Script Tracking Client-Side
Introduzione
Grazie all'implementazione del nostro script di tracking delle conversioni, Click2Buy è in grado di raccogliere le vendite validate generate dagli utenti provenienti dalla nostra soluzione.
Questo tracking consente ai brand di misurare con precisione il ROI del traffico indirizzato ai siti dei rivenditori tramite la soluzione Click2Buy Where to Buy.
Per configurare il tracking, avrai bisogno della tua Retailer Key, che sarà fornita dal tuo Retail Account Manager di Click2Buy. Questo identificatore verrà utilizzato in entrambi i metodi di implementazione disponibili.
Sono disponibili due metodi di implementazione:
🏷️ Tramite Google Tag Manager
Consigliato — il metodo più semplice e rapido da implementare.
💻 Tramite implementazione nativa
Integrazione diretta nel codice del sito web.
Implementazione tramite Google Tag Manager
Abbiamo sviluppato un template ufficiale di Google Tag Manager che consente una semplice implementazione del tracking delle conversioni Click2Buy. Questo template permette ai rivenditori di configurare il tracking senza dover scrivere codice personalizzato. Per installare il tag, è sufficiente fare riferimento alla nostra documentazione su GitHub, che include:
- istruzioni dettagliate di installazione
- il file template da importare in Google Tag Manager
- i passaggi necessari per configurare il tag
Durante la configurazione del tag, dovrai solo inserire la tua Retailer Key, che sarà fornita dal tuo contatto Click2Buy.
👉 Tutta la documentazione e i file necessari sono disponibili qui: https://github.com/Click2Buy/gtm-web-template/tree/master?tab=readme-ov-file
Implementazione Nativa (codice diretto)
Questa guida descrive il metodo di implementazione del nostro tag che permetterà di recuperare la validazione della vendita e il contenuto del carrello. Per questo, sarà necessario eseguire un codice specifico sulla pagina di successo/conferma con il contenuto dell'ordine.
Quando si carica la pagina di conferma dell'ordine, sarà necessario caricare il seguente script:
<!-- Click2Buy retailer script -->
<script>
(function(i,s,o,g,r,a,m){i[r]=i[r]||{q:[],validationProcess:function(){
i[r].q.push(arguments)}};a=s.createElement(o);m=s.getElementsByTagName(o)[0];
a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://rs.clic2buy.com/retailers/__KEY_RETAILER__.js','C2B');
C2B.validationProcess(__PARAMS__);
</script>KEY_RETAILER rappresenta l'ID che ti è stato fornito dal tuo contatto Click2Buy.
PARAMS deve essere sostituito dalle informazioni dell'ordine secondo il formato seguente (o secondo il vostro datalayer).
Parametri della funzione C2B.validationProcess
La funzione deve ricevere come parametri un oggetto con i seguenti campi:
| Campo | Tipo di valore | Obbligatorio | Descrizione |
|---|---|---|---|
totalAmount | Number | Sì | Importo totale del carrello |
currency | String | Sì | Valuta del carrello (ISO4217) |
products | Array | Sì | Tabella contenente un oggetto per prodotto dell'ordine - il formato è descritto di seguito |
Campi degli oggetti prodotto
| Campo | Tipo di valore | Obbligatorio | Descrizione |
|---|---|---|---|
ean | String | Sì | Codice EAN-13 del prodotto |
upc | String | No | Codice UPC del prodotto |
retailerReference | String | Sì | Riferimento prodotto, specifico del rivenditore |
amount | Number | Sì | Prezzo unitario del prodotto |
quantity | Number | Sì | Quantità del prodotto |
name | String | Sì | Nome del prodotto |
packaging | String | No | Imballaggio del prodotto |
brand | String | Sì | Marca del prodotto |
manufacturerReference | String | No | Riferimento prodotto (specifico del brand) |
metadata | JSON | No | Altri dati utili del prodotto (struttura libera) |
Per valorizzare questi dati, avremo bisogno almeno del codice EAN o UPC del prodotto. Se non disponi di queste informazioni, puoi inviarci il tuo riferimento interno (retailerReference).
N.B.: Se non è possibile fornire alcuni campi, è possibile lasciarli vuoti. Se la tua configurazione richiede un valore per ogni campo, puoi utilizzare "null" come variabile predefinita.
⚠️ Attenzione : Quando si copia e incolla lo script in alcuni editor di testo, le virgolette (" ") possono essere modificate automaticamente. Assicurati che siano correttamente formattate per evitare errori nell'esecuzione dello script.
Domini da inserire nella lista di autorizzazioni
Il nostro tag utilizza più sottodomini per funzionare correttamente. Se la tua politica di sicurezza blocca il caricamento di script esterni, è necessario autorizzare i seguenti domini.
Puoi autorizzare:
- *.clic2buy.com
- *.clic2drive.com
- *.click2buy.com
Oppure autorizzare i seguenti domini specifici:
rs.clic2buy.com (obbligatorio) Dominio in cui è ospitato lo script di tracking.
t.clic2buy.com (obbligatorio) Dominio utilizzato per i nostri cookie di terze parti. Consente di recuperare l'ID anonimo assegnato agli utenti della nostra soluzione sul tuo sito.
analytics.clic2drive.com (obbligatorio) Dominio che consente di recuperare le informazioni del carrello tramite l'ID utente e registrare la validazione della vendita.
Dati raccolti
Il nostro tag raccoglie solo le conferme del carrello provenienti dai reindirizzamenti Click2Buy.
Nessun dato personale viene raccolto.
Quando un utente arriva sul sito del rivenditore tramite la soluzione Where to Buy, viene creato un cookie anonimo per identificare la fonte del traffico e misurare le conversioni.
Click2Buy è conforme al GDPR.
Per qualsiasi domanda relativa alla protezione dei dati, puoi contattare il nostro DPO:
Artaches Kherounts📧 dpo@click2buy.com📞 +33 3 66 72 29 04