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

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

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

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

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

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

^1. Формат рекламы «Открыть приложение» доступен только для интеграций с каскадной моделью покадровой съемки.

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

Требования

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

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

• Новейший GMA Next-Gen SDK

• Заполните руководство по началу медиации.

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

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

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

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

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

Торги

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

Водопад

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

Создать зону

Торги

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

Водопад

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

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

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

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

Примечание: Мы настоятельно рекомендуем создать зону AppLovin, соответствующую каждому рекламному блоку Ad Manager, чтобы Ad Manager мог более эффективно оптимизировать источники рекламы в процессе медиации .

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

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

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

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

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

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

Войдите в свой аккаунт в Ad Manager .

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

Торги

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

Водопад

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

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

Вводить имя пользователя или пароль не требуется. После завершения нажмите «Сохранить» .

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

Торги

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

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Передайте защищенный сигнал в запросах на участие в торгах.

Торги

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

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

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Обеспечьте безопасный обмен сигналами для торгов с использованием SDK.

Торги

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

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

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Настройка системы торгов AppLovin

Торги

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

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

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

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

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

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

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

Торги

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

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

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

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

Важно: Настройте таргетинг выбранного рекламного блока как минимум по одной группе доходности.

Водопад

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

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

Выберите компанию, которую вы создали для AppLovin в предыдущем разделе. В качестве типа интеграции выберите «Посредничество мобильного SDK» , в качестве платформы — «Android» , а в качестве статуса — «Активный» .

Введите идентификатор пакета (Bundle ID) вашего приложения, а также ключ SDK (SDK Key) , идентификатор зоны (Zone ID), полученные в предыдущем разделе, и значение CPM по умолчанию . Нажмите «Сохранить» .

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

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

Важно: Убедитесь, что у вас есть разрешение на управление учетной записью для завершения настройки согласия ЕС и GDPR, правил штатов США и платформы обмена сообщениями пользователей. Подробнее см. раздел «Управление доступом пользователей к вашей учетной записи» .

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

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

Примечание: Невозможность интеграции совместимых версий AppLovin и GMA Next-Gen SDK может привести к проблемам со сборкой.

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

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

Котлин

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:applovin:13.5.1.0")
}

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:0.24.0-beta02'
    implementation 'com.google.ads.mediation:applovin:13.5.1.0'
}

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). Вы несете ответственность за проверку того, что согласие передается каждому источнику рекламы в вашей цепочке посредничества. Google не может автоматически передавать выбор согласия пользователя таким сетям.

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

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

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 для приложений, которые объявляют один из следующих параметров с помощью 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: Протестируйте свою реализацию.

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

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

Важно: Перед выпуском приложения отключите тестовый режим для Ad Manager и AppLovin.

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

Чтобы убедиться, что вы получаете тестовые объявления от 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 немедленно начать отслеживать события.

коды ошибок

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

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