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.track, users.delete, users.export.ids, users.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。

アプリ ID（API キー）を見つけるには：

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

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

  1. Brazeのダッシュボードで、メッセージング＞キャンペーンに移動する。
  2. キャンペーンを作成するを選択する。
  3. キャンペーンの種類として、APIキャンペーンを選択せよ。
  4. キャンペーン名を入力します。例として「Decisioning Studio Go メール」がある。

「Decisioning Studio Go メール」というAPIキャンペーン。

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

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

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

選択したAPIキャンペーンの再参加資格。

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

ステップ 5: キャンペーンとメッセージのIDをコピーしろ

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

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

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

ステップ 6: テストユーザー IDを探す

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

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

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

SFMC統合の設定

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

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

  1. マーケティングクラウドのホームページに移動する。
  2. グローバルヘッダーのメニューを開封し、設定を選択する。
  3. サイドパネルのナビゲーションで「プラットフォームツール」内の「アプリ」に移動し、「インストール済みパッケージ」を選択する。
  4. 新規を選択してアプリパッケージを作成する。
  5. アプリパッケージに名前と説明を付ける。

「実験者1 - テスト5」という名前のアプリパッケージ。

  1. コンポーネントの追加を選択する。
  2. コンポーネントタイプには、API統合を選択する。次に、「次へ」を選択する。
  3. 統合タイプでは、サーバー間を選択する。次に、「次へ」を選択する。 9.アプリパッケージに対してのみ、以下の推奨スコープを選択せよ： - チャネル > メール > 読み取り、書き込み、送信 - チャネル > OTT > 読む - チャネル > プッシュ > 読み取り - チャネル > SMS > 読む - チャネル > ソーシャル > 読む - チャネル > Web > 読む - アセット > ドキュメントと写真 > 読み取り、書き込み - アセット > 保存済みコンテンツ > 読み取り、書き込み - オートメーション > オートメーション > 読み取り、書き込み、実行 - オートメーション > ジャーニー > 読み取り、書き込み、実行、起動/停止/一時停止/送信/スケジュールされた送信 - 連絡先 > オーディエンス > 読む - 連絡先 > リストとサブスクライバー > 読み取り、書き込み - クロスクラウドプラットフォーム > 市場オーディエンス > 表示 - クロスクラウドプラットフォーム > 市場オーディエンスメンバー > 表示 - クロスクラウドプラットフォーム > マーケティングクラウドコネクト > 読み取り - データ > データ拡張機能 > 読み取り、書き込み - データ > ファイルの場所 > 読み取り - データ > トラッキングイベント > 読み取り、書き込み - イベント通知 > コールバック > 読み取り - イベント通知 > サブスクリプション > 読む
Show image of recommended scopes

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

10.[保存] を選択します。 11.以下のフィールドをBrazeAI Decisioning Studio™ Goポータルにコピーして貼り付けろ：クライアントID、クライアントシークレット、認証ベースURI、RESTベースURI、SOAPベースURI。

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

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

  1. Salesforce Marketing Cloud のホーム画面から、Journey Builder に移動し、オートメーション Studio を選択する。

ジャーニービルダーのナビゲーションにあるオートメーションスタジオのオプション。

2.新しいオートメーションを選択する。 3.スケジュールノードをドラッグ＆ドロップして開始ソースとする。

「スケジュール」をジャーニーの開始元とする。

  1. スケジュールノードで、設定を選択する。
  2. スケジュールには以下を設定する：
    • 開始日：明日の暦日
    • 時間：午前0時
    • タイムゾーン：(GMT-05:00) 東部 (米国 &カナダ)
  3. 繰り返し設定では、毎日を選択する。
  4. このスケジュールを永遠に終わらないように設定しろ。
  5. スケジュールを保存するには「完了」を選択せよ。

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

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

次に、2つのSQLクエリを作成する：サブスクライバークエリとエンゲージメントクエリだ。これらのクエリにより、BrazeAI Decisioning Studio™ Goはオーディエンスを埋めるデータとエンゲージメントイベントを取得できる。

サブスクライバーの問い合わせ：

  1. SQLクエリをキャンバスにドラッグ＆ドロップする。
  2. 選択せよ。
  3. 新規クエリアクティビティの作成を選択する。
  4. クエリに名前と外部キーを付ける。BrazeAI Decisioning Studio™ Go ポータルで提供されているサブスクライバー クエリ用の推奨名と外部キーを使用することを推奨する。

例"OFE_Subscribers_query_Test5"と外部キー。

  1. [次へ] を選択します。
  2. BrazeAI Decisioning Studio™ Go ポータルで、サブスクライバー クエリ リソースの下にあるシステム データ SQL クエリを探せ。
  3. クエリをテキストボックスにコピーして貼り付け、次に進むを選択する。

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

  1. BrazeAI Decisioning Studio™ Go ポータル内の「使用するリソース」セクションで、対象データ拡張の外部キーを探せ。それから、検索バーに貼り付けて検索するんだ。

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

9.検索した外部キーに一致するデータ拡張を選択せよ。ターゲットデータ拡張子の名前は、参照用にBrazeAI Decisioning Studio™ Goポータルにも記載されている。サブスクライバークエリのデータ拡張子は、接尾BASE_AUDIENCE_DATA辞で終わるべきだ。

例示された外部キーに一致するデータ拡張子の名前。

10.上書きを選択し、次に進む。

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

  1. SQLクエリをキャンバスにドラッグ＆ドロップする。

「SQLクエリ」がジャーニーのアクティビティとして追加された。

2.選択せよ。 3.新規クエリアクティビティの作成を選択する。

  1. クエリに名前と外部キーを付ける。BrazeAI Decisioning Studio™ Go ポータルで提供されているエンゲージメント クエリには、推奨される名前と外部キーを使用することを推奨する。

例"OFE_Engagement_query"と外部キー。

  1. [次へ] を選択します。
  2. BrazeAI Decisioning Studio™ Go ポータルで、エンゲージメント クエリ リソースの下にあるシステム データ SQL クエリを探せ。
  3. クエリをテキストボックスにコピーして貼り付け、次に進むを選択する。

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

  1. BrazeAI Decisioning Studio™ Go ポータルで指定されたエンゲージメントクエリの対象となるデータエクステンションを探し、選択する。

9.上書きを選択し、次に進む。

例示された外部キーに一致するデータ拡張子の名前。

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

  1. オートメーションに名前を付け、保存を選択する。

オートメーションの例 "OFE_Experimenter_Test5_Automation".

2.次に、一度だけ実行を選択して、すべてが期待通りに動作していることを確認する。 3.両方のクエリを選択し、実行を選択する。

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

  1. 今すぐ実行を選択せよ。

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

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

パート3：SFMCの旅を始めよう

ステップ 1: 旅の準備を整える

  1. セールスフォース・マーケティングクラウドで、ジャーニービルダー＞ジャーニービルダーに移動する。
  2. 新規ジャーニーを作成を選択せよ。
  3. 旅程タイプとして「複数ステップの旅程」を選択し、次に「作成」を選択する。

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

ステップ 2:旅を築け

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

  1. エントリソースとして、APIイベントをジャーニービルダーにドラッグする。

「APIイベント」がエントリ元として選択された。

2.APIイベントで、イベントを作成するを選択する。

APIイベントの「イベントを作成する」オプション。

3.データ拡張を選択せよ。BrazeAI Decisioning Studio™ Goが推奨事項を書き込むデータ拡張機能を探し、選択する。

  1. 変更を保存するには「概要」を選択せよ。
  2. 「完了」を選択してAPIイベントを保存する。

APIイベントの概要。

条件分岐を追加する：

  1. APIエントリイベントの後に、条件分岐をドラッグ＆ドロップする。
  2. 条件分岐の詳細で、最初のパスに対して編集を選択する。

「編集」ボタンで条件分岐の詳細を確認する。

3.レコメンデーションデータ拡張機能から渡されたテンプレートIDを使用するように、条件分岐を更新する。旅程データの下にある適切なフィールドを探せ。

条件分岐のパス1にある「旅程データ」セクション。

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

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

  1. 最初のメールテンプレートのテンプレートIDを入力し、完了を選択する。
  2. このパスを保存するには「概要」を選択せよ。
  3. 各メールテンプレートにパスを追加し、その後、上記のステップ4～6を繰り返してフィルター条件を設定する。テンプレートIDが各テンプレートのID値と一致するようにするのだ。
  4. 条件分岐ノードを保存するには「完了」を選択する。

各メールテンプレートIDごとに、条件分岐で2つのパスがある。

各条件分岐ごとにメールを追加する。

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

ジャーニーに追加されたメールノード。

ステップ 3:旅を始めろ

ジャーニーを設定したら、それを有効化し、以下の詳細をBrazeAI Decisioning Studio™ Goチームと共有する：

  • 旅のID
  • 旅の名前
  • APIイベント定義キー
  • 推薦データ拡張外部キー
  1. BrazeAI Decisioning Studio™ Go ポータルで、ジャーニー名をコピーする。
  2. 次に、Salesforce Marketing Cloud Journey Builder で、ジャーニー名を検索バーに貼り付ける。
  3. 旅程名を選択せよ。なお、この旅は現在下書きステータスにある。
  4. 「検証」を選択せよ。

完了した旅を起動する。

  1. 次に、検証結果を確認し、「有効化」を選択する。

検証ルールセクションに記載されている推奨事項。

  1. 「アクティベート・ジャーニー」のサマリーで、もう一度「アクティベート」を選択する。

旅のまとめ。

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

Klaviyoの連携設定

Decisioning Studio GoをKlaviyoと連携させるには、API キーを設定し、プレースホルダーテンプレートフローを作成し、トリガー送信を処理するフローを構築する。

パート 1:Klaviyo API キーを設定する

  1. Klaviyoで、設定＞API キーへ移動する。
  2. プライベートAPI キーの作成を選択する。
  3. APIキーの名前を入力する。例として「Decisioning Studioの実験者たち」がある。
  4. API キーに対して以下の権限を選択する：
    • キャンペーン:読み取りアクセス
    • データプライバシー：フルアクセス
    • イベント：フルアクセス
    • フロー：フルアクセス
    • 写真：読み取りアクセス
    • リスト：フルアクセス
    • 指標:フルアクセス
    • プロファイル：フルアクセス
    • セグメント:読み取りアクセス
    • テンプレート：フルアクセス
    • Webhooks:読み取りアクセス

選択された権限を持つKlaviyo API キー。

  1. [作成] を選択します。
  2. このAPI キーをコピーし、BrazeAI Decisioning Studio™ Goポータルで指定された場所に貼り付けろ。

パート 2:Klaviyoでプレースホルダーテンプレートを作成する

BrazeAI Decisioning Studio™ Goは、Klaviyoアカウント内の既存フローに関連付けられたテンプレートをインポートする。フローに関連付けられていないテンプレートを使用するには、使用したいテンプレートを含むプレースホルダーフローを作成できる。フローは下書きのままにしておける。公開する必要はない。

ステップ 1:フローを設定する

  1. Klaviyoで、フローを選択する。
  2. フローを作成 > 一から作成 を選択する。
  3. プレースホルダーのフローに分かりやすい名前を付け、次に「フローを作成」を選択する。

「OFE プレースホルダー フロー」という名前のフロー。

  1. 任意のトリガーを選択し、フローを保存する。
  2. 確認を選択し、保存する。

ステップ 2:プレースホルダーのテンプレートを作成する

  1. トリガーの後にメールノードをドラッグ＆ドロップする。

トリガーノードに続いてメールノードが続くフロー。

2.メールノードで、テンプレートを選択する。 3.次に、使用するテンプレートを選び、「テンプレートを使用」を選択する。

  1. 保存＞完了を選択する。
  2. （任意）BrazeAI Decisioning Studio™ Goで使用するテンプレートを追加するには、別のメールノードを追加し、ステップ2～4を繰り返す。
  3. すべてのメールを下書きモードのままにしておき、フローを終了する。

BrazeAI Decisioning Studio™ Go ポータルでは、テンプレートはプレースホルダーフローの下で選択可能であるべきだ。

Decisioning Studio Go ポータルにおけるプレースホルダー用 Klaviyo テンプレートの例。

パート3：Klaviyoでフローを作成する

Klaviyoでフローを作成する前に、参照するためにBrazeAI Decisioning Studio™ Goポータルから以下の詳細情報を用意する必要がある：

  • フロー名
  • トリガーイベント名

ステップ 1: フローを設定する

  1. Klaviyoで、フロー＞フローを作成を選択する。
  2. 「自分で作る」を選択せよ。
  3. 名前には、BrazeAI Decisioning Studio™ Go ポータルから取得したフロー名を入力する。次に、手動で作成を選択する。

例として示したフローに対して「手動で作成」オプションが選択された。

  1. トリガーを選べ。
  2. BrazeAI Decisioning Studio™ Go ポータルから、メトリック名とトリガーイベント名を対応付けよ。

トリガーイベント名に一致するメトリック"OFE_TEST_CASE_API_EVENT_TRIGGER".

  1. [保存] を選択します。

ステップ 2:フローにメールを追加する（単一テンプレート）

  1. トリガーノードの後にメールノードをドラッグ＆ドロップする。
  2. メールの詳細で、テンプレートを選択する。

「メール詳細」セクションの「テンプレートを選択」オプション。

3.ベースとなるテンプレートを探して選択する。BrazeAI Decisioning Studio™ Go ポータルの「使用するリソース」セクションで、テンプレート名からテンプレートを検索できる。

Klaviyoのベーステンプレートの例だ。

  1. テンプレートを使用を選択し、保存する。
  2. 件名欄には、と入力する{{event.SubjectLine}}。
  3. 差出人名と差出人メールアドレスには、使用したい詳細を入力する。

「メール1」の件名、差出人名、差出人メールアドレスの例。

  1. ［完了] を選択します。
  2. 「最近メールで送信したプロファイルをスキップする」チェックボックスの選択を解除し、次に「保存」を選択する。 9.メールノードで、モードを下書きからライブに更新する。

Klaviyoのフローエディターに、トリガーノードがメールノードに接続されている様子を示している。

すべて完了しました。BrazeAI Decisioning Studio™ Goを通じてアクティベーションをトリガーできるようになった。

ステップ 3:フローにトリガースプリットを追加する（複数のテンプレート）

  1. トリガーノードの後にトリガースプリットノードをドラッグ＆ドロップせよ。
  2. トリガースプリットノードを選択し、ディメンションをEmailTemplateIDに設定する。

Klaviyoのフロー図で、トリガーノードがディメンションEmailTemplateIDで設定されたトリガースプリットにデータをフィードしている様子を示している。

メールテンプレートを追加する：

  1. BrazeAI Decisioning Studio™ Go ポータルで、使用するリソースセクションの下にある最初のテンプレートのメールテンプレートIDを探す。ディメンションフィールドにメールテンプレートIDを入力し、保存を選択する。
  2. メールノードをトリガー分岐の「はい」側にドラッグ＆ドロップする。

トリガースプリットノードを持つKlaviyoフロー。その「はい」Branchはメールノードへつながり、「いいえ」Branchは別のトリガースプリットへ接続している。

3.メールの詳細で、テンプレートを選択する。

  1. ベースとなるテンプレートを探して選択する。BrazeAI Decisioning Studio™ Go ポータルの「使用するリソース」セクションで、ベーステンプレートの名前からテンプレートを検索できる。
  2. テンプレートを使用を選択し、保存する。
  3. 件名欄には、と入力する{{event.SubjectLine}}。
  4. 差出人名と差出人メールアドレスには、使用したい詳細を入力する。

選択されたメールテンプレートと、件名、差出人名、差出人メールアドレス用のフィールド。

  1. ［完了] を選択します。 9.「最近メールで送信したプロファイルをスキップする」チェックボックスの選択を解除し、次に「保存」を選択する。 10.メールノードで、モードを下書きからライブに更新する。

追加するテンプレートごとに、新しいトリガースプリットを追加する。

  1. 前のトリガースプリットノードの「No」Branchに、別のトリガースプリットノードをドラッグ＆ドロップする。
  2. ディメンションをEmailTemplateIDに設定し、ディメンション値に設定する基本テンプレートのメールテンプレートIDを入力する。
  3. [保存] を選択します。

Klaviyoフローエディタの図。トリガーノードがトリガースプリットへとつながっている様子を示している。トリガースプリットには、メールノードにつながる「はい」Branchと、別のトリガースプリットにつながる「いいえ」Branchがある。この「いいえ」Branchは追加のメールノードへと続く。

  1. 新しいトリガースプリットの「はい」Branchに、メールノードをドラッグ＆ドロップする。
  2. 上記のメールテンプレート設定ステップを繰り返して、対応するテンプレートを選択する。
  3. 件名を設定し{{event.SubjectLine}}、最近メールしたプロファイルをスキップするチェックボックスのチェックを外す。
  4. 実験者が使用する各基本テンプレートに対して、トリガースプリットノードとメールノードがそれぞれ1つずつできるまで、この手順を繰り返す。最後のトリガースプリットでは、「No」Branchに何も含まれてはいけない。

複数のトリガースプリットノードを持つKlaviyoフローで、それらが複数のメールノードに分岐する。

  1. 各メールノードにおいて、モードを下書きからライブに更新せよ。

ノードのステータスを「稼働中」に更新するオプション。

すべて完了しました。BrazeAI Decisioning Studio™ Goを通じてアクティベーションをトリガーできるようになった。

次のステップ

オーケストレーションの設定が完了したから、次にエージェントの設計に進む：
Github   GitHub でこのページを編集
New Stuff!