Как интегрировать PubMatic с медиацией

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

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

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

Адаптер PubMatic для медиации в Менеджере рекламы поддерживает следующие возможности:

Интеграция
Ставки
Водопад
Форматы
Открытие приложения
Баннер
Межстраничное объявление  1
Бонус предоставлен  1
Межстраничное объявление с вознаграждением
Стандартное  1

1 Этот формат находится на стадии бета-тестирования. Чтобы получить доступ, обратитесь к менеджеру аккаунта.

Требования

Прежде чем продолжить, убедитесь, что:

  • Последняя версия Google Mobile Ads Flutter Plugin.
  • Фреймворк Flutter версии 3.7.0 или более поздней.
  • Чтобы развернуть приложение на устройстве Android:
    • Android API уровня 24 или более поздней версии.
  • Чтобы развернуть приложение на устройстве iOS:
    • Целевая версия iOS для развертывания – 13.0 или более поздняя.
  • Рабочий проект Flutter, настроенный с помощью Google Mobile Ads Flutter Plugin. Подробные сведения приведены в статье Как настроить Google Mobile Ads Flutter Plugin.
  • Настройте медиацию.

    • Шаг 1. Задайте настройки в интерфейсе PubMatic OpenWrap SDK

    Зарегистрируйтесь или войдите в аккаунт PubMatic и выберите карточку OpenWrap SDK.

    Как добавить новое приложение

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

    Панель управления приложениями

    Выберите платформу, а также укажите URL в магазине приложений и название приложения.

    Android

    В разделе Integration Path (Способ интеграции) выберите Flutter, а в разделе Sub-integration Path (Дополнительный способ интеграции) – AdMob – назначение ставок в SDK. Затем нажмите кнопку Добавить приложение.

    Форма для нового приложения

    iOS

    В разделе Integration Path (Способ интеграции) выберите Flutter, а в разделе Sub-integration Path (Дополнительный способ интеграции) – AdMob – назначение ставок в SDK. Затем нажмите кнопку Добавить приложение.

    Форма для нового приложения

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

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

    Перед завершением настройки приложения вам будет предложено добавить в файл app-ads.txt соответствующие записи.

    app-aps.txt

    Дополнительную информацию о том, как реализовать app-ads.txt для PubMatic, можно найти в статье Как реализовать файл app-ads.txt.

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

    После создания приложения перейдите на вкладку Apps (Приложения) и запишите Profile ID (Идентификатор профиля) нового приложения.

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

    Создайте рекламный блок

    На вкладке Рекламные блоки выберите приложение, созданное в предыдущем разделе, и нажмите кнопку Создать рекламный блок.

    Создание рекламного блока

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

    Форма создания рекламного блока

    Запишите идентификатор рекламного блока OpenWrap.

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

    Как получить идентификатор издателя

    Перейдите на панель управления Аналитики. Наведите указатель мыши на значок профиля и запишите свой идентификатор.

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

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

    Как настроить медиацию для рекламного блока

    Android

    Инструкции приведены в разделе "Шаг 2" Android.

    iOS

    Инструкции приведены в шаге 2 руководства для iOS.

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

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

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

    Интеграция через pub.dev

    (Только для Android) Добавьте следующие репозитории в файл build.gradle в каталоге android проекта:

      repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://repo.pubmatic.com/artifactory/public-repos")
      }
  }

    Добавьте в файл pubspec.yaml пакета следующую зависимость с последними версиями PubMatic OpenWrap SDK и адаптера:

    dependencies:
  gma_mediation_pubmatic: ^2.5.0

    Интеграция с настройкой вручную

    Скачайте последнюю версию плагина медиации Google Mobile Ads для PubMatic OpenWrap SDK, распакуйте скачанный файл и добавьте извлеченную папку плагина (и ее содержимое) в проект Flutter. Затем добавьте в файл pubspec.yaml следующую зависимость:

    dependencies:
  gma_mediation_pubmatic:
    path: path/to/local/package

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

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

    PubMatic автоматически считывает согласие по GDPR, заданное платформами для запросов согласия, которые поддерживают спецификацию Google "Дополнительное согласие", в том числе UMP SDK. Подробнее о том, как передавать информацию о GDPR и согласии по GDPR…

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

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

    PubMatic автоматически считывает согласие, полученное в соответствии с законом CCPA и заданное платформами для запросов согласия, которые поддерживают спецификацию Google "Дополнительное согласие", в том числе UMP SDK. Подробнее о том, как задать строку CCPA…

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

    Android

    Для интеграции с PubMatic не требуется дополнительный код.

    iOS

    Интеграция SKAdNetwork

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

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

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

    Зарегистрируйте тестовое устройство в Менеджере рекламы.

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

    Чтобы убедиться, что вы получаете тестовые объявления из PubMatic OpenWrap SDK, включите тестирование отдельного источника объявлений в инспекторе объявлений, используя источники объявлений PubMatic OpenWrap.

    Коды ошибок

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

    Android

    com.pubmatic.sdk
com.google.ads.mediation.pubmatic

    iOS

    GADMediationAdapterPubMatic

    Ниже приведены коды и сообщения, которые адаптер PubMatic возвращает, когда не удается загрузить объявление.

    Android

    Код ошибки Поместье Причина
    101 com.google.ads.mediation.pubmatic В конфигурации сервера отсутствует обязательный идентификатор издателя.
    102 com.google.ads.mediation.pubmatic Формат объявления не поддерживается PubMatic или отсутствует в данных сигнала RTB.
    103 com.google.ads.mediation.pubmatic Не удалось показать объявление, так как оно не было готово.
    104 com.google.ads.mediation.pubmatic Идентификатор профиля отсутствует или недействителен.
    105 com.google.ads.mediation.pubmatic Идентификатор рекламного блока отсутствует или не указан.
    106 com.google.ads.mediation.pubmatic Возвращенное объявление с вознаграждением имеет значение null.
    107 com.google.ads.mediation.pubmatic Недопустимый размер баннера.
    1001-5002 Отправлено с помощью PubMatic SDK PubMatic SDK вернул ошибку. Подробная информация приведена в документации PubMatic.

    iOS

    Код ошибки Поместье Причина
    101 com.google.ads.mediation.pubmatic В конфигурации сервера отсутствует обязательный идентификатор издателя.
    102 com.google.ads.mediation.pubmatic Запрос на сбор сигналов для назначения ставок не выполнен, поскольку в его параметрах указано несколько форматов, не указан ни один формат или указан неподдерживаемый формат.
    103 com.google.ads.mediation.pubmatic Недопустимая конфигурация объявления для загрузки объявления.
    104 com.google.ads.mediation.pubmatic Не удалось показать межстраничное объявление, так как оно не было готово.
    105 com.google.ads.mediation.pubmatic Не удалось показать объявление с вознаграждением, поскольку оно не было готово.
    106 com.google.ads.mediation.pubmatic Не удалось загрузить один из источников изображений для нативного объявления.
    107 com.google.ads.mediation.pubmatic В конфигурации объявления отсутствует идентификатор издателя.
    108 com.google.ads.mediation.pubmatic В конфигурации объявления отсутствует идентификатор профиля.
    109 com.google.ads.mediation.pubmatic В конфигурации объявления указан идентификатор профиля, который не является числом.
    110 com.google.ads.mediation.pubmatic В конфигурации объявления отсутствует идентификатор рекламного блока.
    111 com.google.ads.mediation.pubmatic Не удалось создать экземпляр размера объявления в PubMatic OpenWrap SDK.
    1001-5002 Отправлено с помощью PubMatic SDK SDK PubMatic вернул ошибку. Подробную информацию можно найти в документации PubMatic.

    Журнал изменений адаптера медиации Pubmatic для Flutter

    Версия 2.5.1 (в разработке)

    Версия 2.5.0

    Версия 2.4.0

    Версия 2.3.1

    Версия 2.3.0

    Версия 2.2.0

    Версия 2.1.0

    Версия 2.0.0

    Версия 1.6.0

    Версия 1.5.0

    Версия 1.4.1

    Версия 1.4.0

    Версия 1.3.0

    Версия 1.2.0

    Версия 1.1.0

    Версия 1.0.0