PREMIUM Skapa en design

En design definierar hur rekommendationer visas på en sida.

Du kan skapa en Recommendations skapa med en standarddesign eller genom att skapa en egen design. The Recommendations > Designs visas både standarddesignkort och alla designer som har skapats på 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 Recommendations > Designs för att visa Designs bibliotek.

    Designbibliotek

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

    The Create Design visas.

  3. I Information panel, lägga till en Content Name och en förhandsvisningsbild som du kan visa på designkortet.

    När du använder en standarddesign visas designnamnet och"Kopiera" i Content Name fält. 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 in Anpassa en design med Snabb.

    En design kan vara HTML eller icke-HTML. Som standard är HTML-designer omslutna av en <div> -tagg för 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. Skjut HTML Design växla till"av"-positionen om du vill använda kod som inte är HTML.

    OBSERVERA

    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 Recommendations > Designs för att visa Designs bibliotek.

  2. Klicka på Create Design.

    Om du vill basera din nya, anpassade design på en befintlig design håller du musen över den önskade designen och klickar sedan på knappen Copy ikon. 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 symbol i dialogrutan 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

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 klickspårning.

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

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

        #*
        * "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 Activities sida.
    2. Klicka på Create Activity > Recommendations.
    3. Under Choose Experience Composer, markera Form och sedan klicka Next.
    4. Ange texten under platsen: "Sample_Recs_response"
    5. Under Default Content, klickar på nedpilen och klickar 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 väljer 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.

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

    Exempel:

    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

    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 The entity.id av 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:

Ytterligare tips och tricks för JSON-objekt

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). I det här designexemplet returneras även aktivitetsinformation, målprofilinformation (om tillämpligt) och annan information entity.attributes som är kopplade till 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 egna designer i Recommendations (3:20) Märket Översikt

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

  • Skapa en egen design
  • Förstå hur du refererar till visningsvariabler i dina designer

På denna sida