La variabile sui dettagli relativi agli acquisti fornisce informazioni sui prodotti venduti in una determinata transazione. Puoi aggiungere la variabile a uno snippet evento Floodlight, a un tag Floodlight, al livello dati di Google Tag Manager o a una macro di Google Tag Manager.
A seconda di come aggiungi la variabile, utilizza uno dei seguenti formati:
-
Se utilizzi il tag Google, formatta la variabile sui dettagli relativi agli acquisti come un oggetto JSON direttamente nello snippet evento di Floodlight.
- Se utilizzi un tag iframe o immagine Floodlight oppure passi i dati a Google Tag Manager sotto forma di macro, formatta la variabile sui dettagli relativi agli acquisti come stringa suddivisa in un insieme di campi.
-
Se pubblichi i dati nel livello dati di Google Tag Manager, formatta la variabile come oggetto JSON con i campi dei dettagli relativi agli acquisti.
Requisiti per il formato JSON in uno snippet evento di Floodlight
Se utilizzi il tag Google, è necessario specificare i dettagli relativi agli acquisti nello snippet evento sotto forma di array JSON items
, oltre ai campi country
e language
. Ogni elemento dell'array contiene i seguenti campi:
id
price
-
quantity
Ad esempio:
<!--
Event snippet for Thank You on http://www.example.com/thanks: Please do not remove.
Place this snippet on pages with events you’re tracking.
Creation date: 11/01/2017
-->
<script>
gtag('event', 'purchase',
{
'allow_custom_scripts': true,
'send_to': 'DC-1234567/group1/thank123+transactions',
'transaction_id': '012345',
'value': 129.97,
'items': [
{ 'id': '123456755559',
'price': '19.99',
'quantity': 1
},
{ 'id': '123456788889',
'price': '54.00',
'quantity': 2
}
],
'country': 'us',
'language': 'en'
}
);
</script>
<noscript>
<img src="https://ad.doubleclick.net/ddm/activity/src=1234567;type=group1;cat=thank123;
qty=1;cost=129.97;dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;tfua=;npa=;
ord=012345;prd=i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2|c:us|l:en?" width="1" height="1" alt="">
</noscript>
<!-- End of event snippet: Please do not remove -->
Nota: Gli snippet evento generati da Search Ads 360 includono un tag <noscript>
facoltativo che contiene a sua volta un tag immagine Floodlight. Questo tag viene utilizzato per generare rapporti sulle conversioni nei browser che non supportano JavaScript.
Requisiti per il formato JSON nel livello dati
Se utilizzi Google Tag Manager, i campi dei dettagli relativi agli acquisti devono essere specificati come elementi in un array JSON ecommerce.purchase.products
:
'ecommerce':{
'purchase':{
'products': [{
'id': 'String',
'price': 'Floating point',
'quantity': Integer,
'country': 'String', // Optional
'language': 'String', // Optional
'accountId': 'String' // Optional
},
{
… // Each SKU (product) in the transaction
// is in its own array item.
}]
}
}'
Tieni presente che i nomi dei campi per questo oggetto JSON sono diversi dall'oggetto JSON utilizzato se si aggiunge la variabile sui dettagli relativi agli acquisti a uno snippet evento di Floodlight.
Quando trasferisci dettagli relativi agli acquisti al livello dati, questi vengono effettivamente memorizzati nello stesso oggetto che Google Analytics può utilizzare per generare rapporti sui prodotti acquistati dal tuo sito. Ciò significa che se utilizzi sia Search Ads 360 sia Google Analytics per generare rapporti sui dettagli relativi agli acquisti, il tuo sviluppatore web può utilizzare lo stesso oggetto per memorizzare i dati per entrambi i prodotti.
Requisiti per il formato Stringa
Nel formato Stringa, ogni campo dei dettagli relativi agli acquisti deve essere specificato come coppia chiave-valore nel seguente formato:
[ID campo][indice]:[valore]
- [ID campo] identifica il tipo di valore registrato.
- [indice] indica l'elemento per il quale il valore viene trasmesso.
- [valore] fornisce informazioni sulla vendita del prodotto.
Separa ogni campo con una barra verticale (|). Esempio:
i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2
Campi dei dettagli relativi agli acquisti
Campo |
ID in formato Stringa |
Tipo |
Obbligatorio |
Descrizione |
|
|
Stringa |
Sì |
L'ID del prodotto venduto. L'ID deve corrispondere all'ID articolo di Google Merchant Center. |
|
|
Punto floating |
Sì |
Prezzo per unità di prodotto venduto. Non includere il simbolo di una valuta. |
|
|
Numero intero |
Sì |
La quantità di unità di prodotto venduto. |
|
|
Stringa (codice paese ISO 3166) |
No |
Il paese registrato per il feed di Merchant Center che contiene i dati relativi al prodotto. Questo campo è necessario solo se gli ID articolo non sono univoci in più feed di Merchant Center. Specifica il paese solo una volta per ogni prodotto (non è un campo ripetuto). Se il campo non viene specificato, Search Ads 360 sceglie un feed del Merchant Center che contiene l'ID prodotto utilizzandone gli attributi per le dimensioni dei prodotti venduti. |
|
|
Stringa (codice lingua ISO 639) |
No |
La lingua registrata per il feed del Merchant Center che contiene i dati relativi al prodotto. Questo campo è necessario solo se gli ID articolo non sono univoci in più feed di Merchant Center. Se il campo non viene specificato, Search Ads 360 sceglie un feed del Merchant Center che contiene l'ID prodotto utilizzandone gli attributi per le dimensioni dei prodotti venduti. |
Codifica di URL e caratteri speciali
Il simbolo dei due punti (:
) e quello della barra verticale (|
) vengono utilizzati come delimitatori di campo nel formato Stringa. Search Ads 360 non può accettare i dati che includono questi caratteri come valori all'interno di un campo, anche se utilizzi uno dei formati JSON.
Come per tutti i dati Floodlight, anche i seguenti caratteri non sono accettati:
;
, <
, >
, ?
Supponi che una transazione includa i seguenti articoli:
-
Articolo 1
- Nome: m-dress-orange-xl
- UPC: 123456755559
- Prezzo per articolo: 19,99 $
- Quantità: 1
-
Articolo 2
- Nome: m-polo-green-l
- UPC: 123456788889
- Prezzo per articolo: 54 $
- Quantità: 2
La variabile sui dettagli relativi agli acquisti in uno snippet evento contiene i seguenti campi:
'items': [
{ 'id': '123456755559',
'price': '19.99',
'quantity': 1
},
{ 'id': '123456788889',
'price': '54.00',
'quantity': 2
}
]
Ecco come viene visualizzata la variabile sui dettagli relativi agli acquisti in un tag iframe di Floodlight:
i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2
Oltre alla variabile sui dettagli relativi agli acquisti, lo snippet evento o il tag Floodlight potrebbe riportare anche i seguenti dati:
-
ID del gruppo attività Floodlight
-
ID dell'attività Floodlight
-
ID transazione (ID ordine)
-
Valore totale della transazione: 129,97 $ = (1 * 19,99 $ + 2 * 54 $)
-
Quantità: 3 (puoi definire il significato esatto di questo campo. Potresti prendere in considerazione l'idea di utilizzarlo per eseguire report sulle dimensioni totali del carrello).
-
Qualunque altra variabile Floodlight personalizzata
Il tag Google finale con lo snippet evento potrebbe essere simile al seguente:
<!--
Start of global snippet: Please do not remove
Place this snippet between the <head> and </head> tags on every page of your site.
-->
<!-- Google Tag (gtag.js) - DoubleClick -->
<script async src="https://www.googletagmanager.com/gtag/js?id=DC-1234567"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments)};
gtag('js', new Date());
gtag('config', 'DC-1234567');
</script>
<!-- End of global snippet: Please do not remove -->
<!--
Event snippet for Thank You on http://www.example.com/thanks: Please do not remove.
Place this snippet on pages with events you’re tracking.
Creation date: 11/01/2017
-->
<script>
gtag('event', 'purchase',
{
'allow_custom_scripts': true,
'send_to': 'DC-1234567/group1/thank123+transactions',
'transaction_id': '012345',
'value': 129.97,
'items': [
{ 'id': '123456755559',
'price': '19.99',
'quantity': 1
},
{ 'id': '123456788889',
'price': '54.00',
'quantity': 2
}
],
'country': 'us',
'language': 'en'
}
);
</script>
<noscript>
<img src="https://ad.doubleclick.net/ddm/activity/src=1234567;type=group1;cat=thank123;
qty=1;cost=129.97;dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;tfua=;npa=;
ord=012345;prd=i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2|c:us|l:en?" width="1" height="1" alt="">
</noscript>
<!-- End of event snippet: Please do not remove -->
Ecco un esempio di tag iframe di Floodlight con una variabile sui dettagli relativi agli acquisti:
Puoi utilizzare Merchant Center per inviare i prodotti in più feed, ciascuno indirizzato a una lingua e a un paese specifico. Ad esempio, se vendi lo stesso gruppo di prodotti negli Stati Uniti e in Canada, puoi impostare un feed con i prezzi e le descrizioni per gli Stati Uniti, un altro feed con i prezzi e le descrizioni per il Canada in francese e un terzo feed con i prezzi e le descrizioni per il Canada in inglese.
Quando invii i feed con gli stessi ID prodotto ma paesi o lingue di destinazione diversi, devi includere il codice paese e il codice lingua nella variabile sui dettagli relativi agli acquisti. Ad esempio, questo array items
e i campi country
e language
nello snippet evento registrano un acquisto dal feed indirizzato ai canadesi di lingua francese:
'items': [
{ 'id': '123456788889',
'price': '19.99',
'quantity': 1
},
{ 'id': '123456755559',
'price': '54.00',
'quantity': 2
}
],
'country': 'ca',
'language': 'fr'
Assicurati di utilizzare i codici paese e lingua ISO a due cifre.