Implementazione
Riepilogo
L'implementazione del monitoraggio delle conversioni si compone di tre elementi:
- Raccolta di
rwg_token
emerchant_id
dalla pagina di destinazione o dall'app il punto di accesso. - Mantenere
rwg_token
emerchant_id
per l'attribuzione appropriata finestra. - Confronta i
merchant_id
persistenti e imerchant_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.
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.
rwg_token
e merchant_id
persistenti
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
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
})
});
}
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.
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.
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.