Integracja TikTok Shop i katalogu Pinterest: instalacja i konfiguracja

Przegląd

Moduł łączy sklep PrestaShop 8 lub 9 z dwoma kanałami:

• TikTok Shop: tworzenie i aktualizacja ofert przez API Partner, wysyłka stanów i cen, import zamówień, wysyłka numerów przesyłek.
• Pinterest: feed katalogu TSV i opcjonalnie aktualizacje w czasie rzeczywistym przez API Catalogs.

W zestawie jest też feed CSV dla katalogów TikTok Ads. Moduł znajduje się w Katalog > TikTok & Pinterest. Zakładka Przegląd pokazuje listę startową z krokami do wykonania.

Instalacja

1. W Moduły > Menedżer modułów kliknij Prześlij moduł i wybierz plik ZIP.
2. Otwórz Katalog > TikTok & Pinterest.
3. W zakładce Ustawienia sprawdź język, walutę i kraj używane do cen (ceny są wysyłane z podatkiem tego kraju) oraz rozmiar zdjęć. TikTok Shop wymaga co najmniej 600 x 600 pikseli.

Pinterest

Tylko feed, bez aplikacji

1. Zakładka Pinterest: włącz Pinterest i skopiuj adres feedu.
2. W Pinterest Business Hub otwórz Katalogi > Źródła danych, dodaj źródło i wklej adres. Pinterest importuje feed co 24 godziny.

Aktualizacje w czasie rzeczywistym przez API

1. Na developers.pinterest.com utwórz aplikację i dodaj adres przekierowania z zakładki Pinterest modułu.
2. Wpisz App ID i App secret, zostaw Aktualizacje w czasie rzeczywistym na Tak i kliknij Zapisz i połącz Pinterest.
3. Po połączeniu kliknij Utwórz źródło danych w Pinterest: moduł rejestruje feed z walutą i krajem z ustawień.

Zmiany stanów, cen i usunięcia trafiają wtedy do Pinterest w kilka minut. Dwie minuty po każdej wysyłce moduł odczytuje wynik z Pinterest. Odrzucona pozycja jest oznaczana błędem w zakładce Produkty z komunikatem Pinterest.

TikTok Shop

Utworzenie aplikacji TikTok Shop

1. Na partner.tiktokshop.com utwórz własną aplikację sprzedawcy lub aplikację usługi zewnętrznej.
2. Włącz zakresy Product, Order, Fulfillment i Logistics.
3. Jako adres przekierowania podaj adres z zakładki TikTok Shop modułu.
4. Skopiuj App key, App secret i, jeśli aplikacja go ma, Service ID.

Połączenie sklepu

1. Zakładka TikTok Shop: włącz TikTok, wybierz region (Europa i reszta świata albo Stany Zjednoczone), wpisz dane i kliknij Zapisz i połącz TikTok Shop.
2. Autoryzuj aplikację na stronie TikTok. Moduł pobiera sklep i domyślny magazyn.
3. Wybierz magazyn, jeśli masz kilka, a następnie producenta i osobę odpowiedzialną dla UE. Jeśli listy są puste, utwórz ich najpierw w Seller Center i kliknij Odśwież listy.
4. Kliknij Wczytaj kategorie, aby pobrać drzewo kategorii TikTok.

Ustawienia ofert

• Wysyłana cena: po rabatach PrestaShop albo regularna, jeśli promocje prowadzisz w TikTok.
• Domyślna paczka: waga i wymiary dla produktów bez tych danych.
• Twórz nowe oferty: po wyłączeniu moduł aktualizuje tylko stan i cenę istniejących ofert.

Oferty już istniejące w TikTok Shop

Jeśli już sprzedajesz w TikTok Shop, uruchom Powiąż istniejące oferty w zakładce TikTok Shop przed pierwszą synchronizacją. Moduł łączy oferty z produktami po SKU sprzedawcy:

• indeks kombinacji;
• indeks produktu, dla produktu bez kombinacji;
• format PS12 lub PS12-34 używany przez moduł.

Powiązana oferta zachowuje tytuł, zdjęcia i opis z TikTok: moduł zarządza tylko stanem i ceną. Aby zastosować treść z PrestaShop, otwórz podgląd produktu w zakładce Produkty i kliknij Zastąp treść danymi z PrestaShop. Oferta, której SKU wskazują na kilka produktów, jest zgłaszana jako konflikt i nie jest wiązana.

Mapowanie kategorii

Zakładka Kategorie przypisuje każdej kategorii PrestaShop:

• kategorię Google, używaną przez Pinterest i feed TikTok Ads: wpisz kilka słów i wybierz z wbudowanej taksonomii Google;
• kategorię TikTok Shop: wpisz, aby wyszukać, lub kliknij Zaproponuj, aby TikTok zaproponował kategorię na podstawie produktów.

Podkategoria bez własnego mapowania dziedziczy mapowanie rodzica, pokazane na szaro. Produkty korzystają z kategorii domyślnej. Zmiany zapisuje się razem przyciskiem Zapisz zmiany.

Przycisk Atrybuty otwiera atrybuty kategorii TikTok. Oznaczone gwiazdką są wymagane i dotyczą wszystkich produktów kategorii. Mapowanie można eksportować i importować w CSV (separator: średnik).

Zamówienia TikTok

Zakładka Zamówienia TikTok zapobiega nadsprzedaży: bez importu sprzedaż w TikTok obniża stan tylko w TikTok. Dostępne są trzy tryby:

• Twórz zamówienia PrestaShop: każda sprzedaż staje się zamówieniem w cenie zapłaconej w TikTok (po rabacie sprzedawcy) i z kosztem wysyłki TikTok. VAT liczy PrestaShop, stan maleje. Płatność widnieje jako „TikTok Shop” z numerem zamówienia TikTok jako transakcją.
• Tylko zmniejszaj stan: dla zamówień wysyłanych z Seller Center lub przez TikTok.
• Wyłączone.

Zamówienia są importowane przez cron. Po włączeniu pobierane są zamówienia z ostatnich 24 godzin. Wybierz status nowych zamówień i przewoźnika. Koszt wysyłki pozostaje taki, jak zapłacony w TikTok, niezależnie od przewoźnika.

• Anulowania: anulowanie w TikTok zmienia status zamówienia na „Anulowane” lub przywraca stan w trybie tylko stanów.
• Błędy: zamówienie z błędem (niepowiązany SKU, nieaktywna waluta) jest widoczne z przyczyną i ponawiane co 15 minut. Przycisk Ponów spróbuje ponownie przy następnym imporcie.
• Kupujący: są tworzeni jako klienci-goście z adresem @tiktokshop.invalid. TikTok zabrania kontaktu poza platformą, więc moduł blokuje każdy e-mail skierowany do nich.

Karta zamówienia PrestaShop pokazuje blok TikTok Shop z numerem TikTok, statusem i stanem śledzenia.

Numery przesyłek

Gdy do zaimportowanego zamówienia zostanie dodany numer przesyłki, ręcznie lub przez moduł przewoźnika, trafia do TikTok w ciągu 5 minut, a zamówienie TikTok zostaje oznaczone jako wysłane. Zamówienia realizowane przez TikTok są pomijane.

TikTok wymaga dostawcy wysyłki. W zakładce TikTok Shop, w sekcji Przewoźnicy i dostawcy wysyłki TikTok, przypisz każdego przewoźnika do dostawcy TikTok. Bez przypisania moduł szuka dostawcy o tej samej nazwie. Jeśli go nie znajdzie, błąd wymienia dostępnych dostawców.

Zakładka Produkty

Każdy wiersz pokazuje miniaturę, cenę, stan, status w każdym kanale i wynik jakości na 100 z głównym problemem. Możliwe przyczyny to:

• brak zdjęcia, cena zero lub krótki opis;
• błędny EAN;
• nieprzypisana kategoria;
• więcej niż 3 grupy atrybutów dla TikTok.

Filtry pokazują produkty z błędami, wykluczone, bez kategorii Google lub TikTok albo powiązane z Seller Center. Zaznacz produkty, aby zbiorczo je eksportować lub wykluczyć, albo zaplanować pełną synchronizację. Podgląd pokazuje warianty tak, jak zostaną wysłane, i pozwala ustawić tytuł dla każdego kanału. Synchronizuj teraz wysyła produkt od razu.

Ustawienia zaawansowane

• Parametry UTM: dodawane do linków feedów i pinów Pinterest, na potrzeby Google Analytics. Zostaw puste, aby wyłączyć.
• Etykiety niestandardowe: custom_label_0 = kategoria, custom_label_1 = przedział cenowy, custom_label_2 = promocja lub cena regularna.
• Reguły wykluczeń: kategorie (z podkategoriami), marki, minimalna cena brutto, oraz warianty niedostępne usuwane z feedów i z Pinterest. Wykluczony produkt znika z feedów, jest usuwany z Pinterest i dezaktywowany w TikTok Shop. Zmiana reguły ponownie kolejkuje cały katalog.
• Moment wysyłki: zaraz po każdej zmianie (hosting PHP-FPM lub LiteSpeed) albo tylko przez cron.

Zadanie cron

Skopiuj dwie linie z zakładki Przegląd do crontab na hostingu:

• co 5 minut task=sync: kolejka, ponowienia, zamówienia TikTok, śledzenie, wyniki Pinterest;
• co godzinę task=feeds: ponowne generowanie feedów.

Przegląd pokazuje, czy cron działał w ciągu ostatnich 20 minut. Błąd API jest ponawiany po 2, 4, 8, 16 i 32 minutach.

Logi i rozwiązywanie problemów

Zakładka Logi przechowuje zdarzenia z 30 dni, filtrowane po kanale: Pinterest, TikTok, zamówienia TikTok. Błędy API są zapisywane z pełną odpowiedzią.

• Produkt nie trafia do TikTok: sprawdź jego wynik w zakładce Produkty. Brak kategorii TikTok lub produkt wirtualny blokują wysyłkę.
• Zamówienie TikTok pozostaje z błędem: SKU sprzedawcy musi odpowiadać indeksowi w PrestaShop albo oferta musi być utworzona przez moduł. Popraw i kliknij Ponów.
• Zmiany pracownika nie są wysyłane: PrestaShop nie uruchamia hooków modułu dla profilu bez uprawnienia „Wyświetl” do tego modułu. Nadaj je albo użyj Synchronizuj teraz w zakładce Produkty.