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

Integrera Recommendations med e-post

Adobe Target har stöd för anpassning av e-postrekommendationer vid sändning.

Det finns tre metoder för att integrera Target Recommendations med din e-postleverantör (ESP). ESP:s funktioner avgör vilken metod som ska användas. Din kontoansvarige eller konsult kan hjälpa dig att välja det alternativ som passar dig bäst.

Metod
Information
Metod 1: Adobe Target Delivery API (standard)
Använd Adobe Target Delivery API för att göra rekommendationer per kund/per e-post.
Metod 2: Adobe Rawbox API
Använd Adobe Target Rawbox API för att göra rekommendationer per kund/per e-post.
Metod 3: Recommendations Download API
Använd Recommendations Download API för att begära massrekommendationer för en lista över produkter eller kategorier i CSV-format.

Om du använder metod 1 eller metod 2 måste ESP ringa anrop till ett externt API per kund/per e-post och vänta på att innehållet returneras. Dessa metoder stöds inte av alla ESP:er. Kontakta din ESP för att avgöra om de är kompatibla med det här integreringsmönstret.

Om du använder metod 3 måste din ESP ansluta till en lista med rekommendationer per produkt-ID eller kategori-ID i din lista med e-postmeddelanden. Den här metoden kan baseras på ett attribut som kundens senast visade produkt, den senast köpta produkten eller den mest visade kategorin. Din ESP måste dock ha tillgång till dessa data i sin kundprofil för att kunna genomföra kopplingen. Kontakta din ESP för att avgöra om den har tillgång till dessa data och är kompatibel med det här integreringsmönstret.

Öppettidspersonalisering av rekommendationer stöds inte av Adobe Target.

IMPORTANT
Följande riktlinjer för kapacitet gäller för e-postmallsmetoderna Delivery API och rawbox som beskrivs nedan (metoderna 1 och 2):
  • Begäranden bör begränsas till det lägre av 1 000 förfrågningar per sekund eller 25 gånger din högsta dagliga trafik.
  • Ramptrafik i steg om 200 förfrågningar per sekund varje minut.
Kontakta din kontoansvarige om du vill använda högre avgiftsgränser.

Metod 1: Använd leverans-API (standard) delivery-api

Leverans-API:t är en begäran om POST som fungerar med e-post vid byggtid. Det här alternativet är den rekommenderade metoden för e-post under byggtid.

De flesta e-postklienter tillåter inte förfrågningar från POSTER. Detta API rekommenderas därför inte för användningsfall under öppen tid. Vissa e-postklienter, som Gmail eller Outlook, kan cachelagra innehållet eller blockera bilden och kräva att mottagaren aktivt tillåter att bilden återges.

Du kan inte returnera standardinnehåll med leverans-API:t.

Följande kod är ett exempel på en API-leveransbegäran:

curl -X POST \
  'https://clientcode.tt.omtrdc.net/rest/v1/mbox/?client=clientcode' \
  -H 'authorization: Bearer 3423614b-4843-4664-83c4-c6c3f6c8869b' \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -d '{
  "mbox" : "email-mbox",
  "tntId" : "111499796294071-449025.28_44",
  "requestLocation" : {
    "host" : "prod"
  },
   "profileParameters" : {
   },
  "mboxParameters" : {
    "at_property": "b468a242-64a4-32a0-ca0c-890bddd78789",
    "entity.id": "article-123",
    "entity.event.detailsOnly" : "true"
  }
  "contentAsJson":  true
}'

Var clientcode är din Target-klientkod.

NOTE
Var noga med att ange ett unikt värde för både sessionId och en av tntId eller thirdPartyId för varje e-postmottagare (till exempel för varje API-anrop). Om du inte anger unika värden för de här fälten kan API-svar ta lång tid eller misslyckas på grund av många händelser som genereras i en enskild profil.

Mer information finns i dokumentation för leverans-API.

Metod 2: Använd en mall för e-post i en rawbox rawbox

En sandlåda liknar en mbox-begäran, men för icke-webbmiljöer, som e-postleverantörer (ESP). Eftersom du inte har Adobe Experience Platform Web SDK eller at.js för att använda i rawbox-begäranden måste du skapa dina förfrågningar manuellt. Exemplen nedan förklarar hur du arbetar med rawbox-begäranden i e-postmeddelanden.

NOTE
När du använder en radruta och Target ska du läsa det viktiga säkerhetsmeddelandet under Skapa tillåtelselista som anger värdar som har behörighet att skicka mbox-anrop till Target.

Med den här metoden kan du följa upp hur rekommendationerna fungerar i e-postmeddelanden, testa dem på det vanliga sättet med en rekommendation och fortsätta spåra dem på webbplatsen.

Konfigurera en Recommendations-aktivitet i Target med alternativet Formulärbaserad Experience Composer. För platsen väljer du namnet på den mbox som du har valt att använda i den rawbox-begäran som kommer från ESP. Välj en design med det utseende och den känsla du vill ha för e-postmeddelandet. Vid e-postgenerering gör ESP ett anrop till Target-servrarna för varje radruta i varje e-postmeddelande som genereras. Din ESP måste ha ett sätt att inkludera den returnerade HTML i e-postmeddelandet när det skickas.

E-postsystemet du använder måste kunna hantera följande scenarier:

Ett giltigt svar har tagits emot, men det finns inga rekommendationer

  • I det här fallet är svaret det som anges som mboxDefault-parametervärde. Se förklaringen nedan om den här parametern.
  • E-postprovidern bör ha ett standardblock med rekommendationer i HTML som ska användas i det här fallet.

Servern Target gör timeout och returnerar utan data

  • I det här fallet returnerar servern Target följande innehåll:

    //ERROR: application server timeout

  • E-postprogrammet bör söka efter den texten och måste kunna hantera felet. E-postleverantören har flera alternativ för att hantera det här fallet:

    • Prova ett annat serversamtal omedelbart (rekommenderas, kanske med en räknare).
    • Kasta bort just det mejlet och fortsätt till nästa.
    • Köa just den e-postadressen och kör misslyckade e-postmeddelanden som en batch i slutet av den första körningen.

URL för exempelbegäran

https://client_code.tt.omtrdc.net/m2/client_code/ubox/raw?mbox=mbox_name&mboxSession=1396032094853-955654&mboxPC=1396032094853-955654&mboxXDomain=disabled&entity.event.detailsOnly=true&mboxDefault=nocontent&mboxNoRedirect=1&entity.id=2A229&entity.categoryId=5674

Obligatoriska parametrar: reqparams

NOTE
Om du vill använda Recommendations i e-postmeddelanden måste rawbox-anropet vanligtvis innehålla antingen entity.id eller entity.categoryId eller båda, beroende på typen av rekommendationskriterier. Samplingsanropet ovan innehåller båda.
Parameter
Värde
Beskrivning
Validering
client_code
client_code
Kundens kod som används i Recommendations. Din Adobe-konsult kan ge det här värdet.
mbox
mboxName
Det mbox-namn som används för mål.
Samma validering som för alla mbox-anrop.Max
250 tecken.
Kan inte innehålla något av följande tecken: ', ", %22, %27, <, >, %3C, %3E
mboxXDomain
inaktiverad
Förhindrar att svaret ställer in en cookie i icke-webbmiljöer.
entity.id
(Krävs för vissa typer av villkor: visa/visa, visa/köpt, köpt/köpt)
entity_id
Produkt-ID som rekommendationen baseras på, till exempel en övergiven produkt i kundvagnen eller ett tidigare köp.
Om villkoret kräver det måste rawbox-anropet innehålla entity.id.
entity.event.detailsOnly
true
Om entity.id skickas rekommenderar vi att du också skickar den här parametern för att förhindra att begäran ökar antalet tallied-sidvisningar för ett objekt, så att du inte behöver skeva produktvybaserade algoritmer.
entity.categoryId
(Krävs för vissa typer av villkor: mest visade per kategori och bästsäljare per kategori)
category_id
Den kategori som rekommendationen baseras på, till exempel de främsta säljarna i en kategori.
Om villkoret kräver det måste rawbox-anropet innehålla entity.categoryId.
mboxDefault
https://www.default.com
Om parametern mboxNoRedirect inte finns ska mboxDefault vara en absolut URL som returnerar standardinnehåll om ingen rekommendation är tillgänglig. Den här URL:en kan vara en bild eller annat statiskt innehåll.
Om parametern mboxNoRedirect finns kan mboxDefault vara vilken text som helst som anger att det inte finns några rekommendationer, till exempel no_content.
E-postprovidern måste hantera det fall där det här värdet returneras och infoga standard HTML i e-postmeddelandet.
Bästa praxis för säkerhet: Om domänen som används i URL:en mboxDefault inte är tillåtslista kan du utsättas för en risk för ett Open Redirect-fel. För att undvika obehörig användning av omdirigeringslänkar eller mboxDefault av tredje part rekommenderar Adobe att du använder"auktoriserade värdar" för att tillåtslista standardomdirigerings-URL-domänerna. Target använder värdar för att tillåtslista domäner som du vill tillåta omdirigeringar till. Mer information finns i Skapa Tillåtelselista som anger värdar som har behörighet att skicka mbox-anrop till Target i värdar.
mboxHost
mbox_host
Domänen som läggs till i standardmiljön (värdgruppen) när anropet utlöses.
mboxPC
Tom
(Krävs för rekommendationer som använder en besökarprofil.)
Om inget"thirdPartyId" angavs genereras ett nytt tntId som returneras som en del av svaret. Annars förblir den tom.
Obs!: Ange det unika värdet mboxSession och mboxPC för varje e-postmottagare (dvs. för varje API-anrop). Om du inte anger unika värden för de här fälten kan API-svar ta lång tid eller misslyckas på grund av det stora antalet händelser som genereras i en enskild profil.
1 < Längd < 128
Kan inte innehålla mer än en enskild "." (punkt).
Den enda tillåtna punkten är för profilplatsens suffix.

Valfria parametrar

Parameter
Värde
Beskrivning
Validering
mboxPC
(valfritt)
mboxPCId
Målbesökar-ID. Använd det här värdet om du vill spåra en användares fullständiga cirkel tillbaka till webbplatsen vid flera besök eller när du använder en användarprofilsparameter.
Det här värdet måste vara användarens faktiska Adobe Target PCID, som skulle exporteras från webbplatsen till din CRM. E-postleverantören hämtar detta ID från CRM eller Datan Warehouse och använder det som värde för den här parametern.
Värdet mboxPC är även användbart för att spåra besökares webbplatsbeteende vid flera besök för mätspårning när en rekommendation ingår i en A/B-aktivitet.
Obs!: Ange det unika värdet mboxSession och mboxPC för varje e-postmottagare (dvs. för varje API-anrop). Om du inte anger unika värden för de här fälten kan API-svar ta lång tid eller misslyckas på grund av det stora antalet händelser som genereras i en enskild profil.
1 < Längd < 128
Kan inte innehålla mer än en enskild "." (punkt).
Den enda tillåtna punkten är för profilplatsens suffix.
mboxNoRedirect
(valfritt)
1
Som standard dirigeras anroparen om när inget slutbart innehåll hittas. Används för att inaktivera standardbeteendet.
mbox3rdPartyId
xxx
Använd det här alternativet om du har ett eget anpassat besökar-ID att använda för profilanpassning.

Potentiella Target-serversvar

Svar
Beskrivning
//ERROR:
Genereras av belastningsutjämnare när innehållet inte kan returneras
Lyckades
Parametern mboxNoRedirect är inställd på true och servern returnerar inga rekommendationer (d.v.s. det finns ingen matchning för mbox eller så har servercachen inte initierats).
felaktig begäran

Parametern mbox saknas.

  • Parametern mboxDefault eller mboxNoRedirect har inte angetts.
  • mboxTrace-begärandeparametern har angetts, men det är inte mboxNoRedirect.
  • Parametern mboxTarget anges inte när mbox-namn slutar med suffixet -clicked.
Cannot redirect to default content, please specify mboxDefault parameter
mboxDefault har inte angetts när det inte finns någon matchning för begäran och parametern mboxNoRedirect inte har angetts.
Invalid mbox name:= MBOX_NAME
Anger att parametern mbox innehåller ogiltiga tecken.
Mbox name [MBOX_NAME] is too long
Anger att parametern mbox är längre än 250 tecken.

Metod 3: Använda Recommendations Download API download-api

Ange en rekommendation som vanligt, men välj endast nedladdning i presentationsavsnittet i stället för en mall- och mbox-kombination. I ESP anger du sedan för ESP vilket rekommendation-ID du har skapat. ESP får åtkomst till rekommendationsdata via API. Dessa data visar vilka artiklar som bör rekommenderas för en viss kategori eller nyckelartikel, t.ex. artiklar i en övergiven kundvagn. ESP lagrar dessa data, kopplar dem till sitt eget utseende, visar information om varje objekt och levererar det i e-postmeddelandena.

Med det här alternativet kan rekommendationsservern inte direkt spåra prestanda för en rekommendation eller dela trafik mellan flera algoritm-/mallkombinationer. Rekommendationerna är inte heller knutna till någon besökarprofil.

Mer information om hämtnings-API:t finns i Äldre API:er > Hämta.

recommendation-more-help
3d9ad939-5908-4b30-aac1-a4ad253cd654