Vorabruf
Durch den Vorabruf 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 von Prefetch müssen Sie sich mit den folgenden Begriffen vertraut machen:
prefetch
eventToken
zurück.notifications
eventToken
notifications
zurück an Target gesendet werden.Vorabruf-mboxes
Clients wie mobile Apps und Server können mehrere Mboxes für einen bestimmten Besucher innerhalb einer Sitzung vorab abrufen und zwischenspeichern, um mehrere Aufrufe an den 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 im Feld prefetch
mindestens einen mboxes
hinzu, den Sie mindestens einmal für einen Besucher während einer Sitzung vorab abrufen möchten. Nachdem Sie 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 Feld content
mit dem Erlebnis, das dem Besucher für ein bestimmtes mbox
angezeigt werden soll. Dies ist sehr nützlich, wenn sie auf Ihrem Server zwischengespeichert wird, sodass das Erlebnis aus dem Cache bereitgestellt werden kann, wenn ein Besucher innerhalb einer Sitzung mit Ihrer Web- oder Mobile-App interagiert und auf einer bestimmten Seite Ihrer Anwendung den Punkt "mbox
" besucht, anstatt einen weiteren Adobe Target Delivery API -Aufruf vorzunehmen. Wenn dem Besucher jedoch von mbox
aus ein Erlebnis bereitgestellt wird, wird über einen Versand-API-Aufruf eine notification
gesendet, um die Impressions-Protokollierung durchzuführen. Dies liegt daran, dass die Antwort von prefetch
-Aufrufen zwischengespeichert wird, was bedeutet, dass der Besucher die Erlebnisse zum Zeitpunkt des Aufrufs prefetch
nicht gesehen hat. Weitere Informationen zum notification
-Prozess finden Sie unter Benachrichtigungen.
Vorabruf-mboxes mit clickTrack
-Metriken bei Verwendung von Analytics for Target (A4T)
Adobe Analytics for Target (A4T) ist eine lösungsübergreifende Integration, mit der Sie Aktivitäten erstellen können, die auf Analytics Konversionsmetriken und Zielgruppensegmenten basieren.
Das folgende Codefragment ist eine Antwort eines Vorabrufs 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
Ansichten unterstützen Single Page Applications (SPA) und mobile Anwendungen nahtloser. Ansichten können als logische Gruppe visueller Elemente betrachtet werden, aus denen ein SPA oder ein mobiles Erlebnis besteht. Jetzt können über die Bereitstellungs-API VEC-erstellte Aktivitäten A/B Test und Experience Targeting (X)T mit Änderungen an Ansichten für SPA vorabgerufen 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": [{}]
}
}'
Der obige Beispielaufruf ruft alle über den SPA VEC erstellten Ansichten für A/B Test - und XT -Aktivitäten vor, die für das Web channel
angezeigt werden sollen. Beachten Sie, dass der Aufruf alle Ansichten aus den A/B Test - oder XT -Aktivitäten abruft, für die sich ein Besucher mit tntId
:84e8d0e211054f18af365d65f45e902b.28_131
qualifiziert, der die url
:https://target.enablementadobe.com/react/demo/#/
besucht.
{
"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=="
}
]
}
]
}
}
Notieren Sie in den Feldern content
der Antwort Metadaten wie type
, selector
, cssSelector
und content
, die verwendet werden, um das Erlebnis für Ihren Besucher wiederzugeben, wenn ein Benutzer Ihre Seite besucht. Beachten Sie, dass der Inhalt von prefetched
zwischengespeichert und bei Bedarf für den Benutzer gerendert werden kann.