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

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

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

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

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

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

Требования

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

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

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

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

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

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

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

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

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

Награжден

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

Родной

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

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

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

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

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

Шаг 2. Настройте спрос myTarget в интерфейсе Менеджера рекламы.

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

Войдите в свою учетную запись Менеджера рекламы .

Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Новая группа доходности» .

Введите уникальное имя для своей группы доходности, установите статус « Активно» , выберите формат объявления и установите тип инвентаря « Мобильное приложение» . В разделе «Таргетинг» > «Инвентарь» выберите рекламный блок в разделе «Инвентарь и мобильное приложение» , к которому вы хотите добавить агрегатор.

Затем нажмите кнопку «Добавить партнера по доходности» .

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

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

Включите Автоматический сбор данных и введите Токен постоянного доступа, полученный в предыдущем разделе.

После выбора партнера по доходности выберите Mobile SDK Mediation в качестве типа интеграции , iOS в качестве платформы и Активный в качестве статуса . Введите идентификатор слота , полученный в предыдущем разделе. Затем введите значение цены за тысячу показов по умолчанию .

Когда закончите, нажмите «Сохранить» внизу страницы.

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

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

Шаг 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. Проверьте свою реализацию

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

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

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

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

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

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

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

Быстрый

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

Цель-C

GAMRequest *request = [GAMRequest 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, настроенные в пользовательском интерфейсе Менеджера рекламы, отсутствуют/недействительны.
102	Адаптер myTarget не поддерживает запрошенный формат объявления.
103	Пытался показать незагруженное объявление myTarget.
104	Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому myTarget.
105	Отсутствуют необходимые ресурсы нативной рекламы.