Pinterest Conversions API dla Shopify: poradnik konfiguracji

Pinterest Conversions API to sposób Pinteresta na wysyłanie zdarzeń konwersji z serwera na serwer. Twój sklep lub narzędzie takie jak ROASaurus wysyła zdarzenia, na przykład zakupy, prosto do twojego konta reklamowego Pinterest, zamiast polegać wyłącznie na Pinterest Tag w przeglądarce kupującego. Pinterest wykorzystuje te dane do raportowania konwersji, optymalizacji kampanii i targetowania.

Ten poradnik opisuje API v5 i akceptowane przez nie zdarzenia, click id epik, sposób hashowania danych klienta, działanie deduplikacji z Pinterest Tag, testowanie oraz konfigurację całości w Shopify.

Czym jest Pinterest Conversions API?

Pinterest Tag to skrypt w przeglądarce kupującego. Conversions API robi to samo z serwera. W API w wersji 5 wysyłasz zdarzenia na endpoint zdarzeń swojego konta reklamowego, autoryzowany tokenem dostępu do konwersji, który tworzysz w Pinterest Ads Manager. Każde zdarzenie mówi, gdzie się wydarzyło: dla sklepu internetowego action source to web.

Pinterest prosi reklamodawców, którzy używają też Tag, aby nie liczyli konwersji dwa razy, przekazując event_id z każdym zdarzeniem. Prosi też o wysyłanie zdarzeń w czasie rzeczywistym lub najpóźniej godzinę po ich wystąpieniu.

W Shopify połączenie serwerowe ma jedną wyraźną zaletę: zakupy pochodzą z samego zamówienia. Shopify zgłasza każde opłacone zamówienie do ROASaurus przez webhook, a ROASaurus wysyła je do Pinteresta krótko po płatności, niezależnie od tego, czy Tag uruchomił się w przeglądarce. Poradnik o server-side tracking w Shopify wyjaśnia tę ideę dokładniej.

Jakie zdarzenia akceptuje Pinterest Conversions API?

Pinterest ma stałą listę standardowych nazw zdarzeń, zapisywanych małymi literami z podkreśleniami, takich jak page_visit, add_to_cart i checkout. Możesz też zdefiniować do 15 niestandardowych typów zdarzeń na reklamodawcę. ROASaurus mapuje pięć zakupowych zdarzeń Shopify w ten sposób:

Nazwa może wprowadzać w błąd. Zdarzenie checkout w Pinterest to zakończony zakup, a nie początek checkoutu. Początek checkoutu to osobne zdarzenie, initiate_checkout.

Dla zdarzenia checkout Pinterest zaleca wysyłanie wartości, waluty, order id, content ids i liczby pozycji. ROASaurus wysyła wszystkie pięć, a do tego ilość i cenę każdej pozycji. Pinterest prosi o wartość przed podatkiem i wysyłką. W Shopify ROASaurus wysyła dokładnie to: sumę zamówienia pomniejszoną o podatek i wysyłkę, z serwera i z tagu w przeglądarce. Gdy platforma sklepu internetowego nie raportuje podatku i wysyłki osobno, ROASaurus wysyła sumę zamówienia.

Jak Pinterest dopasowuje zdarzenie do osoby?

Każde zdarzenie niesie dane użytkownika. Pinterest wymaga co najmniej jednej z trzech rzeczy: zahashowanego adresu e-mail, zahashowanego mobilnego identyfikatora reklamowego albo adresu IP razem z user agent. Sklep internetowy nie ma identyfikatora reklamowego, więc potrzebuje e-maila albo adresu IP i user agent. ROASaurus pomija zdarzenie, które nie ma żadnego z nich, zamiast wysyłać takie, którego Pinterest nie może wykorzystać.

Click id epik

Click id Pinterest może pochodzić z dwóch miejsc: z parametru epik w adresie URL strony docelowej albo z cookie _epik w twojej domenie. Poradnik API Pinterest zaleca przekazywanie wartości cookie _epik, bo działa ono nadal, gdy parametru URL brakuje lub został usunięty, co daje lepsze pokrycie.

ROASaurus odczytuje oba na stronie twojego sklepu, używając parametru URL, gdy nowe kliknięcie go przynosi, a w innym przypadku cookie. Zapisuje click id przy odwiedzającym i wysyła je w polu click_id każdego zdarzenia server-side, w tym zakupu. Wizyty z epik są liczone jako wizyty z Pinterest w raportach atrybucji ROASaurus.

POST https://api.pinterest.com/v5/ad_accounts/549755885175/events

{
  "data": [{
    "event_name": "checkout",
    "action_source": "web",
    "event_time": 1793016000,
    "event_id": "order-5512345678901",
    "event_source_url": "https://example-store.com/checkouts/…/thank-you",
    "user_data": {
      "em": ["a3f1…9c2e"],
      "ph": ["7b40…11d8"],
      "external_id": ["e05c…4a7f"],
      "client_ip_address": "203.0.113.24",
      "client_user_agent": "Mozilla/5.0 (iPhone; …)",
      "click_id": "dj0yJnU9…"
    },
    "custom_data": {
      "currency": "USD",
      "value": "84",
      "order_id": "5512345678901",
      "content_ids": ["44123456789"],
      "contents": [{ "id": "44123456789", "quantity": 2, "item_price": "42" }],
      "num_items": 2
    }
  }]
}

Jak działa deduplikacja z Pinterest Tag?

Jeśli Tag i API zgłaszają zakup, Pinterest otrzymuje dwa zdarzenia dla jednego zamówienia. Aby potraktować je jako jedno, potrzebuje tego samego id po obu stronach: event id w Tag musi zgadzać się z event_id w zdarzeniu server-side. Pinterest zachowuje pierwsze zdarzenie, które otrzyma, i usuwa duplikaty, które nadejdą w ciągu 48 godzin.

ROASaurus buduje id zakupu z id zamówienia Shopify. Zakup z zamówienia 5512345678901 ma event id order-5512345678901, zarówno w Tag uruchamianym w checkoucie, jak i w zdarzeniu server-side.

Wszystkie pięć zdarzeń jest deduplikowanych

Każde zdarzenie zakupowe w ROASaurus ma jedno event id, którego używa Tag w przeglądarce i zdarzenie z serwera. Tag używa własnych nazw Pinterest dla tych samych zdarzeń: pagevisit, viewcontent, addtocart, initiatecheckout i checkout, które odpowiadają page_visit, view_content, add_to_cart, initiate_checkout i checkout w API. Gdy działają oba, Pinterest zachowuje więc jedną kopię każdej wizyty na stronie, wyświetlenia produktu, dodania do koszyka, rozpoczęcia checkoutu i zakupu.

Możesz to uruchomić na dwa sposoby:

• Tag i Conversions API razem. Tag dodaje sygnały z przeglądarki, serwer uzupełnia to, czego Tag nie wychwycił, a Pinterest scala kopie.
• Uruchom API bez Tag. Zostaw puste Tag ID albo wyłącz Also load the browser tag. Każde zdarzenie jest wtedy wysyłane raz, tylko z serwera.

Artykuł pomocy o podwójnym liczeniu opisuje te same kontrole dla pozostałych platform reklamowych.

Jak przetestować Pinterest Conversions API?

API ma flagę testową. Żądania wysłane z test=true trafiają do piaskownicy: Pinterest traktuje je jako dane testowe i nie wykorzystuje ich do raportowania ani optymalizacji.

1. Włącz tryb testowy

   W ROASaurus edytuj piksel Pinterest w Tracking & platforms i zaznacz Test mode (events show under Test events, max 20). Każde zdarzenie server-side jest wtedy wysyłane z test=true. Pinterest przetwarza najwyżej 20 zdarzeń testowych na partię.

2. Złóż zamówienie testowe

   Wejdź do swojego sklepu, wyświetl produkt, dodaj go do koszyka i złóż zamówienie.

3. Przeczytaj wynik

   Otwórz Event log. Pinterest może odpowiedzieć HTTP 200, mimo że jedno zdarzenie w żądaniu się nie powiodło, więc ROASaurus sprawdza status każdego zdarzenia i pokazuje tam błędy.

4. Wyłącz tryb testowy

   Odznacz tryb testowy, żeby zdarzenia liczyły się w raportowaniu i optymalizacji.

5. Sprawdź Events Overview

   W Pinterest Ads Manager otwórz stronę Events Overview. Pokazuje ona zdarzenia, które docierają, oraz zdeduplikowane konwersje. Pinterest zaleca dążenie do Good Event Quality Score.

Jak skonfigurować Pinterest Conversions API w Shopify z ROASaurus

Potrzebujesz sklepu Shopify z aplikacją ROASaurus i dostępu do Pinterest Ads Manager. Strona integracji z Pinterest wymienia wszystkie pola, które wysyła ROASaurus.

1. Połącz swój sklep Shopify

   Przejdź do Add a store › Shopify, kliknij Install app i włącz osadzenie aplikacji ROASaurus w edytorze motywu. Przechwytuje ona epik i cookie _epik na każdej stronie. Poradnik konfiguracji Shopify pokazuje każdy krok.

2. Utwórz token dostępu do konwersji

   W Pinterest Ads Manager przejdź do Conversions i utwórz token dostępu do konwersji. Zanotuj ID swojego konta reklamowego.

3. Dodaj piksel Pinterest w ROASaurus

   Przejdź do Tracking & platforms, kliknij Add pixel na karcie Pinterest i wypełnij Ad account ID oraz Conversion access token.

4. Dodaj swój Tag ID

   Aby deduplikować zdarzenia z Tag, wypełnij Pinterest Tag ID i zostaw zaznaczone Also load the browser tag. Bez Tag ID ROASaurus wysyła tylko zdarzenia server-side i nie ładuje Tag.

5. Dodaj piksel checkoutu

   W Shopify admin › Settings › Customer events dodaj własny piksel o nazwie ROASaurus i wklej fragment kodu ze strony Tracking & platforms. Uruchamia on zdarzenie checkout z Tag w checkoucie Shopify, z order id jako event_id.

6. Wybierz zdarzenia server-side, potem przetestuj

   Wybierz zdarzenia server-side, których chcesz, i przetestuj w trybie testowym, zanim uruchomisz to na żywo.

Gdy Respect visitor consent jest włączone, co jest ustawieniem domyślnym, ROASaurus przestrzega wyboru kupującego w banerze cookie Shopify. Gdy kupujący odrzuci marketingowe cookie, ROASaurus nie ładuje dla niego Pinterest Tag, nie ustawia visitor id, więc jego kliknięcia nie są z nim powiązane, i nie wysyła jego zdarzeń przeglądania do Pinterest. Jego opłacone zamówienie jest nadal wysyłane z serwera do Conversions API, z zahashowanymi danymi zamówienia oraz adresem IP i user agent z zamówienia, ale bez click id. Poradnik o zgodach i prywatności wyjaśnia, co jest zapisywane i wysyłane.

Połącz swoje konto reklamowe Pinterest w Setup › Ad spend, a ROASaurus będzie co godzinę pobierać wydatki kampanii, więc zobaczysz ROAS z Pinterest i zysk po reklamach w analityce zysku. Poradnik TikTok Events API opisuje tę samą konfigurację dla TikTok, gdzie deduplikowane jest każde zdarzenie wysyłane obiema drogami.

Źródła

1. Pinterest Developers: Track conversion events in the API
2. Pinterest Business help: The Pinterest Conversions API
3. Pinterest Developers: Track conversions with Pinterest Tag

W ROASaurus

• Integracja z Pinterest
• Server-side tracking w ROASaurus
• Pomoc: zapobieganie podwójnemu liczeniu

Czytaj dalej