Show Menu
TÓPICOS×

Atributos da entidade

Use atributos de entidade para passar informações do produto ou conteúdo para o Adobe Target Recommendations.
Recommendations envia productId ou productPurchasedId (referido como entity.id no código) que é usado no algoritmo.
  • entity.id deve corresponder ao productPurchasedId enviado para a página de confirmação do pedido e productId usado nos relatórios de produto do Adobe Analytics.
  • Especificação de que os valores de atributos de entidade expiram após 61 dias. Isso significa que você deve garantir que o valor mais recente de cada atributo de entidade seja passado para as Recommendations do Target pelo menos uma vez por mês para cada item do catálogo.
A maioria dos parâmetros predefinidos aceita apenas um único valor, e os novos valores substituem os valores antigos. O parâmetro categoryId pode aceitar uma lista delimitada por vírgulas de valores de cada categoria que contenha esse produto. Os novos valores de categoryId não substituem os valores existentes, mas em vez disso são anexados durante a atualização da entidade (limite de 250 caracteres).
Em geral, a mbox de informações de exibição pode ser semelhante ao exemplo a seguir se você estiver usando o at.js 1. x com mboxCreate .
  • Se você estiver usando o at.js 2. x , mboxCreate (como usado no exemplo a seguir) não é mais suportado. Para enviar informações sobre o produto ou conteúdo para a Recommendations usando o at.js 2. x , use targetPageParams . Para ver um exemplo disso, consulte Planejar e implementar o Recommendations .
Todos os atributos de parâmetro de entidade distinguem entre maiúsculas e minúsculas.
<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=../baseball/giants-tix/giantsvrockies5.12.2000-67833', 
 
'entity.venue=AT&T PARK', 
 
'entity.secondary=ROCKIES', 
 
'entity.thumbnailUrl=../baseball/giants-tix/giants-136px.gif', 
 
'entity.message=FAMILY SPECIAL', 
 
'entity.value=15.99', 
 
'entity.inventory=1' 
 
); 
 
</script>

URLs relativos são preferidos para pageUrl e thumbnailUrl no lugar de URLs absolutos, pois os dados de recomendação recebem dados de todos os ambientes do seu site. O uso dos URLs relativos evita que os links inseridos no código para um servidor de preparação ou desenvolvimento.
Se a mbox estiver em uma página de produto, é possível incluir a ID de produto e de categoria. O algoritmo selecionado determina o que será exibido. A ID de produto é usada para algoritmos de afinidade e a ID de categoria para algoritmos de categoria.

Variáveis disponíveis

A lista a seguir descreve as variáveis disponíveis.

entity.id

Somente valor único.
Este parâmetro obrigatório identifica o produto. Esta ID alfanumérica deve ser igual em todos os produtos utilizados da Adobe Experience Cloud, incluindo o Analytics, para que os produtos reconheçam o item e compartilhem dados sobre ele.
Os valores do entity.id não devem conter barras, "E" comercial (&), pontos de interrogação, símbolos de porcentagem, vírgulas ou outros caracteres de pontuação que exigem codificação de URL quando passados em uma chamada REST API. Hifens e sublinhados são permitidos. Incluir pontuação inválida em um valor entity.id Recommendations provoca falha em algumas funcionalidades do.
Exemplo: 'entity.id=67833'

entity.name

Somente valor único.
O nome do produto é exibido no site quando o produto é recomendado.
Exemplo: 'entity.name=Giants& vs& Rockies& 5/12'

entity.categoryId

Suporta valores múltiplos (lista separada por vírgulas).
Categoria da página atual. Isto pode incluir várias categorias, como uma subseção cardigãs (ou seja, mulheres, mulheres:suéteres, mulheres:suéteres:cardigãs). Categorias múltiplas devem ser separadas por vírgulas.
categoryId é limitada a 250 caracteres.
Para mostrar uma recomendação com base em uma categoria da página Categoria, apenas um categoryId pode ser transmitido para a mbox usada para exibir essa determinada recomendação. O valor do categoryId deve corresponder exatamente ao valor do entity.categoryId transmitido na página Detalhes do produto.
Exemplos:
  • Exemplo da página de Detalhes do produto: womens, womens: sweaters, womens:sweaters:cardigans
  • Exemplo da Página de categoria Sweaters: womens:sweaters:
  • Exemplo da Página de categoria Cardigans: womens:sweaters:cardigans
Para Recommendations baseadas em categorias, uma vírgula é usada para separar valores de categorias. Quaisquer valores separados por vírgulas se tornam categorias. Você também pode definir subcategorias usando um separador diferente, como dois pontos (:), para separá-las dos valores de categoria.
Por exemplo, no seguinte código, a categoria Mulheres (Womens) está dividida em várias subcategorias:
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 a entrega da mbox, o maior nome de atributo é usado para a chave. Se houver um vínculo, o último atributo será usado. No exemplo acima, a chave da categoria é Womens:Outerwear:Jackets:Caban.

entity.brand

Somente valor único.
Exibe o nome da marca de um item.
Exemplo: 'entity.brand=brandxyz'

entity.pageUrl

Somente valor único.
Define o URL relativo da página onde o item pode ser comprado.
Exemplo: 'entity.pageUrl=baseball/giants-tix/giantsvrockies5.12.2000-67833'

entity.thumbnailUrl

Somente valor único.
Define o URL relativo da imagem em miniatura que é exibida com o item.
Exemplo: 'entity.thumbnailUrl=baseball/giants-tix/giants-136px.gif'

entity.message

Somente valor único.
A mensagem sobre o produto que é exibido na recomendação, como "à venda" ou "promoção". A mensagem normalmente é mais detalhada do que o nome do produto. Use para definir informações adicionais para exibir com o produto no modelo.
Exemplo: 'entity.message=Family&nbsp;special'

entity.inventory

Somente valor único. Exige um valor inteiro ou longo.
Exibe o nível de inventário do item.
Exemplo: 'entity.inventory=1'
Tratamento de atributo de inventário vazio: para a entrega, se você tiver uma regra de inclusão, regra de coleção ou uma configuração de critérios com entity.inventory > 0 ou entity.inventory = 0 e o produto não tiver o inventário definido, o Target avaliará isso como TRUE e incluirá os produtos com inventário não definido. Isso foi feito por padrão, de modo que os produtos com inventário não sejam exibidos em resultados da recomendação.
Da mesma forma, se você tiver uma regra de exclusão global com entity.inventory = 0 e entity.inventory não definido, o Target avalia essa regra como TRUE e exclui o produto.
Problema conhecido: a Pesquisa de produto está inconsistente com a entrega para atributos de valor do inventário não definidos. Por exemplo, para uma regra com entity.inventory = 0, a Pesquisa de produto não exibirá produtos em que o valor de inventário não está definido.

entity.value

Somente valor único.
Define o preço ou o valor do item.
Exemplo: 'entity.value=15.99'

entity.margin

Somente valor único.
A margem de lucro ou outro valor do item.
Exemplo: 'entity.margin=1.00'

entity. custom

Suporta vários valores (matriz JSON).
Defina até 100 variáveis personalizadas que oferecem informações adicionais sobre o item. É possível especificar qualquer nome de atributo não utilizado para cada atributo personalizado. Por exemplo, é possível criar um atributo personalizado chamado entity.genre para especificar um livro ou filme. Ou, um vendedor de ingressos pode criar atributos para o local onde um evento será realizado ou para um artista secundário, como uma equipe visitante em um evento esportivo ou um show de abertura em um concerto.
Restrições:
  • Não é possível usar nomes de atributos de entidade predefinidos para atributos de entidade personalizados.
  • O atributo entity.environment é reservado pelo sistema e não pode ser usado para atributos de entidade personalizados. Tentativas de enviar entity.environment usando targetPageParams, feed ou API serão ignoradas.
Exemplos:
'entity.venue=AT&T&nbsp;Park'
'entity.secondary=Rockies'
Os atributos de entidade personalizados suportam vários valores. Consulte Atributos de entidade personalizados para obter limites de caracteres e valores.
Exemplo: 'entity.secondary=["band1",&nbsp;"band2"]'
Os atributos de entidade personalizados com vários valores exigem matrizes JSON válidas. Para obter informações de sintaxe corretas, consulte os Atributos de entidade personalizados.

entity.event.detailsOnly

Somente valor único.
Usado para impedir que uma chamada de mbox incremente contadores de dados comportamentais para um algoritmo.
Exemplo: 'entity.event.detailsOnly=true'
Nos exemplos abaixo, a primeira chamada da mbox atualizará o catálogo e os dados comportamentais. A segunda chamada da mbox atualizará apenas o 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' )