Enviar notificações (Node.js)

Última atualização: 20 de julho de 2024

Criado para:

  • Desenvolvedor

Descrição

sendNotifications() é usado para enviar notificações de clique ou exibição para Adobe Target para medição e relatórios.

OBSERVAÇÃO
Quando um objeto execute com parâmetros obrigatórios estiver dentro da própria solicitação, a impressão será aumentada automaticamente para atividades qualificadas.

Os métodos do SDK que incrementarão uma impressão automaticamente são:

  • getOffers()
  • getAttributes()

Quando um objeto prefetch é transmitido na solicitação, a impressão não é automaticamente incrementada para as atividades com mboxes no objeto prefetch. sendNotifications() deve ser usado para experiências previamente buscadas para incrementar impressões e conversões.

Método

criar

TargetClient.sendNotifications(options: Object): Promise

Parâmetros

options tem a seguinte estrutura:

NomeTipoObrigatórioPadrão
solicitaçãoObjetoSimNone

Exemplo

Primeiro, vamos criar a solicitação da API de entrega da ID do Target para buscar previamente o conteúdo das mboxes home e product1.

Node.js

const prefetchMboxesRequest = {
  prefetch: {
    mboxes: [
      { name: "home" },
      { name: "product1" }
    ]
  }
};
// Next, we fetch the offers via Target Node.js SDK getOffers() API
const targetResponse = await targetClient.getOffers({ request: prefetchMboxesRequest });

Uma resposta bem-sucedida conterá um objeto de resposta Target Delivery API, que contém conteúdo previamente buscado para as mboxes solicitadas. Um objeto de amostra targetResponse.response pode aparecer da seguinte maneira:

Node.js

{
  "status": 200,
  "requestId": "e8ac2dbf5f7d4a9f9280f6071f24a01e",
  "id": {
    "tntId": "08210e2d751a44779b8313e2d2692b96.21_27"
  },
  "client": "adobetargetmobile",
  "edgeHost": "mboxedge21.tt.omtrdc.net",
  "prefetch": {
    "mboxes": [
      {
        "index": 0,
        "name": "home",
        "options": [
          {
            "type": "html",
            "content": "HOME OFFER",
            "eventToken": "t0FRvoWosOqHmYL5G18QCZNWHtnQtQrJfmRrQugEa2qCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
            "responseTokens": {
              "profile.memberlevel": "0",
              "geo.city": "dublin",
              "activity.id": "302740",
              "experience.name": "Experience B",
              "geo.country": "ireland"
            }
          }
        ],
        "state": "J+W1Fq18hxliDDJonTPfV0S+mzxapAO3d14M43EsM9f12A6QaqL+E3XKkRFlmq9U"
      },
      {
        "index": 1,
        "name": "product1",
        "options": [
          {
            "type": "html",
            "content": "TEST OFFER 1",
            "eventToken": "t0FRvoWosOqHmYL5G18QCZNWHtnQtQrJfmRrQugEa2qCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
            "responseTokens": {
              "profile.memberlevel": "0",
              "geo.city": "dublin",
              "activity.id": "302740",
              "experience.name": "Experience B",
              "geo.country": "ireland"
            }
          }
        ],
        "state": "J+W1Fq18hxliDDJonTPfV0S+mzxapAO3d14M43EsM9f12A6QaqL+E3XKkRFlmq9U"
      }
    ]
  }
}

Observe os campos mbox name e state, bem como o campo eventToken, em cada uma das opções de conteúdo Target. Eles devem ser fornecidos na solicitação sendNotifications(), assim que cada opção de conteúdo for exibida. Suponhamos que a mbox product1 tenha sido exibida em um dispositivo que não seja um navegador. A solicitação de notificações será exibida da seguinte maneira:

Node.js

const mboxNotificationRequest = {
  notifications: [{
    id: "1",
    timestamp: Date.now(),
    type: "display",
    mbox: {
      name: "product1",
      state: "J+W1Fq18hxliDDJonTPfV0S+mzxapAO3d14M43EsM9f12A6QaqL+E3XKkRFlmq9U"
    },
    tokens: [ "t0FRvoWosOqHmYL5G18QCZNWHtnQtQrJfmRrQugEa2qCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==" ]
  }]
};

Observe que incluímos o estado da mbox e o token de evento correspondente à oferta Target entregue na resposta de busca prévia. Depois de criar a solicitação de notificações, podemos enviá-la para Target por meio do método de API sendNotifications():

Node.js

const notificationResponse = await targetClient.sendNotifications({ request: mboxNotificationRequest });
recommendation-more-help