Crear un Salesforce Marketing Cloud conexión base mediante el Flow Service API
Una conexión base representa la conexión autenticada entre un origen y Adobe Experience Platform.
Este tutorial lo acompañará durante los pasos para crear una conexión base para Salesforce Marketing Cloud uso del [Flow Service API] (https://www.adobe.io/experience-platform-apis/references/flow-service/).
Introducción
Esta guía requiere una comprensión práctica de los siguientes componentes de Adobe Experience Platform:
- Fuentes: Experience Platform permite la ingesta de datos desde varias fuentes y, al mismo tiempo, le ofrece la capacidad de estructurar, etiquetar y mejorar los datos entrantes mediante los servicios de Platform.
- Zonas protegidas: El Experience Platform proporciona entornos limitados virtuales que dividen una sola instancia de Platform en entornos virtuales independientes para ayudar a desarrollar y evolucionar aplicaciones de experiencia digital.
Uso de API de Platform
Para obtener información sobre cómo realizar llamadas correctamente a las API de Platform, consulte la guía de introducción a las API de Platform.
La siguiente sección proporciona información adicional que necesitará conocer para conectarse correctamente a Salesforce Marketing Cloud uso del Flow Service API.
Recopilar credenciales necesarias
Para que Flow Service para conectar con Salesforce Marketing Cloud, debe proporcionar las siguientes propiedades de conexión:
host
host
, debe especificar el valor de {subdomain}.rest.marketingcloudapis.com
. Por ejemplo, si la dirección URL del host es https://acme-ab12c3d4e5fg6hijk7lmnop8qrst.auth.marketingcloudapis.com/
, entonces debe introducir acme-ab12c3d4e5fg6hijk7lmnop8qrst.rest.marketingcloudapis.com/
como valor de host.clientId
clientSecret
connectionSpec.id
ea1c2a08-b722-11eb-8529-0242ac130003
.Para obtener más información sobre cómo empezar, consulte esta [Salesforce Marketing Cloud documento] (https://developer.salesforce.com/docs/atlas.en-us.mc-apis.meta/mc-apis/authentication.htm).
Crear una conexión base
Una conexión base retiene información entre el origen y Platform, incluidas las credenciales de autenticación del origen, el estado actual de la conexión y el ID único de conexión base. El ID de conexión base le permite explorar y navegar por archivos desde el origen e identificar los elementos específicos que desea introducir, incluida la información sobre sus tipos de datos y formatos.
Para crear un ID de conexión base, realice una solicitud de POST al /connections
extremo al proporcionar su Salesforce Marketing Cloud credenciales de autenticación como parte del cuerpo 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",
"description": "Salesforce Marketing Cloud base connection",
"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"
}
}'
auth.params.clientId
auth.params.clientSecret
connectionSpec.id
ea1c2a08-b722-11eb-8529-0242ac130003
.Respuesta
Una respuesta correcta devuelve la conexión recién creada, incluido su identificador de conexión único (id
). Este ID es necesario para explorar los datos en el siguiente tutorial.
{
"id": "2fce94c1-9a93-4971-8e94-c19a93097129",
"etag": "\"d403848a-0000-0200-0000-5e978f7b0000\""
}
Pasos siguientes
Al seguir este tutorial, ha creado un Salesforce Marketing Cloud conexión base mediante el Flow Service API. Puede utilizar este ID de conexión base en los siguientes tutoriales: