Typowe problemy z integracją Samby

Spis treści

This post is also available in:

W tym artykule znajdziesz najczęstsze problemy, które możesz napotkać podczas integracji Samby. Pokażemy, jak dowiedzieć się, co jest nie tak w danym przypadku, a także jak rozwiązać problem.

Data Feeds

Dokumentację opartą na typie sklepu internetowego można znaleźć tutaj:

Nie udało się połączyć ze źródłem danych. Sprawdź ustawienia

W Ustawienia – Integracja – Integracja danych – Ustawienia połączenia połączyłeś źródła danych z Sambą, ale po wykonaniu ładowania danych pojawia się ten błąd.

Sprawdź, czy adresy URL kanałów są dostępne. Bez umożliwienia zewnętrznego dostępu do kanałów, Samba nie będzie w stanie uzyskać potrzebnych danych.

Najczęściej problemy są spowodowane błędem w formacie adresu URL feedu lub złym zakończeniem. (Samba obsługuje formaty CSV i XML.) Sprawdź więc, czy adresy URL Twoich feedów są zgodne z ustawieniami opisanymi w naszej dokumentacji.

Format danych

Jeśli adresy URL feedów są skonfigurowane prawidłowo, drugim najczęstszym problemem w linkowaniu są błędy w formacie poszczególnych informacji wewnątrz feedu.

Należy zatem sprawdzić, czy zapis danych jest prawidłowy i czy identyfikatory są spójne (tj. czy wszystkie kanały są ze sobą sparowane przy użyciu wybranych identyfikatorów):

users <– user_id –> orders <– order_id –> orderitems <– product_id –> products

Użycie znacznika VARIANT
- Każdy produkt może mieć nieograniczoną liczbę różnych wariantów. Ten tag zapewni, że klientowi nie będą na przykład polecane różne warianty tego samego produktu w tej samej reklamie.
- Szczegóły można znaleźć tutaj.
Cena zawiera podatek VAT i zaokrąglenia
- Ważne jest, aby wyświetlać zaokrąglone ceny w kanale PRICE i PRICE_BEFORE_DISCOUNT z już wliczonym podatkiem VAT, ponieważ w rezultacie ceny te będą wyświetlane klientowi.
PRICE_BEFORE_DISCOUNT
- Jest to oryginalna cena produktu przed rabatem, w tym podatek VAT. Zalecamy uwzględnienie tej informacji w kanale, aby umożliwić wyróżnienie rabatu.
Produkty w rekomendacjach
- Aby produkt mógł być wyświetlany w naszej rekomendacji, musi zawierać następujące parametry:

Pasujący adres URL / Obraz w wystarczającym rozmiarze i jakości / PRICE> 0 / STOCK> 0 / TITLE

Kategoryzacja
- Zalecamy umieszczanie produktów w kanale w poszczególnych kategoriach produktów.
BRAND
- Oznaczenie producenta (marki) produktu
OPIS
- Szczegółowy opis produktu (zwykły tekst bez znaczników HTML)

NAZWA PIERWSZA i NAZWA OSTATNIA
- - Ten parametr jest ważny dla określenia płci klienta i możliwości użycia tagu scalającego, aby się do niego zwrócić
E-MAIL
- - Wszystkie adresy e-mail w bazie danych powinny być prawidłowe. Jeśli masz zupełnie nową bazę danych e-mail, ważne jest, aby rozpocząć wysyłanie wiadomości e-mail ostrożnie i stopniowo. W razie potrzeby możemy zapewnić sprawdzenie bazy danych e-mail.
  - Więcej informacji można znaleźć tutaj.
REGISTRACJA
- Zalecamy uwzględnienie tego parametru w kanale, ponieważ dzięki tym informacjom można ustawić na przykład wyzwalacz powitalny w kampaniach Flow.
NEWSLETTER_FREQUENCY
- - W przypadku tego parametru ważne jest, aby sprawdzić, czy w bazie danych znajdują się zarówno subskrybowani, jak i niesubskrybowani klienci.
  - Zdecydowanie odradzamy przesyłanie wszystkich klientów do Samby z jedną wartością domyślną (np. wszyscy jako subskrybowani)
ZIP CODE
- Za pomocą tego parametru można pracować z różnymi lokalizacjami klientów w Sambie.

- Data utworzenia zamówienia
  - Samba obsługuje 3 różne statusy zamówień:
    - Zakończone
    - Stworzone
    - Anulowane
  - Jeśli nie wypełnisz statusu zamówienia, automatycznie przyjmuje się, że jest ono zakończone (status finished). Jeśli zamówienie ma status zakończone i nie ma atrybutu FINISHED_ON, wartość w CREATED_ON jest przyjmowana jako data zakończenia.
  - Tylko FINISHED_ON zamówienia są przetwarzane przez Samba.
- E-MAIL / CUSTOMER_ID
  - Jeśli Twoi klienci mogą tworzyć zamówienia bez rejestracji, dodaj element EMAIL do tego kanału zamiast CUSTOMER_ID, a jeśli jest dostępny, dodaj również PHONE i ZIP_CODE. Samba wykorzysta te dane do tworzenia klientów, do których można kierować kampanie.
- Dla parametru AMOUNT > 1, PRICE musi być podana jako łączna cena wszystkich jednostek przedmiotu

ZIP CODE
- Dzięki temu parametrowi można pracować z różnymi lokalizacjami klientów w Sambie.
PRICE
- - Ważne jest, aby podać cenę z wliczonym podatkiem VAT

Śledzenie klientów

Kolejnym częstym problemem są błędy w wdrożeniu SmartPoint Samby, który obsługuje śledzenie użytkowników w witrynie. Szczegółową dokumentację można znaleźć tutaj:

Jeśli SmartPoint lub którakolwiek z powiązanych z nim funkcji jest skonfigurowana nieprawidłowo, Samba wyświetli tę informację w Ustawieniach – Integracja – Śledzenie klienta.

Jeśli śledzenie nigdy nie było powiązane z Sambą, wyświetli się N/A. Jeśli jednak trackpoint działał poprawnie podczas korzystania z Samby, ale nastąpiła jakaś zmiana, która spowodowała awarię, Samba pokaże ostatnią datę kontaktu ze SmartPoint.

Jeśli w ustawieniach widzisz , że masz błąd w SmartPoint lub którejkolwiek z funkcji, musisz sprawdzić wywołania wszystkich metod JS dla określonych scenariuszy w swoim sklepie.

Sprawdź spójność z feedami danych (integralność referencyjna ID itp.) – Uważaj, aby na przykład identyfikator był wysyłany jako STRING (tj. „12345”, a nie 12345)

diffAnalytics.productId(productId)

Używaj tej metody, gdy nie można zagwarantować, że produkt zostanie rozpoznany przez jego adres URL

diffAnalytics.customerLoggedIn(customerId)

Ta metoda musi być wywoływana na każdej ładowanej stronie, gdy klient jest zalogowany. W przeciwnym razie w ogóle jej nie wywołuj (w szczególności nie wywołuj np. customerId = "1234" dla wszystkich niezalogowanych klientów itp.

diffAnalytics.cartInteraction(cartContent)

Kiedy wywołać tę metodę:

Kiedy dokonywana jest jakakolwiek zmiana w zawartości koszyka
Przy każdym przeładowaniu strony

Podczas wdrażania metody należy przetestować poprawność wywołania strony głównej, szczegółów produktu lub kategorii. Należy zwrócić uwagę na format w koszyku. Musi on być zgodny z dokumentacją (productId = string, amount = number).

Ważne jest, aby przetestować wywołanie tej metody zarówno dla zalogowanego, jak i niezalogowanego klienta!

onOrderPage Twój sklep internetowy powinien wywołać ten parametr na stronie tuż przed zakończeniem zamówienia. Oznacza to przed przekierowaniem do bramki płatności lub przed potwierdzeniem zamówienia opłaconego przelewem bankowym itp. Wywołanie onOrderPage jest zalecane, aby nie przegapić momentu opróżnienia koszyka, w przypadku gdy użytkownik nie wróci do sklepu z bramki płatności

diffAnalytics.order(orderInfo)

Ponownie, tutaj również należy zwrócić uwagę na format (productId = ciąg znaków, price = liczba) i wywołać metodę tylko w momencie realizacji zamówienia. Na przykład na stronie z podziękowaniem za zamówienie.

Rejestry DNS

Podobnie jak w poprzednich przypadkach, Samba pokaże ci, czy poprawnie skonfigurowałeś swoje rekordy DNS.

Ustawianie rekordów DNS można wykonać bezpośrednio w interfejsie administracyjnym hostingu. Jak skonfigurować rekordy DNS dla swojego hostingu znajdziesz tutaj.

SPF

Najczęstszym problemem związanym z konfiguracją rekordów DNS jest ich niewłaściwy format. Należy więc sprawdzić w ustawieniach, czy rekord został określony jako typ TXT.

Jednym z najczęstszych problemów, które mogą wystąpić podczas konfigurowania rekordu SPF, jest przekroczenie liczby wyszukiwań.

Dozwolone jest posiadanie maksymalnie 10 wyszukiwań.

Limit ten jest ustalony zgodnie z ogólnie przyjętą specyfikacją RFC.
Sprawdzenie liczby wyszukiwań w domenie można łatwo wykonać, na przykład za pomocą MxToolbox.
Jeśli limit ten zostanie przekroczony, Samba wyświetli informację, że rekord SPF nie został poprawnie utworzony, a wartość zostanie wyświetlona jako wartość żądana, niezależnie od aktualnego stanu rekordu SPF.

Inny problem może wystąpić, jeśli wprowadzisz więcej niż 1 rekord SPF na domenę.

Zgodnie ze specyfikacją, powinieneś mieć tylko 1 rekord SPF ustawiony dla swojej domeny, w przeciwnym razie istnieje ryzyko, że serwery pocztowe nie będą go obsługiwać. Jeśli masz już wiele rekordów SPF, połącz je w jeden rekord za pomocą „include”.

DKIM

Ten sam powszechny problem dotyczy rekordów DKIM co SPF, a jest nim nieprawidłowy format. Sprawdź więc, czy rekord jest poprawnie określony jako typ TXT.

Ważne jest, aby zachować dokładny format rekordów, których Samba wymaga. Zwróć szczególną uwagę na niechciane spacje, cudzysłowy itp. (możesz skopiować dokładny format bezpośrednio w Sambie).

Rekord MX

Należy pamiętać, że Samba nie wyświetla poprawnych ustawień rekordów MX

Jeśli nie masz jeszcze skonfigurowanego rekordu MX w domenie wysyłającej, musisz skonfigurować przekierowanie na serwer, na którym będziesz mógł otrzymywać odpowiedzi wysyłane na twoje newslettery. Niektórzy dostawcy poczty e-mail, tacy jak Seznam.cz, wymagają tego.

Możesz sprawdzić, czy masz poprawnie ustawiony rekord MX w swojej domenie za pomocą narzędzia MxToolBox.

Problem najczęściej pojawia się w przypadku korzystania z subdomeny. Bardzo często rekord MX jest ustawiony w domenie głównej, ale brakuje go w subdomenie. W takim przypadku należy ustawić rekord również na subdomenie.

Wskaźnik braku rekordu MX

Jednym z powszechnych wskaźników braku rekordu MX jest wzrost liczby miękkich odrzuceń w dystrybucji wiadomości e-mail

Połączenie z Facebookiem

Jednym z najczęstszych problemów, które mogą wystąpić podczas łączenia Samby z Facebookiem jest niedostępność konta reklamowego.

Gdy konto reklamowe powiązane z Business Manager nie jest dostępne, należy skontaktować się z administratorem w celu powiązania konta reklamowego z kontem biznesowym. Więcej informacji znajdziesz tutaj.

Zatwierdzenie warunków użytkowania w ustawieniach Facebooka

Facebook wymaga, aby wszyscy administratorzy danego konta Business Manager zatwierdzili warunki użytkowania

Rozłączenie

Jeśli chcesz rozłączyć się z Facebookiem lub masz jakiekolwiek problemy z połączeniem, po prostu kliknij Rozłącz w Sambie.

Jeśli nie możesz się rozłączyć, zalecamy sprawdzić stronę ustawień Facebooka (Ustawienia > Integracje biznesowe) https://www.facebook.com/settings?tab=business_tools&section=active, gdzie możesz ręcznie usunąć aplikację samba.ai, klikając Usuń.

Powiadomienia push

Wstaw skrypt o nazwie service worker, niezmieniony (ta sama zawartość, ta sama nazwa) do katalogu głównego domeny hostingowej, w której znajduje się Twój sklep internetowy.

Skrypt można pobrać bezpośrednio w aplikacji. Ustawienia > Rozszerzenia > Powiadomienia web push

Zwróć szczególną uwagę na to, czy Twoja domena powinna być wymieniona z „www”. Protokół http/https pomiń wpisując adres.
Zwróć uwagę na domenę, której używasz w skrypcie – www.domain.com to nie to samo co domain.com. Dlatego zalecamy użycie konsoli, aby zweryfikować, co jest zwracane jako wartość self.location.hostname i ustawić ją w warunku skryptu.
- Po prostu otwórz konsolę w swojej witrynie i wprowadź wspomnianą powyżej wartość. Konsola pokaże wtedy twoją domenę.