Attributs d’entité
Utilisez les attributs d’entité pour transmettre des informations sur les produits ou le contenu à 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 de télévision), des listes d’emplois, 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 :
entity.iddoit correspondre auproductPurchasedIdenvoyé à la page de confirmation de commande et auproductIdutilisé dans les rapports de produit Adobe Analytics.- Les valeurs d’attribut d’entité que vous transmettez à Recommendations expirent après 61 jours. Adobe recommande de transmettre la dernière valeur de chaque attribut d’entité à Recommendations au moins une fois par mois pour chaque élément de votre catalogue.
La plupart des paramètres prédéfinis acceptent une seule valeur uniquement, 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 d’affichage d’informations 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.
mboxCreate (comme utilisé dans l’exemple suivant) n’est plus pris en charge. Pour transmettre des informations sur les produits ou le contenu à Recommendations à l’aide d’at.js 2.x, utilisez targetPageParams. Pour obtenir un exemple, reportez-vous à la section Planification et implémentation de 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>
pageUrl et thumbnailUrl, plutôt que des URL absolues, car les recommandations reçoivent les données envoyées de tous les environnements sur le site. L’utilisation d’URL relatives évite d’avoir à utiliser des liens codés en dur sur un serveur de développement ou de test.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 des espaces, des barres obliques, des esperluettes, des points d’interrogation, des symboles de pourcentage, des virgules ou d’autres caractères de ponctuation qui nécessitent le codage d’URL lorsqu’ils sont transmis 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 "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.
categoryId peut être transmis dans la mbox utilisée pour afficher cette recommandation spécifique. La valeur de categoryId doit correspondre exactement à la valeur de entity.categoryId transmise sur la page Product Detail.Exemples :
- Exemple de page Détails du produit :
womens,womens:sweaters,womens:sweaters:cardigans - Exemple de page Catégorie Pulls :
womens:sweaters - Exemple de cardigans de page de catégorie :
womens:sweaters:cardigans
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 d’inventaire vide : Pour la diffusion, si vous avez une règle d’inclusion, une règle de collecte ou un paramètre de critère avec entity.inventory > 0 ou entity.inventory = 0 et que l’inventaire du produit n’est pas défini, Target évalue cette valeur à TRUE et inclut les produits dont l’inventaire n’est pas défini. Par conséquent, les produits dont l’inventaire n’est pas défini s’affichent dans les résultats de la 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 d’inventaire qui ne sont pas définis. Par exemple, pour une règle avec entity.inventory = 0 , la recherche de produit n’affiche pas les produits dont la valeur d’inventaire 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'
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 le lieu d’un événement pour un interprète secondaire, par exemple pour une équipe en déplacement dans le cadre d’un événement sportif ou une première partie dans le cadre d’un concert.
Restrictions :
- Vous ne pouvez pas utiliser de noms d’attributs d’entité prédéfinis pour les attributs d’entité personnalisés.
- L’attribut entity.environment est réservé par le système et ne peut pas être utilisé pour les attributs d’entité personnalisés. Toute tentative de transférer entity.environment à l’aide de targetPageParams, d’un flux ou d’une API est ignorée.
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 ne met à jour que 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' )