Vorabruf
Durch das Vorabrufen können Clients wie Mobile Apps und Server Inhalte für mehrere Mboxes oder Ansichten in einer Anfrage abrufen, lokal zwischenspeichern und später Target benachrichtigen, wenn der Besucher diese Mboxes oder Ansichten besucht.
Bei der Verwendung des Vorabrufs ist es wichtig, mit den folgenden Begriffen vertraut zu sein:
prefetcheventToken für jede Mbox oder Ansicht zurück, die im Prefetch-Array vorhanden ist.notificationseventTokennotifications-Array zurückgesendet werden.Prefetch-Mboxes
Clients wie Mobile Apps und Server können mehrere Mboxes für einen bestimmten Besucher innerhalb einer Sitzung im Voraus abrufen und zwischenspeichern, um mehrere Aufrufe an die Adobe Target Delivery API zu vermeiden.
curl -X POST \
'https://demo.tt.omtrdc.net/rest/v1/delivery?client=demo&sessionId=7abf6304b2714215b1fd39a870f01afc#1555632114' \
-H 'Content-Type: application/json' \
-H 'cache-control: no-cache' \
-d '
{
"id": {
"tntId": "abcdefghijkl00023.1_1"
},
"context": {
"channel": "web",
"browser" : {
"host" : "demo"
},
"address" : {
"url" : "http://demo.dev.tt-demo.com/demo/store/index.html"
},
"screen" : {
"width" : 1200,
"height": 1400
}
},
"prefetch": {
"mboxes" : [
{
"name" : "SummerOffer",
"index" : 1
},
{
"name" : "SummerShoesOffer",
"index" : 2
},
{
"name" : "SummerDressOffer",
"index" : 3
}
]
}
}'
Fügen Sie innerhalb des Felds prefetch ein oder mehrere mboxes hinzu, die Sie mindestens einmal für einen Besucher innerhalb einer Sitzung vorab abrufen möchten. Nachdem Sie für diese mboxes vorab abgerufen haben, erhalten Sie die folgende Antwort:
{
"status": 200,
"requestId": "5efee0d8-3779-4b12-a74e-e04848faf191",
"client": "demo",
"id": {
"tntId": "abcdefghijkl00023.1_1"
},
"edgeHost": "mboxedge28.tt.omtrdc.net",
"prefetch": {
"mboxes": [
{
"index": 1,
"name": "SummerOffer",
"options": [
{
"content": "<p><b>Enjoy this 15% discount on your next purchase</b></p>",
"type": "html",
"eventToken": "GcvBXDhdJFNR9E9r1tgjfmqipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
}
]
},
{
"index": 2,
"name": "SummerShoesOffer",
"options": [
{
"content": "<p><b>Enjoy this 15% discount on your next shoe purchase</b></p>"
"type": "html",
"eventToken": "GcvBXDhdJFNR9E9r1tgjfmqipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
}
]
},
{
"index": 3,
"name": "SummerDressOffer",
"options": [
{
"content": "<p><b>Enjoy this 15% discount on your next dress purchase</b></p>"
"type": "html",
"eventToken": "GcvBXDhdJFNR9E9r1tgjfmqipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
}
]
}
]
}
}
In der Antwort sehen Sie das content Feld mit dem Erlebnis, das dem Besucher für eine bestimmte mbox angezeigt werden soll. Dies ist sehr nützlich, wenn es auf Ihrem Server zwischengespeichert wird. Wenn ein Besucher innerhalb einer Sitzung mit Ihrer Web- oder Mobile-App interagiert und eine mbox auf einer bestimmten Seite Ihrer Anwendung besucht, kann das Erlebnis aus dem Cache bereitgestellt werden, anstatt einen weiteren Adobe Target Delivery API-Aufruf durchzuführen. Wenn dem Besucher jedoch ein Erlebnis über die mbox bereitgestellt wird, wird über einen Bereitstellungs-API-Aufruf ein notification gesendet, damit die Impression protokolliert wird. Dies liegt daran, dass die Antwort der prefetch-Aufrufe zwischengespeichert wird, was bedeutet, dass der Besucher die Erlebnisse zum Zeitpunkt des prefetch Aufrufs nicht gesehen hat. Weitere Informationen zum notification finden Sie unter Benachrichtigungen.
Vorabrufen von Mboxes mit clickTrack Metriken bei Verwendung von Analytics for Target (A4T)
Adobe Analytics for Target (A4T) ist eine lösungsübergreifende Integration, die Ihnen das Erstellen von Aktivitäten ermöglicht, die auf Analytics Konversionsmetriken und Zielgruppensegmenten basieren.
Das folgende Code-Snippet ist eine Antwort von einem Vorabruf einer Mbox mit clickTrack Metriken, um Analytics darüber zu informieren, dass auf ein Angebot geklickt wurde:
{
"prefetch": {
"mboxes": [
{
"index": 0,
"name": "<mboxName>",
"options": [
...
],
"metrics": [
{
"type": "click",
"eventToken": "<eventToken>",
"analytics": {
"payload": {
"pe": "tnt",
"tnta": "..."
}
}
},
}
],
"analytics": {
"payload": {
"pe": "tnt",
"tnta": "347565:1:0|2,347565:1:0|1"
}
}
}
]
}
}
Ansichten vorab abrufen
Die Ansichten unterstützen Single Page Applications (SPA) und Mobile Apps nahtloser. Ansichten können als logische Gruppe visueller Elemente betrachtet werden, die zusammen ein SPA- oder Mobile-Erlebnis bilden. Über die Bereitstellungs-API können jetzt von VEC erstellte A/B Test- und Experience Targeting (X)T-Aktivitäten mit Änderungen an Ansichten für SPA vorab abgerufen werden.
curl -X POST \
'https://demo.tt.omtrdc.net/rest/v1/delivery?client=demo&sessionId=a3e7368c62d944c0855d424cd7a03ab0' \
-H 'Content-Type: application/json' \
-H 'cache-control: no-cache' \
-d '{
"id": {
"tntId": "84e8d0e211054f18af365d65f45e902b.28_131"
},
"context": {
"channel": "web",
"window": {
"width": 1819,
"height": 842
},
"browser": {
"host": "target.enablementadobe.com"
},
"address": {
"url": "https://target.enablementadobe.com/react/demo/#/"
}
},
"prefetch": {
"views": [{}]
}
}'
Mit dem obigen Beispielaufruf werden alle Ansichten, die über den SPA VEC für A/B Test- und XT-Aktivitäten erstellt wurden, vorab abgerufen, um sie für die Web-channel anzuzeigen. Beachten Sie, dass durch den Aufruf alle Ansichten aus den A/B Test- oder XT-Aktivitäten abgerufen werden, für die ein Besucher mit tntId:84e8d0e211054f18af365d65f45e902b.28_131, der die url:https://target.enablementadobe.com/react/demo/#/ besucht, qualifiziert ist.
{
"status": 200,
"requestId": "14ce028e-d2d2-4504-b3da-32740fa8dd61",
"client": "demo",
"id": {
"tntId": "84e8d0e211054f18af365d65f45e902b.28_131"
},
"edgeHost": "mboxedge28.tt.omtrdc.net",
"prefetch": {
"views": [
{
"id": 228,
"name": "checkout-express",
"key": "checkout-express",
"state": "Vqfb6kYGAmzWOLf9W6E+Q/0LyS+SYe2h5tuTXzRNnkjKkZaZZr2ijp41/6AwK6fdFgADhFNC7l5efUCs9shgTw==",
"options": [
{
"content": [
{
"type": "setHtml",
"selector": "#app > DIV:nth-of-type(1) > DIV:nth-of-type(2) > SECTION.section:eq(0) > DIV.container:eq(0) > FORM.col-md-4:eq(0) > DIV:nth-of-type(1) > DIV.mb-3:eq(2)",
"cssSelector": "#app > DIV:nth-of-type(1) > DIV:nth-of-type(2) > SECTION:nth-of-type(1) > DIV:nth-of-type(1) > FORM:nth-of-type(2) > DIV:nth-of-type(1) > DIV:nth-of-type(3)",
"content": "<span style=\"color:#000080;\"><strong>*We charge an additional fee of $12.34 for faster delivery. If you choose express delivery get 15% off on your next order.</strong></span>"
}
],
"type": "actions",
"eventToken": "N3C13I0M2PH8iaKtONJlFJNWHtnQtQrJfmRrQugEa2qCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q=="
}
]
},
{
"id": 5,
"name": "home",
"key": "home",
"state": "Vqfb6kYGAmzWOLf9W6E+Q/0LyS+SYe2h5tuTXzRNnkjKkZaZZr2ijp41/6AwK6fdFgADhFNC7l5efUCs9shgTw==",
"options": [
{
"content": [
{
"type": "setHtml",
"selector": "#app > DIV:nth-of-type(1) > DIV:nth-of-type(2) > SECTION.section:eq(0) > DIV.container:eq(1) > DIV.heading:eq(0) > H1.title:eq(0)",
"cssSelector": "#app > DIV:nth-of-type(1) > DIV:nth-of-type(2) > SECTION:nth-of-type(1) > DIV:nth-of-type(2) > DIV:nth-of-type(1) > H1:nth-of-type(1)",
"content": "<span style=\"color:#800000;\"><strong>Trending Items</strong></span>"
}
],
"type": "actions",
"eventToken": "N3C13I0M2PH8iaKtONJlFJNWHtnQtQrJfmRrQugEa2qCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q=="
}
]
},
{
"id": 6,
"name": "products",
"key": "products",
"state": "Vqfb6kYGAmzWOLf9W6E+Q/0LyS+SYe2h5tuTXzRNnkjKkZaZZr2ijp41/6AwK6fdFgADhFNC7l5efUCs9shgTw==",
"options": [
{
"content": [
{
"type": "setStyle",
"selector": "#app > DIV:nth-of-type(1) > DIV:nth-of-type(2) > SECTION.section:eq(0) > DIV.container:eq(0) > DIV.heading:eq(0) > BUTTON.btn:eq(0)",
"cssSelector": "#app > DIV:nth-of-type(1) > DIV:nth-of-type(2) > SECTION:nth-of-type(1) > DIV:nth-of-type(1) > DIV:nth-of-type(1) > BUTTON:nth-of-type(1)",
"content": {
"background-color": "rgba(191,0,0,1)",
"priority": "important"
}
}
],
"type": "actions",
"eventToken": "N3C13I0M2PH8iaKtONJlFJNWHtnQtQrJfmRrQugEa2qCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q=="
}
]
}
]
}
}
Beachten Sie in den content Feldern der Antwort Metadaten wie type, selector, cssSelector und content, mit denen das Erlebnis für Ihren Besucher gerendert wird, wenn ein Benutzer Ihre Seite besucht. Beachten Sie, dass der prefetched Inhalt zwischengespeichert und bei Bedarf für Benutzende gerendert werden kann.