[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:
Den här bilden visar en 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
-
Klicka på Recommendations > Designs för att visa biblioteket Designs.
-
För musen över kortet för den design du vill skapa och klicka sedan på ikonen Copy.
Dialogrutan Create Design visas.
-
Lägg till en Content Name och en förhandsvisningsbild som du vill visa 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.
-
(Villkorligt) Redigera designen Code efter behov.
Rekommendationsdesigner använder designspråket Velocity med öppen källkod. Information om Velocity finns på https://velocity.apache.org och i Anpassa en design med Velocity.
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. -
Klicka på Save.
Skapa en egen design
-
Klicka på Recommendations > Designs för att visa biblioteket Designs.
-
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.
-
Lägg till en Content Name och en valfri förhandsvisningsbild.
-
(Villkorligt) Redigera designen Code efter behov.
Mer information finns i steg 4 ovan.
-
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.
Du kan kopiera en befintlig design och skapa en dubblettdesign som du sedan kan ändra. Med den här processen kan du enkelt skapa en liknande design.
Observera att det finns design för hela kontot. Överväg användningen i andra konton 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.
-
Skapa en design inifrån designbiblioteket eller i det formulärbaserade arbetsflödet. Om du försöker skapa en design i arbetsflödet Visual Experience Composer (VEC) kan du inte skapa något annat än en HTML-design, som är inkapslad i en
<div>
för klickningsspårning. -
Se till att alternativet "HTML Design" är inaktiverat:
-
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" } }
-
Konfigurera en formulärbaserad Recommendations-aktivitet som använder den här designen.
- Navigera till sidan Activities.
- Klicka på Create Activity > Recommendations.
- Under Choose Experience Composer väljer du Form och klickar sedan på Next.
- Ange texten under platsen: "Sample_Recs_Response"
- Klicka på nedpilen under Default Content och sedan på Add Recommendation.
- Välj en sidtyp. Detta avgör den inledande filtreringen för nästa skärm.
- Välj ett villkorskort och klicka sedan på Next.
- Markera designen som du skapade i föregående steg och klicka sedan på Next.
- Slutför installationsprocessen.
- Klicka på högerpilen bredvid Inactive och välj sedan Activate.
-
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 den här processen ta lite tid. 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:
{width="575px"}
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)
Den här videon innehåller följande information:
- Skapa en egen design
- Förstå hur du refererar till visningsvariabler i dina designer