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ò influire sul ranking di 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 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.

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

Analizza e memorizza 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 di rwg_token è una stringa codificata che contiene metadati sul link e le informazioni sul commerciante che hanno generato 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 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 utilizzi specifici per caratteri speciali come =. In ogni caso, assicurati che la versione decodificata venga inviata nella RPC di conversione e che includa eventuali caratteri speciali come =.

Memorizzare il token

Quando memorizzi il 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 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 (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 nell'ambito dell'evento di conversione.

Memorizza a livello di dispositivo

Il livello dispositivo include 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 l'archivio locale o i cookie.
• Utilizza un browser privato o in incognito.

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

Memorizza a livello di utente

Il livello utente mantiene il token nel database dell'applicazione tramite un sistema di analisi lato server o altri sistemi lato server. Il token viene memorizzato sul 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 utente in base all'architettura del sistema, puoi implementare l'evento di conversione una sola volta sul lato server e riutilizzarlo su tutti i dispositivi supportati.

Nota: puoi decidere dove archiviare il rwg_token in base ai tuoi requisiti.

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 dell'archiviazione dei token viene reimpostata e tutte le nuove conversioni per questo commerciante vengono attribuite all'ultimo token.

Per saperne di più, consulta i requisiti per l'attribuzione delle conversioni.

Analizzare e archiviare le informazioni sul 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 metadati del commerciante o merchant_id ai link delle 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. Analogamente all'archiviazione dei token, devi salvare i dettagli del commerciante con il token per 30 giorni dopo il referral iniziale.

L'esempio seguente modifica 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 abbinate 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=/";
}

Restituisci 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 Restituisci il valore della modifica del commerciante.

Il corpo della richiesta POST deve essere un oggetto codificato in formato 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`;

// 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 Content-Type nell'intestazione, altrimenti si verifica un errore CORS.

Avviso: verifica che i dati di identificazione personale (PII) dell'utente non vengano inviati a Google nell'ambito dei dati di conversione.

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

Restituisci il valore della modifica del commerciante

Il valore merchant_changed viene utilizzato per determinare se il commerciante è cambiato rispetto al commerciante di reindirizzamento iniziale. Il cambio di commercianti è 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 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 Analizza e memorizza 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 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 tua pagina di prenotazione non si trova all'interno di una piattaforma o gli utenti non riescono a passare a un altro commerciante, puoi codificare il valore di queste richieste in 2. Questo è comune per i partner che integrano le loro pagine di prenotazione nel sito web del commerciante o che hanno pagine di destinazione personalizzate per elaborare una prenotazione.

Testare e verificare il monitoraggio delle conversioni

I seguenti scenari di test utilizzano token di test forniti nella sezione Token di test e hanno lo scopo di guidarti attraverso tutti 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 opportuno.

Utilizza gli URL dei link di azione o 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 attuale e avrai a disposizione una base pulita su cui lavorare.

Scenario di test	Test Description	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. Questa operazione 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 iniziata 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 token A e il valore 2 di merchant changed 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 venga completata una prenotazione. 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 il token B deve essere archiviato 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 rwg_token.	Un utente torna alla pagina di prenotazione dopo il test n. 4. Il token B deve essere memorizzato per 30 giorni e qualsiasi conversione durante questi 30 giorni deve restituire un evento di conversione.	Verrà inviato un evento di conversione con Token B e valore 2 per merchant changed perché l'utente torna alla pagina di prenotazione dopo il precedente referral 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 precedente referral di Google, la finestra di archiviazione di 30 giorni viene reimpostata e un nuovo token Token C sostituisce il vecchio token Token B. Tutte le conversioni future verranno attribuite al token C.	Verrà inviato un evento di conversione con il token C e il valore 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 il test seguente.

Importante: come indicato nella sezione Restituisci il valore di modifica del commerciante, puoi codificare il valore di queste richieste su 2 se le tue pagine di prenotazione o i link delle azioni non consentono a un utente di cambiare commerciante. Questo è comune per i partner che integrano le loro pagine di prenotazione nel sito web del commerciante o che hanno pagine di destinazione personalizzate per elaborare una prenotazione. Se sei uno di questi partner, puoi saltare i seguenti scenari di test.

Scenario di test	Test Description	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 il token A, ma prima di completare una prenotazione passa a una pagina diversa e completa la prenotazione con un commerciante diverso dal referral originale.	Verrà inviato un evento di conversione perché l'utente ha completato una prenotazione originata da un referral di Google con Token A e valore merchant changed pari a 1 perché l'utente ha completato la prenotazione presso 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 Azione o della pagina di prenotazione che fornisci nei 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 riusciti, 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 Azione locale, 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 di azione locale ed effettua un ordine per lo stesso commerciante nella stessa sessione. Valore della modifica del commerciante = 2.
• Un utente segue un link di azione locale e poi torna da un altro canale entro la 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 di azione locale e poi effettua un ordine in un altro negozio, nella stessa sessione o in una sessione diversa entro una finestra di attribuzione di 30 giorni. Valore della variazione del commerciante = 1.

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

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

Se il token è memorizzato a livello di utente, è previsto che tu fornisca l'attribuzione cross-device. Per saperne di più, 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 dispositivo mobile con lo stesso account utente deve attivare un evento di conversione.

Se il token è 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 persistente separato se l'utente segue un link di azione sul dispositivo e ogni dispositivo può seguire le regole di attribuzione separatamente.

Nota: questo framework di attribuzione può essere diverso da quello del tuo sistema di analisi per l'attribuzione delle conversioni. Questo sistema è progettato per funzionare indipendentemente da qualsiasi monitoraggio delle conversioni che esegui nei tuoi sistemi e non deve influire sulle tue analisi interne.