[GA4] Inviare postback di SKAdNetwork a Google Analytics

Il seguente articolo illustra i passaggi per inviare postback di SKAdNetwork a Google Analytics utilizzando Measurement Protocol.

Passaggio 1: registra i postback di SKAdNetwork per le versioni di iOS pertinenti

Per saperne di più, consulta la documentazione di Apple. Per i clienti che utilizzano l'SDK Google Analytics for Firebase, l'SDK registra questi postback automaticamente per conto dell'app. Puoi quindi saltare questo passaggio.

Passaggio 2: assicurati di ricevere e decodificare i postback di SKAdNetwork

Per saperne di più, consulta la documentazione di Apple. Se non hai configurato un endpoint SKAdNetwork, devi farlo seguendo la documentazione di Apple. 

Nota: al momento, non è possibile configurare Google Analytics 4 come endpoint.

Se hai già configurato un endpoint con un partner di attribuzione app (AAP) approvato da Google o una soluzione interna, puoi andare al passaggio 3 che ti guida nella procedura di indirizzamento dei risultati a Google Analytics utilizzando Measurement Protocol.

Passaggio 3: indirizza i risultati dei postback a Google Analytics utilizzando Measurement Protocol

Per eseguire questa operazione, invia un evento campaign_details personalizzato a Google Analytics tramite Measurement Protocol utilizzando lo schema riportato di seguito (esempio di codelab). 

Implementazione di SKAdNetwork in Google Analytics 4 tramite Measurement Protocol

Tutti i parametri sono obbligatori, a meno che non siano stati specificati come facoltativi.

Parametri a livello di richiesta

Parametro	Ulteriori informazioni
firebase_app_id: {gmp_app_id}	In Google Analytics 4, vai ad Amministrazione > Stream di dati > scegli il tuo stream > ID app Firebase. Imposta il parametro al di fuori del payload.
api_secret: {api_secret}	Per creare un nuovo secret, vai ad Amministrazione > Stream di dati > scegli il tuo stream > Measurement Protocol > Crea in Google Analytics 4. Imposta il parametro al di fuori del payload.
timestamp_micros: {timestamp of received SKAN postback}	Facoltativo. Tuttavia, se viene specificato, deve rientrare nelle ultime 72 ore. Se non viene specificato, verrà utilizzato il timestamp della raccolta. La finestra degli eventi chiave in Google Analytics 4 per gli eventi di acquisizione è di 30 giorni. Per generare report più accurati, è importante inviare i postback il prima possibile.
app_instance_id: {...}	Obbligatorio. Genera una stringa univoca di numeri casuali. Questa stringa ID specifica verrà ignorata e verranno utilizzati ID di istanze di app effettivi una volta che questi dati verranno utilizzati nella definizione del modello di conversione.

Evento GA4

Evento	Ulteriori informazioni
campaign_details	Evento personalizzato.

Parametri GA (esistenti)

Parametro	Ulteriori informazioni
source: {source}	Questi sono i parametri utilizzati nel tagging manuale. I report di Google Analytics 4 vengono organizzati utilizzando i raggruppamenti dei canali predefiniti di Google Analytics 4. Ti consigliamo di utilizzarli come guida per classificare ciascun parametro. Invia questi parametri per tutti i postback non Google. Ecco alcuni esempi: Postback di Facebook: source: facebook medium: cpc|cpm content: ad_version_name campaign: Facebook Spring 22 Campaign  campaign id: uguale a quello del postback SKAN Per i postback di Google, decodificheremo le campagne in base all'integrazione della tua proprietà con Google Ads. Pertanto, i parametri indicati sopra sono facoltativi per i postback di Google. Devi assicurarti che la proprietà Google Analytics 4 sia collegata agli account pubblicitari Google Ads.  Nota: è importante inviare a Google Analytics 4 tutti i postback di SKAdNetwork, non solo quelli non Google.
medium: {medium}
term: {term} facoltativo
content: {content} facoltativo
campaign_id: {campaign_id}	Valore ottenuto dal postback di SKAdNetwork.
campaign: {campaign} facoltativo. Tuttavia, se non viene fornito, questo parametro verrà mostrato come (not set)	Per le campagne Google Ads, decodificheremo l'ID e forniremo il nome della campagna in base al collegamento di Google Analytics e Google Ads. Inoltre, aggiorneremo i parametri source e medium. Se i tuoi account non sono collegati, non decodificheremo gli ID campagna Google e utilizzeremo i parametri source e medium specificati. Per le campagne non Google Ads, puoi decodificare e fornire i nomi delle campagne. Se non conosci il nome, puoi copiare il parametro campaign_id di SKAdNetwork. Nota: se non viene fornito, questo parametro verrà visualizzato come (not set).
source_platform: “apple_skan”	Importante: devi specificare esattamente questa stringa, rispettando le lettere maiuscole e il carattere _.
app_id: {app_id}	Valore ottenuto dal postback di SKAdNetwork. Questo sarà il tuo ID app bundle.
transaction_id: {transaction_id}	Valore ottenuto dal postback di SKAdNetwork.

Nuovi parametri obbligatori

Nota: questi nuovi parametri possono essere configurati nell'interfaccia utente di Google Analytics 4; tuttavia non sono obbligatori. Se vuoi visualizzare report specifici sulle dimensioni personalizzate basati su questi parametri, devi registrarli in Google Analytics 4.

Parametro	Ulteriori informazioni
version: {version}	Valore ottenuto dal postback SKAdNetwork
conversion_value: {conversion_value}	Valore ottenuto dal postback SKAdNetwork
fidelity_type: {fidelity_type}	Valore ottenuto dal postback di SKAdNetwork.
attribution_signature: {attribution_signature}	Valore ottenuto dal postback di SKAdNetwork. Nota: questa è una funzionalità di sicurezza. I postback di SKAdNetwork sono firmati tramite crittografia.
redownload: {redownload}	Valore ottenuto dal postback di SKAdNetwork.
source_app_id: {source_app_id}	Valore ottenuto dal postback di SKAdNetwork. Nota: questo è l'ID dell'app in cui si è verificato il clic sull'annuncio che ha generato l'installazione.
did_win: {did_win}	Valore ottenuto dal postback di SKAdNetwork. Nota: gli inserzionisti ricevono solo i postback migliori. I software AdTech riceveranno i relativi postback migliori e i postback runner-up/assists.
ad_network_id: {ad_network_id} dove {ad_network_id} indica il valore nel postback.	Valore ottenuto dal postback di SKAdNetwork. Mostra la rete pubblicitaria in cui è stato pubblicato il tuo annuncio. Queste informazioni saranno utili anche per la dimensione del traffico "source".

 

Passaggio 4: verifica che gli hit di Marketing Platform vengano ricevuti

Gli eventi campaign_details non vengono visualizzati direttamente in Google Analytics. I postback di SKAdNetwork vengono invece convertiti in eventi e integrati nei report sugli eventi e negli eventi chiave first_open. Possono essere segmentati aggiungendo la piattaforma di origine della dimensione (piattaforma di origine = SKAN).

Per assicurarti che gli hit vengano inviati, ti consigliamo di registrare gli eventi di test duplicando gli eventi campaign_details con un altro nome, ovvero campaign_details_skan_test. Puoi quindi verificare che gli eventi di test vengano visualizzati nel report In tempo reale di Google Analytics 4. Se registri i parametri e l'evento di test, questi verranno visualizzati nei report ad hoc, oltre che nel report In tempo reale.

Note:

• Se vuoi che tutti i postback di SKAdNetwork vengano visualizzati nei report, oltre a inviare ciascun postback come evento campaign.details, devi registrare l'evento e i parametri duplicati come indicato sopra. Se scegli di farlo, i postback di SKAdNetwork devono comunque essere inviati utilizzando l'evento campaign.details. In caso contrario, Google Analytics non li riconoscerà e non potrà eseguire la definizione del modello di conversione per migliorare i report first_open per iOS. 
• I postback di SKAdNetwork devono essere inviati entro 4 giorni dalla loro ricezione affinché Google Analytics possa utilizzarli nella definizione del modello di conversione e nei report.

Scopri di più sulla procedura di verifica generale.