Przejdź do treści
Integracja: WooCommerce

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.

  1. 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_…).

  2. 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.

  3. 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.

  4. 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.
Integracja: WooCommerce

Najczęstsze pytania

Nie ma tu Twojego pytania? Napisz do nas

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.

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