Salesforce Marketing Cloudは、マーケティングプロフェッショナルが顧客ジャーニーのすべての段階で、適切なタイミングで適切なメッセージを配信できるようにします。この統合により、Salesforce Marketing Cloud Data SourceオブジェクトをTreasure Dataにインポートできます。
連絡先情報とキャンペーンデータを収集します。次のような顧客に関するメールイベント、送信データを収集します:
- 開封されたメール
- クリックされたリンク
- 転送またはバウンスされたメール
- 調査データ
- 登録解除リクエスト
次のようなインポートオプションがあります:
- 個別のメールイベントタイプまたは複数ユーザーのメールイベントタイプ
- eventDateタイムスタンプに基づくEmail Eventオブジェクトの増分インポート
同じ接続を使用してSFMCデータをエクスポートできます。Salesforce Marketing Cloud v2 Export Integrationを参照してください。
Salesforce Marketing Cloudデータをインポートするサンプルワークフローについては、Treasure Boxesをご覧ください。
- Prerequisites
- Limitation
- Create an Install Package in Salesforce Marketing Cloud
- Create a Legacy Package
- How to Create Enhanced Functionality Package
- Use the TD Console to Create Your Connection
- Create a new connection
- Create Legacy Package Integration
- Create Enhanced Package Integration
- Create a New Transfer
- Available Targets
- Appendix
- Important Note
- Treasure Dataの基本知識
- Salesforce Marketing Cloudの基本知識
この統合を使用してインポートされたデータは、ブール値が誤ってまたは一貫性なくインポートされるため、データの不整合の問題が発生することがあります。このデータ不整合の症状は、Salesforce Marketing CloudでTrueまたはFalseとして表示される値が、VARCHARまたはBIGINT値として文字列データタイプのfalseまたはBIGINTの0として保存されることです。
Treasure Dataでは、Salesforce統合移行手順に従うことをお勧めします。
2019年8月1日以降、Salesforce Marketing CloudでLegacy Packageを作成することはできないため、Enhanced Packageを作成することを強くお勧めします。
Salesforce Marketing Cloudアカウントにログオンします
Welcome Pageで、右上隅の名前を選択し、Setupを選択します。
新しい画面の左側メニューで、App > Installed Packagesを選択します。
Installed Packages画面で、Newを選択します。
New Package Detailsポップアップで、NameとDescriptionを入力します。**Create with enhanced functionality (recommended)**チェックボックスのチェックを外し（選択解除し）、Saveを選択します。
Package Details画面で、Add Componentを選択します。
Add Componentポップアップで、API Integrationを選択し、Nextを選択します。
Add API Integration画面で:
- CHANNELSセクションまでスクロールし、EmailのReadチェックボックスを選択します
- CONTACTセクションまでスクロールし、AudiencesとList and SubscribersのReadチェックボックスを選択します
- DATAセクションまでスクロールし、Data ExtensionsのRead and Writeチェックボックス、Tracking EventsのReadを選択します
- HUBセクションまでスクロールし、CampaignのReadチェックボックスを選択します
Installed Packages画面で、Componentsパネルまでスクロールし、Client IdとClient Secretをメモします。この情報を使用して、Treasure DataからSalesforce Marketing Cloudにデータを書き込みます。
Salesforce Marketing Cloudアカウントにログオンします。
Welcome Pageで、右上隅の名前を選択し、Setupを選択します。
新しい画面の左側メニューで、App > Installed Packagesを選択します。
**Installed Packages画面で、Newを選択します。
New Package Detailsポップアップで、NameとDescriptionを入力し、**Create with enhanced functionality (recommended)**チェックボックスを選択します。
Saveを選択します。
**Add Componentポップアップで、API Integrationを選択し、Nextを選択します。
**Choose Your Integration Type画面で、Server-to-Serverを選択し、Nextを選択します。
Set Server-to-Server Properties画面で:
CHANNELSセクションまでスクロールし、EmailのReadチェックボックスを選択します
CONTACTセクションまでスクロールし、AudiencesとList and SubscribersのReadチェックボックスを選択します
DATAセクションまでスクロールし、Data ExtensionsのRead and Writeチェックボックス、Tracking EventsのReadを選択します
HUBセクションまでスクロールし、CampaignのReadチェックボックスを選択します
**
Installed Packages画面で、Componentsパネルまでスクロールし、Client Id、Client Secret、およびAuthentication Base URIをメモします。この情報を使用して、Treasure DataからSalesforce Marketing Cloudにデータを書き込みます。
TD Consoleを使用してデータコネクタを作成できます。
データ接続を設定する際、統合にアクセスするための認証を提供します。Treasure Dataでは、認証を設定してから、ソース情報を指定します。
Integrations Hub > Catalogに移動し、Salesforce Marketing Cloudを検索して選択します。
New Authentication画面で、Package TypeとしてLegacy Packageを選択し、Client IdとClient Secret（SFMCでlegacy packageを作成した際に取得したもの）を入力します。
Tenant Authentication Base URIは、Authentication Base URL（SFMCでlegacy packageを作成した際に取得したもの）です。2022年9月以降、Marketing Cloudはレガシーエンドポイント
[https://*.exacttargetapis.com]を非推奨にする予定のため、この値を入力する必要があります。詳細については: https://help.salesforce.com/s/articleView?id=000356497, https://help.salesforce.com/s/articleView?id=000356498
Continueを選択します。
この統合のNameを入力し、Doneを選択します。
New Authentication画面で、Package TypeとしてEnhanced Functionality Packageを選択し、Client Id、Client Secret、およびAuthentication Base URI（SFMCでenhanced packageを作成した際に取得したもの）を入力します。オプションで、Account identifier or MIDを指定して複数のBUにアクセスできます（詳細はHow to get MIDを参照）。また、Scopeを指定してトークンのスコープを制限できます（詳細はAPI scopesを参照**)**。Continueを選択します。
この統合のNameを入力し、Doneを選択します。
接続を作成した後、自動的にSourcesに移動します。作成した接続を探して、New Transferを選択します。
次のダイアログが開きます。詳細を入力し、Nextを選択します。
次に、次のダイアログのようなデータのプレビューが表示されます。変更を加えるには、Advanced Settingsを選択します。それ以外の場合は、Nextを選択します。
ここから、エラー時のスキップやレート制限、接続タイムアウトなどのオプションを変更したい場合は、Advanced Settingsを選択します:
データを転送するデータベースとテーブルを選択します:
次のダイアログを使用してデータ転送のスケジュールを指定し、Start Transferを選択します:
My Input Transfersタブの下に進行中の新しいデータ転送が表示され、対応するジョブがJobsセクションに表示されます。
| Target | Description |
|---|---|
| Campaign | メールキャンペーン |
| Contact | 連絡先リスト |
| Data Extensions | 柔軟なデータストレージのニーズを満たすデータ拡張 |
| Email Events | メールマーケティング送信に関連するイベント |
| Email Events Only | メールイベントデータ |
| Send | メールマーケティング送信 |
場合によっては、一部の属性に問題があるため、データが壊れることがあります。Attribute set names will be ignoredオプションを使用して、問題のある属性をスキップできます。このオプションは、Salesforce Marketing CloudのAPIからエラーなしでデータを取り込むのに役立ちます。
ターゲットData Extensionsは、取り込みたいデータ拡張をフィルタリングするオプションと、共有データ拡張の取り込みを有効にする別のオプションを提供します。
- The log debug info: 有効にすると、リクエストIDを含む詳細なデバッグ情報がログに記録されます（デフォルト: false）
ターゲットEmail Eventsは、次のフィルタリングオプションを提供します:
- メール名のマッチングパターン（完全一致または部分一致）
- 取り込みたいメールイベントタイプ
- 特定の日時範囲でイベントを取り込むための日付範囲を定義する2つのオプション
ターゲットEmail Eventsは、バッチごとにメールを抽出するオプションを提供します
1つのバッチに含めるメール数を指定するオプション（SFMC側で極端なパフォーマンスが発生した場合の微調整に使用）
メール名のマッチングパターン（完全一致または部分一致）: バッチ内のメール数、データ量を小さなチャンクに微調整するために使用されます
デフォルト: 2500
The log debug info: 有効にすると、リクエストIDを含む詳細なデバッグ情報がログに記録されます（デフォルト: false）
- コネクタはHTTPS経由でSFMC v2サーバー/インスタンスエンドポイントと通信します。
- HTTPSおよびSSL/TLS暗号化はSFMC v2サーバーによって強制され、処理前にコネクタによってチェックされます。
- これは、Salesforce Marketing Cloud（SFMC）を使用する際の既知の制限事項であり、特にSOAP API経由でData Extensionsから大規模なデータ取得を行うシナリオで発生します。SFMCのマルチテナントアーキテクチャのため、プロセスの途中でデータカーソルが失われ、不完全または不整合な応答が発生する場合があります。この動作はバルク操作中に観察されており、現在SOAP APIの制限と見なされています。