Pinterest API for Conversions i tag Pinterest: jak poprawnie mierzyć sprzedaż

Czym jest tag Pinterest i jak współpracuje z Conversions API?

Tag Pinterest to fragment kodu JavaScript instalowany na stronie, który rejestruje działania użytkowników – odwiedziny, dodanie do koszyka, zakup – i przekazuje je do Pinteresta. Pinterest API for Conversions (w skrócie Conversions API) wysyła te same zdarzenia bezpośrednio z serwera sklepu, dzięki czemu nie giną przez blokery reklam, ograniczenia przeglądarek ani błędy skryptów.

Tag składa się z kodu bazowego, który ładuje się na każdej podstronie, oraz kodów zdarzeń wywoływanych przy konkretnych działaniach. Bez nich kampania konwersji nie wie, pod co ma optymalizować, retargeting nie ma z czego budować grup odbiorców, a raporty nie pokazują przychodu. Dane z tagu zasilają też automatyzację – kampanie Performance+ uczą się wyłącznie na sygnałach, które im dostarczysz.

Dwa źródła zamiast jednego to dziś standard na dużych platformach reklamowych: podobnie działa Conversions API i Insight Tag na LinkedInie czy piksel X z Conversions API. Jeśli dopiero zakładasz konto, zacznij od tekstu o konfiguracji konta firmowego i weryfikacji domeny, a szerszy kontekst kanału znajdziesz w przewodniku po reklamie na Pintereście.

Jakie zdarzenia i parametry ustawić w sklepie?

W sklepie internetowym minimum to trzy zdarzenia: page visit na każdej podstronie (z identyfikatorem produktu na karcie produktu), add to cart przy dodaniu do koszyka i checkout na stronie potwierdzenia zamówienia. Pozostałe zdarzenia dodajesz wtedy, gdy faktycznie wykorzystasz je w kampaniach lub grupach odbiorców.

Najważniejsza zasada dotyczy identyfikatorów produktów: wartość przekazywana w zdarzeniach musi być identyczna z polem id w katalogu. Jeśli tag wysyła numer SKU, a feed – wewnętrzny identyfikator z bazy danych, retargeting dynamiczny i raporty na poziomie produktów nie zadziałają. Zgodność tych pól sprawdzisz razem z feedem, o którym piszemy w tekście o katalogu produktów na Pintereście.

Druga zasada: wartość zamówienia przekazuj konsekwentnie – albo zawsze brutto, albo zawsze netto, z kosztem dostawy lub zawsze bez niego. Mieszanie wariantów sprawia, że ROAS w raportach przestaje być porównywalny między miesiącami.

Jak zainstalować tag Pinterest krok po kroku?

Tag Pinterest instalujesz jedną z trzech metod: przez oficjalną integrację platformy sklepowej, przez szablon w Google Tag Managerze albo ręcznie w kodzie strony. Integracje Shopify i WooCommerce konfigurują większość zdarzeń automatycznie; przy Shoperze sprawdź dostępne aplikacje, a w sklepach na własnym silniku najczęściej wygrywa Google Tag Manager z warstwą danych.

1. W Menedżerze reklam otwórz sekcję konwersji i utwórz tag; zapisz jego identyfikator.
2. Wybierz jedną metodę instalacji i upewnij się, że w kodzie strony nie został stary tag z wcześniejszej wtyczki.
3. Skonfiguruj kod bazowy na wszystkich podstronach z wyzwalaczem zależnym od zgody na marketingowe pliki cookie.
4. Dodaj zdarzenia page visit, add to cart i checkout z parametrami z tabeli powyżej oraz unikalnym identyfikatorem zdarzenia.
5. Włącz rozszerzone dopasowanie, aby tag przekazywał zahashowany adres e-mail zalogowanych lub kupujących użytkowników.
6. Sprawdź działanie rozszerzeniem Pinterest Tag Helper i złóż testowe zamówienie.
7. Po 24 godzinach skontroluj historię zdarzeń w Menedżerze reklam: liczbę zdarzeń, wartości i ewentualne błędy.

Przykładowe wywołanie zdarzenia zakupu w kodzie strony wygląda tak (wartości podstawia sklep):

javascript pintrk('track', 'checkout', { event_id: 'order-10234', value: 249.00, order_quantity: 2, currency: 'PLN', order_id: '10234' });

Jak wdrożyć Pinterest API for Conversions?

Pinterest API for Conversions wdrażasz przez integrację platformy sklepowej, serwerowy Google Tag Manager albo własne połączenie programistyczne, które wysyła zdarzenia z serwera z tokenem dostępu wygenerowanym w sekcji konwersji Menedżera reklam. Najprostsza droga to integracja sklepu z wbudowaną obsługą API – sprawdź jej ustawienia, zanim zamówisz prace programistyczne.

Każde zdarzenie wysyłane przez API powinno zawierać:

• nazwę zdarzenia (np. checkout, add_to_cart, page_visit) i źródło akcji – dla sklepu internetowego web,
• czas zdarzenia w formacie uniksowym oraz identyfikator zdarzenia zgodny z tym z tagu,
• dane użytkownika – zahashowany algorytmem SHA-256 adres e-mail, adres IP i user agent przeglądarki, a opcjonalnie także zahashowany telefon, imię, nazwisko i kod pocztowy,
• dane niestandardowe – walutę, wartość, numer zamówienia, liczbę sztuk i identyfikatory produktów.

Załóżmy, że sklep z kosmetykami ma 400 zamówień miesięcznie, a tag rejestruje 330 z nich, bo część klientów korzysta z blokerów reklam, a przeglądarki skracają życie plików cookie. Po wdrożeniu API serwer przekazuje także zakupy, których tag nie zarejestrował z przyczyn technicznych – ale wyłącznie od osób, które wyraziły zgodę na marketing. Algorytm dostaje pełniejszy obraz, a koszt konwersji w raportach przestaje być sztucznie zawyżony.

Jak działa deduplikacja zdarzeń i jak ją ustawić?

Deduplikacja to mechanizm, dzięki któremu Pinterest liczy jedną konwersję, gdy to samo zdarzenie przychodzi jednocześnie z tagu i z API. Działa, gdy oba źródła wysyłają ten sam typ zdarzenia i ten sam identyfikator zdarzenia (event_id); bez tego jeden zakup może zostać policzony dwa razy.

Identyfikator zdarzenia musi być unikalny dla każdej konwersji i znany zarówno przeglądarce, jak i serwerowi. Przy zakupie najprościej użyć numeru zamówienia z prefiksem, np. „order-10234”. Przy dodaniu do koszyka czy odwiedzinach strony identyfikator generuje się w przeglądarce i przekazuje do serwera, np. przez warstwę danych lub w żądaniu do backendu sklepu.

Uwaga: Najczęstszy błąd przy deduplikacji to wysyłanie tej samej konwersji jako różnych typów zdarzeń (np. checkout z tagu i zdarzenie niestandardowe z serwera) albo losowy identyfikator generowany osobno w tagu i na serwerze. Efekt widać szybko: liczba zakupów w Pinterest Ads przekracza liczbę zamówień w sklepie, a ROAS wygląda podejrzanie dobrze.

Po wdrożeniu sprawdź w diagnostyce zdarzeń, ile zdarzeń przychodzi z każdego źródła i jaka ich część zostaje połączona. Jeśli API raportuje 100 zakupów, tag 85, a Pinterest pokazuje łącznie 185, deduplikacja nie działa.

Jak poprawić dopasowanie użytkowników i jakość danych?

Jakość danych zależy od tego, ile zdarzeń Pinterest potrafi przypisać do konkretnych użytkowników. Poprawiają ją trzy elementy: rozszerzone dopasowanie w tagu, pełne dane użytkownika w API oraz zachowany identyfikator kliknięcia z reklamy.

Rozszerzone dopasowanie (enhanced match) przekazuje zahashowany adres e-mail – automatycznie z formularzy albo ręcznie przy ładowaniu tagu, gdy użytkownik jest zalogowany. Adres przed hashowaniem trzeba zapisać małymi literami i bez spacji, inaczej dopasowanie się nie powiedzie.

Pinterest dopisuje do adresu docelowego reklamy identyfikator kliknięcia (parametr epik), który tag zapisuje w pliku cookie. Dlatego przekierowania na stronie – z wersji bez „www” na „www”, z adresu kampanii na stronę kategorii czy przez skracacze linków – nie mogą usuwać parametrów z adresu. Sprawdź to, klikając podgląd reklamy i obserwując pasek adresu po załadowaniu strony.

W UE dane do Pinteresta przekazuj tylko w zakresie zgód użytkownika – dotyczy to zarówno tagu, jak i API. Najbezpieczniej przekazywać do serwera stan zgody z narzędzia do zarządzania zgodami i wysyłać zdarzenia wyłącznie osób, które zgodziły się na marketing. Poprawnie zebrane dane zasilają potem grupy odbiorców opisane w poradniku o retargetingu na Pintereście.

Jak sprawdzić, czy pomiar sprzedaży działa poprawnie?

Liczba zdarzeń checkout odebranych przez Pinterest powinna być zbliżona do liczby zamówień w sklepie pomniejszonej o osoby bez zgody na marketing, a konwersje przypisane kampaniom – wyraźnie niższe. Kontrolę rób przy wdrożeniu, po każdej zmianie w sklepie i rutynowo raz w miesiącu.

• Tag Helper – na karcie produktu widać page visit z identyfikatorem produktu, po dodaniu do koszyka add to cart, a na stronie podziękowania checkout.
• Historia zdarzeń – zdarzenia z tagu i API pojawiają się w podobnej liczbie, bez dziur w konkretnych dniach.
• Testowe zamówienie – checkout ma właściwą wartość, walutę i numer zamówienia.
• Porównanie ze sklepem – tygodniowa liczba zdarzeń checkout nie przekracza liczby zamówień.
• Ruch w GA4 – konwersje przypisane kampaniom są wiarygodne na tle sesji z Pinteresta oznaczonych parametrami UTM.

Różnice między Pinterestem a GA4 są normalne, bo Pinterest liczy też konwersje po zapisie pina i po wyświetleniu reklamy w swoich oknach atrybucji, a GA4 widzi tylko wizyty. Jak czytać te rozbieżności i jakie okna wybrać, wyjaśniamy w tekście o raportach i atrybucji w Pinterest Ads.

Najczęstsze błędy w pomiarze sprzedaży z Pinteresta

Większość problemów z pomiarem wynika z kilku powtarzalnych błędów wdrożeniowych, a nie z samej platformy. Zanim uznasz, że Pinterest nie sprzedaje, przejdź poniższą tabelę.

Po usunięciu błędu nie oceniaj kampanii od razu – daj algorytmowi tydzień na zebranie poprawnych danych, bo wcześniejsze, błędne sygnały wciąż wpływają na optymalizację. Jeśli poprawka dotyczyła wartości zamówień, porównuj ROAS dopiero od dnia wdrożenia, a nie w skali całego miesiąca.