Udostępnij za pośrednictwem


Encje katalogu danych

W artykule opisano, jak skonfigurować encje danych katalogu w ramach kontraktu dotyczącej Intelligent Recommendations w zakresie danych.

Omówienie jednostek danych

Jednostka danych to zestaw plików tekstowych dotyczących danych zawierający listę kolumn (nazywanych również atrybutami) oraz wiersze zawierające wartości rzeczywistych danych.

Intelligent Recommendations definiują grupy logiczne obiektów danych, z których każdy ma własny cel.

Uwaga

Encje danych są opcjonalne (chyba że określono inaczej), co oznacza, że ich dane mogą być puste lub brakujące.

Przejdź do pełnej listy jednostek danych

Wprowadzenie do encji danych katalogu

Obiekt danych katalogu reprezentuje wszystkie elementy i elementy, które będą w nich dostępne w wynikach rekomendacji. Kandydaci są określani przez zastosowanie dostępności do elementów, czyli daty, która mówi systemowi, aby uwzględnić element w wynikach rekomendacji. W przypadku nieprawidłowej dostępności elementy są ignorowane podczas zwracania wyników.

Rozwiązanie Intelligent Recommendations obsługuje następujące funkcje i scenariusze:

  • Elementy z wieloma odmianami (na przykład koszulką w różnych rozmiarach lub kolorów) lub brak odmian w ogóle. Odwołyliśmy się do tych odmian jako do warianty. Elementy, które nie mają żadnych braków, są nazywane elementami samodzielnymi, a elementy z co najmniej jednym wariantem to główne elementy.

  • Przypisywanie wartości filtru do elementów (np. kategorii, kolorów lub rozmiaru). Następnie podczas wyszukiwania rekomendacji można filtrować według tych wartości filtru.

  • Przypisywanie obrazów do elementów.

  • Elementy mogą być dostępne w różnych encji logicznych w organizacji. Intelligent Recommendations obsługują dwa poziomy hierarchii:

    • Kanał: elementy można przypisać do kanału, co pozwala na zapewnienie Intelligent Recommendations w zakresie rekomendacji wyłącznie dla produktów zawartych w danym kanałie. Wszystkie elementy są automatycznie skojarzone z kanałem domyślnym, który używa ciągu 0 (zero) jako identyfikatora zarezerwowanego kanału.

      Przykład:

      W tym przykładzie zestaw danych tylko trzy elementy: X, Y i Z. Te trzy elementy są automatycznie przypisane do domyślnego kanału (Channel=0). Te elementy można przypisać do własnych kanałów niestandardowych. Na przykład można przypisać elementy X i Y do Channel=C1 oraz elementy Y i Z do Channel=C2.

      W związku z tym podczas żądania zaleceń można przekazać inne parametry zapytania:

      • Brak parametru Kanał (równa się domyślny kanał): Wszystkie trzy elementy mogą zostać zwrócone w odpowiedzi
      • Channel=0: Taki sam jak parametr Brak parametru, ponieważ jest to kanał domyślny
      • Channel=C1: W odpowiedzi mogą być zwracane tylko elementy należące do kanału C1 (elementy X i Y)
      • Channel=C2: W odpowiedzi mogą być zwracane tylko elementy należące do kanału C2 (elementy Y i Z)
      • Channel=SomethingElse: Pusta odpowiedź, ponieważ to kanał nie jest zdefiniowany i nie są do niego przypisywane żadne elementy
    • Katalog: katalog jest kolejnym, bardziej szczegółowym poziomem ziarnistości dostępności. Pozwala to na definiowanie wielu katalogów w ramach kanału i uzyskiwanie zaleceń dla określonych katalogów. Podobnie jak w przypadku kanału, wszystkie elementy są automatycznie kojarzone z domyślnym katalogiem w ramach kanału, który używa ciągu 0 (zero) jako zarezerwowanego identyfikatora katalogu.

      Przykład:

      W przykładzie Kanał znajdziesz elementy X, Y i Z. Elementy zostały przypisane X i Y do kanału C1 i są automatycznie przypisywane do domyślnego katalogu w kanałie (przy użyciu wartości Catalog=0). Możesz uzyskać dalszą granulację, przypisując te elementy do niestandardowych katalogów w ramach kanału. Przypiszmy element X do catalog=A oraz elementy X i Y do catalog=B.

      W związku z tym podczas żądania zaleceń można przekazać inne parametry zapytania:

      • Channel=C1: Brak parametru katalogu, równa się katalog domyślny. Zarówno elementy X, jak i Y mogą zostać zwrócone w odpowiedzi.
      • Channel=C1&Catalog=0: Taki sam jak parametr katalogu bez, ponieważ jest to katalog domyślny.
      • Channel=C1&Catalog=A: W odpowiedzi mogą być zwrócone tylko pozycje, które należą do katalogu A w kanale C1 (tylko pozycja X).
      • Channel=C1&Catalog=B: W odpowiedzi mogą być zwrócone tylko pozycje, które należą do katalogu B w kanale C1 (pozycje X i Y).
      • Channel=C1&Catalog=SomethingElse: Pusta odpowiedź, ponieważ ten katalog nie został zdefiniowany w kanale C1 i nie są do niego przypisane żadne pozycje.
  • Zadeklarowanie dostępnych elementów:

    • Daty rozpoczęcia/zakończenia dostępności: elementy spoza swojego zakresu czasu dostępności będą wyłączone z odpowiedzi na zalecenia.
    • Ziarnistość dostępności: Zdefiniuj daty rozpoczęcia/ zakończenia w ramach określonych identyfikatorów kanałów/katalogów.

Katalog składa się z kilku encji danych, wszystkie są opcjonalne (w zależności od tego, jakich funkcji chcesz używać) i mogą pozostać puste (lub brak ich) w folderze głównym Intelligent Recommendations. Jeśli użytkownik nie chce tego Reco_ItemsAndVariants danych, może postępować zgodnie z Reco_ItemsAndVariants opisanymi poniżej wytycznymi dotyczącymi tego obiektu danych.

Lista encji katalogu danych

Katalog zawiera następujące encje danych:

Przejdź do pełnej listy jednostek danych

Elementy i warianty

Nazwa encji danych:Reco_ItemsAndVariants

Opis: Wszystkie elementy i przechyłki elementów

Atrybuty:

Nazwa/nazwisko Typ danych Obowiązkowy Domyślna wartość Nieprawidłowe zachowanie wartości Komentarze
ItemId Ciąg(16) Tak Wpisanie do rejestru zrzutów Zobacz scenariusz wymaganych encji danych w scenariuszu rekomendacji, aby uzyskać identyfikator elementu.
ItemVariantId Ciąg(16) Nie. Wpisanie do rejestru zrzutów Zobacz scenariusz wymaganych encji danych w scenariuszu rekomendacji, aby uzyskać identyfikator wariantu elementu.
Nazwa Ciąg(256) Nie. Wartość trymu Długość ograniczona do 256 znaków.
opis Ciąg(2048) Nie. Wartość trymu Długość ograniczona do 2048 znaków.
ReleaseDate DateTime Nie. 1970-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.

Wytyczne:

  • Pochyły element dziedziczy atrybuty ich główny element. Jeśli na przykład wariant elementu nie ma tytułu, dziedziczy on tytuł główny elementu (czyli wiersza z tym samym elementem ItemId, ale z pustym elementem ItemVariantId), jeśli istnieje.

  • ItemIds mogą mieć relację jeden-do-wielu z elementami ItemVariantIds. Możliwe jest, że singe ItemId jest mapowana na więcej niż jeden ItemVariantId , aby przechwytywać relację z główny element na jego wariant. Możliwe jest wpisanie pozycji dla określonej kombinacji ItemId i ItemVariantId bez określania innych kombinacji ItemId do ItemVariantId .

  • Atrybut ReleaseDate reprezentuje datę wydania (opublikowania, wprowadzenia) elementu na rynku. Ten atrybut różni się od atrybutu dostępność elementu (gdy element/produkt może zostać zwrócony w wywołaniu interfejsu API), ale nazwa ReleaseDate może być używana w scenariuszach, takich jak Nowe i Popularne, które korzystają z dat przy zamawianiu elementów.

  • Jeśli ten obiekt danych jest pusty (lub brak), funkcja Intelligent Recommendations automatycznie użyje wszystkich elementów i elementów, które znajdują się w encji danych programu Reco_Interactions jako zestawu elementów katalogu, a także przypisze każdy element i wariant elementu z domyślnym tytułem, opisem i datą wydania. Te elementy są traktowane zawsze jako dostępne, o ile nie zostały przypisane jawne dostępność w encji Reco_ItemAndVariantAvailabilities danych.

  • Funkcja Intelligent Recommendations może używać atrybutów Tytuł i Opis w celu zapewnienia zaleceń opartych na tekście. Ponieważ Intelligent Recommendations obsługują obecnie tylko lokalną obsługę zaleceń tekstowych, podanie tytułu i opisu w innych lokalizacjach regionalnych może spowodować, że zalecenia tekstowe będą wysokiej jakości.

Przykładowe dane:

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

ItemId ItemVariantId Nazwa opis ReleaseDate
Element1 2018-05-15T13:30:00.000Z
Element1 Item1Var1 Czarne okulary przeciwsłoneczne Czarne okulary przeciwsłoneczne dla dzieci 2018-08-01T10:45:00.000Z
Element1 Item1Var2 Brązowe okulary przeciwsłoneczne Brązowe okulary przeciwsłoneczne dla dorosłych
Element2 Ściereczka do czyszczenia okularów 2019-09-20T18:00:00.000Z
Item3 Item3Var1

Powrót do listy encji danych katalogu

Kategorie elementów

Nazwa encji danych:Reco_ItemCategories

Opis: wszystkie kategorie elementów.

Atrybuty:

Nazwa/nazwisko Typ danych Obowiązkowy Domyślna wartość Nieprawidłowe zachowanie wartości Komentarze
ItemId Ciąg(16) Tak Wpisanie do rejestru zrzutów Zobacz scenariusz wymaganych encji danych w scenariuszu rekomendacji, aby uzyskać identyfikator elementu.
Kategoria Ciąg(64) Tak Wartość trymu Długość ograniczona do 64 znaków.

Wytyczne:

  • Każdy ItemId może mieć wiele kategorii, czyli może być wyświetlany w wielu wpisach w danych.

  • Jeśli Twoje dane są tworzone przy użyciu drzew kategorii, będziesz musiał podać pełny zestaw kategorii (spłaszczony) dla każdego elementu.

Przykładowe dane:

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

ItemId Kategoria
Element1 Category1
Element1 Category1_subCategoryX
Element1 Category1_subCategoryY
Element2 Category1_subCategoryX

Powrót do listy encji danych katalogu

Obrazy elementów i wariantów

Nazwa encji danych:Reco_ItemAndVariantImages

Opis: Wszystkie obrazy przedmiotów i wariantów przedmiotów

Atrybuty:

Nazwa/nazwisko Typ danych Obowiązkowy Domyślna wartość Nieprawidłowe zachowanie wartości Komentarze
ItemId Ciąg(16) Tak Wpisanie do rejestru zrzutów Zobacz scenariusz wymaganych encji danych w scenariuszu rekomendacji, aby uzyskać identyfikator elementu.
ItemVariantId Ciąg(16) Nie. Wpisanie do rejestru zrzutów Zobacz scenariusz wymaganych encji danych w scenariuszu rekomendacji, aby uzyskać identyfikator wariantu elementu.
ImageFullUrl Ciąg(2048) Tak Wpisanie do rejestru zrzutów Musi to być bezwzględny adres URL. Adres URL powinien być poprawnie zakodowany (z użyciem kodowań procentu). Długość ograniczona do 2048 znaków.
IsPrimaryImage Bool Tak Zobacz wytyczne Zobacz scenariusz wymaganych encji danych w scenariuszu rekomendacji dotyczących wartości logicznych.

Wytyczne:

  • Należy jawnie przypisać obrazy do elementu ItemId i do każdego odpowiedniego elementu ItemVariantId. Obrazy przypisane do elementu nie są automatycznie przypisywane do wszystkich elementów i na odwrót. Obrazy przypisane do wariantu przedmiotu nie są automatycznie przypisywane do elementu głównego tego wariantu.

  • Jeśli dla kombinacji dla tego samego elementu< ItemId, ItemVariantId> zostanie określony więcej niż jeden obraz podstawowy, w kroku wnioskowania będzie używany tylko jeden z tych obrazów, a pozostałe są używane tylko podczas szkolenia całego modelu wizualnego.

  • Dla każdego obrazu, dla którego nie powiodło się uzyskanie dostępu do Intelligent Recommendations, adres URL obrazu jest ignorowany i nie będzie używany w modelu rekomendacji.

  • Jeśli wartość IsKsyaryImage jest nieprawidłowa, zostanie użyta wartość false (na przykład obraz nie jest używany).

  • Jeśli dla elementu lub elementu określono tylko obrazy inne niż podstawowe, Intelligent Recommendations używa jednego z określonych obrazów jako obrazu podstawowego, aby nadal przedstawiać zalecenia wizualne dla tego elementu lub wariantu elementu.

  • Istnieją dwa typy obsługiwanych adresów URL:

    • Publicznie dostępne adresy URL protokołu HTTPS: nie jest wymagany nagłówek autoryzacji . Ten adres URL nie obejmuje adresów URL obiektów blob platformy Azure, które są dostępne publicznie/anonimowo i które nie są obsługiwane.
    • Adresy URL magazynu obiektów blob Azure wymagające uwierzytelniania: Nie są dostępne publicznie/anonimowo. Uprawnienia do odczytu obiektów blob typu obraz należy przyznać na Intelligent Recommendations, zgodnie z objaśnieniami wdrażając Intelligent Recommendations). Adresy URL obiektów blob muszą zaczynać się od prefiksu: https://<StorageAccountName>.blob.core.windows.net/.
  • Maksymalny obsługiwany rozmiar pojedynczego obrazu to 512 KB. System zignoruje dowolny obraz o rozmiarze ponad 512 KB.

  • Typ ContentType musi zawierać obraz, typ zawartości (należy rozpocząć od obrazu). To wymaganie dotyczy wszystkich obrazów dostępnych za pośrednictwem protokołu HTTPS i obiektów blob obrazów (za pośrednictwem właściwości ContentType obiektu blob ).

Przykładowe dane:

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

ItemId ItemVariantId ImageFullUrl IsPrimaryImage
Element1 https://my.server.org/images/Item1_primary.jpg Prawda
Element1 https://my.server.org/images/Item1_secondary.jpg Fałsz
Element1 Item1Var1 https://my.server.org/images/Item1Var1.jpg Prawda
Element2 https://my.server.org/images/Item2.jpg Prawda

Powrót do listy typów encji katalogu

Filtry elementów i wariantów

Nazwa encji danych:Reco_ItemAndVariantFilters

Opis: Właściwości elementu i wariantu elementu używane w czasie wykonywania filtrowania wyników

Atrybuty:

Nazwa/nazwisko Typ danych Obowiązkowy Domyślna wartość Nieprawidłowe zachowanie wartości Komentarze
ItemId Ciąg(16) Tak Wpisanie do rejestru zrzutów Zobacz scenariusz wymaganych encji danych w scenariuszu rekomendacji, aby uzyskać identyfikator elementu.
ItemVariantId Ciąg(16) Nie. Wpisanie do rejestru zrzutów Zobacz scenariusz wymaganych encji danych w scenariuszu rekomendacji, aby uzyskać identyfikator wariantu elementu.
FilterName Ciąg(64) Tak Wartość trymu
FilterValue Ciąg(64) Tak Wartość trymu Długość ograniczona do 64 znaków.
FilterType String Tak Wpisanie do rejestru zrzutów Możliwe wartości to: tekstowa, liczbowa.

Wytyczne:

  • Elementy i elementy mają relację nadrzędny-podrzędny. Ta wskazówka oznacza, że warianty przedmiotu odziedziczą filtry swojego elementu głównego. Jeśli na przykład dla określonego ItemIdzostał wybrany filtr "Kolor", dla elementu wyfiltrowania tego samego elementuItemId zostanie podana ta sama wartość filtru "Kolor", chyba że dla wariantu elementu zostanie podana inna wartość "Kolor".

  • Typy filtrów tekstowych obsługują operację filtrowania "równa się". Na przykład żądania interfejsu API mogą filtrować elementy przy użyciu wartości "Color"="Blue".

  • Typy filtrów liczbowych obsługują operacje filtrowania "zakresu". Na przykład żądania interfejsu API mogą filtrować elementy przy użyciu wartości "Size" > 40.

  • Można przypisać wiele wartości filtrowania do tego samego filtru. Na przykład dla filtru "Kolor" można podać kilka wartości, takich jak "Zielony" i "Niebieski". W tym przykładzie odpowiedni element ma dwie wartości filtru "Kolor" i zostanie zwrócony po filtrowaniu elementów "Zielony" lub "Niebieski". Aby przypisać wiele wartości do tego samego filtru, należy dodać wpis dla każdej wartości filtru, którą chcesz przypisać, używając tych samych wartości FilterName i FilterType.

  • W przypadku każdej nazwy FiltrName wariant elementu może dziedziczyć nadrzędne wartości filtrowania lub zastąpić je. Łączenie tych dwóch nie jest obsługiwane. Jeśli domyślnie wariant nie ma wartości przypisanych do filtru, dziedziczy on wartości filtru elementu nadrzędnego. Jeśli do filtru dla elementu jest przypisana co najmniej jedna wartość filtru, tryb zastępowania jest włączony i efektywne są tylko wartości filtru wariantów (tylko dla konkretnego filtru). Ta wartość oznacza, że aby osiągnąć zachowanie „scalania”, wariant elementu musi powtarzać wartości filtra nadrzędnego. Na przykład element obsługuje dwa kolory: Niebieski i Zielony. Jeśli wariant obsługuje inny kolor, czerwony, to wariant musi zawierać wszystkie trzy kolory przypisane do identyfikatora wariantu: Niebieski, Zielony i Czerwony. W tym przykładzie wariant elementu zastąpić ma wartości filtru "Kolor", ale może dziedziczyć wartości innych filtrów z elementu nadrzędnego.

  • Wpisy z nieobsługiwanymi typami filtrów zostaną zignorowane.

  • Można podać maksymalnie 20 różnych nazw FilterName.

  • Podanie wielu wpisów o tej samej FilterName, ale innym FilterType nie powiedzie się proces Intelligent Recommendations.

  • Brak filtrów dla elementów lub elementów. Jeśli w żądaniu interfejsu API zostanie określony dowolny filtr, elementy lub elementy, które nie mają określonego filtru, zostaną odfiltrowane.

Przykładowe dane:

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

ItemId ItemVariantId FilterName FilterValue FilterType
Element1 Color Czerwony Tekstowy
Element1 Item1Var1 Color Burgundowy Tekstowy
Element1 Item1Var2 Styl Prostokątne Tekstowy
Element2 Size 38 Liczbowe
Element2 Color Niebieskie Tekstowy
Element2 Color Zielony Tekstowy

Powrót do listy typów encji katalogu

Dostępność elementów i wariantów

Nazwa encji danych:Reco_ItemAndVariantAvailabilities

Opis: Dostępność wszystkich pozycji i wariantów pozycji

Atrybuty:

Nazwa/nazwisko Typ danych Obowiązkowy Domyślna wartość Nieprawidłowe zachowanie wartości Komentarze
ItemId Ciąg(16) Tak Wpisanie do rejestru zrzutów Zobacz scenariusz wymaganych encji danych w scenariuszu rekomendacji, aby uzyskać identyfikator elementu.
ItemVariantId Ciąg(16) Nie. Wpisanie do rejestru zrzutów Zobacz scenariusz wymaganych encji danych w scenariuszu rekomendacji, aby uzyskać identyfikator wariantu elementu.
StartDate DateTime Nie. 0001-01-01T00:00:00.000Z Zobacz wytyczne Zobacz scenariusz wymaganych encji danych w scenariuszu rekomendacji dotyczących wartości daty i czasu.
EndDate DateTime Nie. 9999-12-31T23:59:59.999Z Zobacz wytyczne Zobacz scenariusz wymaganych encji danych w scenariuszu rekomendacji dotyczących wartości daty i czasu.
Atrybut typu double Liczba rzeczywista Nie. Podwójny atrybut, który można stosować zgodnie z potrzebami firmy i nie wpływa na proces modelowania.
Kanał Ciąg (64) Nie. 0 Wartość trymu Długość ograniczona do 64 znaków.
Wykaz Ciąg (64) Nie. 0 Wartość trymu Długość ograniczona do 64 znaków.

Wytyczne:

  • Przypomnienie: dostępność powoduje, że system poda, które elementy lub elementy zostały zakwalifikowane do wykonania przez nich w celu wykonania zalecenia.

  • Dostępność wariantu elementu to możliwość dostępności elementu głównego elementu z dostępnością samego wariantu elementu. Nawet element, który nie ma wpisów, będzie dziedziczyć właściwości ich pozycji głównych.

  • Element, którego brakuje w tej jednostce danych, będzie uważany za zawsze dostępny w domyślnym kanale i katalogu. Dokładniej, Intelligent Recommendations będą działać dokładnie tak, jak kiedy element ten będzie wyświetlany w danych z wartościami domyślnymi dla wszystkich atrybutów.

  • ItemIds mogą mieć relację jeden-do-wielu z elementami ItemVariantIds. Mimo że element ItemId nie jest wymagany do zachowania elementu ItemVariantId, możliwe jest, że na jeden ItemVariantId można zamapować więcej niż jeden element ItemVariantId. Na przykład można dodać wpis dla określonej kombinacji ItemId i ItemVariantId bez jawnego dodawania innego wpisu ItemId ( i pustej wartości ItemVariantId). Podczas ustalania, czy warianty artykułu mają ważną dostępność, tylko określone warianty artykułu są uważane za dostępne (w określonych odstępach czasu dla każdego wariantu).

  • Katalog jest odpowiedni tylko w kontekście kanału (Katalogi są podzbiorem kanału). Na przykład catalog=MySale w channel=Europe jest inny niż catalog=MySale w channel=Asia.

  • Jeśli Twój zestaw danych zawiera wiele kanałów i katalogów, będziesz musiał dodać wpis dla każdego odpowiedniego kanału i kombinacji katalogu dla każdej odpowiedniej pozycji i wariantu pozycji.

  • Daty dostępności mają zastosowanie tylko dla określonego kanału i określonego katalogu. Aby określić te same daty dostępności dla różnych kanałów i katalogów, należy jawnie dodać wpis dla każdego kanału i katalogu.

  • Jeśli wartość każdego z atrybutów StartDate lub EndDate jest nieprawidłowa, cały wpis jest modyfikowany w celu reprezentowania niedostępnego elementu. Wartości StartDate i EndDate są zastępowane wartościami DateTime, które są w przeszłości.

  • Atrybut typu double może pozostać pusty.

  • Nie należy używać wartości "0" jako wartości "Kanał". Ta wartość jest zarezerwowana dla systemu. Użycie wartości „0” spowoduje błąd przetwarzania.

Przykładowe dane:

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

ItemId ItemVariantId StartDate EndDate Atrybut typu double Kanał Wykaz
Element1 2020-08-20T10:00:00.000Z
Element1 Item1Var1 2020-08-01T12:00:00.000Z
Element2 2020-04-01T10:00:00.000Z 2020-04-15T23:59:59.999Z 15.0
Element2 2020-04-01T10:00:00.000Z 9.76
Item3 2020-05-01T12:00:00.000Z Europa MySale

Powrót do listy typów encji katalogu

Zobacz też

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