Conectar Salesforce Marketing Cloud a Experience Platform mediante la API Flow Service

Lea esta guía para aprender a conectar su cuenta de Salesforce Marketing Cloud a Adobe Experience Platform mediante la Flow Service API.

Introducción

Esta guía requiere una comprensión práctica de los siguientes componentes de Experience Platform:

Las secciones siguientes proporcionan información adicional que necesitará conocer para conectarse correctamente a Azure Synapse Analytics mediante la API Flow Service.

Uso de API de Experience Platform

Para obtener información sobre cómo realizar llamadas correctamente a las API de Experience Platform, consulte la guía sobre introducción a las API de Experience Platform.

La siguiente sección proporciona información adicional que necesitará conocer para conectarse correctamente a Salesforce Marketing Cloud mediante la API Flow Service.

Recopilar credenciales necesarias

Lea la Salesforce Marketing Cloud descripción general de la autenticación para obtener información sobre la autenticación.

Uso de API de Experience Platform

Lea la guía sobre introducción a las API de Experience Platform para obtener información sobre cómo realizar llamadas a las API de Experience Platform correctamente.

Conectar Salesforce Marketing Cloud a Experience Platform en Azure

Lea lo siguiente para aprender a crear una conexión base y conectar su cuenta de Salesforce Marketing Cloud a Experience Platform en Azure.

Crear una conexión base azure-base

Una conexión base almacena información clave que vincula el sistema de origen con Adobe Experience Platform. Esto incluye lo siguiente:

El identificador de conexión base le permite examinar y explorar archivos de su origen, lo que le ayuda a identificar qué elementos introducir, junto con sus tipos de datos y formatos.

Para crear un identificador de conexión base, envíe una petición POST al extremo /connections, incluidas sus credenciales de autenticación Salesforce Marketing Cloud en los parámetros de la solicitud.

Formato de API

POST /connections

Solicitud

La siguiente solicitud crea una conexión 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 Salesforce Marketing Cloud a Experience Platform en Amazon Web Service aws

Lea los pasos a continuación para obtener información sobre cómo conectar su cuenta de Salesforce Marketing Cloud a Experience Platform en AWS.

Crear una conexión base aws-base

Formato de API

POST /connections

Solicitud

La siguiente solicitud crea una conexión base para que Salesforce Service Cloud se conecte a Experience Platform en 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"
    }
  }'

Respuesta

Una respuesta correcta devuelve detalles de la conexión base recién creada, incluido su identificador único (id).

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

Crear un flujo de datos para Salesforce Marketing Cloud datos

Ahora que ha conectado correctamente su cuenta de Salesforce Marketing Cloud, puede crear un flujo de datos e introducir datos de su proveedor de automatización de marketing en Experience Platform.