Monitoraggio delle conversioni

Riepilogo

Il monitoraggio delle conversioni ha lo scopo di tenere traccia delle conversioni avviate da Google tramite una delle nostre integrazioni di Action Center. Questo è fondamentale per mantenere l'integrità e l'esecuzione dell'integrazione e può influire sul ranking in determinate pagine. Ogni volta che Google mostra un action_link, l'URL viene modificato in modo da includere un parametro di query univoco: rwg_token. Spetta a te archiviare il token e restituire i valori appropriati quando un utente completa una prenotazione.

Per completare l'integrazione, devi completare i seguenti passaggi:

1. Raccogli e conserva i rwg_token.
2. Raccogli e salva il commerciante.
3. Restituisce i valori rwg_token e merchant_change.
4. Testa e verifica il monitoraggio delle conversioni.

Raccogli e conserva i rwg_token.

Per completare questa integrazione, devi raccogliere e archiviare il rwg_token per un massimo di 30 giorni dal referral iniziale di Google. Il valore rwg_token è una stringa codificata che contiene alcuni metadati relativi al link e al commerciante che lo ha generato. È importante notare che nessun dato utente viene archiviato o criptato nel token.

Raccolta di token

Quando un utente viene indirizzato alla tua pagina di prenotazione, all'URL fornito verrà aggiunto un nuovo parametro di query,rwg_token. Nella pagina di prenotazione, devi analizzare il valore. È incluso un esempio di come questo token può essere analizzato per il monitoraggio a livello di dispositivo tramite il browser.

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

Il parametro di query aggiunto all'URL sarà un token criptato. Consulta il seguente esempio di rwg_token. Utilizza questo token di esempio per assicurarti di eseguire l'analisi sintattica correttamente, inclusi eventuali caratteri speciali come "=". Di seguito è riportato un esempio di token tipico.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Spazio di archiviazione dei token

Quando memorizzi il rwg_token, puoi implementare il monitoraggio delle conversioni a due livelli diversi: a livello di dispositivo e di utente. Puoi decidere dove memorizzare il token, ma devi conservarlo per 30 giorni dal referral iniziale.

L'esempio successivo è il monitoraggio delle conversioni a livello di dispositivo, che memorizza questi valori 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 di archiviazione dei token. Assicurati di aggiornare rootdomain.com con il tuo dominio.

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

Tieni presente quanto segue quando decidi dove archiviare il rwg_token.

Spazio di archiviazione a livello di dispositivo

A livello di dispositivo è possibile utilizzare cookie del browser, spazio di archiviazione locale, spazio di 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 archiviato localmente sul dispositivo dell'utente, se l'utente cambia il dispositivo in uso, cancella lo spazio di archiviazione locale o i cookie oppure utilizza la navigazione privata o la modalità di navigazione in incognito, l'evento di conversione potrebbe non essere attribuito correttamente. Quando utilizzi il monitoraggio delle conversioni a livello di dispositivo, devi riimplementarlo su tutte le piattaforme supportate (incluso il mobile).

Spazio di archiviazione a livello di utente

Il livello utente include la persistenza nel database dell'applicazione, tramite un sistema di analisi lato server o altri sistemi lato server. Poiché il token viene memorizzato lato server, se l'utente cambia il dispositivo in uso, cancella lo spazio di archiviazione locale o i cookie oppure utilizza la navigazione privata o la modalità di navigazione in incognito, l'evento di conversione viene comunque attribuito quando l'utente accede nuovamente. Quando utilizzi il monitoraggio delle conversioni a livello di utente, a seconda dell'architettura del sistema, potresti essere in grado di implementarlo una volta lato server e riutilizzarlo su tutte le piattaforme supportate.

Ogni volta che Google mostra un action_link che hai fornito tramite i feed, l'URL viene modificato in modo da includere un parametro di query univoco: rwg_token. Il valore rwg_token è una stringa codificata che contiene alcuni metadati sul link su cui l'utente ha fatto clic, ma nessun dato utente. Devi memorizzare questo token e ripassarlo nell'ambito dell'evento di conversione.

Aggiorna il token

Quando un utente viene inviato da Google allo stesso commerciante, se viene memorizzato un token esistente, questo viene sostituito con il nuovo token dell'ultimo referral. Quando il token viene sostituito, la finestra di 30 giorni per lo spazio di archiviazione dei token viene reimpostata e tutte le nuove conversioni per questo commerciante devono essere attribuite all'ultimo token.

Per ulteriori dettagli, consulta i nostri Requisiti per l'attribuzione delle conversioni.

Raccogli e salva il commerciante.

Quando un utente viene indirizzato alla tua pagina di prenotazione, devi implementare una logica che lo trovi e lo acquisisca. In genere, i partner aggiungono i metadati del commerciante o merchant_id ai propri link di azioni e li utilizzano per identificare e memorizzare il commerciante. Ti consigliamo di memorizzare merchant_id (o l'identificatore selezionato) accanto a rwg_token in modo che, quando un utente conferma una prenotazione, tu possa fare riferimento al commerciante prima di inviare la richiesta di conversione completata. Analogamente alla finestra di archiviazione dei token, il commerciante deve essere salvato con il token per 30 giorni dal referral iniziale.

Gli esempi successivi modificano il rwg_token memorizzato in precedenza. Si presume che tu stia analizzando il commerciante dai metadati nell'URL fornito e che lo stia salvando come merchant_id o associandolo a un merchant_id esistente.

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

Restituisce i valori rwg_token e merchant_change.

Quando un utente completa una prenotazione iniziata da un referral di Action Link, 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

Quando invii un evento di conversione, devi includere il valore rwg_token memorizzato e un valore merchant_change pari a 1 o 2. Per ulteriori dettagli su merchant_change, consulta Restituire il valore della modifica del commerciante.

Il corpo del messaggio POST deve essere un oggetto JSON codificato nel formato:

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

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

L'esempio seguente include il monitoraggio delle conversioni a livello di dispositivo utilizzando un cookie sul dispositivo dell'utente ed è scritto in JavaScript:

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

Restituire il valore della modifica del commerciante

Il valore merchant_changed viene utilizzato per determinare se il commerciante è stato cambiato rispetto al commerciante del reindirizzamento iniziale. È normale cambiare commerciante se la tua pagina di destinazione si trova all'interno di una piattaforma che include altri commercianti. In questo caso, se un utente è stato indirizzato alla tua piattaforma da Google e ha deciso di visitare un commerciante diverso e di effettuare una prenotazione, vogliamo sapere che si è verificata una conversione, ma con un commerciante diverso. Non è necessario conoscere il commerciante, ma solo che si è verificato un evento di conversione e che il commerciante era diverso. Utilizziamo un valore booleano per identificare se un commerciante è cambiato o meno.

Quando decidi quale valore assegnare a merchant_change, devi prendere il commerciante originale salvato in Raccogliere e archiviare il commerciante e controllare se il commerciante è cambiato, quindi fare riferimento alla tabella seguente per assegnare il valore.

Se la tua pagina di prenotazione non si trova all'interno di una piattaforma o gli utenti non riescono a passare a un altro commerciante, puoi impostare il valore di queste richieste su 2. Questo accade spesso ai partner che integrano le proprie pagine di prenotazione nel sito web del loro commerciante o che hanno pagine di destinazione personalizzate per l'elaborazione delle prenotazioni.

Valore variazione commerciante	Requisito
1	Questo valore deve essere utilizzato quando un utente ha abbandonato 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 la persona giuridica originale (commerciante).

Testa e verifica il monitoraggio delle conversioni.

Per assicurarti che l'implementazione del monitoraggio delle conversioni sia corretta, devi eseguire il seguente test. Assicurati di utilizzare i link di azioni collegati ai tuoi commercianti e che le richieste vengano effettuate in una finestra privata o di navigazione in incognito per assicurarti che qualsiasi token precedente associato all'utente venga cancellato.

1. Completare una prenotazione utilizzando solo un link di azioni
   • Le prenotazioni dirette senza referral o token memorizzati in precedenza non dovrebbero comportare l'invio di richieste a Google.
2. Completa una prenotazione utilizzando un link con un rwg_token aggiunto.
   • Verifica che la richiesta sia andata a buon fine e che sia stata inviata con i valori rwg_token e merchant_change di 2
   • Assicurati di archiviare il file rwg_token per 30 giorni
3. Completa una nuova prenotazione con lo stesso commerciante utilizzando un nuovo rwg_token.
   • Assicurati che la richiesta sia andata a buon fine e che sia stata inviata con il nuovo valore rwg_token e merchant_change di 2
   • Assicurati che la finestra di archiviazione dell'attribuzione del token venga aggiornata per 30 giorni
4. Vai direttamente alla pagina di prenotazione del commerciante che stai testando e fai una nuova prenotazione senza un rwg_token aggiunto.
   • Assicurati che la richiesta venga inviata con il valore rwg_token memorizzato in precedenza e che il valore merchant_change sia 2

Se sei una piattaforma che consente agli utenti di effettuare il pagamento utilizzando un commerciante diverso, esegui i seguenti test.

1. Vai alla pagina di prenotazione del commerciante utilizzando un link con un rwg_token aggiunto, poi vai a un altro commerciante ed effettua una prenotazione.
   • Assicurati che la richiesta venga inviata con il valore rwg_token e merchant_change di 1

Durante il test, invia la 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

Dovrai aggiungere il seguente token al link o all'URL dell'azione:

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

Utilizza il seguente token per i test che richiedono token aggiuntivi.

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

Dopo aver inviato gli eventi di conversione andati a buon fine, puoi visualizzarli aggregati nel Centro azioni nella dashboard Monitoraggio delle conversioni. Tieni presente che la visualizzazione delle conversioni nella dashboard può richiedere fino a un'ora.

Requisiti per l'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.

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

• Un utente segue un link di azione sul luogo e effettua un ordine per lo stesso commerciante nella stessa sessione. (Valore variazione commerciante = 2)
• Un utente segue un link relativo a un'azione di prenotazione e poi ritorna da un altro canale entro il periodo di 30 giorni per effettuare un ordine per lo stesso commerciante. (Merchant Change Value = 2 )
• Un utente segue un link relativo a un'azione di ricerca e poi effettua un ordine in un altro negozio, all'interno della stessa sessione o di un'altra sessione, in un periodo di 30 giorni. ( Merchant Change Value = 1 )

Inoltre, Google si aspetta che gli eventi di conversione vengano inviati da tutte le piattaforme su cui un utente può arrivare da un link Azione diretta. Che include:

• Applicazioni web desktop o mobile
• App mobile tramite un link diretto dell'app o un'intenzione di app registrata per il tuo dominio

Se il token è archiviato a livello di utente (vedi la persistenza del token), è necessario fornire l'attribuzione cross-device. In altre parole, un utente che segue un link di azione da un computer e poi completa la transazione da dispositivo mobile (utilizzando lo stesso account utente) deve attivare un evento di conversione.

Se il token viene memorizzato esclusivamente a livello di dispositivo, ad esempio nei cookie del browser, non è previsto che tu fornisca l'attribuzione cross-device. In questo caso, ogni dispositivo avrebbe un token distinto se l'utente avesse seguito un link di azione su quel dispositivo e ogni dispositivo seguirebbe le regole di attribuzione separatamente.