В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из myTarget с помощью медиации , включая интеграцию по принципу водопада. В нем рассказывается, как добавить myTarget в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер myTarget в приложение 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, вам необходимо настроить каждую из них отдельно.
Android
Далее укажите URL-адрес вашего приложения в Google Play .

iOS
Далее укажите URL-адрес вашего приложения в iTunes **.

При добавлении приложения myTarget требует создания рекламного блока, прежде чем вы сможете завершить процесс.
Баннер
Выберите формат рекламы «БАННЕР» , а затем нажмите кнопку «ДОБАВИТЬ РЕКЛАМНЫЙ БЛОК» .

Интерстициальный
Выберите формат «МЕЖСТАНЦИОННАЯ РЕКЛАМА» из доступных, а затем нажмите кнопку «ДОБАВИТЬ РЕКЛАМНЫЙ БЛОК» .

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

Родной
Выберите формат нативной рекламы из доступных, а затем нажмите «Добавить рекламный блок» .

На странице с подробной информацией о вашем рекламном блоке запишите идентификатор слота, который можно найти в настройках рекламного блока как 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.
Настройте параметры медиации для вашего рекламного блока.
Android
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Добавьте Mail.ru в список рекламных партнеров, соответствующих требованиям GDPR и законодательства штатов США.
Чтобы добавить Mail.ru в список рекламных партнеров, соответствующих европейским и американским государственным нормативным актам, в пользовательском интерфейсе AdMob, выполните действия, описанные в настройках европейских и американских нормативных актов .
Шаг 3: Импортируйте SDK и адаптер myTarget.
Интеграция через pub.dev
Добавьте следующую зависимость с последними версиями SDK и адаптера myTarget в файл pubspec.yaml вашего пакета:
dependencies:
gma_mediation_mytarget: ^1.7.0
Ручная интеграция
Загрузите последнюю версию плагина Google Mobile Ads Mediation для myTarget , распакуйте загруженный файл и добавьте распакованную папку плагина (и ее содержимое) в свой проект Flutter. Затем добавьте ссылку на плагин в файл pubspec.yaml , добавив следующую зависимость:
dependencies:
gma_mediation_mytarget:
path: path/to/local/package
Шаг 4: Внедрите настройки конфиденциальности в SDK myTarget.
Инструкции см. в шаге 4 руководства для Android и iOS .
Шаг 5: Добавьте необходимый код
Android
Для интеграции с myTarget дополнительный код не требуется.
iOS
Интеграция SKAdNetwork
Чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта, следуйте документации myTarget .
Шаг 6: Протестируйте свою реализацию.
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство в AdMob и включили тестовый режим в пользовательском интерфейсе myTarget.
Проверить тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от myTarget, включите тестирование одного источника объявлений в инспекторе объявлений, используя источник(и) объявлений myTarget (Waterfall) .
коды ошибок
Если адаптер не получает объявление от myTarget, издатели могут проверить основную причину ошибки в ответе на объявление, используя ResponseInfo в следующих классах:
Android
com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter
iOS
GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded
Вот коды и соответствующие сообщения, которые выдает адаптер myTarget, когда реклама не загружается:
Android
| Код ошибки | Причина |
|---|---|
| 100 | SDK myTarget вернул ошибку. |
| 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.5.0 (в разработке)
Версия 1.4.0
- Поддерживает адаптер myTarget для Android версии 5.27.2.0 .
- Поддерживает адаптер myTarget для iOS версии 5.33.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.3.0
- Поддерживает адаптер myTarget для Android версии 5.27.1.1 .
- Поддерживает адаптер myTarget для iOS версии 5.31.1.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.2.0
- Поддерживает адаптер myTarget для Android версии 5.27.1.1 .
- Поддерживает адаптер myTarget для iOS версии 5.29.1.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.1.0
- Поддерживает адаптер myTarget для Android версии 5.27.1.1 .
- Поддерживает адаптер myTarget для iOS версии 5.28.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.0.0
- Первый релиз.
- Поддерживает адаптер myTarget для Android версии 5.27.1.0 .
- Поддерживает адаптер myTarget для iOS версии 5.24.1.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 5.3.1.