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. Aiuta a mantenere l'integrazione in buono stato e in esecuzione, in quanto può influenzare il ranking su 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:

1. Analizza e memorizza il valore di rwg_token.
2. Analizza e memorizza le informazioni sul commerciante.
3. Restituisci i valori di rwg_token e merchant_changed.
4. Verifica il monitoraggio delle conversioni.

Nota: la procedura di integrazione standard richiede ai partner di implementare il monitoraggio delle conversioni per la misurazione del rendimento, con passaggi tecnici descritti nella sezione riportata di seguito. Tieni presente che l'implementazione del monitoraggio delle conversioni è facoltativa per i partner del settore sanitario in base alle esigenze aziendali

Analizzare e memorizzare il valore di rwg_token

Per completare l'integrazione, devi raccogliere e memorizzare il valore di rwg_token per un massimo di 30 giorni dal referral iniziale di Google. Il valore di rwg_token è una stringa codificata che contiene metadati sul link e sulle informazioni del commerciante che ha generato l'action_link.

Importante: non vengono memorizzate o criptate informazioni che consentono l'identificazione personale.

Analizzare il token

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

L'esempio seguente mostra come viene analizzato il valore di rwg_token per il monitoraggio a livello di dispositivo tramite un browser.

const rwgToken = new URLSearchParams(location.search).get('rwg_token') || undefined;

Importante: Google consiglia di memorizzare il token come valore decodificato nel cookie, in quanto i cookie del browser hanno usi specifici per i caratteri speciali come =. In ogni caso, assicurati che la versione decodificata venga inviata nell'RPC di conversione e che includa eventuali caratteri speciali come =.

Memorizzare il token

Quando memorizzi il valore di 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 memorizzarlo 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 originale. Questo esempio presuppone che tu abbia analizzato il valore del token in una variabile. Assicurati di aggiornare rootdomain.com con il tuo dominio.

if (rwgToken !== undefined) {
  document.cookie =
  "_rwgToken=" + rwgToken + "; 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 come parte dell'evento di conversione.

Memorizzare a livello di dispositivo

Il livello di dispositivo include l'utilizzo di cookie del browser, spazio di archiviazione locale, spazio di archiviazione locale dell'app o qualsiasi altro metodo in grado di conservare il token per la finestra di attribuzione di 30 giorni. Il token viene memorizzato 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 elimina i cookie.
• Utilizza un browser privato o in incognito.

Quando utilizzi il monitoraggio delle conversioni a livello di dispositivo, devi reimplementare l'evento di conversione su ogni dispositivo supportato, inclusi i dispositivi mobili.

Memorizzare a livello di utente

Il livello di utente conserva il token nel database dell'applicazione, tramite un sistema di analisi lato server o altri sistemi lato server. Il token viene memorizzato lato server. Pertanto, l'evento di conversione viene comunque attribuito correttamente dopo che l'utente ha eseguito di nuovo 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 sola volta lato server e riutilizzarlo su tutti i dispositivi supportati.

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

Aggiornare 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 della memorizzazione del token viene reimpostata e tutte le nuove conversioni per questo commerciante vengono attribuite all'ultimo token.

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

Analizzare e memorizzare le informazioni sul commerciante

Quando un utente viene indirizzato alla tua pagina di prenotazione, devi implementare la logica in grado di trovare e acquisire i dettagli del commerciante. In genere, i partner aggiungono metadati del commerciante o merchant_id ai link di azione 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. Analogamente alla memorizzazione dei token, devi salvare i dettagli del commerciante con il token per 30 giorni dopo il referral iniziale.

L'esempio seguente modifica il valore di rwg_token memorizzato in precedenza. Presuppone 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.

// Store the rwgToken and merchantId in your cookie and set the cookie
// expiration date to 30 days.
if (typeof rwgToken !== 'undefined') {
  document.cookie =
  "_rwgToken=" + rwgToken + "; _merchantId=" + merchantId + "; max-age=2592000;domain=rootdomain.com; path=/";
}

Restituire i valori di 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 di rwg_token memorizzato e un valore di merchant_changed pari a 1 o 2. Per ulteriori dettagli su merchant_changed, consulta Restituire il valore di modifica del commerciante.

Il corpo della richiesta POST deve essere un oggetto codificato in formato JSON:

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

{
  "conversion_partner_id": "XXXXXXX",
  "rwg_token": "AFd1xnHrJWKcjtriCyB5j3QL0bzbmLdcg1N1f5cJuSNVhteYjuOJz18Au6GIAT0tjHkw6fkUJKcarafV45b3c_gl7uT_o8HMcg==",
  "merchant_changed": "2"
}

L'esempio seguente 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`;

// Retrieve the value of the rwgToken stored in the browser's cookie
const match = document.cookie.match(new RegExp('(?:^| )_rwgToken=([^;]+)'));
const storedRwgToken = match ? match[1] : undefined;

// Send Conversion event with decoded token, verify any special characters
// are sent properly.
if (storedRwgToken !== undefined) {
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: decodeURIComponent(storedRwgToken),
      merchant_changed: merchantChanged
    })
  });
}

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

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

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

Restituire il valore di modifica del commerciante

Il valore di merchant_changed viene utilizzato per determinare se il commerciante è stato modificato rispetto al commerciante di reindirizzamento iniziale. La modifica dei commercianti è comune se la 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 passare a un altro commerciante per completare una prenotazione, devi sapere che si è verificata una conversione con un commerciante separato. Puoi utilizzare un valore booleano per identificare la modifica del commerciante, ma non i dettagli del commerciante.

Quando decidi quale valore assegnare a merchant_changed, devi prendere in considerazione il commerciante originale salvato in Analizzare e memorizzare le informazioni sul commerciante. Verifica se il commerciante è stato modificato 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 altro commerciante.
  • Valore di modifica del commerciante: 1
• Requisito: quando l'utente completa una transazione tramite il commerciante originale.
  • Valore di modifica del commerciante: 2

Nota: se la pagina di prenotazione non si trova all'interno di una piattaforma o gli utenti non possono passare a un altro commerciante, puoi codificare il valore di queste richieste su 2. Questa procedura è comune per i partner che integrano le pagine di prenotazione nel sito web del commerciante o che hanno pagine di destinazione personalizzate per elaborare una prenotazione.

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 i vari scenari che possono generare un evento di conversione. In questo modo, il token viene memorizzato correttamente, il valore di merchant_changed viene impostato correttamente e l'evento di conversione viene inviato quando appropriato.

Utilizza i link all'azione o gli URL della pagina di prenotazione forniti nei feed ed esegui ogni scenario di test aggiungendo i token di test alla fine dell'URL. Assicurati di utilizzare una finestra del browser privata o in incognito. In questo modo, verranno cancellati tutti i token esistenti associati all'utente corrente e avrai a disposizione una pagina vuota su cui lavorare.

Caso di test	Descrizione del test	User flow	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. Non dovrebbe generare 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 che ha avuto origine su Google.	Un utente trova il tuo commerciante tramite Google, viene indirizzato alla tua pagina di prenotazione e completa una prenotazione.	Viene inviato un evento di conversione con Token A e valore merchant_changed pari a 2 perché l'utente è stato indirizzato alla pagina di prenotazione da Google.
3	Un utente (proveniente da Google) inizia il flusso di prenotazione, ma abbandona la sessione prima che la prenotazione venga completata. Nota: mantieni 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 una prenotazione, ma Token B deve essere memorizzato per 30 giorni.
4	Un utente torna alla pagina di prenotazione, senza provenire da Google, e completa una prenotazione. Nota: l'URL del flusso di prenotazione non deve includere un valore di rwg_token.	Un utente torna alla pagina di prenotazione dopo il test n. 4. Token B deve essere memorizzato per 30 giorni e qualsiasi conversione durante questi 30 giorni deve restituire un evento di conversione.	Viene inviato un evento di conversione con Token B e valore 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 n. 4.	Se un utente torna alla tua pagina di prenotazione utilizzando un referral di Google dopo un referral precedente di Google, la finestra di memorizzazione di 30 giorni viene reimpostata e un nuovo token Token C sostituisce il vecchio Token B. Tutte le conversioni future verranno attribuite a Token C.	Viene inviato un evento di conversione con Token C e valore merchant_changed pari a 2 perché l'utente ha completato la prenotazione e il nuovo token ha sostituito il token memorizzato in precedenza.

Se hai una piattaforma che consente agli utenti di completare il pagamento con un altro commerciante, esegui il seguente test.

Importante: come indicato nella sezione Restituire il valore di modifica del commerciante, puoi codificare il valore di queste richieste su 2 se le pagine di prenotazione o i link di azione non consentono a un utente di cambiare commerciante. Questa procedura è comune per i partner che integrano le pagine di prenotazione nel sito web del commerciante o che hanno pagine di destinazione personalizzate per elaborare una prenotazione. Se rientri in questa categoria di partner, puoi saltare i seguenti casi di test.

Caso di test	Descrizione del test	User flow	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, viene utilizzato Token A, ma prima di completare una prenotazione passa a un'altra pagina e completa la prenotazione con un commerciante diverso dal referral originale.	Viene inviato un evento di conversione perché l'utente ha completato una prenotazione proveniente da un referral di Google con Token A e valore merchant changed pari a 1 perché l'utente ha completato la prenotazione con un commerciante diverso dal 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 dei link di azione o degli URL della pagina di prenotazione forniti nei feed.

Token A:

rwg_token=AFd1xnHrJWKcjtriCyB5j3QL0bzbmLdcg1N1f5cJuSNVhteYjuOJz18Au6GIAT0tjHkw6fkUJKcarafV45b3c_gl7uT_o8HMcg%3D%3D

Token B:

rwg_token=AE37R_gte8WCEaytMalsIr9agWQRLuN8199RsVhU2WoRKRvcZ0eBTD8cFvnfUZh-GY0IvY-zjS3W9KWAmy3WDiWXbVvQRZyzMQ%3D%3D

Token C:

rwg_token=AE37R_jmAP-UgWNApkxwdlX5M2z1UBGuUzHZ63YWmRWeTjRJKxfSD1mzJ4joLnB11MHrBULuisjP-9I64LnBJDXyCc_CIJSCPg%3D%3D

Quando invii gli eventi di conversione riusciti, puoi visualizzarli aggregati in Action Center nella dashboard di monitoraggio delle conversioni.

Nota: le conversioni possono richiedere fino a un'ora per essere 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 di azione per luogo, in qualsiasi negozio.

Questa finestra di attribuzione indica che Google può prevedere l'invio di un evento di conversione in uno dei seguenti scenari:

• Un utente segue un link all'azione diretta e piazza un ordine per lo stesso commerciante nella stessa sessione. Valore di modifica del commerciante = 2.
• Un utente segue un link all'azione diretta e poi torna da un altro canale entro la finestra di attribuzione di 30 giorni per effettuare un ordine per lo stesso commerciante. Valore di modifica del commerciante = 2.
• Un utente segue un link di azione per luogo ed effettua un ordine in un altro negozio, nella stessa sessione o in una sessione diversa entro una finestra di attribuzione di 30 giorni. Valore di modifica del commerciante = 1.

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

• Applicazioni web per computer o dispositivi mobili.
• App mobile, tramite un link diretto all'app o un intent dell'app registrato per il tuo dominio.

Se il token viene memorizzato a livello di utente, è previsto che tu fornisca l'attribuzione cross-device. Per ulteriori informazioni, consulta Memorizzare a livello di utente. In questo caso, un utente che segue un link di azione dal computer e poi completa la transazione su un dispositivo mobile con 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 può avere un token separato persistente, se l'utente segue un link all'azione su quel dispositivo, e ogni dispositivo può seguire le regole di attribuzione separatamente.

Nota: questo framework di attribuzione può essere diverso dalle conversioni degli attributi del sistema di analisi. Questo sistema è progettato per funzionare indipendentemente da qualsiasi monitoraggio delle conversioni eseguito nei tuoi sistemi e non deve influire sulle analisi interne.