Decisioning Migration API decisioning-migration-api

このページ： Decisioning Migration Service API を使用して、依存関係の自動分析やロールバックのサポートを備えたサンドボックス間で意思決定管理オブジェクトを移行します。これにより、データの整合性を保持しながら、環境間で意思決定コンテンツを移行できます。

Decisioning Migration Service API を使用すると、あるサンドボックスから別のサンドボックスに意思決定管理オブジェクトを移行できます。 移行プロセスは、依存関係の分析、実行、オプションのロールバック機能を含む非同期ワークフローとして実行されます。

この API を使用すると、データの整合性と関係を保持しながら、環境間で意思決定コンテンツをシームレスに移行できます。

意思決定管理と比較した決定のメリットと機能について詳しくは、このページを参照してください。

機能 capabilities

Decisioning Migration Service API には、次の機能が用意されています。

前提条件 prerequisites

必要な権限 permissions

Migration API を使用するには、ソースサンドボックスとターゲットサンドボックスの両方に適切な権限が必要です。

ソースサンドボックス - 意思決定管理オブジェクトへの読み取りアクセス権

ターゲットサンドボックス - 意思決定管理オブジェクトへの作成および編集アクセス権

一般的な権限は次のとおりです。

ターゲットサンドボックスの準備 target-sandbox-preparation

移行を実行する前に、ターゲットサンドボックスが適切に設定されていることを確認します。

サンドボックス管理について詳しくは、サンドボックスの使用と割り当てを参照してください。

サンドボックス間の移行の前提条件 cross-sandbox-prerequisites

ソースサンドボックス≠ターゲットサンドボックスの場合、次の項目が必要です。

API の基本 api-basics

ベース URL base-url

次のベース URLを使用します。

認証 authentication

すべての API リクエストには、次のヘッダーが必要です。

認証の設定手順について詳しくは、Journey Optimizer 認証ガイドを参照してください。

移行ワークフロー migration-workflow

移行プロセスは、依存関係の分析と移行の実行という 2 つの主な手順で構成されます。 移行を成功させるには、次の手順に従います。

手順 1：依存関係を分析 analyze-dependencies

移行前に、依存関係ワークフローを使用して、ターゲットサンドボックスの意思決定管理から決定にマッピングする必要がある項目を特定します。 この分析は、オブジェクト間の関係を理解し、必要なマッピングを準備するのに役立ちます。

依存関係ワークフローの作成 create-dependency-workflow

次の API 呼び出しを使用して、依存関係分析ワークフローを作成します。

API 形式

POST /workflows/generate-dependencies

サンドボックスレベルの依存関係（最初に推奨）

サンドボックスレベルの分析から始めて、すべての依存関係を包括的に把握します。

curl --request POST \
  --url "https://decisioning-migration.adobe.io/workflows/generate-dependencies?request-level=sandbox" \
  --header "Authorization: Bearer <IMS_ACCESS_TOKEN>" \
  --header "x-gw-ims-org-id: <IMS_ORG_ID>" \
  --header "Content-Type: application/json" \
  --data '{
    "imsOrgId": "<IMS_ORG_ID>",
    "sourceSandboxDetails": { "sandboxName": "<SOURCE_SANDBOX_NAME>" },
    "targetSandboxDetails": { "sandboxName": "<TARGET_SANDBOX_NAME>" }
  }'

オファーレベルの依存関係

特定のオファーの依存関係のみを分析するには、クエリ文字列に request-level=offer を含む同じエンドポイントを呼び出し、分析するオファー ID を含む offersList 配列を本文に指定します。

決定レベルの依存関係

特定の決定の依存関係のみを分析するには、クエリ文字列に request-level=decision を使用し、分析する決定 ID を含む decisionsList 配列を本文に指定します。

依存関係ワークフローのステータスの確認 poll-dependency-status

依存関係ワークフローをポーリングして、分析が完了した際に確認します。

API 形式

GET /workflows/generate-dependencies/{id}

リクエスト

curl --request GET \
  --url "https://decisioning-migration.adobe.io/workflows/generate-dependencies/<WORKFLOW_ID>" \
  --header "Authorization: Bearer <IMS_ACCESS_TOKEN>" \
  --header "x-gw-ims-org-id: <IMS_ORG_ID>"

「status」フィールドに Completed が表示されると、依存関係の分析の準備は完了です。 ワークフロー出力を使用して、移行依存関係マッピングを作成します。

これらのマッピングは、手順2の移行リクエストのdependency オブジェクトで指定します。

手順 2：移行を実行 execute-migration

依存関係を分析し、マッピングの準備が整ったら、移行を実行できます。

移行ワークフローの作成 create-migration-workflow

手順 1 の依存関係マッピングを使用して、移行を設定および実行します。

API 形式

POST /workflows/migration

サンドボックスレベルの移行

すべての決定オブジェクトをあるサンドボックスから別のサンドボックスに移行するには：

curl --request POST \
  --url 'https://decisioning-migration.adobe.io/workflows/migration?request-level=sandbox' \
  --header 'Authorization: Bearer <IMS_ACCESS_TOKEN>' \
  --header 'Content-Type: application/json' \
  --header 'x-gw-ims-org-id: <IMS_ORG_ID>' \
  --data '{
    "imsOrgId": "<IMS_ORG_ID>",
    "sourceSandboxDetails": { "sandboxName": "<SOURCE_SANDBOX_NAME>" },
    "targetSandboxDetails": { "sandboxName": "<TARGET_SANDBOX_NAME>" },
    "createDataStream": true,
    "dependency": {
      "profileAttributes": {
        "sourceAttr1": "targetAttr1"
      },
      "segments": {
        "sourceSegmentKey1": {
          "namespace": "<TARGET_SEGMENT_NAMESPACE>",
          "id": "<TARGET_SEGMENT_ID>"
        }
      },
      "contextAttributes": {
        "sourceCtx1": "targetCtx1"
      },
      "datasetName": "<TARGET_DATASET_NAME>"
    }
  }'

オファーレベルの移行

特定のオファーのみを移行するには、クエリ文字列に request-level=offer を使用し、offersList 配列を本文に追加します。

"offersList": ["offer-id-1", "offer-id-2"]

決定レベルの移行

特定の決定のみを移行するには、クエリ文字列に request-level=decision を使用し、decisionsList 配列を本文に追加します。

"decisionsList": ["decision-id-1", "decision-id-2"]

リクエストフィールド

移行ステータスの監視 poll-migration-status

移行ワークフローをポーリングして、進行状況を追跡します。

API 形式

GET /workflows/migration/{id}

リクエスト

curl --request GET \
  --url "https://decisioning-migration.adobe.io/workflows/migration/<WORKFLOW_ID>" \
  --header "Authorization: Bearer <IMS_ACCESS_TOKEN>" \
  --header "x-gw-ims-org-id: <IMS_ORG_ID>"

移行結果

「status」フィールドに Completed が表示された場合、移行は成功しました。 ワークフロー result には、以下が含まれます。

「status」フィールドに Failed が表示された場合、errors[] 配列と「result.error」フィールドで、問題の詳細を確認します。

各ワークフロー（依存関係、移行、ロールバック）は、同じリソースフィールドを返します。

移行の検証 validate-migration

移行が正常に完了したら、すべてのオブジェクトが正しく移行されたことを確認します。

検証チェックリスト validation-checklist

例 test-runtime-delivery

移行でデータストリームを作成した場合は、次の例を使用してオファー配信をテストできます。

curl --request POST \
  --url "https://edge.adobedc.net/ee/or2/v1/interact?configId=<DATASTREAM_ID>" \
  --header "Content-Type: application/json" \
  --header "x-request-id: <uuid>" \
  --data '{ "events": [ ... ] }'

移行のロールバック rollback

検証中に問題が発生した場合は、完了した移行をロールバックして、ターゲットサンドボックスを以前の状態に復元できます。

ロールバックワークフローの作成 create-rollback-workflow

元に戻す移行を参照するロールバックワークフローを作成して、ロールバックを開始します。

API 形式

POST /workflows/rollback

リクエスト

curl --request POST \
  --url "https://decisioning-migration.adobe.io/workflows/rollback" \
  --header "Authorization: Bearer <IMS_ACCESS_TOKEN>" \
  --header "x-gw-ims-org-id: <IMS_ORG_ID>" \
  --header "Content-Type: application/json" \
  --data '{ "rollbackWorkflowId": "<MIGRATION_WORKFLOW_ID>" }'

<MIGRATION_WORKFLOW_ID> を、ロールバックする移行ワークフローの ID に置き換えます。

ロールバックステータスの監視 poll-rollback-status

ロールバックワークフローをポーリングして、進行状況を追跡します。

API 形式

GET /workflows/rollback/{rollbackWorkflowId}

リクエスト

curl --request GET \
  --url "https://decisioning-migration.adobe.io/workflows/rollback/<ROLLBACK_WORKFLOW_ID>" \
  --header "Authorization: Bearer <IMS_ACCESS_TOKEN>" \
  --header "x-gw-ims-org-id: <IMS_ORG_ID>"

同時ワークフローの処理 handle-concurrency

Migration API では、組織ごとに一度に 1 つのワークフローのみを実行できます。 別のワークフローが進行中の間に新しいワークフローを作成しようとすると、409 競合​エラー応答（「ワークフローは既に進行中です…」）が受信されます。

この場合、進行中のワークフローが完了するのを待つか、ワークフロー ID を取得してステータスをポーリングします。 現在のワークフローが完了したら、新しいワークフローを作成できます。

移行範囲と適用範囲 migration-scope

移行の範囲を理解すると、意思決定管理から決定への移行を計画および検証するのに役立ちます。 この節では、移行プロセスでカバーされる内容と、手動で行う必要がある操作の概要を説明します。

インスコープ：対象範囲 in-scope

移行APIは、次の項目と機能を処理します。

範囲外：対象外の項目または手動による操作が必要 out-of-scope

次の項目は、手動で操作する必要があるか、移行ツールでサポートされていません。

エンティティマッピング参照 entity-mapping

決定管理から決定に移行する場合、エンティティは次の表に従ってマッピングされます。 マッピングには、プライマリ Decisioning エンティティと、移行中に作成または使用される追加の関連エンティティが含まれます。

意思決定管理から決定エンティティ マッピング

命名規則

移行プロセスでは、ExD_接頭辞を使用して命名規則を適用することで、一貫性を確保し、名前の競合を防ぎます。

その他の属性

リクエストと応答のモデル request-response-model

意思決定管理からDecisioningに移行する場合は、新しいリクエスト形式と応答形式を使用するようにアプリケーションコードを更新する必要があります。 どちらのシステムもEdge Network エンドポイントを使用しますが、ペイロード構造とフィールド名が異なります。

意思決定管理Edge リクエスト（現在） dm-request

現在の意思決定管理Edge リクエストは、次の構造に従います。

エンドポイント：

POST https://edge.adobedc.net/ee/v2/interact

ヘッダー：
​- Authorization: Bearer <IMS_ACCESS_TOKEN>
​- x-api-key: <API_KEY> （Developer Consoleから）
​- x-gw-ims-org-id: <IMS_ORG_ID> （形式：{ORG_ID}@AdobeOrg）
​- x-request-id: <UNIQUE_REQUEST_ID> （トレースと重複排除の場合）
​- Content-Type: application/vnd.adobe.xdm+json; schema="…/decision-request;version=1.0"
​- Accept: application/vnd.adobe.xdm+json; schema="…/decision-response;version=1.0"
​- x-sandbox-name: <SANDBOX_NAME> （例：製品、開発）

リクエスト本文パラメーター：
​- xdm:dryRun （true/false） – レポートを汚染せずにリクエストをテストします
​- xdm:propositionRequests[] – 決定リクエストの配列：
​- activityId – 決定アクティビティ ID
​- placementId - プレースメント ID
​- itemCount – 返されるオファーの最大数
​- xdm:profiles[].xdm:identityMap - ID マッピング （電子メール、ECIDなど）
​- xdm:validateContextData – 厳密なコンテキストデータ検証フラグ
​- xdm:responseFormat.xdm:includeContent – 実際のコンテンツとIDのみを含める

リクエスト本文の例：

{
  "xdm": {
    "dryRun": false,
    "propositionRequests": [
      { "activityId": "<ACTIVITY_ID>", "placementId": "<PLACEMENT_ID>", "itemCount": 3 }
    ],
    "profiles": [
      { "identityMap": { "ECID": [ { "id": "<ECID>", "primary": true } ] } }
    ],
    "validateContextData": true,
    "responseFormat": { "includeContent": true }
  }
}

Edge リクエストの決定（移行後） decisioning-request

移行後、同じEdge Network エンドポイントを介してDecisioning リクエストフォーマットを使用します。

エンドポイント：

POST https://edge.adobedc.net/ee/v2/interact

キー要求フィールド：
​- query.identity.fetch – 解決するID タイプの配列（例：["ECID"]）
​- event.xdm.environment.type – 環境タイプ："browser"、"app"、または"server"
​- event.xdm.environment.browserDetails - ブラウザーメタデータ （viewportWidth、viewportHeight、userAgent）
​- event.xdm.identityMap – 意思決定管理と同じID マッピング
​- event.xdm.timestamp - ISO 8601 タイムスタンプ
​- query.personalization.surfaces - ターゲットサーフェスの配列（例：["web://site.com/homepage"]） — decisionScopeに代わる
​- query.personalization.schemas – 返されるコンテンツスキーマ （例：["json-content-item", "html-content-item"]）
​- data.__adobe.ajo.allowDuplicateDecisionItems – 重複排除コントロール（デフォルトはtrue、複数のサーフェスに適合するアイテムは1回だけ返されるようにfalseを設定し、他のサーフェスはフォールバック/空のアイテムを受け取ります）。 決定管理allowDuplicatePropositionsを置き換えます。
​- data.__adobe.ajo.dryRun - テスト フラグ。レポート カウンターとキャップ カウンターの両方のフィードバック イベントを抑制します。 決定管理xdm:dryRunを置き換えます。 本番前に削除。

リクエスト本文の例（サーバーサイド）:

{
  "events": [
    {
      "query": {
        "identity": { "fetch": ["ECID"] },
        "personalization": {
          "surfaces": ["web://my-web/IP_NLI_HP_GET_LOAN_WIDGET"],
          "schemas": [
            "https://ns.adobe.com/personalization/json-content-item",
            "https://ns.adobe.com/personalization/html-content-item"
          ]
        }
      },
      "xdm": {
        "eventType": "decisioning.propositionFetch",
        "environment": {
          "type": "browser",
          "browserDetails": { "viewportWidth": 1280, "viewportHeight": 900, "userAgent": "<USER_AGENT>" }
        },
        "identityMap": {
          "ECID": [ { "id": "<ECID>", "authenticatedState": "ambiguous", "primary": true } ]
        },
        "timestamp": "2025-09-08T12:00:00.000Z"
      },
      "data": {
        "__adobe": { "ajo": { "allowDuplicateDecisionItems": false } }
      }
    }
  ],
  "meta": {
    "state": {
      "domain": "my-web",
      "cookiesEnabled": true,
      "entries": [
        { "key": "kndctr_<ORG>_AdobeOrg_identity", "value": "<identity-cookie>" },
        { "key": "kndctr_<ORG>_AdobeOrg_cluster", "value": "<cluster-cookie>" }
      ]
    }
  }
}

Edgeの応答の決定 decisioning-response

決定応答には、関心のタイプ別に整理された複数のハンドルが含まれています：personalization:decisions （オファー）、locationHint:result、およびstate:store （保持するCookie）。

応答構造：

{
  "requestId": "<REQUEST_ID>",
  "handle": [
    {
      "type": "personalization:decisions",
      "eventIndex": 0,
      "payload": [
        {
          "id": "103ae599-e6d8-4631-baf3-51dd8c6ed4c1",
          "scope": "web://my-web/IP_NLI_HP_GET_LOAN_WIDGET",
          "scopeDetails": {
            "decisionProvider": "AJO",
            "correlationID": "<CORRELATION_ID>",
            "characteristics": {
              "eventToken": "<base64 message-level event token>",
              "subPropositions": "<base64-encoded array of decision items>"
            },
            "rank": 1,
            "activity": {
              "id": "<campaignId>#<actionId>",
              "priority": 0,
              "matchedSurfaces": ["web://my-web/IP_NLI_HP_GET_LOAN_WIDGET"]
            }
          },
          "items": [
            {
              "id": "36646bab-af1b-44c6-b632-bbfb9c357919",
              "schema": "https://ns.adobe.com/personalization/json-content-item",
              "data": { "content": "{ ...offer JSON... }" }
            }
          ]
        }
      ]
    },
    {
      "type": "locationHint:result",
      "payload": [
        { "scope": "EdgeNetwork", "hint": "ind1", "ttlSeconds": 1800 }
      ]
    },
    {
      "type": "state:store",
      "payload": [
        { "key": "kndctr_<ORG>_AdobeOrg_cluster", "value": "<cluster-cookie>", "maxAge": 1800 },
        { "key": "kndctr_<ORG>_AdobeOrg_identity", "value": "<identity-cookie>", "maxAge": 34128000 }
      ]
    }
  ]
}

キー応答フィールド：
​- handle[].type - ハンドルの種類（personalization:decisions、locationHint:result、state:store）
​- payload[].id – 一意の提案インスタンス ID – 表示/インタラクティブイベントにエコーします
​- payload[].scope – 提案が解決されたサーフェス URI
​- payload[].scopeDetails.decisionProvider - エンジンがAJOであることを確認します
​- payload[].scopeDetails.correlationID – 決定インスタンスをサービングイベントにリンクします
​- payload[].scopeDetails.rank / payload[].scopeDetails.activity – 提案のランクおよびキャンペーン/アクション メタデータ
​- payload[].scopeDetails.characteristics.eventToken - メッセージレベルのトラッキングトークン
​- payload[].scopeDetails.characteristics.subPropositions - Base64でエンコードされた​決定項目の配列。各項目には、項目ごとに独自のtokenが格納されます。 これらのアイテムごとのトークンは、表示/インタラクティブイベントでpropositionAction.tokensに渡されるものです
​- payload[].items[].schema / payload[].items[].data.content - コンテンツスキーマと実際のオファーコンテンツ（JSON/HTML）をレンダリングする
​- state:store ペイロード – 後続のリクエストで永続化および転送するIDおよびクラスターCookie （サーバーサイド）

characteristics.subPropositions文字列base64-decodesは、各項目tokenを持つサービス済み項目の配列に対して行われます。

[
  {
    "id": "1ae75277-8832-4c23-bbbc-09f01cfe6c8b",
    "scope": "web://my-web/IP_NLI_HP_GET_LOAN_WIDGET",
    "scopeDetails": { "decisionProvider": "EXD", "correlationID": "<CORRELATION_ID>-0", "rank": 1 },
    "items": [
      { "id": "dps:<schema>:1be64ff83a612488", "name": "ExD_Personal Loan Offer", "score": 997.0, "token": "CLaefQnVLcLbCtzEXV3Jeg" },
      { "id": "dps:<schema>:1be6516838e1248c", "name": "ExD_Home Loan Offer",     "score": 995.0, "token": "ALlB5KV1B0e+CpHoahi7Ew" },
      { "id": "dps:<schema>:1be650da3cd06e98", "name": "ExD_Auto Loan Offer",     "score": 994.0, "token": "koJTRQcwFkR92AqbZ88ytQ" },
      { "id": "dps:<schema>:1be65612d5a1248d", "name": "ExD_Fallback Offer",      "itemSelection": { "selectionDetail": { "selectionType": "fallback" } }, "token": "GHo4ow7h6iCzBOhYR1+6jg" }
    ]
  }
]

実装パターン implementation-patterns

決定機能では、次の3つの実装アプローチをサポートしています。

クライアントサイド実装（Web SDK / モバイルSDK） client-side

Web SDKまたはモバイル SDKは、すべてのリクエストとCookie管理を自動的に処理します。 SDKは、IDとクラスターの両方のCookieを各リクエストに格納して転送します。

Cookie処理：​自動 – Web SDKはkndctr_<OrgId>_identityおよびkndctr_<OrgId>_cluster個のCookieを管理します。

サーバーサイド実装（Edge Network API） server-side

アプリケーションサーバーは直接Edge NetworkにPOSTし、Cookie転送を手動で管理する必要があります。 サーバーは、受信リクエストからブラウザーのCookieを抽出し、meta.state.entries[]経由でEdge Networkに転送し、応答でCookieを返します。

Cookie処理：​手動 – アプリサーバーは、ブラウザーリクエストからCookieを抽出し、リクエスト本文でEdge Networkに転送し、応答として設定する必要があります。 IDの一貫性を保つため、Cookieはmeta.state.entriesで明示的に転送する必要があります。

ハイブリッド実装 hybrid

サーバーサイドのレンダリング（最初のページ読み込み）とクライアントサイドのSDK（その後のインタラクション）を組み合わせます。 サーバーは最初のコンテンツをEdge Network経由でレンダリングし、その後のパーソナライゼーションリクエストにはWeb SDKが引き継ぎます。

Cookie処理：​混在 – サーバーサイドではEdge Networkへの手動Cookie転送が必要です。クライアントサイドはWeb SDKによって自動的に処理されます。 サーバーサイドレンダリングのID トークンが、クライアントサイドのSDKで使用できることを確認し、一貫性のあるID解決を実現します。

イベントのトラッキングとデータ収集 event-tracking

決定結果を適切に帰属させ、頻度の上限を有効にし、AI ベースのランキングの最適化を強化するには、決定イベントスキーマを使用したイベントトラッキングを実装する必要があります。

必須イベントフィールド event-fields

eventTypeと_experience.decisioning.propositionEventTypeの両方が必要です。 いずれかが見つからない場合、対応するdisplay/interact カウンターは増分されません。

スキーマ要件 schema-requirements

移行前に、決定フィールドグループをイベントデータセットスキーマに関連付けます。

トラッキングトークンの処理 tracking-token

トラッキングトークンは、次の要件に従って処理する必要があります。

決定イベントの例 event-examples

各例は、提供された提案（characteristics.subPropositionsを含むscopeDetailsを含む）を反映し、eventTypeとpropositionEventTypeの両方を設定します。 subPropositionsの項目に対してカウンターが増加します。propositionAction.tokensは、どの項目を選択します。

表示イベント

ユーザーにオファーが表示されると、表示イベントがDecisioningに通知します。 表示されている項目のトークンを指定するか、tokensを省略して、subPropositionsのすべての項目の表示カウンターを増やします。

{
  "header": {
    "imsOrgId": "YOUR_ORG_ID",
    "sandboxId": "sandbox-id",
    "sandboxName": "sandbox-name",
    "source": { "name": "ajo-inbound" }
  },
  "body": {
    "xdmEntity": {
      "identityMap": {
        "ECID": [ { "id": "ecid-123", "primary": true } ]
      },
      "eventType": "decisioning.propositionDisplay",
      "_experience": {
        "decisioning": {
          "propositionEventType": { "display": 1 },
          "propositionAction": {
            "id": "b96f842b-5dd9-4c55-9dae-647d96250028",
            "tokens": ["CLaefQnVLcLbCtzEXV3Jeg", "ALlB5KV1B0e+CpHoahi7Ew"]
          },
          "propositions": [
            {
              "id": "103ae599-e6d8-4631-baf3-51dd8c6ed4c1",
              "scope": "web://my-web/IP_NLI_HP_GET_LOAN_WIDGET",
              "scopeDetails": {
                "decisionProvider": "AJO",
                "characteristics": {
                  "eventToken": "<base64 eventToken from response>",
                  "subPropositions": "<base64 subPropositions from response>"
                }
              }
            }
          ]
        }
      }
    }
  }
}

インタラクション（クリック）イベント

インタラクティブイベントは、オーディエンスが表示されたオファーをクリックまたはエンゲージメントしたときに追跡します。 クリックされた項目を識別する​個のトークンを​ 個 ​指定する必要があります：

{
  "header": {
    "imsOrgId": "YOUR_ORG_ID",
    "sandboxId": "sandbox-id",
    "sandboxName": "sandbox-name",
    "source": { "name": "ajo-inbound" }
  },
  "body": {
    "xdmEntity": {
      "identityMap": {
        "ECID": [ { "id": "ecid-123", "primary": true } ]
      },
      "eventType": "decisioning.propositionInteract",
      "_experience": {
        "decisioning": {
          "propositionEventType": { "interact": 1 },
          "propositionAction": {
            "id": "b96f842b-5dd9-4c55-9dae-647d96250028",
            "tokens": ["CLaefQnVLcLbCtzEXV3Jeg"]
          },
          "propositions": [
            {
              "id": "103ae599-e6d8-4631-baf3-51dd8c6ed4c1",
              "scope": "web://my-web/IP_NLI_HP_GET_LOAN_WIDGET",
              "scopeDetails": {
                "decisionProvider": "AJO",
                "characteristics": {
                  "eventToken": "<base64 eventToken from response>",
                  "subPropositions": "<base64 subPropositions from response>"
                }
              }
            }
          ]
        }
      }
    }
  }
}

カスタムイベント

カスタムイベントでは、顧客定義のeventType （decisioning.proposition<Display|Interact|Dismiss>以外の任意の値）を使用し、propositionEventTypeのdisplay/interact/dismissから0までのすべてを設定します（OTHERに分類）。 カスタムイベントは、ディスプレイイベント（マルチトークンフィルタリング）のようにsubPropositionsに対してデコードされ、設定されたPQLを使用して評価されます。

{
  "header": {
    "imsOrgId": "YOUR_ORG_ID",
    "sandboxId": "sandbox-id",
    "sandboxName": "sandbox-name",
    "originalTimestamp": 1700000
  },
  "body": {
    "xdmEntity": {
      "identityMap": {
        "ECID": [ { "id": "ecid-123", "primary": true } ]
      },
      "eventType": "add-to-cart",
      "_experience": {
        "decisioning": {
          "propositionEventType": { "display": 0, "interact": 0, "dismiss": 0 },
          "propositionAction": {
            "id": "b96f842b-5dd9-4c55-9dae-647d96250028",
            "tokens": ["CLaefQnVLcLbCtzEXV3Jeg"]
          },
          "propositions": [
            {
              "id": "103ae599-e6d8-4631-baf3-51dd8c6ed4c1",
              "scope": "web://my-web/IP_NLI_HP_GET_LOAN_WIDGET",
              "scopeDetails": {
                "decisionProvider": "AJO",
                "characteristics": {
                  "eventToken": "<base64 eventToken from response>",
                  "subPropositions": "<base64 subPropositions from response>"
                }
              }
            }
          ]
        }
      }
    }
  }
}

これらのイベントにより、頻度の上限、すぐに使用できるレポート、意思決定におけるAIを活用したランキングの最適化が可能になります。 Web SDKを使用して提案イベントを送信する方法については、​ コードベースのエクスペリエンス：実装の決定を参照してください。

エンドツーエンドの移行プロセス migration-process

関連トピック related-topics