# Salesforce Marketing Cloud Import Integration V2 Salesforce Marketing Cloudは、マーケティングプロフェッショナルが顧客ジャーニーのすべての段階で、適切なタイミングで適切なメッセージを配信できるようにします。この統合により、Salesforce Marketing Cloud Data SourceオブジェクトをTreasure Dataにインポートできます。 連絡先情報とキャンペーンデータを収集します。次のような顧客に関するメールイベント、送信データを収集します: - 開封されたメール - クリックされたリンク - 転送またはバウンスされたメール - 調査データ - 登録解除リクエスト 次のようなインポートオプションがあります: - 個別のメールイベントタイプまたは複数ユーザーのメールイベントタイプ - eventDateタイムスタンプに基づくEmail Eventオブジェクトの増分インポート 同じ接続を使用してSFMCデータをエクスポートできます。[Salesforce Marketing Cloud v2 Export Integration](/ja/int/salesforce-marketing-cloud-v2-export-integration)を参照してください。 Salesforce Marketing Cloudデータをインポートするサンプルワークフローについては、[Treasure Boxes](https://github.com/treasure-data/treasure-boxes/tree/master/td_load/sfmc)をご覧ください。 - [Prerequisites](/ja/int/salesforce-marketing-cloud-import-integration-v2#h1_1644201065) - [Limitation](/ja/int/salesforce-marketing-cloud-import-integration-v2#h1__1641228358) - [Create an Install Package in Salesforce Marketing Cloud](/ja/int/salesforce-marketing-cloud-import-integration-v2#h1_1609842111) - [Create a Legacy Package](/ja/int/salesforce-marketing-cloud-import-integration-v2#h2_20487344) - [How to Create Enhanced Functionality Package](/ja/int/salesforce-marketing-cloud-import-integration-v2#h2__78391380) - [Use the TD Console to Create Your Connection](/ja/int/salesforce-marketing-cloud-import-integration-v2#h1__76814271) - [Create a new connection](/ja/int/salesforce-marketing-cloud-import-integration-v2#h2_1865553679) - [Create Legacy Package Integration](/ja/int/salesforce-marketing-cloud-import-integration-v2#h3_404566245) - [Create Enhanced Package Integration](/ja/int/salesforce-marketing-cloud-import-integration-v2#h3_775794262) - [Create a New Transfer](/ja/int/salesforce-marketing-cloud-import-integration-v2#h2__2079243870) - [Available Targets](/ja/int/salesforce-marketing-cloud-import-integration-v2#h2__11689321) - [Custom Filters (Email Events)](/ja/int/salesforce-marketing-cloud-import-integration-v2#custom-filters-email-events) - [Appendix](/ja/int/salesforce-marketing-cloud-import-integration-v2#h1__1835053169) - [Important Note](/ja/int/salesforce-marketing-cloud-import-integration-v2#h1__1087930188) # 前提条件 - Treasure Dataの基本知識 - Salesforce Marketing Cloudの基本知識 # 制限事項 この統合を使用してインポートされたデータは、ブール値が誤ってまたは一貫性なくインポートされるため、データの不整合の問題が発生することがあります。このデータ不整合の症状は、Salesforce Marketing CloudでTrueまたはFalseとして表示される値が、VARCHARまたはBIGINT値として文字列データタイプのfalseまたはBIGINTの0として保存されることです。 Treasure Dataでは、[Salesforce統合移行手順に従う](/ja/int/migrating-salesforce-integrations)ことをお勧めします。 # Salesforce Marketing Cloudでインストールパッケージを作成 **2019年8月1日**以降、Salesforce Marketing Cloudで**Legacy Package**を作成することはできないため、**Enhanced Package**を作成することを強くお勧めします。 ## Legacy Packageを作成 Salesforce Marketing Cloudアカウントにログオンします **Welcome Page**で、右上隅の名前を選択し、**Setup**を選択します。 ![](/assets/image-20191021-143027.5174041da2ba1262fecec3a342aa6bce3ceb41c6e042ee130fee39714531fa0d.3736ed4a.png) 新しい画面の左側メニューで、**App** > **Installed Packages**を選択します。 ![](/assets/image-20191021-143035.41e0d4d8f1ea21af5f24301890ee9d563ca509df392a555eaf7cf2d15c3e2ee8.3736ed4a.png) **Installed Packages**画面で、**New**を選択します。 ![](/assets/image-20191021-143046.b09a9daa4819094f902ecbf155fd53b1395b41246cc32fab0b3679eaed16ff47.3736ed4a.png) **New Package Details**ポップアップで、**Name**と**Description**を入力します。**Create with enhanced functionality (recommended)**チェックボックスのチェックを外し（選択解除し）、**Save**を選択します。 ![](/assets/image-20191021-143110.21a4f99026cf4a84377caeac44d22b7948596e7085dd2185a583b1963bcbd21e.3736ed4a.png) **Package Details**画面で、**Add Component**を選択します。 ![](/assets/image-20191021-143125.9056eea6e9f836acf964d84a39b39f0f73f38bd3e98e29bfd7c27ea1ebc0ef2c.3736ed4a.png) **Add Component**ポップアップで、**API Integration**を選択し、**Next**を選択します。 ![](/assets/image-20191021-143136.d8110597e97cf88b3b22c5067e518313b664c943d36e320bae3e86b7efdd0361.3736ed4a.png) **Add API Integration**画面で: - **CHANNELS**セクションまでスクロールし、**Email**の**Read**チェックボックスを選択します - **CONTACT**セクションまでスクロールし、**Audiences**と**List and Subscribers**の**Read**チェックボックスを選択します - **DATA**セクションまでスクロールし、**Data Extensions**の**Read and Write**チェックボックス、**Tracking Events**の**Read**を選択します - **HUB**セクションまでスクロールし、**Campaign**の**Read**チェックボックスを選択します ![](/assets/image-20191021-143146.ea856636f504485b1834fdcfd6325c277d1d3b7bfb3057264ffab0ffdf50388e.3736ed4a.png) ![](/assets/image-20191021-143153.5ede65c100bc82b4ec6a9bcd9c8312f994ab63ce046adc712000b4acdfa386ee.3736ed4a.png) ![](/assets/image-20191021-143159.61b344fa688a50d3b3de2eb12a540320d5ce88637cd563154b3ed83e35d5f98a.3736ed4a.png) ![](/assets/image-20191021-143206.02630fe123bb6d8d149869821a6d5776714799f0fe6424af24257e9fa0788494.3736ed4a.png) **Installed Packages**画面で、**Components**パネルまでスクロールし、**Client Id**と**Client Secret**をメモします。この情報を使用して、Treasure DataからSalesforce Marketing Cloudにデータを書き込みます。 ![](/assets/image-20191021-143214.84f65b490fa7fa74752feef42ad33362b59470970466231d2fc9428511b1b22d.3736ed4a.png) ## Enhanced Functionality Packageの作成方法 1. Salesforce Marketing Cloudアカウントにログオンします。 2. **Welcome Page**で、右上隅の名前を選択し、**Setup**を選択します。 ![](/assets/image-20191021-143224.62577fde4ad9cd668977dd89e9961331d90de14ab22b4a578703b271db0fc7cc.3736ed4a.png) 3. 新しい画面の左側メニューで、**App** > **Installed Packages**を選択します。 ![](/assets/image-20191021-143237.4131d4caf822c7e03c802c62ef03fa714df6fa0a2f142a975cc992b831053fa4.3736ed4a.png)** 4. **Installed Packages**画面で、**New**を選択します。 ![](/assets/image-20191021-143250.6846f4eec992528d69770c3f8ada141f0157169077f5d21fedaec4533c8100d4.3736ed4a.png) 5. **New Package Details**ポップアップで、**Name**と**Description**を入力し、**Create with enhanced functionality (recommended)**チェックボックスを選択します。 6. **Save**を選択します。 ![](/assets/image-20191021-143301.054b962b05afe633a3f12a3ee89f47bb035c270d04401f1213c15cde749fbff9.3736ed4a.png)** 7. **Add Component**ポップアップで、**API Integration**を選択し、**Next**を選択します。 ![](/assets/image-20191021-143313.390c9d70ef21b4c42eb286abd2bcdd58a383571e30fde1f1bd3bccbfbf3edef5.3736ed4a.png)** 8. Choose Your Integration Type画面で、Server-to-Serverを選択し、**Next**を選択します。 ![](/assets/image-20191021-143326.0fba178d5e0227f878beeda41a8580f3e7213e0c0c6adb4e044bbb7e01383bf3.3736ed4a.png) 9. Set Server-to-Server Properties画面で: 1. **CHANNELS**セクションまでスクロールし、**Email**の**Read**チェックボックスを選択します 2. **CONTACT**セクションまでスクロールし、**Audiences**と**List and Subscribers**の**Read**チェックボックスを選択します 3. **DATA**セクションまでスクロールし、**Data Extensions**の**Read and Write**チェックボックス、**Tracking Events**の**Read**を選択します 4. **HUB**セクションまでスクロールし、**Campaign**の**Read**チェックボックスを選択します **![](/assets/image-20191021-143338.28cd4a8ef05485b695e6725234131d216aa5383ef1c85c5820d6a29d08f0a7a0.3736ed4a.png) ![](/assets/image-20191021-143348.357e5cbb69046045e99b02dee4dd8e6967103e34146405bc6bcd4fb2a92c4b75.3736ed4a.png) ![](/assets/image-20191021-143354.1f482fe60ddb0baba121886ec1c5771f65ec6a03f7551d809353ae07552fc1c1.3736ed4a.png) ![](/assets/image-20191021-143400.c723fe6e07dee083be3620aa6e6488fe5698c8f6c3ab5e70ac04396c40d17d7b.3736ed4a.png) 10. **Installed Packages**画面で、**Components**パネルまでスクロールし、**Client Id**、**Client Secret**、および**Authentication Base URI**をメモします。この情報を使用して、Treasure DataからSalesforce Marketing Cloudにデータを書き込みます。 ![](/assets/image-20191021-143409.df5446402533546a4fb7feb70e376926bbf0d2d7f40549e50f6ebb742782b3ac.3736ed4a.png) # TD Consoleを使用して接続を作成 TD Consoleを使用してデータコネクタを作成できます。 ## 新しい接続を作成 データ接続を設定する際、統合にアクセスするための認証を提供します。Treasure Dataでは、認証を設定してから、ソース情報を指定します。 **Integrations Hub** > **Catalog**に移動し、Salesforce Marketing Cloudを検索して選択します。 ![](/assets/screen-shot-2021-11-30-at-08.39.55.1c14880189b26500d01e5f17c73ee11c8cfcef06d49512e5b95029dce3fabd3a.3736ed4a.png) ### Legacy Package統合を作成 **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](http://exacttargetapis.com)]を非推奨にする予定のため、この値を入力する必要があります。詳細については: [https://help.salesforce.com/s/articleView?id=000356497](https://help.salesforce.com/s/articleView?id=000356497), [https://help.salesforce.com/s/articleView?id=000356498](https://help.salesforce.com/s/articleView?id=000356498) **Continue**を選択します。 ![](/assets/screen-shot-2021-11-30-at-08.42.13.22519d16514d5bebc0d50bde7d45ea6f80ab2f9f5c878947043301e5c5bd4a1c.3736ed4a.png) この統合の**Name**を入力し、**Done**を選択します。 ![](/assets/image-20191021-143438.a3209495167dd05c79b1b6045fefe94660d4e1e2704721bf353c42b42862e12d.3736ed4a.png) ### Enhanced Package統合を作成 **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](https://developer.salesforce.com/docs/atlas.en-us.mc-apis.meta/mc-apis/rest-permissions-and-scopes.htm)を参照**)**。**Continue**を選択します。 ![](/assets/image-20191021-143459.8a9dec9f1a09ebbed8c2d6026b59ac8dbe2e58b84db80cb585ea330fef72329d.3736ed4a.png) この統合の**Name**を入力し、**Done**を選択します。 ![](/assets/image-20191021-143511.75979c784fcbd8db97c8212a7a3b1ae3f2f93950beb92d3c52edff4d221e1d07.3736ed4a.png) ## 新しい転送を作成 接続を作成した後、自動的に**Sources**に移動します。作成した接続を探して、**New Transfer**を選択します。 ![](/assets/image-20191021-143520.62b4d4a4c1b3194ffe01dee2a43fcc755fec054b4f6361d9004dcf6673b44c8a.3736ed4a.png) 次のダイアログが開きます。詳細を入力し、**Next**を選択します。 ![](/assets/image-20191021-143529.a933ee0e85d9e153b13caf20ceb466ae66f141f69f574f19f7f47aec5980e467.3736ed4a.png) 次に、次のダイアログのようなデータのプレビューが表示されます。変更を加えるには、**Advanced Settings**を選択します。それ以外の場合は、**Next**を選択します。 ![](/assets/image-20191021-143539.53c9b99b42edb08e19207068cf9823b955577ea63074c428cbd29a7d409c6130.3736ed4a.png) ここから、エラー時のスキップやレート制限、接続タイムアウトなどのオプションを変更したい場合は、**Advanced Settings**を選択します: ![](/assets/screenshot-2023-03-10-at-15.47.49.d9bb86042fd07fcbed104e1f94de1ce7453ae1e50ca978e1321e8b4c5a0c4ecd.3736ed4a.png) データを転送するデータベースとテーブルを選択します: ![](/assets/image-20191021-143738.46695acbf95696698f3c4fdbd715e39ced4ba0934ed785cebee312a194b5a60b.3736ed4a.png) 次のダイアログを使用してデータ転送のスケジュールを指定し、**Start Transfer**を選択します: ![](/assets/image-20191021-143749.b5563c71c5f954344925becc97e3f31d6a39647a0de89cdf30e999ff46a00e09.3736ed4a.png) `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） ![](/assets/screenshot-2025-04-15-at-09.06.22.c5d43f51ef864cbb9c235729fb49ff5faa127094088f0d043a3844b03f581689.3736ed4a.png) ターゲット`Email Events`は、次のフィルタリングオプションを提供します: - メール名のマッチングパターン（完全一致または部分一致） - 取り込みたいメールイベントタイプ - 特定の日時範囲でイベントを取り込むための日付範囲を定義する2つのオプション ターゲットEmail Eventsは、バッチごとにメールを抽出するオプションを提供します - 1つのバッチに含めるメール数を指定するオプション（SFMC側で極端なパフォーマンスが発生した場合の微調整に使用） - メール名のマッチングパターン（完全一致または部分一致）: バッチ内のメール数、データ量を小さなチャンクに微調整するために使用されます - デフォルト: 2500 - The log debug info: 有効にすると、リクエストIDを含む詳細なデバッグ情報がログに記録されます（デフォルト: false） ### Custom Filters (Email Events) `Email Events`ターゲットはカスタムフィルターをサポートしており、取得するメール送信を絞り込むことができます。カスタムフィルターを使用すると、`EmailName`、`CreatedDate`、その他のSFMC `Send`オブジェクトフィールドなど、指定した条件に一致するオブジェクトのみをインポートできます。 カスタムフィルターを設定するには、転送設定の**Source Table**ステップで**CUSTOM FILTERS**セクションを展開します。**Add**を選択して新しいフィルターを追加し、各フィルターの**Field**、**Operator**、**Value**を指定します。 ![](/assets/email-events-custom-filters.f4772aad160a407e7d4730cb4f56246e1c0971ec9ef6e28d1d7cbba953f866d8.3736ed4a.png) 各フィルターには以下の項目が必要です: | フィールド | 説明 | | --- | --- | | Field | フィルタリングするSFMCオブジェクトのフィールド/プロパティ名（例: `CreatedDate`、`EmailName`） | | Operator | フィルター演算子。使用可能な演算子: `EQUALS`、`NOT_EQUALS`、`GREATER_THAN`、`LESS_THAN`、`GREATER_THAN_OR_EQUAL`、`LESS_THAN_OR_EQUAL`、`LIKE`、`BEGINS_WITH`、`ENDS_WITH`、`CONTAINS`、`NOT_CONTAINS`、`EXISTS_IN_STRING`、`EXISTS_IN_STRING_AS_A_WORD`、`NOT_EXISTS_IN_STRING`、`BETWEEN`、`IN` | | Value | フィルター値。`BETWEEN`および`IN`演算子の場合、カンマ区切りで複数の値を指定します。 | Note 複数のカスタムフィルターを指定した場合、**AND**ロジックで結合されます。メール名（search term）フィルターも指定した場合、カスタムフィルターとANDで結合されます。カスタムフィルターは`Email Events`ターゲットにのみ適用され、他のターゲットには影響しません。 使用可能な演算子とCLI設定の詳細については、[Salesforce Marketing Cloud Import Integration CLI V2 - Custom Filters](/ja/int/salesforce-marketing-cloud-import-integration-cli-v2#custom-filters-for-email_event-target)を参照してください。 # 付録 - コネクタはHTTPS経由でSFMC v2サーバー/インスタンスエンドポイントと通信します。 - HTTPSおよびSSL/TLS暗号化はSFMC v2サーバーによって強制され、処理前にコネクタによってチェックされます。 # 重要な注意事項 - これは、Salesforce Marketing Cloud（SFMC）を使用する際の既知の制限事項であり、特にSOAP API経由でData Extensionsから大規模なデータ取得を行うシナリオで発生します。SFMCのマルチテナントアーキテクチャのため、プロセスの途中でデータカーソルが失われ、不完全または不整合な応答が発生する場合があります。この動作はバルク操作中に観察されており、現在SOAP APIの制限と見なされています。