Premium

Benutzerdefinierte Entitätsattribute

Verwenden benutzerdefinierter Entitätsattribute mit einzelnen und mehreren Werten in Adobe Target Recommendations , um zusätzliche Informationen zu Artikeln in Ihrem Katalog zu definieren.

Beschränkungen

Sie können bis zu 100 benutzerdefinierte Entitätsattribute festlegen, um weitere Informationen zu Artikeln in Ihrem Katalog bereitzustellen. Möglicherweise möchten Sie ein benutzerdefiniertes Attribut mit dem Namen entity.genre erstellen, um damit ein Buch oder einen Film zu kategorisieren. Alternativ kann ein Ticketverkäufer Attribute zum Veranstaltungsort einrichten, um über einen zusätzlichen Auftritt, z. B. ein weiteres Team, das bei einer Sportveranstaltung mitwirkt, oder die Vorgruppe bei einem Konzert, zu informieren.

Die maximale Länge von benutzerdefinierten Attributen für Einzelwert-Entitäten beträgt 15.000 Zeichen (für 1- und 2-Byte-UTF-8-kodierte Sprachen wie Englisch und andere lateinische Skriptbuchstaben) oder 10.000 Zeichen (für 3-Byte-UTF-8-kodierte Sprachen wie Chinesisch, Japanisch und Koreanisch).

Benutzerdefinierte Attribute mit mehreren Werten dürfen maximal 500 Werte enthalten. Jeder einzelne Wert ist auf 100 Zeichen begrenzt. Die Gesamtanzahl der Zeichen für alle Werte muss den Beschränkungen für die maximale Länge von benutzerdefinierten Attributen für Einzelwertentitäten entsprechen (siehe oben).

Benutzerdefinierte Entitätsattributwerte

Benutzerdefinierte Entitätsattribute können einen oder mehrere Werte umfassen. Die Werte der Entitätsattribute werden in der Produktansicht dargestellt.

Ein benutzerdefinierter Entitätswert mit einem einzelnen Wert ist genauso aufgebaut wie ein vordefiniertes Entitätsattribut mit nur einem Wert:

entity.genre=genre1

Ein benutzerdefiniertes Entitätsattribut mit mehreren Werten muss als gültiges JSON-Array festgelegt werden:

entity.genre=["genre1", "genre2"]

Beispiele für gültige JSON-Arrays, die von Recommendations unterstützt werden:

• ["AB","BC"] alle Werte sind Zeichenfolgen
• [1,2] alle Werte sind numerisch

Wurde ein benutzerdefiniertes Attribut als gültiges JSON-Array übermittelt, wird das Attribut für alle Produkte im Katalog als Attribut mit mehreren Werten behandelt.

Einschränkungen:

• Sie können keine voreingestellten Entitätsattributnamen für benutzerdefinierte Entitätsattribute verwenden. (Siehe Entitätsattribute.)
• Das Attribut entity.environment ist vom System reserviert und kann nicht für benutzerdefinierte Entitätsattribute verwendet werden. Versuche, entity.environment mit targetPageParams, Feeds oder APIs zu übermitteln, werden ignoriert.
• Arrays müssen einen einzigen Werttyp enthalten. Arrays mit gemischten Werten (["AB",1,true]) werden nicht unterstützt.
• Ein Attribut mit mehreren Werten, das ein verschachteltes JSON-Array ([10,12,[1,2,3]]) enthält, wird als Attribut mit einem Wert behandelt.

Implementieren von Attributen mit mehreren Werten

Benutzerdefinierte Entitätsattribute mit mehreren Werten werden bei Verwendung von Feeds (CSV) unterstützt. targetPageParamsund der Bereitstellungs-API zum Hochladen von Produkten. Alte Werte werden durch neue Werte ersetzt, nicht ergänzt. Leere Arrays ([]) werden wie Arrays ohne Werte behandelt.

Doppelte Anführungszeichen müssen mit Escapezeichen angegeben werden. Zum Beispiel ist "[""test"", ""value""]" ein gültiges JSON-Array, das in CSV verwendet werden kann.

Sie können bis zu 500 Werte in einem Attribut mit mehreren Werten einbeziehen.

Verwenden von targetPageParams

Das folgende Beispiel zeigt, wie Sie Folgendes verwenden: targetPageParams

function targetPageParams() {
  return {
    'entity.id':                   '123',
    'entity.categoryId':            '["A", "A:B", "A:B:C", "A:B:C:D"]',
    'entity.MultiValueAttribute':   '["X", "Y", "Z"]',
    'entity.event.detailsOnly':     'true',
    'excludedIds":                  '[123, 3232, 2323, 4344]',
    'orderId":                      '123456',
    'orderTotal":                   '195.32',
    'productPurchaseId":            '[001,002,003]'
  };
}

Verwenden von CSV-Dateien

Sie können Ihre CSV-Dateien im Rohformat verwalten, indem Sie einen Texteditor verwenden oder stattdessen mit einem Tabellenkalkulationsprogramm arbeiten.

Eine CSV-Datei im Rohformat sieht wie folgt aus:

Der gleiche Katalog sieht im Tabellenformat so aus:

Wird eine Tabelle in das .csv-Format konvertiert, werden vom Programm automatisch doppelte Anführungzeichen um Zelleninhalte gelegt, damit Kommata in den Zellenwerten nicht als Spaltentrennzeichen interpretiert werden. Außerdem werden doppelte Anführungszeichen um JSON-Zeichenfolgenwerte gelegt, die in benutzerdefinierten Attributen mit mehreren Werten enthalten sind. Die Arbeit mit der Rohdatei erschwert sich hierdurch etwas. Beispiel:

• Tabelle: ["1","2","3"]
• Rohformat: "[""1"",""2"",""3""]"

Gehen Sie bei der direkten Bearbeitung einer CSV-Katalogdatei im Rohformat vorsichtig vor.

Verwenden von APIs

Sie können Attribute mit mehreren Werten mithilfe der Bereitstellungs-API in einem Mbox-Parameter als Zeichenfolgenwert übergeben, der ein escaptes JSON-Array enthält.

"execute": {
    "mboxes": [
      {
        "index": 0,
        "name": "first-mbox",
        "parameters": {
          "entity.id": "32323",
          "entity.categoryId": "My Category",
          "entity.MultiValueAttribute": "[\"X\", \"Y\", \"Z\"]"
        }
      }
    ]
  }

Informationen zur Verwendung der APIs für die Bereitstellung und Speicherung von Entitäten finden Sie in der Dokumentation der Adobe Recommendations-APIs.

Verwenden von Operatoren mit Attributen mit mehreren Werten

Wenden Sie Operatoren nur für benutzerdefinierte Attribute mit mehreren Werten in Algorithmuseinschlussregeln, Katalogregeln und Ausschlussregeln an, lautet das Ergebnis true (wahr), wenn mindestens ein Wert in der Liste die Operation (Boolesches or) erfolgreich durchläuft.

Im folgenden Beispiel lautet die Regel: message contains abc.

• ​1. Fall: entity.genre = ["ab", "bc", "de"]. Das Ergebnis lautet „false“ (falsch), da keiner der Werte abc.
• ​2. Fall: entity.genre = ["abcde","de","ef"]. Das Ergebnis lautet „true“ (wahr), da einer der Werte abc.

Im Falle negativer Operatoren müssen alle Attributwerte die Operation (Boolesches and) erfolgreich durchlaufen. Lautet der Operator beispielsweise notEquals, lautet das Ergebnis false (falsch), wenn nur ein beliebiger Wert die Operation erfüllt.

In den folgenden Abschnitten finden Sie Informationen zum Benutzerverhalten in Algorithmuseinschlussregeln, Katalogregeln und Ausschlussregeln.

Gleich

Entspricht ein beliebiger Attributwert dem eingegebenen Wert, lautet das Ergebnis true (wahr).

Beispiel: genre equals abc

• ​1. Fall: entity.genre = ["ab", "bc", "de"]. Das Ergebnis lautet „false“ (falsch), da keiner der Werte abc.
• ​2. Fall: entity.genre = ["abc", "de", "ef"]. Das Ergebnis lautet „true“ (wahr), da einer der Werte abc.
• ​3. Fall: entity.genre = ["abcde", "de", "ef"]. Das Ergebnis lautet „false“ (falsch), da abc keinem Element in der Liste entspricht.

Ist nicht gleich

Entspricht keiner der Attributwerte dem eingegebenen Wert, lautet das Ergebnis true (wahr).

Beispiel: genre not equals abc

• ​1. Fall: entity.genre = ["ab", "bc", "de"]. Das Ergebnis lautet „true“ (wahr), da keiner der Werte abc.
• ​2. Fall: entity.genre = ["abc", "de", "ef"]. Das Ergebnis lautet „false“ (falsch), da einer der Werte abc.
• ​3. Fall: entity.genre = ["abcde", "de", "ef"]. Das Ergebnis lautet „true“ (wahr), da abc keinem Element in der Liste entspricht.

Enthält

Enthält ein beliebiger Attributwert den eingegebenen Wert, lautet das Ergebnis true (wahr).

Beispiel: genre contains abc

• ​1. Fall: entity.genre = ["ab", "bc", "de"]. Das Ergebnis lautet „false“ (falsch), da keiner der Werte abc.
• ​2. Fall: entity.genre = ["abcde", "de", "ef"]. Das Ergebnis lautet „true“ (wahr), da einer der Werte abc.

Enthält nicht

Enthält keiner der Attributwerte den eingegebenen Wert, lautet das Ergebnis true (wahr).

Beispiel: genre does not contain abc

• ​1. Fall: entity.genre = ["ab", "bc", "de"]. Das Ergebnis lautet „true“ (wahr), da keiner der Werte abc.
• ​2. Fall: entity.genre = ["abcde", "de", "ef"]. Das Ergebnis lautet „false“ (falsch), da einer der Werteabc.

Beginnt mit

Beginnt ein beliebiger Attributwert mit dem eingegebenen Wert, lautet das Ergebnis true (wahr).

Beispiel: genre starts with abc

• ​1. Fall: entity.genre = ["ab", "bc", "de"]. Das Ergebnis lautet „false“ (falsch), da keiner der Werte mit abc.
• ​2. Fall: entity.genre = ["abcde", "de", "ef"]. Das Ergebnis lautet „true“ (wahr), da einer der Werte mit abc.
• ​3. Fall: entity.genre = ["ab", "de", "abc"]. Das Ergebnis lautet „true“ (wahr), da ein Wert mit abc beginnt (nicht notwendigerweise das erste Element in der Liste).

Endet mit

Endet ein beliebiger Attributwert mit dem eingegebenen Wert, lautet das Ergebnis true (wahr).

Beispiel: genre ends with abc

• ​1. Fall: entity.genre = ["ab", "bc", "de"]. Das Ergebnis lautet „false“ (falsch), da keiner der Werte mit abc.
• ​2. Fall: entity.genre = ["deabc", "de", "ef"]. Das Ergebnis lautet „true“ (wahr), da einer der Werte mit abc.

Größer als oder gleich (ausschließlich numerische Werte)

Der Attributwert wird verdoppelt. Attribute, die nicht umgewandelt werden können, werden bei Ausführung der Regel übersprungen.

Nach der Verarbeitung lautet das Ergebnis true (wahr), wenn ein beliebiger Attributwert größer als die eingegebenen Werte oder gleich den eingegebenen Werten ist.

Beispiel: price greater than or equal to 100

• ​1. Fall: entity.price = ["10", "20", "45"]. Das Ergebnis lautet „false“ (falsch), da keiner der Werte größer als oder gleich 100 ist. Der Wert de wurde übersprungen, weil er nicht verdoppelt werden kann.
• ​2. Fall: entity.price = ["100", "101", "90", "80"]. Das Ergebnis lautet „true“ (wahr), da zwei Werte größer als oder gleich 100 sind.

Kleiner als oder gleich (ausschließlich numerische Werte)

Der Attributwert wird verdoppelt. Attribute, die nicht umgewandelt werden können, werden bei Ausführung der Regel übersprungen.

Nach der Verarbeitung lautet das Ergebnis true (wahr), wenn ein beliebiger Attributwert kleiner als die eingegebenen Werte oder gleich den eingegebenen Werten ist.

Beispiel: price less than or equal to 100

• ​1. Fall: entity.price = ["101", "200", "141"]. Das Ergebnis lautet „false“ (falsch), da keiner der Werte kleiner als oder gleich 100 ist. Der Wert de wurde übersprungen, weil er nicht verdoppelt werden kann.
• ​2. Fall: entity.price = ["100", "101", "90", "80"]. Das Ergebnis lautet „true“ (wahr), da zwei Werte kleiner als oder gleich 100 sind.

Dynamische Übereinstimmungen (nur für artikelbasierte Algorithmen verfügbar)

Entspricht ein beliebiger Attributwert dem eingegebenen Wert, lautet das Ergebnis true (wahr).

Beispiel: genre matches abc

• ​1. Fall: entity.genre = ["ab", "bc", "de"]. Das Ergebnis lautet „false“ (falsch), da keiner der Werte abc.
• ​2. Fall: entity.genre = ["abc", "de", "ef"]. Das Ergebnis lautet „true“ (wahr), da einer der Werte abc.

Dynamische Nichtübereinstimmung (nur für artikelbasierte Algorithmen verfügbar)

Entspricht ein beliebiger Attributwert dem eingegebenen Wert, lautet das Ergebnis false (falsch).

Beispiel: genre does not match abc

• ​1. Fall: entity.genre = ["ab", "bc", "de"]. Das Ergebnis lautet „true“ (wahr), da keiner der Werte abc.
• ​2. Fall: entity.genre = ["abc", "de", "ef"]. Das Ergebnis lautet „false“ (falsch), da einer der Werte abc.

Dynamische Bereiche (nur für artikelbasierte Algorithmen verfügbar, ausschließlich numerische Werte)

Liegt ein numerischer Attributwert innerhalb des angegebenen Bereichs, lautet das Ergebnis true (wahr).

Beispiel: price dynamically ranges in 80% to 120% of 100

• ​1. Fall: entity.price = ["101", "200", "125"]. Das Ergebnis lautet „true“ (wahr), da 101 im Bereich von 80% bis 120% von 100 liegt. Der Wert de wurde übersprungen, weil er nicht verdoppelt werden kann.
• ​2. Fall: entity.price = ["130", "191", "60", "75"]. Das Ergebnis lautet „false“ (falsch), da keiner der Werte im Bereich zwischen 80 und 120 % von 100 liegt.

Attribute mit mehreren Werten in Entwürfen

Attribute mit mehreren Werten werden als kommagetrennte Liste angezeigt, wenn in einem Entwurf auf sie verwiesen wird.

Beispiel:

Wenn auf entity.genre=["genre1","genre2"] in einem Entwurf als $entity<N>.genre verwiesen wird, lautet das Ergebnis genre1, genre2.

Verwandte Themen:

• Entitätsattribute