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

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

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

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

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

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

¹ Баннерная реклама (за исключением баннеров MREC) поддерживается только в медиации. Назначение ставок не поддерживает какие-либо типы баннерной рекламы.

Требования

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

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

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

Зарегистрируйтесь или войдите в свою учетную запись AppLovin.

Чтобы настроить рекламный блок AdMob, вам понадобится ключ AppLovin SDK и ключ отчета . Чтобы найти их, перейдите в пользовательский интерфейс AppLovin > Учетная запись > Ключи , чтобы увидеть оба значения.

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

Выберите приложение для медиации

Торги

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

Водопад

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

Создать зону

Торги

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

Водопад

В пользовательском интерфейсе AppLovin выберите «Зоны» в разделе «Монетизация» , чтобы получить доступ к зарегистрированным идентификаторам зон. Если вы уже создали необходимые зоны для своего приложения, перейдите к шагу 2 . Чтобы создать новый идентификатор зоны, нажмите «Создать зону» .

Введите имя идентификатора зоны , выберите Android в качестве платформы и выберите тип объявления .

Настройте цены для зоны, выбрав « Фиксированная цена за тысячу показов» или «Оптимизировано AppLovin» . Цена за тысячу показов может быть настроена для каждой страны при использовании опции «Фиксированная цена за тысячу показов» . Затем нажмите Сохранить .

После создания зоны ее идентификатор можно найти в столбце «Идентификатор зоны» .

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

Следуйте инструкциям в руководстве AppLovin’s MAX Test Mode о том, как включить тестовые объявления AppLovin.

Шаг 2. Настройте запрос AppLovin в AdMob пользовательский интерфейс

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

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

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

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

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

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

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

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

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

Торги

В карточке «Ставки» в разделе « Источники объявлений » выберите «Добавить источник объявлений» . Затем выберите Аппловин .
Нажмите «Как подписать партнерское соглашение и организовать тендерное партнерство с Applovin».

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

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

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

Водопад

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

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

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

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

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

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

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

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

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

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

Загрузите последнюю версию AppLovin iOS SDK и свяжите ApplovinSDK.framework с вашим проектом.
Загрузите последнюю версию адаптера AppLovin по ссылке в журнале изменений и свяжите ApplovinAdapter.framework в своем проекте.
Добавьте в свой проект следующие фреймворки:
- AdSupport
- AVFoundation
- CoreGraphics
- CoreMedia
- CoreTelephony
- StoreKit
- SystemConfiguration
- UIKit
- WebKit
- libz.tbd

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

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

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

Начиная с версии SDK 12.0.0, AppLovin поддерживает чтение строки согласия изUserDefaultsи соответствующим образом установить статус согласия.

Если вы не используете AppLovin SDK версии 12.0.0+ или не используете CMP, который записывает строку согласия вUserDefaultsвы можете использовать метод setHasUserContent . В следующем примере информация о согласии передается в AppLovin SDK. Вы должны установить эти параметры перед инициализацией Google Mobile Ads SDK , чтобы обеспечить их правильную пересылку в AppLovin SDK.

Быстрый

import AppLovinSDK
// ...

ALPrivacySettings.setHasUserConsent(true)

Цель-C

#import <AppLovinSDK/AppLovinSDK.h>
// ...

[ALPrivacySettings setHasUserConsent:YES];

Дополнительную информацию см. в настройках конфиденциальности AppLovin .

Объявить дочерних пользователей

Начиная с AppLovin SDK 13.0.0, AppLovin больше не поддерживает пользовательские флаги с ограничением по возрасту, и вы не можете инициализировать или использовать AppLovin SDK в отношении «ребенка», как это определено действующим законодательством. Для получения дополнительной информации см. документацию AppLovin наЗапрет на данные детей или использование сервисов для детей или приложений, предназначенных исключительно для детей..

Адаптер AppLovin версии 13.0.0.1 или выше автоматически отключает посредничество AppLovin для приложений, которые декларируют одну из следующих настроек с помощью Google Mobile Ads SDK:

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

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

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

AppLovin SDK включает метод setDoNotSell , позволяющий издателям отказаться от продажи личной информации.

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

Быстрый

import AppLovinSDK
// ...

ALPrivacySettings.setDoNotSell(true)

Цель-C

#import <AppLovinSDK/AppLovinSDK.h>
// ...

[ALPrivacySettings setDoNotSell:YES];

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

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

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

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

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

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

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

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

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

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

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

Адаптер AppLovin поддерживает muteAudio — дополнительную функцию, позволяющую отключить звук в видеорекламе. Этот параметр можно передать адаптеру с помощью класса GADMAdapterAppLovinExtras , и его необходимо задавать при каждом запросе объявления. Вот как это установить:

Быстрый

let request = GADRequest()
let extras = GADMAdapterAppLovinExtras()
extras.muteAudio = false
request.register(extras)

Цель-C

GADRequest *request = [GADRequest request];
GADMAdapterAppLovinExtras * extras = [[GADMAdapterAppLovinExtras alloc] init];
extras.muteAudio = NO;
[request registerAdNetworkExtras:extras];

Оптимизации

Инициализация AppLovin SDK сразу после запуска приложения дает AppLovin возможность отслеживать события сразу после запуска приложения.

Быстрый

let sdk = ALSdk.shared(withKey: "sdkKey")
sdk?.initializeSdk()

Цель-C

ALSdk *sdk = [ALSdk sharedWithKey:@"sdkKey"];
[sdk initializeSdk];

Коды ошибок

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

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

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

Код ошибки	Причина
от -1009 до -1, 204	AppLovin SDK вернул ошибку. Дополнительную информацию см. в документации AppLovin .
101	Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому AppLovin.
102	Параметры сервера AppLovin, настроенные в AdMob Пользовательский интерфейс отсутствует/недействителен.
103	Не удалось показать рекламу AppLovin.
104	Запрошено несколько объявлений для одной зоны. AppLovin может загружать только одно объявление одновременно в каждой зоне.
105	Ключ AppLovin SDK не найден.
107	Токен ставки пуст.
108	Адаптер AppLovin не поддерживает запрошенный формат объявления.
110	AppLovin отправил успешный обратный вызов загрузки, но не загрузил рекламу.
111	Не удалось получить экземпляр AppLovin SDK.
112	Пользователь — ребенок.