Skip to content

オーケストレーションを設定する

BrazeAI Decisioning Studio™ Goは、パーソナライズされたコミュニケーションをオーケストレーションするために、カスタマーエンゲージメントプラットフォーム(CEP)に接続する必要があります。この記事では、サポートされている各CEPの統合設定方法を説明します。

サポートされているCEP

Decisioning Studio Goは、以下のカスタマーエンゲージメントプラットフォームをサポートしています。

以下からCEPを選択して、統合設定を開始しましょう。

Braze統合を設定する

Decisioning Studio GoをBrazeと統合するには、APIキーを作成し、APIトリガーキャンペーンを設定し、必要な識別子をDecisioning Studio Goポータルに提供します。

ステップ 1: REST APIキーを作成する

  1. Brazeダッシュボードで、設定 > APIと識別子 > APIキーに移動します。
  2. APIキーを作成を選択します。
  3. APIキーの名前を入力します。例:「DecisioningStudioGoEmail」
  4. 以下のカテゴリに基づいて権限を選択します。
    • ユーザーデータ: users.trackusers.deleteusers.export.idsusers.export.segment を選択
    • メッセージ: messages.send を選択
    • キャンペーン:リストされているすべての権限を選択
    • キャンバス:リストされているすべての権限を選択
    • セグメント:リストされているすべての権限を選択
    • テンプレート:リストされているすべての権限を選択
  1. APIキーを作成を選択します。
  2. APIキーをコピーし、BrazeAI Decisioning Studio™ Goポータルに貼り付けます。

ステップ 2: メールの表示名を確認する

  1. Brazeダッシュボードで、設定 > メール設定に移動します。
  2. BrazeAI Decisioning Studio™ Goで使用する表示名を確認します。
  3. From Display Nameをコピーし、BrazeAI Decisioning Studio™ GoポータルにEmail Display Nameとして貼り付けます。
  4. 関連するメールアドレスをコピーし、BrazeAI Decisioning Studio™ Goポータルに送信元メールアドレスとして貼り付けます。このメールアドレスはローカル部分とドメインを組み合わせたものです。

ステップ 3: BrazeのURLとApp IDを見つける

BrazeのURLを見つけるには:

  1. Brazeダッシュボードに移動します。
  2. ブラウザウィンドウで、BrazeのURLはhttps://で始まりbraze.comで終わります。BrazeのURLの例:https://dashboard-01.braze.com

App ID(APIキー)を見つけるには:

  1. Brazeダッシュボードで、設定 > アプリ設定に移動します。
  2. トラッキングしたいアプリに移動します。
  3. APIキーをコピーし、BrazeAI Decisioning Studio™ Goポータルに貼り付けます。

ステップ 4: APIトリガーキャンペーンを作成する

  1. Brazeダッシュボードで、メッセージング > キャンペーンに移動します。
  2. キャンペーンを作成を選択します。
  3. キャンペーンタイプとして、APIキャンペーンを選択します。
  4. キャンペーン名を入力します。例:「Decisioning Studio Go Email」

「Decisioning Studio Go Email」という名前のAPIキャンペーン。

  1. メッセージングチャネルとして、メールを選択します。

APIキャンペーンのメッセージングチャネルを選択するオプション。

  1. 追加オプションで、ユーザーがキャンペーンの受信資格を再取得できるようにするチェックボックスを選択します。
  2. 再資格取得までの時間として、1を入力し、ドロップダウンから時間を選択します。

APIキャンペーンの再資格設定が選択された状態。

  1. キャンペーンを保存を選択します。

ステップ 5: キャンペーンIDとメッセージIDをコピーする

  1. APIキャンペーンで、キャンペーンIDをコピーします。次に、BrazeAI Decisioning Studio™ Goポータルに移動し、キャンペーンIDを貼り付けます。

コピーして貼り付けるメッセージバリエーションIDの例。

  1. メッセージバリエーションIDをコピーします。次に、BrazeAI Decisioning Studio™ Goポータルに移動し、メッセージバリエーションIDを貼り付けます。

ステップ 6: テストユーザーIDを確認する

統合をテストするには、ユーザーIDが必要です。

ワークスペースで識別子フィールドレベル暗号化を使用している場合、/users/trackエンドポイントで作成する新しいテストユーザーは、暗号化されたワークスペースのメール要件に従う必要があります。emailフィールドには、小文字に変換したメール値のBase64エンコードされたHMAC-SHA256ハッシュを送信し、email_encryptedには設定済みのPII暗号化キーで生成された暗号化メール値を送信してください。

  1. Brazeダッシュボードで、オーディエンス > ユーザーを検索に移動します。
  2. 外部ユーザーID、ユーザーエイリアス、メール、電話番号、またはプッシュトークンでユーザーを検索します。
  3. 設定で参照するためにユーザーIDをコピーします。

ユーザーIDでユーザーを検索した際のユーザープロファイルの例。

SFMC統合を設定する

Decisioning Studio GoをSalesforce Marketing Cloudと統合するには、アプリパッケージを設定し、データクエリオートメーションを作成し、トリガー送信を処理するJourneyを構築します。

パート1: SFMCアプリパッケージを設定する

  1. Marketing Cloudのホームページに移動します。
  2. グローバルヘッダーのメニューを開き、Setupを選択します。
  3. サイドパネルナビゲーションのPlatform ToolsにあるAppsに移動し、Installed Packagesを選択します。
  4. Newを選択してアプリパッケージを作成します。
  5. アプリパッケージに名前と説明を付けます。

「Experimenter 1 - Test 5」という名前のアプリパッケージ。

  1. Add Componentを選択します。
  2. Component Typeで、API Integrationを選択します。次に、Nextを選択します。
  3. Integration Typeで、Server-to-serverを選択します。次に、Nextを選択します。
  4. アプリパッケージに対してのみ、以下の推奨スコープを選択します。
    • Channels > Email > Read, Write, Send
    • Channels > OTT > Read
    • Channels > Push > Read
    • Channels > SMS > Read
    • Channels > Social > Read
    • Channels > Web > Read
    • Assets > Documents and Images > Read, Write
    • Assets > Saved Content > Read, Write
    • Automation > Automations > Read, Write, Execute
    • Automation > Journeys > Read, Write, Execute, Activate/Stop/Pause/Send/Schedule
    • Contacts > Audiences > Read
    • Contacts > List and Subscribers > Read, Write
    • Cross Cloud Platform > Market Audience > View
    • Cross Cloud Platform > Market Audience Member > View
    • Cross Cloud Platform > Marketing Cloud Connect > Read
    • Data > Data Extensions > Read, Write
    • Data > File Locations > Read
    • Data > Tracking Events > Read, Write
    • Event notifications > Callbacks > Read
    • Event notifications > Subscriptions > Read
推奨スコープの画像を表示

Salesforce Marketing Cloudアプリパッケージの推奨スコープ。

  1. Saveを選択します。
  2. 以下のフィールドをコピーし、BrazeAI Decisioning Studio™ Goポータルに貼り付けます:Client IdClient SecretAuthentication Base URIREST Base URISOAP Base URI

パート2: データクエリオートメーションを設定する

ステップ 1: 新しいオートメーションを作成する

  1. Salesforce Marketing Cloudのホームから、Journey Builderに移動し、Automation Studioを選択します。

Journey Builderナビゲーションにあるオートメーションスタジオのオプション。

  1. New Automationを選択します。
  2. Scheduleノードをドラッグ&ドロップしてStarting Sourceとします。

「Schedule」をJourneyの開始ソースとする。

  1. Scheduleノードで、Configureを選択します。
  2. スケジュールに以下を設定します。
    • Start Date:翌日の日付
    • Time:12:00 AM
    • Time Zone:(GMT-05:00) Eastern (US & Canada)
  3. Repeatで、Dailyを選択します。
  4. このスケジュールを終了しないように設定します。
  5. Doneを選択してスケジュールを保存します。

2024年1月25日午前0時(米国東部時間)に定義されたスケジュール例。毎日繰り返されます。

ステップ 2: SQLクエリを作成する

次に、2つのSQLクエリを作成します。サブスクライバークエリとエンゲージメントクエリです。これらのクエリにより、BrazeAI Decisioning Studio™ Goはオーディエンスを構成するデータの取得とエンゲージメントイベントの取り込みが可能になります。

サブスクライバークエリ:

  1. SQL Queryをキャンバスにドラッグ&ドロップします。
  2. Chooseを選択します。
  3. Create New Query Activityを選択します。
  4. クエリに名前と外部キーを付けます。BrazeAI Decisioning Studio™ Goポータルで提供されているサブスクライバークエリ用の推奨名と外部キーを使用することをお勧めします。

「OFE_Subscribers_query_Test5」と外部キーの例。

  1. Nextを選択します。
  2. BrazeAI Decisioning Studio™ Goポータルで、Subscriber Query Resourcesの下にあるシステムデータSQLクエリを確認します。
  3. クエリをテキストボックスにコピーして貼り付け、Nextを選択します。

SQL Queryセクションのクエリ例。

  1. BrazeAI Decisioning Studio™ GoポータルのResources to useセクションで、ターゲットデータエクステンションの外部キーを確認します。次に、検索バーに貼り付けて検索します。

検索バーに貼り付けられた外部キー

  1. 検索した外部キーに一致するデータエクステンションを選択します。ターゲットデータエクステンション名は、BrazeAI Decisioning Studio™ Goポータルでも参照用に提供されています。サブスクライバークエリのData Extensionは、BASE_AUDIENCE_DATAサフィックスで終わるはずです。

外部キーの例に一致するデータエクステンション名。

  1. Overwriteを選択し、次にNextを選択します。

エンゲージメントクエリ:

  1. SQL Queryをキャンバスにドラッグ&ドロップします。

「SQL Query」がJourneyのアクティビティとして追加された状態。

  1. Chooseを選択します。
  2. Create New Query Activityを選択します。
  3. クエリに名前と外部キーを付けます。BrazeAI Decisioning Studio™ Goポータルで提供されているエンゲージメントクエリ用の推奨名と外部キーを使用することをお勧めします。

「OFE_Engagement_query」と外部キーの例。

  1. Nextを選択します。
  2. BrazeAI Decisioning Studio™ Goポータルで、Engagement Query Resourcesの下にあるシステムデータSQLクエリを確認します。
  3. クエリをテキストボックスにコピーして貼り付け、Nextを選択します。

SQL Queryセクションのクエリ例。

  1. BrazeAI Decisioning Studio™ Goポータルで指定されたエンゲージメントクエリのターゲットデータエクステンションを確認し、選択します。
  1. Overwriteを選択し、次にNextを選択します。

外部キーの例に一致するデータエクステンション名。

ステップ 3: オートメーションを実行する

  1. オートメーションに名前を付け、Saveを選択します。

オートメーションの例「OFE_Experimenter_Test5_Automation」。

  1. 次に、Run Onceを選択して、すべてが期待通りに動作していることを確認します。
  2. 両方のクエリを選択し、Runを選択します。

実行するSQLクエリアクティビティの選択リストを持つ「OFE_Experimenter_Test5_Automation」オートメーション。

  1. Run Nowを選択します。

選択されたSQLクエリアクティビティ。

これで、オートメーションが正常に動作しているか確認できます。オートメーションが期待通りに動作しない場合は、Brazeサポートに連絡して追加の支援を受けてください。

パート3: SFMC Journeyを作成する

ステップ 1: Journeyを設定する

  1. Salesforce Marketing Cloudで、Journey Builder > Journey Builderに移動します。
  2. Create New Journeyを選択します。
  3. JourneyタイプとしてMulti-Step Journeyを選択し、Createを選択します。

API Eventエントリソースが条件分岐ノードと複数のメールノードに接続されている。

ステップ 2: Journeyを構築する

エントリソースを作成する:

  1. エントリソースとして、API EventをJourney Builderにドラッグします。

「API Event」がエントリソースとして選択された状態。

  1. API Eventで、Create an eventを選択します。

API Eventの「create an event」オプション。

  1. Select Data Extensionを選択します。BrazeAI Decisioning Studio™ Goがレコメンデーションを書き込むデータエクステンションを確認し、選択します。
  2. Summaryを選択して変更を保存します。
  3. Doneを選択してAPIイベントを保存します。

APIイベントのサマリー。

条件分岐を追加する:

  1. API Entry Eventの後に条件分岐をドラッグ&ドロップします。
  2. 条件分岐の詳細で、最初のパスのEditを選択します。

「Edit」ボタンがある条件分岐の詳細。

  1. レコメンデーションデータエクステンションから渡されるテンプレートIDを使用するように条件分岐を更新します。Journey Dataの下にある適切なフィールドを確認します。

条件分岐のパス1にあるJourney Dataセクション。

  1. エントリイベントを選択し、目的のテンプレートIDフィールドを確認して、ワークスペースにドラッグします。

含めるメールテンプレートID。

  1. 最初のメールテンプレートのテンプレートIDを入力し、Doneを選択します。
  2. Summaryを選択してこのパスを保存します。
  3. 各メールテンプレートにパスを追加し、上記のステップ4〜6を繰り返してフィルター条件を設定します。テンプレートIDが各テンプレートのID値と一致するようにしてください。
  4. Doneを選択して条件分岐ノードを保存します。

各メールテンプレートIDに対応する条件分岐の2つのパス。

各条件分岐にメールを追加する:

  1. 条件分岐の各パスにEmailノードをドラッグします。
  2. Emailを選択し、各パスに適用すべき適切なテンプレートを選択します(つまり、ID値を持つテンプレートが条件分岐のロジックと一致する必要があります)。

Journeyに追加されたメールノード。

ステップ 3: Journeyを有効化する

Journeyを設定したら、有効化して以下の詳細をBrazeAI Decisioning Studio™ Goチームと共有します。

  • Journey ID
  • Journey名
  • APIイベント定義キー
  • レコメンデーションデータエクステンション外部キー
  1. BrazeAI Decisioning Studio™ Goポータルで、Journey名をコピーします。
  2. 次に、Salesforce Marketing Cloud Journey Builderで、Journey名を検索バーに貼り付けます。
  3. Journey名を選択します。なお、Journeyは現在下書きステータスです。
  4. Validateを選択します。

有効化する完成したJourney。

  1. 検証結果を確認し、Activateを選択します。

Validation Rulesセクションに記載されたレコメンデーション。

  1. Activate Journeyのサマリーで、もう一度Activateを選択します。

Journeyのサマリー。

これで設定は完了です。BrazeAI Decisioning Studio™ Goを通じて送信をトリガーできるようになりました。

次のステップ

オーケストレーションの設定が完了したら、次にエージェントの設計に進みましょう。

New Stuff!