Чтобы обсудить наши продукты и оставить отзыв, присоединяйтесь к официальному каналу AdMob Discord на сервере Google Advertising and Measurement Community .

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

Интегрируйте монетизацию Liftoff с медиацией

Выберите платформу: Android (бета-версия)

Android iOS Unity Flutter

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

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

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

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

Требования

Целевая версия iOS для развертывания — 12.0 или выше.
[Для размещения ставок]: Чтобы интегрировать все поддерживаемые форматы объявлений в систему размещения ставок, используйте адаптер Liftoff Monetize версии 7.3.0.0 или выше ( рекомендуется последняя версия ).

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

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

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

Добавьте свое приложение на панель управления Liftoff Monetize , нажав кнопку «Добавить приложение» .

Заполните форму, указав все необходимые данные.

После создания приложения выберите его на панели управления Liftoff Monetize Applications .

Запишите идентификатор приложения .

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

Чтобы создать новое место размещения для использования с AdMob Mediation, перейдите на панель управления Liftoff Monetize Placements , нажмите кнопку «Добавить место размещения» и выберите свое приложение из выпадающего списка.

Подробная информация о добавлении новых мест работы приведена ниже:

Приложение открыто

Выберите «Межстраничная реклама» и введите название размещения . Затем выберите «Да» для параметра «Пропускаемая» и заполните остальную часть формы. [Только ставки] В разделе «Монетизация» переключите переключатель «Встроенные ставки» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать размещение.

Выберите «Баннер» , введите название места размещения и заполните остальную часть формы. [Только ставки] В разделе «Монетизация» переключите переключатель «Встроенные ставки» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.

Выберите MREC , введите название размещения и заполните остальную часть формы. [Только торги] В разделе «Монетизация» переведите переключатель «Торги в приложении» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать размещение.

Интерстициальный

Выберите «Межстраничная реклама» , введите название размещения и заполните остальную часть формы. [Только ставки] В разделе «Монетизация» переключите переключатель «Встроенные ставки» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать размещение.

Награжден

Выберите «Вознаграждение» , введите название размещения и заполните остальную часть формы. [Только ставки] В разделе «Монетизация» переключите переключатель «Встроенные ставки» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать размещение.

Вознагражденный интерстициальный

Выберите «Вознаграждение» . Введите название размещения , включите опцию «Пропускаемый» и заполните остальную часть формы. [Только ставки] В разделе «Монетизация» переключите переключатель «Встроенные ставки» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать размещение.

Родной

Выберите «Нативная реклама» , введите название размещения и заполните остальную часть формы. [Только ставки] В разделе «Монетизация» переключите переключатель «Встроенные ставки» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать размещение.

Запишите идентификатор ссылки и нажмите «Звучит неплохо» .

Приложение открыто

Баннер

Баннер 300x250

Интерстициальный

Награжден

Вознагражденный интерстициальный

Родной

Найдите свой ключ API для создания отчетов.

Торги

Этот шаг не требуется для интеграции с системами торгов.

Водопад

Помимо идентификатора приложения (App ID) и идентификатора ссылки (Reference ID ), вам также понадобится ключ API для отчетов Liftoff Monetize, чтобы настроить идентификатор рекламного блока AdMob. Перейдите на панель управления отчетами Liftoff Monetize и нажмите кнопку «Ключ API для отчетов», чтобы просмотреть свой ключ API для отчетов .

Обновите файл app-ads.txt.

Файл app-ads.txt, созданный в рамках инициативы IAB Tech Lab для авторизованных продавцов рекламы в приложениях , помогает гарантировать, что рекламный инвентарь вашего приложения продается только через каналы, которые вы определили как авторизованные. Чтобы предотвратить значительные потери дохода от рекламы, вам потребуется внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для своего приложения .

Для интеграции файла app-ads.txt с Liftoff Monetize загрузите и добавьте записи из файла app-ads.txt Liftoff Monetize в существующий файл app-ads.txt . Для получения дополнительной информации см. app-ads.txt .

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

Чтобы включить тестовые объявления, перейдите в панель управления Liftoff Monetize и выберите раздел «Приложения» .

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

Шаг 2: Настройте запрос на монетизацию Liftoff в пользовательском интерфейсе AdMob.

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

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

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

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

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

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

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

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

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

Торги

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

Нажмите «Как подписать партнерское соглашение и заключить партнерское соглашение с Liftoff Monetize».

Нажмите «Подтвердить и согласиться» , затем нажмите «Продолжить» .

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

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

Водопад

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

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

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

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

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

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

Используйте менеджер пакетов Swift.

Прежде чем продолжить, у вас должна быть установлена минимальная поддерживаемая версия адаптера 7.5.3.0.

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

В Xcode перейдите в меню Файл > Добавить зависимости пакета... .
В появившемся окне введите следующий URL-адрес пакета:
```
https://github.com/googleads/googleads-mobile-ios-mediation-liftoffmonetize.git
```
В разделе «Правило зависимости» выберите «Ветвь» .
В текстовом поле введите main .

Используйте CocoaPods

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

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

Загрузите последнюю версию Vungle iOS SDK и подключите файл VungleAdsSDK.xcframework к своему проекту.
Загрузите последнюю версию адаптера Liftoff Monetize по ссылке для скачивания в журнале изменений и добавьте ссылку на LiftoffMonetizeAdapter.xcframework в свой проект.
Добавьте в свой проект следующие фреймворки:
- AdSupport
- AudioToolbox
- AVFoundation
- CFNetwork
- CoreGraphics
- CoreMedia
- libz.tbd
- MediaPlayer
- QuartzCore
- StoreKit
- SystemConfiguration

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

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

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

Начиная с версии Vungle SDK 7.4.1, Liftoff Monetize автоматически считывает согласия GDPR, установленные платформами управления согласиями, поддерживающими спецификацию Google Additional Consent , включая UMP SDK . Для получения дополнительной информации см. Рекомендации по внедрению GDPR .

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

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

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

Быстрый

import VungleAdsSDK
// ...

VunglePrivacySettings.setCCPAStatus(true)

Objective-C

#import <VungleAdsSDK/VungleAdsSDK.h>
// ...

[VunglePrivacySettings setCCPAStatus:YES];

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

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

Интеграция SKAdNetwork

Чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта, следуйте документации Liftoff Monetize .

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

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

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

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

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

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

Параметры, специфичные для сети

Адаптер Liftoff Monetize поддерживает дополнительный параметр запроса, который можно передать адаптеру с помощью класса VungleAdNetworkExtras . Этот класс включает следующие свойства:

userId: Строка, представляющая идентификатор пользователя, получающего вознаграждение от Liftoff Monetize.
nativeAdOptionPosition: Целое число, определяющее положение значка конфиденциальности для нативной рекламы.

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

Быстрый

#import "VungleAdapter.h"
// ...

let request = GADRequest()
let extras = VungleAdNetworkExtras()
extras.userId = "myUserID"
extras.nativeAdOptionPosition = 1
// ...
request.register(extras)

Objective-C

#import <LiftoffMonetizeAdapter/VungleAdapter.h>
// ...

GADRequest *request = [GADRequest request];
VungleAdNetworkExtras *extras = [[VungleAdNetworkExtras alloc] init];
extras.userId = @"myUserID";
extras.nativeAdOptionPosition = 1;
// ...
[request registerAdNetworkExtras:extras];

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

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

Поле	Ресурсы всегда включены в адаптер Liftoff Monetize.
Заголовок
Изображение	1
Просмотр медиафайлов
Тело
значок приложения
Призыв к действию
Звездный рейтинг
Магазин
Цена

^1. Адаптер Liftoff Monetize не предоставляет прямого доступа к основному графическому ресурсу для своих нативных объявлений. Вместо этого адаптер заполняет GADMediaView видео или изображением.

коды ошибок

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

Формат	Название класса
Приложение открыто (торги)	GADMediationAdapterVungle
Приложение открыто (водопад)	GADMediationAdapterVungle
Баннер (Торги)	GADMediationAdapterVungle
Баннер (Водопад)	GADMAdapterVungleInterstitial
Интерстициальный (торги)	GADMediationAdapterVungle
Межзернистый (водопад)	GADMAdapterVungleInterstitial
Награждено (за участие в торгах)	GADMediationAdapterVungle
Награда (Водопад)	GADMAdapterVungleRewardBasedВидеообъявление
Вознаграждаемая промежуточная реклама (торги)	GADMediationAdapterVungle
Награждаемый промежуточный элемент (Водопад)	GADMediationAdapterVungle
Нативный (Торги)	GADMediationAdapterVungle
Родной (Водопад)	GADMediationAdapterVungle

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

Код ошибки	Домен	Причина
101	com.google.mediation.vungle	Неверные параметры сервера (например, идентификатор приложения или идентификатор размещения).
102	com.google.mediation.vungle	Для данной конфигурации сети уже загружено объявление. Vungle SDK не может загрузить второе объявление для того же идентификатора размещения.
103	com.google.mediation.vungle	Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Liftoff Monetize.
104	com.google.mediation.vungle	Vungle SDK не смог отобразить баннерную рекламу.
105	com.google.mediation.vungle	Vungle SDK поддерживает загрузку только одного баннерного объявления за раз, независимо от идентификатора места размещения.
106	com.google.mediation.vungle	Vungle SDK отправил обратный вызов, сообщив, что реклама не воспроизводится.
107	com.google.mediation.vungle	Vungle SDK не готов к воспроизведению рекламы.

Для получения информации об ошибках, возникающих в Vungle SDK, обратитесь к разделу «Коды ошибок: Vungle SDK для iOS и Android» .