Monitoraggio delle conversioni

Nota :il monitoraggio delle conversioni è stato aggiornato il 2 febbraio 2024. In caso di domande sulle modifiche, contatta il tuo rappresentante di Google.

Avviso: assicurati che, come parte dei dati sulle conversioni, non vengano inviate a Google informazioni che consentono l'identificazione personale (PII) dell'utente.

Implementazione

Riepilogo

L'implementazione del monitoraggio delle conversioni prevede tre passaggi:

• Raccolta del rwg_token dalla pagina di destinazione o dal punto di ingresso dell'app.
• Mantenere rwg_token per la finestra di attribuzione appropriata
• Inviare un evento di conversione al momento del pagamento

Questa implementazione del monitoraggio delle conversioni non richiede l'utilizzo di Google Analytics o di qualsiasi altro codice JavaScript di terze parti.

Punto chiave: esistono due diversi livelli a cui puoi implementare il monitoraggio delle conversioni: a livello di dispositivo e a livello di utente. Entrambi sono supportati durante questa integrazione e puoi scegliere in base all'architettura del prodotto.

Prima di iniziare a lavorare sull'implementazione del monitoraggio delle conversioni, devi decidere se monitorare le conversioni a livello di dispositivo o di utente:

• Il livello di dispositivo include l'utilizzo di cookie del browser, spazio di archiviazione locale, archiviazione locale dell'app o qualsiasi altro metodo che possa mantenere il token per la finestra di attribuzione di 30 giorni. Poiché il token viene memorizzato localmente sul dispositivo dell'utente, se l'utente cambia il dispositivo utilizzato, cancella l'archiviazione locale o i cookie oppure se utilizza una modalità di navigazione in incognito o privata, l'evento di conversione potrebbe non essere attribuito correttamente. Quando utilizzi il monitoraggio delle conversioni a livello di dispositivo, devi implementarlo nuovamente su ogni piattaforma supportata (inclusi i dispositivi mobili).
• Il livello utente include la memorizzazione nel database dell'applicazione tramite un sistema di analisi lato server o altri sistemi lato server. Poiché il token verrà archiviato sul lato server, se l'utente cambia il dispositivo che sta utilizzando, cancella lo spazio di archiviazione locale o i cookie oppure se utilizza una modalità di navigazione in incognito o di navigazione privata, l'evento di conversione viene comunque attribuito una volta che l'utente esegue nuovamente l'accesso. Quando utilizzi il monitoraggio delle conversioni a livello di utente, a seconda dell'architettura del sistema potresti essere in grado di implementarlo una volta sul lato server e riutilizzarlo su tutte le piattaforme supportate.

Raccogliere rwg_token

Ogni volta che Google mostra un link action_link che hai fornito tramite i feed, l'URL viene modificato per includere un parametro di ricerca univoco: rwg_token. Il valore rwg_token è una stringa codificata che contiene alcuni metadati sul link su cui l'utente ha fatto clic. Devi archiviare questo token e ritrasmetterlo come parte dell'evento di conversione.

Su ogni pagina di destinazione o punto di ingresso dell'app devi analizzare il valore impostato per il parametro di query rwg_token e archiviarlo. I requisiti per l'archiviazione di questo parametro sono descritti nel passaggio Creazione di rwg_token.

Di seguito è riportato un esempio di come è possibile analizzare questo token per il monitoraggio a livello di dispositivo tramite il browser. In alternativa, potresti raccogliere questo token sul lato server quando rispondi alla richiesta:

<script>
  var query = location.search.substring(1);
  var params = query.split('&');
  var rwgToken = undefined;
  for (var i = 0; i < params.length; ++i) {
    var pair = params[i].split('=');
    if (pair[0] == 'rwg_token') {
      rwgToken = decodeURIComponent(pair[1]);
      break;
    }
  }
</script>

Mantenere rwg_token

Nota: la presenza di rwg_token è fondamentale per implementare correttamente la finestra di attribuzione richiesta. Per ulteriori dettagli sui requisiti di attribuzione, consulta la sezione Requisiti per l'attribuzione delle conversioni riportata di seguito.

Ti verrà chiesto di mantenere in modo permanente il parametro URL rwg_token, che verrà aggiunto a tutti i link di azione forniti da te, per una durata totale di 30 giorni. Il valore di rwg_token deve essere archiviato e restituito senza alcuna modifica.

Insieme al token rwg_token, devi archiviare i merchant_id associati al link di azione.

Se esiste già un token salvato in una visita precedente, è necessario sostituire i token rwg_token e merchant_id precedenti e reimpostare la finestra di 30 giorni per l'archiviazione.

Quando mantieni la coppia precedente, puoi memorizzare i valori a livello di dispositivo o di utente:

• Il livello di dispositivo include l'utilizzo di cookie del browser, spazio di archiviazione locale, archiviazione locale dell'app o qualsiasi altro metodo che possa mantenere il token per la finestra di attribuzione di 30 giorni.
• Il livello utente include la memorizzazione nel database dell'applicazione tramite un sistema di analisi lato server o altri sistemi lato server.

Di seguito è riportato un esempio di monitoraggio delle conversioni a livello di dispositivo, in cui questi valori vengono memorizzati in un browser web utilizzando un cookie proprietario. Questo esempio presuppone che tu abbia analizzato il valore del token in una variabile, come nell'esempio precedente. Per usare questo esempio, devi aggiornare "rootdomain" al tuo dominio.

<script>
  if (typeof rwg_token !== 'undefined') {
    document.cookie =
    "_rwg_token=" + rwg_token + ";_merchant_id="+merchantid +";max-age=2592000;domain=rootdomain.com;path=/";
  }
</script>

Quando utilizzi il monitoraggio delle conversioni a livello di utente, rwg_token + merchant_id devono essere archiviati sul server e associati all'utente.

Invio di dati sulle conversioni

Quando un utente completa una transazione attribuibile a un link di Google Place Action, devi inviare una richiesta POST HTTP all'endpoint di conversione. Esistono due endpoint, uno per l'ambiente di produzione e uno per l'ambiente sandbox.

• Produzione: https://www.google.com/maps/conversion/collect
• Sandbox: https://www.google.com/maps/conversion/debug/collect

Il corpo del post deve essere un oggetto con codifica JSON nel formato:

{
  "conversion_partner_id": <partnerId>,
  "rwg_token": <rwg_token_val>
  "merchant_changed": 1|2
}

Il valore merchant_changed viene utilizzato per determinare se il commerciante è stato modificato rispetto al commerciante di reindirizzamento iniziale. Ci sono due valori che possono essere trasmessi

Valore variazione commerciante	Requisito
1	Questo valore deve essere utilizzato quando un utente ha lasciato il sito web del commerciante originale e ha completato un acquisto tramite la tua piattaforma con un commerciante diverso
2	Questo valore deve essere utilizzato quando il cliente ha completato una transazione tramite l'entità originale (commerciante).

Sia nell'ambiente sandbox che in quello di produzione, devi fornire un rwg_token valido quando invii un evento di conversione. A scopo di test, utilizza il seguente token di test in entrambi gli ambienti fino al lancio:

ADQ7psRE9YyDSVR6YpfD-fYdxoFYVKS1xeTvXdSxqF8a3bnk0W62eMEnUjoNPwjhNHG0elwBnM1awTjr9vXET8yOowCeuODjwA==

Nota: in produzione, non devi inviare eventi di conversione non attribuiti a questa integrazione. Assicurati di verificare la presenza di un valore rwg_token valido e non scaduto prima di inviare l'evento.

Di seguito è riportato un esempio completo di monitoraggio delle conversioni a livello di dispositivo (utilizzando un cookie sul dispositivo dell'utente) in JavaScript relativo a come effettuare questa richiesta di post:

const partnerId = XXXXXXXXXX;

const endpoint = `https://www.google.com/maps/conversion/collect`;

const rwgTokenCookie = document.cookie
  .split('; ')
  .find(row => row.startsWith('_rwg_token='));

if (typeof rwgTokenCookie !== 'undefined') {
  const rwgTokenVal = rwgTokenCookie.split('=')[1];
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: rwgTokenVal,
      Merchant_changed: merchantChanged
    })
  });
}

Quando utilizzi il monitoraggio delle conversioni a livello di utente, devi recuperare il token associato all'utente (indipendentemente dalla superficie in cui si trova) dal meccanismo di archiviazione lato server e inviarlo utilizzando gli stessi endpoint di produzione o sandbox.

Nota: gli eventi di conversione possono essere inviati da un client web o di app o dal server. Puoi prendere questa decisione in base alle tue esigenze e a dove è archiviato il token, a condizione che un evento di conversione venga inviato esattamente una volta per conversione e che includa un valore rwg_token valido.

Requisiti di attribuzione delle conversioni

Lo standard richiesto da Google per l'attribuzione delle conversioni è una finestra di attribuzione di 30 giorni per qualsiasi interazione con un link a un luogo, in qualsiasi negozio.

Nota: questo framework di attribuzione potrebbe essere diverso dal modo in cui il sistema di analisi attribuisce le conversioni. Questo sistema è progettato per funzionare indipendentemente dal monitoraggio delle conversioni che esegui nei tuoi sistemi e non dovrebbe influire sulle analisi interne.

Questa finestra di attribuzione indica che Google si aspetta che venga inviato un evento di conversione in uno dei seguenti scenari:

• Un utente segue un link per l'azione di contatto ed effettua un ordine per lo stesso commerciante nella stessa sessione(Valore variazione commerciante = 2)
• Un utente segue un link di azione diretta e poi torna da un canale diverso entro il periodo di 30 giorni per effettuare un ordine per lo stesso commerciante. ( Valore variazione commerciante = 2)
• Un utente segue un link all'azione di posizionamento e poi effettua un ordine in un altro negozio, nella stessa sessione o in una diversa sessione in un periodo di 30 giorni. ( Valore variazione commerciante = 1)

Inoltre, Google si aspetta che gli eventi di conversione vengano inviati da tutte le piattaforme a cui un utente può arrivare da un link di azione luogo. Tra cui:

• Applicazioni web desktop o mobile
• App mobile, tramite un link diretto all'app o un intent di app registrato per il tuo dominio

Se il token è archiviato a livello di utente (vedi il salvataggio del token), si prevede che fornisci l'attribuzione cross-device. In altre parole, un utente che segue un link all'azione dal computer e poi completa la transazione su un dispositivo mobile (utilizzando lo stesso account utente) dovrebbe attivare un evento di conversione.

Se il token viene memorizzato esclusivamente a livello di dispositivo, ad esempio nei cookie del browser, non è previsto l'attribuzione cross-device. In questo caso, ogni dispositivo avrebbe un token separato persistente se l'utente avesse seguito un link di azione sul dispositivo e ogni dispositivo seguisse le regole di attribuzione separatamente.