[Premium]{class="badge positive" title="Se vad som ingår i Target Premium."}

Skapa en design

En design definierar hur rekommendationer visas på en sida.

Du kan skapa en Recommendations-design med en standarddesign eller genom att skapa en anpassad design. Skärmen Recommendations > Designs visar både standarddesignkort och alla designer som har skapats i ditt konto.

Tänk på följande när du arbetar med design:

  • Du kan skapa en rekommendationsdesign med hjälp av en standarddesign eller skapa en anpassad design.
  • Du kan inte redigera eller ta bort en standarddesign.
  • Du kan redigera, kopiera eller ta bort en anpassad design.
  • Om du vill skapa en design baserad på en standarddesign måste du först kopiera designen och sedan redigera kopian.

Bilden visar standarddesignen 1 x 4:

1 x 4 standarddesign

Den här bilden visar en egen design:

Egen design

Du kan skapa en design under aktivitetsskapandet i Visual Experience Composer (VEC) eller från designbiblioteket utanför aktivitetsskapandet. I följande avsnitt antas du skapa designer från biblioteket, men stegen är liknande.

Skapa designer

Du kan skapa en design baserad på en standarddesign eller skapa en egen design.

Skapa en design baserad på en standarddesign

  1. Klicka på Recommendations > Designs för att visa biblioteket Designs.

    Designbibliotek

  2. För musen över kortet för den design du vill skapa och klicka sedan på ikonen Copy.

    Card_CopyDesign-bild

    Dialogrutan Create Design visas.

    createDesign-bild

  3. Lägg till en Content Name och en valfri förhandsvisningsbild som ska visas på designkortet på panelen Information.

    När du använder en standarddesign visas designnamnet och kopian i fältet Content Name. Du kan redigera namnet. Du kan också välja en bild som ska visas på designkortet.

  4. (Villkorligt) Redigera designen Code efter behov.

    I rekommendationsdesignen används designspråket Velocity med öppen källkod. Information om hastighet finns på https://velocity.apache.org och i Anpassa en design med Snabb.

    En design kan vara HTML eller icke-HTML. Som standard är HTML-designer omslutna av en <div>-tagg som tillåter klickspårning i en webbmiljö. Designer som inte är HTML är avsedda för andra miljöer än webbmiljöer där klickspårning inte är möjlig. Dra HTML Design-växeln till avmarkeringspositionen om du vill använda kod som inte är HTML.

    note note
    NOTE
    Det maximala antalet enheter som kan refereras i en design, antingen hårdkodade eller via slingor, är 99.
  5. Klicka på Save.

Skapa en egen design

  1. Klicka på Recommendations > Designs för att visa biblioteket Designs.

  2. Klicka på Create Design.

    Om du vill basera din nya anpassade design på en befintlig design för du musen över önskad design och klickar sedan på ikonen Copy . Du kan sedan redigera kopian för att skapa en ny anpassad design.

  3. Lägg till en Content Name och valfri förhandsvisningsbild.

  4. (Villkorligt) Redigera designen Code efter behov.

    Mer information finns i steg 4 ovan.

  5. Klicka på Save.

Redigera, kopiera eller ta bort en design

Kom ihåg att du inte kan redigera eller kopiera en standarddesign. Du kan bara kopiera standarddesigner.

Håll pekaren över önskad design i biblioteket Design och klicka sedan på lämplig ikon: redigera, kopiera eller ta bort.

Hovringsikoner för en design

Du kan kopiera en befintlig design och skapa en dubblettdesign som du sedan kan ändra. Det gör att du kan skapa en liknande design enklare.

Observera att det finns design för hela kontot. Tänk på detta innan du tar bort en design. Borttagna designer kan inte återställas.

JSON-exempel section_75BFB2537CFF4FBD9B560F59EB32C8DD

I följande exempel visas hur JSON-svar kan returneras när en aktivitet konfigureras via den formulärbaserade redigeraren.

  1. Skapa en design i designbiblioteket eller i det formulärbaserade arbetsflödet. Om du försöker göra detta i Visual Experience Composer-arbetsflödet (VEC) kan du inte skapa något annat än en HTML-design, som är inkapslad i en <div> för klickningsspårning.

  2. Se till att alternativet "HTML Design" är inaktiverat:

    html_design_toggle-bild

  3. Följande kod är ett exempel på vad du kan klistra in i din design:

    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. Konfigurera en formulärbaserad Recommendations-aktivitet som använder den här designen.

    1. Navigera till sidan Activities.
    2. Klicka på Create Activity > Recommendations.
    3. Under Choose Experience Composer väljer du Form och klickar sedan på Next.
    4. Ange texten under platsen: "Sample_Recs_Response"
    5. Klicka på nedpilen under Default Content och sedan på Add Recommendation.
    6. Välj en sidtyp. Detta avgör den inledande filtreringen för nästa skärm.
    7. Välj ett villkorskort och klicka sedan på Next.
    8. Markera designen som du skapade i föregående steg och klicka sedan på Next.
    9. Slutför installationsprocessen.
    10. Klicka på högerpilen bredvid Inactive och välj sedan Activate.
  5. När din aktivitet har konfigurerats och aktiverats kan du ställa in en exempelbegäran för att få tillbaka det rena JSON-svaret.

    Från den tidpunkt du sparar aktiviteten måste Target skapa en modell som stöder den valda villkorskonfigurationen. Beroende på ett antal faktorer kan detta ta en stund. Resultaten visas när modellen har byggts.

    Exempel:

    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
    

    där

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Parameter Värde
    [YOUR_CLIENT_CODE] Målklientkod (finns på /help/target/products.html#recsSettings > Recommendations API Token > Klientkod.
    [YOUR_MBOX_NAME] Det namn du har valt i avsnittet "locations" i den formulärbaserade Recommendations, i det här fallet Sample_Recs_Response.
    [ENTITY_ID entity.id för ett objekt i katalogen.
    [AT_PROPERTY_TOKEN] (Valfritt) Lägg till om du har valt en egenskap (ingår i Enterprise Permissions) under aktivitetsinställningarna.

När algoritmen har körts och du har fått resultat bör svaret se ut ungefär så här:

json_recommendation image

Ytterligare tips och tricks för JSON-objekt section_C305673C68944749969DB239E3221DC2

Du kan också skicka tillbaka en enkel kommaavgränsad lista med objekt genom att konfigurera en design med följande syntax:

entity1.id, $entity2.id, $entity3.id, $entity4.id, $entity5.id,

Du kan också skicka ytterligare information i svaret. Följande kodfil är ett mer komplext exempel som returnerar mycket mer än enhets-ID:n med associerade platser (ordning). Det här designexemplet returnerar även aktivitetsinformation, målprofilinformation (om tillämpligt) och andra entity.attributes som är associerade med de returnerade objekten.

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

Utbildningsvideo: Skapa anpassade designer i Recommendations (3:20) Översikt

Den här videon innehåller följande information:

  • Skapa en egen design
  • Förstå hur du refererar till visningsvariabler i dina designer
recommendation-more-help
3d9ad939-5908-4b30-aac1-a4ad253cd654