使用Flow Service API連線Salesforce Marketing Cloud至Experience Platform

Last update: Wed Jun 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

開發人員

WARNING

Salesforce Marketing Cloud來源將於2026年1月汰除。新的來源將作為替代方案於今年晚些時候發行。釋放新來源後，您必須在2026年1月底之前建立新的帳戶連線和資料流，以計畫移轉至新來源。

閱讀本指南，瞭解如何使用Flow Service API將您的Salesforce Marketing Cloud帳戶連結至Adobe Experience Platform。

快速入門

本指南需要您深入瞭解下列Experience Platform元件：

來源： Experience Platform允許從各種來源擷取資料，同時讓您能夠使用Experience Platform服務來建構、加標籤以及增強傳入的資料。
沙箱： Experience Platform提供的虛擬沙箱可將單一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 可讓您瀏覽和瀏覽來源中的檔案，協助您識別要擷取的專案，以及專案的資料型別和格式。

若要建立基底連線識別碼，請傳送POST要求至/connections端點，包括要求引數中的Salesforce Marketing Cloud驗證認證。

API格式

POST /connections

要求

下列要求會建立Salesforce Marketing Cloud的基礎連線。

檢視範例請求

code language-shell

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" } }'

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應用程式關聯的使用者端識別碼。
`auth.params.clientSecret`	與您的Salesforce Marketing Cloud應用程式關聯的使用者端密碼。
`connectionSpec.id`	Salesforce Marketing Cloud連線規格識別碼： `ea1c2a08-b722-11eb-8529-0242ac130003`。

檢視範例回應

回應

成功的回應會傳回新建立的基礎連線的詳細資料，包括其唯一識別碼(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多雲端總覽。

請閱讀下列步驟，以瞭解如何在AWS上將您的Salesforce Marketing Cloud帳戶連結至Experience Platform。

建立基礎連線 aws-base

API格式

POST /connections

要求

下列要求會建立Salesforce Service Cloud的基礎連線，以連線至AWS上的Experience Platform。

檢視請求範例

code language-shell

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" } }'

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)。

檢視回應範例

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

337b99bb-92fb-42ae-b6b7-c7042161d089