[GA4] SKAdNetworkin takaisinlähetysten lähettäminen Google Analyticsiin

Tässä artikkelissa kerrotaan, miten voit lähettää SKAdNetworkin takaisinlähetykset Google Analyticsiin käyttämällä Measurement Protocolia.

Vaihe 1: Rekisteröi SKAdNetworkin takaisinlähetykset asiaankuuluville iOS-versioille

Lue lisää Applen dokumentaatiosta. Jos käytät Google Analytics for Firebase SDK:ta, SDK tekee rekisteröinnit automaattisesti sovelluksen puolesta ja voit ohittaa tämän vaiheen.

Vaihe 2: Varmista, että saat SKAdNetworkin takaisinlähetyksiä ja purat ne

Lue lisää Applen dokumentaatiosta. Jos et ole ottanut käyttöön SKAdNetwork-päätepistettä, sinun on tehtävä se seuraamalla Applen ohjeita.

Huom. Google Analytics 4:ää ei voi tällä hetkellä määrittää päätepisteeksi.

Jos olet jo määrittänyt päätepisteen käyttämällä Googlen hyväksymää App Attribution Partner (AAP) ‐kumppania tai omaa ratkaisua, voit siirtyä vaiheeseen 3, jonka ohjeiden avulla voit ohjata tulokset Google Analyticsiin Measurement Protocolin avulla.

Vaihe 3: Ohjaa takaisinlähetystulokset Google Analyticsiin käyttämällä Measurement Protocolia

Tämä tehdään lähettämällä oma campaign_details-tapahtuma Google Analyticsiin Measurement Protocolin kautta käyttämällä seuraavaa mallia (koodauslabraesimerkki).

Google Analytics 4:n, SKAdNetworkin ja Measurement Protocolin käyttöönotto

Kaikki parametrit ovat pakollisia, ellei niiden ole mainittu olevan valinnaisia.

Pyyntötason parametrit

Parametri	Lisätiedot
firebase_app_id: {gmp_app_id}	Siirry Google Analytics 4:ssä kohtaan Järjestelmänvalvoja > Datastriimit > valitse striimi > Firebase-sovelluksen tunnus. Parametri on hyötykuorman ulkopuolella.
api_secret: {api_secret}	Jos haluat luoda uuden salatunnuksen, siirry Google Analytics 4:ssä kohtaan Järjestelmänvalvoja > Datastriimit > valitse striimi > Measurement Protocol > Luo. Parametri on hyötykuorman ulkopuolella.
timestamp_micros: {vastaanotetun SKAN-takaisinlähetyksen aikaleima}	Valinnainen. Jos tämä lähetetään, arvon on oltava 72 viime tunnin ajalta. Jos tätä ei ole lähetetä, käytetään keruuhetken aikaleimaa. Tärkeiden tapahtumien ikkuna Google Analytics 4:ssä hankintatapahtumille on 30 päivää. Takaisinlähetykset on tärkeää lähettää mahdollisimman pian, jotta saat tarkempaa raportointia.
app_instance_id: {...}	Pakollinen. Luo yksilöllinen merkkijono käyttämällä satunnaisia lukuja. Tämä tunnusmerkkijono hylätään ja sen tilalle tulevat todelliset sovellusesiintymätunnukset, kun dataa käytetään konversiomallinnuksessa.

Google Analytics ‐tapahtuma

Tapahtuma	Lisätiedot
campaign_details	Oma tapahtuma

Google Analytics ‐parametrit (nykyiset)

Parametri	Lisätiedot
source: {source}	Näitä parametreja käytetään manuaalisessa taggauksessa. Google Analytics 4:n raportoinnissa käytetään Google Analytics 4:n oletusarvoisia kanavaryhmittelyjä. Suosittelemme hyödyntämään niitä parametrien luokittelussa. Lähetä nämä parametrit kaikkien paitsi Googlen takaisinlähetysten yhteydessä. Esimerkki: Facebook-takaisinlähetys: source: facebook medium: cpc|cpm content: ad_version_name campaign: Kevään 2022 Facebook-kampanja campaign_id: SKAN-takaisinlähetykseen sisältyvä kampanjatunnus Google-takaisinlähetysten yhteydessä puramme kampanjat sen mukaan, miten mittauskokonaisuutesi on integroitu Google Adsiin. Edellä olevat parametrit ovat siis valinnaisia Google-takaisinlähetyksissä. Varmista, että Google Analytics 4 ‐mittauskokonaisuutesi on linkitetty Google Ads ‐mainontatileihisi. Huom. On tärkeää, että lähetät Google Analytics 4:ään kaikki SKAdNetworkin takaisinlähetykset (pelkkien muiden kuin Googlen takaisinlähetysten sijasta).
medium: {medium}
term: {term} – valinnainen
content: {content} – valinnainen
campaign_id: {campaign_id}	Arvo SKAdNetworkin takaisinlähetyksestä.
campaign: {campaign} – valinnainen, mutta jos tätä ei lähetetä, arvona näkyy "(not set)"	Google Ads ‐kampanjoiden yhteydessä puramme tunnuksen, lisäämme kampanjan nimen Google Analyticsin ja Google Adsin välisen linkityksesi perusteella ja päivitämme source- ja medium-parametrit. Jos tilejäsi ei ole linkitetty, emme pura Google-kampanjatunnuksia ja käytämme määritettyjä source- ja medium-parametreja. Muiden kuin Google Ads ‐kampanjoiden yhteydessä voit itse purkaa ja lisätä kampanjoiden nimet. Jos et tiedä niitä, voit kopioida SKAdNetworkin campaign_id-arvon. Huom. Jos tätä ei lähetetä, arvona näkyy (not set).
source_platform: apple_skan	Tärkeää: Tämän merkkijonon on oltava täsmälleen vaaditussa muodossa kirjainkokoa ja alaviivoja (_) myöten.
app_id: {app_id}	Arvo SKAdNetworkin takaisinlähetyksestä. Tämä on sovelluspaketin tunnus.
transaction_id: {transaction_id}	Arvo SKAdNetworkin takaisinlähetyksestä.

Uudet pakolliset parametrit

Huom. Nämä uudet parametrit voidaan ottaa käyttöön Google Analytics 4:n käyttöliittymässä, mutta ne eivät ole pakollisia. Jos haluat nähdä näiden parametrien perusteella tarkkaa omien ulottuvuuksien raportointia, ne on rekisteröitävä Google Analytics 4:ssä.

Parametri	Lisätiedot
version: {version}	Arvo SKAdNetworkin takaisinlähetyksestä.
conversion_value: {conversion_value}	Arvo SKAdNetworkin takaisinlähetyksestä.
fidelity_type: {fidelity_type}	Arvo SKAdNetworkin takaisinlähetyksestä.
attribution_signature: {attribution_signature}	Arvo SKAdNetworkin takaisinlähetyksestä. Huom. Tämä on turvaominaisuus. SKAdNetworkin takaisinlähetykset allekirjoitetaan salatusti.
redownload: {redownload}	Arvo SKAdNetworkin takaisinlähetyksestä.
source_app_id: {source_app_id}	Arvo SKAdNetworkin takaisinlähetyksestä. Huom. Tämä on sen sovelluksen tunnus, jossa mainosta klikattiin niin, että klikkaus johti asennukseen.
did_win: {did_win}	Arvo SKAdNetworkin takaisinlähetyksestä. Huom. Mainostajat saavat vain voittaneet takaisinlähetykset. Mainosteknologiat puolestaan saavat voittaneet takaisinlähetykset sekä toiseksi tulleet ja avustaneet takaisinlähetykset.
ad_network_id: {ad_network_id} {ad_network_id} edustaa takaisinlähetyksen sisältämää arvoa.	Arvo SKAdNetworkin takaisinlähetyksestä. Tämä ilmaisee mainosverkoston, jossa mainoksesi on näkynyt. Siitä on hyötyä myös Liikenteen lähde ‐ulottuvuudelle.

 

Vaihe 4: Tarkista, että Marketing Platform ‐osumia vastaanotetaan

Campaign_details-tapahtumat eivät näy suoraan Google Analyticsissa. Sen sijaan SKAdNetworkin takaisinlähetykset muutetaan tapahtumiksi ja integroidaan tärkeisiin first_open-tapahtumiin ja ‑tapahtumaraportointiin. Ne voidaan segmentoida lisäämällä Liikenteen lähteen alusta ‑ulottuvuus (liikenteen lähteen alusta = SKAN).

Jos haluat varmistaa, että osumia lähetetään, voit kirjata testitapahtumia kopioimalla campaign_details-tapahtumat ja lisäämällä niille eri nimen (esim. campaign_details_skan_test). Tämän jälkeen voit tarkistaa, että testitapahtumat näkyvät Google Analytics 4:n reaaliaikaisessa raportissa. Jos rekisteröit testitapahtuman ja ‐parametrit, ne näkyvät reaaliaikaisen raportoinnin lisäksi myös tarpeen mukaan luotavissa raporteissa.

Hyvä huomata

• Jos haluat, että kaikki SKAdNetworkin takaisinlähetykset näkyvät raporteissa, sinun on lähetettävä ne campaign.details-tapahtumana ja lisäksi rekisteröitävä tapahtuman kopio ja parametrit yllä kuvatulla tavalla. Jos teet niin, SKAdNetworkin takaisinlähetykset on silti lähetettävä campaign.details-tapahtuman kautta. Muuten Google Analytics ei tunnista niitä eikä voi tehdä konversiomallinnusta iOS:n first_open-raportoinnin parantamiseksi.
• SKAdNetworkin takaisinlähetykset on lähetettävä neljän päivän kuluessa niiden vastaanottamisesta, jotta Google Analytics voi hyödyntää niitä konversiomallinnuksessa ja raportoinnissa.

Lue lisää yleisistä tarkistusvaiheista.