Przewodnik
Połącz swoją witrynę WooCommerce z Casa Signals
Zainstaluj łącznik Casa Signals WordPress, wygeneruj klucz API swojej witryny, włącz śledzenie i potwierdź, że zdarzenia WooCommerce docierają do Twojego pulpitu nawigacyjnego.
Zanim zaczniesz
- Konto Casa Signals.
- Sklep WooCommerce, w którym możesz zalogować się jako administrator WordPress.
Co będziesz mieć po zakończeniu
- W Casa Signals istnieje połączenie wtyczki WordPress z właściwą witryną.
- Klucz API Casa Signals jest zapisany w WordPress.
- Śledzenie zdarzeń jest włączone we wtyczce WordPress.
- Nowe zdarzenia WooCommerce zaczynają pojawiać się w analizach Casa Signals, osiach czasu klientów, raportach produktów i wyzwalaczach przepływu.
- Opcjonalne historyczne produkty, użytkownicy i zamówienia można importować bez uruchamiania automatyzacji na żywo.
Jak działa połączenie
Casa Signals łączy się z WooCommerce poprzez wtyczkę Customer Event Sync for Casa Signals WordPress. Wtyczka śledzi ważną aktywność WordPress i WooCommerce, kolejkuje zdarzenia w WordPressie i wysyła je do Casa Signals partiami w tle.
Połączenie jest uwierzytelniane za pomocą klucza API specyficznego dla witryny. Każda witryna Casa Signals ma swój własny klucz, więc klucz musi pochodzić z tego samego rekordu witryny, co domena WooCommerce, z którą się łączysz.
Śledzenie wymaga zgody. Samo zainstalowanie wtyczki nie wystarczy. Klucz API musi zostać zapisany, domena serwisu musi być poprawna, a opcja Włącz śledzenie zdarzeń musi być włączona.
- Istnieje witryna Casa Signals.
- Wtyczka WordPress jest zainstalowana i aktywna.
- .
- Śledzenie zdarzeń jest włączone.
- Ostatnia aktywność pojawia się w Casa Signals.
1. Dodaj witrynę WooCommerce w Casa Signals
Otwórz panel Casa Signals
Zaloguj się do Casa Signals i otwórz pulpit nawigacyjny. Jeżeli jest to pierwszy sklep na koncie, na panelu wyświetli się formularz Dodaj domenę.
Wpisz nazwę sklepu
Użyj nazwy, którą Twój zespół będzie rozpoznawał, na przykład Przykładowy sklep. Ta nazwa jest używana w całym panelu i może pojawić się w podglądzie SMS-ów, gdy nie jest aktywny żaden zatwierdzony identyfikator nadawcy.
Wprowadź domenę internetową
Wprowadź aktywną domenę skierowaną do klienta, na przykład example.com. Nie dołączaj ścieżki realizacji transakcji, ścieżki produktu, ścieżki wp-admin ani parametrów śledzenia.
Użyj tej samej domeny, której klienci używają do przeglądania i zakupów. Jeśli sklep przekierowuje z www na stronę inną niż www lub odwrotnie, użyj końcowej domeny publicznej, którą Casa Signals ma traktować jako sklep.
Zapisz domenę
Kliknij Dodaj domenę. Karta witryny pojawi się na pulpicie nawigacyjnym z linkami do Analytics, Klienci, Produkty, Transmisje, Przepływy i Ustawienia.
2. Wygeneruj klucz API wtyczki WordPress
Otwórz ustawienia witryny
W panelu Casa Signals otwórz kartę witryny sklepu WooCommerce i kliknij Ustawienia.
Znajdź panel wtyczki WordPress
W Ustawieniach znajdź sekcję Połączenie o nazwie Wtyczka WordPress. Panel ten pokazuje, czy sklep jest podłączony, pozwala wygenerować lub zregenerować klucz API oraz umożliwia pobranie wtyczki.
Wygeneruj klucz
Kliknij opcję Wygeneruj klucz. Casa Signals tworzy nowy klucz API dla tej witryny. Jeśli klucz już istnieje i klikniesz Regeneruj klucz, stary aktywny klucz dla tej witryny zostanie zastąpiony.
Skopiuj klucz
Kliknij Kopiuj i przygotuj klucz dla WordPress. Potraktuj to jak hasło. Każdy, kto posiada klucz, może przesyłać zdarzenia dla tej witryny Casa Signals.
- Skopiowany klucz pochodzi z tej samej witryny Casa Signals, co sklep WooCommerce.
- Stan witryny pokazuje Połączono lub widoczny jest klucz API.
- Użytkownik nie skopiował klucza z innej domeny.
3. Pobierz i zainstaluj wtyczkę WordPress
Pobierz konektor
W tym samym panelu wtyczki WordPress kliknij Pobierz wtyczkę. Plik nosi nazwę customer-event-sync-casa-signals.zip.
Prześlij go do WordPressa
W WordPressie przejdź do Wtyczki -> Dodaj nową wtyczkę -> Prześlij wtyczkę. Wybierz plik customer-event-sync-casa-signals.zip, a następnie kliknij Zainstaluj teraz.
Aktywuj wtyczkę
Po zainstalowaniu wtyczki przez WordPress kliknij Aktywuj wtyczkę. Nazwa wtyczki to Customer Event Sync for Casa Signals.
Otwórz ustawienia wtyczki
Na ekranie Wtyczki WordPress kliknij link Ustawienia w obszarze Customer Event Sync for Casa Signals.
4. Skonfiguruj wtyczkę w WordPressie
Wklej klucz API
W polu Klucz API wklej klucz skopiowany z Casa Signals. Jeśli klucz jest już zapisany, WordPress wyświetla zamaskowany symbol zastępczy, dzięki czemu prawdziwy klucz nie jest widoczny w formularzu ustawień.
Potwierdź domenę witryny
W domenie witryny wprowadź tę samą domenę, która została zapisana w Casa Signals. W ten sposób nadchodzące wydarzenia są łączone z powrotem do właściwej witryny.
Włącz śledzenie zdarzeń
Zaznacz opcję Włącz śledzenie zdarzeń. Wtyczka nie śledzi ani nie wysyła zdarzeń klientów, dopóki ta opcja nie zostanie włączona.
Zapisz zmiany
Kliknij Zapisz zmiany. Od tego momentu wtyczka może ustawiać własne pliki cookie dotyczące gości i sesji, lokalnie kolejkować zdarzenia klientów i sklepów oraz wysyłać je do Casa Signals w tle.
- Włącz śledzenie zdarzeń jest zaznaczone.
- Klucz API jest obecny.
- Domena witryny odpowiada witrynie Casa Signals.
- WooCommerce jest aktywny.
5. Przetestuj połączenie
Utwórz wydarzenie dla nowego klienta
Otwórz witrynę sklepową w prywatnym oknie przeglądarki lub w innej przeglądarce. Wyświetl produkt, dodaj go do koszyka, wyświetl koszyk, a następnie rozpocznij realizację transakcji.
Jeśli to możliwe, wpisz adres e-mail i numer telefonu przy kasie. Przepływy SMS-ów klientów wymagają numeru telefonu w przypadku wydarzenia, a przepływy wiadomości e-mail wymagają adresu e-mail.
Wróć do Casa Signals
Otwórz panel witryny w Casa Signals. Nowa aktywność może pojawić się w statystykach, osiach czasu klientów, analizach produktów i aktywności w witrynie na żywo.
Poczekaj na dostawę w tle
Wtyczka lokalnie kolejkuje zdarzenia i wysyła je za pomocą przetwarzania w tle WordPress. Krótkie opóźnienie jest normalne, zwłaszcza jeśli witryna ma mały ruch lub WP-Cron działa tylko podczas odwiedzania stron.
W razie potrzeby sprawdź panel debugowania WordPress
Jeśli zdarzenia się nie pojawią, wróć do ustawień wtyczki WordPress, włącz tryb debugowania, zapisz, wykonaj inną akcję w sklepie, a następnie sprawdź kolejkę śledzenia i ostatnią odpowiedź API w tle na stronie ustawień.
6. Opcjonalnie: import danych historycznych
Po uruchomieniu połączenia na żywo administratorzy WordPressa mogą otworzyć Narzędzia -> Import Casa Signals, aby zaimportować istniejący katalog, dane użytkownika i zamówienia.
Importy są zaprojektowane tak, aby były idempotentne, więc ponowne uruchomienie importu nie powinno powielać tych samych rekordów historycznych. Historyczne zdarzenia dotyczące zamówień są oznaczane jako zapasowe i nie powodują przepływu wiadomości SMS ani e-mail.
- Najpierw skonfiguruj klucz API.
- Najpierw włącz śledzenie zdarzeń.
- Uruchamiaj import produktów, użytkowników i zamówień, gdy sklep ma wystarczająco dużo czasu na ich przetworzenie.
- Nie używaj narzędzia do importowania jako testu zdarzeń na żywo, ponieważ zaimportowane zdarzenia celowo pomijają automatyzację.
Co Casa Signals rozpoczyna śledzenie
Po włączeniu wtyczka może śledzić wyświetlenia produktów, wyszukiwania produktów, wyświetlenia koszyka, zdarzenia dodania do koszyka, zdarzenia usunięcia z koszyka, zmiany ilości koszyka, rozpoczęcie realizacji transakcji, przechwytywanie danych kontaktowych przy kasie, aktualizacje adresów przy kasie, wybrane metody płatności i wysyłki, złożenie zamówienia, udane płatności, nieudane płatności, zwroty kosztów, anulowanie, aktywność kuponów, rejestracje kont, logowania, wylogowania, resetowanie haseł, aktualizacje konta, subskrypcje, przesłania formularzy, atrybucja i stan witryny.
Casa Signals wykorzystuje te zdarzenia do celów analitycznych, osi czasu klientów, raportowania produktów, transmisji, wyzwalaczy przepływu, kontroli pomijania i przypisywania odzyskanych przychodów.
Najlepsze praktyki po połączeniu
- Dokonaj prawdziwego zakupu testowego lub testu płatności w normalnym trybie testowym bramki płatności WooCommerce, jeśli jest dostępny.
- Zachowaj klucz API jako prywatny i wygeneruj go ponownie, jeśli został udostępniony poza Twoim zespołem.
- Sprawdź Analytics po pierwszym dniu, aby upewnić się, że nadeszły zdarzenia związane z produktem, koszykiem, realizacją transakcji i zamówieniem.
- Dodaj adres e-mail domeny głównej w Ustawieniach przed użyciem przepływu poczty e-mail lub emisji.
- Poproś o identyfikator nadawcy wiadomości SMS, jeśli chcesz, aby wiadomości SMS klientów zawierały nazwę Twojej marki zamiast domyślnego nadawcy.
- Utwórz przepływ porzucenia koszyka dopiero po wyświetleniu zdarzeń dodania do koszyka lub realizacji transakcji.
Rozwiązywanie problemów
Po konfiguracji w Sygnałach Casa nie pojawiają się żadne zdarzenia.
- Potwierdź opcję Włącz śledzenie zdarzeń w WordPressie.
- Potwierdź, że klucz API jest zapisany w WordPressie i pochodzi z właściwej witryny Casa Signals.
- Potwierdź, że pole domeny witryny w WordPress odpowiada domenie zapisanej w Casa Signals.
- Odwiedź witrynę sklepową i utwórz nowe wydarzenie po zapisaniu ustawień. Aktywność historyczna sprzed konfiguracji nie zostanie wyświetlona, chyba że zostanie zaimportowana.
- Upewnij się, że WP-Cron jest uruchomiony. Łącznik wysyła zdarzenia umieszczone w kolejce w partiach w tle.
Wtyczka jest zainstalowana, ale nie ma danych.
- Sama instalacja wtyczki nie umożliwia śledzenia. Otwórz ustawienia wtyczki na ekranie Wtyczki WordPress, wklej klucz API, wprowadź domenę witryny, zaznacz Włącz śledzenie zdarzeń i zapisz.
- Jeśli sklep korzysta z agresywnych zabezpieczeń, buforowania lub wtyczek wyłączających cron, zezwól na WordPress cron i wychodzące żądania HTTPS do casasignals.com.
Wydarzenia są opóźnione.
- Oczekuje się krótkiego opóźnienia, ponieważ wtyczka lokalnie kolejkuje zdarzenia i wysyła partie w tle.
- Jeśli zdarzenia nadal się utrzymują, włącz tryb debugowania i sprawdź liczbę kolejek śledzenia i ostatnią odpowiedź API w tle.
- Jeśli włączona jest opcja DISABLE_WP_CRON, skonfiguruj prawdziwe zadanie cron serwera dla cron WordPress.
Wydarzenia są wyświetlane w niewłaściwej witrynie.
- Klucz API WordPress prawdopodobnie pochodzi z innej witryny Casa Signals lub wartość domeny witryny nie jest zgodna z zamierzoną witryną.
- Wygeneruj nowy klucz z właściwej witryny w Ustawieniach Casa Signals, wklej go do WordPress, potwierdź domenę witryny i zapisz.
SMS-y klientów nie są wysyłane po połączeniu.
- Połączenie może działać, ale przepływ wiadomości SMS klienta wymaga również podania numeru telefonu klienta w przypadku zdarzenia wyzwalającego.
- Sprawdź, czy przepływ jest aktywny, czy dostępne są kredyty i czy nie jest blokowany, ponieważ płatność powiodła się w trakcie opóźnienia.
- Pamiętaj, że odbiorca, który zrezygnował z otrzymywania SMS-ów dla sklepu, zostanie pominięty.
Import został zakończony, ale nie uruchomiono żadnych automatyzacji.
- Tego się można spodziewać. Narzędzie do importowania oznacza zdarzenia historyczne jako uzupełnienie, a Casa Signals pomija wykonywanie przepływu i oznaczanie odzyskiwania dla zaimportowanych zdarzeń.
- Użyj nowej akcji na żywo w sklepie, aby przetestować automatyzację.
FAQ dla agentów wsparcia
Gdzie znajdę klucz API Casa Signals?
W Casa Signals otwórz sklep, przejdź do Ustawień, a następnie znajdź panel połączeń wtyczki WordPress. Kliknij opcję Wygeneruj klucz lub Wygeneruj klucz ponownie, a następnie Kopiuj.
Gdzie znajdują się ustawienia wtyczki WordPress?
W WordPressie przejdź do Wtyczek, znajdź Synchronizację zdarzeń klienta dla Casa Signals i kliknij Ustawienia.
Czy wtyczka automatycznie wysyła stare zamówienia?
Nie. Łącznik na żywo wysyła nowe zdarzenia po włączeniu śledzenia. Historyczne produkty, użytkownicy i zamówienia można importować z menu Narzędzia -> Import Casa Signals.
Czy importowanie starych zamówień spowoduje przepływ SMS-ów lub e-maili?
Nie. Zdarzenia importu są oznaczone jako zapasowe. Casa Signals pomija automatyzację przepływu i przypisywanie odzyskiwania w przypadku zapasowych zdarzeń.