Preacquisizione

Ultimo aggiornamento: 20 luglio 2024

Creato per:

  • Sviluppatore

La preacquisizione consente ai client come le app e i server mobili di recuperare contenuti per più mbox o visualizzazioni in una richiesta, memorizzarli nella cache locale e successivamente inviare una notifica a Target quando il visitatore visita tali mbox o visualizzazioni.

Quando si utilizza la preacquisizione, è importante avere familiarità con i seguenti termini:

Nome campoDescrizione
prefetchElenco di mbox e visualizzazioni che devono essere recuperate ma non contrassegnate come visitate. L'Edge Target restituisce un eventToken per ogni mbox o vista esistente nell'array di preacquisizione.
notificationsElenco di mbox e visualizzazioni precedentemente preacquisite che devono essere contrassegnate come visitate.
eventTokenToken crittografato con hash restituito quando il contenuto viene prerecuperato. Questo token deve essere rimandato a Target nell'array notifications.

Preacquisizione di Mbox

I client, ad esempio le app per dispositivi mobili e i server, possono preacquisire più mbox per un determinato visitatore all'interno di una sessione e memorizzarle nella cache per evitare più chiamate a Adobe Target Delivery API.

curl -X POST \
'https://demo.tt.omtrdc.net/rest/v1/delivery?client=demo&sessionId=7abf6304b2714215b1fd39a870f01afc#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
    }
  },
    "prefetch": {
    "mboxes" : [
      {
        "name" : "SummerOffer",
        "index" : 1
      },
      {
        "name" : "SummerShoesOffer",
        "index" : 2
      },
      {
        "name" : "SummerDressOffer",
        "index" : 3
      }
    ]
  }
}'

All'interno del campo prefetch, aggiungi uno o più mboxes da preacquisire almeno una volta per un visitatore all'interno di una sessione. Dopo la preacquisizione di questi mboxes, si riceve la seguente risposta:

{
    "status": 200,
    "requestId": "5efee0d8-3779-4b12-a74e-e04848faf191",
    "client": "demo",
    "id": {
        "tntId": "abcdefghijkl00023.1_1"
    },
    "edgeHost": "mboxedge28.tt.omtrdc.net",
    "prefetch": {
        "mboxes": [
            {
                "index": 1,
                "name": "SummerOffer",
                "options": [
                    {
                        "content": "<p><b>Enjoy this 15% discount on your next purchase</b></p>",
                        "type": "html",
                        "eventToken": "GcvBXDhdJFNR9E9r1tgjfmqipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
                    }
                ]
            },
            {
                "index": 2,
                "name": "SummerShoesOffer",
                "options": [
                    {
                        "content": "<p><b>Enjoy this 15% discount on your next shoe purchase</b></p>"
                        "type": "html",
                        "eventToken": "GcvBXDhdJFNR9E9r1tgjfmqipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
                    }
                ]
            },
            {
                "index": 3,
                "name": "SummerDressOffer",
                "options": [
                    {
                        "content": "<p><b>Enjoy this 15% discount on your next dress purchase</b></p>"
                        "type": "html",
                        "eventToken": "GcvBXDhdJFNR9E9r1tgjfmqipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
                    }
                ]
            }
        ]
    }
}

All'interno della risposta, viene visualizzato il campo content contenente l'esperienza da mostrare al visitatore per un particolare mbox. Questa funzione è molto utile quando è memorizzata nella cache del server, in modo che, quando un visitatore interagisce con l'app web o mobile all'interno di una sessione e visita un mbox in una pagina specifica dell'applicazione, l'esperienza possa essere distribuita dalla cache anziché effettuare un'altra chiamata a Adobe Target Delivery API. Tuttavia, quando un'esperienza viene consegnata al visitatore da mbox, un notification viene inviato tramite una chiamata API di consegna per consentire la registrazione delle impression. Questo perché la risposta di prefetch chiamate è memorizzata nella cache, il che significa che il visitatore non ha visto le esperienze al momento della chiamata di prefetch. Per ulteriori informazioni sul processo notification, vedere Notifiche.