Premium

Integrera Recommendations med e-post

Adobe Target stöder personalisering av rekommendationer i e-postmeddelanden vid sändning.

Tre integreringsmetoder Target Recommendations med din e-postleverantör (ESP) är tillgänglig. 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 den är kompatibel 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.

Anpassning av rekommendationer i öppen tid stöds inte av Adobe Target.

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

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
}'

Plats clientcode är din Target klientkod.

Se Dokumentation för leverans-API för mer information.

Metod 2: Använda en e-postmall för en rawbox

En sandlåda liknar en mbox-begäran, men för icke-webbmiljöer, som e-postleverantörer (ESP). För du har inte Adobe Experience Platform Web SDK eller at.js om du vill använda i en rawbox-begäran måste du skapa din begäran 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 Formulärbaserad Experience Composer alternativ. 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. När ESP skapar e-postmeddelanden ringer de Target servrar för varje enskild kryssruta 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 togs 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.

The Target servern gör timeout och returnerar utan data

• I det här fallet Target servern returnerar 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:

Valfria parametrar

Potentiell Target serversvar

Metod 3: Använda Recommendations Download API

Konfigurera 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 nedladdnings-API:t finns i Äldre API:er > Hämta.