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

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

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

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

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

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

Требования

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

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

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

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

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

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

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

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

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

Настраивать

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Обязательно зарегистрируйте тестовое устройство в Менеджере рекламы.

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

Чтобы убедиться, что вы получаете тестовые объявления от 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 = GAMRequest()
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";
}];

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