Show Menu
ARGOMENTI×

Creare una progettazione

Una progettazione definisce come i consigli verranno visualizzati su una pagina.
È possibile creare una progettazione Consigli utilizzando una progettazione predefinita o creandone una personalizzata. La schermata Consigli > Progettazioni visualizza le schede di progettazione predefinite e le progettazioni create. Le progettazioni predefinite non possono essere modificate o eliminate.
  1. Nella schermata Consigli > Progettazioni , muovi il mouse sulla scheda della progettazione che desideri creare.
  2. Per copiare e modificare una progettazione esistente, fai clic sull’icona Copia .
    Oppure
    Per creare una progettazione personalizzata, fai clic su Crea progettazione nella schermata Consigli > Progettazioni .
  3. Aggiungi un nome contenuto .
    Quando si utilizza una progettazione predefinita, il nome della progettazione e la “copia” verranno visualizzati nel campo Nome contenuto . È possibile modificare il nome. 1. (Facoltativo) Fai clic per selezionare un'immagine da visualizzare sulla scheda di progettazione.
  4. Modifica il codice di progettazione.
    Le progettazioni per consigli utilizzano il linguaggio di progettazione open-source Velocity. Le informazioni su Velocity sono disponibili all’indirizzo velocity.apache.org https://velocity.apache.org.
    Una progettazione può essere HTML o non HTML. Per impostazione predefinita, le progettazioni HTML sono racchiuse da un tag
    per consentire il tracciamento dei clic in un ambiente web. Le progettazioni non HTML sono per ambienti non web in cui non è possibile effettuare il monitoraggio dei clic.
    Il numero massimo di entità a cui puoi fare riferimento in una progettazione, tramite codifica fissa o cicli, è 99.
  5. Fai clic su Salva .

Esempio JSON

Nell'esempio seguente viene illustrato come è possibile restituire risposte JSON quando si configura un'attività tramite l'editor basato su modelli.
  1. Crea una progettazione dall'interno della Libreria di progettazione o all'interno del flusso di lavoro basato su modelli. Se tenti di eseguire questa operazione all’interno del flusso di lavoro del Compositore esperienza visivo, puoi creare solo una struttura HTML, che viene racchiusa in un elemento <div> a scopo di tracciamento dei clic.
  2. Assicurati che l'opzione “Progettazione HTML” sia disattivata:
  3. Il codice riportato di seguito è un esempio di ciò che è possibile incollare nella progettazione:
        #* 
        * "Return a simple list of recommended entity ids"   
        *#
    
        {   
          "notes":{   
          "purpose": "Return a simple list of recommended entity ids",   
          "use-case": "Use this approach if you prefer to do a real-time lookup of entity attribute details (such as inventory, price, rating) from another system (such as a CMS, PIM or ecommerce platform)",   
          "version": "01"   
          },   
          "recommendedItems": {   
            "key": "$key.id",   
            "slot-01": "$entity1.id",   
            "slot-02": "$entity2.id",   
            "slot-03": "$entity3.id",   
            "slot-04": "$entity4.id",   
            "slot-05": "$entity5.id",   
            "slot-06": "$entity6.id",   
            "slot-07": "$entity7.id",   
            "slot-08": "$entity8.id",   
            "slot-09": "$entity9.id",   
            "slot-10": "$entity10.id"   
          }   
        }  
    
    
  4. Imposta un'attività di Consigli basata su moduli che utilizzi questa progettazione.
    1. Passa alla pagina Attività.
    2. Fai clic su Crea attività .
    3. Seleziona Consigli .
    4. In Scegli Compositore esperienza , seleziona Modulo .
    5. In posizione, immetti il testo: “Sample_Recs_Response”
    6. In Contenuto predefinito fai clic sulla freccia giù, poi su Aggiungi consiglio .
    7. Scegli un Tipo di pagina. Questo determina il filtraggio iniziale della schermata successiva.
    8. Seleziona una scheda Criteri, poi fai clic su Avanti .
    9. Seleziona la struttura creata nel passaggio precedente, poi fai clic su Salva .
    10. Completa il processo di impostazione.
    11. Fai clic sulla freccia destra accanto a Inattivo , poi seleziona Attiva .
  5. Dopo aver impostato e attivato l'attività, è possibile impostare una richiesta di esempio per ottenere la risposta JSON pulita.
    Dal momento in cui salvi l'attività, Target dovrà generare un modello per supportare la configurazione dei criteri selezionati. A seconda di una serie di fattori, questo potrebbe richiedere del tempo. Una volta generato il modello vengono visualizzati i risultati.
    Ad esempio:
    https://[YOUR_CLIENT_CODE].tt.omtrdc.net/m2/YOUR_CLIENT_CODE/ubox/raw?mbox=[YOUR_MBOX_NAME]&mboxContentType=text/html&mboxXDomain=disabled&entity.id=[ENTITY_ID]&mboxHost=rawbox_sample&at_property=[AT_PROPERTY_TOKEN]&mboxNoRedirect=true&mboxPC=1234-4321&mboxSession=9876-7000
    
    
    dove
Parametro
Valore
[YOUR_CLIENT_CODE]
Codice client di Target (disponibile in ../target/products.html#recsSettings > Token API per i consigli > Codice client.
[YOUR_MBOX_NAME]
Il nome selezionato nella sezione "percorsi" di Recommendations basato su moduli, in questo caso Sample_Recs_Response.
[ENTITY_ID ]
L' entity.id di un elemento nel catalogo.
[AT_PROPERTY_TOKEN]
(Facoltativo) Aggiungi se hai selezionato una Proprietà (parte delle autorizzazioni dell'azienda) durante l'impostazione dell'attività.
Dopo che l'algoritmo è stato eseguito e si dispone dei risultati, la risposta dovrebbe essere simile a questa:

Ulteriori suggerimenti sugli oggetti JSON

È inoltre possibile inviare un semplice elenco di elementi delimitato da virgole impostando una progettazione con la seguente sintassi:
entity1.id, $entity2.id, $entity3.id, $entity4.id, $entity5.id, 

In alternativa, è possibile inviare ulteriori informazioni nella risposta. Il file di codice seguente è un esempio più complesso che restituisce molto di più degli ID di entità con gli spazi associati (ordine). In questo esempio di progettazione vengono inoltre restituiti i dettagli dell'attività, del Profilo di Target (come applicabile) e altri attributi entity.attributes associati agli elementi restituiti.
    {   
     "adobeRecommendations": {   
      "notes": {   
       "purpose": "Return a list of entity ids with their associated entity.attributes",   
       "use-case": "Use this approach to avoid looking up attribute details after receiving a response from Target",   
       "version": "01"   
      },   
      "recommendedItems": {   
       "slot-01": "$entity1.id",   
       "slot-02": "$entity2.id",   
       "slot-03": "$entity3.id",   
       "slot-04": "$entity4.id",   
       "slot-05": "$entity5.id",   
       "slot-06": "$entity6.id",   
       "slot-07": "$entity7.id",   
       "slot-08": "$entity8.id",   
       "slot-09": "$entity9.id",   
       "slot-10": "$entity10.id"   
      },   
      "activityDetails": {   
       "mbox.name": "email-mbox",   
       "campaign.name": "\${campaign.name}",   
       "campaign.id": "\${campaign.id}",   
       "campaign.recipe.name": "\${campaign.recipe.name}",   
       "campaign.recipe.id": "\${campaign.recipe.id}",   
       "offer.name": "\${offer.name}",   
       "offer.id": "\${offer.id}",   
       "criteria.title": "$criteria.title",   
       "algorithm.name": "$algorithm.name",   
       "algorithm.dayCount": "$algorithm.dayCount"   
      },   
      "visitorProfile": {   
       "profile.favorite-category": "\${profile.favorite-category}",   
       "profile.test": "\${profile.test}",   
       "user.endpoint.lastPurchasedEntity": "\${user.endpoint.lastPurchasedEntity}",   
       "user.endpoint.lastViewedEntity": "\${user.endpoint.lastViewedEntity}",   
       "user.endpoint.mostViewedEntity": "\${user.endpoint.mostViewedEntity}",   
       "user.endpoint.categoryAffinity": "\${user.endpoint.categoryAffinity}",   
       "profile.geolocation.city": "\${profile.geolocation.city}",   
       "profile.geolocation.dma": "\${profile.geolocation.dma}",   
       "profile.geolocation.state": "\${profile.geolocation.state}",   
       "profile.geolocation.country": "\${profile.geolocation.country}",   
       "profile.sessionCount": "\${profile.sessionCount}",   
       "profile.averageDaysBetweenVisits": "\${profile.averageDaysBetweenVisits}",   
       "profile.browserTime": "\${profile.browserTime}",   
       "user.activeActivities": "\${user.activeActivities}",   
       "user.pcId": "\${user.pcId}",   
       "user.isFirstSession": "\${user.isFirstSession}",   
       "user.isNewSession": "\${user.isNewSession}",   
       "user.header": "\${user.header}",   
       "user.parameter": "\${user.parameter}"   
      },   
      "recKey": {   
       "recKeyDetails": {   
        "id": "$key.id",   
        "name": "$key.name",   
        "category": "$key.category",   
        "pageUrl": "$key.pageUrl",   
        "thumbnailUrl": "$key.thumbnailUrl"   
       }   
      },   
      "recDetailedResults": {   
       "recEntity1Details": {   
        "id": "$entity1.id",   
        "name": "$entity1.name",   
        "category": "$entity1.category",   
        "pageUrl": "$entity1.pageUrl",   
        "thumbnailUrl": "$entity1.thumbnailUrl"   
       },   
       "recEntity2Details": {   
        "id": "$entity2.id",   
        "name": "$entity2.name",   
        "category": "$entity2.category",   
        "pageUrl": "$entity2.pageUrl",   
        "thumbnailUrl": "$entity2.thumbnailUrl"   
       },   
       "recEntity3Details": {   
        "id": "$entity3.id",   
        "name": "$entity3.name",   
        "category": "$entity3.category",   
        "pageUrl": "$entity3.pageUrl",   
        "thumbnailUrl": "$entity3.thumbnailUrl"   
       },   
       "recEntity4Details": {   
        "id": "$entity4.id",   
        "name": "$entity4.name",   
        "category": "$entity4.category",   
        "pageUrl": "$entity4.pageUrl",   
        "thumbnailUrl": "$entity4.thumbnailUrl"   
       },   
       "recEntity5Details": {   
        "id": "$entity5.id",   
        "name": "$entity5.name",   
        "category": "$entity5.category",   
        "pageUrl": "$entity5.pageUrl",   
        "thumbnailUrl": "$entity5.thumbnailUrl"   
       },   
       "recEntity6Details": {   
        "id": "$entity6.id",   
        "name": "$entity6.name",   
        "category": "$entity6.category",   
        "pageUrl": "$entity6.pageUrl",   
        "thumbnailUrl": "$entity6.thumbnailUrl"   
       },   
       "recEntity7Details": {   
        "id": "$entity7.id",   
        "name": "$entity7.name",   
        "category": "$entity7.category",   
        "pageUrl": "$entity7.pageUrl",   
        "thumbnailUrl": "$entity7.thumbnailUrl"   
       },   
       "recEntity8Details": {   
        "id": "$entity8.id",   
        "name": "$entity8.name",   
        "category": "$entity8.category",   
        "pageUrl": "$entity8.pageUrl",   
        "thumbnailUrl": "$entity8.thumbnailUrl"   
       },   
       "recEntity9Details": {   
        "id": "$entity9.id",   
        "name": "$entity9.name",   
        "category": "$entity9.category",   
        "pageUrl": "$entity9.pageUrl",   
        "thumbnailUrl": "$entity9.thumbnailUrl"   
       },   
       "recEntity10Details": {   
        "id": "$entity10.id",   
        "name": "$entity10.name",   
        "category": "$entity10.category",   
        "pageUrl": "$entity10.pageUrl",   
        "thumbnailUrl": "$entity10.thumbnailUrl"   
       }   
      }   
     }   
    }  

Training video: Create custom designs in Recommendations (3:20)

Questo video contiene le seguenti informazioni:
  • Creare una progettazione personalizzata
  • Comprendere come inserire nelle progettazioni un riferimento a variabili di visualizzazione