Настройка SKAdNetwork для атрибуции установок iOS-приложения

Настройка SKAdNetwork для атрибуции установок iOS-приложения

После iOS 14.5 Apple убрала прямой доступ к IDFA без явного согласия пользователя. Вместо детерминированной атрибуции через рекламный идентификатор Apple ввела SKAdNetwork — агрегированный механизм, где постбэки отправляются напрямую в рекламную сеть без передачи данных об устройстве. Настроить это не сложно — но понять, что именно делать и в каком порядке, занимает время.

Как работает SKAdNetwork

Цепочка атрибуции выглядит так:

1. Рекламная сеть подписывает показ рекламы своим SKAdNetwork ID
2. Пользователь кликает и устанавливает приложение
3. iOS регистрирует установку и запускает таймер
4. Приложение вызывает updateConversionValue(_:) — передаёт 6-битное значение (0–63), кодирующее действие пользователя
5. Apple отправляет постбэк рекламной сети — без user_id, без IDFA, только aggregate-данные кампании

Задержка постбэка — от 24 до 72 часов. Это не баг, это архитектурное решение Apple для защиты приватности.

Что нужно сделать в приложении

Добавить SKAdNetwork IDs в Info.plist

Каждая рекламная сеть имеет уникальный SKAdNetwork ID. Их нужно прописать в Info.plist вашего приложения — иначе Apple не засчитает атрибуцию от этой сети:

<key>SKAdNetworkItems</key>
<array>
    <!-- Google UAC -->
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>cstr6suwn9.skadnetwork</string>
    </dict>
    <!-- Meta (Facebook) -->
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>v9wttpbfk9.skadnetwork</string>
    </dict>
    <!-- TikTok -->
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>gta9lk7p23.skadnetwork</string>
    </dict>
    <!-- AppLovin -->
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>ludvb6z3bs.skadnetwork</string>
    </dict>
</array>

Актуальный список из 200+ идентификаторов поддерживают MMP-провайдеры (AppsFlyer, Adjust) — их можно выгрузить готовым plist-фрагментом.

Вызов updateConversionValue

Это самая тонкая часть. У вас есть 6 бит (значение 0–63) для кодирования поведения пользователя. Apple сбросит таймер на 24 часа каждый раз, когда вы вызываете updateConversionValue с возрастающим значением. После того как таймер истечёт — постбэк уходит, значение зафиксировано.

import StoreKit

// Пример простой схемы конверсии:
// 0–7: регистрация (бит 0 = завершил онбординг)
// 8–15: первое действие (бит 3 = добавил в корзину)
// 16–31: покупка (бит 4 = совершил покупку)

func trackRegistration() {
    if #available(iOS 14.0, *) {
        SKAdNetwork.updateConversionValue(1) // 000001
    }
}

func trackFirstPurchase(revenueLevel: Int) {
    // revenueLevel 1–3 кодируем в биты 1-2
    let value = 16 | revenueLevel // 010001, 010010, 010011
    if #available(iOS 14.0, *) {
        SKAdNetwork.updateConversionValue(value)
    }
}

Правило: значение должно быть строго возрастающим. Если вызвать updateConversionValue(5) после updateConversionValue(10) — вызов игнорируется. Это ограничение SKAdNetwork 1.0–2.x.

Conversion Value Schema: как упаковать максимум смысла в 6 бит

Стандартный подход — разделить 6 бит на два поля:

При такой схеме рекламная сеть получает не просто «установка», а «пользователь совершил первую покупку в диапазоне $5–20». Google UAC может оптимизировать кампанию именно под таких пользователей.

Распространённые ошибки

Не добавлены все SKAdNetwork IDs. Если ID сети отсутствует в Info.plist — Apple не отправит постбэк этой сети, и атрибуция с неё не работает. Рекламная сеть видит установки как неатрибутированные.

Conversion value не обновляется. Многие команды вызывают SKAdNetwork.registerAppForAdNetworkAttribution() (устаревший метод из SKAdNetwork 1.0) и забывают про updateConversionValue. В результате постбэк уходит с нулевым значением — рекламная сеть знает об установке, но не об активности пользователя.

Схема conversion value не согласована с рекламной командой. Техническая интеграция сделана, но маркетинг не знает, что означает значение 17 в постбэке. Декодирование conversion value нужно документировать и настраивать в MMP-дашборде.

Что входит в работу

• Сбор актуального списка SKAdNetwork IDs под используемые рекламные сети
• Проектирование conversion value schema под продуктовые события
• Интеграция updateConversionValue в ключевых точках приложения
• Настройка декодирования в AppsFlyer / Adjust
• Тестирование через SKAdNetwork TestKit

Сроки

3–5 дней с учётом проектирования conversion value schema и тестирования. Стоимость рассчитывается индивидуально после анализа рекламных каналов.