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).