Google Mobile Ads SDK находится в режиме технического обслуживания. Для получения последних обновлений и новых функций выполните миграцию и настройку GMA Next-Gen SDK .

Эта страница переведена с помощью Cloud Translation API.

Интегрируйте DT Exchange с посредничеством

Выберите платформу: Android iOS Unity Flutter Android (Legacy)

This guide shows you how to use Google Mobile Ads SDK (Legacy) to load and display ads from DT Exchange using AdMob Mediation , covering waterfall integrations. It covers how to add DT Exchange to an ad unit's mediation configuration and how to integrate the DT SDK and adapter into an Android app.

Поддерживаемые интеграции и форматы рекламы

Адаптер посредничества для DT Exchange обладает следующими возможностями:

Интеграция
Торги
Водопад
Форматы
Баннер
Интерстициальный
Награжден
Родной

Требования

Android API level 23 or higher
[For bidding]: To integrate all supported ad formats in bidding, use the DT Exchange adapter 8.4.2.0 or higher ( latest version recommended ).

Последняя версия Google Mobile Ads SDK (Legacy) .
Пройдите руководство по началу процесса медиации.

Шаг 1: Настройка параметров в пользовательском интерфейсе DT Exchange.

Добавить новое приложение и место размещения рекламы.

Click Add App .

Управление приложениями

Choose your platform and placements, fill out the rest of the form, and then click Create App .

Enter the names and select the types for your placements. Then, click Save Placement .

Настраивать

Идентификатор приложения и идентификатор размещения

Hover over the left navigation bar to open it, then click App Management .

On the App Management page, take note of the App ID next to your app.

Select your app and navigate to the Placements tab. Take note of the Placement ID ..

Идентификатор размещения

Идентификатор издателя, ключ потребителя и секретный ключ потребителя

Click your username from the left menu and select User Profile .

Take note of the Publisher ID , Consumer Key , and Consumer Secret as these are needed in the next step.

Обновите файл app-ads.txt.

Файл app-ads.txt, созданный в рамках инициативы IAB Tech Lab для авторизованных продавцов рекламы в приложениях , помогает гарантировать, что рекламный инвентарь вашего приложения продается только через каналы, которые вы определили как авторизованные. Чтобы предотвратить значительные потери дохода от рекламы, вам потребуется внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для своего приложения .

To implement app-ads.txt for DT Exchange, Add DT to your app-ads.txt file .

Шаг 2: Настройте запрос DT Exchange в пользовательском интерфейсе AdMob.

Настройте параметры медиации для вашего рекламного блока.

You need to add DT Exchange 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 DT Exchange as an ad source .

Чтобы создать новую группу медиации, выберите «Создать группу медиации» .

Укажите формат и платформу вашей рекламы, затем нажмите «Продолжить» .

Присвойте вашей группе посредничества название и выберите регионы для таргетирования. Затем установите статус группы посредничества на «Включено» и нажмите «Добавить рекламные блоки» .

Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите «Готово» .

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

Добавьте DT Exchange в качестве источника рекламы.

Торги

Under the Bidding card in the Ad Sources section, select Add ad source . Then select DT Exchange .

Click How to sign a partnership agreement and set up a bidding partnership with DT Exchange.

Нажмите «Подтвердить и согласиться» , затем нажмите «Продолжить» .

If you already have a mapping for DT Exchange, you can select it. Otherwise, click Add mapping .

Next, enter the Application ID and Placement ID obtained in the previous section. Then click Done .

Водопад

В разделе «Источники рекламы » на вкладке « Водопад » выберите «Добавить источник рекламы» .

Select DT Exchange and enable the Optimize switch. Enter the Publisher ID , Consumer Secret and Consumer Key obtained in the previous section to set up ad source optimization for DT Exchange. Then enter an eCPM value for DT Exchange and click Continue .

If you already have a mapping for DT Exchange, you can select it. Otherwise, click Add mapping .

Next, enter the Application ID and Placement ID obtained in the previous section. Then click Done .

Примечание : Оптимизация источника рекламы занимает несколько дней, чтобы собрать достаточно данных для точного расчета eCPM для сети медиации. В это время статус оптимизации источника рекламы — PENDING , поэтому вам необходимо вручную установить значение eCPM для сети. Как только eCPM будет рассчитан, источник рекламы автоматически начнет обновлять значение eCPM от вашего имени.

Добавить DT Exchange (монетизация Fyber) в список рекламных партнеров, соответствующих требованиям GDPR и законодательства штатов США.

Follow the steps in European regulations settings and US state regulations settings to add DT Exchange (Fyber Monetization) to the European and US state regulations ad partners list in the AdMob UI.

Шаг 3: Импортируйте SDK DT и адаптер.

Интеграция с Android Studio (рекомендуется)

В файл gradle на уровне приложения добавьте следующие зависимости реализации:

Котлин

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.4.0")
    implementation("com.google.ads.mediation:fyber:8.4.5.1")
}

Классный

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.4.0'
    implementation 'com.google.ads.mediation:fyber:8.4.5.1'
}

Ручная интеграция

Download the latest version of the DT SDK for Android and add fyber-marketplace-xyzaar to your project.
Navigate to the DT Exchange adapter artifacts on Google's Maven Repository. Select the latest version, download the DT Exchange adapter's .aar file, and add it to your project.

Step 4: Implement privacy settings on DT SDK

Согласие ЕС и GDPR

В соответствии с Политикой Google по согласию пользователей в ЕС , вы должны предоставлять пользователям в Европейской экономической зоне (ЕЭЗ), Великобритании и Швейцарии определенную информацию и получать их согласие на использование файлов cookie или других локальных хранилищ, если это требуется по закону, а также на сбор, передачу и использование персональных данных для персонализации рекламы. Данная политика отражает требования Директивы ЕС о защите конфиденциальности в электронных коммуникациях (ePrivacy Directive) и Общего регламента по защите данных (GDPR). Вы несете ответственность за проверку того, что согласие передается каждому источнику рекламы в вашей цепочке посредничества. Google не может автоматически передавать выбор согласия пользователя таким сетям.

Starting in DT Exchange SDK version 8.3.0, DT Exchange automatically reads GDPR consent set by consent management platforms that support Google's Additional Consent specification . For more information, see the DT Exchange GDPR implementation guide.

Законы штатов США о защите частной жизни

Законы США о защите конфиденциальности требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (как это определено в законе), при этом отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на главной странице «продающей» стороны. Руководство по соблюдению законов США о защите конфиденциальности предлагает возможность включения ограниченной обработки данных для показа рекламы Google, но Google не может применить эту настройку к каждой рекламной сети в вашей цепочке посредничества. Поэтому вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать указаниям каждой из этих сетей для обеспечения соответствия требованиям.

DT Exchange contains an API that lets you forward user consent to their SDK. The following sample code shows how to pass consent information to the DT SDK manually. Should you choose to pass consent information to the DT SDK manually, it is recommended that this code is called prior to requesting ads through Google Mobile Ads SDK (Legacy) .

Java

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING);DTExchangeMediationSnippets.java

Котлин

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING)DTExchangeMediationSnippets.kt

Replace US_PRIVACY_STRING with your US privacy string.

Visit DT Exchange's CCPA implementation guide for more details and the values that may be provided in the method.

Шаг 5: Добавьте необходимый код

Загрузить рекламу с контекстом активности

Pass Activity context when loading Interstitial ad formats. Without activity context, ad load will fail.

Шаг 6: Протестируйте свою реализацию.

Включить тестовые объявления

Make sure you register your test device for AdMob.

Проверить тестовые объявления

To verify that you are receiving test ads from DT Exchange, enable single ad source testing in ad inspector using the DT Exchange (Bidding) and DT Exchange (Waterfall) ad source(s).

Дополнительные шаги

Параметры, специфичные для сети

The DT Exchange adapter supports additional request parameters that can be passed to the adapter as an Android Bundle. The adapter looks for the following keys in the bundle:

Request parameters and values
`InneractiveMediationDefs.KEY_AGE`	Integer . The age of the user
`FyberMediationAdapter.KEY_MUTE_VIDEO`	Boolean . Mute or unmute video

Here's a code example of how to set these ad request parameters:

Java

Bundle extras = new Bundle();
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10);
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false);

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(FyberMediationAdapter.class, extras).build();DTExchangeMediationSnippets.java

Котлин

val extras = Bundle()
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10)
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false)

val request =
  AdRequest.Builder().addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras).build()DTExchangeMediationSnippets.kt

коды ошибок

If the adapter fails to receive an ad from DT Exchange, you can check the underlying error from the ad response using ResponseInfo.getAdapterResponses() under the following class:

com.google.ads.mediation.fyber.FyberMediationAdapter

Вот коды и соответствующие сообщения, которые выдает адаптер DT Exchange, когда реклама не загружается:

Код ошибки	Причина
101	DT Exchange server parameters configured in the AdMob UI are missing/invalid.
103	Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому DT Exchange.
105	DT SDK loaded an ad but returned an unexpected controller.
106	Объявление пока не готово к показу.
107	Контекст не является экземпляром действия.
108	Реклама не была показана.
200-399	DT SDK returned an error. See code for more details.