Крок 1. Зареєструйте повернення даних SKAdNetwork для відповідних версій iOS
Щоб дізнатися більше, перегляньте документацію від компанії Apple. Клієнти, які використовують Google Analytics for Firebase SDK, можуть пропустити цей крок, оскільки пакет SDK автоматично виконує реєстрацію від імені додатка.
Крок 2. Переконайтеся, що ви можете отримувати й розкодовувати повернення даних SKAdNetwork
Щоб дізнатися більше, перегляньте документацію від компанії Apple. Якщо ви не налаштували кінцеву точку SKAdNetwork, потрібно буде це зробити, дотримуючись вказівок, наведених у документації від компанії Apple.
Якщо ви вже налаштували кінцеву точку за допомогою власного рішення або партнера з атрибуції для додатків, схваленого компанією Google, можете одразу перейти до кроку 3, щоб спрямувати результати в Google Analytics із застосуванням Measurement Protocol.
Крок 3. Спрямуйте результати повернення даних у Google Analytics за допомогою Measurement Protocol
Для цього потрібно надсилати в Google Analytics спеціальну подію campaign_details за допомогою Measurement Protocol за наведеною нижче схемою (див. приклад у практичній роботі).
Як використовувати Measurement Protocol з SKAdNetwork у Google Analytics 4
Параметри на рівні запиту
| Параметр | Додаткова інформація |
| firebase_app_id: {ідентифікатор додатка gmp} |
|
| api_secret: {секретний токен API} |
|
| timestamp_micros: {позначка часу отриманого повернення даних SKAN} |
|
| app_instance_id: {…} |
Обов’язково. Згенеруйте унікальний рядок випадкових чисел. Цей рядок ідентифікатора буде відхилено на користь фактичних ідентифікаторів екземплярів додатка, коли ці дані використовуватимуться в моделюванні конверсій. |
Подія Google Analytics
| Подія | Додаткова інформація |
| campaign_details | Спеціальна подія. |
Параметри Google Analytics (наявні)
| Параметр | Додаткова інформація |
| source: {джерело} |
Ці параметри використовуються для позначення тегами вручну. Звіти Google Analytics 4 структуровано за допомогою групувань каналів Google Analytics 4 за умовчанням. Рекомендуємо використовувати їх для класифікації кожного параметра. Надсилайте ці параметри для всіх сторонніх повернень даних (не Google). Нижче наведено приклади. Повернення даних Facebook:
Для повернень даних Google ми розкодовуватимемо кампанії на основі інтеграції вашого ресурсу з Google Ads. Тому наведені вище параметри є необов’язковими для повернень даних Google. Переконайтеся, що ваш ресурс Google Analytics 4 зв’язано з рекламними обліковими записами Google Ads. Примітка. Важливо надсилати в Google Analytics 4 не лише сторонні повернення даних (не Google), а всі повернення даних SKAdNetwork. |
| medium: {канал} | |
| term: {термін} (необов’язково) | |
| content: {вміст} (необов’язково) | |
| campaign_id: {ідентифікатор кампанії} | Значення з повернення даних SKAdNetwork. |
| campaign: {кампанія} (необов’язково, але без цього параметра відображатиметься значення "(not set)") |
Для кампаній Google Ads ми розкодуємо ідентифікатор і надамо назву кампанії на основі зв’язку між Google Analytics і Google Ads, а також оновимо параметри джерела й каналу. Якщо ваші облікові записи не зв’язано, ми не розкодовуватимемо ідентифікатори кампаній Google і використовуватимемо вказані параметри джерела й каналу. Для сторонніх кампаній (не Google Ads) можна розкодувати й указати назви кампаній. Якщо ви їх не знаєте, можете скопіювати campaign_id з SKAdNetwork. Примітка. Без цього параметра відображатиметься значення (not set). |
| source_platform: "apple_skan" | Важливо. Ви повинні точно вказати цей рядок, включно з регістром і символом "_". |
| app_id: {ідентифікатор додатка} |
Значення з повернення даних SKAdNetwork. Це має бути ідентифікатор пакета додатка. |
| transaction_id: {ідентифікатор трансакції} | Значення з повернення даних SKAdNetwork. |
Обов’язкові нові параметри
Примітка. Ці нові параметри можна налаштувати в інтерфейсі користувача Google Analytics 4, однак це необов’язково. Щоб переглядати звіти про спеціальні параметри на основі цих параметрів, потрібно зареєструвати їх у Google Analytics 4.
| Параметр | Додаткова інформація |
| version: {версія} | Значення з повернення даних SKAdNetwork. |
| conversion_value: {цінність конверсії} | Значення з повернення даних SKAdNetwork. |
| fidelity_type: {тип точності} | Значення з повернення даних SKAdNetwork. |
| attribution_signature: {підпис атрибуції} |
Значення з повернення даних SKAdNetwork. Примітка. Це функція безпеки. Повернення даних SKAdNetwork мають криптографічний підпис. |
| redownload: {повторне завантаження} | Значення з повернення даних SKAdNetwork. |
| source_app_id: {ідентифікатор вихідного додатка} |
Значення з повернення даних SKAdNetwork. Примітка. Це ідентифікатор додатка, у якому було натиснуто оголошення, що призвело до встановлення. |
| did_win: {чи виграно атрибуцію} |
Значення з повернення даних SKAdNetwork. Примітка. Рекламодавці отримують лише виграшні повернення даних, тобто рекламні технології визначають повернення даних, які посіли перше й друге/допоміжне місце.
|
|
ad_network_id: {ідентифікатор рекламної мережі} (де {ідентифікатор рекламної мережі} – значення з повернення даних) |
Значення з повернення даних SKAdNetwork. Тут ви побачите рекламну мережу, яка показувала ваше оголошення. Ця інформація також корисна для відстеження параметра трафіку "Джерело". |
Крок 4. Перевірте, чи надходять звернення Marketing Platform
Події campaign_details не відображаються безпосередньо в Google Analytics. Натомість повернення даних SKAdNetwork перетворюються на події і інтегруються в ключові події first_open та звіти про події. Їх можна сегментувати, додавши параметр вихідної платформи (вихідна платформа = SKAN).
Щоб переконатися, що звернення надсилаються, рекомендуємо реєструвати тестові події за допомогою копій подій campaign_details з іншою назвою (наприклад, campaign_details_skan_test). Після цього потрібно перевірити, чи з’явилися тестові події у звіті Google Analytics 4 У реальному часі. Якщо ви зареєструєте тестову подію і параметри, вони відображатимуться не лише у звітах "У реальному часі", але й у спеціальних звітах.
- Якщо ви хочете, щоб у звітах відображалися всі повернення даних SKAdNetwork, потрібно не лише надсилати кожне повернення як подію
campaign.details, але й зареєструвати копію події і параметрів, як описано вище. Зверніть увагу на те, що повернення даних SKAdNetwork завжди надсилаються за допомогою подіїcampaign.details. Інакше Google Analytics не зможе розпізнати їх і змоделювати конверсії, щоб покращити звіти про подіїfirst_openу додатках iOS. - Повернення даних SKAdNetwork потрібно надсилати протягом 4 днів із моменту їх отримання, щоб сервіс Google Analytics використовував їх для моделювання конверсій і звітів.