Odesílání volání postback SKAdNetwork do Google Analytics

Tento článek vás podrobně provede odesíláním volání postback SKAdNetwork do Google Analytics pomocí platformy Measurement Protocol.

Krok 1: Zaregistrujte volání postback SKAdNetwork pro příslušné verze systému iOS

Další informace najdete v dokumentaci společnosti Apple. U zákazníků, kteří používají sadu SDK Google Analytics pro Firebase, zaregistruje toto volání sada SDK automaticky jménem aplikace a vy můžete tento krok přeskočit.

Krok 2: Postarejte se, abyste přijímali a dekódovali volání postback SKAdNetwork

Další informace najdete v dokumentaci společnosti Apple. Pokud jste nenastavili koncový bod SKAdNetwork, budete to muset provést podle postupu v dokumentaci společnosti Apple.

Poznámka: Google Analytics v současné době nelze nakonfigurovat jako koncový bod.

Pokud už máte nastavený koncový bod se schváleným partnerem pro atribuci v kampaních na aplikace (AAP) nebo vlastním řešením, můžete přejít ke kroku 3, který vás provede přesměrováním výsledků do Google Analytics pomocí platformy Measurement Protocol.

Krok 3: Přesměrování výsledků volání postback do Google Analytics pomocí platformy Measurement Protocol

Lze to provést odesíláním vlastní události campaign_details do Google Analytics prostřednictvím platformy Measurement Protocol pomocí následujícího schématu (příklad: codelab).

Implementace Measurement Protocol SKAdNetwork Google Analytics

Všechny parametry jsou povinné, pokud nejsou označeny jako nepovinné.

Parametry na úrovni požadavku

Parametr	Další informace
firebase_app_id: {gmp_app_id}	V Google Analytics přejděte do Správce > Datové streamy > vyberte svůj stream > ID aplikace Firebase. Nastavte možnost Mimo datovou část.
api_secret: {api_secret}	Pokud chcete vytvořit nový tajný kód, přejděte v Google Analytics do Administrátor > Datové streamy > vyberte svůj stream > Measurement Protocol > Vytvořit. Nastavte možnost Mimo datovou část.
timestamp_micros: {časové razítko přijatého volání postback SKAN}	Nepovinné, ale pokud je zadáno, nesmí být starší než dva kalendářní dny plus dnešek. Pokud není zadáno, použije se časové razítko shromažďování. Doba sledování klíčových událostí akvizice v Google Analytics je 30 dní. Kvůli přesnosti přehledů je nutné odesílat volání postback co nejdříve.
app_instance_id: {...}	Povinné. Vygeneruje jedinečný řetězec náhodných čísel. Tento specifický identifikační řetězec bude nahrazen aktuálním ID instance aplikace, jakmile budou tato data použita při modelování konverzí.

Událost GA

Událost	Další informace
campaign_details	Vlastní událost.

Parametry GA (stávající)

Parametr	Další informace
source: {zdroj}	Jedná se o parametry, které se používají při manuálním značkování. Přehledy Google Analytics jsou strukturovány pomocí výchozích seskupení kanálů Google Analytics. Doporučujeme je použít jako vodítko pro kategorizaci jednotlivých parametrů. Odešlete tyto parametry pro všechna volání postback mimo Google. Příklad: Volání postback Facebooku: source: facebook medium: cpc|cpm content: ad_version_name campaign: jarní kampaň Facebook 22 campaign id: shodné s ID z volání postback SKAN V případě volání postback Google budeme kampaně dekódovat na základě integrace vaší služby s Google Ads. Proto jsou výše uvedené parametry u volání postback Google nepovinné. Vy musíte zajistit, aby vaše služba v Google Analytics byla propojena s vašimi inzertními účty Google Ads. Poznámka: Do Google Analytics je důležité odesílat všechna volání postback SKAdNetwork, nejen ta od třetích stran.
medium: {médium}
term: {dotaz}  Nepovinné
content: {obsah}  Nepovinné
campaign_id: {campaign_id}	Hodnota z volání postback SKAdNetwork.
campaign: {kampaň} nepovinná, ale bez ní se zobrazí jako (not set)	V případě kampaní Google Ads dekódujeme ID a poskytneme název kampaně na základě vašeho propojení Google Analytics a Google Ads a aktualizujeme parametry zdroje a média. V případě, že vaše účty propojeny nejsou, nedekódujeme ID kampaní Google a použijeme zadané parametry zdroje a média. U kampaní mimo Google Ads můžete dekódovat a uvést názvy kampaní. Pokud je neznáte, můžete zkopírovat své SKAdNetwork campaign_id. Poznámka: Pokud není zadáno, zobrazí se jako (not set).
source_platform: „apple_skan“	Důležité: Řetězec je nutné zadat přesně, dodržet velká a malá písmena a _.
app_id: {app_id}	Hodnota z volání postback SKAdNetwork. Toto by bylo vaše ID balíčku aplikace.
transaction_id: {transaction_id}	Hodnota z volání postback SKAdNetwork.

Požadované nové parametry

Poznámka: Tyto nové parametry je možné nastavit v uživatelském rozhraní služby Google Analytics. Není to však povinné. Pokud chcete na základě těchto parametrů sledovat konkrétní přehledy vlastních dimenzí, musíte je v Google Analytics zaregistrovat.

Parametr	Další informace
version: {verze}	Hodnota z volání postback SKAdNetwork
conversion_value: {hodnota konverze}	Hodnota z volání postback SKAdNetwork
fidelity_type: {fidelity_type}	Hodnota z volání postback SKAdNetwork.
attribution_signature: {attribution_signature}	Hodnota z volání postback SKAdNetwork. Poznámka: Jedná se o zabezpečovací funkci. Volání postback SKAdNetwork jsou kryptograficky podepsána.
redownload: {redownload}	Hodnota z volání postback SKAdNetwork.
source_app_id: {source_app_id}	Hodnota z volání postback SKAdNetwork. Poznámka: ID aplikace, kde instalace aplikace proběhla následkem kliknutí na reklamu.
did_win: {did_win}	Hodnota z volání postback SKAdNetwork. Poznámka: Inzerenti obdrží pouze vítězná volání postback. Zatímco AdTechs obdrží jejich vítězná volání postback a volání postback runner-up/assists.
ad_network_id: {ad_network_id} Kde {ad_network_id} představuje hodnotu volání postback.	Hodnota z volání postback SKAdNetwork. Ukazuje reklamní síť, která reklamu zobrazila. Tyto informace budou užitečné i pro dimenzi návštěvnosti „zdroj“.

 

Krok 4: Ověřte, že přijímáte požadavky na server Marketing Platform

Události campaign_details se v Google Analytics nezobrazují přímo. Místo toho se volání postback SKAdNetwork mění na události a jsou integrována do klíčových událostí first_open a přehledů událostí. Mohou být segmentována přidáním zdrojové platformy dimenze (zdrojová platforma = SKAN).

Pokud chcete potvrdit, že se požadavky na server odesílají, doporučujeme, abyste protokolovali testovací události tím, že duplikujete události campaign_details pomocí jiného názvu události (např. campaign_details_skan_test). Pak můžete ověřit, zda se testovací události zobrazují v Google Analytics v přehledu v reálném čase. Když zaregistrujete testovací událost a parametry, zobrazí se kromě přehledů v reálném čase také v přehledech ad hoc.

Poznámky:

• Pokud chcete, aby se v přehledech zobrazovala všechna vaše volání postback SKAdNetwork, musíte kromě odesílání událostí campaign.details zaregistrovat také výše uvedenou duplicitní událost a parametry. Pokud to uděláte, volání postback SKAdNetwork bude nadále nutné odesílat pomocí události campaign.details. Jinak je služba Google Analytics nerozpozná, a nebude moci modelování konverzí použít ke zlepšení přehledů first_open v iOS. 
• Volání postback SKAdNetwork je nutné odeslat do 4 dnů od přijetí, aby jej mohla služba Google Analytics využít k modelování konverzí a vytváření přehledů.

Další informace o obecných ověřovacích krocích.