Zmienna szczegółów zakupu zawiera informacje o produktach sprzedanych w ramach danej transakcji. Możesz ją dodać do fragmentu kodu zdarzenia Floodlight, tagu Floodlight, warstwy danych Menedżera tagów Google lub makra Menedżera tagów Google.
W zależności od tego, jak dodajesz zmienną, użyj jednego z tych formatów:
-
Jeśli używasz tagu Google, sformatuj zmienną szczegółów zakupu jako obiekt JSON bezpośrednio we fragmencie kodu Floodlight.
- Jeśli używasz tagu iframe lub graficznego Floodlight albo przekazujesz dane do Menedżera tagów Google w postaci makra, sformatuj zmienną szczegółów zakupu jako ciąg znaków podzielony na zbiór pól.
-
Jeśli przekazujesz dane do warstwy danych Menedżera tagów Google, sformatuj zmienną jako obiekt JSON z polami szczegółów zakupu.
Wymagania dotyczące formatu JSON we fragmencie kodu zdarzenia Floodlight
Jeśli używasz tagu Google, szczegóły zakupu musisz określić we fragmencie kodu zdarzenia jako elementy tablicy items
w formacie JSON oraz w polach country
i language
. Każdy element w tablicy zawiera te pola:
id
price
-
quantity
Przykład:
<!--
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 -->
Uwaga: Fragmenty kodu zdarzenia wygenerowane przez Search Ads 360 obejmują opcjonalny tag <noscript>
zawierający tag graficzny Floodlight. Ten tag jest używany do raportowania konwersji w przeglądarkach, które nie obsługują JavaScriptu.
Wymagania dotyczące formatu JSON w warstwie danych
Jeśli używasz Menedżera tagów Google, pola szczegółów zakupu musisz określić jako elementy tablicy ecommerce.purchase.products
w formacie JSON:
'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.
}]
}
}'
Pamiętaj, że nazwy pól obiektu JSON różnią się od tych w obiekcie JSON, którego używasz, gdy dodajesz zmienną szczegółów zakupu do fragmentu kodu zdarzenia Floodlight.
Gdy przekażesz szczegóły zakupu do warstwy danych, w rzeczywistości zapiszesz dane w tym samym elemencie, za pomocą którego Google Analytics może raportować produkty kupione w Twojej witrynie. Oznacza to, że jeśli do raportowania szczegółów zakupu używasz zarówno Search Ads 360, jak i Google Analytics, Twój programista witryny może użyć tego samego elementu do zapisywania danych na potrzeby obu tych usług.
Wymagania dotyczące formatu ciągu znaków
W formacie ciągu znaków każde pole szczegółów zakupu należy podać jako parę klucz-wartość w formacie:
[identyfikator pola][indeks]:[wartość]
- [identyfikator pola] określa typ raportowanej wartości.
- [indeks] wskazuje produkt, dla którego wartość jest raportowana.
- [wartość] zawiera informacje o sprzedaży produktu.
Każde pole należy oddzielić znakiem | (pionową kreską). Przykład:i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2
Pola szczegółów zakupu
Pole |
Identyfikator w formacie ciągu znaków |
Typ |
Wymagany |
Opis |
|
|
Ciąg znaków |
Tak |
Identyfikator sprzedanego produktu. Musi być zgodny z identyfikatorem produktu w Google Merchant Center. |
|
|
Liczba rzeczywista |
Tak |
Cena jednostkowa sprzedanego produktu. Nie podawaj symbolu waluty. |
|
|
Liczba całkowita |
Tak |
Liczba sprzedanych jednostek produktu. |
|
|
Ciąg znaków (kod kraju w formacie ISO 3166) |
Nie |
Kraj zarejestrowany na potrzeby pliku danych Merchant Center zawierającego dane o produkcie. To pole jest potrzebne tylko wtedy, gdy identyfikatory produktów nie są unikalne w wielu plikach danych Merchant Center. Podaj kraj tylko raz dla każdego produktu (to nie jest pole powtarzalne). Jeśli nie określisz wartości pola, Search Ads 360 wybierze plik danych Merchant Center zawierający identyfikator produktu i użyje atrybutów tego pliku jako wymiarów powiązanych ze sprzedanymi produktami. |
|
|
Ciąg znaków (kod języka w formacie ISO 639) |
Nie |
Język zarejestrowany na potrzeby pliku danych Merchant Center zawierającego dane o produkcie. To pole jest potrzebne tylko wtedy, gdy identyfikatory produktów nie są unikalne w różnych plikach danych Merchant Center. Jeśli nie określisz wartości pola, Search Ads 360 wybierze plik danych Merchant Center zawierający identyfikator produktu i użyje atrybutów tego pliku jako wymiarów powiązanych ze sprzedanymi produktami. |
Znaki specjalne i kodowanie adresów URL
Dwukropek :
i pionowa kreska |
służą jako separatory pól w formacie ciągu znaków. Search Ads 360 nie akceptuje danych, które zawierają takie znaki jako wartości w polach, nawet wtedy, gdy używasz jednego z formatów JSON.
Podobnie jak we wszystkich danych Floodlight, nie są też akceptowane te znaki:
;
, <
, >
, ?
Weźmy transakcję obejmującą te produkty:
-
Produkt 1
- Nazwa: m-dress-orange-xl
- UPC: 123456755559
- Cena jednostkowa: 19,99 PLN
- Ilość: 1
-
Produkt 2
- Nazwa: m-polo-green-l
- UPC: 123456788889
- Cena jednostkowa: 54 PLN
- Ilość: 2
Zmienna szczegółów zakupu we fragmencie kodu zdarzenia mogłaby zawierać te pola:
'items': [
{ 'id': '123456755559',
'price': '19.99',
'quantity': 1
},
{ 'id': '123456788889',
'price': '54.00',
'quantity': 2
}
]
Zmienna szczegółów zakupu w tagu Floodlight typu iframe wygląda tak:i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2
Oprócz zmiennej szczegółów zakupu tag Floodlight lub fragment kodu zdarzenia zawierałby też te dane:
-
Identyfikator grupy aktywności Floodlight
-
Identyfikator aktywności Floodlight
-
Identyfikator transakcji (identyfikator zamówienia)
-
Całkowita wartość transakcji: 129,97 PLN = (1*19,99 PLN + 2*54 PLN)
-
Ilość: 3 (Możesz określić dokładne znaczenie tego pola. Na przykład możesz go użyć do raportowania całkowitej wielkości koszyka).
-
Pozostałe niestandardowe zmienne Floodlight
W ostatecznej postaci globalny tag witryny z fragmentem kodu zdarzenia wyglądałby tak:<!--
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 -->
Przykład tagu iframe Floodlight ze zmienną szczegółów zakupu:
W Merchant Center możesz przesyłać produkty w wielu plikach danych, z których każdy będzie kierowany do konkretnego kraju i na konkretny język. Jeśli na przykład sprzedajesz tę samą grupę produktów w Stanach Zjednoczonych i Kanadzie, możesz skonfigurować plik danych z cenami i opisami dla USA, plik z kanadyjskimi cenami i opisami w języku francuskim i plik z kanadyjskimi cenami i opisami w języku angielskim.
Gdy przesyłasz pliki danych z tymi samymi identyfikatorami produktów, ale innymi krajami i językami docelowymi, musisz w zmiennej szczegółów zakupu podać kod kraju i języka. Na przykład tablica items
oraz pola country
i language
we fragmencie kodu zdarzenia rejestrują zakup pochodzący z pliku danych kierowanego do francuskojęzycznych Kanadyjczyków:
'items': [
{ 'id': '123456788889',
'price': '19.99',
'quantity': 1
},
{ 'id': '123456755559',
'price': '54.00',
'quantity': 2
}
],
'country': 'ca',
'language': 'fr'
Pamiętaj, aby używać 2-cyfrowych kodów ISO kraju i języka.