Verbinden von Salesforce Marketing Cloud mit Experience Platform mithilfe der Flow Service-API
Erstellt für:
- Entwickler
Lesen Sie dieses Handbuch, um zu erfahren, wie Sie Ihr Salesforce Marketing Cloud-Konto mithilfe der Flow Service API mit Adobe Experience Platform verbinden.
Erste Schritte
Dieses Handbuch setzt ein Verständnis der folgenden Komponenten von Experience Platform voraus:
- Quellen: Experience Platform ermöglicht die Aufnahme von Daten aus verschiedenen Quellen und bietet Ihnen die Möglichkeit, die eingehenden Daten mithilfe von Experience Platform-Services zu strukturieren, zu kennzeichnen und anzureichern.
- Sandboxes: Experience Platform bietet virtuelle Sandboxes, die eine einzelne Experience Platform-Instanz in separate virtuelle Umgebungen unterteilen, damit Sie Programme für digitale Erlebnisse besser entwickeln und weiterentwickeln können.
Die folgenden Abschnitte enthalten zusätzliche Informationen, die Sie benötigen, um mithilfe der Flow Service-API eine Verbindung zu Azure Synapse Analytics herstellen zu können.
Verwenden von Experience Platform-APIs
Informationen zum erfolgreichen Aufrufen von Experience Platform-APIs finden Sie im Handbuch unter mit Experience Platform-APIs.
Der folgende Abschnitt enthält zusätzliche Informationen, die Sie benötigen, um sich mithilfe der Flow Service-API erfolgreich mit Salesforce Marketing Cloud verbinden zu können.
Sammeln erforderlicher Anmeldedaten
Informationen zur Authentifizierung Salesforce Marketing Cloud Sie inAuthentifizierungsübersicht“.
Verwenden von Experience Platform-APIs
Lesen Sie das Handbuch Erste Schritte mit Experience Platform-APIs um Informationen darüber zu erhalten, wie Sie Experience Platform-APIs erfolgreich aufrufen können.
Verbinden von Salesforce Marketing Cloud mit Experience Platform auf Azure
Lesen Sie das Folgende, um zu erfahren, wie Sie eine Basisverbindung erstellen und Ihr Salesforce Marketing Cloud-Konto mit Experience Platform on Azure verbinden.
Erstellen einer Basisverbindung
Eine Basisverbindung speichert wichtige Informationen, die Ihr Quellsystem mit Adobe Experience Platform verknüpfen. Dazu gehören:
- Authentifizierungsdaten Ihrer Quelle
- Der aktuelle Status der Verbindung
- Eine eindeutige Basisverbindungs-ID
Mit Basisverbindungs-ID können Sie Dateien aus Ihrer Quelle durchsuchen und untersuchen, um zu ermitteln, welche Elemente zusammen mit ihren Datentypen und Formaten aufgenommen werden sollen.
Um eine Basisverbindungs-ID zu erstellen, senden Sie eine POST-Anfrage an den /connections
-Endpunkt, einschließlich Ihrer Salesforce Marketing Cloud Authentifizierungsdaten in den Anfrageparametern.
API-Format
POST /connections
Anfrage
Die folgende Anfrage erstellt eine Basisverbindung für 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"
}
}'
auth.params.host
auth.params.clientId
auth.params.clientSecret
connectionSpec.id
ea1c2a08-b722-11eb-8529-0242ac130003
.Antwort
Eine erfolgreiche Antwort gibt Details zur neu erstellten Basisverbindung zurück, einschließlich ihrer eindeutigen Kennung (id
).
{
"id": "2fce94c1-9a93-4971-8e94-c19a93097129",
"etag": "\"d403848a-0000-0200-0000-5e978f7b0000\""
}
Verbinden von Salesforce Marketing Cloud mit Experience Platform auf Amazon Web Services
Lesen Sie die folgenden Schritte, um Informationen zum Verbinden Ihres Salesforce Marketing Cloud-Kontos mit Experience Platform auf AWS zu erhalten.
Erstellen einer Basisverbindung
API-Format
POST /connections
Anfrage
Die folgende Anfrage erstellt eine Basisverbindung für Salesforce Service Cloud, um eine Verbindung zu Experience Platform auf AWS herzustellen.
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"
}
}'
Antwort
Eine erfolgreiche Antwort gibt Details zur neu erstellten Basisverbindung zurück, einschließlich ihrer eindeutigen Kennung (id
).
{
"id": "2fce94c1-9a93-4971-8e94-c19a93097129",
"etag": "\"d403848a-0000-0200-0000-5e978f7b0000\""
}
Erstellen eines Datenflusses für Salesforce Marketing Cloud Daten
Nachdem Sie Ihr Salesforce Marketing Cloud-Konto erfolgreich verbunden haben, können Sie jetzt einen Datenfluss erstellen und Daten von Ihrem Marketing-Automatisierungsanbieter in Experience Platform.