[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.
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.
- 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.
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.
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.
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
entity.id
eller entity.categoryId
eller båda, beroende på typen av rekommendationskriterier. Samplingsanropet ovan innehåller båda.client_code
mbox
250 tecken.
Kan inte innehålla något av följande tecken:
', ", %22, %27, <, >, %3C, %3E
mboxXDomain
entity.id
(Krävs för vissa typer av villkor: visa/visa, visa/köpt, köpt/köpt)
Om villkoret kräver det måste rawbox-anropet innehålla
entity.id
.entity.event.detailsOnly
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)
Om villkoret kräver det måste rawbox-anropet innehålla
entity.categoryId
.mboxDefault
https://www.default.com
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
mboxPC
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.Kan inte innehålla mer än en enskild "." (punkt).
Den enda tillåtna punkten är för profilplatsens suffix.
Valfria parametrar
mboxPC
(valfritt)
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.Kan inte innehålla mer än en enskild "." (punkt).
Den enda tillåtna punkten är för profilplatsens suffix.
mboxNoRedirect
(valfritt)
mbox3rdPartyId
Potentiella Target-serversvar
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).Parametern mbox
saknas.
- Parametern
mboxDefault
ellermboxNoRedirect
har inte angetts. mboxTrace
-begärandeparametern har angetts, men det är intemboxNoRedirect
.- 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
mbox
innehåller ogiltiga tecken.Mbox name [MBOX_NAME] is too long
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.