[Premium]{class="badge positive" title="Erfahren Sie, was in Target Premium enthalten ist."}

Entitätsattribute

Verwenden Sie Entitätsattribute, um Produkt- oder Inhaltsinformationen an Adobe Target Recommendations zu übergeben.

Entitäten beziehen sich auf die Artikel, die Sie empfehlen möchten. Entitäten können Produkte, Inhalte (Artikel, Diashows, Bilder, Filme und Fernsehsendungen), Stellenausschreibungen, Restaurants usw. umfassen.

Recommendations sendet den in den Algorithmen verwendeten productId oder productPurchasedId (im Code als entity.id bezeichnet).

Beachten Sie Folgendes:

  • entity.id muss mit dem productPurchasedId übereinstimmen, der an die Bestellbestätigungsseite gesendet wird, und mit dem productId, der in Adobe Analytics -Produktberichten verwendet wird.
  • Die Entitätsattributwerte, die Sie an Recommendations übergeben, laufen nach 61 Tagen ab. Adobe empfiehlt, den neuesten Wert jedes Entitätsattributs für jedes Element in Ihrem Katalog mindestens einmal monatlich an Recommendations zu übergeben.

Die meisten vordefinierten Parameter akzeptieren nur einen einzigen Wert, wobei neue Werte alte Werte überschreiben. Der categoryId-Parameter kann für jede Kategorie, in der das Produkt enthalten ist, eine kommagetrennte Liste mit Werten akzeptieren. Neue categoryId-Werte überschreiben die vorhandenen Werte nicht mehr, sondern werden bei einer Entitätsaktualisierung angehängt (Längenbeschränkung von 250 Zeichen).

Im Allgemeinen sieht die Mbox mit den Anzeigeinformationen wie im folgenden Beispiel aus, wenn Sie at.js 1 verwenden.x mit mboxCreate. Bei allen Entitätsparameterattributen wird zwischen Groß- und Kleinschreibung unterschieden.

NOTE
Wenn Sie at.js 2.x, mboxCreate (wie im folgenden Beispiel verwendet) wird nicht mehr unterstützt. Übergeben von Produkt- oder Inhaltsinformationen an Recommendations mithilfe von at.js 2.x, verwenden Sie targetPageParams. Ein Beispiel finden Sie unter Planen und Implementieren von Recommendations.
<div class="mboxDefault"></div><script language="JavaScript1.2">

mboxCreate('productPage',

'entity.id=67833',

'entity.name=GIANTS VS ROCKIES 5/12',

'entity.categoryId=BASEBALL, GIANTS, SF BAY AREA',

'entity.pageUrl=/help/baseball/giants-tix/giantsvrockies5.12.2000-67833',

'entity.venue=AT&T PARK',

'entity.secondary=ROCKIES',

'entity.thumbnailUrl=/help/baseball/giants-tix/giants-136px.gif',

'entity.message=FAMILY SPECIAL',

'entity.value=15.99',

'entity.inventory=1'

);

</script>
NOTE
Relative URLs werden für pageUrl und thumbnailUrl im Gegensatz zu absoluten URLs bevorzugt, da die Empfehlungen aus allen Umgebungen auf Ihrer Site Daten empfangen. Durch die Verwendung von relativen URLs werden fest codierte Links auf Staging- oder Entwicklungsserver vermieden.

Wenn sich die Mbox auf einer Produktseite befindet, können Sie sowohl die Produkt-ID als auch die Kategorie-ID aufnehmen. Der gewählte Algorithmus bestimmt, was angezeigt wird. Die Produkt-ID wird für Affinitätsalgorithmen und die Kategorie-ID für Kategoriealgorithmen verwendet.

Verfügbare Variablen

Die folgende Liste beschreibt die verfügbaren Variablen.

entity.id

Nur einzelner Wert.

Dieser erforderliche Parameter identifiziert das Produkt. Diese alphanumerische ID muss für alle Adobe Experience Cloud -Produkte gleich sein, einschließlich Analytics, damit die verschiedenen Produkte das Element erkennen und Daten darüber austauschen.

Die entity.id -Werte dürfen nicht Leerzeichen, Schrägstriche, kaufmännische Und-Zeichen, Fragezeichen, Prozentzeichen, Kommas oder andere Satzzeichen enthalten, die bei der Übergabe in einem REST-API-Aufruf eine URL-Kodierung erfordern. Bindestriche und Unterstriche sind zulässig. Wenn in einem entity.idRecommendations-Wert ungültige Satzzeichen enthalten sind, schlagen manche fehl.

Beispiel: 'entity.id=67833'

entity.name

Nur einzelner Wert

Der Produktname, der auf der Site angezeigt wird, wenn das Produkt empfohlen wird.

Beispiel: 'entity.name=Giants& vs& Rockies& 5/12'

entity.categoryId

Mehrere Werte werden unterstützt (kommagetrennte Liste).

Kategorie der aktuellen Seite. Die entity.categoryID kann mehrere Kategorien umfassen, wie z. B. einen Cardigans-Unterabschnitt (z. B. womens, womens:sweaters, womens:sweaters:cardigans). Mehrere Kategorien müssen durch Kommas getrennt werden.

Der Wert categoryId ist auf 250 Zeichen begrenzt.

NOTE
Um eine Empfehlung basierend auf einer Kategorie auf einer Category -Seite anzuzeigen, kann nur ein categoryId an die Mbox übergeben werden, die zur Anzeige dieser Empfehlung verwendet wird. Der Wert von categoryId muss genau mit dem Wert von entity.categoryId übereinstimmen, der auf der Seite Product Detail übergeben wird.

Beispiele:

  • Beispiel-Produktdetailseite: womens, womens:sweaters, womens:sweaters:cardigans
  • Beispiel für Kategorieseiten-Pullover: womens:sweaters
  • Beispiel für Kategorieseiten-Cardigans: womens:sweaters:cardigans

Bei kategoriebasierten Empfehlungen wird der Kategoriewert durch ein Komma getrennt. Alle durch Kommas getrennten Werte sind dann Kategorien. Sie können auch Unterkategorien mit einem anderen Trennzeichen, beispielsweise einem Doppelpunkt (:), definieren, um Unterkategorien innerhalb des Kategoriewerts zu trennen.

Im folgenden Code wird beispielsweise die Kategorie "Frauen"in mehrere Unterkategorien unterteilt:

mboxCreate('mboxName', 'entity.id=343942-32', 'entity.categoryId= Womens, Womens:Outerwear, Womens:Outerwear:Jackets, Womens:Outerwear:Jackets:Parka, Womens:Outerwear:Jackets:Caban', 'entity.thumbnailUrl=...', 'entity.message=...', );

Für die MBox-Bereitstellung wird der längste Attributname für den Schlüssel verwendet. Wenn eine Bindung vorhanden ist, wird das letzte Attribut verwendet. Im obigen Beispiel ist der Kategorieschlüssel Womens:Outerwear:Jackets:Caban.

entity.brand

Nur einzelner Wert

Zeigt den Markennamen eines Artikels an.

Beispiel: 'entity.brand=brandxyz'

entity.pageUrl

Nur einzelner Wert

Definiert die relative URL der Seite, auf der der Artikel zum Kauf angeboten wird.

Beispiel: 'entity.pageUrl=baseball/giants-tix/giantsvrockies5.12.2000-67833'

entity.thumbnailUrl

Nur einzelner Wert

Definiert die relative URL zum Miniaturbild, das mit dem Artikel angezeigt wird.

Beispiel: 'entity.thumbnailUrl=baseball/giants-tix/giants-136px.gif'

entity.message

Nur einzelner Wert

Eine Botschaft zu dem in der Empfehlung angezeigten Produkt, wie zum Beispiel „Im Angebot“ oder „Ausverkauf“. Die Botschaft ist in der Regel ausführlicher als der Produktname. Verwenden Sie entity.message , um zusätzliche Informationen zu definieren, die mit dem Produkt in der Vorlage angezeigt werden.

Beispiel: 'entity.message=Family&nbsp;special'

entity.inventory

Nur einzelner Wert Erfordert eine Ganzzahl oder einen langen Wert.

Zeigt den Lagerbestand des Artikels.

Beispiel: 'entity.inventory=1'

Umgang mit leeren Lagerattributen: Wenn Sie für die Bereitstellung eine Einschlussregel, eine Erfassungsregel oder eine Kriterieneinstellung mit entity.inventory > 0 oder entity.inventory = 0 haben und das Produkt den Lagerbestand nicht festgelegt hat, wertet Target diesen Wert auf TRUE aus und schließt Produkte ein, bei denen der Bestand nicht festgelegt ist. Daher werden Produkte mit nicht festgelegtem Inventar in Empfehlungsergebnissen angezeigt.

Wenn Sie eine globale Ausschlussregel mit entity.inventory = 0 und entity.inventory nicht festgelegt haben, wird diese Regel von Target auf TRUE gesetzt und das Produkt ausgeschlossen.

Bekanntes Problem: Die Produktsuche ist nicht mit der Bereitstellung für nicht festgelegte Bestandswertattribute konsistent. Beispiel: Für eine Regel mit entity.inventory = 0 zeigt die Produktsuche keine Produkte an, bei denen der Bestandswert nicht festgelegt ist.

entity.value

Nur einzelner Wert

Definiert den Preis oder Wert des Artikels.

Beispiel: 'entity.value=15.99'

entity.value unterstützt nur das Dezimalformat (z. B. 15.99). Das Kommaformat (15,99) wird nicht unterstützt.

entity.margin

Nur einzelner Wert

Die Gewinnspanne oder ein anderer Wert des Artikels.

Beispiel: 'entity.margin=1.00'

Entität.custom

Mehrere Werte werden unterstützt (JSON-Array).

Definieren Sie bis zu 100 benutzerspezifische Variablen, um weitere Informationen zum Artikel bereitzustellen. Sie können jeden nicht bereits in Gebrauch befindlichen Attributnamen für die benutzerspezifischen Attribute verwenden. Sie können beispielsweise ein benutzerdefiniertes Attribut mit dem Namen entity.genre erstellen, um ein Buch oder einen Film zu definieren. Ein Ticketverkäufer kann Attribute für einen Veranstaltungsort für einen zusätzlichen Auftritt erstellen, z. B. ein weiteres Team, das bei einer Sportveranstaltung mitwirkt, oder eine Vorgruppe bei einem Konzert.

Einschränkungen:

  • Sie können keine voreingestellten Entitätsattributnamen für benutzerdefinierte Entitätsattribute verwenden.
  • Das Attribut entity.environment ist vom System reserviert und kann nicht für benutzerdefinierte Entitätsattribute verwendet werden. Versuche, entity.environment mit targetPageParams, Feed oder API zu übermitteln, werden ignoriert.

Beispiele:

'entity.venue=AT&T&nbsp;Park'

'entity.secondary=Rockies'

Benutzerdefinierte Entitätsattribute unterstützen mehrere Werte. Siehe Benutzerdefinierte Entitätsattribute für Zeichen- und Wertbeschränkungen.

Beispiel: 'entity.secondary=["band1",&nbsp;"band2"]'

Benutzerdefinierte Entitätsattribute mit mehreren Werten erfordern gültige JSON-Arrays. Informationen zur korrekten Syntax finden Sie unter Benutzerdefinierte Entitätsattribute.

entity.event.detailsOnly

Nur einzelner Wert

Wird dazu verwendet zu verhindern, dass durch einen Mbox-Aufruf der Zähler für Verhaltensdaten eines Algorithmus ansteigt.

Beispiel: 'entity.event.detailsOnly=true'

In den Beispielen unten aktualisiert der erste Mbox-Aufruf den Katalog und die Verhaltensdaten. Der zweite Mbox-Aufruf aktualisiert nur den Katalog.

mboxCreate('myMbox', 'profile.geo.city = new york', 'profile.geo.state = new york',  'entity.id = 'entity.inventory = 4' )
mboxCreate('myMbox',  'profile.geo.city = new york', 'profile.geo.state = new york',  'entity.id = 123', 'entity.inventory = 4' 'entity.event.detailsOnly=true' )
recommendation-more-help
3d9ad939-5908-4b30-aac1-a4ad253cd654