Che cosa è necessario sapere prima di creare un’attività di Consigli.
Che cosa è necessario sapere prima di creare un’attività di Recommendations.
Recommendations richiede la configurazione della seguente gerarchia di informazioni:
Passaggio | Informazioni | Dettagli |
---|---|---|
![]() |
Libreria JavaScript | Ogni pagina richiede un riferimento a at.js versione 0.9.1 (o successiva) o mbox. js versione 55 (o successiva). Questo passaggio di implementazione è obbligatorio in tutte le pagine in cui verrà utilizzata un'attività di Target e può includere chiavi quali un ID di prodotto o di categoria. Per informazioni su at. js, consulta Implementazione di at. js. Per ulteriori informazioni su mbox.js, consulta Implementazione di mbox.js. |
![]() |
Chiavi | La chiave determina il tipo di prodotto o contenuto visualizzato nei consigli. Ad esempio, la chiave può essere una categoria di prodotti. Consulta Basare il consiglio su una Chiave consiglio. |
![]() |
Attributi | Gli attributi forniscono informazioni più specifiche sui prodotti da mostrare. Ad esempio, potrebbe essere utile mostrare i prodotti entro una determinata fascia di prezzo, o prodotti con un certo livello di scorte. Gli attributi possono essere indicati nella mbox o attraverso un feed. Consultate Specificare le regole di inclusione. |
![]() |
Esclusioni | Le esclusioni determinano quali elementi specifici non includere nei consigli. Consulta Esclusioni. |
![]() |
Dettagli di acquisto | I dettagli di acquisto forniscono informazioni sugli elementi acquistati e sull’ordine una volta completato l’acquisto. |
L’implementazione di base richiede la trasmissione alla pagina di parametri che determinano quali prodotti o servizi visualizzare nei consigli.
Prima di iniziare la configurazione di un’attività di Recommendations, è necessario comprendere in che modo i dati dei prodotti vengono trasmessi a Recommendations, e stabilire quale sia il metodo ottimale per le tue esigenze.
Esistono due metodi per fornire informazioni sui prodotti e i servizi a Recommendations:
Metodo | Descrizione |
---|---|
Trasmettere i parametri direttamente alla pagina | Questo metodo funziona bene per gli elementi che cambiano di frequente. Tuttavia, poiché richiede di applicare delle modifiche direttamente nella pagina, in molte aziende è necessario coinvolgere il reparto informatico e gli addetti all’implementazione delle pagine. |
Trasmettere i parametri attraverso un feed di Google o CSV | Questo metodo funziona bene per le raccolte che non vengono modificate spesso. Solitamente non è necessario modificare l’implementazione o altro codice di pagina per fornire le informazioni di prodotto attraverso un feed. Tuttavia, l’elenco dei prodotti rimane statico ed è più difficile apportare modifiche rapide. Per ulteriori informazioni, consulta Feed. |
Questi metodi possono essere utilizzati separatamente o insieme, come negli esempi seguenti.
Un’alternativa comune per l’implementazione di Recommendations utilizza sia parametri di pagina che feed.
Questo metodo potrebbe essere più adatto per un venditore con un catalogo di prodotti relativamente fisso, ma che desidera mettere in evidenza articoli stagionali specifici o in saldo. La maggior parte dei clienti potrebbe fornire le proprie informazioni principalmente attraverso il feed, con solo modifiche occasionali sulla pagina.
Utilizza un feed per fornire informazioni che non sono soggette a modifiche frequenti. Che tu scelga un file CSV o un feed Google, utilizza i seguenti parametri:
Parametri richiesti
entity.id
Parametri utili
entity.name
entity.categoryId
entity.brand
entity.pageUrl
entity.thumbnailUrl
entity.message
Una volta che il feed è configurato e trasmesso a Recommendations, trasmetti i parametri alla pagina per gli attributi che vengono modificati spesso, ossia più di una volta al giorno.
Parametri richiesti
entity.id
entity.categoryId
Parametri utili
entity.inventory
entity.value
La priorità è attribuita a qualsiasi insieme di dati eseguito più di recente. Se trasmetti prima il feed e poi aggiorni i parametri della pagina, verranno visualizzate le modifiche apportate nei parametri della pagina, sostituendo le informazioni dell’articolo trasmesse nel feed.
Se trasmetti tutti i parametri sulla pagina, puoi eseguire rapidamente gli aggiornamenti modificando la pagina. In alcune aziende, questo richiede il coinvolgimento del reparto IT o del team di progettazione web.
Questo esempio potrebbe essere particolarmente utile per un’azienda nel settore dei media, con contenuti che cambiano costantemente.
Parametri richiesti
entity.id
entity.categoryId
Ad esempio, è possibile utilizzare il codice seguente nella sezione dell’intestazione delle pagine dei prodotti o dei contenuti:
function targetPageParams() {
return {
"entity": {
"id": "32323",
"categoryId": "My Category",
"value": 105.56,
"inventory": 329
}
}
}
Per ulteriori esempi di codice per diversi tipi di pagine, consulta Implementazione in base al tipo di pagina.
Il tipo di pagina influenzerà l’implementazione di Recommendations.
Ad esempio, i tipi di consigli che si desidera presentare possono essere diversi in una pagina di prodotto rispetto a una pagina di categoria o alla pagina principale. Per ogni pagina, puoi eseguire funzioni specifiche prima della chiamata mbox per visualizzare i consigli appropriati.
Per informazioni sugli attributi negli esempi, consulta Attributi di entità.
È richiesta una formattazione JSON valida.
La funzione targetPageParams
mostrata di seguito è particolarmente utile se utilizzi una soluzione di gestione tag per implementare le pagine. Adobe Launch o Adobe Dynamic Tag Manager (DTM) colloca il riferimento at.js/mbox.js e la funzione targetPageParams
nella pagina e consente di configurare i valori. È opportuno inserire la funzione prima della chiamata at.js/mbox.js, oppure collocarla nella sezione JavaScript Extra della at.js/mbox.js.
Tutte le pagine che contengono consigli richiedono un riferimento at.js o mbox.js nella pagina. Aggiungi uno dei seguenti riferimenti a tutte le pagine con consigli:
<script src="/docs/target/at.js /></script>
<script src="/docs/target/mbox.js /></script>
Questa implementazione richiede:
at.js versione 0.9.2 (o successiva) o mbox.js versione 55 (o successiva)
mbox.js deve includere il riferimento a target.js (at.js non richiede un riferimento a target.js)
Per ulteriori informazioni sull’implementazione di at.js, consulta Come distribuire at.js.
Per ulteriori informazioni sull’implementazione di mbox.js, consulta Implementazione di mbox.js.
Per ulteriori informazioni sulle differenze tra le due librerie JavaScript di Target, consulta Vantaggi di at.js.
In una pagina categoria, sarà probabilmente utile limitare i consigli ai prodotti o al contenuto all'interno della categoria in questione. Per impostare una pagina categoria, configura le chiavi utilizzate dalla pagina. Per ulteriori informazioni sulle chiavi, consulta Basare il consiglio su una Chiave consiglio.
function targetPageParams() {
return {
"entity": {
"categoryId": "My Category"
}
}
}
In una pagina di prodotto, potrebbe essere utile raccomandare elementi specifici, oppure gli elementi con un prezzo o con un livello di scorte particolare. Per una pagina di prodotto, potrebbe essere necessario impostare attributi che si modificano frequentemente (come il valore e l'inventario), oltre alle chiavi necessarie per una pagina di categoria.
function targetPageParams() {
return {
"entity": {
"id": "32323",
"categoryId": "My Category",
"value": 105.56,
"inventory": 329
}
}
}
In una pagina del carrello, è probabile che si vogliano escludere alcuni elementi dai consigli, ad esempio quelli già presenti nel carrello.
<script type="text/javascript">
function targetPageParams() {
return {
"excludedIds": [352, 223, 23432, 432, 553]
}
}
</script>
Nella pagina di ringraziamento può essere utile mostrare il totale dell'ordine e l'ID ordine, nonché i prodotti che sono stati acquistati, senza raccomandare elementi aggiuntivi. È possibile implementare un secondo elemento mbox per acquisire le informazioni sull'ordine.
Utilizza le impostazioni per gestire l’implementazione di Recommendations.
Per accedere alle opzioni Recommendations Settings, aprire Target in Adobe Experience Cloud, quindi fare clic su Recommendations > Settings.
Sono disponibili le seguenti opzioni:
Impostazione | Descrizione |
---|---|
Mbox globale personalizzata | (Facoltativo) Specifica la mbox globale personalizzata utilizzata per le attività di Target. Per impostazione predefinita, la mbox globale utilizzata da Target è utilizzata per Recommendations. Nota: Questa opzione è impostata nella pagina Target Amministrazione. Apri Target, quindi fai clic su Amministrazione > Visual Experience Composer (Compositore esperienza visivo). |
Settore verticale | Il settore verticale è utilizzato per aiutare a categorizzare i criteri per i consigli. Questo consente ai membri del gruppo di individuare criteri rilevanti per una determinata pagina, ad esempio quelli più adatti per la pagina del carrello o per una pagina con contenuti multimediali. |
Filtra criteri incompatibili | Abilita questa opzione per mostrare solo i criteri per i quali la pagina selezionata trasmette i dati richiesti. Non tutti i criteri vengono eseguiti correttamente su ogni pagina. La pagina o mbox deve passare entity.id o entity.categoryId per rendere compatibili i consigli per l’elemento o la categoria corrente. In generale, è consigliabile mostrare solo i criteri compatibili. Per fare in modo che i criteri incompatibili siano disponibili per l’attività, deseleziona questa opzione.È consigliabile disattivare l’opzione se utilizzi una soluzione di gestione tag. Per ulteriori informazioni su questa opzione, consulta Domande frequenti su Recommendations. |
Gruppo host predefinito | Seleziona il gruppo host predefinito. Il gruppo di host può essere utilizzato per separare gli elementi disponibili nel catalogo per usi diversi. Ad esempio, puoi utilizzare i gruppi di host per ambienti di sviluppo e produzione, marchi diversi o diverse aree geografiche. Per impostazione predefinita, i risultati dell'anteprima in Ricerca nel catalogo, Raccolte ed Esclusioni si basano sul gruppo di host predefinito. Puoi anche selezionare un gruppo di host diverso per visualizzare in anteprima i risultati, utilizzando il filtro Ambiente. Per impostazione predefinita, gli elementi appena aggiunti sono disponibili in tutti i gruppi di host, a meno che non sia specificato un ID ambiente al momento della creazione o dell'aggiornamento dell'elemento. I consigli distribuiti dipendono dal gruppo di host specificato nella richiesta. Se i prodotti non vengono visualizzati, assicurati di utilizzare il gruppo host corretto. Ad esempio, se imposti che il consiglio usi un ambiente di gestione temporanea e imposti il gruppo host su Gestione temporanea, potrebbe essere necessario ricreare le raccolte nell'ambiente di gestione temporanea perché si visualizzino i prodotti. Per visualizzare i prodotti disponibili in ogni ambiente, utilizza Ricerca catalogo con ogni ambiente. Puoi anche visualizzare in anteprima il contenuto delle raccolte ed esclusioni di Recommendations per un ambiente selezionato (gruppo di host). Nota: dopo aver modificato l’ambiente selezionato, fai clic su Cerca per aggiornare i risultati restituiti. Il filtro Ambiente è disponibile nelle seguenti posizioni nell’interfaccia utente Target:
|
URL di base per le miniature | L’impostazione di un URL di base per il catalogo dei prodotti rende possibile l’utilizzo di URL relativi quando specifichi le miniature dei prodotti fornendo l’URL della miniatura. Ad esempio: "entity.thumbnailURL=/Images/Homepage/product1.jpg" imposta un URL relativo all’URL di base della miniatura. |
Token API per consigli | Utilizza questo token nelle chiamate API per la funzione Consigli, ad esempio l’API di download. |