Che cosa è necessario sapere prima di creare un’attività di Consigli.

Pianificare e implementare la funzione 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.

Implementazione di base

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.

Esempio 1: combinare pagina e feed

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
  • Tutti gli attributi personalizzati

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.

Esempio 2: trasmettere tutti i parametri alla pagina dei dettagli del prodotto (o contenuto)

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
  • Tutti gli altri attributi

Codice di esempio

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.

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

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.

Pagina categoria

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" 
      } 
   } 
}

Pagina di prodotto

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 
      } 
   } 
}

Pagina del carrello

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>

Pagina di ringraziamento

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.

• Se utilizzi at.js, consulta Tracciare le conversioni.
• Se utilizzi mbox.js, consulta Creare una mbox di conferma d’ordine - mbox.js.

Impostazioni

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: Ricerca nel catalogo (Recommendations > Ricerca nel catalogo) Finestra di dialogo Crea raccolta (Recommendations > Raccolte > Crea nuova) Finestra di dialogo Aggiorna raccolta (Recommendations > Raccolte > Modifica) Finestra di dialogo Crea esclusione (Recommendations > Esclusioni > Crea nuova) Finestra di dialogo Aggiorna esclusione (Recommendations > Esclusioni > Modifica) Per ulteriori informazioni, consulta Host.
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.