Чтобы обсудить наши продукты и оставить отзыв о них, присоединяйтесь к официальному каналу Ad Manager Discord на сервере Google Advertising and Measurement Community .

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

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

В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из AppLovin с помощью медиации , охватывая интеграцию как каскадной модели, так и биддинга. В нём также рассказывается, как добавить AppLovin в конфигурацию медиации рекламного блока, а также как интегрировать AppLovin SDK и адаптер в приложение для Android.

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

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

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

¹ Waterfall поддерживает только баннеры размером 320x50 и 728x90. Bidding не поддерживает баннерную рекламу.

Требования

Android API уровня 23 или выше

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

Последняя версия Google Mobile Ads SDK
Завершить посредничество . Руководство по началу работы.

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

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

Для настройки рекламного блока Менеджера рекламы вам понадобятся ключ AppLovin SDK и ключ отчёта . Чтобы найти их, перейдите в раздел «Интерфейс AppLovin» > «Учётная запись» > «Ключи» и посмотрите оба значения.

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

Выберите приложение для посредничества

Торги

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

Водопад

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

Создать зону

Торги

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

Водопад

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

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

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

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

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

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

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

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

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

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

Войдите в свою учетную запись Менеджера рекламы .

Добавить Applovin в раздел «Компании»

Торги

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

Водопад

Перейдите в раздел «Администрирование» > «Компании» , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите «Рекламная сеть» .

Выберите Applovin в качестве рекламной сети , введите уникальное имя и включите посредничество . Включите автоматический сбор данных и введите ключ отчёта, полученный в предыдущем разделе.

Имя пользователя и пароль вводить не нужно. Нажмите «Сохранить» по завершении.

Включить безопасный обмен сигналами

Торги

Перейдите в раздел «Администрирование» > «Глобальные настройки» . Перейдите на вкладку «Настройки аккаунта Ad Exchange» , проверьте и включите опцию «Безопасный обмен сигналами» . Нажмите «Сохранить» .

Водопад

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

Поделиться защищенным сигналом в запросах ставок

Торги

Перейдите в раздел «Инвентарь» > «Защищённые сигналы» . В разделе «Защищённые сигналы» найдите Applovin Corp. и включите опцию «Включить интеграцию приложений» .

Нажмите «Сохранить» .

Водопад

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

Разрешить безопасный обмен сигналами для SDK Bidding

Торги

Перейдите в раздел «Доставка» > «Настройки канала спроса» . На вкладке «Настройки по умолчанию» включите опцию «Разрешить безопасный обмен сигналами для торгов SDK» .

Нажмите «Сохранить» .

Водопад

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

Настройте ставки Applovin

Торги

Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .

Нажмите кнопку «Новый участник торгов» .

Выберите Applovin в качестве участника торгов.

Нажмите «Продолжить» , чтобы включить функцию ставок SDK для этого участника торгов.

Нажмите Готово .

Водопад

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

Настроить сопоставление рекламных блоков

Торги

Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .

Выберите компанию для Applovin.

Перейдите на вкладку Сопоставление рекламного блока и нажмите Новое сопоставление рекламного блока .

Выберите конкретный рекламный блок . Выберите рекламный блок и формат, выберите «Мобильное приложение» в качестве типа инвентаря и ваше мобильное приложение . Затем введите ключ SDK, полученный в предыдущем разделе. Нажмите «Сохранить» .

Водопад

Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Новая группа доходности» . Выберите мобильное приложение .

Прокрутите вниз и нажмите «Добавить партнера по доходности» .

Выберите компанию, которую вы создали для Applovin в предыдущем разделе. Выберите Mobile SDK mediation в качестве типа интеграции , Android в качестве платформы и Active в качестве статуса .

Введите идентификатор приложения вместе с ключом SDK и идентификатором зоны, полученными в предыдущем разделе, а также значение CPM по умолчанию . Нажмите «Сохранить» .

Примечание: Автоматическому сбору данных требуется несколько дней, прежде чем он сможет точно рассчитать значение динамической цены за тысячу показов (CPM) для сети медиации. После того, как значение eCPM будет рассчитано, оно автоматически обновляется от вашего имени.

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

Следуйте инструкциям в настройках европейского законодательства и государственных нормативных актов США, чтобы добавить Applovin Corp. в список рекламных партнеров, соответствующих европейским и государственным нормативным актам США, в пользовательском интерфейсе Менеджера рекламы.

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

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.5.0")
    implementation("com.google.ads.mediation:applovin:13.3.1.1")
}

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

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

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

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

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

Начиная с версии SDK 12.0.0, AppLovin поддерживает чтение строки согласия из общих настроек и соответствующую установку статуса согласия.

Если вы не используете AppLovin SDK версии 12.0.0+ или CMP, который записывает строку согласия в общие настройки, вы можете использовать метод setHasUserContent . В следующем примере информация о согласии передаётся в AppLovin SDK. Эти параметры необходимо задать до инициализации Google Mobile Ads SDK, чтобы они были корректно переданы в AppLovin SDK.

Ява

AppLovinPrivacySettings.setHasUserConsent(true);AppLovinMediationSnippets.java

Котлин

AppLovinPrivacySettings.setHasUserConsent(true)AppLovinMediationSnippets.kt

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

Объявить детей-пользователей

Начиная с версии AppLovin SDK 13.0.0, AppLovin больше не поддерживает флаги возрастных ограничений пользователей, и вам запрещено инициализировать или использовать AppLovin SDK в отношении «ребёнка» в соответствии с действующим законодательством. Подробнее см. в документации AppLovin о запрете на использование данных детей, использовании сервисов для детей или приложениях, предназначенных исключительно для детей .

Адаптер AppLovin версии 13.0.0.1 или выше автоматически отключает посредничество AppLovin для приложений, которые объявляют какие-либо из следующих настроек с помощью Google Mobile Ads SDK:

Если вы используете адаптер AppLovin версии 12.6.1.0 или более ранней, обратитесь к документации AppLovin по установке флага ограничения по возрасту для пользователя с помощью AppLovin SDK.

Законы США о конфиденциальности

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

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

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

Ява

AppLovinPrivacySettings.setDoNotSell(true);AppLovinMediationSnippets.java

Котлин

AppLovinPrivacySettings.setDoNotSell(true)AppLovinMediationSnippets.kt

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

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

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

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

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

Обязательно зарегистрируйте свое тестовое устройство в Ad Manager и включите тестовый режим в Applovin UI.

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

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

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

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

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

Ява

Bundle extras = new AppLovinExtras.Builder()
   .setMuteAudio(true)
   .build();

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(ApplovinAdapter.class, extras)
   .build();

Котлин

val extras = AppLovinExtras.Builder()
   .setMuteAudio(true)
   .build()

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(ApplovinAdapter::class.java, extras)
   .build()

Оптимизации

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

Ява

AppLovinSdk.getInstance("sdkKey", null, context).initializeSdk();

Котлин

AppLovinSdk.getInstance("sdkKey", null, context).initializeSdk()

Коды ошибок

Если адаптеру не удается получить рекламу от AppLovin, издатели могут проверить основную ошибку в ответе на рекламу, используя ResponseInfo.getAdapterResponses() в следующих классах:

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

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

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