Personalize APIに電話する

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

POST /v2/callFlows

ウェブベースまたはモバイルアプリケーション上でインタラクティブな実験や体験を実施します。

フロー実行要求を送信する場合、これらの属性の1つだけを使用できます。 browserId、email、またはidentifiers。

大事な

コンバージョンされた目標をアトリビューション率に含めるには、browserId属性を使用してフローを実行する必要があります。これにより、テストまたはエクスペリエンスが実行されるたびに同じセッションが保存されます。これにより、マーケターがインタラクティブなテストやエクスペリエンスに追加したゴールは、正しいブラウザーセッションに結び付けられ、コンバージョンがカウントされ、マーケターがパフォーマンス分析を表示する際のアトリビューション率が正確になります。

テストやテストを実行するたびに別のセッションに保存するには、email属性またはidentifiers属性を使用します。

必要に応じて、paramsオブジェクトを使用してカスタムフィールドを含めることができます。

browserIdを使用してテストまたはエクスペリエンスを実施する:

curl -X POST '<baseURL>/v2/callFlows' \
-H 'Accept: application/json' \
--data-raw '
{
    "clientKey": "abBah8aelipaPeebae7roox2tiexoSee",
    "channel": "WEB",
    "language": "en",
    "currencyCode": "EUR",
    "pointOfSale": "myretailsite/ireland",
    "browserId": "a38b230c-11eb-4cf9-8d5d-274e9f344925",
    "friendlyId": "home_page_banner"
}'

emailを使用してテストまたはエクスペリエンスを実施する:

curl -X POST '<baseURL>/v2/callFlows' \
-H 'Accept: application/json' \
--data-raw '
{
    "clientKey": "abBah8aelipaPeebae7roox2tiexoSee",
    "channel": "WEB",
    "language": "en",
    "currencyCode": "EUR",
    "pointOfSale": "myretailsite/ireland",
    "email": "[email protected]",
    "friendlyId": "home_page_banner"
}'

identifiersを使用してテストまたはエクスペリエンスを実施する:

curl -X POST '<baseURL>/v2/callFlows' \
-H 'Accept: application/json' \
--data-raw '
{
    "clientKey": "abBah8aelipaPeebae7roox2tiexoSee",
    "channel": "WEB",
    "language": "en",
    "currencyCode": "EUR",
    "pointOfSale": "myretailsite/ireland",
    "identifiers":{
      "id":"123456",
      "provider":"BXLP"
    },
    "friendlyId": "home_page_banner"
}'

カスタムフィールドを含める:

curl -X POST '<baseURL>/v2/callFlows' \
-H 'Accept: application/json' \
--data-raw '
{
    "clientKey": "abBah8aelipaPeebae7roox2tiexoSee",
    "channel": "WEB",
    "language": "en",
    "currencyCode": "EUR",
    "pointOfSale": "retailsite.com",
    "browserId": "a38b230c-11eb-4cf9-8d5d-274e9f344925",
    "params":{
      "loggedInState":"loggedIn",
      "someKey":"someValue"
    },
    "friendlyId": "home_page_banner"
}'

params.utmオブジェクトにUTMパラメータを含めます。

curl -X POST '<baseURL>/v2/callFlows' \
-H 'Accept: application/json' \
--data-raw '
{
   "clientKey":"abBah8aelipaPeebae7roox2tiexoSee",
   "channel":"WEB",
   "language":"en",
   "currencyCode":"EUR",
   "pointOfSale":"retailsite.com",
   "browserId": "a38b230c-11eb-4cf9-8d5d-274e9f344925",
   "params":{
      "utm":{
         "campaign":"summer_sale",
         "source":"newsletter",
         "medium":"email",
         "content":"running shoes"
      }
   },
   "friendlyId":"home_page_banner"
}

[
    {
    "trackingUrl": "<apiEndpoint>/v3/trackers/eyJjaGFubmVsIj",
      "Name": "Ancillary bundle",
      "imageURLForTesting": "https://png.icons8.com/ios/50/000000/cardboard-box.png"
    },
    {
    "trackingUrl": "<apiEndpoint>/v3/trackers/eyJjaGFubmVsIj",
      "Name": "Ancillary seat",
      "imageURLForTesting": "https://png.icons8.com/dotty/50/000000/flight-seat.png"
    },
    {
    "trackingUrl": "<apiEndpoint>/v3/trackers/eyJjaGFubmVsIj",
      "Name": "Ancillary bag",
      "imageURLForTesting": "https://png.icons8.com/metro/50/000000/suitcase.png",
      "nonDependent": "false"
    },
    {
    "trackingUrl": "<apiEndpoint>/v3/trackers/eyJjaGFubmVsIj",
      "Name": "Ancillary insurance",
      "imageURLForTesting": "https://png.icons8.com/ios/50/000000/umbrella.png",
      "nonDependent": "false"
    }
]

この記事を改善するための提案がある場合は、お知らせください!