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

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

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

AdMob Адаптер медиации для Unity Ads имеет следующие возможности:

Требования

• Последняя версия Google Mobile Ads SDK
• Флаттер 3.7.0 или выше
• Развертывание на Android
  • Android API уровня 21 или выше
• Развертывание на iOS
  • Цель развертывания iOS 12.0 или выше
• Рабочий Flutter проект, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
• Пройдите руководство по началу работы с медиацией

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

Шаг 2. Настройте спрос на Unity Ads в AdMob пользовательский интерфейс

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

Добавлять Unity Ads в соответствии с GDPR и списком рекламных партнеров США.

Выполните действия, описанные вНастройки GDPRиНастройки правил штата США, чтобы добавить Unity Ads в список рекламных партнеров GDPR и правил штата США. в пользовательском интерфейсе AdMob .

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

Интеграция через pub.dev

Добавьте следующую зависимость с последними версиямиUnity Ads SDK и адаптер в файле pubspec.yaml вашего пакета:

dependencies:
  gma_mediation_unity: ^1.0.0

Ручная интеграция

Загрузите последнюю версию плагина медиации Google Mobile Ads дляUnity Ads , извлеките загруженный файл и добавьте извлеченную папку плагина (и ее содержимое) в свой проект Flutter. Затем укажите ссылку на плагин в файле pubspec.yaml , добавив следующую зависимость:

dependencies:
  gma_mediation_unity:
    path: path/to/local/package

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

Согласие ЕС и GDPR

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

Плагин медиации Google Mobile Ads для Unity Adsвключает в себяGmaMediationUnity.setGDPRConsent()метод. В следующем примере кода показано, как передать информацию о согласии в Unity Ads SDK. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setGDPRConsent(true);

Дополнительные сведения и значения, которые можно предоставить в каждом методе, см. в руководствах Unity Ads « Согласие на конфиденциальность и API данных» и «Соблюдение GDPR» .

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

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

Плагин медиации Google Mobile Ads для Unity Adsвключает в себяGmaMediationUnity.setCCPAConsent()метод. В следующем примере кода показано, как передать информацию о согласии в Unity Ads SDK. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setCCPAConsent(true);

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

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

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

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

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

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

Коды ошибок

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

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

GADMAdapterUnity
GADMediationAdapterUnity

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

Журнал изменений адаптера Unity Ads Flutter Mediation

Версия 1.0.0

• Первоначальный выпуск.
• Проверенная совместимость с адаптером Unity Android версии 4.10.0.0.
• Проверенная совместимость с адаптером Unity iOS версии 4.10.0.0.