Premium

Attributi di entità

Ultimo aggiornamento: 20 luglio 2024

Utilizzare gli attributi di entità per passare informazioni su prodotti o contenuti a Adobe Target Recommendations.

Le entità si riferiscono agli elementi che desideri consigliare. Le entità possono includere prodotti, contenuti (articoli, presentazioni, immagini, filmati e programmi televisivi), annunci di lavoro, ristoranti e così via.

Recommendations invia productId o productPurchasedId (indicato come entity.id nel codice) utilizzato negli algoritmi.

Considera i seguenti aspetti:

  • entity.id deve corrispondere a productPurchasedId inviato alla pagina di conferma dell'ordine e a productId utilizzato nei report di prodotto di Adobe Analytics.
  • I valori degli attributi di entità passati a Recommendations scadono dopo 61 giorni. L'Adobe consiglia di passare il valore più recente di ogni attributo di entità a Recommendations almeno una volta al mese per ogni elemento del catalogo.

La maggior parte dei parametri predefiniti accetta un solo valore, con i nuovi valori che sovrascrivono i vecchi valori. Il parametro categoryId può accettare un elenco di valori delimitato da virgole per ogni categoria contenente quel prodotto. I nuovi valori categoryId non sovrascrivono quelli esistenti ma vengono aggiunti durante l’aggiornamento dell’entità (limite di 250 caratteri).

In generale, se utilizzi at.js 1, la mbox delle informazioni di visualizzazione si presenta come l’esempio seguente.x con mboxCreate. Tutti gli attributi dei parametri di entità fanno distinzione tra maiuscole e minuscole.

NOTE
Se utilizzi at.js 2.x, mboxCreate (come utilizzato nell'esempio seguente) non è più supportato. Per passare informazioni su prodotti o contenuti a Recommendations utilizzando at.js 2.x, utilizza targetPageParams. Ad esempio, vedere Pianificare e implementare 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>
NOTE
Per pageUrl e thumbnailUrl gli URL relativi sono preferiti agli URL assoluti poiché i consigli ricevono i dati inviati da tutti gli ambienti sul sito. L'utilizzo degli URL relativi evita collegamenti fissi a un server di preproduzione o di sviluppo.

Se l'elemento mbox si trova su una pagina di prodotto, puoi includere sia l'ID prodotto che l'ID categoria. L'algoritmo selezionato determina quale verrà visualizzato. L'ID prodotto è utilizzato per gli algoritmi di affinità e l'ID categoria per gli algoritmi di categoria.

Variabili disponibili

Nell’elenco seguente sono illustrate le variabili disponibili.

entity.id

Solo valore singolo.

Questo parametro richiesto identifica il prodotto. Questo ID alfanumerico deve essere lo stesso in tutti i prodotti Adobe Experience Cloud utilizzati, tra cui Analytics, affinché i vari prodotti riconoscano l’elemento e ne condividano i dati.

I valori entity.id devono not contenere spazi, barre, e commerciali, punti interrogativi, simboli percentuali, virgole o altri caratteri di punteggiatura che richiedono la codifica URL quando vengono trasmessi in una chiamata API REST. Sono consentiti trattini e trattini bassi. L’inclusione di punteggiatura non valida in un valore entity.id causerà il mancato funzionamento di alcune funzionalità di Recommendations.

Esempio: 'entity.id=67833'

entity.name

Solo valore singolo.

Il nome del prodotto visualizzato sul sito Web quando il prodotto viene consigliato.

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

entity.categoryId

Supporta più valori (elenco delimitato da virgole).

Categoria della pagina corrente. entity.categoryID può includere più categorie, ad esempio una sottosezione cardigan (ad esempio, womens, womens:sweaters, womens:sweaters:cardigans). Più categorie devono essere separate da virgole.

Il valore categoryId è limitato a 250 caratteri.

NOTE
Per mostrare un consiglio basato su una categoria in una pagina Category, è possibile passare un solo categoryId nella mbox utilizzata per visualizzare quel consiglio specifico. Il valore di categoryId deve corrispondere esattamente al valore di entity.categoryId passato nella pagina Product Detail.

Esempi:

  • Esempio di pagina dettagli prodotto: womens, womens:sweaters, womens:sweaters:cardigans
  • Esempio di pagine di Sweaters categoria: womens:sweaters
  • Esempio di cardigan pagina categoria: womens:sweaters:cardigans

Per i consigli basati su categorie, una virgola separa il valore della categoria. I valori separati da virgole diventano categorie. Puoi inoltre definire le sottocategorie usando un separatore diverso, ad esempio un segno di due punti (:), per separare le sottocategorie nel valore della categoria.

Ad esempio, nel codice seguente la categoria Donne è suddivisa in diverse sottocategorie:

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

Per la distribuzione mbox, viene utilizzato il nome di attributo più lungo per la chiave. Se c'è un pareggio, viene utilizzato l'ultimo attributo. Nell'esempio precedente, la chiave della categoria è Womens:Outerwear:Jackets:Caban.

entity.brand

Solo valore singolo.

Visualizza il nome del marchio di un elemento.

Esempio: 'entity.brand=brandxyz'

entity.pageUrl

Solo valore singolo.

Definisce l'URL relativo della pagina nella quale l'elemento può essere acquistato.

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

entity.thumbnailUrl

Solo valore singolo.

Definisce l'URL relativo all'immagine di miniatura visualizzata con l'elemento.

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

entity.message

Solo valore singolo.

Un messaggio relativo al prodotto che viene visualizzato nel consiglio, come ad esempio “in offerta” o “saldo”. Il messaggio è in genere più dettagliato rispetto al nome del prodotto. Utilizza entity.message per definire informazioni aggiuntive da visualizzare con il prodotto nel modello.

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

entity.inventory

Solo valore singolo. Richiede un valore intero o lungo.

Visualizza il livello di inventario dell'elemento.

Esempio: 'entity.inventory=1'

Gestione attributi inventario vuoti: Per la consegna, se disponi di una regola di inclusione, una regola di raccolta o un'impostazione dei criteri con entity.inventory > 0 o entity.inventory = 0 e il prodotto non ha impostato l'inventario, Target valuta questo valore su TRUE e include i prodotti in cui l'inventario non è impostato. Di conseguenza, i prodotti con inventario non impostato vengono visualizzati nei risultati dei consigli.

Analogamente, se si dispone di una regola di esclusione globale con entity.inventory = 0 e entity.inventory non è impostato, Target valuta questa regola in modo che sia TRUE ed esclude il prodotto.

Problema noto: la ricerca del prodotto non è coerente con la consegna per gli attributi dei valori di inventario non impostati. Ad esempio, per una regola con entity.inventory = 0 , la ricerca del prodotto non visualizza i prodotti in cui il valore di inventario non è impostato.

entity.value

Solo valore singolo.

Definisce il prezzo o il valore dell'elemento.

Esempio: 'entity.value=15.99'

entity.value supporta solo il formato decimale (ad esempio, 15.99). Il formato virgola (15,99) non è supportato.

entity.margin

Solo valore singolo.

Il margine di profitto o altro valore dell'elemento.

Esempio: 'entity.margin=1.00'

entità.personalizzato

Supporta più valori (array JSON).

Definisci fino a 100 variabili personalizzate che forniscono informazioni aggiuntive sul prodotto. Puoi specificare qualsiasi nome di attributo non utilizzato per ogni attributo personalizzato. Ad esempio, è possibile creare un attributo personalizzato denominato entity.genre per definire un libro o un film. Un venditore di biglietti può creare attributi per un luogo di un evento per un artista secondario, ad esempio una squadra in visita in un evento sportivo o un atto di apertura in un concerto.

Limitazioni:

  • Non è possibile utilizzare nomi di attributi di entità predefiniti per attributi di entità personalizzati.
  • L’attributo entity.environment è riservato dal sistema e non può essere utilizzato per gli attributi di entità personalizzati. I tentativi di passare entity.environment utilizzando targetPageParams, feed o API vengono ignorati.

Esempi:

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

'entity.secondary=Rockies'

Gli attributi di entità personalizzati supportano più valori. Consulta Attributi di entità personalizzata per i limiti di carattere e valore.

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

Gli attributi di entità personalizzati multivalore richiedono array JSON validi. Per informazioni sulla sintassi corretta, vedere Attributi di entità personalizzati.