詳細情報:
Marketing Cloud Engagement の Salesforce OAuth 2.0 接続
Engagement からのデータを CRM Analytics と同期させるには、Salesforce Marketing Cloud Engagement OAuth 2.0 コネクタを使用してリモート接続を作成します。
接続の作成
- [データマネージャー接続] タブで、[新しい接続] をクリックします。
- コネクタの名前をクリックし、[次へ] をクリックします。
- コネクタ設定を入力します。
- 設定を検証してソースへの接続を試みるには、[保存 & テスト] をクリックします。接続に失敗すると、考えられる理由が CRM Analytics に表示されます。
このコネクタには、テナント固有のエンドポイントと OAuth 2.0 認証を使用する Marketing Cloud Engagement パッケージが必要です。少なくとも次のパッケージ権限が必要です。
- 「リストおよび登録者」に対する「参照」
- 「データエクステンション」に対する「参照」および「更新」
- 「Marketing Cloud Connect」に対する「参照」および「更新」
- 「取引先」に対する「参照」
- 「ユーザー」に対する「参照」
接続に使用するユーザーのセキュリティ設定によって、同期に使用できるオブジェクトと項目が決まります。
特に明記されていない限り、すべての設定で値が必要です。
| 接続設定 | 説明 |
|---|---|
| 接続名 | 接続を識別します。異なる接続を区別しやすい規則を使用します。 |
| API 参照名 | 接続の API 参照名。この名前にスペースを含めることはできません。API 参照名は、この接続を介して抽出されたデータをレシピで参照するために使用します。接続の作成後に API 参照名を変更することはできません。 |
| 説明 | 内部使用の接続の説明。 |
| API Type (API 種別) | 使用する API。オプションは、SOAP API または REST のSOAPです (デフォルト)。 |
| ClientSecret | 有効なアクセストークンの生成に必要な Marketing Cloud Engagement のクライアントの秘密。 |
| ClientId | 有効なアクセストークンの生成に必要な Marketing Cloud Engagement のクライアント ID。 |
| Salesforce Marketing Cloud URL | Marketing Cloud Engagement WSDL への接続に使用する URL。URLを作成するには、デフォルトのhttps://mcxxx.soap.marketingcloudapis.com/etframework.wsdlの「mcxxx」をベースURLに置き換えます。ベース URL を取得する
たとえば、ベース URL が mc7f4m1tsgmxz8862chq5qar2k4q の場合、Salesforce Marketing Cloud Url の値は https://mc7f4m1tsgmxz8862chq5qar2k4q.soap.marketingcloudapis.com/etframework.wsdl になります。 |
| UTC のオフセット | 省略可能な設定。UTC オフセットタイムゾーンで Marketing Cloud Engagement からデータを参照するために使用します。 |
| 子データエクステンションを表示 | 省略可能な設定。MID オブジェクトの最上位および子ビジネスユニット MID 情報が Parentname_childnameID の形式を使用して表示されます。サフィックスがある場合とない場合の現在のビジネスユニットのデータエクステンションが表示されます。この両方のデータは同じです。 |
CRM Analytics に同期するデータの絞り込み
データ同期検索条件を使用して、不要なデータや機密データを CRM Analytics との同期から除外します。検索条件はソースオブジェクトで実行されます。検索条件を使用すると、必要なデータのみが CRM Analytics に取り込まれるため、データ同期の時間を短縮できます。
- データマネージャーから、[接続] タブをクリックします。
- 絞り込むオブジェクトに関連付けられた接続を選択します。
- 絞り込むオブジェクトの名前をクリックします。
- [データ同期検索条件] をクリックします。
- 検索条件を入力します。
- [保存] をクリックします。
Marketing Cloud Engagement OAuth 2.0 コネクタの場合、Filterpart ヘルプに相当する SQL 構文で検索条件を入力します。検索条件には、Boolean ステートメント (AND、OR)、数値比較 (>、>=、<、<=)、等号 (=、!=)、LIKE 演算子を使用できます。SOAP オブジェクトでは絞り込みはサポートされていません。
簡単な例として、 filter Name="Marc"を使用して [名前] フィールドが Marc のエントリを返します。パフォーマンスとクエリ応答を最適にするには、この種類の簡単な検索条件を使用します。より複雑な状況では、2 つの検索条件部分を AND または OR 論理演算子 ((Name="Marc") AND (Age=57) など) で組み合わせます。(Name="Marc")
AND ((Age=57) OR (Age=37)) など、検索条件を括弧でネストすることもできます。
日付で絞り込むには、Supported 形式で日付データを保存します。例: column_date >
'2010-12-31T22:00:00.000Z'
Salesforce Marketing Cloud Engagement OAuth 2.0 コネクタの考慮事項
Salesforce Marketing Cloud Engagement コネクタを使用するときは、次の点に留意してください。
- 接続済みオブジェクト名は、先頭が文字で、文字、数字、またはアンダースコアのみが含まれている必要があります。オブジェクト名の末尾をアンダースコアにすることはできません。
- 英数字、ドット、アンダースコア、ダッシュの文字を組み合わせた項目名のみがサポートされます。コネクタに、スペースや括弧などの他の文字を含んだ項目名がある場合、同期に失敗します。
- コネクタは、オブジェクトあたり最大 2,000 万行または 10 GB のいずれか先に制限に達したものを同期できます。
- 標準 Marketing Cloud Engagement およびカスタムオブジェクトがサポートされますが、パッケージのアクセス権または権限設定が原因で使用できない場合があります。メモ JourneyActivities オブジェクトは使用できません。
- データ同期中にデータエクステンションを上書きしないでください。データエクステンションが同時に上書きされる場合、Marketing Cloud Engagement の SOAP API は、データエクステンションの読み取り操作から不完全なデータを返すことができます。
- このコネクタは、Marketing Cloud Engagement に保存されている 16 進数文字データ (0x1B など) を読み取ることができず、HTTP 302 エラーを生成します。列を取り込むには、すべての 16 進値を削除します。
- Marketing Cloud Engagement データエクステンションを表示する場合、名前にはアンダースコア 2 個が含まれる「Ungrouped__」というテキストが先頭に追加されます。たとえば、データエクステンション
MC_EastはUngrouped__MC_Eastとして表示されます。
