Enviar notificacions de conversió d'SKAdNetwork a Google Analytics

L'article següent us mostra els passos per enviar notificacions de conversió d'SKAdNetwork a Google Analytics mitjançant Measurement Protocol.

Pas 1: registreu les notificacions de conversió d'SKAdNetwork per a les versions d'iOS rellevants

Per obtenir més informació, consulteu la documentació d'Apple. En el cas dels clients que utilitzen l'SDK de Google Analytics for Firebase, l'SDK les registra automàticament en nom de l'aplicació i podeu ometre aquest pas.

Pas 2: assegureu-vos que rebeu i descodifiqueu les notificacions de conversió d'SKAdNetwork

Per obtenir més informació, consulteu la documentació d'Apple. Si no heu configurat cap punt final d'SKAdNetwork, caldrà que ho feu seguint la documentació d'Apple.

Nota: actualment, Google Analytics 4 no es pot configurar com a punt final.

Si ja heu configurat un punt final amb un partner d'atribució d'aplicacions (AAP) aprovat per Google o amb una solució interna, podeu passar al pas 3, que us guiarà pel procés de dirigir els resultats a Google Analytics mitjançant Measurement Protocol.

Pas 3: dirigiu els resultats de les notificacions de conversió a Google Analytics mitjançant Measurement Protocol

Això es fa enviant un esdeveniment campaign_details personalitzat a Google Analytics mitjançant Measurement Protocol fent servir l'esquema següent (exemple del laboratori de programació).

Implementació de Measurement Protocol d'SKAdNetwork de Google Analytics

Tots els paràmetres són obligatoris, tret dels que s'especifiquen com a opcionals.

Paràmetres del nivell de sol·licitud

Paràmetre	Més informació
firebase_app_id: {gmp_app_id}	A Google Analytics, navegueu fins a Administració > Fluxos de dades > trieu el flux de dades > Identificador d'aplicació de Firebase. Definiu el paràmetre fora de la càrrega útil.
api_secret: {api_secret}	Per crear un secret nou, navegueu fins a Administració > Fluxos de dades > trieu el flux de dades > Measurement Protocol > Crea a Google Analytics. Definiu el paràmetre fora de la càrrega útil.
timestamp_micros: {timestamp of received SKAN postback}	Opcional, però si es proporciona, ha de ser dels dos darrers dies naturals, més el dia d'avui. Si no es proporciona, s'utilitzarà la marca de temps de la col·lecció. El període d'esdeveniment clau a Google Analytics per als esdeveniments d'adquisició és de 30 dies. És important enviar les notificacions de conversió al més aviat possible perquè els informes siguin més precisos.
app_instance_id: {...}	Required. Genereu una cadena única de nombres aleatoris. Aquesta cadena d'identificador concreta es descartarà en favor d'un identificador d'instància d'aplicació real un cop s'utilitzin aquestes dades en la modelització de conversions.

Esdeveniment de GA

Esdeveniment	Més informació
campaign_details	Esdeveniment personalitzat.

Paràmetres de GA (existents)

Paràmetre	Més informació
source: {source}	Són paràmetres que s'utilitzen en l'etiquetatge manual. Els informes de Google Analytics s'estructuren mitjançant les agrupacions de canals predeterminades de Google Analytics. Us recomanem que les feu servir com a guia per categoritzar cada paràmetre. Envieu aquests paràmetres per a totes les notificacions de conversió que no siguin de Google. Per exemple: Notificació de conversió de Facebook: source: facebook medium: cpc|cpm content: ad_version_name campaign: campanya de primavera 22 de Facebook campaign id: tal com es mostra a la notificació de conversió de SKAN En el cas de les notificacions de conversió de Google, descodificarem les campanyes segons la integració de la vostra propietat amb Google Ads. Per tant, els paràmetres anteriors són opcionals pel que fa a les notificacions de conversió de Google. Heu d'assegurar-vos que la vostra propietat de Google Analytics estigui enllaçada als comptes publicitaris de Google Ads. Nota: és important enviar a Google Analytics totes les notificacions de conversió d'SKAdNetwork, no només les que no siguin de Google.
medium: {medium}
term: {term}  Opcional
content: {content}  Opcional
campaign_id: {campaign_id}	Valor de la notificació de conversió d'SKAdNetwork.
campanya: {campaign} Opcional, però si no s'estableix, es mostrarà com a (not set).	En el cas de les campanyes de Google Ads, descodificarem l'identificador i proporcionarem el nom de la campanya segons l'enllaç de Google Analytics i Google Ads, i actualitzarem els paràmetres source i medium. Si els comptes no estan enllaçats, no descodificarem els identificadors de campanya de Google i utilitzarem els paràmetres source i medium especificats. En el cas de les campanyes que no siguin de Google Ads, podeu descodificar i proporcionar els noms de les campanyes. Si no els sabeu, podeu copiar el paràmetre campaign_id de SKAdNetwork. Nota: si no es proporciona, es mostrarà com a (not set).
source_platform: “apple_skan”	Important: heu d'especificar aquesta cadena amb exactitud, respectant l'ús de les majúscules i les ratlles baixes (_).
app_id: {app_id}	Valor de la notificació de conversió d'SKAdNetwork. Aquest seria l'identificador del paquet d'aplicació.
transaction_id: {transaction_id}	Valor de la notificació de conversió d'SKAdNetwork.

Paràmetres nous obligatoris

Nota: aquests paràmetres nous es poden configurar a la interfície d'usuari de Google Analytics, però no és obligatori. Si voleu veure informes concrets de dimensions personalitzades basats en aquests paràmetres, caldrà que els registreu a Google Analytics.

Paràmetre	Més informació
version: {version}	Valor de la notificació de conversió d'SKAdNetwork.
conversion_value: {conversion_value}	Valor de la notificació de conversió d'SKAdNetwork.
fidelity_type: {fidelity_type}	Valor de la notificació de conversió d'SKAdNetwork.
attribution_signature: {attribution_signature}	Valor de la notificació de conversió d'SKAdNetwork. Nota: això és una funció de seguretat. Les notificacions de conversió d'SKAdNetwork estan signades criptogràficament.
redownload: {redownload}	Valor de la notificació de conversió d'SKAdNetwork.
source_app_id: {source_app_id}	Valor de la notificació de conversió d'SKAdNetwork. Nota: aquest és l'identificador de l'aplicació en què s'ha fet clic a l'anunci que ha generat la instal·lació.
did_win: {did_win}	Valor de la notificació de conversió d'SKAdNetwork. Nota: els anunciants només reben les notificacions de conversió guanyadores. És on les AdTech rebran les notificacions de conversió guanyadores i les que han quedat en segona posició o en posicions posteriors.
ad_network_id: {ad_network_id} On {ad_network_id} representa el valor de la notificació de conversió.	Valor de la notificació de conversió d'SKAdNetwork. Mostra la xarxa publicitària que ha publicat el vostre anunci. Aquesta informació també serà útil per a la dimensió de trànsit "source".

 

Pas 4: verifiqueu que s'estiguin rebent les peticions de fitxer de Marketing Platform

Els esdeveniments campaign_details no es mostren directament a Google Analytics. En lloc d'això, les notificacions de conversió d'SKAdNetwork es converteixen en esdeveniments i s'integren en els esdeveniments clau first_open i en els informes d'esdeveniments. Es poden segmentar afegint la plataforma d'origen de la dimensió (plataforma font = SKAN).

Si voleu confirmar que s'estan enviant les peticions de fitxer, us recomanem que registreu esdeveniments de prova duplicant els esdeveniments campaign_details fent servir un nom d'esdeveniment diferent (p. ex., campaign_details_skan_test). A continuació, podeu verificar que els esdeveniments de prova es mostrin a l'informe En temps real de Google Analytics. Si registreu l'esdeveniment i els paràmetres de prova, es mostraran als informes ad hoc a més dels informes En temps real.

Notes:

• Si voleu que totes les notificacions de conversió d'SKAdNetwork es mostrin als informes, a més d'enviar cadascuna com a esdeveniment campaign.details, heu de registrar l'esdeveniment i els paràmetres duplicats tal com s'esmenta més amunt. Si decidiu fer-ho, cal que envieu igualment les notificacions de conversió d'SKAdNetwork amb l'esdeveniment campaign.details En cas contrari, Google Analytics no les reconeixerà i no podrà dur a terme la modelització de conversions per millorar els informes first_open d'iOS. 
• Les notificacions de conversió d'SKAdNetwork s'han d'enviar en un termini de 4 dies després de rebre-les perquè Google Analytics les pugui utilitzar per a la modelització de conversions i per als informes.

Obteniu més informació sobre els passos generals de verificació.