Odosielanie volaní postback rámca SKAdNetwork do služby Google Analytics

Nasledujúci článok vás prevedie postupom odosielania volaní postback rozhrania SKAdNetwork do služby Google Analytics pomocou platformy Measurement Protocol.

1. krok: registrácia volaní postback rozhrania SKAdNetwork pre relevantné verzie systému iOS

Prečítajte si viac v dokumentácii od firmy Apple. V prípade zákazníkov používajúcich Google Analytics for Firebase SDK to zaregistruje súprava SDK automaticky za aplikáciu a tento krok možno preskočiť.

2. krok: kontrola prijímania a dekódovania volaní postback rozhrania SKAdNetwork

Prečítajte si viac v dokumentácii od firmy Apple. Ak ste nenastavili koncový bod pre SKAdNetwork, budete to musieť urobiť podľa dokumentácie od firmy Apple.

Poznámka: Google Analytics momentálne nemožno nakonfigurovať ako koncový bod.

Ak ste už ako koncový bod nastavili partnera atribúcie pre aplikácie schváleného Googlom alebo vlastné riešenie, môžete prejsť na 3. krok, ktorý vás prevedie procesom nasmerovania výsledkov do služby Google Analytics pomocou platformy Measurement Protocol.

3. krok: nasmerovanie výsledkov volaní postback do služby Google Analytics pomocou platformy Measurement Protocol

Funguje to tak, že do služby Google Analytics sa odošle vlastná udalosť campaign_details prostredníctvom platformy Measurement Protocol pomocou nasledujúcej schémy (príklad zo seminára programovania).

Zavedenie rámca SKAdNetwork prostredníctvom rozhrania Measurement Protocol v službe Google Analytics

Všetky parametre sú povinné, pokiaľ nie sú uvedené ako nepovinné.

Parametre na úrovni žiadosti

Parameter	Ďalšie informácie
firebase_app_id: {gmp_app_id}	V službe Google Analytics prejdite do sekcie Správca > Streamy údajov > vyberte stream > Identifikátor aplikácie Firebase. Nastavuje sa mimo dátového obsahu.
api_secret: {tajny_kluc_api}	Ak chcete vytvoriť nový tajný kľúč, v službe Google Analytics prejdite do sekcie Správca > Streamy údajov > vyberte stream > Measurement Protocol > Vytvoriť. Nastavuje sa mimo dátového obsahu.
timestamp_micros: {časová pečiatka prijatého volania postback rozhrania SKAN}	Nepovinný, ale ak ho chcete poskytnúť, musí byť v rámci posledných dvoch kalendárnych dní a dnešného dňa. Ak nie je poskytnutý, použije sa časová pečiatka zbierky. Dĺžka sledovania kľúčových udalostí v službe Google Analytics pre udalosti akvizície je 30 dní. Je dôležité posielať volania postback čo najskôr, aby boli reporty presnejšie.
app_instance_id: {...}	Povinné. Vygenerujte jedinečný reťazec náhodných čísel. Po použití týchto údajov pri modelovaní konverzií bude tento konkrétny reťazec identifikátora nahradený skutočnými identifikátormi inštancie aplikácie.

Udalosť služby GA

Udalosť	Ďalšie informácie
campaign_details	Vlastná udalosť.

Parametre služby GA (existujúce)

Parameter	Ďalšie informácie
source: {zdroj}	Ide o parametre, ktoré sa používajú pri manuálnom značkovaní. Reporty v službe Google Analytics sú štruktúrované pomocou predvolených zoskupení kanálov v službe Google Analytics. Odporúčame použiť ich ako pomôcku pri kategorizácii jednotlivých parametrov. Odošlite tieto parametre pre všetky volania postback mimo Googlu. Príklad: Volanie postback služby Facebook: source: facebook medium: czk|ctz content: nazov_verzie_aplikacie campaign: Jarná kampaň č. 22 na Facebooku campaign id: ako je uvedené vo volaní postback rozhrania SKAN V prípade volaní postback z Googlu dekódujeme kampane na základe integrácie vášho vlastníctva so službou Google Ads. Uvedené parametre sú preto pre volania postback z Googlu nepovinné. Musíte sa uistiť, že vlastníctvo v službe Google Analytics je pripojené k vašim reklamným účtom Google Ads. Poznámka: Do služby Google Analytics je dôležité odosielať všetky volania postback rámca SKAdNetwork, nielen volania postback mimo Googlu.
medium: {medium}
term: {vyraz} nepovinné
content: {obsah} nepovinné
campaign_id: {campaign_id}	Hodnota z volania postback rámca SKAdNetwork
campaign: {kampaň} nepovinný, ale bez neho sa zobrazuje hodnota (not set)	V prípade kampaní Google Ads dekódujeme identifikátor a poskytneme názov kampane na základe prepojenia účtov Google Analytics a Google Ads a aktualizujeme parametre zdroja a média. Ak vaše účty nie sú prepojené, identifikátory kampaní Google nebudeme dekódovať a použijeme uvedené parametre zdroja a média. V prípade kampaní mimo služby Google Ads môžete dekódovať a poskytnúť názvy kampaní. Ak ich nepoznáte, môžete skopírovať parameter campaign_id v rozhraní SKAdNetwork. Poznámka: Ak nebude poskytnutý, zobrazí sa ako (not set).
source_platform: “apple_skan”	Dôležité: Tento reťazec musíte uviesť presne a zachovať veľké písmená aj symbol _
app_id: {app_id}	Hodnota z volania postback rámca SKAdNetwork. Ide o identifikátor balíka aplikácie.
transaction_id: {transaction_id}	Hodnota z volania postback rámca SKAdNetwork

Povinné nové parametre

Poznámka: Tieto nové parametre možno nastaviť v používateľskom rozhraní služby Google Analytics. Nie je to však povinné. Ak chcete, aby sa na základe týchto parametrov zobrazovali reporty konkrétnych vlastných dimenzií, bude potrebné ich zaregistrovať v službe Google Analytics.

Parameter	Ďalšie informácie
version: {verzia}	Hodnota z volania postback rámca SKAdNetwork
conversion_value: {hodnota_konverzie}	Hodnota z volania postback rámca SKAdNetwork
fidelity_type: {fidelity_type}	Hodnota z volania postback rámca SKAdNetwork
attribution_signature: {attribution_signature}	Hodnota z volania postback rámca SKAdNetwork. Poznámka: Ide o bezpečnostnú funkciu. Volania postback rozhrania SKAdNetwork sú kryptograficky podpísané.
redownload: {redownload}	Hodnota z volania postback rámca SKAdNetwork
source_app_id: {source_app_id}	Hodnota z volania postback rámca SKAdNetwork. Poznámka: Ide o identifikátor aplikácie, v ktorej používateľ klikol na reklamu vedúcu k inštalácii.
did_win: {did_win}	Hodnota z volania postback rámca SKAdNetwork. Poznámka: Inzerenti dostávajú iba víťazné volania postback. Reklamné technológie dostávajú víťazné volania postback aj konkurenčné alebo asistujúce volania postback.
ad_network_id: {ad_network_id} Pokiaľ {identifikator_reklamnej_siete} predstavuje hodnotu vo volaní postback.	Hodnota z volania postback rámca SKAdNetwork. Zobrazuje reklamnú sieť, ktorá zobrazila vašu reklamu. Tieto informácie budú užitočné aj pre dimenziu návštevnosti „zdroj‟.

 

4. krok: overenie, či sa prijímajú prístupy súpravy služieb Marketing Platform

Udalosti campaign_details sa nezobrazujú priamo v službe Google Analytics. Volania postback rozhrania SKAdNetwork sa namiesto toho menia na udalosti a sú integrované do kľúčových udalostí first_open a reportov udalostí. Možno ich segmentovať podľa dimenzie platformy zdroja (platforma zdroja = SKAN).

Ak chcete mať istotu, že sa odosielajú prístupy, odporúčame vám zaznamenať testovacie udalosti duplikovaním udalostí campaign_details pod iným názvom udalosti (t. j. campaign_details_skan_test). Potom môžete overiť, či sa testovacie udalosti zobrazujú v reporte v reálnom čase v službe Google Analytics. Ak testovaciu udalosť a parametre zaregistrujete, zobrazia sa v reporte V reálnom čase aj v reportoch ad hoc.

Poznámky:

• Ak chcete, aby sa v reportoch zobrazovali všetky volania postback rozhrania SKAdNetwork, okrem odosielania jednotlivých volaní postback ako udalostí campaign.details musíte zaregistrovať duplicitnú udalosť a parametre, ako je uvedené vyššie. Ak to urobíte, volania postback rozhrania SKAdNetwork musia byť naďalej odosielané pomocou udalosti campaign.details. Inak ich Google Analytics nerozpozná a nebude môcť vykonať modelovanie konverzií na zlepšenie reportov first_open pre iOS.
• Ak chcete, aby služba Google Analytics použila v modelovaní konverzií a reportoch volania postback rozhrania SKAdNetwork, je potrebné odoslať ich do štyroch dní od ich prijatia.

Ďalšie informácie o všeobecných krokoch overenia