В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из AppLovin с помощью медиации , включая интеграцию ставок и водопада. В нем рассказывается, как добавить AppLovin в конфигурацию медиации рекламного блока, а также как интегрировать AppLovin SDK и адаптер в Flutter приложение.
Поддерживаемые интеграции и форматы объявлений
Ad Manager Адаптер-посредник для AppLovin имеет следующие возможности:
Интеграция | |
---|---|
Торги | |
Водопад | |
Форматы | |
Баннер | 1 |
Межстраничный | |
Награжден |
Баннерная реклама (за исключением баннеров MREC) поддерживается только в медиации. Назначение ставок не поддерживает какие-либо типы баннерной рекламы.
Требования
- Последняя версия Google Mobile Ads SDK
- Флаттер 3.7.0 или выше
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий Flutter проект, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе « Начало работы ».
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе AppLovin.
Зарегистрируйтесь или войдите в свою учетную запись AppLovin.
Чтобы настроить рекламный блок AdMob, вам понадобится ключ AppLovin SDK и ключ отчета . Чтобы найти их, перейдите в пользовательский интерфейс AppLovin > Учетная запись > Ключи , чтобы увидеть оба значения.
Если вы планируете просто интегрировать назначение ставок, вы можете перейти к настройке параметров медиации .
Выберите приложение для медиации
Торги
Этот шаг не требуется для интеграции ставок.
Водопад
В пользовательском интерфейсе AppLovin выберите «Приложения» в разделе «Монетизация» , чтобы перейти к зарегистрированным приложениям. Выберите приложение, которое вы хотите использовать с медиацией, из списка доступных приложений.
Создать зону
Торги
Этот шаг не требуется для интеграции ставок.
Водопад
В пользовательском интерфейсе AppLovin выберите «Зоны» в разделе «Монетизация» , чтобы получить доступ к зарегистрированным идентификаторам зон. Если вы уже создали необходимые зоны для своего приложения, перейдите к шагу 2 . Чтобы создать новый идентификатор зоны, нажмите «Создать зону» .
Введите имя зоны , выберите Android в качестве платформы и выберите тип объявления .
Настройте цены для зоны, выбрав « Фиксированная цена за тысячу показов» или «Оптимизировано AppLovin» . Цены за тысячу показов можно настроить для каждой страны с помощью опции «Фиксированная цена за тысячу показов» . Затем нажмите Сохранить .
Андроид
iOS
После создания зоны ее идентификатор можно найти в столбце «Идентификатор зоны» .
Андроид
iOS
Включите тестовый режим
Следуйте инструкциям в руководстве по тестовому режиму AppLovin MAX о том, как включить тестовые объявления AppLovin.
Шаг 2. Настройте запрос AppLovin в Ad Manager пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства поАндроид .
iOS
Инструкции см. в шаге 2 руководства поiOS .
Добавьте AppLovin Corp. в список рекламных партнеров GDPR и государственных нормативов США.
Следуйте инструкциям внастройки GDPRиНастройки регулирования штата СШАдобавитьAppLovin Corp. в соответствии с GDPR и правилами штата США, список рекламных партнеров в списке Ad Manager Пользовательский интерфейс.
,Следуйте инструкциям внастройки GDPRиНастройки регулирования штата СШАдобавитьAppLovin Corp. в соответствии с GDPR и правилами штата США, список рекламных партнеров в списке Ad Manager Пользовательский интерфейс.
,Следуйте инструкциям внастройки GDPRиНастройки регулирования штата СШАдобавитьAppLovin Corp. в соответствии с GDPR и правилами штата США, список рекламных партнеров в списке Ad Manager Пользовательский интерфейс.
Шаг 3. Импортируйте AppLovin SDK и адаптер.
Интеграция через pub.dev
Добавьте следующую зависимость с последними версиямиAppLovin SDK и адаптер в файле pubspec.yaml
вашего пакета:
dependencies:
gma_mediation_applovin: ^1.0.0
Ручная интеграция
Загрузите последнюю версию плагина медиации Google Mobile Ads дляAppLovin , извлеките загруженный файл и добавьте извлеченную папку плагина (и ее содержимое) в свой проект Flutter. Затем укажите ссылку на плагин в файле pubspec.yaml
, добавив следующую зависимость:
dependencies:
gma_mediation_applovin:
path: path/to/local/package
Шаг 4. Реализуйте настройки конфиденциальности в AppLovin SDK.
Согласие ЕС и GDPR
В соответствии с Политикой согласия пользователей Google из ЕС вы должны гарантировать, что пользователям в Европейской экономической зоне (ЕЭЗ) будет предоставлена определенная информация и получено от них согласие на использование идентификаторов устройств и личных данных. Эта политика отражает требования Директивы ЕС об электронной конфиденциальности и Общего регламента защиты данных (GDPR). При запросе согласия вы должны указать каждую рекламную сеть в вашей цепочке посредничества, которая может собирать, получать или использовать персональные данные, а также предоставлять информацию об использовании каждой сети. В настоящее время Google не может автоматически передавать выбор согласия пользователя в такие сети.
AppLovin поддерживает чтение строки согласия из общих настроек и соответствующую настройку статуса согласия. Если выне используя CMP, который записывает строку согласия в общие настройки, вы можете использоватьGmaMediationApplovin.setHasUserConsent()
и GmaMediationApplovin.setIsAgeRestrictedUser()
методы. В следующем примере кода показано, как передать информацию о согласии в AppLovin SDK. Эти параметры необходимо настроить до инициализации Google Mobile Ads SDK , чтобы обеспечить их правильную пересылку в AppLovin SDK.
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);
Дополнительную информацию см. в настройках конфиденциальности AppLovin .
Законы о конфиденциальности штатов США
Законы о конфиденциальности штатов США требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (согласно определению этих условий в законе), при этом отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на странице «продажа». " Домашняя страница партии. Руководство по соблюдению законов о конфиденциальности штатов США предлагает возможность включить ограниченную обработку данных для показа рекламы Google, но Google не может применить этот параметр к каждой рекламной сети в вашей цепочке медиации. Таким образом, вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать инструкциям каждой из этих сетей, чтобы обеспечить соблюдение требований.
Плагин медиации Google Mobile Ads для AppLovinвключает в себяGmaMediationApplovin.setDoNotSell()
метод. В следующем примере кода показано, как передать информацию о согласии в AppLovin SDK. Эти параметры необходимо настроить до инициализации Google Mobile Ads SDK , чтобы обеспечить их правильную пересылку в AppLovin SDK.
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setDoNotSell(true);
Дополнительную информацию см. в документации по конфиденциальности AppLovin .
Шаг 5. Добавьте необходимый код.
Андроид
Для интеграции AppLovin не требуется никакого дополнительного кода.
iOS
Интеграция со SKAdNetwork
Следуйте документации AppLovin , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.
Шаг 6. Проверьте свою реализацию
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство дляAd Manager и включите тестовый режим в AppLovin Пользовательский интерфейс.
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления отAppLovin, включите тестирование одного источника объявлений в Инспекторе объявлений с помощью AppLovin (Bidding) and AppLovin (Waterfall) источник(и) рекламы.
,Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство дляAd Manager и включите тестовый режим в AppLovin Пользовательский интерфейс.
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления отAppLovin, включите тестирование одного источника объявлений в Инспекторе объявлений с помощью AppLovin (Bidding) and AppLovin (Waterfall) источник(и) рекламы.
,Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство дляAd Manager и включите тестовый режим в AppLovin Пользовательский интерфейс.
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления отAppLovin, включите тестирование одного источника объявлений в Инспекторе объявлений с помощью AppLovin (Bidding) and AppLovin (Waterfall) источник(и) рекламы.
Дополнительные шаги
Сетевые параметры
Адаптер AppLovin поддерживает передачу объекта AppLovinMediationExtras
в запрос объявления для установки параметров, специфичных для сети. В следующем примере кода показано, как отключить звук в видеорекламе с помощью параметра isMuted
:
AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)
AdRequest request = AdRequest(
keywords: <String>['foo', 'bar'],
contentUrl: 'http://foo.com/bar.html',
mediationExtras: [applovinExtras],
);
Оптимизации
Добавление звонка вGmaMediationApplovin.initializeSdk('sdkKey')
к вашей активности запуска предоставляет 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, настроенные в Ad Manager Пользовательский интерфейс отсутствует/недействителен. |
103 | Не удалось показать рекламу AppLovin. |
104 | Запрошено несколько объявлений для одной зоны. AppLovin может загружать только одно объявление одновременно в каждой зоне. |
105 | Ключ AppLovin SDK не найден. |
107 | Токен ставки пуст. |
108 | Адаптер AppLovin не поддерживает запрошенный формат объявления. |
110 | AppLovin отправил успешный обратный вызов загрузки, но не загрузил рекламу. |
Журнал изменений адаптера AppLovin Flutter Mediation
1.2.0
- Подтверждена совместимость с адаптером AppLovin Android версии 12.6.1.0.
- Проверенная совместимость с адаптером AppLovin iOS версии 12.6.1.0.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.1.0.
1.1.0
- API для GmaMediationApplovin больше не является статичным.
- Подтверждена совместимость с адаптером AppLovin Android версии 12.4.3.0.
- Проверенная совместимость с адаптером AppLovin iOS версии 12.4.2.0.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.1.0.
1.0.0
- Первоначальный выпуск.
- Проверенная совместимость с адаптером AppLovin Android версии 12.3.0.0.
- Проверенная совместимость с адаптером AppLovin iOS версии 12.2.1.0.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.0.0.