Google Ad Manager

This topic explains how to set up the Google Ad Manager bidding mediation partner for Audience Network.

Before You Start

• Audience Network SDK requirements: 6.2.1 or later (Android | iOS)
• Google SDK requirements: Downloads for the Google Mobile Ads SDK. Apply to any apps that will utilize Open Bidding (Android | iOS).
• Open Bidding setup: Update the AdsManager SDK, Audience Network SDK and Adapter to ensure you’re using the latest version. Then, follow the instructions for Android or iOS to set up open bidding. Please check compatibility for the Google Mobile Ads SDK, Audience Network SDK and Adapter here (Android | iOS)
• Supported formats: Banner, Interstitial, Medium Rectangle, Native, Native Banner, Rewarded Video.

How to Set Up Bidding

Update your app code

• iOS: Update your Info.list file. Add GADIsAdManagerApp key and GADApplicationIdentifier key.
• Android: Update your AndroidManifest.xml. Add rtb enabled flag in AndroidManifest.xml file.

Initialize SDK

1. Initialize the Google Mobile SDK and adapters by following the instructions for iOS or Android.
2. Wait for successful completion of adapters, use callbacks and listener functions to confirm.
3. Make ad requests and load ads.

It is important that you wait until the completion handler is called before loading ads, as this will ensure that all mediation adapters are initialized. Please consult Google Ad Manager Documentation here for more information.

Placement setup

Rather than creating a new placement_id for bidding, use an existing tag placement_id that generates the most revenue and convert it to bidding. Use an existing placement_id that performs well to provide statistically reliable results and to help with accurate performance comparisons.

Inspect your Ad Units

Use Ad inspector to get serving insights and test third-party yield partners in real time, displayed in your apps as an overlay.

Best practices

• Create yield groups for each app separately: You can combine iOS and Android in the yield group for the same app. Don’t combine multiple apps in the same yield group.
• Choose the correct integration type and platform in yield groups: For example, choose integration type “Mobile SDK Mediation – iOS” for iOS placements, and integration type “Mobile SDK Mediation – Android” for the Android placements in Audience Network.
• Review regional privacy legislation: Be sure to consider specific legislation such as CCPA, EU consent, and LGPD, and made sure your new Yield Partner is part of either the Global Vendor List or the Additional Consent string if your App uses the TCF Framework. See Create and Manage Yield Partners.
• Map your inventory using Ad Unit Mapping
• Monitor performance and delivery using Yield Group Reporting
• Wait for the SDK to initialize It is important that you wait until the completion handler is called before loading ads. Please consult Google Ad Manager Documentation here for more information.

Testing

We recommend testing your integration before releasing your app. Complete the following steps to load bidding test ads into your app:

• Add your Device ID to the Testing section of your Monetization Dashboard. See Testing for details.
• Send a test bid request to Facebook using Ad Manager’s Mediation Test Suite (Android | iOS).
• (iOS only) Set Audience Network's ATE flag to true for testing.

Google / Meta Format Mapping

Note: Applies to both Android and iOS

Troubleshooting

• Ensure the SDKS finish initializing The most common issue is due to the SDK not initializing fully. It is important that you wait until the completion handler is called before loading ads, as this will ensure that all mediation adapters are initialized. Please consult Google Ad Manager Documentation here for more information.
• Refer to Open Bidding FAQs for answers to questions on open bidding and how it works.
• Use Ad Inspector to check whether your ads are filling as expected, identify errors and find out how to resolve them, and view Open Bidding ad sources or mediation details per request.