Salesforce Data Cloud セットアップガイド:fins-version: 1.9

Data Cloud の [設定] 歯車アイコンで ​[CDP 設定]​ を選択します。

[CONFIGURATION]​ の下の左ナビゲーションから ​[取り込み API]​ を選択します。

[新規]​ をクリックし、API ソースの名前 (「​FINS_B​anking-Data-Connector」など) を入力して、​[保存]​ をクリックします。

新しいコネクタの詳細ページで、​.yaml​ ファイル拡張子を付けた OpenAPI (OAS) 形式でスキーマファイルをアップロードする必要があります。スキーマファイルは、API を介して転送されるデータの構造を記述します。
注意:​ 取り込み API スキーマには一定の要件があります。スキーマのアップロード中に問題が発生した場合は、以下のスキーマ要件を確認してください。

[スキーマをアップロード]​ をクリックし、使用するファイルの場所に移動します。ファイルを選択し、[開く] をクリックします。 CDP を使用したカスタマーエクスペリエンスの最適化​のユースケースでは、スキーマファイル ​mule-cdp-connector-schema.yaml​ は、 FINS Salesforce CDP System API (FINS Salesforce Data Cloud システム API)​ 実装テンプレートの ​src/test/resources/cdp-schema​ で使用できます。

検出されたすべてのオブジェクトとその属性をスキーマでプレビューします。

[保存]​ をクリックします。

[設定] アプリケーションから、​[アプリケーション]->[アプリケーションマネージャー]​ ページに移動します。

右上で ​[新規接続アプリケーション]​ ボタンをクリックします。

接続アプリケーション名 (「FINS Salesforce CDP System API」 (FINS Salesforce Data Cloud システム API) など) を入力します。

新しい連絡先メールアドレスを入力します。

[OAuth 設定の有効化]​ オプションを選択し、​[コールバック URL]​ として「http://localhost」と入力します。

[選択した OAuth 範囲] セクションで、​[利用可能な OAuth 範囲]​ リストから次の範囲を追加します。

[保存]​、​[完了]​ の順にクリックして、接続アプリケーションを作成します。

Data Cloud で [データストリーム] に移動して、​[新規]​ をクリックします。

[Salesforce CRM]​ データソースを選択し、​[次へ]​ をクリックします。

データストリームを作成するには、Salesforce 組織を選択します (Data Cloud に接続されている Salesforce 組織が 1 つしかない場合は、それがデフォルトで選択されます)。

[すべてのオブジェクト]​ ボタンをクリックし、同期する対象オブジェクト (​取引先​など) を選択して、​[次へ]​ をクリックします。

[カテゴリ]​ では、​[プロファイル]​ オプションを選択します。

データストリームに含める項目を確認します。デフォルトでは、すべての項目が事前に選択され、オブジェクトで使用可能な項目の合計数が括弧内に示されます。

[次へ]​ をクリックして、リリースの詳細を入力します。

[リリース]​ をクリックして、Salesforce CRM データストリームを作成します。

[データストリーム] リストビューでデータストリームをクリックすると、詳細ページが表示されます。

右上のアクションリストから ​[新規数式項目]​ アクションを選択します。アクションを見つけるには、[その他] 下矢印をクリックすることが必要になる場合があります。

次の値を入力します。

[テスト]​ ボタンを使用して、空の値と空以外の値の両方で数式出力を検証します。

[保存]​ をクリックして新しい数式項目を保存します。

Data Cloud に取り込むオブジェクトと項目が含まれる Salesforce 組織にログインします。

[設定] ページから、[クイック検索] ボックスに「権限」と入力し、​[権限セット]​ を選択します。

[Customer Data Platform Salesforce Connector Integration (Customer Data Platform Salesforce Connector インテグレーション)]​ 権限セットを選択します。
注意:​ この権限セットは、CRM 組織を Data Cloud に接続した後でのみ使用可能になります。

アプリケーションから [オブジェクト設定] を選択します。

Data Cloud に取り込むオブジェクト (​取引先​など) を選択します。

オブジェクト権限を変更するには、[編集] をクリックします。

オブジェクトの [参照] および [すべて表示] 権限と、各項目の [参照アクセス権] を有効にします。上記の表を参考にしてください。

[保存] をクリックします。

Data Cloud で [データストリーム] を選択して、​[新規]​ をクリックします。

[取り込み API]​ を選択し、​[次へ]​ をクリックします。

以前に設定したコネクタをドロップダウンから選択します。

上記の表のとおりに、スキーマで見つかったすべてのオブジェクトを選択し、​[次へ]​ をクリックします。

[新規データストリーム] ダイアログで、​[設定するオブジェクト]​ の下に表示されているオブジェクトを選択し、上記の表の詳細を使用して各オブジェクトを設定します。

[保存]​ をクリックします。

ダイアログが閉じたら、​[次へ]​ をクリックします。

最後の概要画面で、Data Cloud で作成されたデータストリームのリストを確認し、​[リリース]​ をクリックします。

[データストリーム] リストビューでデータストリームをクリックすると、詳細ページが表示されます。

右上のアクションリストから ​[新規数式項目]​ アクションを選択します。アクションを見つけるには、[その他] 下矢印をクリックすることが必要になる場合があります。

次の値を入力します。

[テスト]​ ボタンを使用して、空の値と空以外の値の両方で数式出力を検証します。

[保存]​ をクリックして新しい数式項目を保存します。

[データストリーム] ビューから対象のデータストリームをクリックします。

データストリームの詳細ページで、​[データマッピングを開始]​ をクリックします。

データをマッピングするための ​[ビジュアルビュー]​ が選択されていることを確認します。

[オブジェクトの選択]​ をクリックし、​[カスタムデータモデル]​ タブを選択します。

データストリームに必要な DMO が​すでに存在する​場合は、次の手順を実行します。

必要な DMO が​存在しない​場合は、次の手順を実行します。

[保存して閉じる]​ をクリックして、ストリームの詳細ページに戻ります。

[データマッピング] セクションの下部にある ​[マッピングの確認]​ リンクをクリックします。

右側の [データモデルエンティティ] グループの横にある鉛筆アイコンボタンをクリックします。

[標準データモデル]​ タブで、プラス記号ボタンをクリックして、(上記の表のとおりに) マッピングする必要があるオブジェクトを選択します。

[完了]​ をクリックして、オブジェクトの選択を保存します。

以下の​「標準オブジェクトマッピング」​セクションに進みます。

[データストリーム] ビューから対象のデータストリームをクリックします。

データストリームの詳細ページで、​[データマッピングを開始]​ をクリックします。

データをマッピングするための ​[ビジュアルビュー]​ が選択されていることを確認します。

[オブジェクトの選択]​ をクリックし、プラス記号ボタンをクリックして、(上記の表のとおりに) マッピングする必要がある`標準データモデルオブジェクトを選択します。

[完了]​ をクリックして、オブジェクトの選択を保存し、以下の​「標準オブジェクトマッピング」​セクションに進みます。

[データストリーム] ビューから対象のデータストリームをクリックします。

[データマッピング] セクションの下部にある ​[マッピングの確認]​ リンクをクリックします。

[データストリーム] マッピングキャンバスでは、DSO と対象 DMO の両方のすべての項目を参照できます。

以下のマッピング表​のとおりに、DSO のすべての項目を対象 DMO にマッピングします。項目を別の項目にマッピングするには、まず右側の対象 DMO の ​[マッピングなし]​ セクションを展開します。左側の DSO の項目をクリックし、対象項目をクリックして右側の DMO に接続します。たとえば、左側の DSO の ​[PartyType]​ 項目をクリックし、右側の ​[Party Identification (関係者 ID)]​ DMO の ​[Party Identification Type (関係者 ID 種別)]​ 項目をクリックします。DMO のマッピングが完了したら、​[マッピングなし]​ セクションを折りたたんで、スペースを節約します。

すべての DMO のマッピングが完了したら、​[保存]​ ボタンをクリックして、変更を保存します。プライマリキーに関連するエラーが発生した場合、マッピングをダブルクリックします。当面、「ID 解決」の警告は無視します。

マッピングした DMO ごとに「リンク」アイコンをクリックして DMO の ​[オブジェクトリレーション]​ ダイアログを表示し、以下の​「DMO 間のデータリレーション」​の表のとおりにリレーションが表示されていることを確認します。表のとおりに表示されていない場合は、​[新規]​ ボタンをクリックして、必要なリレーションを追加します。

[保存]​ および ​[閉じる]​ をクリックして、マッピングとリレーションの変更を記録します。

上部のナビゲーションメニューから ​[有効化対象]​ を選択します。

[新規]​ ボタンをクリックして、新しいエントリを作成します。

aws | S3​ 外部プラットフォームを選択し、​[次へ]​ をクリックします。

わかりやすい一意の名前 (「Data Cloud Segmentation Results Bucket」 (Data Cloud セグメンテーション結果バケット) など) を入力し、​[次へ]​ をクリックします。

システム管理者から提供された、有効化対象の S3 バケットと親フォルダーを指定します。

バケットの S3 アクセスキーとシークレットキーを入力します。提供された S3 ログイン情報は、s3:PutObject、s3:GetObject、s3:ListBucket、s3:DeleteObject、s3:GetBucketLocation の権限を持っている必要があります。
注意:​ S3 アクセスキーまたはシークレットキーを削除するには、まず有効化対象を削除します。

エクスポートファイルの形式 (JSON など) を選択します。

[保存]​ をクリックして、有効化対象を作成します。

AWS にログインして S3 サービスを選択します。

有効化対象で設定したバケットに移動します。

/Salesforce_c360_Segments​ に移動して、生成されたセグメントを参照します。

上部のナビゲーションメニューから ​[有効化対象]​ を選択します。

[新規]​ ボタンをクリックして、新しいエントリを作成します。

対象として ​[Marketing Cloud]​ を選択し、​[次へ]​ をクリックします。

わかりやすい一意の名前 (「Data Cloud Segmentation Results MC」 (Data Cloud セグメンテーション結果 MC) など) を入力します。
IMPORTANT:​ Marketing Cloud 有効化対象名は、128 文字を超えたり、アンダースコアで始めたり、すべて数字にしたりすることはできず、次の文字を含めることはできません: @ % ^ = < ' * + # $ / \ ! ? ( ) { } [ ] , . (space)

[次へ]​ をクリックします。

公開セグメントを受信するビジネスユニット (BU) を追加または削除するには、2 つの列間の矢印をクリックします。有効化対象に複数の BU がある場合、有効化によって取引先責任者が BU で絞り込まれます。セグメントは、Marketing Cloud へのデータエクステンション (DE) ではなく、共有データエクステンション (SDE) として有効化されます。有効化対象に複数のビジネスユニットが設定されている場合は、有効化対象設定を変更して 1 つのビジネスユニットのみを含めます。

変更を保存します。

上部のナビゲーションメニューから ​[有効化対象]​ を選択します。

[新規]​ ボタンをクリックして、新しいエントリを作成します。

セグメント (​[Cross-selling money market account (クロスセル金融市場口座)]​ または ​[Upselling mortgage account (アップセル住宅ローン口座)]​ など) を選択します。

以前作成した有効化対象のいずれか (AWS S3 または Marketing Cloud) を選択します。

[有効化メンバーシップ] ドロップダウンから ​[取引先]​ を選択します。​[次へ]​ をクリックします。

連絡先を選択します。
注意:​ S3 有効化の場合は、連絡先の選択は任意です。連絡先がマッピングされている場合、既存のパスを選択するか、[編集] をクリックします。

追加属性を有効化するには、​[属性を追加]​ をクリックします。

属性 ​[取引先 ID]​ と ​[取引先名]​ をキャンバスにドラッグします。​[保存]​ をクリックします。

[統合個人 <ruleset>]​ で、​[グローバル関係者]​ 項目を選択し、関連するパスを ​[取引先]​ から選択します。​[次へ]​ をクリックします。

有効化の名前と説明を入力します。
IMPORTANT:​ 名前項目に次の文字を含めることはできません: + ! @ # $ % ^ * ( ) = { } [ ] \ . < > / " : ? | , _ &

[保存]​ をクリックします。