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

Интегрируйте DT Exchange с посредничеством

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

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

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

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

Требования

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

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

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

Добавить новое приложение и место размещения рекламы

Зарегистрируйтесь или войдите в консоль DT Exchange.

Нажмите кнопку «Добавить приложение», чтобы добавить свое приложение.

Управление приложениями

Выберите платформу , заполните оставшуюся часть формы и нажмите «Добавить места размещения» .

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

Настраивать

Идентификатор приложения и идентификатор места размещения

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

На странице «Управление приложениями» запишите идентификатор приложения рядом с вашим приложением.

Идентификатор приложения

Выберите свое приложение, перейдите на вкладку «Места размещения» и нажмите значок копирования рядом с названием места размещения . Обратите внимание на идентификатор места размещения .

Идентификатор места размещения

Идентификатор издателя, ключ потребителя и секрет потребителя

Нажмите на свое имя пользователя в меню слева и выберите «Профиль пользователя» .

Запишите идентификатор издателя , ключ потребителя и секрет потребителя , поскольку они понадобятся на следующем шаге.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Добавьте DT Exchange (монетизация Fyber) в список рекламных партнеров GDPR и государственных нормативов США.

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

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

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

Добавьте следующую строку в подфайл вашего проекта:

pod 'GoogleMobileAdsMediationFyber'

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

pod install --repo-update

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

Загрузите последнюю версию DT Exchange SDK для iOS и свяжите со своим проектом следующие платформы:
- IASDKCore.framework
- IASDKMRAID.framework
- IASDKVideo.framework
Загрузите последнюю версию адаптера DT Exchange по ссылке в журнале изменений и свяжите FyberAdapter.framework в своем проекте.
Добавьте в свой проект следующие фреймворки:
- libxml2.2.tbd

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

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

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

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

Быстрый

import IASDKCore
// ...

IASDKCore.sharedInstance().gdprConsent = IAGDPRConsentType.given
IASDKCore.sharedInstance().gdprConsentString = "myGdprConsentString"

Цель-C

#import <IASDKCore/IASDKCore.h>
// ...

[IASDKCore.sharedInstance setGDPRConsent:YES];
[IASDKCore.sharedInstance setGDPRConsentString:@"myGdprConsentString"];

Посетите страницу ресурсов GDPR DT Exchange и руководство по внедрению GDPR для получения более подробной информации и значений, которые могут быть предоставлены в этом методе.

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

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

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

Быстрый

import IASDKCore
// ...

IASDKCore.sharedInstance().ccpaString = "myCCPAConsentString"

Цель-C

#import <IASDKCore/IASDKCore.h>
// ...

[IASDKCore.sharedInstance setCCPAString:@"myCCPAConsentString"];

Посетите страницу ресурсов CCPA DT Exchange и руководство по реализации CCPA для получения более подробной информации и значений, которые могут быть предоставлены в этом методе.

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

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

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

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

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

Обязательно зарегистрируйте тестовое устройство в AdMob.

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

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

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

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

Адаптер DT Exchange поддерживает дополнительные параметры запроса, которые можно передать адаптеру с помощью GADMAdapterFyberExtras() . Адаптер ищет в комплекте следующие ключи:

Параметры и значения запроса
`setUserData` Возраст, пол и почтовый индекс пользователя.	`IAUserData`
`setMuteAudio`	Логическое значение . Отключить или включить звук видео

Вот пример кода, показывающий, как задать эти параметры запроса объявления:

Быстрый

let userData = IAUserData.build({ builder in
  builder.age = 23
  builder.gender = IAUserGenderType.male
  builder.zipCode = "1234"
}];

let request = GADRequest()
let extras = GADMAdapterFyberExtras()
extras.userData = userData
extras.muteAudio = true
request.register(extras)

Цель-C

IAUserData *userData = [IAUserData build:^(id<IAUserDataBuilder> _Nonnull builder) {
    builder.age = 23;
    builder.gender = IAUserGenderTypeMale;
    builder.zipCode = @"1234";
}];

GADRequest *request = [GADRequest request];
GADMAdapterFyberExtras *extras = [[GADMAdapterFyberExtras alloc] init];
extras.userData = userData;
extras.muteAudio = YES;
[request registerAdNetworkExtras:extras];

Дополнительную информацию см. в руководстве по интеграции DT Exchange .

Коды ошибок

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

GADMediationAdapterFyber

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

Код ошибки	Причина
0-10	DT Exchange SDK возвратил ошибку. Более подробную информацию смотрите в документации .
101	Параметры сервера DT Exchange, настроенные в пользовательском интерфейсе AdMob, отсутствуют или недействительны.
102	Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому DT Exchange.
103	Не удалось показать объявление, поскольку объект объявления уже использовался.
104	Не удалось показать объявления DT Exchange, поскольку объявление не готово.
105	DT Exchange SDK возвратил ошибку инициализации.