単一またはバッチ配信

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

作成対象：

  • 開発者

Adobe Target Delivery API は、単一またはバッチの配信呼び出しをサポートします。 1 つは、1 つまたは複数の mbox のコンテンツに対してサーバーリクエストを行うことができます。

1 回の呼び出しを行うことを決定する際のパフォーマンスコストとバッチ呼び出しを行う際のパフォーマンスコストを比較します。 ユーザーに表示する必要のあるすべてのコンテンツがわかっている場合は、複数のバッチ配信呼び出しを行わないように、1 回のバッチ配信呼び出しですべての mbox のコンテンツを取得することがベストプラクティスです。

1 回の配信呼び出し

Adobe Target Delivery API を介して、1 つの mbox のユーザーに表示するエクスペリエンスを取得できます。 1 回の配信呼び出しを行う場合、ユーザーの mbox の追加コンテンツを取得するには、別のサーバー呼び出しを開始する必要があります。 これは時間の経過と共に非常にコストがかかる可能性があるので、1 回の配信 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
    }
  },
    "execute": {
    "mboxes" : [
      {
        "name" : "SummerOffer",
        "index" : 1
      }
    ]
  }
}'

上記の 1 回の配信呼び出しの例では、エクスペリエンスが取得され、web チャネルの mbox:SummerOffer に対して tntId:abcdefghijkl00023.1_1 を使用してユーザーに表示されます。 この単一の配信呼び出しでは、次の応答が生成されます。

{
  "status": 200,
  "requestId": "25e0cc42-3d7b-456a-8b49-af60c1fb23d9",
  "client": "demo",
  "id": {
      "tntId": "abcdefghijkl00023.1_1"
  },
  "edgeHost": "mboxedge28.tt.omtrdc.net",
  "execute": {
      "mboxes": [
          {
              "index": 1,
              "name": "SummerOffer",
              "options": [
                  {
                      "content": "<p><b>Enjoy this 15% discount on your next purchase</b></p>",
                      "type": "html",
                  }
              ]
          }
      ]
    }
}

応答で、「content」フィールドには、SummerOffer mbox に対応する web 用にユーザーに表示するエクスペリエンスを示すHTMLが含まれていることに注意してください。

ページ読み込みを実行

フッターやヘッダーにあるフォントを AB テストするなど、web チャネルでページの読み込みが発生した場合に表示する必要があるエクスペリエンスがある場合は、execute フィールドで pageLoad を指定して、適用するすべての変更を取得できます。

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",
    "window": {
      "width": 1819,
      "height": 842
    },
    "browser": {
      "host": "target.enablementadobe.com"
    },
    "address": {
      "url": "https://target.enablementadobe.com/react/demo/#/"
    }
  },
  "execute": {
    "pageLoad": {}
  }
}'

上記の呼び出し例では、ページ https://target.enablementadobe.com/react/demo/#/ ージの読み込み時にユーザーに表示するエクスペリエンスを取得しています。

{
      "status": 200,
      "requestId": "355ebc47-edb6-481f-aeae-ae55d71afaca",
      "client": "demo",
      "id": {
          "tntId": "84e8d0e211054f18af365d65f45e902b.28_131"
      },
      "edgeHost": "mboxedge28.tt.omtrdc.net",
      "execute": {
          "pageLoad": {
              "options": [
                  {
                      "content": [
                          {
                              "type": "setHtml",
                              "selector": "#app > DIV:nth-of-type(1) > DIV:nth-of-type(1) > NAV.nav:eq(0) > DIV.container:eq(0) > DIV.nav-right:eq(0) > A.nav-item:eq(0)",
                              "cssSelector": "#app > DIV:nth-of-type(1) > DIV:nth-of-type(1) > NAV:nth-of-type(1) > DIV:nth-of-type(1) > DIV:nth-of-type(2) > A:nth-of-type(1)",
                              "content": "Modified Home"
                          }
                      ],
                      "type": "actions"
                  }
              ],
              "metrics": [
                  {
                      "type": "click",
                      "selector": "#app > DIV:nth-of-type(1) > DIV:nth-of-type(2) > SECTION.section:eq(0) > DIV.container:eq(0) > FORM.col-md-4:eq(0) > DIV.form-group:eq(0) > BUTTON.btn:eq(0)",
                      "eventToken": "QPaLjCeI9qKCBUylkRQKBg=="
                  }
              ]
          }
      }
  }

「content」フィールドでは、ページ読み込み時に適用する必要のある変更を取得できます。 上記の例では、ヘッダー上のリンクに Modified Home という名前を付ける必要があることに注意してください。