알림
- 주제:
- APIs/SDKs
작성 대상:
- 개발자
프리페치된 mbox 또는 보기가 최종 사용자에게 방문되거나 렌더링될 때 알림을 실행해야 합니다.
올바른 mbox 또는 보기에 대해 알림을 실행하려면 각 mbox 또는 보기에 대해 해당 eventToken을(를) 추적해야 합니다. 보고를 올바르게 반영하려면 해당 mbox 또는 보기에 대해 올바른 eventToken이(가) 있는 알림을 실행해야 합니다.
프리페치된 Mbox에 대한 알림
한 번의 게재 호출을 통해 하나 이상의 알림을 전송할 수 있습니다. 알림의 type이(가) 올바르게 반영될 수 있도록 추적해야 하는 지표가 각 mbox에 대해 click 또는 display인지 확인하십시오. 또한 각 알림에 대해 id을(를) 전달하여 Adobe Target Delivery API을(를) 통해 알림이 올바르게 전송되었는지 확인할 수 있습니다. 보고용으로 제공된 mbox에 대해 click 또는 display이(가) 발생한 시기를 나타내기 위해 timestamp을(를) Target (으)로 전달해야 합니다.
curl -X POST \
'https://demo.tt.omtrdc.net/rest/v1/delivery?client=demo&sessionId=10abf6304b2714215b1fd39a870f01afc#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
}
},
"notifications": [
{
"id" : "SummerOfferNotification",
"timestamp" : 1555705311051,
"type" : "display",
"mbox" : {
"name" :"SummerOffer"
},
"tokens" : [
"GcvBXDhdJFNR9E9r1tgjfmqipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q"
]
},
{
"id" : "SummerShoesOfferNotification",
"timestamp" : 1555705311051,
"type" : "display",
"mbox" : {
"name" :"SummerShoesOffer"
},
"tokens" : [
"GcvBXDhdJFNR9E9r1tgjfmqipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q"
]
},
{
"id" : "SummerDressOfferNotification",
"timestamp" : 1555705311051,
"type" : "display",
"mbox" : {
"name" :"SummerDressOffer"
},
"tokens" : [
"GcvBXDhdJFNR9E9r1tgjfmqipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q"
]
}
]
}'
위의 예제 호출을 수행하면 notifications 요청이 성공적으로 처리되었음을 나타내는 응답이 발생합니다.
{
"status": 200,
"requestId": "36014eed-4772-4c48-a9e2-e532762b6a85",
"client": "demo",
"id": {
"tntId": "abcdefghijkl00023.28_20"
},
"edgeHost": "mboxedge28.tt.omtrdc.net",
"notifications": [
{
"id": "SummerOfferNotification"
},
{
"id": "SummerDressOfferNotification"
},
{
"id": "SummerShoesOfferNotification"
}
]
}
Target (으)로 전송된 notifications이(가) 모두 올바르게 처리되면 응답의 notifications 배열에 나타납니다. 그러나 notifications id이(가) 누락된 경우 해당 특정 notification은(는) 처리되지 않았습니다. 이 시나리오에서는 성공한 notification 응답을 검색할 때까지 다시 시도 논리를 적용할 수 있습니다. API 호출이 차단되어 성능 지연이 발생하지 않도록 재시도 논리에 시간 제한이 지정되어 있는지 확인하십시오.
프리페치된 보기에 대한 알림
한 번의 게재 호출을 통해 하나 이상의 알림을 전송할 수 있습니다. 알림 유형을 올바르게 반영할 수 있도록 추적해야 하는 지표가 각 mbox에 대해 click 또는 display인지 여부를 결정합니다. 또한 각 알림에 대해 id을(를) 전달하여 알림이 Adobe Target Delivery API을(를) 통해 올바르게 전송되었는지 확인할 수 있습니다. 보고 목적으로 제공된 보기에 대해 click 또는 display이(가) 발생한 시점을 나타내기 위해 타임스탬프를 Target (으)로 전달해야 합니다.
curl -X POST \
'https://demo.tt.omtrdc.net/rest/v1/delivery?client=demo&sessionId=d359570e04f14e1faeeba02d6ab9914e' \
-H 'Content-Type: application/json' \
-H 'cache-control: no-cache' \
-d '{
"id": {
"tntId": "84e8d0e211054f18af365d65f45e902b.28_131"
},
"context": {
"channel": "web",
"browser": {
"host": "target.enablementadobe.com"
},
"address": {
"url": "https://target.enablementadobe.com/react/demo/#/"
}
},
"notifications": [{
"id": "228",
"type": "display",
"timestamp": 1556226121884,
"tokens": ["N3C13I0M2PH8iaKtONJlFJNWHtnQtQrJfmRrQugEa2qCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q=="],
"view": {
"name": "checkout-express",
}
},
{
"id": "5",
"type": "display",
"timestamp": 1556226121884,
"tokens": ["N3C13I0M2PH8iaKtONJlFJNWHtnQtQrJfmRrQugEa2qCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q=="],
"view": {
"name": "home",
}
},
{
"id": "6",
"type": "display",
"timestamp": 1556226121884,
"tokens": ["N3C13I0M2PH8iaKtONJlFJNWHtnQtQrJfmRrQugEa2qCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q=="],
"view": {
"name": "products",
}
}
]
}'
위의 예제 호출을 수행하면 notifications 요청이 성공적으로 처리되었음을 나타내는 응답이 발생합니다.
{
"status": 200,
"requestId": "85cc7394-c19a-4398-9b8b-bbee1e4c4579",
"client": "demo",
"id": {
"tntId": "84e8d0e211054f18af365d65f45e902b.28_131"
},
"edgeHost": "mboxedge28.tt.omtrdc.net",
"notifications": [
{
"id": "5"
},
{
"id": "6"
},
{
"id": "228"
}
]
}
Target (으)로 전송된 notifications이(가) 모두 올바르게 처리되면 응답의 notifications 배열에 나타납니다. 그러나 notifications id이(가) 누락된 경우 해당 특정 알림은 처리되지 않았습니다. 이 시나리오에서는 성공적인 알림 응답이 검색될 때까지 재시도 논리를 적용할 수 있습니다. API 호출이 차단되어 성능 지연이 발생하지 않도록 재시도 논리에 시간 제한이 지정되어 있는지 확인하십시오.