Przejdź do treści
Konwersje i integracje

Integracje sklepu: od czego zacząć, żeby zamówienia, reklamy i katalog działały razem

Co połączyć najpierw w sklepie na Shoperze: API Shopera, konto Meta i odbiorca, przepływ zakupów, skrypt po zgodzie, feedy, potem inne platformy. Stany i ograniczenia.

Opublikowano: Zaktualizowano: 8 min czytania
Ilustracja: siatka kafelków, z których część świeci turkusem i jest połączona liniami
Spis treści
  1. Co pokazuje strona Integracje?
  2. Od czego zacząć w sklepie na Shoperze?
  3. Co połączyć w drugiej kolejności?
  4. Kiedy dodać skrypt w sklepie i feedy?
  5. Co z GA4, TikTokiem, Pinterestem i Klaviyo?
  6. Jak to wygląda w Basketly?
  7. Ograniczenia
  8. Następny krok

Integracje sklepu to wszystkie miejsca, z którymi łączy się sklep: skąd przychodzą zamówienia, gdzie się reklamujesz, dokąd idzie katalog produktów i gdzie mierzysz wyniki. Każde z nich da się podłączyć osobno, ale kolejność ma znaczenie. Zły start kończy się tym, że Meta dostaje zakupy bez produktów albo feed ma identyfikatory, których nie ma w zakupach. Poniżej: jak czytać stronę Integracje i w jakiej kolejności łączyć sklep na Shoperze.

Co pokazuje strona Integracje?

Strona Integracje to katalog wszystkich połączeń sklepu podzielony na sześć kategorii: gdzie sprzedajesz, gdzie się reklamujesz, dokąd idzie katalog produktów, analityka i zgody, marketing oraz dla programistów. Każdy kafelek mówi, co daje, w jakim jest stanie i ile połączeń ma organizacja, a przycisk otwiera miejsce, w którym się nim zarządza.

Stan jest liczony z rekordów, które już istnieją, a nie z deklaracji:

StanCo znaczyPrzykład
PołączoneCo znaczyjest co najmniej jedno działające połączeniePrzykładźródło Shoper, aktywny odbiorca Meta, feed
BłądCo znaczyktóreś połączenie zgłasza problemPrzykładbłąd połączenia ze Shoperem, wygasłe logowanie Mety, odrzucony klucz
NiepołączoneCo znaczyintegracja istnieje, ale jej nie używaszPrzykładbrak konta GA4
NiedostępneCo znaczyserwer nie ma jeszcze ustawień potrzebnych do logowaniaPrzykładGoogle Ads bez klucza deweloperskiego na serwerze
W planachCo znaczyintegracja nie jest jeszcze zbudowanaPrzykład—

Dwa ostatnie wiersze są ważne. Kafelek „Niedostępne” ani „W planach” nigdy nie pokaże stanu „Połączone”, nawet jeśli coś podobnego masz podłączone inną drogą. Lepiej, żebyś wiedział, czego jeszcze nie ma, niż żebyś zakładał, że działa.

Od czego zacząć w sklepie na Shoperze?

Zacznij od sklepu, bo z niego pochodzą wszystkie dane: zamówienia, kupujący i produkty. Połączenie z API Shopera pobiera zamówienia, zakłada w sklepie webhook, żeby zamówienia przychodziły od razu, i co 15 minut sprawdza zmiany statusów, bo Shoper wysyła każdy webhook tylko raz.

Przy połączeniu ustawiasz cztery rzeczy:

  1. Użytkownik API. W Shoperze zakładasz administratora z typem „Dostęp do API” i uprawnieniami do zamówień, produktów, kategorii, producentów, walut i webhooków. Hasło jest przechowywane zaszyfrowane.
  2. Statusy liczone jako zakup. Zamówienia oznaczone w Shoperze jako opłacone liczą się zawsze. Dopisz numery statusów, które też są sprzedażą, np. za pobraniem.
  3. Identyfikator produktu w katalogu Mety: ID produktu, ID wariantu, kod (SKU) albo EAN. Musi być taki sam jak w feedzie, który trafia do katalogu, inaczej reklamy katalogowe nie połączą zakupu z produktem.
  4. Podstawa prawna przekazywania danych zamówień (e-mail, telefon) do Mety, potwierdzana przez Ciebie.

Po połączeniu w tle pobierają się zamówienia z ostatnich 7 dni i wszystkie produkty, a raz na połączenie także historia zamówień z 24 miesięcy (bez wysyłki do Mety). Kupujący trafiają do Klientów, zamówienia na stronę Zamówienia. Co z tymi liczbami zrobić, opisujemy w tekście o zamówieniach, przychodzie i kupujących. Jak działa sam zakup wysyłany z serwera, wyjaśnia artykuł o Shoperze i Meta Conversions API.

Co połączyć w drugiej kolejności?

W drugiej kolejności połącz Metę, bo to tam idą zakupy i stamtąd przychodzą wydatki na reklamy. Potrzebne są trzy elementy: logowanie do Mety, odbiorca danych (Pixel, czyli zbiór danych w Menedżerze zdarzeń) i przepływ, który mówi, że status purchase ze sklepu ma iść do tego odbiorcy jako Purchase.

  • Logowanie do Mety (kafelek „Meta (Facebook i Instagram)”) daje dostęp do kont reklamowych, kampanii, kreacji i wydatków. Wydatki pobierają się same dla kont reklamowych, których używają Twoi odbiorcy.
  • Odbiorca (kafelek „Meta — API konwersji”) to Pixel, do którego wysyłamy zakupy. Na start możesz ustawić tryb testowy z kodem z Menedżera zdarzeń, ale pamiętaj, żeby go potem wyłączyć.
  • Przepływ tworzysz na stronie Konwersje. Bez niego zakupy zostają w Basketly i nie idą do Mety.

Co to jest Conversions API i czego po nim oczekiwać, opisujemy w tekście Meta Conversions API: co to jest.

Kiedy dodać skrypt w sklepie i feedy?

Skrypt w sklepie dodaj, gdy zakupy już płyną do Mety. Skrypt nic nie robi, dopóki baner zgód nie wywoła zgody; potem zbiera identyfikatory kliknięć reklam (fbp, fbc) oraz oglądania, koszyki i rozpoczęte zamówienia do statystyk produktów, bez danych osobowych. Feedy dodaj zaraz potem, bo dopiero zgodny katalog pozwala reklamom katalogowym połączyć zakup z produktem.

Skrypt nie potwierdza zakupów. Robi to wyłącznie serwer, bo publiczny klucz skryptu zna każdy, kto otworzy stronę.

Feedy znajdziesz w menu Praca → Feedy. Feed może pochodzić z adresu, z wgranego pliku albo z produktów Shopera; Basketly poprawia produkty, przepisuje je Twoimi regułami i wystawia pod własnym adresem dla Google Merchant Center, katalogu Mety i porównywarek. W Integracjach widzisz to jako trzy kafelki w kategorii „Dokąd idzie katalog produktów”, wszystkie liczone z liczby feedów.

Co z GA4, TikTokiem, Pinterestem i Klaviyo?

Te cztery integracje łączysz kluczem: wpisujesz identyfikatory i klucz, a Basketly sprawdza go u dostawcy tam, gdzie dostawca na to pozwala. Klucz jest zaszyfrowany, nie wraca do przeglądarki i nie zobaczysz go ponownie. Każdej z nich połączysz najwyżej 5 kont. Każda z nich dostaje zakupy po włączeniu „Wysyłaj zakupy” w Konwersjach. TikTok, Pinterest i Klaviyo mają też osobny przełącznik „Czytaj wyniki kampanii”: po jego włączeniu Basketly co 6 godzin czyta ich wyniki (TikTok i Pinterest — wydatki i konwersje kampanii, grup reklam i reklam do Kampanii i Raportów; Klaviyo — przychód kampanii i flow e-mailowych do wiersza e-mail w tabeli Kanały). Token bez uprawnienia do raportów zostaje odrzucony z czytelnym powodem.

IntegracjaCo wpisujeszJak sprawdzamyCo robi dziś
Google Analytics 4Co wpisujeszidentyfikator pomiaru G-…, klucz Measurement ProtocolJak sprawdzamynie da się z góry (zapis „niesprawdzone”)Co robi dziśdostaje zakupy z serwera po włączeniu „Wysyłaj zakupy”
TikTokCo wpisujeszID konta reklamowego, kod piksela, tokenJak sprawdzamylista pikseli kontaCo robi dziśdostaje zakupy (CompletePayment) po włączeniu „Wysyłaj zakupy”; po włączeniu „Czytaj wyniki kampanii” podaje wyniki kampanii
PinterestCo wpisujeszID konta reklamowego, tokenJak sprawdzamyodczyt konta reklamowegoCo robi dziśdostaje zakupy (checkout, Conversions API) po włączeniu „Wysyłaj zakupy”; po włączeniu „Czytaj wyniki kampanii” podaje wyniki kampanii
KlaviyoCo wpisujeszprywatny klucz APIJak sprawdzamyodczyt kontaCo robi dziśdostaje zakupy (Placed Order, tylko z e-mailem) i segmenty jako listy, bez zmiany zgód marketingowych; po włączeniu „Czytaj wyniki kampanii” podaje przychód z e-maili

Przy każdym połączeniu widać jego identyfikatory, stan (działa, błąd z powodem podanym przez dostawcę albo zapisane, niesprawdzone) i datę ostatniego sprawdzenia. „Sprawdź ponownie” powtarza test, „Odłącz” usuwa połączenie. Jak włączyć wysyłkę do GA4 i TikToka i co dokładnie dostają, opisujemy w tekście o zakupach do GA4 i TikToka z serwera.

Jak to wygląda w Basketly?

W Basketly Integracje są w menu Konfiguracja → Integracje. Pierwsza zakładka, Przegląd, to katalog z kafelkami. Kolejne zakładki to Źródła danych (Shoper, IdoSell, BaseLinker, WooCommerce, Shopify, Arkusz Google), Zbiory danych Meta i Połączone konta (logowania Google i Meta, konta SMS). „Połącz” na kafelku od razu otwiera okno tej platformy, np. formularz sklepu albo logowanie, a kafelki katalogu produktów prowadzą do Feedów.

Kto co może:

  • oglądać Integracje może każda rola z dostępem do Połączeń,
  • łączyć, zmieniać i odłączać integracje może osoba z prawem edycji Połączeń (domyślnie właściciel i administrator),
  • włączyć „Wysyłaj zakupy” może osoba z prawem edycji Konwersji.

Nowa organizacja ma też stronę Pierwsze kroki: listę kroków liczoną z tego, co już istnieje (sklep, odbiorca Meta, przepływ zakupów, feed, odczytane kampanie Meta, inne platformy), z przyciskiem prowadzącym dokładnie tam, gdzie dany krok się wykonuje. Dopóki wymagane kroki nie są zrobione, strona jest na górze menu z liczbą pozostałych kroków.

Proponowana kolejność dla sklepu na Shoperze, w jednym miejscu:

  1. Źródło Shoper z połączeniem API Shopera.
  2. Logowanie do Mety i odbiorca.
  3. Przepływ purchase → Purchase na stronie Konwersje.
  4. Skrypt w sklepie wywoływany po zgodzie.
  5. Feed produktów i jego adres w Merchant Center oraz katalogu Mety.
  6. GA4, TikTok, Pinterest, Klaviyo, Google Ads i Microsoft Ads z włączoną wysyłką zakupów.

Po każdym kroku zajrzyj do bilansu zakupów, a na koniec do mapy połączeń, która pokazuje wszystkie te elementy na jednym płótnie ze stanem każdego połączenia.

Ograniczenia

  • Sklepy łączone przez API to Shoper, IdoSell, BaseLinker, WooCommerce i Shopify. Inny sklep może wysyłać opłacone zamówienia przez źródło sklepu z własnego serwera.
  • Google Ads i Microsoft Ads łączysz logowaniem i wyborem konta oraz konwersji. Dostają tylko zakupy z kliknięcia ich reklam (identyfikator kliknięcia odczytany przez skrypt po zgodzie), a Google przy konwersjach rozszerzonych także dopasowane po e-mailu; ich kampanie i wydatki pokazują Kampanie (karta każdej platformy) i tabela Kanały w Raportach, każda platforma według własnego raportu. Kafelek działa, gdy administrator serwera ustawi ich klucze deweloperskie.
  • Klaviyo nie zapisuje nikogo na newsletter. Basketly tylko dodaje profile do listy i wysyła zdarzenia zakupów; zgody marketingowe zostają, jakie były.
  • GA4 nie potwierdza klucza z góry, więc błąd klucza zobaczysz dopiero przy wysyłce.
  • Stan „Połączone” to nie gwarancja, że dane płyną. Mówi, że połączenie istnieje i nie zgłasza błędu. Czy zakupy docierają, mówi bilans zakupów.
  • Przyjęcie zakupu przez platformę nie dowodzi optymalizacji kampanii ani przypisania zakupu do reklamy.

Następny krok

Otwórz Integracje → Przegląd i zobacz, które kafelki z kategorii „Gdzie sprzedajesz” i „Gdzie się reklamujesz” są już połączone. Jeśli Shoper jest niepołączony, zacznij od niego. Pełny opis wszystkich połączeń znajdziesz na stronie Integracje.

O autorze

Aleksander

Założyciel Basketly.io, BooksyAudit.pl i SMSPortal.app

Założył Basketly.io, BooksyAudit.pl i SMSPortal.app. W bazie wiedzy opisuje, jak przekazywać do Meta zakupy ze sklepu, jak dbać o katalog produktów i jak liczyć koszt zakupu z reklam.

Wszystkie artykuły autora

Najczęściej zadawane pytania

Co znaczy stan „W planach” albo „Niedostępne” przy integracji?

„W planach” znaczy, że tej integracji jeszcze nie zbudowaliśmy. „Niedostępne” — że serwer nie ma jeszcze ustawień potrzebnych do logowania w tej platformie; kafelek mówi to wprost i proponuje „Napisz do nas”. Żaden z nich nigdy nie pokaże stanu „Połączone”, więc nie musisz się zastanawiać, czy coś działa w tle.

Czy po połączeniu Klaviyo Basketly wysyła tam segmenty?

Tak. W Klienci → Segmenty właściciel albo administrator wybiera „Wyślij do Klaviyo”, listę (albo nową, nazwaną jak segment) i potwierdza podstawę prawną. Co noc Basketly dopisuje nowe osoby po e-mailu i usuwa te, które wypadły z segmentu. Nikogo nie zapisuje na newsletter: zgody marketingowe w Klaviyo się nie zmieniają. Zakupy mogą też trafiać do Klaviyo jako zdarzenia Placed Order.

Czy Pinterest dostaje zakupy ze sklepu?

Tak, po włączeniu „Wysyłaj zakupy” w Konwersjach. Pinterest łączysz kluczem: ID konta reklamowego i tokenem, który Basketly sprawdza, odczytując to konto. Zakup idzie przez Pinterest Conversions API jako checkout.

Czy mogę zobaczyć zapisany klucz integracji?

Nie. Klucz jest zaszyfrowany i nie wraca do przeglądarki. Przy edycji puste pole zostawia zapisany klucz, a nowy wpisany klucz go zastępuje.

Ile kont jednej integracji mogę połączyć?

Najwyżej 5 kont każdej integracji łączonej kluczem (GA4, TikTok, Pinterest, Klaviyo) w jednej organizacji, np. kilka usług GA4 albo pikseli TikToka.

Zacznij w mniej niż 5 minut

Połącz sklep i Metę i zobacz, ile zakupów naprawdę dociera.

  • Za darmo do 100 zamówień miesięcznie
  • Bez programisty
  • Bilans zakupów i autodiagnostyka