Connetti Salesforce Marketing Cloud ad Experience Platform utilizzando l'API Flow Service

Leggi questa guida per scoprire come collegare il tuo account Salesforce Marketing Cloud a Adobe Experience Platform utilizzando Flow Service API.

Introduzione

Questa guida richiede una buona conoscenza dei seguenti componenti di Experience Platform:

Le sezioni seguenti forniscono informazioni aggiuntive che è necessario conoscere per connettersi correttamente a Azure Synapse Analytics utilizzando l'API Flow Service.

Utilizzo delle API di Experience Platform

Per informazioni su come effettuare correttamente chiamate alle API di Experience Platform, consulta la guida introduttiva alle API di Experience Platform.

La sezione seguente fornisce informazioni aggiuntive che è necessario conoscere per connettersi correttamente a Salesforce Marketing Cloud utilizzando l'API Flow Service.

Raccogli le credenziali richieste

Per informazioni sull'autenticazione, leggere la Salesforce Marketing Cloud panoramica autenticazione.

Utilizzo delle API di Experience Platform

Per informazioni su come effettuare correttamente chiamate alle API di Experience Platform, leggi la guida guida introduttiva alle API di Experience Platform.

Connetti Salesforce Marketing Cloud ad Experience Platform il Azure

Per informazioni su come creare una connessione di base e connettere l'account Salesforce Marketing Cloud ad Experience Platform il Azure, leggi quanto segue.

Creare una connessione di base azure-base

Una connessione di base memorizza le informazioni chiave che collegano il sistema di origine a Adobe Experience Platform. Ciò include:

L'ID connessione di base ti consente di sfogliare ed esplorare i file dall'origine, identificando gli elementi da acquisire, insieme ai relativi tipi di dati e formati.

Per creare un ID connessione di base, inviare una richiesta POST all'endpoint /connections, incluse le credenziali di autenticazione Salesforce Marketing Cloud nei parametri della richiesta.

Formato API

POST /connections

Richiesta

La richiesta seguente crea una connessione di base per Salesforce Marketing Cloud.

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

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

Connetti Salesforce Marketing Cloud ad Experience Platform su Amazon Web Services aws

Per informazioni su come collegare il tuo account Salesforce Marketing Cloud ad Experience Platform su AWS, leggi i passaggi seguenti.

Creare una connessione di base aws-base

Formato API

POST /connections

Richiesta

La richiesta seguente crea una connessione di base per Salesforce Service Cloud per connettersi ad Experience Platform su AWS.

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

Risposta

In caso di esito positivo, la risposta restituisce i dettagli della connessione di base appena creata, incluso il relativo identificatore univoco (id).

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

Crea un flusso di dati per Salesforce Marketing Cloud dati

Dopo aver connesso correttamente l'account Salesforce Marketing Cloud, è ora possibile creare un flusso di dati e acquisire dati dal provider di automazione marketing in Experience Platform.