Как атрибутировать установки iOS с помощью SKAdNetwork

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

Ниже описано, как меняется атрибуция установок приложений в зависимости от версии SKAdNetwork.

• 2.0–2.1. Атрибуция установки рекламируемого приложения выполняется на основе данных со страницы товара в магазине приложений, которая отображается с помощью StoreKit, когда пользователь нажимает на объявление и устанавливает приложение.
• 2.2 и более поздние версии. Дополнительная поддержка объявлений, ориентированных на просмотры. В этом случае установка рекламируемого приложения атрибутируется, если пользователь устанавливает приложение после просмотра вашего объявления.

Подробнее о различиях между версиями SKAdNetwork читайте в примечаниях к выпуску SKAdNetwork.

Как настроить идентификаторы SKAdNetwork в интерфейсе

Чтобы получать запросы ставок, содержащие идентификаторы SKAdNetwork, необходимо указать эти идентификаторы в интерфейсе Авторизованных покупателей или Open Bidding. Например, идентификатор SKAdNetwork может иметь значение a1b2c3d4e5.skadnetwork.

Чтобы указать идентификатор SKAdNetwork в интерфейсе Авторизованных покупателей или Open Bidding, выполните следующие действия:

1. В меню навигации Настройки системы назначения ставок выберите Настройки назначения ставок в реальном времени. Откроется страница Настройки назначения ставок в реальном времени.
2. Перейдите к полю Разрешенные идентификаторы iOS SKAdNetwork, чтобы посмотреть и настроить идентификаторы SKAdNetwork.

На изображении ниже показан пример идентификатора SKADNetwork в поле Разрешенные идентификаторы iOS SKAdNetwork.

Как настроить креативы для атрибуции

Google Mobile Ads SDK инициирует атрибуцию SKAdNetwork, только если URL перехода по клику ведет в Apple App Store. Если вы отправляете креативы на проверку с помощью Real-time Bidding API, в них должен использоваться URL перехода по клику, который является прямой ссылкой на рекламируемое приложение в App Store или использует HTTP-переадресацию, конечным пунктом которой является рекламируемое приложение в App Store. Google Mobile Ads SDK инициирует атрибуцию, если конечный целевой URL перехода по клику начинается с любого из следующих префиксов:

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

Если конечный целевой URL перехода по клику в креативе не соответствует этим префиксам или в нем используются другие методы переадресации на стороне клиента, которые не ведут в App Store, Google Mobile Ads SDK может не инициировать атрибуцию SKAdNetwork. Ниже приведены примеры ситуаций, в которых может применяться этот процесс:

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

Как начать атрибуцию по типу креатива

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

HTML

Его можно указать в качестве целевого URL в тегах привязки, окружающих элемент, на который можно нажать, или в качестве целевого URL для операций window.location из событий клика на основе JavaScript.

MRAID

Действие-клик должно вызывать Mraid.open(), чтобы инициировать атрибуцию SKAdNetwork.

Видео VAST

URL магазина приложений должен быть указан в элементе ClickThrough в XML-коде VAST.

Стандартное

URL магазина приложений должен быть указан в поле BidResponse.seatbid.bid.{adm/adm_native}.link.url.

Определите BidRequest сигналов

Информацию о зарегистрированных идентификаторах SKAdNetwork, которые поддерживает приложение издателя, можно найти в поле BidRequest.imp.ext.skadn. Если указано поле skadn, вы можете использовать атрибуты, чтобы создать ответ для объявления, ориентированного на установку приложения или повторное взаимодействие, которое связывает установку или конверсию с одним из включенных идентификаторов SKAdNetwork. Поле skadn – это объект SKAdNetworkRequest со следующими атрибутами:

Ниже приведен пример запроса ставки для мобильного инвентаря, в котором приложение издателя поддерживает ваши идентификаторы SKAdNetwork.

{
  "id": "9NaI48SmPW7Zf3MAHR43DY",
  "imp": [
    {
      "id": "1",
      // OMITTED...
      "ext": {
        // OMITTED...
        "skadn": {
          "sourceapp": "com.google.testapp",
          "skadnetids": [
            "cF58w81X"
          ],
          "versions": [
            "2.0",
            "2.1",
            "4.0"
          ],
          "fidelities": [
            1,
            0
          ]
        }
        // OMITTED...
      }
    }
  ],
  "app": {
    "name": "Test App",
    "ver": "5.6.0",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-6156239328255091",
      "ext": {
        "country": "JP"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "livestream": 0,
      "language": "ja"
    },
    "storeurl": "https://www.google.com"
  }
  // OMITTED...
}

Заполнить поля BidResponse

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

Вы должны передавать информацию об атрибуции, которая соответствует данным, включенным в запрос ставки. Информация об авторстве указывается в поле BidResponse.seatbid.bid.ext.skadn, которое является объектом SKAdNetworkResponse со следующими атрибутами:

Ниже приведен пример ответа на запрос ставки, содержащего информацию об атрибуции установок приложения.

{
  "id": "9NaI48SmPW7Zf3MAHR43DY",
  "seatbid": [
    {
      "bid": [
        {
          "id": "9NaI48SmPW7Zf3MAHR43DY",
          // OMITTED...
          "ext": {
            // OMITTED...
            "skadn": {
              "version": "4.0",
              "network": "cF58w81X",
              "itunesitem": "788729094",
              "sourceapp": "1422994973",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "017e597c-3c7d-4a44-afeb-41cd9a17066f",
                  "timestamp": "1757235407882",
                  "signature": "11iF1L96q2cw8tu790p301c10530ogr7h250k1P9pLxqcJ2qe37klG8xB3M592YbpafQ9861493838C521XA6AEF4A40DK8X"
                },
                {
                  "fidelity": 1,
                  "nonce": "017e597c-3c7d-4a44-afeb-41cd9a17066f",
                  "timestamp": "1757235407882",
                  "signature": "f67L3C138Y6XB7940141011Pd58AZbdBk9Xo1Mlf1973706DsB5808ILLKumU2ic9fr72b9bSs3CD25CCZo8DJB65JB0615L"
                }
              ],
              "sourceidentifier": "5507"
            },
            "app_promotion_type": 1
            // OMITTED...
          }
        }
      ]
      // OMITTED...
    }
  ]
  // OMITTED...
}

Ниже описано, как SKAdNetwork реагирует на ответ на запрос ставки.

• Если рекламируемое приложение устанавливается в течение 24 часов после просмотра объявления в течение как минимум трех секунд, рекламодателю отправляется уведомление о возврате данных атрибуции просмотров SKAdNetwork.
• При нажатии на объявление показывается встроенный оверлей магазина с рекламируемым приложением. Если пользователь установит и откроет это приложение, рекламодателю будет отправлено уведомление о возврате данных атрибуции по кликам SKAdNetwork.

Как повысить эффективность атрибуции с помощью SKOverlay

Вы можете повысить атрибуцию объявлений, отрисованных с помощью StoreKit, если будете показывать SKOverlay, когда это возможно. SKOverlay позволяет приложению издателя показывать оверлей, с помощью которого пользователи могут скачать рекламируемое приложение, не покидая приложение издателя. Подробнее SKOverlay…

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

• Оверлей SKOverlay показывается не менее трех секунд.
• Рекламируемое приложение устанавливается в течение 30 дней после показа SKOverlay.
• Ваш оверлей SKOverlay был показан последним перед установкой рекламируемого приложения.

Google поддерживает SKOverlay для фрагментов HTML и видеокреативов VAST, размещенных в межстраничных объявлениях или объявлениях с вознаграждением.

Как определить, поддерживается ли SKOverlay

Получив запрос ставки, вы можете узнать, поддерживается ли SKOverlay, проверив значение поля BidRequest.imp.ext.skadn.skoverlay. SKOverlay поддерживается, если для поля skoverlay задано значение true (для конечных точек назначения ставок, использующих формат OpenRTB Protobuf) или 1 (для конечных точек назначения ставок, использующих формат OpenRTB JSON).

Как разместить объявление с помощью SKOverlay

Если SKOverlay поддерживается, вы можете указать поле BidResponse.seatbid.bid.ext.skadn.skoverlay, чтобы сообщить о своем желании показывать SKOverlay. Поле skoverlay имеет следующие атрибуты:

• delay – целое число, представляющее задержку в секундах между показом объявления и показом SKOverlay. Для видеокреативов временем показа считается момент начала воспроизведения видео. Если это поле не заполнено, оверлей SKOverlay не показывается.
• endcarddelay – целое число, представляющее задержку в секундах между показом конечной заставки видеокреатива и показом SKOverlay. Если это поле не заполнено, SKOverlay не будет показываться после конечной заставки. Применимо только к видеокреативам VAST, размещенным в межстраничных объявлениях или объявлениях с вознаграждением.
• dismissible – логическое значение, указывающее, может ли пользователь закрыть SKOverlay.

Ниже приведен пример ответа на запрос ставки.

{
  // OMITTED...
  "seatbid": [
    {
      "bid": [
        {
          // OMITTED...
          "ext": {
            // OMITTED...
            "skadn": {
              // OMITTED...
              "itunesitem": "422689480",
              "skoverlay": {
                "delay": 5,
                "endcarddelay": 0
              },
              "productpageid": "some_id"
            }
          }
        }
      ]
    }
  ]
}

Ожидаемое поведение SKOverlay

Ниже описано, как будет работать SKOverlay в соответствии с приведенным выше ответом на запрос ставки.

• Показывать SKOverlay через пять секунд после начала видео.
• Показывать SKOverlay сразу после конечной заставки.

• Открывать магазин приложений, когда пользователь нажимает на SKOverlay.

• Если указан параметр BidResponse.seatbid.bid.ext.skadn.productpageid, в качестве данных страницы приложения в SKOverlay используется значок на специальной странице товара.

• Когда пользователь нажимает на оверлей SDK в видеокреативе VAST, отправляются запросы к URL перехода по клику и URL отслеживания кликов.

• Если в видеокреативах VAST пользователь закрывает SKOverlay во время воспроизведения видео, то SKOverlay все равно будет показан после конечной заставки, если задано поле BidResponse.seatbid.bid.ext.skadn.skoverlay.endcarddelay.