Konfiguracja

Pinterest: tag i Conversions API (CAPI) w SalesCRM

SalesCRM wysyła zdarzenia do Pinteresta dwoma kanałami naraz: tagiem w przeglądarce klienta oraz Conversions API z naszego serwera. Oba wysyłają ten sam event_id, więc Pinterest łączy je w jedną konwersję i nie liczy zakupu dwa razy.

1. Po co dwa kanały

Sam tag w przeglądarce gubi część konwersji - blokują go wtyczki reklamowe, ograniczenia ciasteczek w Safari i przeglądarkach mobilnych, czasem zwykły brak zasięgu w chwili zakupu. Zdarzenie wysłane z naszego serwera dociera niezależnie od tego, co dzieje się w przeglądarce.

Tag (przeglądarka) - widzi zachowanie na stronie i ciasteczka Pinteresta, w tym identyfikator kliknięcia w reklamę.
Conversions API (serwer) - dociera zawsze, także gdy tag został zablokowany, i niesie dane zamówienia prosto z systemu.

Nie musisz wybierać. Włączone razem uzupełniają się, a Pinterest scala obie kopie zdarzenia.

2. Konfiguracja w panelu

Wejdź w Konfiguracja → Integracje → Pinterest. Znajdziesz tam dwie grupy pól.

Tag (przeglądarka):

Identyfikator tagu - z Pinterest Ads Manager, sekcja Konwersje.
Śledzenie wyświetleń koszyka, dodań do koszyka, zamówień - osobne przełączniki.
Zdarzenie wywołujące zarejestrowanie zamówienia - potwierdzenie zamówienia albo przekierowanie po płatności. Wybierz to drugie, jeśli chcesz liczyć wyłącznie zakupy z potwierdzoną płatnością.

Conversions API (serwer):

ID konta reklamowego - numer konta w Pinterest Ads Manager.
Token dostępu - wygenerujesz go w ustawieniach konta reklamowego.

Wysyłkę serwerową włącza samo uzupełnienie obu tych pól - nie ma osobnego przełącznika. Puste pola oznaczają, że działa wyłącznie tag.

3. Jakie zdarzenia i którym kanałem

Zdarzenie	Kiedy	Tag	Conversions API
`pagevisit`	wejście na stronę koszyka	tak	nie
`addtocart`	dodanie produktu do koszyka	tak	tak
`checkout`	złożone zamówienie	tak	tak

Zdarzenia niosą wartość zamówienia, walutę, liczbę sztuk oraz listę pozycji z identyfikatorami produktów i cenami.

4. Deduplikacja - dlaczego konwersje nie liczą się podwójnie

Każde zdarzenie ma identyfikator, taki sam w obu kanałach:

zakup - orders_<id zamówienia>,
dodanie do koszyka - wspólny identyfikator przypisany do tego dodania.

Pinterest po tym identyfikatorze rozpoznaje, że kopia z przeglądarki i kopia z serwera to to samo zdarzenie, i liczy je raz. W Events Managerze zobaczysz wtedy jedno zdarzenie ze wskazanymi dwoma źródłami.

5. Dane dopasowania - dlaczego Pinterest prosi o e-mail

Pinterest dopasowuje konwersję do użytkownika, który widział reklamę. Im więcej danych dopasowania, tym większa część konwersji zostanie przypisana do kampanii. SalesCRM wysyła je zawsze w postaci zaszyfrowanej (SHA-256) - Pinterest nigdy nie dostaje od nas adresu e-mail ani numeru telefonu w czytelnej formie.

Dane	Skąd pochodzą	Kiedy dostępne
adres e-mail	dane zamówienia	koszyk z wypełnionym formularzem, potwierdzenie, powrót z płatności
numer telefonu	dane zamówienia	zamówienie
identyfikator odwiedzającego	ciasteczko sklepu	zawsze, także przy dodaniu do koszyka
adres IP i przeglądarka	żądanie do serwera	zawsze
identyfikator kliknięcia w reklamę	ciasteczko Pinteresta	gdy klient przyszedł z reklamy

Brak e-maila przy dodaniu do koszyka jest normalny. Klient podaje adres dopiero w formularzu zamówienia, więc wcześniej po prostu go nie znamy - ani my, ani żadne inne narzędzie. Na tym etapie dopasowanie opiera się na identyfikatorze odwiedzającego, adresie IP i identyfikatorze kliknięcia w reklamę. Przy zakupie e-mail już leci.

6. Zgody i prywatność

Jeśli w sklepie działa Google Consent Mode, tag Pinteresta uruchamia się dopiero po wyrażeniu zgody marketingowej - tak samo jak pozostałe piksele. Dane osobowe wysyłamy wyłącznie zaszyfrowane funkcją skrótu, której nie da się odwrócić.

7. Jak sprawdzić, czy działa

W Pinterest Ads Manager → Konwersje → Events Manager zobaczysz przychodzące zdarzenia wraz ze źródłem (tag, API albo oba).
Po uzupełnieniu konta reklamowego i tokenu przy zdarzeniach checkout i addtocart powinno pojawić się źródło serwerowe.
Wskaźnik dopasowania rośnie stopniowo - Pinterest liczy go na podstawie ruchu z kilku dni.

Gdyby konwersje zaczęły się dublować, sprawdź, czy tag Pinteresta nie jest dodatkowo wstawiony ręcznie - np. przez Google Tag Manager albo w kodzie własnego frontu. Dwa niezależne tagi wysyłają dwa zdarzenia bez wspólnego identyfikatora, więc Pinterest nie ma jak ich połączyć.

8. Najczęstsze pytania

Czy muszę włączać Conversions API? Nie, tag działa samodzielnie. Conversions API dokłada odporność na blokery reklam i poprawia dopasowanie - warto, jeśli realnie prowadzisz kampanie na Pintereście.

Czy Pinterest dostaje mój adres e-mail klienta? Nie w czytelnej formie. Wysyłamy skrót SHA-256, który służy wyłącznie do porównania z danymi po stronie Pinteresta.

Mam własny front sklepu. Wtedy tag na swoich stronach osadzasz sam, a zdarzenia z koszyka i zamówienia wysyła SalesCRM - kanał serwerowy działa niezależnie od tego, czym renderujesz sklep.

W skrócie: wpisz identyfikator tagu, włącz interesujące Cię zdarzenia, a jeśli prowadzisz kampanie - dodaj ID konta reklamowego i token. Deduplikacja i szyfrowanie danych dzieją się po naszej stronie.