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

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

Интегрируйте Pangle с назначением ставок

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

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

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

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

Требования

Цель развертывания iOS 10.0 или выше
[Для торгов]: Чтобы интегрировать все поддерживаемые форматы рекламы в торги, используйте адаптер Pangle 5.4.1.1.0 или выше ( рекомендуется последняя версия ).

Последняя версия Google Mobile Ads SDK
Завершить посредничество . Руководство по началу работы.

Шаг 1: Настройка конфигураций в Pangle UI

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

Добавить новое приложение

Перейдите на вкладку «Приложения» и нажмите кнопку «Добавить приложение» .

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

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

Создать место размещения рекламы

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

Торги

Выберите формат рекламы и название места размещения , а также выберите «In-App Bidding» в качестве типа ценообразования . Заполните оставшуюся часть формы и нажмите «Отправить» .

После создания места размещения рекламы запишите идентификатор места размещения рекламы .

Водопад

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

После создания места размещения рекламы запишите идентификатор места размещения рекламы .

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

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

Чтобы реализовать app-ads.txt для Pangle, ознакомьтесь со статьей Как добавить Pangle в файл app-ads.txt .

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

Следуйте инструкциям в руководстве Pangle «Как добавить тестовое объявление» по включению тестовых объявлений Pangle.

Шаг 2: Настройте спрос Pangle в пользовательском интерфейсе Менеджера объявлений

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

Добавить Pangle в компании

Торги

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

Водопад

Перейдите в раздел «Администрирование» > «Компании» , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите «Рекламная сеть» .

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

Имя пользователя и пароль вводить не нужно. Нажмите «Сохранить» по завершении.

Включить безопасный обмен сигналами

Торги

Перейдите в раздел «Администрирование» > «Глобальные настройки» . Перейдите на вкладку «Настройки аккаунта Ad Exchange» , проверьте и включите опцию «Безопасный обмен сигналами» . Нажмите «Сохранить» .

Водопад

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

Поделиться защищенным сигналом в запросах ставок

Торги

Перейдите в раздел «Инвентарь» > «Защищённые сигналы» . В разделе «Защищённые сигналы» найдите Pangle DSP и включите опцию «Включить интеграцию с приложением» .

Нажмите «Сохранить» .

Водопад

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

Разрешить безопасный обмен сигналами для SDK Bidding

Торги

Перейдите в раздел «Доставка» > «Настройки канала спроса» . На вкладке «Настройки по умолчанию» включите опцию «Разрешить безопасный обмен сигналами для торгов SDK» .

Нажмите «Сохранить» .

Водопад

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

Настроить ставки Pangle

Торги

Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .

Нажмите кнопку «Новый участник торгов» .

Выберите Pangle в качестве участника торгов.

Нажмите «Продолжить» , чтобы включить функцию ставок SDK для этого участника торгов.

Нажмите Готово .

Водопад

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

Настроить сопоставление рекламных блоков

Торги

Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .

Выберите компанию для Pangle.

Перейдите на вкладку Сопоставление рекламного блока и нажмите Новое сопоставление рекламного блока .

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

Водопад

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

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

Выберите компанию, созданную для Pangle в предыдущем разделе. Выберите Mobile SDK mediation в качестве типа интеграции , iOS в качестве платформы и Active в качестве статуса .

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

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

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

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

CocoaPods (рекомендуется)

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

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

Загрузите последнюю версию Pangle SDK для iOS и свяжите все файлы и пакеты .framework в вашем проекте.
Загрузите последнюю версию адаптера Pangle по ссылке в журнале изменений и добавьте PangleAdapter.xcframework в свой проект.

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

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

Адаптер Pangle предоставляет метод +setGDPRConsent: который пересылает информацию о согласии адаптеру Pangle, а затем в Pangle SDK. Следующий пример кода показывает, как передать информацию о согласии в Pangle SDK. Задайте информацию о согласии до инициализации Google Mobile Ads SDK, чтобы обеспечить её корректную передачу в Pangle SDK.

Быстрый

import PAGAdSDK
import PangleAdapter
// ...

GADMediationAdapterPangle.setGDPRConsent(PAGGDPRConsentType.consent.rawValue)

Objective-C

#import <PAGAdSDK/PAGSdk.h>
#import <PangleAdapter/PangleAdapter.h>
// ...

[GADMediationAdapterPangle setGDPRConsent:PAGGDPRConsentTypeConsent];

Более подробную информацию и значения, которые можно указать в каждом методе, см. в руководстве Pangle по интеграции с iOS.

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

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

Адаптер Pangle предоставляет метод +setPAConsent: который пересылает информацию о согласии адаптеру Pangle, а затем в Pangle SDK. Следующий пример кода показывает, как передать информацию о согласии в Pangle SDK. Задайте информацию о согласии до инициализации Google Mobile Ads SDK, чтобы гарантировать её корректную передачу в Pangle SDK.

Быстрый

import PAGAdSDK
import PangleAdapter
// ...

GADMediationAdapterPangle.setPAConsent(PAGPAConsentType.consent.rawValue)

Objective-C

#import <PAGAdSDK/PAGSdk.h>
#import <PangleAdapter/PangleAdapter.h>
// ...

[GADMediationAdapterPangle setPAConsent:PAGPAConsentTypeConsent];

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

Интеграция SKAdNetwork

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

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

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

Обязательно зарегистрируйте свое тестовое устройство в Ad Manager и включите тестовый режим в Pangle UI.

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

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

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

Нативная реклама

Рендеринг рекламы

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

Поле	Активы всегда включены адаптером Pangle
Заголовок
Изображение	1
Тело
Икона
Призыв к действию
Звездный рейтинг
Магазин
Цена
Рекламодатель

¹ Адаптер Pangle не предоставляет прямого доступа к основному изображению для нативной рекламы. Вместо этого адаптер заполняет GADMediaView видео или изображением.

Коды ошибок

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

GADMediationAdapterPangle

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

Код ошибки	Домен	Причина
101	com.google.ads.mediation.pangle	Неверные параметры сервера (например, отсутствует идентификатор приложения или идентификатор размещения).
102	com.google.ads.mediation.pangle	Запрошенный размер объявления не соответствует поддерживаемому Pangle размеру баннера.
-1-60000	Отправлено Pangle SDK	Pangle SDK вернул ошибку. Подробнее см. в документации Pangle.