Як надсилати повернення даних SKAdNetwork у Google Analytics

У цій статті описано, як надсилати повернення даних SKAdNetwork у Google Analytics за допомогою Measurement Protocol.

Крок 1. Зареєструйте повернення даних SKAdNetwork для відповідних версій iOS

Щоб дізнатися більше, перегляньте документацію від компанії Apple. Клієнти, які використовують Google Analytics for Firebase SDK, можуть пропустити цей крок, оскільки пакет SDK автоматично виконує реєстрацію від імені додатка.

Крок 2. Переконайтеся, що ви можете отримувати й розкодовувати повернення даних SKAdNetwork

Щоб дізнатися більше, перегляньте документацію від компанії Apple. Якщо ви не налаштували кінцеву точку SKAdNetwork, потрібно буде це зробити, дотримуючись вказівок, наведених у документації від компанії Apple.

Примітка. Зараз Google Analytics не можна налаштувати як кінцеву точку.

Якщо ви вже налаштували кінцеву точку за допомогою власного рішення або партнера з атрибуції для додатків, схваленого компанією Google, можете одразу перейти до кроку 3, щоб спрямувати результати в Google Analytics із застосуванням Measurement Protocol.

Крок 3. Спрямуйте результати повернення даних у Google Analytics за допомогою Measurement Protocol

Для цього потрібно надсилати в Google Analytics спеціальну подію campaign_details за допомогою Measurement Protocol за наведеною нижче схемою (див. приклад у практичній роботі).

Як використовувати Measurement Protocol з SKAdNetwork у Google Analytics

Усі параметри є обов’язковими, крім позначених як необов’язкові.

Параметри на рівні запиту

Параметр	Докладніше
firebase_app_id: {gmp_app_id}	У Google Analytics відкрийте розділ Адміністратор > Потоки даних > виберіть свій потік > Ідентифікатор додатка у Firebase. Налаштовується поза корисним навантаженням.
api_secret: {api_secret}	Щоб створити новий секретний токен, у Google Analytics відкрийте розділ Адміністратор > Потоки даних > виберіть свій потік > Measurement Protocol > Створити. Налаштовується поза корисним навантаженням.
timestamp_micros: {позначка часу отриманого повернення даних SKAN}	Необов’язково, але за наявності має бути вказано значення за останні 2 календарні дні й сьогодні. В іншому разі використовуватиметься позначка часу збирання даних. Період урахування ключових подій у Google Analytics становить 30 днів для подій залучення. Щоб отримувати точніші звіти, важливо якомога швидше надсилати повернення даних.
app_instance_id: {...}	Обов’язково. Згенеруйте унікальний рядок випадкових чисел. Цей рядок ідентифікатора буде відхилено на користь фактичних ідентифікаторів екземплярів додатка, коли ці дані використовуватимуться в моделюванні конверсій.

Подія Google Analytics

Подія	Докладніше
campaign_details	Спеціальна подія.

Параметри Google Analytics (наявні)

Параметр	Докладніше
source: {джерело}	Ці параметри використовуються для позначення тегами вручну. Звіти Google Analytics структуровано за допомогою групувань каналів Google Analytics за умовчанням. Рекомендуємо використовувати їх для класифікації кожного параметра. Надсилайте ці параметри для всіх сторонніх повернень даних (не Google). Нижче наведено приклади. Повернення даних Facebook: source: facebook medium: cpc|cpm content: ad_version_name campaign: на Facebook, весна 2022 року campaign id: як було вказано в поверненні даних SKAN Для повернень даних Google ми розкодовуватимемо кампанії на основі інтеграції вашого ресурсу з Google Ads. Тому наведені вище параметри є необов’язковими для повернень даних Google. Переконайтеся, що ваш ресурс Google Analytics зв’язано з рекламними обліковими записами Google Ads. Примітка. Важливо надсилати в Google Analytics не лише сторонні повернення даних (не Google), а всі повернення даних SKAdNetwork.
medium: {medium}
term: {термін} (необов’язково)
content: {вміст} (необов’язково)
campaign_id: {campaign_id}	Значення з повернення даних SKAdNetwork.
campaign: {campaign} (необов’язково, але без цього параметра відображатиметься значення "(not set)")	Для кампаній Google Ads ми розкодуємо ідентифікатор і надамо назву кампанії на основі зв’язку між Google Analytics і Google Ads, а також оновимо параметри джерела й каналу. Якщо ваші облікові записи не зв’язано, ми не розкодовуватимемо ідентифікатори кампаній Google і використовуватимемо вказані параметри джерела й каналу. Для сторонніх кампаній (не Google Ads) можна розкодувати й указати назви кампаній. Якщо ви їх не знаєте, можете скопіювати campaign_id з SKAdNetwork. Примітка. Без цього параметра відображатиметься значення (not set).
source_platform: "apple_skan"	Важливо. Ви повинні точно вказати цей рядок, включно з регістром і символом "_".
app_id: {app_id}	Значення з повернення даних SKAdNetwork. Це має бути ідентифікатор пакета додатка.
transaction_id: {transaction_id}	Значення з повернення даних SKAdNetwork.

Обов’язкові нові параметри

Примітка. Ці нові параметри можна налаштувати в інтерфейсі користувача Google Analytics, однак це необов’язково. Щоб переглядати звіти про спеціальні параметри на основі цих параметрів, потрібно зареєструвати їх у Google Analytics.

Параметр	Докладніше
version: {version}	Значення з повернення даних SKAdNetwork.
conversion_value: {conversion_value}	Значення з повернення даних SKAdNetwork.
fidelity_type: {fidelity_type}	Значення з повернення даних SKAdNetwork.
attribution_signature: {attribution_signature}	Значення з повернення даних SKAdNetwork. Примітка. Це функція безпеки. Повернення даних SKAdNetwork мають криптографічний підпис.
redownload: {redownload}	Значення з повернення даних SKAdNetwork.
source_app_id: {source_app_id}	Значення з повернення даних SKAdNetwork. Примітка. Це ідентифікатор додатка, у якому було натиснуто оголошення, що призвело до встановлення.
did_win: {did_win}	Значення з повернення даних SKAdNetwork. Примітка. Рекламодавці отримують лише виграшні повернення даних, тобто рекламні технології визначають повернення даних, які посіли перше й друге/допоміжне місце.
ad_network_id: {ad_network_id} (де {ідентифікатор рекламної мережі} – значення з повернення даних)	Значення з повернення даних SKAdNetwork. Тут ви побачите рекламну мережу, яка показувала ваше оголошення. Ця інформація також корисна для відстеження параметра трафіку "Джерело".

 

Крок 4. Перевірте, чи надходять звернення Marketing Platform

Події campaign_details не відображаються безпосередньо в Google Analytics. Натомість повернення даних SKAdNetwork перетворюються на події і інтегруються в ключові події first_open та звіти про події. Їх можна сегментувати, додавши параметр вихідної платформи (вихідна платформа = SKAN).

Щоб переконатися, що звернення надсилаються, рекомендуємо реєструвати тестові події за допомогою копій подій campaign_details з іншою назвою (наприклад, campaign_details_skan_test). Після цього потрібно перевірити, чи з’явилися тестові події у звіті Google Analytics У реальному часі. Якщо ви зареєструєте тестову подію і параметри, вони відображатимуться не лише у звітах "У реальному часі", але й у спеціальних звітах.

Примітки

• Якщо ви хочете, щоб у звітах відображалися всі повернення даних SKAdNetwork, потрібно не лише надсилати кожне повернення як подію campaign.details, але й зареєструвати копію події і параметрів, як описано вище. Зверніть увагу на те, що повернення даних SKAdNetwork завжди надсилаються за допомогою події campaign.details. Інакше Google Analytics не зможе розпізнати їх і змоделювати конверсії, щоб покращити звіти про події first_open у додатках iOS. 
• Повернення даних SKAdNetwork потрібно надсилати протягом 4 днів із моменту їх отримання, щоб сервіс Google Analytics використовував їх для моделювання конверсій і звітів.

Докладніше про основні кроки перевірки.