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

Интегрируйте AppLovin с посредником

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

Поддерживаемые интеграции и форматы объявлений

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

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

¹ Баннерная реклама (за исключением баннеров MREC) поддерживается только в медиации. Назначение ставок не поддерживает какие-либо типы баннерной рекламы.

Требования

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

[Для ставок]: адаптер AppLovin 9.4.2.0 или выше ( рекомендуется последняя версия )

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

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

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

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

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

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

Торги

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

Водопад

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

Создать зону

Торги

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

Водопад

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

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

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

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

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

Следуйте инструкциям в руководстве AppLovinMAX Test Mode о том, как включить тестовые объявления AppLovin.

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

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

Добавьте AppLovin в компании

Торги

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

Водопад

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

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

Вам не нужно вводить имя пользователя или пароль . Нажмите «Сохранить» , когда закончите.

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

Торги

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

Водопад

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

Настройка ставок AppLovin

Торги

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

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

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

Нажмите Продолжить .

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

Водопад

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

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

Торги

Перейдите в раздел Доставка > Участники торгов и выберите компанию дляAppLovin на вкладке SDK Bidding .

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

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

Водопад

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

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

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

Введите Application ID of your app along with the SDK Key and the Zone ID полученный в предыдущем разделе, и значение цены за тысячу показов по умолчанию . Нажмите Сохранить .

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

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

Выполните действия, описанные вНастройки GDPRиНастройки правил штата США, чтобы добавить AppLovin Corp. в список рекламных партнеров GDPR и правил штата США. в пользовательском интерфейсе Ad Manager .

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

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

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

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

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

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

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

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

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

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

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

Джава

import com.applovin.sdk.AppLovinPrivacySettings;
// ...

AppLovinPrivacySettings.setHasUserConsent(true, context);

Котлин

import com.applovin.sdk.AppLovinPrivacySettings
// ...

AppLovinPrivacySettings.setHasUserConsent(true, context)

Кроме того, если известно, что пользователь относится к категории с возрастными ограничениями, вы также можете установить для флага ниже значение true .

Джава

AppLovinPrivacySettings.setIsAgeRestrictedUser(true, context);

Котлин

AppLovinPrivacySettings.setIsAgeRestrictedUser(true, context)

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

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

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

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

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

Джава

import com.applovin.sdk.AppLovinPrivacySettings;
// ...

AppLovinPrivacySettings.setDoNotSell(true, context);

Котлин

import com.applovin.sdk.AppLovinPrivacySettings
// ...

AppLovinPrivacySettings.setDoNotSell(true, context)

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

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

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

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

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

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

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

Чтобы убедиться, что вы получаете тестовые объявления отAppLovin, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений AppLovin (Bidding) and 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.getAdapterResponse() в следующих классах:

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 не поддерживает запрошенный формат объявления.