Migrazione alla versione 2 del monitoraggio delle conversioni

Panoramica

L'implementazione del monitoraggio delle conversioni prevede due parti: l'archiviazione e la restituzione di rwg_token. Questi valori rimangono invariati, ma per garantire la conformità con la versione 2 del monitoraggio delle conversioni, ora devi restituire un nuovo valore: merchant_change.

Modifiche relative al mantenimento del token

Quando il token viene mantenuto, ti verrà chiesto di archiviare il commerciante associato al link di azione. In genere, questo viene fatto abbinando il commerciante al merchant_id corrispondente.

Di seguito è riportato un esempio di monitoraggio delle conversioni a livello di dispositivo, in cui questi valori vengono memorizzati in un browser web utilizzando un cookie proprietario. Questo esempio presuppone che tu abbia analizzato il valore del token in una variabile e abbia implementato la logica per l'archiviazione di merchant_id. Per utilizzare questo esempio, devi aggiornare rootdomain con il tuo dominio. Questo approccio suggerito potrebbe non funzionare per tutti, quindi i partner sono liberi di modificare o implementare la propria logica come meglio credono.

<script>
  if (typeof rwg_token !== 'undefined') {
    merchant_id = // Write your own logic here assigning the merchant id value
    document.cookie =
    "_rwg_token=" + rwg_token + ";_merchant_id=" + merchantid + ";max-age=2592000;domain=rootdomain.com;path=/";
  }
</script>

Modifiche all'invio dei dati sulle conversioni

Quando un utente completa un evento di conversione, il corpo del post deve essere un oggetto codificato JSON con un nuovo valore booleano merchant_change.

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

I merchant_id archiviati in precedenza vengono utilizzati per determinare se il commerciante che ha attivato l'evento di conversione è diverso da quello originale. Dopo aver stabilito se il commerciante è cambiato, dovrai restituire il valore merchant_change appropriato utilizzando la seguente tabella.

Valore variazione commerciante Requisito
1 Questo valore deve essere utilizzato quando un utente ha lasciato il sito web del commerciante originale e ha completato un acquisto tramite la tua piattaforma con un commerciante diverso
2 Questo valore deve essere utilizzato quando il cliente ha completato una transazione tramite l'entità originale (commerciante).

Devi fornire un valore rwg_token valido per inviare un evento di conversione. A scopo di test, utilizza il seguente token di test in entrambi gli ambienti fino al momento del lancio:

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Quando effettui la richiesta, utilizza i seguenti endpoint che corrispondono al tuo ambiente:

  • Produzione: https://www.google.com/maps/conversion/collect
  • Sandbox: https://www.google.com/maps/conversion/debug/collect

Requisiti di 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 a un luogo, in qualsiasi negozio.

Questa finestra di attribuzione indica che Google si aspetta che venga inviato un evento di conversione in uno dei seguenti scenari:

  • Un utente segue un link per l'azione di contatto ed effettua un ordine per lo stesso commerciante nella stessa sessione(Valore variazione commerciante = 2)
  • Un utente segue un link di azione diretta e poi torna da un canale diverso entro il periodo di 30 giorni per effettuare un ordine per lo stesso commerciante. ( Valore variazione commerciante = 2)
  • Un utente segue un link all'azione di posizionamento e poi effettua un ordine in un altro negozio, nella stessa sessione o in una diversa sessione in un periodo di 30 giorni. ( Valore variazione commerciante = 1)

Inoltre, Google si aspetta che gli eventi di conversione vengano inviati da tutte le piattaforme a cui un utente può arrivare da un link di azione luogo. Tra cui:

  • 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 salvataggio del token), si prevede che fornisci l'attribuzione cross-device. In altre parole, un utente che segue un link all'azione dal computer e poi completa la transazione su un dispositivo mobile (utilizzando lo stesso account utente) dovrebbe attivare un evento di conversione.

Se il token viene memorizzato esclusivamente a livello di dispositivo, ad esempio nei cookie del browser, non è previsto l'attribuzione cross-device. In questo caso, ogni dispositivo avrebbe un token separato persistente se l'utente avesse seguito un link di azione sul dispositivo e ogni dispositivo seguisse le regole di attribuzione separatamente.