PREMIUMPlan e implementa Recommendations

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.
	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. Consulta 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:

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. I tag in Adobe Experience Platform inseriscono il riferimento at.js/mbox.js e la funzione targetPageParams nella pagina e consentono 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)

Per ulteriori informazioni sull’implementazione di at.js, consulta Come distribuire 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.

Impostazioni

Utilizza le impostazioni per gestire l’implementazione di Recommendations.

Per accedere alle opzioni Impostazioni Recommendations, apri Target in Adobe Experience Cloud, quindi fai clic su Recommendations > Impostazioni.

Sono disponibili le seguenti opzioni: