Notificações
As notificações devem ser disparadas quando uma mbox ou visualização previamente buscada for visitada ou renderizada para o usuário final.
Para que as notificações sejam desativadas para a mbox ou exibição correta, certifique-se de rastrear o eventToken
correspondente para cada mbox ou exibição. Notificações com o eventToken
correto para as mboxes ou exibições correspondentes precisam ser disparadas para que os relatórios sejam refletidos corretamente.
Notificações para mboxes buscadas previamente
Uma ou várias notificações podem ser enviadas por meio de uma única chamada de entrega. Determine se a métrica que precisa ser rastreada é um click
ou display
para cada mbox para que o type
da notificação possa ser refletido corretamente. Além disso, forneça um id
para cada notificação, para que seja possível determinar se uma notificação foi enviada corretamente através do Adobe Target Delivery API. O timestamp
também é importante para ser encaminhado para Target para indicar quando o click
ou display
ocorreu para uma determinada mbox para fins de relatório.
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"
]
}
]
}'
O exemplo de chamada acima resultará em uma resposta que indica que a solicitação notifications
foi processada com êxito.
{
"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"
}
]
}
Se todos os notifications
enviados para Target forem processados corretamente, eles aparecerão na matriz notifications
na resposta. No entanto, se um notifications
id
estiver ausente, esse notification
em particular não será aprovado. Neste cenário, uma lógica de nova tentativa pode ser colocada em prática até que uma resposta notification
bem-sucedida seja recuperada. Verifique se a lógica de repetição tem um tempo limite especificado para que a chamada à API não seja bloqueada e cause atrasos de desempenho.
Notificações para Exibições Pré-buscadas
Uma ou várias notificações podem ser enviadas por meio de uma única chamada de entrega. Determine se a métrica que precisa ser rastreada é um click
ou display
para cada mbox para que o tipo de notificação possa ser refletido corretamente. Além disso, transmita um id
para cada notificação para que seja possível determinar se uma notificação foi enviada corretamente através do Adobe Target Delivery API. O carimbo de data/hora também é importante para ser encaminhado a Target para indicar quando o click
ou display
ocorreu para uma determinada exibição para fins de relatório.
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",
}
}
]
}'
O exemplo de chamada acima resultará em uma resposta que indica que a solicitação notifications
foi processada com êxito.
{
"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"
}
]
}
Se todos os notifications
enviados para Target forem processados corretamente, eles aparecerão na matriz notifications
na resposta. No entanto, se um notifications
id
estiver ausente, essa notificação específica não será enviada. Nesse cenário, uma lógica de nova tentativa pode ser colocada em prática até que uma resposta de notificação bem-sucedida seja recuperada. Verifique se a lógica de repetição tem um tempo limite especificado para que a chamada à API não seja bloqueada e cause atrasos de desempenho.