PREMIUM Atributos de entidad

Use los atributos de entidad para pasar la información de producto o contenido a Adobe Target Recommendations.

Las entidades se refieren a los elementos que desea recomendar. Las entidades pueden incluir productos, contenido (artículos, presentaciones de diapositivas, imágenes, películas y programas de televisión), ofertas de empleo, restaurantes, etc.

Recommendations envía el valor de productId o productPurchasedId (denominado entity.id en el código) que se utiliza en los algoritmos.

Tenga en cuenta lo siguiente:

  • entity.id debe coincidir con el productPurchasedId enviado a la página de confirmación del pedido y con el productId utilizado en los informes de Adobe Analytics productos.
  • Los valores de atributo de entidad que pase a Recommendations caducan pasados 61 días. Adobe recomienda pasar el valor más reciente de cada atributo de entidad a Recommendations al menos una vez al mes para cada elemento del catálogo.

La mayoría de los parámetros predefinidos solo aceptan un valor único. Los valores nuevos sobrescriben a los antiguos. El parámetro categoryId puede aceptar una lista de valores delimitados por comas para cada categoría que contenga el producto. Los nuevos valores de categoryId no sobrescriben los valores existentes, sino que, en cambio, se agregan durante la actualización de entidades (límite de 250 caracteres).

En general, el mbox de información de visualización se parece al siguiente ejemplo si utiliza at.js 1.** xwith mboxCreate. Todos los atributos de parámetros de entidad distinguen entre mayúsculas y minúsculas.

NOTA

Si utiliza at.js 2.x, mboxCreate (como se usa en el ejemplo siguiente) ya no es compatible. Para pasar información de producto o contenido a Recommendations mediante at.js 2.x, utilice targetPageParams. Para ver un ejemplo, consulte Planificación e implementación 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>
NOTA

Las direcciones URL relativas son preferibles para pageUrl y thumbnailUrl en lugar de las direcciones URL absolutas, porque las recomendaciones reciben los datos que se han enviado desde todos los entornos del sitio. El uso de direcciones URL relativas evita los vínculos predeterminados de un servidor de ensayo o desarrollo.

Si el mbox está en una página de productos, tiene la opción de incluir el ID del producto y el ID de la categoría. El algoritmo seleccionado determina cuál mostrar. El ID del producto se utiliza para algoritmos de afinidad y el ID de la categoría para algoritmos de categoría.

Variables disponibles

La siguiente tabla describe las variables disponibles.

entity.id

Solamente valor único.

Este parámetro obligatorio identifica el producto. Este ID alfanumérico debe ser el mismo en todos los productos de Adobe Experience Cloud que utilice, incluido Analytics, a fin de que los distintos productos reconozcan el artículo y compartan los datos sobre él.

Los valores entity.id deben no contener barras diagonales, símbolos, signos de interrogación, símbolos de porcentaje, comas u otros caracteres de puntuación que requieran codificación URL cuando se pasan en una llamada a la API de REST. Se permiten guiones y guiones bajos. Incluida puntuación no válida en un valor entity.id hace que algunas funciones de Recommendations fallen.

Ejemplo: 'entity.id=67833'

entity.name

Solamente valor único.

Nombre del producto que se muestra en el sitio web cuando se recomienda el producto.

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

entity.categoryId

Admite varios valores (lista separada por comas).

Categoría de la página actual. entity.categoryID puede incluir varias categorías, como una subsección de rebecas (por ejemplo, mujer, mujer:jerséis, mujer:jerséis:rebecas). Las categorías múltiples deben separarse con comas.

El valor categoryId está limitado a 250 caracteres.

NOTA

Para mostrar una recomendación basada en una categoría de una página Categoría, solo puede pasarse un categoryId al mbox utilizado para mostrar esa recomendación particular. El valor de categoryId debe coincidir exactamente con el valor de entity.categoryId pasado a la página Detalles del producto.

Ejemplos:

  • Ejemplo de página Detalles del producto: mujer, mujer:suéters, mujer:suéters:cardigans
  • Ejemplo de página de categoría Suéters: mujer:suéters
  • Ejemplo de página de categoría Cardigans: mujer:suéters:cardigans

Para las recomendaciones basadas en categorías, una coma separa el valor de categoría. Los valores separados por comas pasan a ser categorías. También puede definir subcategorías con otro separador, como los dos puntos (😃, para separar las subcategorías dentro del valor de categoría.

Por ejemplo, en el siguiente código, la categoría Mujer se divide en varias subcategorías:

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

Para la entrega de mbox, se utiliza el nombre de atributo más largo para la clave. Si hay un empate, se utiliza el último atributo. En el ejemplo anterior, la clave de categoría es Womens:Outerwear:Jackets:Caban.

entity.brand

Solamente valor único.

Muestra la marca de un artículo.

Ejemplo: 'entity.brand=brandxyz'

entity.pageUrl

Solamente valor único.

Define la dirección URL relativa de la página donde se puede comprar el artículo.

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

entity.thumbnailUrl

Solamente valor único.

Define la dirección URL relativa a la imagen en miniatura que se muestra con el artículo.

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

entity.message

Solamente valor único.

Un mensaje sobre el producto que se muestra en la recomendación, como “oferta” o “liquidación”. Generalmente el mensaje es más extenso que el nombre del producto. Utilice entity.message para definir información adicional que se mostrará con el producto en la plantilla.

Ejemplo: 'entity.message=Family&nbsp;special'

entity.inventory

Solamente valor único. Requiere un valor “integer” o “long”.

Muestra el nivel de inventario del artículo.

Ejemplo: 'entity.inventory=1'

Gestión de atributos de inventario vacíos: para la entrega, si tiene una regla de inclusión, una regla de recopilación o una configuración de criterio con entity.inventory > 0 o entity.inventory = 0 y no se ha establecido un inventario para el producto, Target evalúa este valor como TRUE e incluye productos sin inventario establecido. Como resultado, los productos con inventario no establecido se muestran en los resultados de la recomendación.

Igualmente, si tiene una regla de exclusión global con entity.inventory = 0 y entity.inventory no está establecido, Target evalúa esta regla como TRUE y excluye el producto.

Problema conocido: la búsqueda de productos no es coherente con la entrega de atributos de valor de inventario no establecidos. Por ejemplo, para una regla con entity.inventory = 0 , la búsqueda de productos no muestra los productos sin valor de inventario establecido.

entity.value

Solamente valor único.

Define el precio o el valor del elemento.

Ejemplo: 'entity.value=15.99'

entity.value solo admite formato decimal (por ejemplo, 15.99). No se admite el formato de coma (15,99).

entity.margin

Solamente valor único.

Margen de ganancia u otro valor del artículo.

Ejemplo: 'entity.margin=1.00'

entity.custom

Admite varios valores (matriz JSON).

Define hasta 100 variables personalizadas que proporcionan información adicional sobre el artículo. Puede especificar el nombre de los atributos no utilizados para cada atributo personalizado. Por ejemplo, puede crear un atributo personalizado llamado entity.genre para definir un libro o una película. Un vendedor de entradas puede crear atributos del lugar de celebración de un actor secundario, como un equipo visitante en un evento deportivo o un acto de apertura en un concierto.

Restricciones:

  • No se pueden usar nombres de atributos de entidad predefinidos para atributos de entidad personalizados.
  • El atributo entity.environment se reserva para el sistema y no se puede usar en atributos de entidad personalizados. Se omiten los intentos de pasar entity.environment usando targetPageParams, fuentes o API.

Ejemplos:

'entity.venue=AT&T&nbsp;Park'

'entity.secondary=Rockies'

Los atributos de entidad personalizados admiten varios valores. Consulte Atributos de entidad personalizados para límites de caracteres y valores.

Ejemplo: 'entity.secondary=["band1",&nbsp;"band2"]'

Los atributos de entidad personalizados de varios valores requieren matrices JSON válidas. Para obtener información sobre la sintaxis correcta, consulte Atributos de entidad personalizados.

entity.event.detailsOnly

Solamente valor único.

Se utiliza para impedir que una llamada de mbox incremente los contadores de datos de comportamiento para un algoritmo.

Ejemplo: 'entity.event.detailsOnly=true'

En los ejemplos siguientes, la primera llamada de mbox actualiza el catálogo y los datos de comportamiento. La segunda llamada de mbox actualiza solo el catálogo.

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

En esta página