Integracja wewnętrzna

Widżety personalizacji, karuzele rekomendacji, przepływy porzuconych koszyków i kampanie wielokanałowe (web push, e-mail, SMS, WhatsApp, banery na stronie) Insidera korzystają z tego samego katalogu produktów. Bez zsynchronizowanego kanału, Insider nie ma dostępu do nazw produktów, cen, zdjęć ani stanu magazynowego, które można by wstawić do tych doświadczeń.

Dostarczanie Insiderowi czystego, poprawnie zmapowanego katalogu chroni również Twoje Google Merchant Center i inne kanały reklamowe. Jeśli Twój zespół utrzymuje już kanał zoptymalizowany pod kątem Feedance dla Google Merchant Center lub Meta, zazwyczaj możesz ponownie wykorzystać te same podstawowe dane produktowe – przekształcając je do formatu oczekiwanego przez Insider – zamiast tworzyć i utrzymywać całkowicie oddzielny eksport.

W dokumentacji Insider dotyczącej integracji katalogów opisano synchronizację w czasie rzeczywistym (lub zaplanowaną) jako mechanizm, który sprawia, że ​​funkcja Smart Recommender działa na podstawie bieżących danych: w miarę aktualizacji katalogu Insider One automatycznie usuwa niedostępne produkty z kampanii i widżetów rekomendacji, dzięki czemu kupującym nigdy nie wyświetlają się produkty, których nie mogą kupić.

Insider nie publikuje wewnętrznej logiki rankingowej swojego mechanizmu rekomendacji, więc traktuj to jako gwarancję świeżości danych, a nie opis samego algorytmu personalizacji: jeśli dane będą dokładne i aktualne, dalsze rekomendacje również pozostaną dokładne i aktualne.

Integracja z katalogiem produktów Insider (udokumentowana w ramach metodyki integracji katalogu produktów opartej na XML) akceptuje kanały XML w jednym z trzech obsługiwanych formatów:

1. Format Criteo XML — dla sprzedawców, którzy już eksportują dane zgodne ze standardem Criteo.
2. Format XML Google Merchant — wspólna struktura przestrzeni nazw `g:` używana w przypadku Google Merchant Center, którą system dopasowywania atrybutów katalogu produktów Insider może automatycznie mapować na własne atrybuty.
3. Niestandardowy format XML — samodzielnie zdefiniowana struktura, w której ręcznie mapujesz każdy tag na atrybut Insider.

Insider obsługuje również aktualizacje katalogów za pośrednictwem interfejsów API Ingest/Update (opartych na JSON) jako alternatywę dla XML. Insider wyraźnie nie zezwala na jednoczesne uruchamianie kanału XML i integracji API dla tego samego katalogu — należy wybrać jedną metodę.

Podczas konfiguracji w panelu Insider (InOne) określasz również nazwę tagu produktu (zwykle item chyba że w pliku XML używana jest inna terminologia), ustawienia regionalne i waluty wyświetlane w pliku — integracje XML są konfigurowane dla poszczególnych ustawień regionalnych/sklepu.

Lista atrybutów katalogu produktów Insider dokumentuje zestaw domyślnych atrybutów, które są automatycznie rozpoznawane, gdy nazwa i typ pola są zgodne, a także obsługuje w pełni niestandardowe atrybuty definiowane samodzielnie. Status wymagania różni się w zależności od wybranego typu pliku danych (patrz poniżej), ale pola podstawowe to:

Dokumentacja Insider ostrzega, że ​​produktom brakuje wymaganego atrybutu (takiego jak item_id or in_stock) są ignorowane podczas przetwarzania, zamiast powodować błąd całego kanału.

1. W Feedance utwórz lub wybierz kanał produktów, który chcesz wysłać do Insider, mapując dane źródłowe na pola oczekiwane przez Insider: item_id, name, image_url, url, in_stock, Plus price/original_price jeśli zamierzasz używać kanału opartego na przychodach ze sprzedaży akcji.
2. Wybierz Google Merchant XML jako format wyjściowy w Feedance, jeśli chcesz, aby automatyczne dopasowywanie atrybutów usługi Insider działało z minimalnym mapowaniem ręcznym — wykorzystuje to tę samą strukturę tagów `g:`, którą wiele zespołów utrzymuje już dla Google Merchant Center.
3. Opublikuj kanał i skopiuj adres URL kanału Feedance.
4. W panelu InOne aplikacji Insider przejdź do integracji Katalogu produktów, wybierz XML jako metodę integracji, nadaj integracji nazwę, wybierz Google Merchant (lub Niestandardowy) jako format i wklej adres URL kanału Feedance jako źródło.
5. Ustaw ustawienia regionalne, tag produktu (domyślne ustawienie Insider to item), okres synchronizacji, obowiązujące waluty i włącz wykrywanie braków w magazynie, jeśli ma to zastosowanie.
6. Jeśli adres URL Twojego kanału Feedance jest chroniony, dodaj wymaganą parę Klucz nagłówka/Wartość nagłówka, aby użytkownik Insider mógł się uwierzytelnić. W przeciwnym razie upewnij się, że adresy IP użytkownika Insider znajdują się na liście dozwolonych, jeśli Twój hosting ma zaporę sieciową/WAF/ochronę przed botami.
7. Zmapuj wszelkie pozostałe atrybuty niestandardowe, a następnie potwierdź — Insider zweryfikuje kanał i poda liczbę produktów oraz zakres atrybutów przed aktywacją.

Insider umożliwia skonfigurowanie interwału synchronizacji w zakresie od 1 godziny do 5 dni podczas konfiguracji integracji XML. W dokumentacji Insidera zaznaczono, że zmiany w katalogu są wprowadzane w kolejnym cyklu synchronizacji, a nie natychmiast — dlatego jeśli w przypadku wyprzedaży błyskawicznych lub szybko rotujących zapasów polegasz na aktualnych danych o stanie magazynowym lub cenach, wybierz najkrótszy interwał, jaki obsługuje harmonogram generowania danych Feedance, zamiast zakładać, że zmiany będą wprowadzane natychmiast.

Insider informuje o stanie integracji poprzez statusy walidacji wyświetlane w panelu InOne: Aktywny, Pasywny, Oczekujący na walidację, Gotowy do aktywacji, Niepowodzenie walidacji i Błąd systemu. Udokumentowane przyczyny, na które warto zwrócić uwagę, to:

• Brak wymaganych atrybutów — brak produktów item_id, namelub in_stock (lub inne pola wymagane przez wybrany typ kanału) są automatycznie pomijane w przetwarzaniu, zamiast blokować cały kanał.
• Adres URL kanału zablokowany przez zaporę sieciową/WAF/ochronę botów — jeśli Twój hosting chroni adres URL XML za pomocą ograniczeń IP lub wykrywania botów, żądania pobierania Insider'a nie powiodą się, chyba że adresy IP Insider'a zostaną wyraźnie umieszczone na liście dozwolonych.
• Niezgodna nazwa tagu produktu — jeśli Twój XML nie używa item jako tag produktu i nie ustawisz prawidłowej nazwy tagu podczas konfiguracji, Insider nie będzie w stanie analizować poszczególnych produktów.
• Jednoczesne uruchamianie integracji XML i API — Insider pozwala na integrację tylko jednej aktywnej metody katalogu na raz; nie jest obsługiwane włączanie obu metod.

Są to ogólne praktyki dotyczące higieny pasz, a nie wymagania dotyczące osób mających dostęp do informacji poufnych:

• Trzymać in_stock a pola cenowe są tak aktualne, jak pozwala na to interwał synchronizacji — trafność rekomendacji i kampanii zależy bezpośrednio od aktualności tych danych.
• Wybierz typ kanału (zasoby-przychody, dostępność, czas publikacji lub na podstawie czasu rozpoczęcia-zakończenia), który odpowiada Twojemu modelowi biznesowemu, zamiast domyślnie wybierać ogólny model e-commerce, ponieważ Insider używa typu kanału, aby zdecydować, który wymiar steruje filtrowaniem rekomendacji.
• W miarę możliwości wykorzystuj ponownie kanał w formacie Google Merchant, aby funkcja automatycznego dopasowywania atrybutów Insider mogła wykonać mapowanie za Ciebie.
• Wypełnij opcjonalne atrybuty, takie jak category, brand, group_code chociaż nie są wymagane — zazwyczaj poprawiają skuteczność personalizacji i grupowania wariantów w dalszej części procesu.

Czy mogę używać zarówno kanału XML, jak i integracji API dla mojego katalogu produktów Insider?
Nie. Insider pozwala na to, aby dla danego katalogu w danym momencie aktywna była tylko jedna metoda integracji — XML lub API.

Czy Insider bezpośrednio obsługuje kanały w formacie Google Merchant Center?
Tak. System dopasowywania atrybutów katalogu produktów Insider został stworzony tak, aby automatycznie rozpoznawać standardową strukturę tagów Google Merchant `g:`, która jest jednym z trzech obsługiwanych formatów XML, obok Criteo i Custom.

Jak szybko zmiany cen i stanów magazynowych zostaną uwzględnione w Insider po aktualizacji mojego kanału?
Tylko tak szybko, jak skonfigurowany interwał synchronizacji, który można ustawić w zakresie od 1 godziny do 5 dni — zmiany zostaną zastosowane w następnym cyklu synchronizacji, a nie natychmiast.

Jakich minimalnych danych potrzebuje Insider, aby zaakceptować produkt?
Co najmniej ważny item_id, namei pola wymagane przez wybrany typ kanału (na przykład in_stock (w przypadku typów kanałów uwzględniających stan magazynowy). Produkty, w których brakuje tych informacji, są ignorowane, zamiast powodować awarię całego kanału.