В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из myTarget с помощью медиации , включая каскадную интеграцию. В нём также рассказывается, как добавить myTarget в конфигурацию медиации рекламного блока, а также как интегрировать myTarget SDK и адаптер в приложение Flutter.
Поддерживаемые интеграции и форматы рекламы
Интеграция | |
---|---|
Торги | |
Водопад | |
Форматы | |
Баннер | |
Интерстициальный | |
Награжден | |
Вознагражденный интерстициальный | |
Родной |
Требования
- Последняя версия Google Mobile Ads SDK
- Flutter 3.7.0 или выше
- Для развертывания на Android
- Android API уровня 23 или выше
- Для развертывания на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий проект Flutter, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
- Завершить посредничество . Руководство по началу работы.
Шаг 1: Настройте конфигурации в пользовательском интерфейсе myTarget
Войдите в свою учётную запись myTarget. Перейдите на страницу «Приложения», нажав «ПРИЛОЖЕНИЯ» в заголовке. Добавьте приложение, нажав «ДОБАВИТЬ ПРИЛОЖЕНИЕ» .
Если ваше приложение поддерживает обе платформы: Android и iOS, вам необходимо настроить каждую из них отдельно.
Андроид
Затем укажите URL-адрес вашего приложения в Google Play .
iOS
Затем укажите URL-адрес iTunes ** для вашего приложения.
При добавлении приложения myTarget требует создания рекламного блока, прежде чем вы сможете завершить процесс.
Баннер
Выберите БАННЕР из доступных форматов рекламы, а затем нажмите кнопку ДОБАВИТЬ РЕКЛАМНЫЙ БЛОК .
Интерстициальный
Выберите INTERSTITIAL из доступных форматов рекламы, а затем нажмите кнопку ДОБАВИТЬ РЕКЛАМНЫЙ БЛОК .
Награжден
Выберите REWARDED VIDEO из доступных форматов рекламы, а затем нажмите кнопку ДОБАВИТЬ РЕКЛАМНЫЙ БЛОК .
Родной
Выберите NATIVE из доступных форматов объявлений, а затем нажмите ДОБАВИТЬ РЕКЛАМНЫЙ БЛОК .
На странице сведений о вашем рекламном блоке запишите идентификатор слота, который можно найти в настройках рекламного блока как slot_id . Этот идентификатор слота будет использоваться для настройки рекламного блока AdMob в следующем разделе.
Помимо slot_id , вам также понадобится постоянный токен доступа myTarget для настройки идентификатора рекламного блока AdMob. Перейдите на вкладку «Профиль» и выберите «Токены доступа» . Нажмите «Создать токен» или «Показать токен», чтобы увидеть свой постоянный токен доступа myTarget.
Обновите файл app-ads.txt
Файл app-ads.txt для авторизованных продавцов приложений — это инициатива IAB Tech Lab, которая помогает гарантировать, что рекламный инвентарь вашего приложения будет продаваться только через каналы, которые вы указали как авторизованные. Чтобы предотвратить значительную потерю дохода от рекламы, вам необходимо внедрить файл app-ads.txt
. Если вы ещё этого не сделали, настройте файл app-ads.txt для своего приложения .
Чтобы реализовать app-ads.txt
для myTarget, см . раздел Как создать и опубликовать файл .
Включить тестовый режим
Следуйте инструкциям в документации myTarget, чтобы добавить и настроить тестовое устройство в пользовательском интерфейсе myTarget.
Шаг 2: Настройте спрос myTarget в пользовательском интерфейсе AdMob
Настройте параметры медиации для вашего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Добавьте Mail.ru в список рекламных партнеров, соответствующих GDPR и государственным нормам США
Следуйте инструкциям в настройках европейского и американского законодательства , чтобы добавить Mail.ru в список рекламных партнеров, соответствующих европейскому и американскому законодательству, в пользовательском интерфейсе AdMob.
Шаг 3: Импортируйте myTarget SDK и адаптер
Интеграция через pub.dev
Добавьте следующую зависимость с последними версиями myTarget SDK и адаптера в файл pubspec.yaml
вашего пакета:
dependencies:
gma_mediation_mytarget: ^
Ручная интеграция
Загрузите последнюю версию плагина-медиатора Google Mobile Ads для myTarget , извлеките скачанный файл и добавьте извлеченную папку плагина (и её содержимое) в свой проект Flutter. Затем добавьте ссылку на плагин в файл pubspec.yaml
, добавив следующую зависимость:
dependencies:
gma_mediation_mytarget:
path: path/to/local/package
Шаг 4: Реализуйте настройки конфиденциальности в myTarget SDK
Инструкции см. в шаге 4 руководства для Android и iOS .
Шаг 5: Добавьте необходимый код
Андроид
Для интеграции myTarget дополнительный код не требуется.
iOS
Интеграция SKAdNetwork
Следуйте документации myTarget , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 6: Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте свое тестовое устройство в AdMob и включите тестовый режим в пользовательском интерфейсе myTarget.
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от myTarget, включите тестирование одного источника объявлений в инспекторе объявлений, используя источник(и) объявлений myTarget (Waterfall ).
Коды ошибок
Если адаптеру не удается получить рекламу от myTarget, издатели могут проверить основную ошибку в ответе на рекламу, используя ResponseInfo
в следующих классах:
Андроид
com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter
iOS
GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded
Вот коды и сопутствующие сообщения, выдаваемые адаптером myTarget, когда реклама не загружается:
Андроид
Код ошибки | Причина |
---|---|
100 | myTarget SDK вернул ошибку. |
101 | Параметры сервера myTarget, настроенные в пользовательском интерфейсе AdMob, отсутствуют/недействительны. |
102 | Запрошенный размер объявления не соответствует поддерживаемому размеру баннера myTarget. |
103 | Запрос объявления не является унифицированным запросом нативного объявления. |
104 | Загруженное нативное объявление из myTarget отличается от запрошенного нативного объявления. |
105 | В загруженном нативном объявлении из myTarget отсутствуют некоторые обязательные ресурсы (например, изображение или значок). |
iOS
Код ошибки | Причина |
---|---|
100 | В myTarget SDK пока нет доступной рекламы. |
101 | Параметры сервера myTarget, настроенные в пользовательском интерфейсе AdMob, отсутствуют/недействительны. |
102 | Адаптер myTarget не поддерживает запрошенный формат рекламы. |
103 | Попытка показать рекламу myTarget, которая не загружена. |
104 | Запрошенный размер объявления не соответствует поддерживаемому размеру баннера myTarget. |
105 | Отсутствуют необходимые нативные рекламные ресурсы. |
Журнал изменений адаптера Flutter Mediation myTarget
Версия 1.4.0
- Поддерживает Android-адаптер myTarget версии 5.27.2.0 .
- Поддерживает адаптер myTarget iOS версии 5.33.0.0 .
- Создано и протестировано с помощью плагина Flutter для Google Mobile Ads версии 6.0.0.
Версия 1.3.0
- Поддерживает Android-адаптер myTarget версии 5.27.1.1 .
- Поддерживает адаптер myTarget iOS версии 5.31.1.0 .
- Создано и протестировано с помощью плагина Flutter для Google Mobile Ads версии 6.0.0.
Версия 1.2.0
- Поддерживает Android-адаптер myTarget версии 5.27.1.1 .
- Поддерживает адаптер myTarget iOS версии 5.29.1.0 .
- Создано и протестировано с помощью плагина Flutter для Google Mobile Ads версии 6.0.0.
Версия 1.1.0
- Поддерживает Android-адаптер myTarget версии 5.27.1.1 .
- Поддерживает адаптер myTarget iOS версии 5.28.0.0 .
- Создано и протестировано с помощью плагина Flutter для Google Mobile Ads версии 6.0.0.
Версия 1.0.0
- Первоначальный выпуск.
- Поддерживает Android-адаптер myTarget версии 5.27.1.0 .
- Поддерживает адаптер myTarget iOS версии 5.24.1.0 .
- Создано и протестировано с помощью плагина Flutter для Google Mobile Ads версии 5.3.1.