Conectar o Salesforce Marketing Cloud ao Experience Platform usando a API Flow Service

Leia este guia para saber como conectar sua conta do Salesforce Marketing Cloud à Adobe Experience Platform usando a Flow Service API.

Introdução

Este guia requer uma compreensão funcional dos seguintes componentes do Experience Platform:

As seções a seguir fornecem informações adicionais que você precisará saber para se conectar com êxito ao Azure Synapse Analytics usando a API Flow Service.

Uso de APIs do Experience Platform

Para obter informações sobre como fazer chamadas para APIs do Experience Platform com êxito, consulte o manual sobre introdução às APIs do Experience Platform.

A seção a seguir fornece informações adicionais que você precisará saber para se conectar com êxito ao Salesforce Marketing Cloud usando a API Flow Service.

Coletar credenciais necessárias

Leia a Salesforce Marketing Cloud visão geral da autenticação para obter informações sobre autenticação.

Uso de APIs do Experience Platform

Leia o manual sobre introdução às APIs do Experience Platform para obter informações sobre como fazer chamadas com êxito para as APIs do Experience Platform.

Conectar Salesforce Marketing Cloud ao Experience Platform em Azure

Leia o seguinte para saber como criar uma conexão básica e conectar sua conta do Salesforce Marketing Cloud ao Experience Platform em Azure.

Criar uma conexão básica azure-base

Uma conexão base armazena informações importantes que vinculam seu sistema de origem à Adobe Experience Platform. Isso inclui:

A ID da conexão base permite procurar e explorar arquivos da sua origem, ajudando você a identificar quais itens serão assimilados, juntamente com seus tipos de dados e formatos.

Para criar uma ID de conexão base, envie uma solicitação POST para o ponto de extremidade /connections, incluindo suas credenciais de autenticação Salesforce Marketing Cloud nos parâmetros de solicitação.

Formato da API

POST /connections

Solicitação

A solicitação a seguir cria uma conexão base para 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\""
}

Conectar o Salesforce Marketing Cloud ao Experience Platform no Amazon Web Services aws

Leia as etapas abaixo para obter informações sobre como conectar sua conta do Salesforce Marketing Cloud ao Experience Platform no AWS.

Criar uma conexão básica aws-base

Formato da API

POST /connections

Solicitação

A solicitação a seguir cria uma conexão base para Salesforce Service Cloud se conectar ao Experience Platform no 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"
    }
  }'

Resposta

Uma resposta bem-sucedida retorna detalhes da conexão base recém-criada, incluindo seu identificador exclusivo (id).

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

Criar um fluxo de dados para dados de Salesforce Marketing Cloud

Agora que você conectou com êxito a conta Salesforce Marketing Cloud, é possível criar um fluxo de dados e assimilar dados do provedor de automação de marketing na Experience Platform.