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

Aangepaste entiteitskenmerken

Aangepaste entiteitskenmerken voor één en meerdere waarden gebruiken in Adobe Target Recommendations om aanvullende informatie over items in uw catalogus te definiëren.

Limieten limits

U kunt maximaal 100 aangepaste entiteitskenmerken opnemen om aanvullende informatie over items in uw catalogus te definiëren. U kunt bijvoorbeeld een aangepast kenmerk maken met de naam entity.genre om een boek of een film te definiëren. Of een verkoper van tickets kan kenmerken maken voor een plaats van de gebeurtenis, zodat een tweede uitvoerder, zoals een bezoekend team, kan deelnemen aan een sportevenement of een openingsactie bij een concert.

De maximale lengte van aangepaste kenmerken van entiteiten met een enkele waarde is 15.000 tekens (voor UTF-8-gecodeerde talen van één en twee bytes, zoals Engels en andere Latijnse alfabeten) of 10.000 tekens (voor UTF-8-gecodeerde talen van drie bytes, zoals Chinees, Japans en Koreaans).

Aangepaste kenmerken van entiteiten met meerdere waarden mogen niet meer dan 500 waarden bevatten. Elke individuele waarde is beperkt tot 100 tekens. Het totale aantal tekens voor alle waarden moet in overeenstemming zijn met de beperkingen voor de maximumlengte van aangepaste attributen voor entiteiten met één waarde (zie hierboven).

Kenmerkwaarden van aangepaste entiteit section_313331A9F8194A89B5EDD89363018651

Aangepaste entiteitskenmerken kunnen één waarde of meerdere waarden bevatten. Kenmerkwaarden voor entiteit worden weergegeven in de productweergave.

Een attribuut van de douaneentiteit met één enkele waarde wordt gevormd de zelfde manier zoals een enig-waarde vooraf bepaald entiteitsattribuut:

entity.genre=genre1

Een attribuut van een aangepaste entiteit met meerdere waarden moet worden verzonden als een geldige JSON-array:

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

Voorbeelden van geldige JSON-arrays die door Recommendations:

Nadat een aangepast kenmerk is verzonden als een geldige JSON-array, wordt het kenmerk behandeld als een kenmerk met meerdere waarden voor alle producten in de catalogus.

Beperkingen:

Meerdere-waardekenmerken implementeren section_80FEFE49E8AF415D99B739AA3CBA2A14

Aangepaste entiteitskenmerken met meerdere waarden worden ondersteund bij gebruik van feeds (CSV). targetPageParamsen de leverings-API om producten te uploaden. Nieuwe waarden vervangen huidige waarden; ze worden niet toegevoegd. Lege arrays ( [] ) worden beschouwd als zijnde zonder waarden.

Dubbele aanhalingstekens moeten worden vermeden. Bijvoorbeeld: "[""test"", ""value""]" is een geldige JSON-array die kan worden gebruikt in CSV.

U kunt maximaal 500 waarden opnemen in een kenmerk met meerdere waarden.

targetPageParams gebruiken

In het volgende voorbeeld wordt getoond hoe u 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]'
  };
}

CSV gebruiken

U kunt uw CSV-bestanden in onbewerkte vorm beheren met een teksteditor of u kunt spreadsheetsoftware gebruiken.

De onbewerkte CSV ziet er als volgt uit:

Dezelfde catalogus ziet er zo uit in een spreadsheet:

Bij de conversie naar de CSV-indeling worden dubbele aanhalingstekens toegevoegd rondom de celinhoud om te voorkomen dat komma's binnen de cel fungeren als kolomscheidingstekens. Er worden ook dubbele aanhalingstekens toegevoegd rondom JSON-tekenreekswaarden die u opneemt in aangepaste multiwaardekenmerken. Hierdoor kan het werken met het Raw-bestand lastig zijn. Bijvoorbeeld:

Wees voorzichtig wanneer u een CSV-bestand met een Raw-catalogus rechtstreeks bewerkt.

API's gebruiken

U kunt kenmerken met meerdere waarden doorgeven met de API voor aflevering in een mabox-parameter als een tekenreekswaarde die een JSON-array met escape-teken bevat.

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

Zie de Adobe Recommendations API-documentatie voor informatie over het gebruik van de API's voor levering en opslaan van entiteiten.

Operatoren met kenmerken van meerdere waarden gebruiken section_83C2288A805242D9A02EBC4F07DEE945

Wanneer u operatoren toepast op aangepaste attributen met meerdere waarden in regels voor het opnemen van algoritmen, catalogusregels en uitsluitingsregels, wordt het resultaat true als ten minste één waarde in de lijst de bewerking doorgeeft (boolean) of).

In het volgende voorbeeld is de regel message contains abc.

Voor negatieve operatoren moeten alle kenmerkwaarden worden doorgegeven (boolean) en). Als de operator bijvoorbeeld notEquals, zal het resultaat false als een waarde overeenkomt.

Raadpleeg de volgende secties voor het gedrag van de operator in regels voor het opnemen van algoritmen, catalogusregels en uitsluitingsregels.

Gelijk

Als een kenmerkwaarde gelijk is aan de invoerwaarde, resulteert dit in true.

Voorbeeld: genre equals abc

Is niet gelijk aan

Als geen kenmerkwaarde gelijk is aan de invoerwaarde, resulteert dit in true.

Voorbeeld: genre not equals abc

Bevat

Als een waarde van een kenmerk de invoerwaarde bevat, resulteert dit in true.

Voorbeeld: genre contains abc

Bevat niet

Als geen waarde van kenmerk de invoerwaarde bevat, resulteert dit in true.

Voorbeeld: genre does not contain abc

Begint met

Als een waarde van een kenmerk begint met de invoerwaarde, resulteert dit in true.

Voorbeeld: genre starts with abc

Eindigt met

Als een waarde van een kenmerk eindigt met de invoerwaarde, resulteert dit in true.

Voorbeeld: genre ends with abc

Groter dan of gelijk aan (alleen numerieke waarden)

Kenmerkwaarde wordt omgezet in dubbel. Kenmerken die niet kunnen worden omgezet, worden overgeslagen tijdens het uitvoeren van de regel.

Na verwerking resulteert een kenmerkwaarde die groter is dan of gelijk is aan de invoerwaarde in true.

Voorbeeld: price greater than or equal to 100

Kleiner dan of gelijk aan (alleen numerieke waarden)

Kenmerkwaarde wordt omgezet in dubbel. Kenmerken die niet kunnen worden omgezet, worden overgeslagen tijdens het uitvoeren van de regel.

Na verwerking resulteert een kenmerkwaarde die kleiner is dan of gelijk is aan de invoerwaarde in true.

Voorbeeld: price less than or equal to 100

Dynamisch overeenkomt (alleen beschikbaar in op items gebaseerde algoritmen)

Als een kenmerkwaarde overeenkomt met de invoerwaarde, resulteert dit in true.

Voorbeeld: genre matches abc

Komt dynamisch niet overeen (alleen beschikbaar in op items gebaseerde algoritmen)

Als een kenmerkwaarde overeenkomt met de invoerwaarde, resulteert dit in false.

Voorbeeld: genre does not match abc

Dynamisch bereik (alleen beschikbaar in op items gebaseerde algoritmen, alleen numerieke waarden)

Als een numerieke kenmerkwaarde binnen het opgegeven bereik ligt, resulteert dit in true.

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

Kenmerken met meerdere waarden in ontwerpen section_F672E4F6E1D44B3196B7ADE89334ED4A

Kenmerken met meerdere waarden worden weergegeven als een lijst met door komma's gescheiden waarden wanneer hiernaar wordt verwezen in een ontwerp.

Voorbeeld:

Wanneer entity.genre=["genre1","genre2"] in een ontwerp wordt ernaar verwezen als $entity<N>.genre, het resultaat genre1, genre2.

Verwante onderwerpen: