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

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

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

Выберите платформу: Android (бета-версия)

Android iOS Unity Flutter

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

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

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

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

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

Требования

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

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

Новейший SDK для мобильной рекламы Google
Заполните руководство по началу медиации.

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

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

Для настройки рекламного блока AdMob вам понадобятся ключ SDK AppLovin и ключ отчета . Чтобы найти их, перейдите в пользовательский интерфейс AppLovin > Аккаунт > Ключи, где вы увидите оба значения.

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

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

Торги

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

Водопад

В пользовательском интерфейсе 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 ads.txt, добавьте в него слово AppLovin.

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

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

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

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

Вам необходимо добавить Applovin в конфигурацию медиации для вашего рекламного блока.

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

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

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

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

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

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

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

Торги

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

Нажмите «Как подписать партнерское соглашение и заключить соглашение о партнерстве с Applovin».

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

Если у вас уже есть сопоставление для Applovin, вы можете его выбрать. В противном случае нажмите «Добавить сопоставление» .

Далее введите ключ SDK , полученный в предыдущем разделе. Затем нажмите «Готово» .

Водопад

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

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

Далее введите идентификатор приложения (Application ID ), а также ключ SDK и идентификатор зоны (Zone ID) , полученные в предыдущем разделе. Затем нажмите «Готово» .

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

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

Чтобы добавить компанию Applovin Corp. в список рекламных партнеров, подпадающих под действие европейских и американских государственных нормативных актов, в пользовательском интерфейсе AdMob, выполните действия, описанные в настройках европейских и американских нормативных актов .

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

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

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

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

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

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

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

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

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

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

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

Java

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 для приложений, которые указывают один из следующих параметров в SDK Google Mobile Ads:

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

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

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

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

Java

AppLovinPrivacySettings.setDoNotSell(true);AppLovinMediationSnippets.java

Котлин

AppLovinPrivacySettings.setDoNotSell(true)AppLovinMediationSnippets.kt

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

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

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

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

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

Убедитесь, что вы зарегистрировали свое тестовое устройство в AdMob и включили тестовый режим в пользовательском интерфейсе Applovin.

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

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

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

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

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

Java


Bundle extras = new AppLovinExtras.Builder().setMuteAudio(true).build();
AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(ApplovinAdapter.class, extras).build();AppLovinMediationSnippets.java

Котлин


val extras = AppLovinExtras.Builder().setMuteAudio(true).build()
val request =
  AdRequest.Builder().addNetworkExtrasBundle(ApplovinAdapter::class.java, extras).build()AppLovinMediationSnippets.kt

Оптимизации

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

коды ошибок

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

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	Отсутствует идентификатор рекламного блока.