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

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

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

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

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

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

Требования

Цель развертывания iOS 12.0 или выше

Последняя версия Google Mobile Ads SDK
Пройдите руководство по началу работы с медиацией

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

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

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

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

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

Межстраничный

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

Награжден

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

Родной

Выберите НАТИВНЫЙ из доступных форматов объявлений и нажмите «ДОБАВИТЬ РЕКЛАМНЫЙ БЛОК» .

На странице сведений о рекламном блоке запишите идентификатор рекламного места, который можно найти в настройках рекламного блока как slot_id . Этот идентификатор рекламного места будет использоваться для настройки рекламного блока AdMob в следующем разделе.

Помимо slot_id вам также понадобится токен постоянного доступа myTarget для настройки идентификатора рекламного блока AdMob. Перейдите на вкладку «Профиль» и выберите «Токены доступа» . Нажмите «Создать токен» или «Показать токен», чтобы просмотреть свой токен постоянного доступа myTarget.

Включите тестовый режим

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

Шаг 2. Настройте спрос myTarget в интерфейсе AdMob.

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

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

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

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

Введите формат объявления и платформу, затем нажмите «Продолжить» .

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

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

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

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

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

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

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

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

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

Добавьте Mail.ru в список рекламных партнеров GDPR и государственных нормативов США

Следуйте инструкциям в настройках GDPR и настройках законодательства США , чтобы добавить Mail.ru в список рекламных партнеров GDPR и законодательства США в пользовательском интерфейсе AdMob.

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

Использование CocoaPods (рекомендуется)

Добавьте следующую строку в подфайл вашего проекта:
```
pod 'GoogleMobileAdsMediationMyTarget'
```
Из командной строки выполните:
```
pod install --repo-update
```

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

Загрузите последнюю версию myTarget SDK .
Загрузите последнюю версию адаптера myTarget по ссылке в журнале изменений и свяжите MyTargetAdapter.framework с вашим проектом.
Добавьте в свой проект следующие фреймворки:
- CoreLocation
- CoreTelephony
- CoreMedia
- SystemConfiguration
- StoreKit
- AdSupport
- SafariServices
- AVFoundation

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

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

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

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

Быстрый

import MyTargetSDK
// ...

MTRGPrivacy.setUserConsent(true)

Цель-C

#import <MyTargetSDK/MyTargetSDK.h>
// ...

[MTRGPrivacy setUserConsent:YES];

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

Быстрый

import MyTargetSDK
// ...

MTRGPrivacy.setUserAgeRestricted(true)

Цель-C

#import <MyTargetSDK/MyTargetSDK.h>
// ...

[MTRGPrivacy setUserAgeRestricted:YES];

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

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

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

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

Быстрый

import MyTargetSDK
// ...

MTRGPrivacy.setCcpaUserConsent(true)

Цель-C

#import <MyTargetSDK/MyTargetSDK.h>
// ...

[MTRGPrivacy setCcpaUserConsent:YES];

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

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

Интеграция со SKAdNetwork

Следуйте документации myTarget , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.

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

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

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

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

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

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

Сетевые параметры

Адаптер myTarget поддерживает isDebugMode — дополнительную опцию, позволяющую включить ведение журнала, значение которой по умолчанию — YES . Этот параметр можно передать адаптеру с помощью класса GADMAdapterMyTargetExtras , и его необходимо задавать при каждом запросе объявления. Вот как это установить:

Быстрый

let request = GADRequest()
let extras = GADMAdapterMyTargetExtras()
extras.isDebugMode = false
adRequest.register(extras)

Цель-C

GADRequest *request = [GADRequest request];
GADMAdapterMyTargetExtras * extras = [[GADMAdapterMyTargetExtras alloc] init];
extras.isDebugMode = NO;
[request registerAdNetworkExtras:extras];

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

Рендеринг рекламы

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

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

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

Google Mobile Ads SDK использует обратные вызовы myTarget SDK для отслеживания показов и кликов, поэтому отчеты из обоих источников должны совпадать с небольшими расхождениями или вообще без них.

Коды ошибок

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

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

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

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