Conversions API dla WooCommerce, bez wtyczek, które się psują
Użytkownicy WooCommerce piszą wprost: „raportuje złą liczbę zakupów, czasem dwa razy tyle, a czasem jeszcze więcej” (wątek na r/woocommerce). Zwykle to dwie wtyczki, które wysyłają ten sam zakup. Basketly czyta zakup z zamówienia przez API sklepu i wysyła go do Mety z serwera, więc nie dokłada kolejnej wtyczki od Pixela.
Demo ma przykładowe dane; login przychodzi na Twój e-mail.
Skąd bierze się dubel zakupu
Pixel w przeglądarce i wysyłka z serwera to dwie drogi tego samego zakupu. Meta policzy go raz tylko wtedy, gdy oba zdarzenia mają ten sam identyfikator. W sklepie z kilkoma narzędziami, które wysyłają zakup (na przykład dwie wtyczki albo wtyczka i kreator zamówień), łatwo o trzy drogi i nikt nie wie, która co robi. Użytkownik jednego z wątków pisał o „6 zakupach przy 2 prawdziwych zamówieniach”.
Co robi Basketly w WooCommerce
Podajesz adres sklepu i klucz REST API. Resztę robi panel, a Ty widzisz każdy zakup i jego wysyłkę.
- Zapisanie klucza sprawdza go odczytem jednego zamówienia, zakłada webhooki sklepu (zamówienia i produkty, każdy z własnym sekretem) i kolejkuje odczyty. Webhook jest przyjęty tylko z poprawnym podpisem.
- Zamówienia zmienione od ostatniego odczytu wracają co 15 minut, więc nic nie wisi na jednym powiadomieniu.
- Opłacone, nieanulowane zamówienie staje się zakupem: wartość, waluta, produkty z pozycji, e-mail, telefon (haszowane przed wysyłką), IP i przeglądarka kupującego z kasy. Anulowane, zwrócone, nieudane i usunięte nie są wysyłane.
- Każdy zakup jest najpierw zapisany, a potem wysyłany z ponawianiem. Gdy Meta ma awarię, zakup czeka, a nie ginie.
- Produkty z WooCommerce (nazwa, opis, cena, zdjęcie, stan, marka, GTIN z pól wtyczek GTIN) trafiają do ekranu Produkty z diagnozą pod Google Merchant Center i katalog Mety, a stamtąd do poprawionego feedu.
- Klucz jest zapisany w postaci zaszyfrowanej i nigdy nie jest pokazywany ponownie.
Podłączenie WooCommerce w 4 krokach
Zajmuje kilka minut. Nie potrzebujesz programisty, ale w sklepie wkleisz krótki fragment kodu z instrukcji.
Utwórz klucz REST API w WooCommerce
W panelu WordPressa utwórz klucz REST API WooCommerce i zapisz Consumer key (ck_…) oraz Consumer secret (cs_…).
Dodaj sklep w panelu
W Basketly otwórz Integracje → Źródła danych → Dodaj źródło, wybierz WooCommerce i podaj nazwę oraz adres sklepu. Z menu źródła otwórz połączenie z API, wpisz adres WordPressa i klucze, zaznacz statusy kupione i potwierdź podstawę prawną przekazywania danych.
Podłącz Metę i wklej kod z instrukcji
Zaloguj się kontem Meta, wybierz zbiór danych (Pixel) i zostaw przepływ zakupów ze sklepu do Mety. Instrukcja podłączenia pokazuje skrypt dla sklepu i fragment PHP zapisujący identyfikator w zamówieniu.
Sprawdź pierwszy zakup
Kliknij „Pobierz teraz”, wyślij Zdarzenie testowe z kodem z Events Managera, a po pierwszych zamówieniach zajrzyj do Bilansu zakupów.
Przelew, płatność przy odbiorze i statusy
Zamówienie z płatnością online ma datę płatności i jest kupione od razu. Przelew bankowy zwykle czeka w statusie „w oczekiwaniu”, a płatność przy odbiorze dostaje datę płatności po zrealizowaniu zamówienia. Przy podłączeniu zaznaczasz statusy, które liczą się jako kupione (po nazwach technicznych, na przykład on-hold). Anulowane, zwrócone, nieudane i usunięte zamówienia nigdy nie stają się zakupem. Pamiętaj o limicie Mety: zakup starszy niż 7 dni nie zostanie przyjęty.
Połączenie zakupu z wizytą
Sam odczyt zamówienia nie wie, skąd przyszedł kupujący. Instrukcja podłączenia dodaje do sklepu fragment kodu, który zapisuje identyfikator skryptu Basketly w zamówieniu (ciasteczko i fragment PHP, w kasie klasycznej i blokowej). Dzięki temu zakup wysyłany do Mety niesie to, co skrypt widział podczas wizyty, ale tylko po zgodzie kupującego, bo skrypt działa dopiero wtedy.
Jak sprawdzić, że to działa
- Zdarzenie testowe: jednym kliknięciem wysyłasz najnowszy zakup ze sklepu z kodem testowym z Events Managera i widzisz go w zakładce Test Events.
- Bilans zakupów: zamówienia sklepu obok zakupów przyjętych przez Metę, dzień po dniu, z najczęstszymi powodami błędów. Dubel w Pixelu zobaczysz w Events Managerze jako więcej zakupów niż zamówień.
- Autodiagnostyka: porównuje statystyki zbioru danych w Mecie z tym, co naprawdę wysłaliśmy, i podpowiada, co poprawić.
- Zamówienia: przy każdym zamówieniu widać, czy zakup został przyjęty, nie przeszedł, czy czeka.
Czego to nie zrobi
- Nie naprawia ani nie wyłącza innych wtyczek. Jeśli wtyczka też wysyła zakup z serwera, masz dwie serwerowe drogi tego samego zakupu: zostaw jedną albo zadbaj o ten sam identyfikator zdarzenia i sprawdź wynik w Events Managerze.
- Nie zastępuje Pixela w przeglądarce: zdarzenia takie jak oglądanie produktu czy dodanie do koszyka zostają po stronie sklepu. To druga, niezależna droga dla zakupów.
- Bez skryptu Basketly w sklepie i zgody kupującego Meta nie dostanie identyfikatora kliknięcia reklamy, więc przypisanie zakupu do reklamy bywa słabsze.
- Nie wyrówna liczb Mety i sklepu: Meta liczy zakupy po swoich oknach atrybucji. Pokazujemy obie liczby obok siebie.
- Nie wyśle zakupu starszego niż 7 dni i nie działa bez potwierdzonej podstawy prawnej sklepu.
Nie zastępuje Pixela w przeglądarce. Zakupy wysyła z zamówienia, niezależnie od przeglądarki. Co zrobić z wtyczką, zależy od tego, co dziś wysyła: sprawdź w Events Managerze, czy zakupy się nie dublują, i zostaw jedną serwerową drogę zakupu.
Najczęściej ten sam zakup przychodzi dwiema drogami bez wspólnego identyfikatora zdarzenia. Bilans zakupów pokazuje zamówienia sklepu obok zakupów przyjętych przez Metę, a Autodiagnostyka porównuje statystyki zbioru danych z tym, co wysłaliśmy.
Tak, jeśli zamówienie ma datę płatności albo status, który zaznaczysz jako kupiony. Zakup pójdzie po takiej zmianie, pod warunkiem że od zamówienia nie minęło 7 dni.
Pierwszy odczyt sięga 7 dni wstecz, bo starszych zakupów Meta nie przyjmie. Historia z 24 miesięcy wczytuje się raz do Zamówień i Klientów, ale nie jest wysyłana do Mety.
Plan darmowy obejmuje do 100 zamówień miesięcznie, bez karty i bez limitu czasu. Limit liczy zamówienia, nie wysyłki do platform. Pozostałe plany są w cenniku.
Zobacz też
- Meta Conversions APIOpłacone zamówienia ze sklepu wysyłane do Mety z serwera, z kolejką, która nie gubi zakupów, i wynikiem każdej wysyłki.Czytaj
- AutodiagnostykaJedno sprawdzenie całej konfiguracji: sklep, wysyłka zakupów do Mety, logowania, zadania w tle i automatyzacje, z linkiem do poprawki przy każdym problemie.Czytaj
- Basketly a StapeStape (serwerowy GTM, bramka CAPI) obok Basketly (zakupy z zamówień sklepu): tabela, ceny ze strony Stape z datą, kiedy co wybrać.Czytaj
- Conversions API (CAPI)Wysyłka zdarzeń, np. zakupów, do Mety z serwera sklepu zamiast z przeglądarki klienta.Czytaj
- Deduplikacja zdarzeń Pixela i Conversions API: event_id, event_name i okno 48 godzinJak Meta łączy to samo zdarzenie z Pixela i z Conversions API: event_id, event_name, okno 48 godzin, metoda fbp, typowe błędy i sprawdzenie w Menedżerze zdarzeń.Czytaj
- Bilans zakupów: jak sprawdzić, czy zamówienia ze sklepu naprawdę docierają do Mety i innych platformJak czytać bilans zakupów dzień po dniu: zamówienia w sklepie, zakupy przyjęte przez Basketly i wysyłki do Mety oraz innych platform. Co znaczy każda różnica.Czytaj
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