Flow Service APIを使用してSalesforce Marketing CloudをExperience Platformに接続します

最終更新日： 2025年11月1日

トピック：
Sources

作成対象：

Developer

WARNING

Salesforce Marketing Cloud ソースは2026年1月に非推奨（廃止予定）になります。新しいソースは、代替案として今年後半にリリースされる予定です。新しいソースがリリースされたら、2026年1月末までに新しいアカウント接続とデータフローを作成して、新しいソースに移行することを計画する必要があります。

このガイドでは、Flow Service APIを使用してSalesforce Marketing Cloud アカウントをAdobe Experience Platformに接続する方法について説明します。

基本を学ぶ

このガイドは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。

ソース : Experience Platformを使用すると、様々なソースからデータを取り込むことができますが、Experience Platform サービスを使用して着信データを構造化、ラベル付け、強化することができます。
サンドボックス : Experience Platformは、1つのExperience Platform インスタンスを個別のバーチャル環境に分割して、デジタルエクスペリエンスアプリケーションの開発と進化に役立つバーチャルサンドボックスを提供します。

次の節では、Flow Service APIを使用してAzure Synapse Analyticsに正常に接続するために知っておく必要がある追加情報を示します。

Experience Platform APIの使用

Experience Platform APIの呼び出しを正常に行う方法について詳しくは、Experience Platform APIの概要に関するガイドを参照してください。

次の節では、Flow Service APIを使用してSalesforce Marketing Cloudに正常に接続するために知っておく必要がある追加情報を示します。

必要な資格情報の収集

認証について詳しくは、Salesforce Marketing Cloud 認証の概要を参照してください。

Experience Platform APIの使用

Experience Platform APIを正常に呼び出す方法について詳しくは、Experience Platform APIの概要に関するガイドを参照してください。

Salesforce Marketing CloudをAzureにExperience Platformに接続します

ベース接続を作成し、Salesforce Marketing Cloud アカウントをAzureにExperience Platformに接続する方法については、次を参照してください。

ベース接続の作成 azure-base

IMPORTANT

カスタムオブジェクトの取り込みは、現在Salesforce Marketing Cloud ソース統合ではサポートされていません。

ベース接続には、ソースシステムとAdobe Experience Platformをリンクするキー情報が格納されます。これには以下が含まれます。

ソースの認証情報
接続の現在ステータス
一意のベース接続ID

ベース接続IDを使用すると、ソースからファイルを参照および探索し、取り込む項目とそのデータの種類および形式を特定できます。

ベース接続IDを作成するには、リクエストパラメーターにSalesforce Marketing Cloud認証情報を含むPOST リクエストを/connections エンドポイントに送信します。

API 形式

POST /connections

リクエスト

次のリクエストは、Salesforce Marketing Cloudのベース接続を作成します。

リクエスト例を表示

code language-shell

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Salesforce Marketing Cloud base connection for Azure",
    "description": "Salesforce Marketing Cloud base connection for Azure",
    "auth": {
      "specName": "Client-Id-Secret Based Authentication",
      "params": {
        "host": "acme-ab12c3d4e5fg6hijk7lmnop8qrst",
        "clientId": "acme-salesforce-marketing-cloud",
        "clientSecret": "xxxx"
      }
    },
    "connectionSpec": {
      "id": "ea1c2a08-b722-11eb-8529-0242ac130003",
      "version": "1.0"
    }
  }'

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
プロパティ	説明
`auth.params.host`
`auth.params.clientId`	Salesforce Marketing Cloud アプリケーションに関連付けられているクライアント ID。
`auth.params.clientSecret`	Salesforce Marketing Cloud アプリケーションに関連付けられているクライアント秘密鍵。
`connectionSpec.id`	Salesforce Marketing Cloud接続仕様ID: `ea1c2a08-b722-11eb-8529-0242ac130003`。

回答の例を表示

応答

リクエストが成功した場合は、一意の ID（id）を含め、新しく作成されたベース接続の詳細が返されます。

code language-json
`{ "id": "2fce94c1-9a93-4971-8e94-c19a93097129", "etag": "\"d403848a-0000-0200-0000-5e978f7b0000\"" }`

Salesforce Marketing CloudをAmazon Web Services上のExperience Platformに接続 aws

AVAILABILITY

この節は、Amazon Web Services（AWS）で動作するExperience Platformの実装に適用されます。 AWS上で動作するExperience Platformは、現在、一部のお客様にご利用いただけます。サポートされているExperience Platform インフラストラクチャについて詳しくは、Experience Platform マルチクラウドの概要を参照してください。

Salesforce Marketing Cloud アカウントをAWS上のExperience Platformに接続する方法について詳しくは、以下の手順を参照してください。

ベース接続の作成 aws-base

API 形式

POST /connections

リクエスト

次のリクエストは、Salesforce Service CloudがAWS上のExperience Platformに接続するためのベース接続を作成します。

リクエストの例を表示

code language-shell

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Salesforce Marketing Cloud base connection for AWS",
    "description": "Salesforce Marketing Cloud base connection for AWS",
    "auth": {
      "specName": "OAuth2 Client Credential",
      "params": {
        "subdomain": "mc563885gzs27c5t9-63k636ttgm",
        "clientId": "3a1b2c3d4e5f67890123456789abcdef",
        "clientSecret": "xxxx"
      }
    },
    "connectionSpec": {
      "id": "ea1c2a08-b722-11eb-8529-0242ac130003",
      "version": "1.0"
    }
  }'

応答

リクエストが成功した場合は、一意の ID（id）を含め、新しく作成されたベース接続の詳細が返されます。

応答の例を表示

code language-json
`{ "id": "2fce94c1-9a93-4971-8e94-c19a93097129", "etag": "\"d403848a-0000-0200-0000-5e978f7b0000\"" }`

Salesforce Marketing Cloud データのデータフローを作成

Salesforce Marketing Cloud アカウントが正常に接続されたので、データフローを作成し、マーケティングオートメーションプロバイダーからExperience Platformにデータを取り込むことができるようになりました。

recommendation-more-help

experience-platform-help-sources