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

Интегрируйте AppLovin с медиацией

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

В этом руководстве показано, как использовать GMA Next-Gen SDK для загрузки и отображения рекламы из AppLovin с помощью AdMob Mediation, охватывая как каскадную, так и билдинговую интеграцию. В нем рассказывается, как добавить AppLovin в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер AppLovin в приложение Android.

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

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

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

^1. Интеграция каскадной модели находится в закрытой бета-версии.

^2. Waterfall поддерживает только баннеры размером 320x50 и 728x90. Система назначения ставок не поддерживает баннерную рекламу.

Предварительные требования

Прежде чем продолжить, проверьте следующее:

Android API уровня 24 или более поздней версии.

[Для участия в торгах]: Чтобы интегрировать все поддерживаемые форматы рекламы в процесс торгов, используйте адаптер AppLovin версии 9.4.2.0 или более поздней ( рекомендуется последняя версия ).

Последняя версия GMA Next-Gen SDK .
Настройте медиацию AdMob .

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

Зарегистрируйтесь или войдите в свою учетную запись AppLovin.

To set up your AdMob ad unit, you'll need your AppLovin SDK Key and Report Key . To find them, go to the AppLovin UI > Account > Keys to see both values.

Если вы планируете интегрировать только систему торгов, вы можете перейти к настройке параметров медиации .

Выберите приложение для медиации.

Торги

Этот шаг не требуется для интеграции с системами торгов.

Водопад

В пользовательском интерфейсе AppLovin выберите «Приложения» в разделе «Монетизация» , чтобы перейти к зарегистрированным приложениям. Выберите из списка доступных приложений приложение, которое вы хотите использовать для посредничества.

Создать зону

Торги

Этот шаг не требуется для интеграции с системами торгов.

Водопад

В пользовательском интерфейсе AppLovin выберите «Зоны» в разделе «Монетизация» , чтобы получить доступ к зарегистрированным идентификаторам зон. Если вы уже создали необходимые зоны для своего приложения, перейдите к шагу 2. Чтобы создать новый идентификатор зоны, нажмите «Создать зону» .

Введите название зоны ID , выберите Android в качестве платформы и укажите тип рекламы .

Настройте ценообразование для зоны, выбрав либо « Плоская цена за 1000 показов» (Flat CPM) , либо «Оптимизировано AppLovin» (Optimized by AppLovin) . В варианте «Плоская цена за 1000 показов » (Flat CPM) можно настроить для каждой страны отдельно. Затем нажмите «Сохранить ».

После создания зоны ее идентификатор можно найти в столбце «Идентификатор зоны» .

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

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

Чтобы добавить AppLovin в файл app-ads.txt , добавьте AppLovin в свой файл app-ads.txt .

Включите тестовый режим

Чтобы включить тестовую рекламу AppLovin, следуйте инструкциям в руководстве по режиму MAX Test Mode от AppLovin.

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

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

You need to add AppLovin to the mediation configuration for your ad unit.

Сначала войдите в свою учетную запись AdMob . Затем перейдите на вкладку «Медиация» . Если у вас уже есть группа медиации, которую вы хотите изменить, щелкните по ее названию, чтобы отредактировать ее, и перейдите к разделу «Добавить AppLovin в качестве источника рекламы» .

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

Enter your ad format and platform, then click Continue .

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 .

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

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

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

Торги

In the Ad Sources section, find the Bidding card and select Add ad source . Then select AppLovin .

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

Click Acknowledge & agree , then click Continue .

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

Next, enter the SDK Key obtained in the previous section. Then click Done .

Водопад

Under the Waterfall card in the Ad Sources section, select Add Ad Source .

Выберите AppLovin и включите переключатель «Оптимизировать» . Введите ключ отчета , полученный в предыдущем разделе, чтобы настроить оптимизацию источника рекламы для AppLovin. Затем введите значение eCPM для AppLovin и нажмите «Продолжить» .

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

Next, enter the Bundle ID of your app along with the SDK Key and the Zone ID obtained in the previous section. Then click Done .

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

Добавьте AppLovin Corp. в список рекламных партнеров, соответствующих требованиям GDPR и законодательства штатов США.

Follow the steps in European regulations settings and US state regulations settings to add AppLovin Corp. to the European and US state regulations ad partners list in the AdMob UI.

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

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

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

Котлин

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.4.0")
    implementation("com.google.ads.mediation:applovin:13.6.4.2")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Классный

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.4.0'
    implementation 'com.google.ads.mediation:applovin:13.6.4.2'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

Загрузите Android SDK AppLovin , распакуйте файл applovin-sdk-xyzjar и добавьте его в свой проект.
Перейдите к артефактам адаптера AppLovin в репозитории Maven от Google. Выберите последнюю версию, загрузите файл .aar адаптера AppLovin и добавьте его в свой проект.

Шаг 4: Внедрите настройки конфиденциальности в SDK AppLovin.

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

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

Адаптер AppLovin для Android версии 12.0.0.0 и более поздних версий поддерживает передачу сигналов согласия GDPR из UMP SDK и платформ управления согласием, интегрированных со спецификацией Google Additional Consent, в AppLovin SDK. Для получения дополнительной информации см. раздел «Конфиденциальность» .

Объявить дочерних пользователей

AppLovin не поддерживает инициализацию SDK AppLovin в связи с детьми. Для получения дополнительной информации см. документацию AppLovin по вопросам запрета использования данных детей, использования сервисов для детей или приложений, предназначенных исключительно для детей .

AppLovin adapter version 13.0.0.1 or higher disables AppLovin mediation automatically for apps that declare either of the following settings with the GMA Next-Gen SDK :

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

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

В состав SDK AppLovin входит метод setDoNotSell , позволяющий издателям отказаться от продажи личной информации.

В следующем примере эта информация о согласии передается в SDK AppLovin. Необходимо установить эти параметры до инициализации GMA Next-Gen SDK чтобы обеспечить их корректную передачу в SDK AppLovin.

Java

AppLovinPrivacySettings.setDoNotSell(true);AppLovinMediationSnippets.java

Котлин

AppLovinPrivacySettings.setDoNotSell(true)AppLovinMediationSnippets.kt

Для получения более подробной информации см. документацию AppLovin по вопросам конфиденциальности .

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

Для интеграции с AppLovin дополнительный код не требуется.

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

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

Make sure you register your test device for AdMob and enable test mode in AppLovin UI.

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

Чтобы убедиться, что вы получаете тестовые объявления от AppLovin, включите тестирование по одному источнику объявлений в инспекторе объявлений, используя источники объявлений AppLovin (торги) и AppLovin (каскадная модель ).

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

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

Адаптер AppLovin поддерживает setMuteAudio() , который позволяет отключать звук в видеорекламе. Этот метод можно вызвать из объекта AppLovinExtras.Builder() :

Java


Bundle extras = new AppLovinExtras.Builder()
  .setMuteAudio(true)
  .build();
AdRequest request = new AdRequest.Builder(AD_UNIT_ID)
  .putAdSourceExtrasBundle(ApplovinAdapter.class, extras)
  .build();

Котлин


val extras = AppLovinExtras.Builder()
   .setMuteAudio(true)
   .build()
val request = AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(ApplovinAdapter::class.java, extras)
   .build()

Оптимизации

Инициализируйте SDK AppLovin при запуске вашего приложения. Это позволит AppLovin немедленно начать отслеживать события.

коды ошибок

If the adapter fails to receive an ad from AppLovin, publishers can check the underlying error from the ad response using ResponseInfo.getAdSourceResponses() under the following classes:

com.google.ads.mediation.applovin.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

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

Код ошибки	Причина
от -1009 до -1, 204	SDK AppLovin вернул ошибку. Дополнительные сведения см. в документации AppLovin .
101	Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому AppLovin.
103	Контекст отсутствует.
104	Токен заявки AppLovin пуст.
105	Запрошено несколько объявлений для одной и той же зоны. AppLovin может загружать только одно объявление за раз для каждой зоны.
106	Объявление пока не готово к показу.
108	Адаптер AppLovin не поддерживает запрашиваемый формат рекламы.
109	Context не является экземпляром Activity.
110	Отсутствует ключ SDK.
112	Пользователь — ребёнок.
113	Отсутствует идентификатор рекламного блока.