В этом руководстве показано, как использовать 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. Перейдите на страницу приложений, нажав на APPS в заголовке. Добавьте свое приложение, нажав ДОБАВИТЬ ПРИЛОЖЕНИЕ .
Если ваше приложение поддерживает платформы Android и iOS, вам необходимо настроить каждую из них отдельно.
андроид
Затем укажите URL-адрес вашего приложения в Google Play .
iOS
Затем укажите URL-адрес iTunes ** для вашего приложения.
При добавлении приложения myTarget требует создания рекламного блока, прежде чем вы сможете завершить процесс.
Баннер
Выберите БАННЕР из доступных форматов рекламы, а затем нажмите кнопку ДОБАВИТЬ РЕКЛАМНЫЙ БЛОК .
Интерстициальный
Выберите INTERSTITIAL из доступных форматов рекламы, а затем нажмите кнопку ДОБАВИТЬ РЕКЛАМНЫЙ БЛОК .
Награжден
Выберите ВИДЕО С ВОЗНАГРАЖДЕНИЕМ из доступных форматов рекламы, а затем нажмите кнопку ДОБАВИТЬ РЕКЛАМНЫЙ БЛОК .
Родной
Выберите 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 mediation для 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 myTarget
Версия 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.