[GA4] SKAdNetwork-visszaküldések küldése a Google Analytics rendszerbe

Az alábbi cikk azt tekinti át, hogyan küldhetők SKAdNetwork-visszaküldések a Google Analytics rendszernek a Measurement Protocol használatával.

1. lépés: Az SKAdNetwork-visszaküldések regisztrálása a megfelelő iOS-verziókhoz

További információt az Apple dokumentációjában talál. A Google Analytics for Firebase SDK-t használó ügyfelek számára az SDK automatikusan elvégzi a regisztrációt az alkalmazás számára; náluk ez a lépés kihagyható.

2. lépés: Az SKAdNetwork-visszaküldések fogadásának és dekódolásának ellenőrzése

További információt az Apple dokumentációjában talál. Ha még nem állított be SKAdNetwork-végpontot, akkor az Apple dokumentációjában foglaltak szerint tegye ezt meg. 

Megjegyzés: A Google Analytics 4 jelenleg nem konfigurálható végpontként.

Ha már állított be végpontot Google által jóváhagyott alkalmazás-hozzárendelési partnerrel (AAP) vagy saját megoldással, akkor az eredmények Measurement Protocol segítségével a Google Analytics szolgáltatásba történő küldésének folyamatát áttekintő 3. lépésre ugorhat.

3. lépés: A visszaküldési eredmények elküldése a Google Analytics szolgáltatásba a Measurement Protocol használatával

Ehhez el kell küldeni egy egyéni campaign_details eseményt a Google Analytics számára a Measurement Protocol segítségével, a következő séma alkalmazásával (a kódlabor példája). 

Google Analytics 4 SKAdNetwork Measurement Protocol – megvalósítás

Az opcionálisként megadottak kivételével minden paraméter kötelező.

Kérelemszintű paraméterek

Paraméter	További információ
firebase_app_id: {gmp_app_id}	A Google Analytics 4 szolgáltatásban lépjen az Adminisztrálás > Adatfolyamok > megfelelő adatfolyam > Firebase-alkalmazásazonosító részre. A hasznos adatokon kívül beállított.
api_secret: {api_secret}	Új titkos kód létrehozásához lépjen az Adminisztrálás > Adatfolyamok > megfelelő adatfolyam > Measurement Protocol > Létrehozás részre a Google Analytics 4 szolgáltatásban. A hasznos adatokon kívül beállított.
timestamp_micros: {timestamp of received SKAN postback}	Nem kötelező, de ha megadja, akkor a legutóbbi 72 órán belülinek kell lennie. Ha nincs megadva, a rendszer a gyűjtés időbélyegét használja. A Google Analytics 4 szolgáltatásban az ügyfélszerzési események kulcseseményeinek időtartama 30 nap. A jelentéskészítés pontosabbá tételéhez fontos, hogy a lehető leghamarabb elküldje a visszaküldéseket.
app_instance_id: {...}	Kötelező. Véletlen számokból álló egyedi karakterlánc létrehozása. Miután a rendszer felhasználta ezeket az adatokat a konverziómodellezésben, elveti ezt az azonosítót a tényleges alkalmazáspéldány-azonosítóknál.

GA-esemény

Esemény	További információ
campaign_details	Egyéni esemény.

GA-paraméterek (meglévő)

Paraméter	További információ
source: {source}	Ezek a kézi címkézés során használt paraméterek. A Google Analytics 4 jelentéskészítési szerkezetének kialakítása a Google Analytics 4 alapértelmezett csatornacsoportjainak használatával történik. Azt javasoljuk, hogy ezeket használja segédletként az egyes paraméterek kategorizálásához. Minden olyan visszaküldésnél küldje el ezeket a paramétereket, amely nem a Google-tól származik. Példa: Facebook-visszaküldés: forrás: facebook médium: cpc|cpm tartalom: ad_version_name kampány: Facebook, 22 tavaszi kampány  kampányazonosító: a SKAN-visszaküldés alapján A Google-visszaküldések esetén a tulajdon Google Ads szolgáltatással való integrációja alapján dekódoljuk a kampányokat. Ennek megfelelően a Google-visszaküldéseknél a fenti paraméterek nem kötelezők. Győződjön meg arról, hogy a Google Analytics 4-tulajdon össze van kapcsolva a Google Ads-hirdetési fiókokkal.  Megjegyzés: Fontos, hogy az összes SKAdNetwork-visszaküldést elküldje a Google Analytics 4 számára, ne csak a Google-visszaküldéseket.
medium: {medium}
term: {term}  Nem kötelező
content: {content}  Nem kötelező
campaign_id: {campaign_id}	Az SKAdNetwork-visszaküldésből származó érték.
campaign: {campaign}  Nem kötelező, de ha nem használja, a „(nincs beállítva)” érték jelenik meg	A Google Ads-kampányoknál a Google Analytics- és a Google Ads-összekapcsolás alapján dekódoljuk az azonosítót és adjuk meg a kampány nevét, majd frissítjük a forrás és a médium paramétereket. Ha a fiókok nincsenek összekapcsolva, akkor nem dekódoljuk a Google-kampányazonosítókat, és a megadott forrás és médium paramétereket használjuk. Nem Google Ads-kampányoknál dekódolhatja és megadhatja a kampányneveket. Ha nem ismeri őket, másolja ki az SKAdNetwork campaign_id paraméterét. Megjegyzés: Ha nincsenek megadva, akkor a (nincs beállítva) érték jelenik meg.
source_platform: “apple_skan”	Fontos: Ezt a karakterláncot pontosan kell megadnia; a kis- és nagybetűknek, illetve a _ karakternek is egyeznie kell.
app_id: {app_id}	Az SKAdNetwork-visszaküldésből származó érték. Ez az alkalmazáscsomag azonosítója.
transaction_id: {transaction_id}	Az SKAdNetwork-visszaküldésből származó érték.

Kötelező új paraméterek

Megjegyzés: Ezek az új paraméterek a Google Analytics 4 kezelőfelületén állíthatók be; ez azonban nem kötelező. Ha e paraméterek alapján konkrét egyéni dimenziókat tartalmazó jelentéseket szeretne készíteni, akkor regisztrálnia kell a paramétereket a Google Analytics 4 rendszerben.

Paraméter	További információ
version: {version}	Az SKAdNetwork-visszaküldésből származó érték.
conversion_value: {conversion_value}	Az SKAdNetwork-visszaküldésből származó érték.
fidelity_type: {fidelity_type}	Az SKAdNetwork-visszaküldésből származó érték.
attribution_signature: {attribution_signature}	Az SKAdNetwork-visszaküldésből származó érték. Megjegyzés: Ez biztonsági funkció. Az SKAdNetwork-visszaküldések titkosítási aláírással vannak ellátva.
redownload: {redownload}	Az SKAdNetwork-visszaküldésből származó érték.
source_app_id: {source_app_id}	Az SKAdNetwork-visszaküldésből származó érték. Megjegyzés: Ez annak az alkalmazásnak az azonosítója, amelyben rákattintottak a telepítést eredményező hirdetésre.
did_win: {did_win}	Az SKAdNetwork-visszaküldésből származó érték. Megjegyzés: A hirdetők csak nyertes visszaküldéseket kapnak. Ahol az AdTech technológiák megkapják a nyertes visszaküldéseiket és a második helyezett/segítő visszaküldéseket.
ad_network_id: {ad_network_id} Az {ad_network_id} jelöli a visszaküldésben lévő értéket.	Az SKAdNetwork-visszaküldésből származó érték. Megmutatja a hirdetést megjelenítő hirdetési hálózatot. Ez a „forrás” forgalmi dimenzió számára is hasznos információ.

 

4. lépés: Ellenőrizze, hogy megérkeznek-e a Marketing Platform-lekérések

A campaign_details események nem jelennek meg közvetlenül a Google Analytics szolgáltatásban. Ehelyett az SKAdNetwork-visszaküldések eseményekké alakulnak, majd integrálódnak a first_open kulcseseményekbe és az eseményjelentésekbe. A dimenzió forrásplatformjának (forrásplatform = SKAN) hozzáadásával szegmentálhatók.

Ha meg szeretne győződni arról, hogy a rendszer elküldi a lekéréseket, azt javasoljuk, hogy úgy naplózza a teszteseményeket, hogy a campaign_details eseményekről egy másik eseménynév használatával (például campaign_details_skan_test) másolatot készít. Ezután ellenőrizheti, hogy a tesztesemények megjelennek-e a Google Analytics 4 Valós idejű jelentésében. Ha regisztrálja a teszteseményt és a paramétereket, akkor a Valós idejű jelentés mellett az eseti jelentésekben is megjelennek.

Megjegyzések:

• Ha azt szeretné, hogy az összes SKAdNetwork-visszaküldés megjelenjen a jelentésekben, akkor nem elég, ha mindegyiket elküldi campaign.details eseményként, de az ismétlődő eseményt és a paramétereket is regisztrálnia kell a fent említett módon. Ha ezt a megoldást választja, az SKAdNetwork-visszaküldéseket továbbra is a campaign.details esemény használatával kell elküldeni. Ellenkező esetben a Google Analytics nem ismeri fel őket, és a konverziómodellezés nem lesz használható az iOS first_open jelentéseinek javításához. 
• Az SKAdNetwork-visszaküldéseket a fogadásuktól számított 4 napon belül kell elküldeni ahhoz, hogy a Google Analytics felhasználhassa őket a konverziómodellezéshez és a jelentéskészítéshez.

További információ az általános ellenőrzési lépésekről.