[Premium]{class="badge positive" title="Vedi cosa è incluso in Target Premium."}

Creare una progettazione

Una progettazione definisce come i consigli verranno visualizzati su una pagina.

È possibile creare una progettazione Recommendations utilizzando una progettazione predefinita o creando una progettazione personalizzata. Nella schermata Recommendations > Designs vengono visualizzate le schede di progettazione predefinite e le progettazioni create nel tuo account.

Quando si lavora con le progettazioni, tenere presenti le seguenti informazioni:

  • Puoi creare una progettazione di consigli utilizzando una progettazione predefinita oppure puoi creare una progettazione personalizzata.
  • Non è possibile modificare o eliminare una progettazione predefinita.
  • Puoi modificare, copiare o eliminare una progettazione personalizzata.
  • Per creare una progettazione basata su una progettazione predefinita, è necessario innanzitutto copiare la progettazione e quindi modificare la copia.

Questa illustrazione mostra la progettazione predefinita 1 x 4:

1 x 4 design predefinito

Questa illustrazione mostra una progettazione personalizzata:

Progettazione personalizzata

Puoi creare una progettazione durante il processo di creazione delle attività dall’interno del Compositore esperienza visivo o dalla libreria di progettazione al di fuori della creazione delle attività. Le sezioni seguenti presuppongono la creazione di progetti dalla libreria, ma i passaggi sono simili.

Creare progettazioni

È possibile creare una progettazione basata su una progettazione predefinita oppure una progettazione personalizzata.

Creare una progettazione basata su una progettazione predefinita

  1. Fare clic su Recommendations > Designs per visualizzare la libreria Designs.

    Libreria progettazioni

  2. Passa il puntatore del mouse sulla scheda della progettazione che desideri creare, quindi fai clic sull'icona Copy.

    Immagine Card_CopyDesign

    Viene visualizzata la finestra di dialogo Create Design.

    creaImmagine design

  3. Nel pannello Information, aggiungi un'immagine Content Name e un'anteprima facoltativa da visualizzare sulla scheda di progettazione.

    Quando si utilizza una progettazione predefinita, il nome della progettazione e la "copia" vengono visualizzati nel campo Content Name. È possibile modificare il nome. È inoltre possibile selezionare un'immagine da visualizzare nella scheda di progettazione.

  4. (Condizionale) Modificare la struttura Code come desiderato.

    Le progettazioni per consigli utilizzano il linguaggio di progettazione open-source Velocity. Le informazioni su Velocity sono disponibili all'indirizzo https://velocity.apache.org e in Personalizzare una progettazione utilizzando Velocity.

    Una progettazione può essere HTML o non HTML. Per impostazione predefinita, le progettazioni di HTML sono racchiuse tra 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 eseguire il tracciamento dei clic. Fare scorrere l'interruttore HTML Design in posizione "off" per utilizzare codice non HTML.

    note note
    NOTE
    Il numero massimo di entità a cui è possibile fare riferimento in una progettazione, tramite codifica fissa o cicli, è 99.
  5. Fare clic su Save.

Creare una progettazione personalizzata

  1. Fare clic su Recommendations > Designs per visualizzare la libreria Designs.

  2. Fare clic su Create Design.

    Se desideri basare la nuova progettazione personalizzata su una progettazione esistente, passa il mouse sulla progettazione desiderata, quindi fai clic sull'icona Copy. Puoi quindi modificare la copia per creare una nuova progettazione personalizzata.

  3. Aggiungi un'immagine Content Name e un'immagine di anteprima facoltativa.

  4. (Condizionale) Modificare la struttura Code come desiderato.

    Per ulteriori informazioni, consulta le informazioni nel passaggio 4 precedente.

  5. Fare clic su Save.

Modificare, copiare o eliminare una progettazione

Non è possibile modificare o copiare una progettazione predefinita; è possibile copiare solo le progettazioni predefinite.

Passa il puntatore del mouse sulla struttura desiderata nella libreria Design, quindi fai clic sull'icona appropriata: modifica, copia o elimina.

Icone al passaggio del mouse per una progettazione

Potete copiare una progettazione esistente per creare una progettazione duplicata che potete quindi modificare. Questo consente di creare un design simile con meno sforzo.

Tieni presente che le progettazioni sono disponibili a livello dell’intero account. Prima di eliminare una progettazione, è necessario considerare questa possibilità. Non è possibile recuperare le progettazioni eliminate.

Esempio JSON section_75BFB2537CFF4FBD9B560F59EB32C8DD

L’esempio seguente mostra come le risposte JSON possono essere restituite durante la configurazione di un’attività tramite l’editor basato su moduli.

  1. Creare una progettazione dall'interno della Libreria di progettazione o all'interno del flusso di lavoro basato su moduli. Se tenti di eseguire questa operazione all'interno del flusso di lavoro del Compositore esperienza visivo, non puoi creare elementi diversi da una progettazione HTML, che viene racchiusa in <div> a scopo di tracciamento dei clic.

  2. Assicurati che l'opzione “Progettazione HTML” sia disattivata:

    html_design_toggle immagine

  3. Il codice seguente è un esempio di ciò che puoi incollare nella progettazione:

    code language-javascript
        #*
        * "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. Configurare un'attività Recommendations basata su modulo che utilizza questa struttura.

    1. Passare alla pagina Activities.
    2. Fare clic su Create Activity > Recommendations.
    3. In Choose Experience Composer, selezionare Form, quindi fare clic su Next.
    4. In posizione, immetti il testo: “Sample_Recs_Response”
    5. In Default Content fare clic sulla freccia giù, quindi su Add Recommendation.
    6. Scegli un Tipo di pagina. Questo determina il filtraggio iniziale della schermata successiva.
    7. Selezionare una scheda Criteri, quindi fare clic su Next.
    8. Selezionare la struttura creata nel passaggio precedente, quindi fare clic su Next.
    9. Completa il processo di impostazione.
    10. Fare clic sulla freccia destra accanto a Inactive, quindi selezionare Activate.
  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:

    code language-none
    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

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Parametro Valore
    [YOUR_CLIENT_CODE] Codice client di Target (disponibile in /help/target/products.html#recsSettings > Token API di Recommendations > Codice client.
    [YOUR_MBOX_NAME] Il nome selezionato nella sezione "locations" del 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:

immagine json_recommendations

Suggerimenti e trucchi aggiuntivi per oggetti JSON section_C305673C68944749969DB239E3221DC2

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

Video di formazione: Creare progettazioni personalizzate in Recommendations (3:20) Icona panoramica

Questo video contiene le seguenti informazioni:

  • Creare una progettazione personalizzata
  • Comprendere come inserire nelle progettazioni un riferimento a variabili di visualizzazione
recommendation-more-help
3d9ad939-5908-4b30-aac1-a4ad253cd654