Эта страница переведена с помощью Cloud Translation API.

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

Выберите платформу: Android iOS Unity Flutter Android (Legacy)

В этом руководстве показано, как использовать GMA Next-Gen SDK для загрузки и отображения рекламы из myTarget с помощью AdMob Mediation , включая интеграцию по принципу водопада. В нем рассказывается, как добавить myTarget в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер myTarget в приложение для Android.

Поддерживаемые интеграции и форматы рекламы

Адаптер посредничества для myTarget обладает следующими возможностями:

Интеграция
Торги
Водопад
Форматы
Баннер
Интерстициальный
Награжден
Родной

Предварительные требования

Прежде чем продолжить, проверьте следующее:

Android API уровня 24 или более поздней версии.

Последняя версия GMA Next-Gen SDK .
Настройте медиацию AdMob .

Шаг 1: Настройка параметров в пользовательском интерфейсе myTarget.

Войдите в свою учетную запись myTarget. Перейдите на страницу «Приложения», нажав на кнопку «ПРИЛОЖЕНИЯ» в заголовке. Добавьте свое приложение, нажав кнопку «ДОБАВИТЬ ПРИЛОЖЕНИЕ» .

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

При добавлении приложения 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.

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

Вам необходимо добавить myTarget в конфигурацию медиации для вашего рекламного блока.

Сначала войдите в свою учетную запись AdMob . Затем перейдите на вкладку «Медиация» . Если у вас уже есть группа медиации, которую вы хотите изменить, щелкните по ее названию, чтобы отредактировать ее, и перейдите к разделу «Добавить myTarget в качестве источника рекламы» .

Чтобы создать новую группу медиации, выберите «Создать группу медиации» .

Укажите формат и платформу вашей рекламы, затем нажмите «Продолжить» .

Присвойте вашей группе посредничества название и выберите регионы для таргетирования. Затем установите статус группы посредничества на «Включено» и нажмите «Добавить рекламные блоки» .

Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите «Готово» .

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

Добавьте myTarget в качестве источника рекламы.

В разделе «Источники рекламы » на вкладке « Водопад » выберите «Добавить источник рекламы» .

Выберите myTarget и включите переключатель «Оптимизировать» . Введите полученный в предыдущем разделе постоянный токен доступа , чтобы настроить оптимизацию источника рекламы для myTarget. Затем введите значение eCPM для myTarget и нажмите «Продолжить» .

Если у вас уже есть сопоставление для myTarget, вы можете его выбрать. В противном случае нажмите «Добавить сопоставление» .

Далее введите идентификатор слота , полученный в предыдущем разделе. Затем нажмите «Готово» .

Примечание : Оптимизация источника рекламы занимает несколько дней, чтобы собрать достаточно данных для точного расчета eCPM для сети медиации. В это время статус оптимизации источника рекламы — PENDING , поэтому вам необходимо вручную установить значение eCPM для сети. Как только eCPM будет рассчитан, источник рекламы автоматически начнет обновлять значение eCPM от вашего имени.

Добавьте Mail.ru в список рекламных партнеров, соответствующих требованиям GDPR и законодательства штатов США.

Чтобы добавить Mail.ru в список рекламных партнеров, соответствующих европейским и американским государственным нормативным актам, в пользовательском интерфейсе AdMob, выполните действия, описанные в настройках европейских и американских нормативных актов .

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

Интеграция с Android Studio (рекомендуется)

В файл gradle на уровне приложения добавьте следующие зависимости реализации и конфигурации:

Котлин

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.4.0")
    implementation("com.google.ads.mediation:mytarget:5.51.2.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Классный

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.4.0'
    implementation 'com.google.ads.mediation:mytarget:5.51.2.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

Для подключения SDK myTarget обратитесь к документации по Android SDK myTarget .
Перейдите к артефактам адаптера myTarget в репозитории Maven от Google. Выберите последнюю версию, загрузите файл .aar адаптера myTarget и добавьте его в свой проект.

Шаг 4: Внедрите настройки конфиденциальности в SDK myTarget.

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

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

В версии SDK 5.1.0 myTarget добавил API для получения согласия пользователя, чтобы обеспечить соблюдение требований конфиденциальности. Следующий пример кода показывает, как передать эту информацию о согласии в SDK myTarget. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через GMA Next-Gen SDK .

Java

MyTargetPrivacy.setUserConsent(true);MyTargetMediationSnippets.java

Котлин

MyTargetPrivacy.setUserConsent(true)MyTargetMediationSnippets.kt

Кроме того, если известно, что пользователь относится к возрастной категории, для передачи информации о согласии в SDK myTarget можно использовать следующий код.

Java

MyTargetPrivacy.setUserAgeRestricted(true);MyTargetMediationSnippets.java

Котлин

MyTargetPrivacy.setUserAgeRestricted(true)MyTargetMediationSnippets.kt

Дополнительную информацию, а также сведения о значениях, которые можно указать в методе, см. в руководстве myTarget по вопросам конфиденциальности и GDPR .

Законы штатов США о защите частной жизни

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

В версии SDK 5.9.0 myTarget добавил API для получения согласия пользователя, чтобы обеспечить соблюдение требований конфиденциальности. Следующий пример кода показывает, как передать эту информацию о согласии в SDK myTarget. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через GMA Next-Gen SDK .

Java

MyTargetPrivacy.setCcpaUserConsent(true);MyTargetMediationSnippets.java

Котлин

MyTargetPrivacy.setCcpaUserConsent(true)MyTargetMediationSnippets.kt

Для получения дополнительной информации и сведений о значениях, которые можно указать в методе, обратитесь в службу поддержки myTarget .

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

Для интеграции с myTarget дополнительный код не требуется.

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

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

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

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

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

Дополнительные шаги

Использование нативной рекламы

Отображение рекламы

Адаптер myTarget возвращает нативную рекламу в виде объектов NativeAd . Он заполняет следующие поля описания нативной рекламы для объекта NativeAd .

Поле	Заполняется адаптером myTarget
Заголовок	Всегда
Изображение	Всегда
Тело	Всегда
значок приложения	Всегда
Призыв к действию	Всегда
Звездный рейтинг	Не гарантировано
Магазин	Не гарантировано
Цена	Не гарантировано
Логотип	Не гарантировано
Рекламодатель	Всегда

SDK myTarget всегда возвращает 0 для ширины и высоты mediaView , поэтому адаптер myTarget всегда возвращает 0 для getAspectRatio() . В будущих версиях SDK myTarget исправит эту проблему.

Отслеживание показов и кликов

GMA Next-Gen SDK использует обратные вызовы myTarget SDK для отслеживания показов и кликов, поэтому отчеты из обоих источников должны совпадать с минимальными расхождениями или вовсе без них.

коды ошибок

Если адаптер не получает объявление от myTarget, вы можете проверить основную причину ошибки в ответе на объявление, используя ResponseInfo.getAdSourceResponses() из следующих классов:

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

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

Код ошибки	Причина
100	SDK myTarget вернул ошибку.
101	Параметры сервера myTarget, настроенные в пользовательском интерфейсе AdMob, отсутствуют/недействительны.
102	Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому myTarget.
103	Запрос на показ рекламы не является запросом на показ нативной рекламы в рамках унифицированной системы.
104	Загруженная нативная реклама от myTarget отличается от запрошенной нативной рекламы.
105	В загруженной нативной рекламе от myTarget отсутствуют некоторые необходимые элементы (например, изображение или иконка).
106	myTarget SDK не смог показать рекламу.

Список изменений адаптера посредничества myTarget для Android