[Premium]{class="badge positive" title="Kijk wat er in Target Premium is opgenomen."}

Entiteitskenmerken

Gebruik entiteitskenmerken om product- of inhoudsinformatie door te geven aan Adobe Target Recommendations .

Entiteiten verwijzen naar de items die u wilt aanbevelen. De entiteiten kunnen producten, inhoud (artikelen, diashows, beelden, films, en televisieprogramma's), baanaanbiedingen, restaurants, etc. omvatten.

Recommendations verzendt productId of productPurchasedId (in de code entity.id genoemd) die in de algoritmen wordt gebruikt.

Overweeg het volgende:

De meeste vooraf gedefinieerde parameters accepteren slechts één waarde, waarbij nieuwe waarden oude waarden overschrijven. De parameter categoryId kan een door komma's gescheiden lijst met waarden accepteren voor elke categorie die dat product bevat. Nieuwe categoryId -waarden overschrijven geen bestaande waarden, maar worden toegevoegd tijdens het bijwerken van een entiteit (limiet van 250 tekens).

In het algemeen ziet het informatievenster voor de weergave er als in het volgende voorbeeld uit als u at.js 1 gebruikt.x met mboxCreate. Alle attributen van de entiteitparameter zijn case-sensitive.

<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>

Als het selectievakje op een productpagina staat, kunt u zowel de product-id als de categorie-id opnemen. Het geselecteerde algoritme bepaalt welke weergaven worden weergegeven. De product-id wordt gebruikt voor affiniteitsalgoritmen en de categorie-id wordt gebruikt voor categoriealgoritmen.

Beschikbare variabelen

In de volgende lijst worden de beschikbare variabelen beschreven.

entity.id

Alleen randwaarde.

Deze vereiste parameter identificeert het product. Deze alfanumerieke id moet hetzelfde zijn voor alle gebruikte Adobe Experience Cloud producten, inclusief Analytics , zodat de verschillende producten het item herkennen en er gegevens over kunnen delen.

De entity.id waarden moeten ** geen ruimten, schuine strepen, ampersands, vraagtekens, percentagesymbolen, komma's, of andere leestekens bevatten die URL het coderen wanneer overgegaan in een REST API vraag vereisen. Afbreekstreepjes en onderstrepingstekens zijn toegestaan. Het opnemen van ongeldige interpunctie in een entity.id -waarde leidt tot een fout in de Recommendations -functionaliteit.

Voorbeeld: 'entity.id=67833'

entity.name

Alleen één waarde.

De productnaam die op de Website wordt getoond wanneer het product wordt geadviseerd.

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

entity.categoryId

Ondersteunt meerdere waarden (door komma's gescheiden lijst).

Categorie van de huidige pagina. De entity.categoryID kan meerdere categorieën bevatten, zoals een subsectie voor cardigans (bijvoorbeeld womens , womens:sweaters , womens:sweaters:cardigans ). Meerdere categorieën moeten worden gescheiden door komma's.

De waarde categoryId mag maximaal 250 tekens bevatten.

Voorbeelden:

Voor op categorieën gebaseerde aanbevelingen wordt de categoriewaarde met een komma van elkaar gescheiden. Waarden die door komma's worden gescheiden, worden categorieën. U kunt ook subcategorieën definiëren door een ander scheidingsteken, zoals een dubbele punt (:), te gebruiken om subcategorieën binnen de categoriewaarde te scheiden.

In de volgende code is de categorie Vrouwen bijvoorbeeld onderverdeeld in verschillende subcategorieën:

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=...', );

Voor de levering mbox, wordt de langste kenmerknaam gebruikt voor de sleutel. Als er een tijd is, wordt het laatste kenmerk gebruikt. In het bovenstaande voorbeeld is de categorietoets Womens:Outerwear:Jackets:Caban .

entity.brand

Alleen één waarde.

Geeft de merknaam van een item weer.

Voorbeeld: 'entity.brand=brandxyz'

entity.pageUrl

Alleen één waarde.

Definieert de relatieve URL van de pagina waarop het item kan worden aangeschaft.

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

entity.thumbnailUrl

Alleen één waarde.

Definieert de relatieve URL ten opzichte van de miniatuurafbeelding die bij het item wordt weergegeven.

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

entity.message

Alleen één waarde.

Een bericht over het product dat in de aanbeveling wordt getoond, zoals "bij verkoop" of "klaring". Het bericht is doorgaans uitgebreider dan de productnaam. Gebruik entity.message om aanvullende informatie te definiëren die met het product in de sjabloon moet worden weergegeven.

Voorbeeld: 'entity.message=Family special'

entity.inventory

Alleen één waarde. Vereist een geheel getal of een lange waarde.

Hiermee geeft u het voorraadniveau van het item weer.

Voorbeeld: 'entity.inventory=1'

de Lege Behandeling van de Attributen van de Inventaris: voor levering, als u een inclusieregel, inzamelingsregel, of criteria die met entity.inventory > 0 of entity.inventory = 0 hebt plaatsen en het product inventaris niet heeft, Target evalueert deze waarde aan WAAR en omvat producten waar de inventaris niet wordt geplaatst. Dit heeft tot gevolg dat producten met een voorraad die niet is ingesteld, in de resultaten van aanbevelingen worden weergegeven.

En als u een algemene uitsluitingsregel hebt met entity.inventory = 0 en entity.inventory niet is ingesteld, evalueert Target deze regel als TRUE en wordt het product uitgesloten.

Bekende kwestie: het Onderzoek van het Product is inconsistent met levering voor de attributen van de inventariswaarde die niet worden geplaatst. Voor een regel met entity.inventory = 0 geeft productzoekopdracht bijvoorbeeld geen producten weer waarvoor de inventariswaarde niet is ingesteld.

entity.value

Alleen één waarde.

Hiermee definieert u de prijs of waarde van het item.

Voorbeeld: 'entity.value=15.99'

entiteit.value ondersteunt alleen decimale notatie (bijvoorbeeld 15.99). De komma-indeling (15,99) wordt niet ondersteund.

entity.margin

Alleen één waarde.

De winstmarge of andere waarde van de post.

Voorbeeld: 'entity.margin=1.00'

entiteit.douane

Ondersteunt multivalue (JSON-array).

Definieer maximaal 100 aangepaste variabelen die aanvullende informatie over het item bevatten. U kunt elke ongebruikte kenmerknaam opgeven voor elk aangepast kenmerk. U kunt bijvoorbeeld een aangepast kenmerk met de naam entity.genre maken om een boek of film te definiëren. Een verkoper van vervoerbewijzen kan kenmerken voor een gebeurtenisplaats voor een secundaire uitvoerder, zoals een bezoekend team in een sportevenement of een openingsactie in een concert tot stand brengen.

Beperkingen:

Voorbeelden:

'entity.venue=AT&T Park'

'entity.secondary=Rockies'

Aangepaste entiteitskenmerken ondersteunen meerdere waarden. Zie de entiteitattributen van de Douanevoor karakter en waardegrenzen.

Voorbeeld: 'entity.secondary=["band1", "band2"]'

Aangepaste entiteitskenmerken van meerdere waarden vereisen geldige JSON-arrays. Voor correcte syntaxisinformatie, zie {de Attributen van de Entiteit van 0} Douane .

entity.event.detailsOnly

Alleen één waarde.

Gebruikt om een mbox vraag te verhinderen gedragstellers van gegevens voor een algoritme te verhogen.

Voorbeeld: 'entity.event.detailsOnly=true'

In de onderstaande voorbeelden werkt de eerste mbox-aanroep de catalogus en gedragsgegevens bij. De tweede mbox-aanroep werkt alleen de catalogus bij.

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' )