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

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

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

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

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

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

Требования

  • Последняя версия Google Mobile Ads SDK
  • Unity 5.6 или выше
  • [Для назначения ставок]: чтобы интегрировать все поддерживаемые форматы объявлений в назначение ставок, используйте плагин посредничества Google Mobile Ads для AppLovin 4.2.0 или более поздней версии ( рекомендуется последняя версия ).
  • Развертывание на Android
    • Android API уровня 21 или выше
  • Развертывание на iOS
    • Цель развертывания iOS 12.0 или выше
  • Рабочий проект Unity, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе « Начало работы ».
  • Пройдите руководство по началу работы с медиацией

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

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

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

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

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

Торги

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

Водопад

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

Создать зону

Торги

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

Водопад

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

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

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

Андроид

iOS

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

Андроид

iOS

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

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

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

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

Андроид

Инструкции см. в шаге 2 руководства для Android .

iOS

Инструкции см. в шаге 2 руководства для iOS .

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

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

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

OpenUPM-CLI

Если у вас установлен OpenUPM-CLI , вы можете установить плагин медиации Google Mobile Ads Applovin для Unity в свой проект, выполнив следующую команду из корневого каталога вашего проекта:

openupm add com.google.ads.mobile.mediation.applovin

ОпенУПМ

В редакторе проекта Unity выберите «Правка» > «Настройки проекта» > «Диспетчер пакетов» , чтобы открыть настройки диспетчера пакетов Unity .

На вкладке «Регистрации с ограниченной областью» добавьте OpenUPM в качестве реестра с ограниченной областью действия со следующими сведениями:

  • Имя: OpenUPM
  • URL-адрес: https://package.openupm.com .
  • Область применения: com.google

Подробности об OpenUPM

Затем перейдите в «Окно» > «Диспетчер пакетов» , чтобы открыть диспетчер пакетов Unity , и выберите «Мои реестры» в раскрывающемся меню.

Реестры Unity

Выберите пакет Google Mobile Ads Applovin Mediation и нажмите «Установить» .

Установить из OpenUPM

Пакет Единства

Загрузите последнюю версию плагина-посредника Google Mobile Ads для Applovin по ссылке для скачивания в журнале изменений и извлеките пакет GoogleMobileAdsApplovinMediation.unitypackage из zip-файла.

В редакторе проекта Unity выберите «Активы» > «Импортировать пакет» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsApplovinMediation.unitypackage . Убедитесь, что все файлы выбраны, и нажмите «Импортировать» .

Импорт из Unity

Затем выберите «Активы» > «Диспетчер внешних зависимостей» > «Android Resolver» > «Принудительное разрешение» . Библиотека диспетчера внешних зависимостей выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android вашего приложения Unity.

Силовая решимость

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

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

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

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

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetHasUserConsent(true);

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

AppLovin.SetIsAgeRestrictedUser(true);

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

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

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

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

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetDoNotSell(true);

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

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

Андроид

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

iOS

Интеграция со SKAdNetwork

Следуйте документации AppLovin , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.

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

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

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

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

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

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

Оптимизации

Добавление вызова AppLovin.Initialize() к активности запуска дает AppLovin возможность отслеживать события сразу после запуска приложения.

Коды ошибок

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

Андроид 

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

iOS 

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

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

Андроид

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

iOS

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

Журнал изменений плагина AppLovin Unity Mediation

Версия 8.0.3

Версия 8.0.2

Версия 7.4.1

Версия 7.4.0

Версия 7.3.1

Версия 7.3.0

Версия 7.2.2

Версия 7.2.1

Версия 7.2.0

Версия 7.1.0

Версия 7.0.1

Версия 7.0.0

Версия 6.9.1

Версия 6.9.0

Версия 6.8.0

Версия 6.7.0

  • Поддерживает адаптер AppLovin Android версии 11.9.0.0 .
  • Поддерживает адаптер AppLovin iOS версии 11.9.0.0 .
  • Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.1.0.
  • Содержимое адаптера перенесено в GoogleMobileAds/Mediation/AppLovin/ .
  • Переработано пространство имен адаптера для использования GoogleMobileAds.Mediation.AppLovin .

Версия 6.6.0

Версия 6.5.1

Версия 6.5.0

Версия 6.4.3

Версия 6.4.2

Версия 6.4.1

Версия 6.4.0

Версия 6.3.1

Версия 6.3.0

Версия 6.2.1

Версия 6.2.0

Версия 6.1.0

Версия 6.0.0

Версия 5.1.3

Версия 5.1.2

Версия 5.1.1

Версия 5.1.0

Версия 5.0.0

Версия 4.8.1

Версия 4.8.0

Версия 4.7.0

Версия 4.6.2

Версия 4.6.1

Версия 4.6.0

Версия 4.5.8

Версия 4.5.7

Версия 4.5.6

Версия 4.5.5

Версия 4.5.4

Версия 4.5.3

Версия 4.5.2

Версия 4.5.1

Версия 4.5.0

Версия 4.4.1

Версия 4.4.0

Версия 4.3.0

Версия 4.2.0

  • Поддерживает адаптер AppLovin Android версии 9.4.2.0.
  • Поддерживает адаптер AppLovin iOS версии 6.6.1.0.

Версия 4.1.0

  • Обновлен плагин для поддержки новой открытой бета-версии Rewarded API.
  • Поддерживает адаптер AppLovin Android версии 9.2.1.1.
  • Поддерживает адаптер AppLovin iOS версии 6.3.0.0.

Версия 4.0.0

  • Поддерживает адаптер AppLovin Android версии 9.2.1.0.
  • Поддерживает адаптер AppLovin iOS версии 6.2.0.0.

Версия 3.1.2

  • Поддерживает адаптер AppLovin Android версии 8.1.4.0.
  • Поддерживает адаптер AppLovin iOS версии 5.1.2.0.

Версия 3.1.1

  • Поддерживает адаптер AppLovin Android версии 8.1.0.0.
  • Поддерживает адаптер AppLovin iOS версии 5.1.1.0.

Версия 3.1.0

  • Поддерживает адаптер AppLovin Android версии 8.1.0.0.
  • Поддерживает адаптер AppLovin iOS версии 5.1.0.0.

Версия 3.0.3

  • Поддерживает адаптер AppLovin Android версии 8.0.2.1.
  • Поддерживает адаптер AppLovin iOS версии 5.0.2.0.

Версия 3.0.2

  • Поддерживает AppLovin Android SDK версии 8.0.1.
  • Поддерживает AppLovin iOS SDK версии 5.0.1.

Версия 3.0.1

  • Поддерживает AppLovin Android SDK версии 8.0.0.
  • Поддерживает AppLovin iOS SDK версии 5.0.1.
  • Добавлен метод AppLovin.SetIsAgeRestrictedUser() указывающий, принадлежит ли пользователь к категории с возрастными ограничениями.

Версия 3.0.0

  • Поддерживает AppLovin Android SDK версии 8.0.0.
  • Поддерживает AppLovin iOS SDK версии 5.0.1.
  • Добавлен метод AppLovin.SetHasUserConsent() для пересылки флага согласия пользователя в AppLovin SDK.

Версия 2.0.0

  • Поддерживает AppLovin Android SDK версии 7.8.6.
  • Поддерживает AppLovin iOS SDK версии 5.0.1.

Версия 1.2.1

  • Поддерживает AppLovin Android SDK версии 7.8.6.
  • Поддерживает AppLovin iOS SDK версии 4.8.3.

Версия 1.2.0

  • Поддерживает AppLovin Android SDK версии 7.8.5.
  • Поддерживает AppLovin iOS SDK версии 4.8.3.

Версия 1.1.0

  • Поддерживает AppLovin Android SDK версии 7.7.0.
  • Поддерживает AppLovin iOS SDK версии 4.7.0.

Версия 1.0.0

  • Первый выпуск!
  • Поддерживает AppLovin Android SDK версии 7.4.1.
  • Поддерживает AppLovin iOS SDK версии 4.4.1.