Monitoraggio delle conversioni

Figura 1. Panoramica del monitoraggio delle conversioni

Panoramica

Il monitoraggio delle conversioni tiene traccia delle conversioni avviate da Google tramite una delle nostre integrazioni di Action Center. È necessario mantenere l'integrazione attiva e in buono stato, in quanto può influire sul ranking in determinate pagine. Ogni volta che Google genera un action_link, l'URL specifico viene modificato in modo da includere un parametro di query univoco: rwg_token. Puoi memorizzare il token e restituire i valori appropriati quando un utente completa una prenotazione.

Per completare l'integrazione, segui questi passaggi:

1. Analizza e memorizza il rwg_token.
2. Analizza e memorizza le informazioni del commerciante.
3. Restituisce i valori rwg_token e merchant_changed.
4. Testa e verifica il monitoraggio delle conversioni.

Analizza e memorizza il rwg_token

Per completare l'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 i metadati del link e le informazioni del commerciante che hanno generato il action_link.

Importante: nessun dato utente viene archiviato o criptato nel token.

Analizza il token

Quando un utente viene indirizzato alla tua pagina di prenotazione, un nuovo rwg_token viene aggiunto all'URL fornito. Nella pagina di prenotazione, devi analizzare il valore del token.

L'esempio seguente mostra come viene analizzato rwg_token per il monitoraggio a livello di dispositivo tramite un 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 token aggiunto all'URL è criptato. Consulta il seguente esempio di rwg_token. Utilizza questo token di esempio per assicurarti di analizzarlo correttamente, insieme a eventuali caratteri speciali come =.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Memorizza il token

Quando memorizzi il parametro rwg_token, puoi implementare il monitoraggio delle conversioni a due livelli diversi:

• A livello di dispositivo
• A livello di utente

Puoi memorizzare il token a qualsiasi livello, ma devi conservarlo per 30 giorni dopo il referral iniziale.

L'esempio seguente mostra il monitoraggio delle conversioni a livello di dispositivo. Puoi memorizzare i valori dei token in un browser con il cookie proprietario. Questo esempio presuppone che tu abbia analizzato il valore del token in una variabile. 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=/";
}

Ogni volta che Google genera un action_link che hai fornito tramite i feed, l'URL viene modificato in modo da includere un parametro di query univoco: rwg_token. Devi memorizzare questo token e restituirlo nell'ambito dell'evento di conversione.

Memorizza a livello di dispositivo

A livello di dispositivo è incluso l'utilizzo di 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. Il token viene archiviato localmente sul dispositivo dell'utente. Pertanto, l'evento di conversione non può essere attribuito correttamente se l'utente:

• Cambia il dispositivo che utilizza.
• Svuota lo spazio di archiviazione locale o i cookie.
• Utilizza un browser in incognito o privato.

Quando utilizzi il monitoraggio delle conversioni a livello di dispositivo, devi implementare nuovamente l'evento di conversione su tutti i dispositivi supportati, inclusi i dispositivi mobili.

Memorizza a livello di utente

A livello di utente, il token viene mantenuto nel database dell'applicazione tramite un sistema di analisi lato server o altri sistemi lato server. Il token viene archiviato lato server. Di conseguenza, l'evento di conversione viene attribuito correttamente dopo che l'utente ha eseguito nuovamente l'accesso.

Quando utilizzi il monitoraggio delle conversioni a livello di utente in base all'architettura del sistema, puoi implementare l'evento di conversione una volta lato server e riutilizzarlo su tutti i dispositivi supportati.

Nota: puoi decidere dove memorizzare il file rwg_token in base alle tue esigenze.

Aggiorna il token

Quando Google indirizza un utente allo stesso commerciante, il token esistente già memorizzato viene sostituito con il nuovo token dell'ultimo referral. Dopo la sostituzione del token, la finestra di attribuzione di 30 giorni dell'archiviazione dei token viene reimpostata e tutte le nuove conversioni per questo commerciante vengono attribuite all'ultimo token.

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

Analizza e memorizza le informazioni del commerciante

Quando un utente viene indirizzato alla tua pagina di prenotazione, devi implementare la logica che può trovare e acquisire i dettagli del commerciante. In genere, i partner aggiungono i metadati del commerciante o merchant_id ai propri link di azioni e li utilizzano per identificare e memorizzare le informazioni del commerciante.

Ti consigliamo di memorizzare merchant_id o l'identificatore selezionato insieme a rwg_token. Quando un utente conferma una prenotazione, puoi fare riferimento al commerciante prima di inviare la richiesta di conversione completa. Come per lo stoccaggio dei token, devi salvare i dettagli del commerciante con il token per 30 giorni dopo il referral iniziale.

L'esempio seguente modifica il valore rwg_token memorizzato in precedenza. Si presume che tu abbia analizzato le informazioni del commerciante dai metadati nell'URL fornito e le abbia salvate come merchant_id o le abbia associate 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_changed

Quando un utente completa una prenotazione che inizia da un referral action_link, devi inviare una richiesta POST HTTP all'endpoint di conversione. Esistono due endpoint:

• Ambiente di produzione: https://www.google.com/maps/conversion/collect
• Ambiente 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_changed pari a 1 o 2. Per ulteriori dettagli su merchant_changed, consulta la sezione Restituire il valore della modifica del commerciante.

Il corpo del messaggio POST deve essere un oggetto codificato in JSON 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"
}

Il seguente esempio include il monitoraggio delle conversioni a livello di dispositivo con un cookie sul dispositivo dell'utente, 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
    })
  });
}

Attenzione: l'unico MIME Content-Type accettato è text/plain. Non impostare altri Content-Type nell'intestazione, in quanto si verifica un errore CORS.

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

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

Restituire il valore della modifica del commerciante

Il valore merchant_changed viene utilizzato per determinare se il commerciante è diverso da quello del reindirizzamento iniziale. Il cambio di commerciante è comune se la tua pagina di destinazione si trova all'interno di una piattaforma che include altri commercianti. In questo caso, se un utente viene indirizzato alla tua piattaforma da Google e decide di visitare un commerciante diverso per completare una prenotazione, devi sapere che si è verificata una conversione con un commerciante diverso. Puoi utilizzare un valore booleano per identificare la variazione del commerciante, ma non i dettagli del commerciante.

Quando decidi quale valore assegnare a merchant_changed, devi prendere il commerciante originale salvato in Eseguire l'analisi e memorizzare le informazioni sul commerciante. Controlla se il commerciante è cambiato e assegna il valore in base alle tue esigenze.

• Requisito: quando un utente esce dal sito web del commerciante originale e completa un acquisto tramite la tua piattaforma con un commerciante diverso.
  • Valore della modifica del commerciante: 1
• Requisito: quando l'utente completa una transazione tramite il commerciante originale.
  • Valore della modifica del commerciante: 2

Nota: se la tua pagina di prenotazione non si trova all'interno di una piattaforma o gli utenti non riescono a visitare un altro commerciante, puoi impostare in modo hardcoded 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 elaborare le prenotazioni.

Testare e verificare il monitoraggio delle conversioni

I seguenti casi di test utilizzano i token di test forniti nella sezione Token di test e hanno lo scopo di aiutarti a comprendere tutti i vari scenari che possono generare un evento di conversione. In questo modo, il token viene archiviato in modo appropriato, il valore merchant_changed viene impostato correttamente e l'evento di conversione viene inviato quando opportuno.

Utilizza i link all'azione o gli URL delle pagine di prenotazione forniti nei feed ed esegui ogni caso di test aggiungendo i token di test alla fine dell'URL. Assicurati di utilizzare una finestra del browser privata o di navigazione in incognito, in modo da cancellare tutti i token esistenti associati all'utente corrente e avere un ambiente di lavoro pulito.

Caso di test	Descrizione test	Flusso utente	Risultato previsto
1	Un utente completa una prenotazione che non ha avuto origine su Google.	Un utente accede direttamente alla pagina di prenotazione senza essere indirizzato da Google o senza un referral esistente. Ciò non dovrebbe comportare alcun evento di conversione.	Nessun evento di conversione perché l'utente non ha visitato in precedenza la pagina di prenotazione o non è stato indirizzato da Google.
2	Un utente completa una prenotazione effettuata su Google.	Un utente trova il tuo commerciante tramite Google, viene indirizzato alla tua pagina di prenotazione e completa una prenotazione.	Verrà inviato un evento di conversione con il valore Token A e Merchant changed pari a 2 perché l'utente è stato indirizzato alla pagina di prenotazione da Google.
3	Un utente (proveniente da Google) avvia il flusso di prenotazione, ma abbandona la sessione prima del completamento della prenotazione. Nota: tieni aperta questa sessione per i test 4 e 5.	Un utente viene indirizzato alla tua pagina di prenotazione, ma la sessione termina e non completa una prenotazione.	Nessuna conversione perché l'utente non ha completato la prenotazione, ma il token B deve essere archiviato per 30 giorni.
4	Un utente torna alla pagina di prenotazione, senza aver effettuato l'accesso da Google, e completa una prenotazione. Nota: l'URL del flusso di prenotazione non deve includere un token rwg.	Un utente torna alla pagina di prenotazione dopo il test 4. Il token B deve essere archiviato per 30 giorni e qualsiasi conversione durante questi 30 giorni deve restituire un evento di conversione.	Verrà inviato un evento di conversione con il valore Token B e Merchant changed pari a 2 perché l'utente torna alla pagina di prenotazione dopo un referral precedente da Google.
5	Un utente completa una nuova prenotazione proveniente da Google dopo il test 4.	Se un utente torna alla tua pagina di prenotazione utilizzando un referral di Google dopo un referral di Google precedente, la finestra di archiviazione di 30 giorni viene reimpostata e un nuovo token Token C sostituisce quello precedente Token B. Tutte le conversioni future verranno attribuite al token C.	Verrà inviato un evento di conversione con il valore Token C e Merchant changed pari a 2 perché l'utente ha completato la prenotazione e il nuovo token ha sostituito quello memorizzato in precedenza.

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

Importante: come indicato nella sezione Restituire il valore della modifica del commerciante, puoi impostare il valore di queste richieste su 2 se le tue pagine di prenotazione o i tuoi link di azioni non consentono a un utente di cambiare commerciante. 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 elaborare le prenotazioni. Se sei uno di questi partner, puoi saltare i seguenti casi di test.

Caso di test	Descrizione test	Flusso utente	Risultato previsto
6	Un utente viene indirizzato alla tua pagina di prenotazione da Google e completa una prenotazione con un altro commerciante.	Un utente viene indirizzato alla tua pagina di prenotazione da Google e viene utilizzato il token A, ma prima di completare una prenotazione passa a una pagina diversa e completa la prenotazione con un commerciante diverso da quello del referral originale.	Verrà inviato un evento di conversione perché l'utente ha completato una prenotazione che ha avuto origine da un referral di Google con Token A e il valore merchant changed pari a 1 perché l'utente ha completato la prenotazione in un commerciante diverso da quello del referral.

Durante il test, invia la richiesta POST HTTP all'endpoint di conversione. Esistono due endpoint:

• Ambiente di produzione: https://www.google.com/maps/conversion/collect
• Ambiente sandbox: https://www.google.com/maps/conversion/debug/collect

Token di test

Per testare il monitoraggio delle conversioni, aggiungi uno dei seguenti token di test alla fine degli URL dei link di azioni o delle pagine di prenotazione che fornisci nei tuoi feed.

Token A:

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

Token B:

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

Token C:

rwg_token=AJKvS9VwInjZ_hGZPvBz0COVWJ5oFDzocFt9hGi7TMurlo2l71uiXP48PspPUMmRnqCUDE1mF_A5H_dMV78cBTF8jIfSQK6lEA%3D%3D

Quando invii gli eventi di conversione andati a buon fine, puoi visualizzarli aggregati nel Centro azioni nella dashboard di monitoraggio delle conversioni.

Nota: potrebbero essere necessarie fino a un'ora prima che le conversioni vengano visualizzate nella dashboard.

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 all'azione di luogo in qualsiasi negozio.

Questa finestra di attribuzione indica che Google può aspettarsi 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 della modifica del commerciante = 2.
• Un utente segue un link all'azione di destinazione e poi ritorna da un altro canale in una finestra di attribuzione di 30 giorni per effettuare un ordine per lo stesso commerciante. Valore della modifica del commerciante = 2.
• Un utente segue un link all'azione di un luogo e poi effettua un ordine in un altro negozio, nella stessa sessione o in un'altra sessione, entro una finestra di attribuzione di 30 giorni. Valore della variazione del commerciante = 1.

Inoltre, Google si aspetta di inviare eventi di conversione da qualsiasi dispositivo a cui un utente può accedere tramite un link all'azione di luogo. Questi dispositivi includono:

• Applicazioni web per computer o dispositivi mobili.
• App mobile tramite un link diretto all'app o un'intenzione di app registrata per il tuo dominio.

Se il token è archiviato a livello di utente, è necessario fornire l'attribuzione cross-device. Per ulteriori informazioni, consulta Archiviare a livello di utente. In questo caso, un utente che segue un link di azione da un computer e poi completa la transazione da dispositivo mobile con lo stesso account utente deve attivare un evento di conversione.

Se il token viene archiviato 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 può avere un token distinto persistente, se l'utente segue un link di azione su quel dispositivo, e ogni dispositivo può seguire le regole di attribuzione separatamente.

Nota: questo framework di attribuzione può essere diverso da come il sistema di analisi attribuisce le conversioni. Questo sistema è progettato per funzionare indipendentemente dal monitoraggio delle conversioni che esegui nei tuoi sistemi e non deve influire sui tuoi dati di analisi interna.