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. ダッシュボードで、設定＞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. 送信元表示名」をコピーし、「メール表示名」としてBrazeAI Decisioning Studio™ Goポータルに貼り付ける。
  4. 関連するメールアドレスをコピーして、BrazeAI Decisioning Studio™ GoポータルのFromメールアドレスに貼り付ける。

ステップ 3:BrazeのURLとアプリ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. キャンペーン名を入力します。例えば、「決定戦スタジオ囲碁メール」である。

決裁スタジオGoメール」というAPIキャンペーン。

  1. メッセージング・チャネルには、メールを選択する。

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

  1. Additional Optionsで、Allow users to become re-eligible to receive campaignチェックボックスを選択する。
  2. 再資格となるまでの時間は、「1」を入力し、ドロップダウンから「時間」を選択する。

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

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

ステップ 5: キャンペーンIDとメッセージ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を統合するには、アプリパッケージを設定し、データクエリーオートメーションを作成し、トリガー送信を処理するジャーニーを構築する。

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

  1. マーケティングクラウドのホームページにアクセスする。
  2. グローバルヘッダーでメニューを開封し、セットアップを選択する。
  3. サイドパネルのナビゲーションの「Platform Tools」にある「Apps」を開き、「Installed Packages」を選択する。
  4. アプリ・パッケージを作成するには「新規」を選択する。
  5. アプリパッケージに名前と説明をつける。

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

  1. Add Componentを選択する。
  2. Component Type（コンポーネント・タイプ）」で「API Integration（API統合）」を選択する。次に「Next」を選択する。
  3. Integration Type（統合タイプ）」で「Server-to-server（サーバー間）」を選択する。次に「Next」を選択する。 9.アプリパッケージにのみ、以下の推奨スコープを選択する： - チャネル > メール > 読み取り、書き込み、送信 - チャンネル > OTT > 読む - チャネル > プッシュ > リード - チャネル > SMS > 読む - チャネル > ソーシャル > 読む - チャンネル > ウェブ > 読む - 資産 > ドキュメントと画像写真 > 読み取り、書き込み - 資産 > 保存されたコンテンツ > 読み取り、書き込み - オートメーション > オートメーション > 読み取り、書き込み、実行 - オートメーション > ジャーニー > 読み取り、書き込み、実行、アクティベート／停止／一時停止／送信／スケジュール - コンタクト >オーディエンス > 読む - 連絡先 > リストとサブスクライバー > 読み取り、書き込み - Cross Cloud Platform > マーケットオーディエンス > ビュー - Cross Cloud Platform > マーケットオーディエンス > ビュー - Cross Cloud Platform > Marketing Cloud Connect > 読む - データ > データ拡張 > 読み取り、書き込み - データ > ファイルの場所 > 読み込み - データ > イベントトラッキング > 読み取り、書き込み - イベント通知 > コールバック > 読み取り - イベント通知 > サブスクリプション > 読む
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に移動し、オートメーションスタジオを選択する。

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

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

"スケジュール "を旅の出発点とする。

  1. スケジュールノードで、Configureを選択する。
  2. スケジュールには以下を設定する： - 開始日明日のカレンダー - 時間だ：12:00 AM - タイムゾーン：(GMT-05:00) 東部 (米国& カナダ)
  3. Repeatでは、Dailyを選択する。
  4. このスケジュールは終わらないように設定する。
  5. 完了を選択してスケジュールを保存する。

スケジュール例は2024年1月25日午前12時（東部標準時）、毎日繰り返される。

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

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

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

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

"OFE_Subscribers_query_Test5" と内部キーの例。

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

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

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

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

9.検索した外部キーに一致するデータ拡張子を選択する。BrazeAI Decisioning Studio™ Goポータルで相互参照するために、ターゲットデータの拡張子名も提供される。サブスクライバークエリーのData Extensionは、BASE_AUDIENCE_DATA のサフィックスで終わるべきである。

外部キーの例と一致するデータ拡張子名。

10.Overwriteを選択し、Nextを選択する。

エンゲージメントの問い合わせだ：

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

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

2.選択する。 3.Create New Query Activityを選択する。

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

"OFE_Engagement_query" と内部キーの例。

  1. [次へ] を選択します。
  2. BrazeAI Decisioning Studio™ Goポータルで、Engagement Query Resourcesの下にSystem data SQLクエリを見つける。
  3. クエリをコピーしてテキストボックスに貼り付け、「Next」を選択する。

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

  1. BrazeAI Decisioning Studio™ Goポータルで指定したエンゲージメントクエリーのターゲットData Extensionを探し、選択する。

9.Overwriteを選択し、Nextを選択する。

外部キーの例と一致するデータ拡張子名。

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

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

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

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

オートメーション"OFE_Experimenter_Test5_Automation" 、実行するSQLクエリ・アクティビティを選択したリストがある。

  1. 今すぐ実行」を選択する。

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

これで、オートメーションが正常に実行されていることを確認できる。オートメーションが期待通りに作動しない場合は、Brazeサポートに問い合わせること。

パート3：SFMCの旅を創造する

ステップ 1: 旅の設定

  1. Salesforce Marketing Cloudで、Journey Builder>Journey Builderに進む。
  2. Create New Journeyを選択する。
  3. ジャーニーのタイプで「Multi-Step Journey（マルチステップ・ジャーニー）」を選択し、「Create（作成）」を選択する。

条件分岐ノードと複数のメールノードに接続されたAPIイベントエントリソース。

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

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

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

エントリーソースとして "APIイベント "を選択した。

2.API Eventで、Create an eventを選択する。

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

3.Select Data Extensionを選択する。BrazeAI Decisioning Studio™ Goがレコメンデーションを書き込むデータエクステンションを探し、選択する。

  1. Summaryを選択して変更を保存する。
  2. Doneを選択してAPIイベントを保存する。

APIイベントの概要。

条件分岐を追加する：

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

編集」ボタンで条件分岐の詳細を決定する。

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

条件分岐のパス1にあるジャーニー・データのセクション。

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

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

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

各メールテンプレートIDに対して、条件分岐で2つのパスを設定する。

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

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

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

ステップ 3:旅を活性化する

Journeyの設定後、Journeyを有効化し、以下の詳細をBrazeAI Decisioning Studio™ Goチームと共有する：

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

完成した活性化への旅。

  1. その後、検証結果を確認し、Activateを選択する。

バリデーションルールのセクションに記載されている推奨事項。

  1. Activate Journey要約で、再度Activateを選択する。

旅のまとめ

すべて完了しました。BrazeAI Decisioning Studio™ Goでトリガーを開始できる。

Klaviyoとの統合を設定する

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

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

  1. Klaviyoで、設定>APIキーに行く。
  2. Create Private API Keyを選択する。
  3. APIキーの名前を入力する。例えば、”決定力のあるスタジオ・エクスペリメンター “だ。
  4. APIキーに対して以下の権限を選択する：
    • キャンペーン:アクセスを読む
    • データのプライバシーフルアクセス
    • イベントだ：フルアクセス
    • フローだ：フルアクセス
    • 画像、写真：アクセスを読む
    • リストを見てみよう：フルアクセス
    • 指標:フルアクセス
    • プロファイルだ：フルアクセス
    • セグメント:アクセスを読む
    • テンプレートだ：フルアクセス
    • Webhookだ：アクセスを読む

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

  1. [作成] を選択します。
  2. このAPIキーをコピーして、BrazeAI Decisioning Studio™ Goポータルにペーストする。

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

BrazeAI Decisioning Studio™ Goは、Klaviyoアカウントの既存のフローに関連付けられたテンプレートをインポートする。どのフローにも関連付けられていないテンプレートを使用するには、使用したいテンプレートを含むプレースホルダーフローを作成すればよい。流れは下書きとして残しておくことができる。

ステップ 1:流れを設定する

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

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

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

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

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

トリガーノードの後にメールノードが続くフロー。

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

  1. Save>Doneを選択する。
  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. Nameには、BrazeAI Decisioning Studio™ Goポータルのフロー名を入力する。次に、Create manuallyを選択する。

フロー例で「手動で作成」オプションを選択した。

  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. Sender name（送信者名）とSender email address（送信者メールアドレス）には、使用したい詳細を入力する。

メール1」の件名、送信者名、送信者メールアドレスの例。

  1. ［完了] を選択します。
  2. 最近メールしたプロファイルをスキップする]チェックボックスの選択を外し、[保存]を選択する。 9.メールノードで、モードを下書きから 本番に更新する。

Klaviyoフローエディターでは、トリガーノードがメールノードに接続されている。

すべて完了しました。BrazeAI Decisioning Studio™ Goでトリガーできるようになった。

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

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

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

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

  1. BrazeAI Decisioning Studio™ Goポータルで、使用するリソースセクションの下にある、最初のテンプレートのメールテンプレートIDを見つける。DimensionフィールドにメールテンプレートIDを入力し、Saveを選択する。
  2. Eメールノードをトリガースプリットの Yesブランチにドラッグ＆ドロップする。

トリガー分岐ノードを持つKlaviyoフローで、Yes分岐はメールノードにつながり、No分岐は別のトリガー分岐につながる。

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

  1. ベースとなるテンプレートを探し、選択する。BrazeAI Decisioning Studio™ Goポータルの使用するリソースセクションで、ベーステンプレート名からテンプレートを検索できる。
  2. テンプレートを使用＞保存を選択する。
  3. 件名には {{event.SubjectLine}} と入力する。
  4. Sender name（送信者名）とSender email address（送信者メールアドレス）には、使用したい詳細を入力する。

選択されたメールテンプレートと、件名、送信者名、送信者メールアドレスのフィールド。

  1. ［完了] を選択します。 9.最近メールしたプロファイルをスキップする]チェックボックスの選択を外し、[保存]を選択する。 10.メールノードで、モードを下書きから 本番に更新する。

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

  1. 別のトリガー分割ノードを、前のトリガー分割ノードのNoBranchにドラッグ＆ドロップする。
  2. Dimensionを EmailTemplateIDに設定し、設定するベーステンプレートのメールテンプレートIDを Dimensionの値に記入する。
  3. [保存] を選択します。

Klaviyoフローエディターの図。トリガーノードがトリガースプリットにつながっている。トリガースプリットには、メールノードにつながるYesブランチと、追加のメールノードにつながる別のトリガースプリットに接続するNoブランチがある。

  1. 新しいトリガースプリットのYesBranchにEmailノードをドラッグ＆ドロップする。
  2. 上記のメールテンプレート設定ステップを繰り返し、対応するテンプレートを選択する。
  3. 件名を {{event.SubjectLine}} に設定し、最近メールしたプロファイルをスキップするチェックボックスのチェックを外す。
  4. 実験者が使用しているベーステンプレートごとに、トリガー分割ノードとメールノードが1つずつできるまで、このプロセスを繰り返す。最後のトリガー・スプリットでは、”No “ブランチには何も入っていないはずだ。

複数のメールノードに分岐する複数のトリガー分岐ノードを持つKlaviyoフロー。

  1. 各Eメールノードで、モードを下書きから ライブに更新する。

ノードのステータスを「ライブ」に更新するオプション。

すべて完了しました。BrazeAI Decisioning Studio™ Goでトリガーできるようになった。

次のステップ

オーケストレーションの設定ができたところで、エージェントの設計に進む：
Github   GitHub でこのページを編集
New Stuff!