[Premium]{class="badge positive" title="Voir ce qui est inclus dans Target Premium."}

Attributs d’entité

Utilisez les attributs d’entité pour transmettre des informations sur les produits ou le contenu aux Adobe Target Recommendations.

Les entités font référence aux éléments que vous voulez recommander. Les entités peuvent inclure des produits, du contenu (articles, diaporamas, images, films et émissions télévisées), des offres d’emploi, des restaurants, etc.

Recommendations envoie le productId ou le productPurchasedId (appelé entity.id dans le code) utilisé dans les algorithmes.

Tenez compte des points suivants :

La plupart des paramètres prédéfinis n’acceptent qu’une seule valeur, les nouvelles valeurs remplaçant les anciennes. Le paramètre categoryId peut accepter une liste de valeurs délimitées par des virgules pour chaque catégorie contenant ce produit. Les nouvelles valeurs categoryId n’écrasent pas les valeurs existantes, mais sont ajoutées lors de la mise à jour de l’entité (250 caractères maximum).

En règle générale, la mbox des informations d’affichage ressemble à l’exemple suivant si vous utilisez at.js 1.x avec mboxCreate. Tous les attributs de paramètre d’entité sont sensibles à la casse.

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

Si la mbox se situe sur une page de produit, vous pouvez inclure l’identifiant du produit et l’identifiant de sa catégorie. L’algorithme sélectionné détermine ce qui s’affiche. L’identifiant du produit est utilisé pour les algorithmes d’affinité et l’identifiant de la catégorie, pour les algorithmes de catégorie.

Variables disponibles

La liste ci-dessous décrit les variables disponibles.

entity.id

Une seule valeur uniquement.

Ce paramètre obligatoire identifie le produit. Cet ID alphanumérique doit être le même dans tous les produits Adobe Experience Cloud utilisés, y compris Analytics, pour que les différents produits reconnaissent l’élément et partagent les données le concernant.

Les valeurs entity.id ne doivent pas contenir d’espaces, de barres obliques, d’esperluettes, de points d’interrogation, de symboles de pourcentage, de virgules ou d’autres caractères de ponctuation qui nécessitent un codage d’URL lors de leur transmission dans un appel API REST. Les tirets et les traits de soulignement sont autorisés. Le fait d’inclure des signes de ponctuation non autorisés dans une valeur entity.id entraîne l’échec de certaines fonctionnalités de Recommendations.

Exemple : 'entity.id=67833'

entity.name

Une seule valeur uniquement.

Nom du produit affiché sur le site web lorsque ce produit est recommandé.

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

entity.categoryId

Prend en charge plusieurs valeurs (liste délimitée par des virgules).

Catégorie de la page en cours. entity.categoryID peut inclure plusieurs catégories, telles qu’une sous-sous-section de cardigans (par exemple, womens, womens:sweaters, womens:sweaters:cardigans). Plusieurs catégories doivent être séparées par des virgules.

La valeur categoryId est limitée à 250 caractères.

Exemples :

Pour les recommandations basées sur des catégories, une virgule sépare la valeur de la catégorie. Toutes les valeurs séparées par des virgules deviennent des catégories. Vous pouvez également définir des sous-catégories en utilisant un autre séparateur, tel que les deux-points (:), pour séparer les sous-catégories au sein de la valeur de catégorie.

Par exemple, dans le code suivant, la catégorie Femmes est divisée en plusieurs sous-catégories :

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

Pour la diffusion de mbox, le nom d’attribut le plus long est utilisé pour la clé. S’il existe un lien, le dernier attribut est utilisé. Dans l’exemple ci-dessus, la clé de catégorie est Womens:Outerwear:Jackets:Caban.

entity.brand

Une seule valeur uniquement.

Affiche le nom de marque d’un élément.

Exemple : 'entity.brand=brandxyz'

entity.pageUrl

Une seule valeur uniquement.

Définit l’URL relative de la page dans laquelle l’élément peut être acheté.

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

entity.thumbnailUrl

Une seule valeur uniquement.

Définit l’URL relative de l’image miniature qui s’affiche en même temps que l’élément.

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

entity.message

Une seule valeur uniquement.

Un message relatif au produit s’affiche dans la recommandation, par exemple « en solde » ou « soldes ». Ce message est plus détaillé que le nom du produit. Utilisez entity.message pour définir des informations supplémentaires à afficher avec le produit dans le modèle.

Exemple : 'entity.message=Family special'

entity.inventory

Une seule valeur uniquement. Exige un nombre entier ou une valeur longue.

Affiche le niveau de stock de l’élément.

Exemple : 'entity.inventory=1'

Gestion des attributs de stock vides : pour la diffusion, si une règle d’inclusion, une règle de collecte ou un paramètre de critère est défini avec entity.inventory > 0 ou entity.inventory = 0 et que le stock du produit n’est pas défini, Target évalue cette valeur sur TRUE et inclut les produits pour lesquels le stock n’est pas défini. Par conséquent, les produits dont le stock n’est pas défini s’affichent dans les résultats de recommandation.

De même, si vous disposez d’une règle d’exclusion globale avec entity.inventory = 0 et que entity.inventoryn’est pas définie, Target évalue cette règle à TRUE et exclut le produit.

Problème connu : la recherche de produit est incohérente avec la diffusion pour les attributs de valeur de stock qui ne sont pas définis. Par exemple, pour une règle avec entity.inventory = 0 , la recherche de produits n’affiche pas les produits pour lesquels la valeur de stock n’est pas définie.

entity.value

Une seule valeur uniquement.

Définit le prix ou la valeur de l’élément.

Exemple : 'entity.value=15.99'

entity.value prend uniquement en charge le format décimal (par exemple, 15.99). Le format de virgule (15,99) n’est pas pris en charge.

entity.margin

Une seule valeur uniquement.

Marge bénéficiaire ou autre valeur de l’élément.

Exemple : 'entity.margin=1.00'

l’entité .custom

Prend en charge plusieurs valeurs (tableau JSON).

Définissez jusqu’à 100 variables personnalisées donnant d’autres informations sur l’élément. Pour chaque attribut personnalisé, vous pouvez spécifier un nom d’attribut non utilisé. Par exemple, vous pouvez créer un attribut personnalisé appelé entity.genre pour définir un livre ou un film. Un vendeur de billets peut créer des attributs pour un lieu d’événement pour un interprète secondaire, tel qu’une équipe visiteuse lors d’un événement sportif ou un acte d’ouverture dans un concert.

Restrictions :

Exemples :

'entity.venue=AT&T Park'

'entity.secondary=Rockies'

Les attributs d’entité personnalisés prennent en charge plusieurs valeurs. Consultez les Attributs d’entité personnalisés pour les limites de caractère et de valeur.

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

Les attributs d’entité personnalisés à plusieurs valeurs exigent des tableaux Json valides. Pour obtenir des informations de syntaxe correctes, voir Attributs d’entité personnalisés.

entity.event.detailsOnly

Une seule valeur uniquement.

Utilisé pour empêcher un appel mbox d’incrémenter les compteurs de données de comportement pour un algorithme.

Exemple : 'entity.event.detailsOnly=true'

Dans les exemples ci-dessous, le premier appel de mbox met à jour le catalogue et les données comportementales. Le deuxième appel de mbox met uniquement à jour le catalogue.

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