App SDK (Android) - Google Ad Manager

What Is App Bidding

App Bidding allows App Developers to build a transparent and fair auction for their ad inventory by offering every ad opportunity to multiple demand partners in real-time. In-app bidding, each demand partner can compete fairly and win an impression based on the highest bid.

Why is App Bidding beneficial for App Developers?

• App Bidding provides many benefits to App Developers:

• Optimize revenues by getting the highest CPM for each ad opportunity

• Provides complete transparency on the value of your ad inventory

• Requires less manual maintenance and fewer resources

Make sure that mavenCentral() repository is already declared in your project-level build.gradle:

allprojects { repositories { google() mavenCentral() } }

Then, in your app's build.gradle, add the following line to the "dependencies" section to import Criteo SDK and its dependencies:

dependencies { implementation 'com.criteo.publisher:criteo-publisher-sdk:4.4.0' }

Criteo SDK uses Java 8 language features; add the following to your app's build.gradle:

android { compileOptions { sourceCompatibility JavaVersion.VERSION_1_8 targetCompatibility JavaVersion.VERSION_1_8 } }

Once done, save the file and perform a Gradle sync.

Criteo SDK requires play-services-ads-identifier and play-services-base package from Google. Make sure that you have the following dependencies in your app's build.gradle file.

SDK Initialization

Initialize Criteo SDK in your Application class by using Criteo.Builder() method. This needs to be done only once. Criteo.Builder() method takes 3 parameters:

If mapping ad units in Commerce Grid, use adUnits() method on the builder and pass List<AdUnit> object to initialize all ad units that Criteo will monetize, passing the ad unit IDs defined in Commerce Grid. Contact your technical account manager to get your ad unit IDs.

Load Criteo bids using loadBid() method that takes 2 parameters:

On the BidResponseListener#onResponse() callback, check if the Bid object is not null, then call enrichAdObjectWithBid() to set the bid on your AdManagerAdRequest.Builder object.

Then, you can call loadAd() on your AdManagerAdView object.

Load Criteo bids using loadBid() method that takes 2 parameters:

On the BidResponseListener#onResponse() callback, check if the Bid object is not null, then call enrichAdObjectWithBid() to set the bid on your AdManagerAdRequest.Builder object.

Then, you can call loadAd() on your AdManagerInterstitialAd object.

Load Criteo bids using loadBid() method that takes 2 parameters:

On the BidResponseListener#onResponse() callback, check if the Bid object is not null, then call enrichAdObjectWithBid() to set the bid on your AdManagerAdRequest.Builder object.

Then, you can call load() on RewardedAd class.

Commerce Grid's App solution works best with high-density price granularity line item setup. You will need to create the first line item as a base template and duplicate the line item for all other price granularity. Please contact your Criteo representative for an alternative automated solution.

Keywords

Go to Inventory > Key-values and click on New Key to create 3 key-values:

• Name: crt_cpm, crt_size, and crt_format

• Value type: Dynamic

Go to Delivery > All orders and click on New Order to create a new Order for Criteo App SDK campaign.

Now, you can create the first line item. The goal is to create one dedicated line item per different CPM price bands based on this first line item.

On the next page, choose Display as Ad Type.

• Name: Use a self-explanatory name like Criteo App SDK Line Item

• Line Item Type: Select the priority type as agreed with your Criteo representative.

• Expected creatives:

  • Include all Banner formats available on your page. Eg: 320x50, 300x250, 320x100

  • For Interstitials, please add all 4 sizes according to Google Ad Manager's recommendation: 320x480, 480x320, 768x1024, and 1024x768

Below the list of sizes, click on Show Creative Details, and on the Creative Targeting section, select Add new targeting. As of Criteo SDK v3.6.0, creative targeting is required for each Banner size.

On the popup shown, write a name for the targeting, for example Criteo Targeting 320x50, and on the Custom targeting section, select crt_size with the expected banner size as the value.

Make sure to add Creative Targeting for all of your Banner sizes, and leave Interstitial sizes without targeting.

• Delivery settings:

  • Rate: For our line item template, we'll use 0.01.

  • Type: CPM

Select the inventory for the campaign and add a Custom Targeting crt_cpm with the same value that we put in the Rate field, i.e. 0.01.

Select the AND button to add a second key value crt_format. Select is none of and enter video. This ensures the line item will not get called to deliver on video impressions.

Finally, hit Save and follow the creative steps below.

On the popup shown, write a name for the targeting, for example Criteo Targeting 320x50, and on the Custom targeting section, select crt_size with the expected banner size as the value.

Make sure to add Creative Targeting for all of your Banner sizes and leave Interstitial sizes without targeting.

• Delivery settings:

  • Rate: For our line item template, we'll use 0.01.

  • Type: CPM

Select the inventory for the campaign and add a Custom targeting crt_cpm with the same value that we put in the Rate field, i.e. 0.01.

Select the AND button to add a second key-value crt_format. Select is none of and enter video. This ensures the line item will not get called to deliver on video impressions.

Finally, hit Save and follow the creative steps below.

See sample implementation of Criteo App Bidding with Google Ad Manager in GitHub.