Skip to content
Last updated

REST APIからのDecision Pointのマージおよび重複機能の使用

Decision Pointを使用することで、カスタマージャーニーをより適切にパーソナライズできます。選択したDecision Pointに基づいて、ジャーニーパスを分岐または再接続できます。

Decision Pointの作成

特定の基準に基づいてDecision Pointを追加することで、顧客のジャーニー体験をパーソナライズできます。たとえば、メールオファーに応答したかどうかに基づいて、ジャーニーパスを変更または分岐できます。ジャーニーステージ内に最大2層のDecision Pointを追加できます。さらに、プロファイルが複数のパスに該当する場合にDecision Pointに優先順位を付けることができます。パスの優先順位は、ペイロード内で上から下への配置順序によって決まります。

  1. PATCHメソッドとジャーニーIDを使用して、既存のジャーニーにDecision Pointを追加します。次の例では、ジャーニーIDは2058です。
PATCH https://api-cdp.treasuredata.com/entities/journeys/2058
  1. ペイロードに、Decision Pointとそれに含まれるパスを追加します。Decision Pointはイベントまたはオブジェクトを記述し、各Decision Pointには2~6個のパスを設定できます。また、除外されたプロファイル(いずれの決定パスも満たさないプロファイル)をキャプチャするために、Decision Pointに除外パスを追加することもできます。たとえば、顧客がディーラーのウェブサイトで車などの特定の商品ページにアクセスした場合のDecision Pointを作成し、その後、フォームへの入力を含むパスを設定し、訪問者の地域に基づいて分岐させることができます。プロファイルが特定の決定パスを満たす場合、プロファイルはそのパスに従います。次の例では、Decision Pointには地域と性別の両方が含まれています。ただし、Decision Pointに「除外されたプロファイル」パスがある場合、いずれの決定パスも満たさないプロファイルは「除外されたプロファイル」パスに従います。
{
  "type": "journey",
  "attributes": {
    "name": "Draft journey",
    "state": "draft",
    "audienceId": "57320",
    "description": "",
    "journeyStages": [
      {
        "name": "StageA",
        "id": "4080",
        "entryCriteria": null,
        "exitCriterias": null,
        "milestone": null,
        "rootStep": "9ad15b6d-53e3-42fd-89bd-7c00adce4379",
        "steps": {
          "9ad15b6d-53e3-42fd-89bd-7c00adce4379": {
            "type": "DecisionPoint",
            "branches": [
              {
                "uuid": "4f77161a-f7cb-41d0-bc43-31ee4c9ba394",
                "name": "North America",
                "description": "Customer lives in North America",
                "excludedPath": false,
                "segmentId": "1000",
                "next": ""
              },
              {
                "uuid": "e8413329-551d-47a1-9e71-08927e8a2f30",
                "name": "Asia",
                "description": "Customer lives in Asia",
                "excludedPath": false,
                "segmentId": "1001",
                "next": "2969c02b-adb9-4f45-acfd-e1d006908522"
              },
              {
                "uuid": "c47fe48e-fcbc-4f93-a75d-c6fd11ca8a20",
                "name": "Excluded profiles",
                "description": "comment",
                "excludedPath": true,
                "segmentId": null,
                "next": ""
              }
            ]
          },
          "2969c02b-adb9-4f45-acfd-e1d006908522": {
            "type": "DecisionPoint",
            "branches": [
              {
                "uuid": "7b6822a9-bb24-4e01-b8cc-76d31e32952d",
                "name": "Male",
                "description": "Customer is a male",
                "excludedPath": false,
                "segmentId": "1002",
                "next": "8e02f3e3-2f1f-4172-a793-57cc7d2db173"
              },
              {
                "uuid": "55c38fad-b184-4152-82f3-4b9ca4cbb01f",
                "name": "Female",
                "description": "Customer is a female",
                "excludedPath": false,
                "segmentId": "1003",
                "next": "8e02f3e3-2f1f-4172-a793-57cc7d2db173"
              }
            ]
          },
          "8e02f3e3-2f1f-4172-a793-57cc7d2db173": {
            "type": "Merge",
            "next": ""
          }
        }
      }
    ],
    "goal": null
  },
  "relationships": {
    "parentFolder": {
      "data": {
        "id": "205977",
        "type": "folder-segment"
      }
    }
  },
  "id": "2058"
}

Decision Pointの編集

ジャーニーを開始する前に、作成したDecision Pointを編集できます。たとえば、次のいずれかを行う必要がある場合があります:

  • 決定パスの名前を変更する
  • 決定パスを編集する
  • Decision Pointのパスを削除する
  • Decision Point全体を削除する
  • Decision Pointのパスを並べ替える*

Decision Point内の決定パスは、それぞれのDecision Point内で並べ替えることができます。

  1. PATCHメソッドとジャーニーIDを使用して、既存のジャーニーのDecision Pointを編集します。
PATCH https://api-cdp.treasuredata.com/entities/journeys/2058
  1. ペイロードで、指定されたジャーニーのDecision Pointを変更します。次の例では、Decision Pointがヨーロッパの顧客を含むように編集されています。
{
  "type": "journey",
  "attributes": {
    "name": "Draft journey",
    "state": "draft",
    "audienceId": "57320",
    "description": "",
    "journeyStages": [
      {
        "name": "StageA",
        "id": "4080",
        "entryCriteria": null,
        "exitCriterias": null,
        "milestone": null,
        "rootStep": "9ad15b6d-53e3-42fd-89bd-7c00adce4379",
        "steps": {
          "9ad15b6d-53e3-42fd-89bd-7c00adce4379": {
            "type": "DecisionPoint",
            "branches": [
              {
                "uuid": "4f77161a-f7cb-41d0-bc43-31ee4c9ba394",
                "name": "North America",
                "description": "顧客は北米に在住",
                "excludedPath": false,
                "segmentId": "1000",
                "next": ""
              },
              {
                "uuid": "e8413329-551d-47a1-9e71-08927e8a2f30",
                "name": "Asia",
                "description": "顧客はアジアに在住",
                "excludedPath": false,
                "segmentId": "1001",
                "next": "2969c02b-adb9-4f45-acfd-e1d006908522"
              },
              {
                "uuid": "c47fe48e-fcbc-4f93-a75d-c6fd11ca8a20",
                "name": "Excluded profiles",
                "description": "コメント",
                "excludedPath": true,
                "segmentId": null,
                "next": ""
              }
            ]
          },
          "2969c02b-adb9-4f45-acfd-e1d006908522": {
            "type": "DecisionPoint",
            "branches": [
              {
                "uuid": "7b6822a9-bb24-4e01-b8cc-76d31e32952d",
                "name": "Male",
                "description": "顧客は男性",
                "excludedPath": false,
                "segmentId": "1002",
                "next": "8e02f3e3-2f1f-4172-a793-57cc7d2db173"
              },
              {
                "uuid": "55c38fad-b184-4152-82f3-4b9ca4cbb01f",
                "name": "Female",
                "description": "顧客は女性",
                "excludedPath": false,
                "segmentId": "1003",
                "next": "8e02f3e3-2f1f-4172-a793-57cc7d2db173"
              }
            ]
          },
          "8e02f3e3-2f1f-4172-a793-57cc7d2db173": {
            "type": "Merge",
            "next": ""
          }
        }
      }
    ],
    "goal": null
  },
  "relationships": {
    "parentFolder": {
      "data": {
        "id": "205977",
        "type": "folder-segment"
      }
    }
  },
  "id": "2058"
}

Decision Pointはジャーニーが起動された後は編集できません。

Decision Pointのマージ

Decision Pointをマージすることで、指定したDecision Pointの後にプロファイルが同じジャーニーパスを辿るようにできます。マージするパスを選択し、パスをマージする特定のポイントを指定できます。また、マージを削除することもできます。

  1. PATCHメソッドとジャーニーIDを使用して、既存のジャーニーにマージポイントを追加します。次の例では、性別に関係なく顧客パスがマージされ、別の分岐が指定されるかジャーニーが終了するまで、ユーザーは同じパスに沿って進みます。
PATCH https://api-cdp.treasuredata.com/entities/journeys/2058
  1. ペイロードで、指定したジャーニーにマージポイントを追加します。
{
  "type": "journey",
  "attributes": {
    "name": "Draft journey",
    "state": "draft",
    "audienceId": "57320",
    "description": "",
    "journeyStages": [
      {
        "name": "StageA",
        "id": "4080",
        "entryCriteria": null,
        "exitCriterias": null,
        "milestone": null,
        "rootStep": "9ad15b6d-53e3-42fd-89bd-7c00adce4379",
        "steps": {
          "9ad15b6d-53e3-42fd-89bd-7c00adce4379": {
            "type": "DecisionPoint",
            "branches": [
              {
                "uuid": "4f77161a-f7cb-41d0-bc43-31ee4c9ba394",
                "name": "North America",
                "description": "顧客は北米に在住",
                "excludedPath": false,
                "segmentId": "1000",
                "next": ""
              },
              {
                "uuid": "e8413329-551d-47a1-9e71-08927e8a2f30",
                "name": "Asia",
                "description": "顧客はアジアに在住",
                "excludedPath": false,
                "segmentId": "1001",
                "next": "2969c02b-adb9-4f45-acfd-e1d006908522"
              },
              {
                "uuid": "c47fe48e-fcbc-4f93-a75d-c6fd11ca8a20",
                "name": "Excluded profiles",
                "description": "コメント",
                "excludedPath": true,
                "segmentId": null,
                "next": ""
              }
            ]
          },
          "2969c02b-adb9-4f45-acfd-e1d006908522": {
            "type": "DecisionPoint",
            "branches": [
              {
                "uuid": "7b6822a9-bb24-4e01-b8cc-76d31e32952d",
                "name": "Male",
                "description": "顧客は男性",
                "excludedPath": false,
                "segmentId": "1002",
                "next": "8e02f3e3-2f1f-4172-a793-57cc7d2db173"
              },
              {
                "uuid": "55c38fad-b184-4152-82f3-4b9ca4cbb01f",
                "name": "Female",
                "description": "Customer is a female",
                "excludedPath": false,
                "segmentId": "1003",
                "next": "8e02f3e3-2f1f-4172-a793-57cc7d2db173"
              }
            ]
          },
          "8e02f3e3-2f1f-4172-a793-57cc7d2db173": {
            "type": "Merge",
            "next": ""
          }
        }
      }
    ],
    "goal": null
  },
  "relationships": {
    "parentFolder": {
      "data": {
        "id": "205977",
        "type": "folder-segment"
      }
    }
  },
  "id": "2058"
}

ジャーニーの複製

起動後のジャーニーは編集できませんが、既存のジャーニーを複製して編集し、同じ親セグメント内にドラフトとして保存することができます。この方法により、既存の起動済みジャーニーのセグメントやアクティベーションを含むすべての設定をコピーできます。ドラフトモードのジャーニーも複製できます。

  1. POST メソッドとジャーニー ID を使用して、既存の起動済みジャーニーを複製します。
POST https://api-cdp.treasuredata.com/entities/journeys/duplicate
  1. ジャーニーとその依存リソースをドラフトとして新しいジャーニーにコピーできます。リクエストボディは次の例のようになります。以下の例では、複製されるジャーニーは 9957 です。
{
  "id": "9957",
  "type": "journey",
  "attributes": {
    "name": "Duplicated journey"
  },
  "relationships": {
    "parentFolder": {
      "data": {
        "id": "7601",
        "type": "folder-segment"
      }
    }
  }
}

Decision Pointの削除

ジャーニーを起動する前に作成したDecision Pointは、指定したデシジョンパスを削除することで削除できます。

  1. PATCH メソッドとジャーニー ID を使用して、既存のジャーニーのDecision Pointを削除します。
PATCH https://api-cdp.treasuredata.com/entities/journeys/2058
  1. ペイロード内で、指定したジャーニーのDecision Pointを変更します。以下の例では、プロファイルの性別に基づいてパスを変更するDecision Point 2969c02b-adb9-4f45-acfd-e1d006908522 と対応するマージがペイロードから削除されています。他の条件が同じマージに依存している場合は、マージをペイロード内に保持できます。
{
  "type": "journey",
  "attributes": {
    "name": "Draft journey",
    "state": "draft",
    "audienceId": "57320",
    "description": "",
    "journeyStages": [
      {
        "name": "StageA",
        "id": "4080",
        "entryCriteria": null,
        "exitCriterias": null,
        "milestone": null,
        "rootStep": "9ad15b6d-53e3-42fd-89bd-7c00adce4379",
        "steps": {
          "9ad15b6d-53e3-42fd-89bd-7c00adce4379": {
            "type": "DecisionPoint",
            "branches": [
              {
                "uuid": "4f77161a-f7cb-41d0-bc43-31ee4c9ba394",
                "name": "North America",
                "description": "Customer lives in North America",
                "excludedPath": false,
                "segmentId": "1000",
                "next": ""
              },
              {
                "uuid": "e8413329-551d-47a1-9e71-08927e8a2f30",
                "name": "Europe",
                "description": "Customer lives in Europe",
                "excludedPath": false,
                "segmentId": "1001",
                "next": "2969c02b-adb9-4f45-acfd-e1d006908522"
              },
              {
                "uuid": "e8413329-551d-47a1-9e71-08927e8a2f30",
                "name": "Asia",
                "description": "Customer lives in Asia",
                "excludedPath": false,
                "segmentId": "1001",
                "next": "2969c02b-adb9-4f45-acfd-e1d006908522"
              },
              {
                "uuid": "c47fe48e-fcbc-4f93-a75d-c6fd11ca8a20",
                "name": "Excluded profiles",
                "description": "comment",
                "excludedPath": true,
                "segmentId": null,
                "next": ""
              }
            ]
          }
        }
      }
    ],
    "goal": null
  },
  "relationships": {
    "parentFolder": {
      "data": {
        "id": "205977",
        "type": "folder-segment"
      }
    }
  },
  "id": "2058"
}