[Premium]{class="badge positive" title="Erfahren Sie, was in Target Premium enthalten ist."}
Integrieren von Recommendations in E-Mail
Adobe Target unterstützt die Sendezeit-Personalisierung von Recommendations in E-Mails.
Es sind drei Methoden zur Integration von Target Recommendations mit Ihrem E-Mail-Provider (ESP) verfügbar. Die Fähigkeiten Ihres ESP bestimmen, welche Methode zu verwenden ist. Ihr Account Manager oder Berater kann Ihnen bei der Wahl der am besten geeigneten Option behilflich sein.
Bei Verwendung von Methode 1 oder Methode 2 muss Ihr ESP eine externe API pro Kunde/pro E-Mail aufrufen und auf die Rückgabe von Inhalten warten. Diese Methoden werden nicht von allen ESPs unterstützt. Wenden Sie sich an Ihren ESP, um festzustellen, ob diese Art der Integration bei ihm möglich ist.
Bei der Verwendung von Methode 3 muss Ihr ESP einer Liste von Recommendations nach Produkt-ID oder Kategorie-ID mit Ihrer E-Mail-Liste verknüpfen. Diese Methode kann auf einem Attribut basieren, z. B. dem zuletzt angezeigten Produkt, dem zuletzt gekauften Produkt oder der am häufigsten angezeigten Kategorie des Kunden. Ihr ESP muss jedoch Zugriff auf diese Daten in ihrem Kundenprofil haben, um die Verknüpfung durchführen zu können. Wenden Sie sich an Ihren ESP, um festzustellen, ob er Zugriff auf diese Daten hat und diese Art der Integration unterstützt.
Die Open-Time-Personalisierung von Empfehlungen wird von Adobe Target nicht unterstützt.
- Anfragen sollten auf den niedrigeren Wert von entweder 1.000 Anfragen pro Sekunde oder das 25-fache des höchsten Traffics pro Tag beschränkt sein.
- Erhöhen Sie den Traffic jede Minute in Schritten von 200 Anfragen pro Sekunde.
Methode 1: Verwenden der Bereitstellungs-API (Bevorzugt) delivery-api
Die Bereitstellungs-API ist eine POST-Anforderung, die zusammen mit der Erstellungszeit-E-Mail verwendet wird. Diese Option ist die bevorzugte Methode für die Erstellungszeit-E-Mail.
Die meisten E-Mail-Clients erlauben keine POST-Anfragen. Aus diesem Grund ist diese API nicht für Anwendungsfälle zu empfehlen, bei denen die Zeit offen ist. Einige E-Mail-Clients wie Gmail oder Outlook speichern unter Umständen den Inhalt im Cache ab oder blockieren ein Bild, sodass der Empfänger die Darstellung eines Bildes proaktiv zulassen muss.
Mithilfe der Bereitstellungs-API können Sie keinen Standardinhalt zurückgeben.
Der folgende Code ist ein Beispiel für eine API-Bereitstellungsanfrage:
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
}'
Dabei ist clientcode
Ihr Target-Client-Code.
sessionId
und entweder tntId
oder thirdPartyId
für jeden E-Mail-Empfänger bereitstellen (z. B. für jeden API-Aufruf). Wenn Sie keine eindeutigen Werte für diese Felder angeben, kann die API-Antwort aufgrund der zahlreichen in einem einzigen Profil generierten Ereignisse lange dauern oder sogar fehlschlagen.Weitere Informationen finden Sie in der Dokumentation zur Bereitstellungs-API .
Option 2: Verwenden einer Rawbox-E-Mail-Vorlage rawbox
Eine Rawbox ähnelt einer Mbox-Anfrage, die jedoch für Nicht-Web-Umgebungen wie E-Mail-Provider (ESP) erstellt wird. Da Sie bei Rawbox-Anfragen nicht mit dem Adobe Experience Platform Web SDK oder at.js arbeiten können, müssen die Anfragen manuell erstellt werden. In den unten stehenden Beispielen ist beschrieben, wie Sie mit Rawbox-Anfragen in E-Mails arbeiten.
Dieser Ansatz ermöglicht es Ihnen, die Leistung von Recommendations in E-Mails zu verfolgen, die E-Mails unter normalen Bedingungen mit einer Empfehlung zu testen und die Verfolgung auf der Site fortzusetzen.
Richten Sie eine Recommendations-Aktivität in Target mit der Option Formularbasierter Erlebniseditor ein. Wählen Sie als Speicherort den Namen der Mbox aus, die Sie für die Rawbox-Anfrage des ESP gewählt haben. Wählen Sie das passende Design für Ihre E-Mail aus. Zum Zeitpunkt des E-Mail-Aufbaus generiert der ESP einen Aufruf an die Target-Server für jede Rawbox in jeder E-Mail-Nachricht, die erstellt wird. Ihr ESP muss über eine Möglichkeit verfügen, den zurückgegebenen HTML-Code beim Senden in die E-Mail einzuschließen.
Das von Ihnen verwendete E-Mail-System muss mit den folgenden Szenarien klarkommen:
Eingang einer gültigen Antwort ohne vorhandene Empfehlungen
- In diesem Fall ist die Antwort der Parameterwert von
mboxDefault
. Eine Erläuterung dieses Parameters finden Sie unten. - Der E-Mail-Anbieter sollte in diesem Fall über einen Standard-HTML-Block für Empfehlungen verfügen.
Zeitüberschreitung des Target-Servers und Rückgabe ohne Daten
-
In diesem Fall gibt der Target-Server folgenden Inhalt zurück:
//ERROR: application server timeout
-
Das E-Mail-Programm sollte nach diesem Text suchen und muss mit diesem Fehler umgehen können. Der E-Mail-Anbieter verfügt für den Umgang mit diesem Szenario über mehrere Möglichkeiten:
- Sofortiger Versuch eines erneuten Server-Aufrufs (empfohlen, möglicherweise mit Versuchszähler).
- Ignorieren der betroffenen E-Mail und Fortfahren mit der nächsten Nachricht.
- Einreihen der betroffenen E-Mail in eine Warteschlange und erneute Batch-Verarbeitung der fehlgeschlagenen Nachrichten am Ende des ersten Durchlaufs.
Beispiel für eine Anfrage-URL
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
Erforderliche Parameter: reqparams
entity.id
oder entity.categoryId
oder beide enthalten. Im obigen Beispielaufruf sind beide enthalten.client_code
mbox
Längenbeschränkung von 250 Zeichen.
Darf keines der folgenden Zeichen enthalten:
', ", %22, %27, <, >, %3C, %3E
mboxXDomain
entity.id
(Erforderlich für bestimmte Kriterientypen: Ansicht/Ansicht, Ansicht/Gekauft, Gekauft/Gekauft)
Falls von den Kriterien gefordert, muss der Rawbox-Aufruf
entity.id
enthalten.entity.event.detailsOnly
entity.id
wird dringend empfohlen, diesen Parameter zu übergeben, um zu verhindern, dass die Anforderung die Anzahl der Seitenansichten für ein Element erhöht, sodass produktansichtsbasierte Algorithmen nicht verfälscht werden.entity.categoryId
(Für bestimmte Kriterientypen erforderlich: am häufigsten angezeigt nach Kategorie und Topverkäufe nach Kategorie)
Falls von den Kriterien gefordert, muss der Rawbox-Aufruf
entity.categoryId
enthalten.mboxDefault
https://www.default.com
mboxNoRedirect
-Parameter vorhanden, sollte mboxDefault
eine absolute URL sein, die Standardinhalte zurückgibt, wenn keine Empfehlung zur Verfügung steht. Bei dieser URL kann es sich um Bilder oder statische Inhalte handeln.Wenn der
mboxNoRedirect
-Parameter vorhanden ist, kann es sich bei mboxDefault
um einen beliebigen Text handeln, der angibt, dass es keine Empfehlungen gibt wie z. B. no_content
.Der E-Mail-Anbieter muss mit Situationen umgehen können, bei denen dieser Wert zurückgegeben wird, und bei deren Eintreten Standard-HTML-Inhalte in die E-Mail einfügen.
Best Practice für die Sicherheit: Wenn die in der
mboxDefault
-URL verwendete Domain nicht in der Zulassungsliste enthalten ist, bieten Sie eine Angriffsfläche für Open Redirects. Zur Vermeidung einer unbefugten Nutzung von Weiterleitungs-Links oder mboxDefault
durch Dritte empfiehlt Adobe die Verwendung von „autorisierten Hosts“, wodurch die Domains der Standard-Weiterleitungs-URL auf die Zulassungsliste gesetzt werden. Target verwendet Hosts, um Domains auf die Zulassungsliste zu setzen, für die Umleitungen erlaubt sind. Weitere Informationen finden Sie im Abschnitt Hosts unter Erstellen von Zulassungslisten mit Hosts, die autorisiert sind, Mbox-Aufrufe an Target zu senden.mboxHost
mboxPC
Wenn keine "thirdPartyId"angegeben wurde, wird eine neue tntId generiert und als Teil der Antwort zurückgegeben. Ansonsten wird kein Wert angegeben.
Hinweis: Stellen Sie sicher, dass Sie einen eindeutigen Wert für
mboxSession
und mboxPC
für jeden einzelnen E-Mail-Empfänger angeben (d. h. für jeden API-Aufruf). Wenn Sie keine eindeutigen Werte für diese Felder angeben, kann die API-Antwort aufgrund der zahlreichen in einem einzigen Profil generierten Ereignisse lange dauern oder sogar fehlschlagen.Darf nicht mehr als einen einzelnen „.“ (Punkt) enthalten.
Der einzig zulässige Punkt ist derjenige vor dem Suffix für den Profilspeicherort.
Optionale Parameter
mboxPC
(Optional)
Dieser Wert muss die Adobe Target-PCID des Benutzers sein, die von der Website in Ihr CRM-System importiert wird. Der E-Mail-Anbieter würde diese ID aus Ihrem CRM-System oder Data Warehouse abrufen und als Wert für diesen Parameter einsetzen.
Der Wert
mboxPC
ist auch für die Verfolgung des Site-Verhaltens von Besuchern über mehrere Besuche hinweg sinnvoll. Mit seiner Hilfe lassen sich Metriken verfolgen, wenn eine Empfehlung Teil einer A/B-Aktivität ist.Hinweis: Stellen Sie sicher, dass Sie einen eindeutigen Wert für
mboxSession
und mboxPC
für jeden einzelnen E-Mail-Empfänger angeben (d. h. für jeden API-Aufruf). Wenn Sie keine eindeutigen Werte für diese Felder angeben, kann die API-Antwort aufgrund der zahlreichen in einem einzigen Profil generierten Ereignisse lange dauern oder sogar fehlschlagen.Darf nicht mehr als einen einzelnen „.“ (Punkt) enthalten.
Der einzig zulässige Punkt ist derjenige vor dem Suffix für den Profilspeicherort.
mboxNoRedirect
(Optional)
mbox3rdPartyId
Mögliche Antworten des Target-Servers
mboxNoRedirect
ist als „true“ (wahr) festgelegt und der Server gibt keine Empfehlungen zurück (d. h., es ist keine Übereinstimmung für die Mbox vorhanden oder der Zwischenspeicher des Servers wurde nicht initialisiert).Der mbox
-Parameter fehlt.
- Der
mboxDefault
- odermboxNoRedirect
-Parameter wird nicht angegeben. - Anforderungsparameter
mboxTrace
ist angegeben, abermboxNoRedirect
nicht. - Parameter
mboxTarget
wird nicht angegeben, wenn mbox-Namen mit dem Suffix-clicked
enden.
Cannot redirect to default content, please specify mboxDefault parameter
mboxDefault
wurde nicht angegeben, wenn für die Anfrage keine Übereinstimmung gefunden wurde oder der Parameter mboxNoRedirect
nicht angegeben ist.Invalid mbox name:= MBOX_NAME
mbox
unzulässige Zeichen enthalten sind.Mbox name [MBOX_NAME] is too long
mbox
mehr als 250 Zeichen enthält.Methode 3: Verwenden der Recommendations Download-API download-api
Richten Sie die Empfehlung wie gehabt ein, wählen Sie jedoch statt einer Vorlagen-/Mbox-Kombination die Option nur Download im Präsentationsbereich. Teilen Sie dem ESP dann mit, welche Empfehlungs-ID Sie erstellt haben. Der ESP greift über API auf die Empfehlungsdaten zu. Diese Daten zeigen, welche Artikel für eine bestimmte Kategorie oder ein Schlüsselelement, wie z. B. im Einkaufswagen liegen gebliebene Artikel, empfohlen werden sollen. Der ESP speichert diese Daten, verbindet sie mit der eigenen Designvorgabe, zeigt Informationen zu den einzelnen Artikeln an und liefert die E-Mails aus.
Bei dieser Option kann der Recommendations-Server die Performance einer Empfehlung weder direkt verfolgen noch den Traffic über mehrere Algorithmus/Vorlagen-Kombinationen verteilen. Außerdem sind Empfehlungen nicht an ein bestimmtes Besucherprofil gebunden.
Weitere Informationen zur Download-API finden Sie unter Vorgänger-APIs > Download.