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.

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3