オーケストレーションの設定
AI意思決定エージェントは、顧客データを取り込み1:1レベルでパーソナライズした後、コミュニケーションをオーケストレーションするためにカスタマーエンゲージメントプラットフォーム（CEP）に接続する必要があります。この記事では、準備に必要なものと、サポートされている各CEPの統合を構成する方法について説明します。
オーケストレーションとは
オーケストレーションとは、Decisioning Studioとカスタマーエンゲージメントプラットフォーム（CEP）間の接続です。AI意思決定エージェントが各顧客に最適なアクションを決定すると、オーケストレーションがCEPを通じてパーソナライズされたコミュニケーションをトリガーすることで、その決定を実行します。
次のように考えてください：
- Decisioning Studioは何を送信するか、いつ送信するかを決定します
- CEPはどのように送信するかを処理します
CEPの選択
最初のステップは、Decisioning Studioで使用するCEPを選択することです。選択によって、設定の複雑さと利用可能な機能が異なります。
サポートされているCEP
| CEP | 統合タイプ | 設定の複雑さ |
|---|---|---|
| Braze | ネイティブAPI統合（推奨） | 低 |
| Salesforce Marketing Cloud | APIイベント + Journey Builder | 中 |
| その他のCEP | カスタム（レコメンデーションファイル） | 高 |
すでにBrazeをCEPとして使用している場合は、最もスムーズな設定体験のためにネイティブBraze統合を使用することをお勧めします。
前提条件
オーケストレーションを設定する前に、選択したCEPに基づいて以下の項目を準備してください。
| 要件 | 説明 |
|---|---|
| REST APIキー | ユーザーデータ、メッセージ、Campaigns、Canvas、Segments、テンプレートの権限を持つ新しいAPIキー。 |
| BrazeダッシュボードURL | BrazeインスタンスURL（例：https://dashboard-01.braze.com）。 |
| アプリID | トラッキングしたいアプリに関連付けられたAPIキー（設定 > アプリ設定で確認できます）。 |
| メール表示名とアドレス | Campaignsに使用する送信者情報（設定 > メール設定で確認できます）。 |
| ベーステンプレート | エージェントがオーケストレーションに使用するメッセージテンプレート。各テンプレートに対してAPIトリガーCampaignsを作成します。 |
| テストユーザーID | 起動前に統合をテストするためのユーザーID。 |
| 要件 | 説明 |
|---|---|
| アプリパッケージ認証情報 | サーバー間API統合を持つインストール済みパッケージからのクライアントID、クライアントシークレット、認証ベースURI、RESTベースURI、SOAPベースURI。 |
| API権限 | チャネル、アセット、オートメーション、ジャーニー、コンタクト、データエクステンション、トラッキングイベントのスコープ。 |
| データエクステンション | サブスクライバーデータ、エンゲージメントデータ、レコメンデーション用のデータエクステンションが必要です。 |
| メールテンプレート | Decisioning Studioで使用するテンプレートと、各テンプレートのテンプレートID。 |
| Journey Builderアクセス | APIイベントエントリソースを使用したマルチステップジャーニーの作成とアクティベーションへのアクセス。 |
BrazeまたはSalesforce Marketing Cloud以外のCEPを使用している場合、Decisioning Studioはレコメンデーションファイルアプローチを通じて統合できます：
| 項目 | 説明 |
|---|---|
| データ取り込み機能 | CEPは、各顧客のパーソナライズされた決定を含むレコメンデーションファイル（通常CSVまたはJSON）を取り込める必要があります。 |
| ダイナミックコンテンツサポート | Campaignsはレコメンデーションデータに基づいてフィールドを動的に入力できる必要があります。 |
| カスタムエンジニアリングリソース | チームがレコメンデーションファイルを読み取り、コミュニケーションをトリガーする統合を構築する必要があります。 |
Campaignsの計画
オーケストレーションを設定する前に、以下の詳細を検討してください：
ベーステンプレート
ベーステンプレートとは、AI意思決定エージェントが使用する可能性のあるメッセージテンプレートです。以下を検討してください：
- テンプレートの数は？ エージェントは1つのテンプレートでも複数のテンプレートでも動作できます。複数の場合、エージェントは各顧客が受け取るテンプレートをパーソナライズできます。
- どのチャネル？ メール、プッシュ、SMS、またはそれらの組み合わせです。各チャネルには個別のテンプレートとCampaignsが必要になる場合があります。
- どのダイナミック要素？ エージェントがパーソナライズするメッセージの部分（件名、CTA、オファー、タイミングなど）を特定します。これらはAPIトリガープロパティまたはダイナミックプレースホルダーになります。
再適格性設定
Campaignsでは、ユーザーが複数回メッセージを受信できるようにする必要があります：
- テスト時には、同じCampaignを同じユーザーに繰り返し送信する必要があります
- 本番環境では、エージェントが連続する日に同じCampaignがユーザーにとって最適であると判断する場合があります
テスト用に再適格性を設定する場合でも、Decisioning Studioエージェントはフリークエンシーキャップを尊重するように設計されており、本番環境では同じCampaignを1日に1回以上ユーザーに送信することはありません。
APIトリガープロパティ
Braze統合の場合、エージェントが最適化するディメンションを計画します。これらはCampaignsにダイナミックな値を渡すAPIトリガープロパティになります：
| ディメンションの例 | APIトリガープロパティ |
|---|---|
| 件名 | {{api_trigger_properties.${subject_line}}} |
| コールトゥアクション | {{api_trigger_properties.${cta_message}}} |
| オファー | {{api_trigger_properties.${offer_id}}} |
| 割引額 | {{api_trigger_properties.${discount}}} |
統合の設定
以下からCEPを選択して、統合の設定を開始してください。
Braze統合の設定
以下の手順に従って、Decisioning StudioエージェントをBrazeのオーケストレーション機能と統合します（Brazeのサービスチームがサポートいたします）：
ステップ 1: APIキーの作成
設定 > APIキーに移動し、以下の権限を持つ新しいキーを作成します：
| 権限 | 目的 | 必須かどうか |
|---|---|---|
/users/track |
ユーザープロファイルのカスタム属性を更新します。また、テスト送信を使用する際に一時的なユーザープロファイルを作成します。 | ✓ |
/users/delete |
テスト送信の使用中に作成された一時的なユーザープロファイルを削除します。 | テスト送信のみ |
/users/export/segment |
選択した各Segmentからユーザーの一覧をエクスポートして、毎朝利用可能なオーディエンスのコミュニケーションを更新します。 | ✓ |
/users/export/ids |
Segmentの代わりに external_id を使用してユーザーをターゲットにする場合に、識別子の一覧を取得します。Decisioning Studioは個人を特定できる情報（PII）を受け付けないため、fields_to_export パラメーターが非PIIフィールドのみを返すようにする必要があります。 |
external_ids を使用している場合のみ |
/messages/send |
Decisioning Studioの実験者向けに設定されたAPI Campaignsを使用して、推奨される時間に推奨されるバリアントを送信します。 | ✓ |
/campaigns/list |
アクティブなCampaignsの一覧を取得し、実験に使用可能なメールコンテンツを抽出します。 | ✓ |
/campaigns/data_series |
集計されたCampaignデータをエクスポートして、Decisioning Studioでのレポート作成、検証、トラブルシューティングを可能にします。レポート値を比較し、ベースラインのパフォーマンスを分析できます。 必須ではありませんが、この権限を推奨します。 |
|
/campaigns/details |
既存のCampaignsからHTMLコンテンツ、件名、画像リソースを取得して、実験に使用します。 | ✓ |
/canvas/list |
アクティブなCanvasesの一覧を取得し、実験に使用可能なメールコンテンツを抽出します。 | ✓ |
/canvas/data_series |
集計されたCanvasデータをエクスポートして、レポート作成と検証を行います。特にBAUがCanvasでオーケストレーションされている場合に有用です。 必須ではありませんが、この権限を推奨します。 |
|
/canvas/details |
既存のCanvasesからHTMLコンテンツ、件名、画像リソースを取得して、実験に使用します。 | ✓ |
/segments/list |
既存の全Segmentsを、Decisioning Studioの実験者向けの潜在的なターゲットオーディエンスとして取得します。 | ✓ |
/segments/data_series |
オーディエンスを選択する際にDecisioning Studioに表示されるSegmentサイズ情報をエクスポートします。 | ✓ |
/segments/details |
オーディエンスのサイズやパフォーマンスの変化を理解するのに役立つ、エントリや終了の基準などのSegmentの詳細を取得します。 | |
/templates/email/create |
実験用に、ダイナミックなプレースホルダー（Braze Liquidタグ）を含む選択済みの基本HTMLテンプレートのコピーを作成し、オリジナルへの変更を回避します。 | ✓ |
/templates/email/update |
コールトゥアクションなどの実験条件が変更された場合に、Decisioning Studioで作成されたテンプレートのコピーに更新を反映します。 | ✓ |
/templates/email/info |
BrazeインスタンスでDecisioning Studioによって作成されたテンプレートの情報を取得します。 | ✓ |
/templates/email/list |
テンプレートがBrazeインスタンスに正常にコピーされたことを検証します。 | ✓ |
ステップ 2: APIトリガーCampaignsの設定
各ベーステンプレートに対して、すべての最適化ディメンションのAPIトリガープロパティを含むAPIトリガーCampaignを設定します。
ベーステンプレートとは、AI意思決定エージェントがメッセージのオーケストレーションに使用する可能性のあるテンプレートです。AI意思決定エージェントは1つのベーステンプレートを持つ場合も複数を持つ場合もあり、複数の場合は各顧客に適切なベーステンプレートを選択することがエージェントのパーソナライズする決定の1つになります。
ステップ 3: 再適格性の構成
すべてのAPIトリガーCampaignsで、ユーザーが15分以内に再適格になるように設定します。
Decisioning Studioエージェントは同じCampaignを1日に1回以上送信することはありませんが、テスト目的で同じCampaignsを1日に複数回送信できるようにしておく必要があります。
ステップ 4: ダイナミックプレースホルダーの追加
これらは、Decisioning Studioエージェントが最適化する決定のダイナミックプレースホルダーとして機能します。
例1：メールCampaign
Decisioning StudioエージェントがメールCampaignを最適化しているとします。次のように構成される場合があります：
エージェントがテンプレートの選択とコールトゥアクション（CTA）メッセージを最適化している場合、各テンプレートに対してAPIトリガーCampaignを作成し、1つのテンプレートのCTAセクションは次のようになります：
例2：プッシュCampaign
Decisioning StudioエージェントがプッシュCampaignのメッセージを最適化しているとします。次のように構成される場合があります：
結果として次のメッセージが表示されます：
例3：SMS Campaign
Decisioning StudioエージェントがSMS Campaignのフィールドを最適化しているとします。次のように構成される場合があります：
結果として次のメッセージが表示されます：
SFMC統合の設定
Decisioning StudioはSalesforce Marketing Cloudとのネイティブ統合をサポートしています。Decisioning Studioは、ダイナミック要素を入力するために必要なデータを含むAPIイベントをジャーニーにトリガーします。
SFMC統合を構成する詳細な手順については、Decisioning Studio GoドキュメントのSFMC手順を参照してください。
その他のCEP統合の設定
Decisioning Studioは任意のカスタマーエンゲージメントプラットフォームと統合できます。ただし、Decisioning Studioはコミュニケーションを直接トリガーできないため、チームによるカスタムエンジニアリング作業が必要になる場合があります。
このシナリオでは、エージェントは「レコメンデーションファイル」を配信します。このファイルには各顧客の行が含まれ、その顧客に対するすべてのパーソナライズされた決定を示す列があります。
例えば、次のレコメンデーションファイル：
次のようなメールCampaignを最適化するために使用される場合があります：
ベストプラクティス
オーケストレーションの準備にあたって、以下のベストプラクティスを念頭に置いてください：
- 狭い範囲から始めましょう。 まず1つのチャネルと1〜2つのテンプレートを使用します。何が効果的かを学んでから拡張できます。
- 徹底的にテストしましょう。 起動前に、少数のユーザーセットで統合をテストし、ダイナミックコンテンツが正しく入力されることを確認します。
- 設定を文書化しましょう。 Campaign ID、テンプレートID、APIキー、その他の識別子を記録しておきます。Decisioning Studioポータルでこれらを参照する必要があります。
- チームと連携しましょう。 オーケストレーションの設定には、マーケティング、エンジニアリング、データチームが関与する場合があります。プロセスにおける各自の役割を全員が理解していることを確認してください。
- フィードバックデータを計画しましょう。 オーケストレーションにはメッセージの送信と、エージェントの学習に役立つエンゲージメントおよびコンバージョンデータの収集が含まれます。詳細については、データの準備を参照してください。
次のステップ
オーケストレーションの設定後、エージェントの設計に進みます：