Skrypt śledzenia Client-Side
Wprowadzenie
Dzięki wdrożeniu naszego skryptu śledzenia konwersji Click2Buy jest w stanie zbierać zweryfikowane sprzedaże generowane przez użytkowników naszego rozwiązania.
To śledzenie pozwala markom precyzyjnie mierzyć ROI ruchu kierowanego na strony sprzedawców za pośrednictwem rozwiązania Where-to-Buy Click2Buy.
Aby skonfigurować śledzenie, będziesz potrzebować swojego Retailer Key, który zostanie Ci przekazany przez Twojego Retailer Account Managera Click2Buy. Ten identyfikator jest używany w obu dostępnych metodach implementacji.
Dostępne są dwie metody implementacji:
🏷️ Przez Google Tag Manager
Zalecane — najprostsza i najszybsza metoda implementacji.
💻 Przez natywną implementację
Bezpośrednia integracja w kodzie źródłowym strony internetowej.
Implementacja przez Google Tag Manager
Opracowaliśmy oficjalny szablon Google Tag Manager, który umożliwia prostą implementację śledzenia konwersji Click2Buy. Ten szablon pozwala sprzedawcom skonfigurować śledzenie bez pisania własnego kodu. Aby zainstalować tag, po prostu postępuj zgodnie z naszą dokumentacją GitHub, która zawiera:
- szczegółowe instrukcje instalacji
- plik szablonu do zaimportowania do Google Tag Manager
- niezbędne kroki konfiguracji tagu
Podczas konfigurowania tagu wystarczy wpisać swój Retailer Key, który zostanie Ci przekazany przez Twój kontakt Click2Buy.
👉 Cała dokumentacja i niezbędne pliki są dostępne tutaj: https://github.com/Click2Buy/gtm-web-template/tree/master?tab=readme-ov-file
Natywna implementacja (bezpośredni kod)
Ten przewodnik opisuje metodę implementacji naszego tagu, która umożliwi pobranie walidacji sprzedaży oraz zawartości koszyka. W tym celu konieczne jest wykonanie konkretnego kodu na stronie sukcesu/potwierdzenia z zawartością zamówienia.
Gdy ładuje się strona potwierdzenia zamówienia, należy załadować następujący skrypt:
<!-- 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 reprezentuje identyfikator przekazany przez Twój kontakt Click2Buy.
PARAMS należy zastąpić informacjami o zamówieniu zgodnie z poniższym formatem (lub zgodnie z Twoją warstwą danych).
Parametry funkcji C2B.validationProcess
Funkcja musi otrzymać jako parametry obiekt z następującymi polami:
| Pole | Typ wartości | Obowiązkowe | Opis |
|---|---|---|---|
totalAmount | Number | Tak | Łączna kwota koszyka |
currency | String | Tak | Waluta koszyka (ISO4217) |
products | Array | Tak | Tabela zawierająca jeden obiekt na produkt zamówienia - format jest opisany poniżej |
Pola obiektów produktów
| Pole | Typ wartości | Obowiązkowe | Opis |
|---|---|---|---|
ean | String | Tak | Kod EAN-13 produktu |
upc | String | Nie | Kod UPC produktu |
retailerReference | String | Tak | Numer referencyjny produktu, specyficzny dla sprzedawcy |
amount | Number | Tak | Cena jednostkowa produktu |
quantity | Number | Tak | Ilość produktu |
name | String | Tak | Nazwa produktu |
packaging | String | Nie | Opakowanie produktu |
brand | String | Tak | Marka produktu |
manufacturerReference | String | Nie | Numer referencyjny produktu (specyficzny dla marki) |
metadata | JSON | Nie | Inne przydatne dane produktu (dowolna struktura) |
Aby wycenić te dane, będziemy potrzebować co najmniej kodu EAN lub UPC produktu. Jeśli nie masz tych informacji, możesz przesłać nam swój numer referencyjny (retailerReference).
N.B.: Jeśli nie możesz podać niektórych pól, możesz je pozostawić puste. Jeśli Twoja konfiguracja wymaga wartości dla każdego pola, możesz użyć "null" jako domyślnej zmiennej.
⚠️ Uwaga : Podczas kopiowania i wklejania skryptu do niektórych edytorów tekstu cudzysłowy (" ") mogą być automatycznie zmieniane. Upewnij się, że są poprawnie sformatowane, aby uniknąć błędów podczas wykonywania skryptu.
Domeny do autoryzacji
Nasz tag używa kilku subdomen, aby działać poprawnie. Jeśli Twoja polityka bezpieczeństwa blokuje ładowanie zewnętrznych skryptów, konieczne jest autoryzowanie następujących domen.
Możesz autoryzować:
- *.clic2buy.com
- *.clic2drive.com
- *.click2buy.com
Lub autoryzować następujące konkretne domeny:
rs.clic2buy.com (obowiązkowe) Domena, na której hostowany jest skrypt śledzenia.
t.clic2buy.com (obowiązkowe) Domena używana dla naszych plików cookie stron trzecich. Umożliwia pobranie anonimowego identyfikatora przypisanego użytkownikom naszego rozwiązania na Twojej stronie.
analytics.clic2drive.com (obowiązkowe) Domena umożliwiająca pobranie informacji o koszyku za pomocą identyfikatora użytkownika i zarejestrowanie potwierdzenia sprzedaży.
Zbierane dane
Nasz tag zbiera wyłącznie potwierdzenia koszyków z przekierowań Click2Buy.
Żadne dane osobowe nie są zbierane.
Gdy użytkownik trafia na stronę sprzedawcy za pośrednictwem rozwiązania Where-to-Buy, tworzony jest anonimowy plik cookie w celu identyfikacji źródła ruchu i mierzenia konwersji.
Click2Buy jest zgodne z RODO.
W przypadku pytań dotyczących ochrony danych możesz skontaktować się z naszym IOD:
Artaches Kherounts📧 dpo@click2buy.com📞 +33 3 66 72 29 04