[Premium]{class="badge positive" title="Se vad som ingår i Target Premium."}

Entitetsattribut

Använd entitetsattribut för att skicka produkt- eller innehållsinformation till Adobe Target Recommendations.

Enheter refererar till de objekt som du vill rekommendera. Exempel på organisationer är produkter, innehåll (artiklar, bildspel, bilder, filmer och TV-program), jobblistor, restauranger och så vidare.

Recommendations skickar productId eller productPurchasedId (kallas entity.id i koden) som används i algoritmerna.

Tänk på följande:

De flesta fördefinierade parametrar accepterar endast ett värde, med nya värden som skriver över gamla värden. The categoryId parametern kan acceptera en kommaavgränsad lista med värden för varje kategori som innehåller den produkten. Nytt categoryId värden skriver inte över befintliga värden, utan läggs i stället till under entitetsuppdatering (högst 250 tecken).

I allmänhet ser visningsinformationsrutan ut som i följande exempel om du använder at.js 1.x med mboxCreate. Alla entitetsparameterattribut är skiftlägeskänsliga.

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

Om mbox finns på en produktsida kan du inkludera både produkt-ID och kategori-ID. Den valda algoritmen avgör vilka som visas. Produkt-ID används för tillhörighetsalgoritmer och kategori-ID används för kategorialgoritmer.

Tillgängliga variabler

I följande lista beskrivs de tillgängliga variablerna.

entity.id

Endast ett värde.

Den här obligatoriska parametern identifierar produkten. Detta alfanumeriska ID måste vara detsamma för alla Adobe Experience Cloud produkter som används, inklusive Analytics, för de olika produkterna för att identifiera artikeln och dela data om den.

The entity.id värden måste not innehåller mellanslag, snedstreck, et-tecken, frågetecken, procentsymboler, kommatecken eller andra skiljetecken som kräver URL-kodning när de skickas i ett REST API-anrop. Bindestreck och understreck tillåts. Inkludera ogiltig interpunktion i en entity.id värde orsakar vissa Recommendations funktioner som ska misslyckas.

Exempel: 'entity.id=67833'

entity.name

Endast ett värde.

Det produktnamn som visas på webbplatsen när produkten rekommenderas.

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

entity.categoryId

Stöder flera värden (kommaavgränsad lista).

Den aktuella sidans kategori. Entity.categoryID kan innehålla flera kategorier, t.ex. underavsnittet cardigans (t.ex. womens, womens:sweaters, womens:sweaters:cardigans). Flera kategorier måste avgränsas med kommatecken.

The categoryId värdet är begränsat till 250 tecken.

Exempel:

För kategoribaserade rekommendationer avgränsar ett kommatecken kategorivärdet. Alla värden som avgränsas med kommatecken blir kategorier. Du kan också definiera underkategorier genom att använda en annan avgränsare, t.ex. ett kolon (:), för att skilja underkategorier inom kategorivärdet.

I följande kod delas kategorin Kvinnor in i flera underkategorier:

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 leverans av mbox används det längsta attributnamnet för nyckeln. Om det finns en slips används det sista attributet. I exemplet ovan är kategorinyckeln Womens:Outerwear:Jackets:Caban.

entity.brand

Endast ett värde.

Visar ett objekts varumärke.

Exempel: 'entity.brand=brandxyz'

entity.pageUrl

Endast ett värde.

Definierar den relativa URL-adressen till sidan där objektet kan köpas.

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

entity.thumbnailUrl

Endast ett värde.

Definierar den relativa URL-adressen till miniatyrbilden som visas med objektet.

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

entity.message

Endast ett värde.

Ett meddelande om produkten som visas i rekommendationen, t.ex."vid försäljning" eller"godkännande". Meddelandet är vanligtvis mer detaljerat än produktnamnet. Använd entity.message för att definiera ytterligare information som ska visas med produkten i mallen.

Exempel: 'entity.message=Family special'

entity.inventory

Endast ett värde. Kräver ett heltal eller ett långt värde.

Visar artikelns lagernivå.

Exempel: 'entity.inventory=1'

Tom attributhantering för lager: För leverans, om du har en inkluderingsregel, samlingsregel eller kriterieinställning med entity.inventory > 0 eller entity.inventory = 0 och produkten har inget lager angivet, Target utvärderar det här värdet till TRUE och inkluderar produkter där lagret inte är inställt. Detta resulterar i att produkter med lager som inte är inställda visas i rekommendationsresultat.

Om du har en global exkluderingsregel med entity.inventory = 0 och entity.inventory är inte inställd, Target utvärderar den här regeln till TRUE och utesluter produkten.

Känt fel: Produktsökningen är inkonsekvent med leveransen för lagervärdesattribut som inte har angetts. Till exempel för en regel med entity.inventory = 0, Produktsökning visar inte produkter där lagervärdet inte har angetts.

entity.value

Endast ett värde.

Definierar pris eller värde för artikeln.

Exempel: 'entity.value=15.99'

entity.value stöder endast decimalformat (till exempel 15.99). Kommaformatet (15,99) stöds inte.

entity.margin

Endast ett värde.

Vinstmarginalen eller annat värde för artikeln.

Exempel: 'entity.margin=1.00'

enhet.anpassad

Stöder flervärdesmatris (JSON-matris).

Definiera upp till 100 anpassade variabler som innehåller ytterligare information om objektet. Du kan ange vilket attributnamn som inte används för varje anpassat attribut. Du kan till exempel skapa ett anpassat attribut med namnet entity.genre för att definiera en bok eller film. En biljettleverantör kan skapa attribut för en evenemangsplats för en sekundär utförare, till exempel ett besöksteam i ett idrottsevenemang eller en öppningsakt på en konsert.

Begränsningar:

Exempel:

'entity.venue=AT&T Park'

'entity.secondary=Rockies'

Anpassade entitetsattribut har stöd för flera värden. Se Anpassade entitetsattribut för tecken- och värdegränser.

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

Anpassade entitetsattribut med flera värden kräver giltiga JSON-matriser. Korrekt syntaxinformation finns i Anpassade entitetsattribut.

entity.event.detailsOnly

Endast ett värde.

Används för att förhindra att ett mbox-anrop ökar beteendedataräknare för en algoritm.

Exempel: 'entity.event.detailsOnly=true'

I exemplen nedan uppdaterar det första mbox-anropet katalogen och beteendedata. Det andra mbox-anropet uppdaterar bara katalogen.

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