Questa pagina è stata tradotta dall'API Cloud Translation.

Monitoraggio delle conversioni

di Gemini Advanced.

Implementazione

Riepilogo

L'implementazione del monitoraggio delle conversioni si compone di tre elementi:

Raccolta del rwg_token dalla pagina di destinazione o dal punto di ingresso dell'app.
Permanere di rwg_token per la finestra di attribuzione appropriata
Inviare un evento di conversione al momento del pagamento

Questa implementazione del monitoraggio delle conversioni non richiede l'utilizzo Google Analytics o qualsiasi altro codice JavaScript di terze parti.

Prima di iniziare a implementare il monitoraggio delle conversioni, devi decidere Se monitori le conversioni a livello di dispositivo o di utente:

A livello di dispositivo è incluso l'utilizzo di cookie del browser, di cookie locali archiviazione locale, spazio di archiviazione dell'app o qualsiasi altro metodo che può essere mantenuto il token per la finestra di attribuzione di 30 giorni. Poiché il token vengono archiviati localmente sul dispositivo dell'utente, se quest'ultimo cambia dal dispositivo utilizzato, cancellano lo spazio di archiviazione/i cookie locali o utilizza una navigazione privata o la modalità di navigazione in incognito, l'evento di conversione potrebbero non essere attribuiti correttamente. Quando si utilizza il livello di dispositivo il monitoraggio delle conversioni, devi implementarlo nuovamente in ogni piattaforma supportata (inclusi i dispositivi mobili).
Il livello utente include il passaggio nella tua applicazione tramite un sistema di analisi lato server o altro sistemi lato server. Poiché il token verrebbe archiviato lato server, se l'utente cambia il dispositivo che sta utilizzando, cancella loro archiviazione locale/cookie oppure sta usando una navigazione privata modalità di navigazione in incognito, l'evento di conversione verrà attribuito una volta l'utente eseguirà di nuovo l'accesso. Quando utilizzi il monitoraggio delle conversioni a livello di utente, a seconda dell'architettura del sistema, potresti essere in grado implementarla una volta sul lato server e riutilizzarla piattaforme supportate.

Raccolta di `rwg_token` in corso...

Ogni volta che Google mostra un action_link che hai fornito tramite i feed, l'URL verrà modificato per includere una query unica parametro: rwg_token. rwg_token è una stringa codificata che contiene alcuni metadati relativi al sul link selezionato dall'utente. Dovrai memorizzare questo token e ritrasmetterlo come parte dell'evento di conversione.

In ogni pagina di destinazione o punto di ingresso dell'app devi analizzare il set di valori per il parametro di query rwg_token e archivialo. Requisiti per per la memorizzazione di questo parametro, vengono descritti nel passaggio 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 nella lato server quando rispondi alla richiesta:

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

`rwg_token` permanente

Nota: mantenere rwg_token è fondamentale per implementare la finestra di attribuzione richiesta. Per ulteriori dettagli su i requisiti di attribuzione, consulta la sezione Requisiti di attribuzione delle conversioni riportati di seguito.

Ti verrà chiesto di mantenere il parametro URL rwg_token, che verrà aggiunto a tutti i link di azione forniti da te, per un totale di 30 giorni. Il valore dell'attributo rwg_token deve essere archiviati e restituiti senza alcuna modifica. Se esiste già un token mantenuto da una visita precedente, il token precedente dovrebbe essere sostituito, mentre la finestra di 30 giorni per l'archiviazione deve essere reimpostato.

Quando mantieni il token, puoi archiviarlo nel a livello di dispositivo o di utente:

A livello di dispositivo sono inclusi l'uso di cookie del browser, l'archiviazione locale e spazio di archiviazione locale dell'app o qualsiasi altro metodo che possa rendere persistenti il token per la finestra di attribuzione di 30 giorni.
A livello di utente è incluso il salvataggio permanente nel database dell'applicazione, attraverso un sistema di analisi lato server o altri sistemi lato server.

Di seguito è riportato un esempio di monitoraggio delle conversioni a livello di dispositivo memorizzando questo token in un browser web tramite un cookie di terze parti. Questo esempio presuppone che tu abbia analizzato il valore del token in una variabile, come nell'esempio precedente. Per usare questo esempio, devi aggiornare "rootdomain" al tuo dominio.

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

Quando utilizzi il monitoraggio delle conversioni a livello di utente, rwg_token deve archiviati sul server e associati all'utente.

Invio dei dati sulle conversioni

Quando un utente completa una transazione attribuibile a un Google Place Action, devi inviare una richiesta POST HTTP al endpoint di conversione. Ci sono due endpoint, uno per la produzione e uno per l'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>
}

Sia nell'ambiente sandbox che in quello di produzione fornisci un valore rwg_token valido durante l'invio di un evento di conversione. A scopo di test nell'ambiente sandbox, puoi utilizzare quanto segue token di test.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Nota: in un ambiente di produzione non è consentito inviare eventi di conversione che non attribuiti a questa integrazione. Assicurati di verificare la presenza di un indirizzo IP valore rwg_token non scaduto prima di inviare l'evento.

Un esempio completo del monitoraggio delle conversioni a livello di dispositivo (uso di un cookie su dispositivo dell'utente) nel codice JavaScript di come effettuare questa richiesta di pubblicazione è inclusi 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
    })
  });
}

Quando utilizzi il monitoraggio delle conversioni a livello di utente, devi recuperare il parametro associato all'utente (indipendentemente dalla piattaforma dal meccanismo di archiviazione lato server e invia utilizzando gli stessi endpoint di produzione o sandbox.

Nota: gli eventi di conversione possono essere inviati da un client web o di un'app. o dal server. Puoi prendere questa decisione in base alle tue in base alle esigenze e a dove è archiviato il token, purché venga eseguita una viene inviato esattamente una volta per ogni conversione e include una Valore rwg_token.

Requisiti per l'attribuzione delle conversioni

Lo standard richiesto da Google per l'attribuzione delle conversioni è un periodo di 30 giorni finestra di attribuzione per qualsiasi interazione con un link a un luogo, in qualsiasi .

Questa finestra di attribuzione indica che ci aspettiamo una conversione da inviare in uno dei seguenti scenari:

Un utente segue un link di azione diretta ed effettua un ordine nella stessa sessione
Un utente segue un link di azione diretta e poi torna da un canale diverso entro il periodo di 30 giorni necessario per effettuare un ordine.
Un utente segue un link di azione diretta e poi effettua un ordine presso una un negozio diverso, nella stessa sessione o in sessione in una finestra di 30 giorni.

Inoltre, prevediamo che gli eventi di conversione vengano inviati da tutti Piattaforme a cui un utente può essere indirizzato da un link di azione locale. Che include:

Applicazioni web desktop o mobile
App mobile, tramite un link diretto all'app o una registrazione app-intent per il tuo dominio

Se il token è archiviato a livello di utente (vedi il token permanente), è previsto che fornisci l'attribuzione cross-device. Vale a dire che un utente segue un link di azione dal desktop e completa la su dispositivo mobile (utilizzando lo stesso account utente) dovrebbe attivarsi un evento di conversione.

Se il token è archiviato esclusivamente a livello di dispositivo, ad esempio cookie del browser, non è previsto che tu fornisca dati cross-device l'attribuzione dei contenuti. In questo caso, ogni dispositivo avrà un token separato siano mantenuti se l'utente ha seguito un link di azione su quel dispositivo ogni dispositivo seguirebbe le regole di attribuzione separatamente.