プリフェッチ

最終更新日： 2024年7月22日

作成対象：

  • 開発者

プリフェッチを使用すると、モバイルアプリやサーバーなどのクライアントは、複数の mbox またはビューのコンテンツを 1 回のリクエストで取得し、ローカルにキャッシュした後、訪問者が mbox またはビューに訪問した Target きに通知することができます。

プリフェッチを使用する場合、次の用語を理解しておくことが重要です。

フィールド名説明
prefetch取得する必要があるが、訪問済みとしてマークしてはいけない mbox とビューのリスト。 Target Edgeは、プリフェッチ配列に存在する mbox またはビューごとに eventToken を返します。
notifications以前にプリフェッチされ、訪問済みとしてマークする必要があった mbox とビューのリスト。
eventTokenコンテンツがプリフェッチされたときに返される、ハッシュ化された暗号化トークン。 このトークンは、notifications 配列の Target に送り返される必要があります。

Mbox をプリフェッチ

モバイルアプリやサーバーなどのクライアントでは、セッション内の特定の訪問者に対して複数の mbox をプリフェッチし、それらをキャッシュして、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
      }
    ]
  }
}'

「prefetch」フィールド内に、セッション内の訪問者に mboxes して少なくとも 1 回プリフェッチする 1 つ以上のリクエストを追加します。 これらの mboxes ータをプリフェッチすると、次の応答が返されます。

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

応答内には、特定の mbox ーザーの訪問者に表示するエクスペリエンスを含む content フィールドが表示されます。 これは、サーバーにキャッシュされている場合に非常に便利です。訪問者がセッション内で web アプリケーションやモバイルアプリケーションを操作し、アプリケーションの特定のページで mbox を訪問すると、別の Adobe Target Delivery API 呼び出しを行う代わりに、キャッシュからエクスペリエンスを配信できます。 ただし、エクスペリエンスが mbox ージから訪問者に配信されると、配信 API 呼び出しを介してエクスペリ notification ンスが送信され、インプレッションログが発生します。 これは、prefetch 呼び出しの応答がキャッシュされ、訪問者が prefetch 呼び出し発生時にエクスペリエンスを確認していないためです。 notification のプロセスについて詳しくは、 通知を参照してください。