Руководство по инициированию атрибуции SKAdNetwork

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

SKAdNetwork API от Apple предназначен для измерения успешности рекламных кампаний по установке приложений при сохранении конфиденциальности пользователей. Для SKAdNetwork v2.0 и v2.1 атрибуция установки для объявлений, отображаемых в StoreKit, определяется кликами по объявлению, которые приводят к установке приложения пользователем. SKAdNetwork версии 2.2 и более поздних версиях дополнительно поддерживает рекламу по показам, где атрибуция определяется простым просмотром рекламы.

Следующие рекомендации предназначены для того, чтобы Google Mobile Ads SDK мог правильно инициировать атрибуцию SKAdNetwork.

Атрибуция по клику для мобильных объявлений

По умолчанию атрибуция SKAdNetwork инициируется событием клика по объявлению Google Mobile Ads SDK, только если действие клика конкретно попадает в Apple App Store. Причиной этого требования является предотвращение запуска магазина приложений кликами, которые не предназначены для открытия магазина приложений. Эти типы кликов могут включать, например, переход на страницу выбора рекламы.

Руководящие указания

Чтобы гарантировать, что клики по объявлениям и последующие установки приложения приведут к атрибуции SKAdNetwork, при создании креативов убедитесь, что URL перехода по клику креатива:

  • прямую ссылку на рекламируемое приложение в магазине приложений или,
  • использует методы перенаправления, такие как HTTP 301, 302 или другие типы цепочек перенаправления HTTP на стороне сервера, которые имеют конечный пункт назначения в магазине приложений.

Ссылки на магазин приложений либо напрямую, либо через цепочку перенаправлений подтверждаются, если URL-адрес начинается с любого из следующих шаблонов:

  • https://apps.apple.com
  • https://itunes.apple.com
  • itms-apps://
  • itms://

Любые другие целевые страницы или любые другие методы перенаправления на стороне клиента считаются не попадающими в магазин приложений и могут не инициировать процесс атрибуции SKAdNetwork. Примеры:

  • HTML-страница, требующая действий пользователя для перенаправления в магазин приложений
  • HTML-страница с автоматическим сценарием перенаправления на основе JavaScript в магазин приложений.
  • Мета-теги обновления

Рекомендации для разных типов креативов

Действие по клику для запуска атрибуции SKAdNetwork можно настроить для различных типов объявлений следующим образом:

HTML-креативы
Его можно указать в качестве целевого URL-адреса в тегах привязки, окружающих кликабельный элемент, или в качестве целевого URL-адреса операций window.location из событий щелчка на основе JavaScript.
МРАИД
Действие по клику должно вызывать Mraid.open() , чтобы инициировать атрибуцию SKAdNetwork.
VAST-видео
URL-адрес магазина приложений или начальный элемент цепочки перенаправления можно задать в качестве элемента ClickThrough в XML-файле VAST.
Родной
URL-адрес магазина приложений или начальный элемент цепочки перенаправления можно указать в поле native_ad.click_link_url для прототипа Google RTB или в поле native.link для прототипа OpenRTB.

При желании всегда инициируйте атрибуцию SKAdNetwork

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

Параметр может быть указан как часть поля объекта BidResponse.ad.skadn.skadn_options в ответе заявки Google Authorized Buyers по протоколу:

ad {
  skadn {
    version: "2.0"
    ...

    skadn_options {
      always_open_appstore: true
    }
  }
}

или, как часть поля объекта BidResponse.seat_bid.bid.ext.skadn.skadn_opts в ответе на запрос заявки протокола OpenRTB:

"seatbid": [{
  "bid": [{
    "ext": {
      "skadn": {
        "version": "2.0"
        ...

        "skadn_opts": {
          "always_open_appstore": true
        }
      }
    }
  }]
}]

Атрибуция по показам для мобильных объявлений

Когда SKAdNetwork v2.2 поддерживает атрибуцию по показам, SKAdNetwork API запускает таймер показов после отображения объявления и его просмотра пользователем. Атрибуция разрешена только для объявлений, которые были показаны в течение как минимум 3 секунд .

Обратите внимание, что iOS версии 15.3 и старше поддерживает только 1 активный таймер показов за раз, и в этом случае показ может не пройти инициацию атрибуции по показам, если на одном экране есть несколько объявлений с атрибуцией по показам. Это ограничение было снято в iOS версии 15.4 и выше , поэтому SKAdNetwork теперь позволяет использовать несколько одновременных показов для атрибуции по показам.

Руководящие указания

Поля запроса BidRequest.mobile.skadn.supported_fidelity_types для протокола Google RTB и BidRequest.imp.ext.skadn.fidelities для протокола BidRequest.imp.ext.skadn.fidelities указывают, какие типы достоверности атрибуции поддерживаются запросом ставки. Эти поля включают тип точности VIEW_THROUGH_ADS в версиях SKAdNetwork v2.2 и выше.

Убедитесь, что в ответе на запрос ставки не VIEW_THROUGH_ADS , если атрибуция по показам не поддерживается. Ответ с VIEW_THROUGH_ADS когда она не поддерживается, приводит к тому, что ставка будет отфильтрована до аукциона.

Обратная совместимость

Начиная с SKAdNetwork v4.0, запросы объявлений, включенные для атрибуции SKAdNetwork, обратно совместимы. Это позволяет рекламным сетям отвечать более старыми версиями SKAdNetwork, даже если запрос объявления поддерживает более новые версии.

Руководящие указания

Версия ОС устройства пользователя и версия Google Mobile Ads SDK приложения издателя определяют, какие функции SKAdNetwork поддерживаются запросом объявления. Это можно определить в BidRequest.mobile.skadn.versions с помощью поля BidRequest.mobile.skadn.versions для протокола Google RTB или поля BidRequest.imp.ext.skadn.versions для протокола BidRequest.imp.ext.skadn.versions . В этом поле перечислены все версии SKAdNetwork, поддерживаемые запросом объявления.

Чтобы предотвратить фильтрацию ставок, убедитесь, что версия SKAdNetwork, используемая для создания ответа, является одной из версий, перечисленных в запросе ставки. Кроме того, когда вводятся новые версии SKAdNetwork, обратите внимание, что ответы с более старыми версиями разрешены, если версия находится в этом списке. Это позволяет рекламным сетям продолжать реагировать на более старые версии и адаптировать новые версии в своем собственном темпе.