Mediate via DFP on iOS

The Flurry AdMob and DFP mediation adapter lets you integrate ads from the Flurry network, via the Flurry Advertising SDKs, into the Google Mobile Ads mediation platform.

To start the mediation integration, ensure that you have access to the following:


Note that this section describes mediation of Flurry through DFP. For AdMob mediation of Flurry inventory, follow these Integration instructions

Get Started Mediating Flurry via DFP

To integrate Flurry as a mediated Network in DFP ad serving, you perform the following tasks:

  1. Integrate the Flurry SDK and Flurry adapter for DFP and AdMob code into your app.
  2. Configure Flurry’s Ad Unit(s).
  3. Configure DFP to mediate Flurry.
  4. Request ads in your app.

Integrate Flurry SDK and Flurry Adapter Into Your App

Follow these steps:

  1. If your app is not currently tracked by Flurry, create a new application on Flurry’s developer portal.
  2. Keep a reference to the API Key for the new application after it has been created. Flurry requires each application to have its own unique API key to identify your app within the Flurry system. The Flurry API key is also used when configuring mediation on the DFP dashboard.
  3. Add the latest Flurry iOS SDK into your app.
  4. To integrate the Flurry adapter into your application code, add the adapter as a dependency in your project (available here).

Configure Flurry’s Ad Unit(s)

Follow these steps:

  1. For each DFP ad unit that you want to mediate Flurry through, create a matching ad unit on the Flurry developer portal.
  2. Log into the developer portal and navigate to the Monetization tab. On the left navigation bar select, Applications & Ad Units.
  3. You may see a list of previously created ad units. To set up a new one, click the Ad Unit button in the upper-left corner. Depending on the type of Ad Unit you are creating, the Ad Unit setup screen has three to four modules. The Basic Setup section includes fields required to define the name, application, dimensions, placement and orientation of the ad unit.
Flurry ad unit creation screen
  1. You only need the basic setup to start. Click Save.

For additional ad unit configuration, see Basic ad space setup instructions and Advanced ad space setup instructions.

You are required to create your ad space on the developer portal before retrieving ads through mediation.

Mediating Flurry through DFP requires no additional Flurry-related code in your application. The Flurry Ad Unit invocation code is already incorporated in the adapter adapter code.

If you are integrating banner ads, Flurry recommends that you turn off banner refresh in Flurry and let DFP refresh the ads. Set the refresh rate for the ad space to an unusually high number, like 9999 (instead of the default 30 seconds). This setting is found in the Advanced Options section of the Ad Unit setup.

Configure DFP to Mediate Flurry

Follow these steps:

  1. On the DFP site, create one or more ad units with SDK mediation creatives. Each ad unit created on the DFP site should have a corresponding ad space created on Flurry’s developer portal (detailed instructions are provided below) View instructions for adding a new creative.
  2. Create the SDK Mediation creative to include Flurry impressions into the ad serving flow created following these Instructions.

To enable mediation of Flurry inventory:

  1. Click the Inventory tab.
  2. Select the ad unit for which you are extending with Flurry mediation. This unit’s ad id (found under Generate Tags) is used in the code to reference it.
  3. Target a line item to mobile device. Instructions.
  4. Create SDK Mediation creative, select Flurry from the list of available ad networks. Provide the Flurry API key in the corresponding field (iOS or Android) and ad unit name as created in the earlier step.

See the Detailed Google instructions.

ad mob mediation for dfp

Request Ads in Your App

Follow the same instructions used for integrating DFP ads into your application. To integrate non-interstitial ads (banner size, leaderboard size, and so on), follow the DFP instructions for banner ads from Google. To integrate interstitial ads (full-screen ads that take over the screen), follow the DFP instructions for interstitial ads from Google.

To integrate native ads, follow the instructions for DFP from Google for native ads. The Google Ads SDK allows the mediation of two system-defined native ad formats: Content and App-install ad formats. Publishers mediating Flurry can request for both formats.

Note: Ad requests for only App-install ads will not work during Flurry mediation. We recommend that publishers request for both formats if mediating Flurry.

Example

To learn about making DFP ad requests, follow the instructions provided by Google.

For native ads, after completing a successful native ad request, you can get Flurry-specific assets in the following way:

#pragma mark GADNativeContentAdLoaderDelegate implementation

- (void)adLoader:(GADAdLoader *)adLoader
      didReceiveNativeContentAd:(GADNativeContentAd *)nativeContentAd {

    NSLog(@"Received native content ad: %@", nativeContentAd);

    GADNativeAdImage *flurryBrandingLog = nativeContentAd.extraAssets[kFlurryExtraBrandingLogo];
    // Load the rest of the native ad
    // ..
}

// ..

#pragma mark GADNativeAppInstallAdLoaderDelegate implementation

- (void)adLoader:(GADAdLoader *)adLoader
      didReceiveNativeAppInstallAd:(GADNativeAppInstallAd *)nativeAppInstallAd {

    NSLog(@"Received native app install ad: %@", nativeAppInstallAd);

    GADNativeAdImage *flurryBrandingLog = nativeContentAd.extraAssets[kFlurryExtraBrandingLogo];
    NSString *appCategory = nativeContentAd.extraAssets[kFlurryExtraAppCategory];
    // Load the rest of the native ad
    // ..
}