Udostępnij za pośrednictwem


Encje danych list zewnętrznych

Intelligent Recommendations umożliwiają ręczne tworzenie list elementów. Ta lista jest przydatna na przykład w scenariuszu zimnego startu, w którym nie masz wystarczającej ilości danych interakcji użytkownika, aby wygenerować sensowne rekomendacje. Innym scenariuszem jest tworzenie list promocyjnych, takich jak wyprzedaż „powrót do szkoły” lub „Wybór redaktorów”.

W każdym przypadku dostępność produktów jest zawsze respektowana. Żaden element, który nie jest uznawany za dostępny w momencie, gdy jest wywoływany interfejs API rekomendacji, nie zostanie zwrócony jako część odpowiedzi.

Następujące jednostki danych są częścią jednostek danych list zewnętrznych:

Zewnętrzne listy rekomendacji

Nazwa encji danych:Reco_ExternalRecommendationsLists

Opis: Zewnętrzne listy zaleceń

Atrybuty:

Nazwa/nazwisko Typ danych Obowiązkowy Domyślna wartość Nieprawidłowe zachowanie wartości Komentarze
ListName Ciąg(64) Tak Wartość trymu Unikatowy identyfikator listy, również używany podczas wyszukiwania listy. Długość ograniczona do 64 znaków.
Nazwa Ciąg(256) Tak Wartość trymu Długość ograniczona do 256 znaków.
ListAvailabilityStartDate DateTime Nie. 0001-01-01T00:00:00.000Z Wpisanie do rejestru zrzutów Zobacz scenariusz wymaganych encji danych w scenariuszu rekomendacji dotyczących wartości daty i czasu.
ListAvailabilityEndDate DateTime Nie. 9999-12-31T23:59:59.999Z Wpisanie do rejestru zrzutów Zobacz scenariusz wymaganych encji danych w scenariuszu rekomendacji dotyczących wartości daty i czasu.

Wytyczne:

  • Taka encja danych może być do wykorzystania w przyszłości.

  • Atrybut ListName ma następujące ograniczenia:

    • Zestaw dozwolonych znaków: A-Z, a-z, 0-9, _, -, ~, ..
    • Wielkość liter nie jest rozróżniana.
    • Istniejące wartości nazwy RecoListName są zarezerwowane i nie można ich używać jako wartości ListName . Zobacz pełną listę zarezerwowanych nazw na stronie Rekomendacje wzbogacania encji danych.
    • Korzystając z dat rozpoczęcia i zakończenia dostępności listy, możesz określić dostępność listy, która może być obsługiwana przez Inteligentne rekomendacje tylko między tymi określonymi datami.

Przykładowe dane:

Nagłówki są wyświetlane jedynie dla ułatwienia i nie powinny być częścią rzeczywistych danych.

ListName Nazwa ListAvailabilityStartDate ListAvailabilityEndDate
SummerSale2020 Najlepsze produkty na lato 2020 2020-07-01T00:00:00.000Z 2020-08-31T23:59:59.999Z

Elementy rekomendacji zewnętrznych

Nazwa encji danych:Reco_ExternalRecommendationsItems

Opis: Pozycje na zewnętrzne listy rekomendacji

Atrybuty:

Nazwa/nazwisko Typ danych Obowiązkowy Domyślna wartość Nieprawidłowe zachowanie wartości Komentarze
ListName Ciąg(64) Tak Wartość trymu Unikatowy identyfikator listy, który jest również używany podczas wyszukiwania listy. Długość ograniczona do 64 znaków. Tabelę z nazwami list można wyświetlić tutaj.
ItemId Ciąg(16) Tak Wpisanie do rejestru zrzutów Zobacz scenariusz wymaganych encji danych w scenariuszu rekomendacji, aby uzyskać identyfikator itemId.
ItemVariantId Ciąg(16) Nie. Wpisanie do rejestru zrzutów Zobacz scenariusz wymaganych encji danych w scenariuszu rekomendacji, aby uzyskać identyfikator itemVariantId.
Ranga Int Tak Wpisanie do rejestru zrzutów Kolejność pozycji, w której poszczególne pozycje mają być wyświetlane.

Wytyczne:

  • Taka encja danych może być do wykorzystania w przyszłości.

  • Zobacz wytyczne ListName w encjach Reco_ExternalRecommendationsLists.

  • Intelligent Recommendations nie gwarantuje wewnętrznego zamawiania między wieloma elementami przypisanymi do tej samej pozycji na tej samej liście.

  • W przypadku, gdy ten sam element lub wariant elementu jest więcej niż jeden raz wyświetlany na liście, jest używany najwyższy ranking, a wszystkie inne pozycje zostaną zignorowane.

  • W przypadku każdej wartości encji danych ListName w tej encji danych musi być odpowiedni wpis o tej samej wartości ListName w encji danych Reco_ExternalRecommendationsLists. W przeciwnym razie wpis zostanie zignorowany.

Przykładowe dane:

Nagłówki są wyświetlane jedynie dla ułatwienia i nie powinny być częścią rzeczywistych danych.

ListName ItemId ItemVariantId Ranga
SummerSale2020 Element2 1
SummerSale2020 Item3 Item3Var1 2
SummerSale2020 Element1 Item1Var2 3

Zobacz też

Omówienie kontraktu danych
Tabela mapowania encji danych
Encje katalogu danych
Odwzorowanie obrazu na elementy danych
Encje danych interakcji
Jednostki danych konfiguracji Reco
Encje danych użytkowników, z których nie można zrezygnować
Rekomendacje wzbogacania encji danych
Intelligent Recommendations API
Przewodnik szybkiego startu: Skonfiguruj i uruchom Intelligent Recommendations z przykładowymi danymi