Notifiche

Ultimo aggiornamento: 2023-07-27
  • Argomenti:
  • APIs/SDKs
    Visualizza ulteriori informazioni su questo argomento
  • Creato per:
  • Developer

Le notifiche devono essere attivate quando una mbox o una visualizzazione preacquisite viene visitata o sottoposta a rendering all’utente finale.

Affinché le notifiche vengano inviate per la mbox o la visualizzazione corretta, assicurati di tenere traccia delle corrispondenti eventToken per ogni mbox o vista. Notifiche con il corretto eventToken affinché i rapporti vengano rispecchiati correttamente, è necessario attivare le mbox o le visualizzazioni corrispondenti.

Notifiche per mbox preacquisite

Una o più notifiche possono essere inviate tramite una singola chiamata di consegna. Determinare se la metrica da tracciare è click o display per ogni mbox in modo che il type della notifica possa essere riflessa correttamente. Inoltre, passa un id per ogni notifica, in modo da poter determinare se una notifica è stata inviata correttamente tramite il​ API di consegna di Adobe Target. Il timestamp è importante anche per essere inoltrato a Target per indicare quando click o display si è verificato per una data mbox a scopo di reporting.

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"
        ]
    }
    ]
  }'

La chiamata di esempio precedente si tradurrà in una risposta che indica notifications richiesta elaborata correttamente.

{
  "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 tutte le notifications inviato a Target vengono elaborati correttamente, verranno visualizzati nel notifications nella risposta. Tuttavia, se un notifications id manca, quel particolare notification non è passato. In questo scenario, è possibile implementare una logica di nuovo tentativo fino a quando non viene notification risposta recuperata. Assicurati che nella logica di esecuzione di un nuovo tentativo sia specificato un timeout in modo che la chiamata API non si blocchi e non provochi ritardi nelle prestazioni.

Notifiche per le visualizzazioni preacquisite

Una o più notifiche possono essere inviate tramite una singola chiamata di consegna. Determinare se la metrica da tracciare è click o display per ogni mbox in modo che il tipo di notifica possa essere riflesso correttamente. Inoltre, passa un id per ogni notifica, in modo da poter determinare se una notifica è stata inviata correttamente tramite il API di consegna di Adobe Target. Anche la marca temporale è importante per essere inoltrata a Target per indicare quando click o display si è verificato per una determinata visualizzazione a scopo di reporting.

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",
      }
    }
  ]
}'

La chiamata di esempio precedente si tradurrà in una risposta che indica notifications richiesta elaborata correttamente.

{
    "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 tutte le notifications inviato a Target vengono elaborati correttamente, verranno visualizzati nel notifications nella risposta. Tuttavia, se un notifications id manca, quella particolare notifica non è stata eseguita. In questo scenario, è possibile implementare una logica di nuovo tentativo fino a quando non viene recuperata una risposta di notifica corretta. Assicurati che nella logica di esecuzione di un nuovo tentativo sia specificato un timeout in modo che la chiamata API non si blocchi e non provochi ritardi nelle prestazioni.

In questa pagina