Integrating Verizon Media with Mediation

This guide is intended for publishers who want to use the Google Mobile Ads SDK to load and display ads from Verizon Media via mediation. It covers how to add Verizon Media to an ad unit's mediation configuration, how to set up Ad Network Optimization (ANO), and how to integrate the Verizon Media SDK and adapter into a Unity app.

Supported ad formats and features

The AdMob mediation adapter for Verizon Media has the following capabilities:

Formats
Banners
Interstitials
Rewarded Video
Native Advanced
Features
Smart Banners
Ad Network Optimization (ANO)

Requirements

  • Unity 4 or higher
  • Latest Google Mobile Ads SDK
  • To deploy on Android
    • Android API level 16 or higher
  • To deploy on iOS
    • iOS deployment target of 8.0 or higher
  • A working Unity project configured with Google Mobile Ads SDK. Refer to Get Started for details.

Step 1: Set up Verizon Media

Sign up or log in to Verizon Media's SSP.

Under Applications and Sites, click the button to create your app and select your preferred platform.

Fill out the form and click Save and Add Placement to create your app.

Android

iOS

Once you've created an app, you will need to create a Placement. Select a Placement Type, fill out the form, and click Save & Monetize. Take note of your Placement ID. You will need this in the next step.

You will need to add an Ad Source to your placement. On the next form, select Verizon Media SSP as an Ad Source and fill out the form with the required information. Once you've completed the form, click Save.

Finally, drag the Ad Source that you just created under the Waterfall Ad Sources table to add it to your placement. Take note of the Site ID, just beside your app's name. You will also need this in the next step.

Open the Navigation menu and select Reporting Credentials under Account Settings.

Take note of the Company ID and Company Access Key.

Step 2: Configure mediation settings for your ad unit

You need to add Verizon Media to the mediation configuration for your ad unit. First sign in to your AdMob account.

Next, navigate to the Mediation tab. If you have an existing mediation group you'd like to modify, click the name of that mediation group to edit it, and skip ahead to Add Verizon Media as an ad source.

To create a new mediation group, select Create Mediation Group.

Enter your ad format and platform, then click Continue.

Android

iOS

Give your mediation group a name, and select locations to target. Next, set the mediation group status to Enabled, and then click Add Ad Units.

Android

iOS

Associate this mediation group with one or more of your existing AdMob ad units. Then click Done.

Android

iOS

You should now see the ad units card populated with the ad units you selected:

Android

iOS

Add Verizon Media as an ad source

In the Ad Sources card, select Add Ad Network. Select Verizon Media and enable the Optimize switch. Enter the Company ID and Company Access Key obtained in the previous section to set up ANO for Verizon Media. Then enter an eCPM value for Verizon Media and click Continue.

Enter the Placement ID and Site ID obtained in the previous section.

Android

iOS

Using rewarded video ads

In the settings for your rewarded video ad unit, check the Apply to all networks in Mediation groups box so that you provide the same reward to the user no matter which ad network is served.

If you don't check this setting, the Verizon Media adapter defaults to a reward of type "" (empty string) with a value of 1. The Verizon Media SDK does not provide specific reward values for its rewarded video ads.

For more information on setting reward values for AdMob ad units, see Create an ad unit.

Step 3: Import the Verizon Media SDK and Adapter

Download the latest version of the Google Mobile Ads mediation plugin for Verizon Media and extract the GoogleMobileAdsVerizonMediaMediation.unitypackage from the zip file.

In your Unity project editor, select Assets > Import Package > Custom Package and find the GoogleMobileAdsVerizonMediaMediation.unitypackage file you downloaded. Make sure all the files are selected and click Import.

Then, select Assets > Play Services Resolver > Android Resolver > Force Resolve. The Unity Play Services Resolver library will perfrom dependency resolution from scratch and copy the declared dependencies into the Assets/Plugins/Android directory of your Unity app.

Step 4: Additional Code Required

No Additional code required for Verizon Media integration.

Step 5: Test Your Implementation

Verizon Media ads can be tested by creating a Test Ad Source and adding it into your placement's Waterfall Ad Sources. Navigate to your Placement ID's settings, click the Add button and select Test Ad Source.

Once you've created the Ad Source, drag it into your placement's Waterfall Ad Sources.

Optional steps

Under the Google EU User Consent Policy, you must ensure that certain disclosures are given to, and consents obtained from, users in the European Economic Area (EEA) regarding the use of device identifiers and personal data. This policy reflects the requirements of the EU ePrivacy Directive and the General Data Protection Regulation (GDPR). When seeking consent, you must identify each ad network in your mediation chain that may collect, receive, or use personal data and provide information about each network's use. Google currently is unable to pass the user's consent choice to such networks automatically.

Follow the instructions below to enable or disable personalized ads for Verizon Media.

The VerizonMedia class has the following methods that forward consent consent information to the Verizon Ads SDK:

  • GetVerizonIABConsentKey()
    • Gets the Verizon Media SDK's IAB consent key.
  • SetPrivacyData()
    • Sets GDPR privacy data on the Verizon Media SDK.

The following sample code demonstrates how to pass these parameters to the Verizon Media adapters. If you choose to call these methods, it is recommended that you do so prior to initializing the Google Mobile Ads SDK.

    using GoogleMobileAds.Api.Mediation.VerizonMedia;
    using System.Collections.Generic;
    // ...

    Dictionary<string, string> privacyData = new Dictionary<string, string>();
    privacyData.Add(VerizonMedia.GetVerizonIABConsentKey(), "myIABConsentString");

    VerizonMedia.SetPrivacyData(privacyData);

Visit Verizon Media's Privacy Settings guide for more information about what inputs can be passed.

Verizon Media Unity Mediation Plugin Changelog

Version 1.4.0

Version 1.3.0

Version 1.2.0

Version 1.1.0

Version 1.0.1

  • Added the following methods to the VerizonMedia class to support GDPR requirements:
    • GetVerizonIABConsentKey() to get the Verizon Media SDK's IAB Consent Key.
    • SetConsentData() to pass GDPR consent data to the Verizon Media SDK.

Version 1.0.0

  • Supports banner and interstitial ads.
  • Supports Verizon Media Android adapter version 1.1.1.0.
  • Supports Verizon Media iOS adapter version 1.1.2.0.