[Premium]{class="badge positive" title="Consulte o que está incluído no Target Premium."}

Atributos da entidade

Use atributos de entidade para passar informações sobre o produto ou conteúdo para Adobe Target Recommendations.

As entidades referem-se a itens que você quer recomendar. As entidades podem incluir produtos, conteúdo (artigos, apresentação de slides, imagens, filmes e programas de televisão), listas de trabalho, restaurantes e assim por diante.

Recommendations envia productId ou productPurchasedId (referido como entity.id no código) que é usado nos algoritmos.

Considere o seguinte:

A maioria dos parâmetros predefinidos aceita apenas um único valor, enquanto 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 é semelhante ao seguinte exemplo se você estiver usando a at.js 1.x com mboxCreate. Todos os atributos de parâmetro de entidade fazem distinção 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=/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>

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 entity.id devem não conter espaços, 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. A entity.categoryID pode incluir várias categorias, como uma subseção de cardigãs (por exemplo, womens, womens:sweaters, womens:sweaters:cardigans). Categorias múltiplas devem ser separadas por vírgulas.

O valor categoryId é limitado a 250 caracteres.

Exemplos:

Para recomendações baseadas em categorias, uma vírgula separa o valor da categoria. 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 código a seguir, a categoria Feminino é 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 entity.message para definir informações adicionais para exibir com o produto no modelo.

Exemplo: 'entity.message=Family 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á esse valor como TRUE e incluirá os produtos com inventário não definido. Como resultado, os produtos com inventário não definido são exibidos nos 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 de estoque não definidos. Por exemplo, para uma regra com entity.inventory = 0 , a Pesquisa de produto não exibe 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.value suporta apenas o formato decimal (por exemplo, 15.99). O formato de vírgula (15,99) não é compatível.

entity.margin

Somente valor único.

A margem de lucro ou outro valor do item.

Exemplo: 'entity.margin=1.00'

entidade.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, você pode criar um atributo personalizado chamado entity.genre para definir um livro ou filme. Um vendedor de ingressos pode criar atributos para o local onde um evento será realizado para um artista secundário, como uma equipe visitante em um evento esportivo ou um show de abertura em um concerto.

Restrições:

Exemplos:

'entity.venue=AT&T 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", "band2"]'

Os atributos de entidade personalizados com vários valores exigem matrizes JSON válidas. Para obter informações de sintaxe corretas, consulte 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 de mbox atualiza o catálogo e os dados comportamentais. A segunda chamada de mbox atualiza somente 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' )