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. Nella schermata Recommendations > Progettazione sono visualizzate sia le schede di progettazione predefinite che tutte le progettazioni create nel vostro account.
Quando lavorate con le progettazioni, tenete presenti le seguenti informazioni:
  • Potete creare una progettazione di raccomandazioni utilizzando una progettazione predefinita oppure una progettazione personalizzata.
  • Non è possibile modificare o eliminare una progettazione predefinita.
  • Potete modificare, copiare o eliminare una progettazione personalizzata.
  • Per creare una progettazione basata su una progettazione predefinita, dovete prima copiare la progettazione e quindi modificare la copia.
Questa illustrazione mostra la progettazione predefinita di 1 x 4:
Questa illustrazione mostra una progettazione personalizzata:
Potete creare una progettazione durante il processo di creazione dell'attività dall'interno di Visual Experience Composer (VEC) o dalla libreria di progettazione all'esterno della creazione dell'attività. Le sezioni seguenti presumono che si stiano creando strutture dalla libreria, ma i passaggi sono simili.

Creare progettazioni

Potete creare una progettazione basata su una progettazione predefinita oppure su una progettazione personalizzata.

Creare una progettazione basata su una progettazione predefinita

  1. Fare clic su Recommendations > Progettazione per visualizzare la libreria Progettazione .
  2. Passate il puntatore del mouse sulla scheda per la progettazione da creare, quindi fate clic sull'icona Copia .
    Viene visualizzata la finestra di dialogo Crea struttura .
  3. Nel pannello Informazioni , aggiungete un nome ​contenuto e un'immagine di anteprima facoltativa da visualizzare sulla scheda grafica.
    When you use a default design, the design name and "Copy" appears in the Content Name field. È possibile modificare il nome. Potete anche selezionare un'immagine da visualizzare sulla scheda grafica.
  4. (Condizionale) Modificate il Codice di progettazione come desiderate.
    Le progettazioni per consigli utilizzano il linguaggio di progettazione open-source Velocity. Per informazioni su Velocity, consultate https://velocity.apache.org e Personalizzare un progetto con Velocity .
    Una progettazione può essere HTML o non HTML. Per impostazione predefinita, le progettazioni HTML sono racchiuse da un tag <div> 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. Fate scorrere l'opzione Progettazione HTML nella posizione "disattivata" per utilizzare codice non HTML.
    Il numero massimo di entità a cui è possibile fare riferimento in una progettazione, tramite hardcoded o loop, è 99.
  5. Fai clic su Salva .

Creare una progettazione personalizzata

  1. Fare clic su Recommendations > Progettazione per visualizzare la libreria Progettazione .
  2. Fate clic su Crea struttura .
    Se desiderate basare la nuova progettazione personalizzata su una progettazione esistente, passate il puntatore del mouse sulla progettazione desiderata, quindi fate clic sull'icona Copia . Potete quindi modificare la copia per creare una nuova progettazione personalizzata.
  3. Aggiungete un nome ​contenuto e un’immagine di anteprima facoltativa.
  4. (Condizionale) Modificate il Codice di progettazione come desiderate.
    Per ulteriori informazioni, fare riferimento alle informazioni del punto 4 precedente.
  5. Fai clic su Salva .

Modificare, copiare o eliminare una progettazione

Non potete modificare o copiare una progettazione predefinita; è possibile copiare solo le strutture predefinite.
Passate il puntatore del mouse sulla progettazione desiderata nella libreria Progettazione , quindi fate clic sull'icona appropriata: modificare, copiare o eliminare.
Potete copiare una progettazione esistente per creare una progettazione duplicata da modificare. Questo consente di creare un design simile con meno sforzi.
Tenete presente che le progettazioni sono disponibili per l'intero account. Considerate questo aspetto prima di eliminare una progettazione. I disegni eliminati non possono essere recuperati.

Esempio JSON

L'esempio seguente mostra come è possibile restituire le risposte JSON quando si configura un'attività tramite l'editor basato su modulo.
  1. Creare una progettazione dall'interno della libreria Progettazione o nel flusso di lavoro basato su moduli. 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. Di seguito è riportato 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. Set up a form-based Recommendations activity that uses this design.
    1. Navigate to the Activities page.
    2. Fai clic su Crea attività > Consigli .
    3. In Scegli Experience Composer (Compositore esperienza) , seleziona Modulo , quindi fai clic su Avanti .
    4. In posizione, immetti il testo: “Sample_Recs_Response”
    5. In Contenuto predefinito fai clic sulla freccia giù, poi su Aggiungi consiglio .
    6. Scegli un Tipo di pagina. Questo determina il filtraggio iniziale della schermata successiva.
    7. Seleziona una scheda Criteri, poi fai clic su Avanti .
    8. Select the design you created in the previous step, then click Next .
    9. Completa il processo di impostazione.
    10. 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.
    From the time that you save your activity, Target will need to build a model to support the selected criteria configuration. 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]
    Nome selezionato nella sezione "percorsi" dell'Recommendations basato su modulo, 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:

Additional JSON object tips and tricks

È 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). This design example also returns activity details, Target Profile details (as applicable), and other entity.attributes associated with the items returned.
    {   
     "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