Wprowadzenie
Ten dokument dostarcza instrukcję integracji, który wyjaśnia, jak korzystać z funkcji JS z DL API SDK, aby wysyłać zdarzenia z internetowego sklepu. Poradnik pokazuje, jak prawidłowo zintegrować dane ze strony internetowej, zapewniając kontrolę nad wysyłanymi danymi.
Uwaga
Mimo że możliwe jest korzystanie z funkcji JS z DL API SDK, zazwyczaj nie są one zalecane. Jeśli sklep, który jest integrowany, ma już integrację z Google Universal Analytics lub GA4, zalecamy korzystanie z prostszego sposobu integracji opisanego tutaj. Skrypt automatycznie zacznie śledzić zdarzenia na podstawie domeny strony internetowej.
W zależności od konkretnych wymagań i charakterystyki strony internetowej, zalecane podejście do integracji może się różnić.
Instrukcja obsługi
Następny przewodnik oferuje kompleksowe rozwiązania dotyczące następujących tematów:
- Procedury rejestracji zdarzeń o sprzedaży produktów,
- Metody dokumentowania zdarzeń zdobytych leadów,
- Śledzenie aktywności użytkowników w sklepie, wyświetlenie
product detail,
add to cart
,view chart
.
Krok 1 - Osadź skrypt śledzenia
Aby zintegrować wyświetlanie reklam i korzystać z zdarzeń piksela, musisz osadzić skrypt Ad & Pixel.
Jeśli potrzebujesz tylko wysyłać zdarzenia piksela, powinieneś osadzić skrypt Pixel only.
Krok 2 - Wysyłanie informacji o sprzedaży
Aby przekazać zdarzenie zakupu, wywołaj metodę dlApi.sendActivityEvent
z niezbędnymi parametrami: network
, event
, actgid
, cost
, and ord
. Za zdarzenia zakupu odpowiedzialny jest typ purchased
.
Parametry szczegółów produktów (products
) oraz wartość VAT (tax
) są opcjonalne.
Aby uzyskać więcej informacji na temat parametrów, sprawdź Purchased event spec
Twoja strona website: <WEBSITE>
Jeśli jesteś zalogowany, możesz zobaczyć identyfikatory pikseli dla swojej strony internetowej. Jeśli masz więcej niż 1 stronę, kliknij na domenę, aby wybrać Website.
Website: <WEBSITE>
- Pixel ID: <PIXEL_ID>
Pamiętaj, że każdy Website, którą posiadasz, ma osobne ID piksela (
actgid
).
dlApi.cmd.push(function(dlApi) {
dlApi.sendActivityEvent({
network: <<network>>,
event: 'purchased',
actgid: <<actgid>>,
cost: '33.33',
ord: '321-123',
products: [
{
name: 'Donut Friday Scented T-Shirt',
id: '67890',
price: '11.11',
brand: 'Google',
category: 'Apparel',
variant: 'Black',
qty: '3',
}
],
tax: '3.33'
})
});
Jeśli nie zamierzasz przekazywać szczegółów na temat produktów (products
), w patametrze qty
musisz użyć do podania ilość produktów zakupionych przez użytkownika.
dlApi.cmd.push(function(dlApi) {
dlApi.sendActivityEvent({
network: <<network>>,
event: 'purchased',
actgid: <<actgid>>,
cost: '33.33',
ord: '321-123',
qty: '3',
tax: '3.33'
})
});
Krok 3 - Aktywności użytkowników - zdarzenie szczegółów produktu
Zdarzenie product_detail
powinno być wysyłane, gdy użytkownik wyświetla stronę ze szczegółami produktu.
Aby uzyskać więcej informacji na temat parametrów, sprawdź Product detail event spec
dlApi.cmd.push(function(dlApi) {
dlApi.sendActivityEvent({
network: <<network>>,
event: 'product_detail',
actgid: <<actgid>>,
products: [
{
name: 'Donut Friday Scented T-Shirt',
id: '67890',
price: '33.75',
brand: 'Google',
category: 'Apparel',
variant: 'Black',
},
],
sitetype: 'product'
})
});
Krok 4 Zdarzenie aktywności użytkowników - Dodaj do koszyka / Usuń z koszyka
Zdarzenie add_to_cart
powinno być wysyłane, gdy użytkownik kliknie przycisk dodaj do koszyka. W sitetype
powinieneś podać informacje o typie strony, na której wystąpiło zdarzenie.
Zdarzenie remove_from_cart
powinno być przekazane, gdy użytkownik kliknie przycisk usuń z koszyka.
Aby uzyskać więcej informacji na temat parametrów, sprawdź Add to cart event spec and Remove from cart event spec
dlApi.cmd.push(function(dlApi) {
dlApi.sendActivityEvent({
network: <<network>>,
event: 'add_to_cart',
actgid: <<actgid>>,
products: [
{
name: 'Donut Friday Scented T-Shirt',
id: '67890',
price: '33.75',
brand: 'Google',
category: 'Apparel',
variant: 'Black',
qty: 2
},
],
sitetype: 'list'
})
});
Krok 5 - Aktywności użytkowników - Koszyk
Zdarzenie checkout
powinno być wysłane, gdy użytkownik przegląda stronę koszyka.
Aby uzyskać więcej informacji na temat parametrów, sprawdź Checkout event spec
dlApi.cmd.push(function(dlApi) {
dlApi.sendActivityEvent({
network: <<network>>,
event: 'checkout',
actgid: <<actgid>>,
products: [
{
name: 'Donut Friday Scented T-Shirt',
id: '67890',
price: '33.75',
brand: 'Google',
category: 'Apparel',
variant: 'Black',
qty: 2
},
]
})
});
Krok 6 - Sprawdź poprawność integracji
Aby sprawdzić poprawność integracji, skontaktuj się z menedżerem ds. konta z Ringier Axel Springer Polska.
Wysyłanie niestandardowych zdarzeń konwersji
Ta metoda może być wykorzystywana do śledzenia niestandardowych zdarzeń konwersji, które są dostosowane do specyficznych celów reklamodawcy. Przykłady niestandardowych zdarzeń konwersji obejmują wysyłanie formularzy, umieszczenie reklam, zaangażowanie użytkownika poprzez czas spędzony na stronie internetowej i inne unikalne akcje. Wykorzystując niestandardowy piksel konwersji, reklamodawcy mogą monitorować te zdarzenia i optymalizować swoje działania marketingowe.
Aby uzyskać więcej informacji na temat parametrów, sprawdź Custom event spec
dlApi.cmd.push(function(dlApi) {
dlApi.sendActivityEvent({
network: <<network>>,
event: 'custom',
actgid: <<actgid>>,
ord: '321-123'
})
});
Zgody użytkowników
Jeśli Website ma informacje, że użytkownik nie powinien być śledzony przez żadne skrypty, flaga dnt
(do not track) powinna być ustawiona na 'true'. Oto przykład ustawienia flagi dnt
na true
:
dlApi.cmd.push(function(dlApi) {
if (typeof ringDataLayer !== 'undefined' && ringDataLayer !== null) {
ringDataLayer.user = ringDataLayer.user || {};
ringDataLayer.user.consent = ringDataLayer.user.consent || {};
ringDataLayer.user.consent.dnt = true;
}
});
Skrypt jednocześnie utrzymuje zgodność z TCF v2.0 IAB Consent Framework, automatycznie przestrzegając zgód wybranych przez użytkownika, gdy na stronie internetowej zaimplementowana plansza zgodna ze standardem IAB Consent Management Platform (CMP).