Monitoraggio delle conversioni

Avviso: assicurati che, nell'ambito dei dati sulle conversioni, l'identificazione personale dell'utente e non vengono inviate a Google informazioni (PII).

Implementazione

Riepilogo

L'implementazione del monitoraggio delle conversioni si compone di tre elementi:

• Raccolta di rwg_token e merchant_id dalla pagina di destinazione o dall'app il punto di accesso.
• Mantenere rwg_token e merchant_id per l'attribuzione appropriata finestra.
• Confronta i merchant_id persistenti e i merchant_id al momento della conversione (prenotazione completata).
• Invio di un evento di conversione al momento della conversione (prenotazione completata).

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

Punto chiave: esistono due diversi livelli a cui puoi implementare le conversioni di monitoraggio, a livello di dispositivo e di utente. Sono supportati entrambi durante questa operazione ed è possibile scegliere in base all'architettura del prodotto.

Prima di iniziare a implementare il monitoraggio delle conversioni, ti consigliamo di decidi se monitorare le conversioni a livello di dispositivo o di utente:

• A livello di dispositivo sono inclusi l'utilizzo di cookie del browser, spazio di archiviazione locale e locale dell'app spazio di archiviazione o qualsiasi altro metodo che possa rendere persistenti il token per 30 giorni finestra di attribuzione. Poiché il token verrebbe archiviato localmente sul dispositivo, se l'utente cambia il dispositivo che sta utilizzando, cancella i dati spazio di archiviazione o cookie oppure se utilizza una navigazione privata o la modalità di navigazione in incognito, potrebbe non essere attribuito correttamente. Quando si utilizza il livello di dispositivo il monitoraggio delle conversioni, devi implementarlo nuovamente in tutti i servizi (inclusi i dispositivi mobili).
• Il livello utente include il salvataggio nel database dell'applicazione, tramite un sistema di analisi lato server o altri sistemi lato server. Poiché verrà archiviato sul lato server se l'utente cambia il dispositivo che sta utilizzando, cancella lo spazio di archiviazione locale o i cookie oppure sta usando una di navigazione o in modalità di navigazione in incognito, l'evento di conversione viene comunque attribuito una volta l'utente eseguirà di nuovo l'accesso. Quando utilizzi il monitoraggio delle conversioni a livello di utente, a seconda sull'architettura del sistema, potreste riuscire a implementarla una volta lato server e riutilizzarlo su tutte le piattaforme supportate.

Raccolta di rwg_token in corso...

Ogni volta che Google mostra un link action_link che hai fornito tramite i Feed, questo URL viene modificato per includere un parametro di ricerca univoco: rwg_token. La Il valore rwg_token è una stringa codificata che contiene alcuni metadati relativi al collegamento su cui l'utente ha fatto clic, ma nessun dato utente. Dovresti archiviare questo token e lo ritrasmetti come parte dell'evento di conversione.

In ogni pagina di destinazione o punto di ingresso di un'app, devi analizzare il valore impostato per il parametro rwg_token e archivialo. Requisiti per l'archiviazione sono descritti nel passaggio persistente rwg_token.

Un esempio di come questo token può essere analizzato per il monitoraggio a livello di dispositivo tramite del browser è incluso di seguito. In alternativa, puoi raccogliere questo token lato server quando rispondi alla richiesta:

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;
  }
}

Raccolta di merchant_id in corso...

Se implementi la logica di monitoraggio delle conversioni nel frontend, nella pagina di destinazione devi implementare uno script personalizzato che trovi e acquisisca merchant_id. Di solito, merchant_id potrebbe essere già presente nella pagina di destinazione o nell'URL, in modo da poterla acquisire da lì. In caso contrario, devi trovare un modo per esporlo da qualche parte in modo che sia efficace, il che probabilmente implicherebbe modifiche al backend.

Se implementi la logica di monitoraggio delle conversioni nel backend, potresti trovare merchant_id insieme ai dati che eseguono query al tuo sistema interno per generare la pagina del frontend.

Questo merchant_id deve essere uguale a quello che hai condiviso con Google in del tuo feed.

Nota: nel caso raro che la tua esperienza frontend non consenta all'utente per passare da un commerciante all'altro (può verificarsi per i siti web etichetta bianca che non avere una "casa" per tornare a una selezione di commercianti). Puoi saltare le Acquisisci merchant_id e suppone che merchant_id non sia cambiata ("merchant_changed": 2) perché è impossibile per gli utenti passare da un commerciante all'altro nel loro percorso di prenotazione.

rwg_token e merchant_id persistenti

Nota: mantenere rwg_token è fondamentale per implementare correttamente i campi obbligatori finestra di attribuzione. Per ulteriori dettagli sui requisiti di attribuzione, consulta Requisiti relativi all'attribuzione delle conversioni di seguito.

Ti verrà richiesto di mantenere 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 dell'attributo rwg_token deve essere archiviato e restituito senza alcuna modifica.

Oltre a rwg_token, dovrai archiviare i merchant_id associati con il link di azione.

Se esiste già un token persistente di una visita precedente, la prima È necessario sostituire rwg_token e merchant_id, mentre la finestra di 30 giorni per lo spazio di archiviazione deve essere reimpostato.

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

• A livello di dispositivo sono inclusi l'utilizzo di cookie del browser, spazio di archiviazione locale e locale dell'app spazio di archiviazione o qualsiasi altro metodo che possa rendere persistenti il token per 30 giorni finestra di attribuzione.
• Il livello utente include il salvataggio 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 vengono memorizzati questi valori in un browser web utilizzando un cookie proprietario. Questo esempio presuppone che tu abbia analizzato in una variabile, come nell'esempio sopra. Per utilizzare questo esempio, devi aggiornare rootdomain.com al tuo dominio.

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

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

Invio dei dati sulle conversioni

Quando un utente completa una transazione attribuibile a un luogo Google Link di azione, devi inviare una richiesta POST HTTP all'endpoint di conversione. Esistono due endpoint, uno per l'ambiente di produzione e uno per dell'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
}

Esempio (commerciante non modificato con il token di prova per il partner 20123456):

{
  "conversion_partner_id": 20123456,
  "rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==",
  "merchant_changed": 2
}

Il valore merchant_changed viene utilizzato per determinare se il commerciante è stato modificato dal commerciante di reindirizzamento iniziale. Esistono due valori che possono essere trasmessi

Valore della modifica del commerciante	Requisito
1	Questo valore deve essere utilizzato quando un utente ha abbandonato sito web del commerciante originale e completato un acquisto sulla tua piattaforma con un altro commerciante
2	Questo valore deve essere utilizzato quando il cliente completato una transazione tramite l'entità originale (Commerciante).

Sia nell'ambiente sandbox che in quello di produzione devi fornire rwg_token valido durante l'invio di un evento di conversione. A scopo di test, utilizza la classe il seguente token di test in entrambi gli ambienti fino all'avvio:

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Per eseguire il test in Sandbox, devi aggiungere manualmente il seguente parametro URL a i link alla sandbox:

rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D

Attenzione: in produzione non è consentito inviare eventi di conversione che non attribuiti a questa integrazione. Assicurati di controllare se è presente una scadenza valida e non scaduta. rwg_token prima di inviare l'evento.

Un esempio completo del monitoraggio delle conversioni a livello di dispositivo (uso di un cookie nella risposta device) nel codice JavaScript di come effettuare questa richiesta di pubblicazione è incluso di seguito:

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
    })
  });
}

Attenzione: l'unico Content-Type MIME accettato è text/plain. Non impostare nessuna Content-Type nell'intestazione. In questo caso, riceverai un errore CORS.

Quando utilizzi il monitoraggio delle conversioni a livello di utente, devi recuperare il token che associato all'utente (indipendentemente dalla piattaforma su cui si trova) meccanismo di archiviazione lato server e inviare il token utilizzando degli endpoint sandbox.

Nota: gli eventi di conversione possono essere inviati da un client web, di app oppure o server web. Puoi prendere questa decisione in base alle tue esigenze e in base in cui è archiviato il token, purché un evento di conversione venga inviato esattamente una volta per conversione e include un valore rwg_token valido.

Requisiti per l'attribuzione delle conversioni

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

Nota: questo framework di attribuzione potrebbe essere diverso dal modo in cui utilizzi il tuo sistema di analisi che attribuisca le conversioni. Questo sistema è progettato per funzionare indipendentemente il monitoraggio delle conversioni che stai effettuando nei tuoi sistemi e non dovrebbe influire per l'analisi interna.

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

• Un utente segue un link di azione diretta ed effettua un ordine per lo stesso commerciante nella stessa sessione. (Valore di modifica del commerciante = 2)
• Un utente segue un link di azione diretta e poi torna da un altro canale entro il periodo di 30 giorni previsto per effettuare un ordine per lo stesso commerciante. (Commerciante Modifica valore = 2 )
• Un utente segue un link di azione diretta e poi effettua un ordine presso un altro all'interno della stessa sessione o in un'altra sessione nell'arco di 30 giorni finestra. ( Valore modifica commerciante = 1)

Inoltre, Google si aspetta che gli eventi di conversione vengano inviati da tutte le piattaforme l'utente può arrivare da un link di azione locale. Che include:

• 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 relativo mantenimento), è è previsto che tu fornisca l'attribuzione cross-device. Vale a dire che un utente che segue un link di azione dal desktop e poi completa la transazione da dispositivo mobile (utilizzando lo stesso account utente) dovrebbe attivare un evento di conversione.

Se il token viene archiviato esclusivamente a livello di dispositivo, ad esempio nel browser non è previsto che tu fornisca l'attribuzione cross-device. In questo caso, ciascun dispositivo avrebbe un token separato se l'utente avesse seguito un link all'azione su tale dispositivo e ogni dispositivo seguirà l'attribuzione separatamente le regole.