Référence du connecteur Salesforce Marketing Cloud

info

Bêta

Cette fonctionnalité est en Bêta. Les administrateurs du Workspace peuvent contrôler l'accès à cette fonctionnalité à partir de la page Previews . Consultez Gérer les aperçus Databricks.

Cette page fournit des informations de référence techniques pour le connecteur Salesforce Marketing Cloud.

Objets pris en charge

Le connecteur Salesforce Marketing Cloud prend en charge les tables par default suivantes (lorsque source_schema est défini sur default) :

Nom de la table	Type de mise à jour
journeys	Incrémentiel
campaigns	Incrémentiel
emails	Incrémentiel
automations	Batch (non incrémentiel)
push_messages	Incrémentiel
subscribers	Batch (non incrémentiel)
audit_events	Incrémentiel
security_events	Incrémentiel
click_events	Incrémentiel
sent_events	Incrémentiel
open_events	Incrémentiel
not_sent_events	Incrémentiel
bounce_events	Incrémentiel
unsubscribe_events	Incrémentiel

Nom de la table	Type de mise à jour
journeys	Incrémentiel
campaigns	Incrémentiel
emails	Incrémentiel
automations	Batch (non incrémentiel)
push_messages	Incrémentiel
subscribers	Batch (non incrémentiel)
audit_events	Incrémentiel
security_events	Incrémentiel
click_events	Incrémentiel
sent_events	Incrémentiel
open_events	Incrémentiel
not_sent_events	Incrémentiel
bounce_events	Incrémentiel
unsubscribe_events	Incrémentiel

Pour les extensions de données, vous devez fournir la clé externe (clé client) comme nom source_table. Les extensions de données sont uniquement par batch (non incrémentielles).

Transformations automatiques des types de données

Le connecteur convertit les types de données de Salesforce Marketing Cloud dans les extensions de données en types de données compatibles Delta comme suit :

Type Salesforce Marketing Cloud	Type Delta
Texte	chaîne
E-mail	chaîne
Adresse e-mail	chaîne
Téléphone	chaîne
Locale	chaîne
Nombre	entier
LongNumber	long
Décimal(p, s)	decimal(min(p, 38), min(s, 18))
Booléen	booléen
Date	timestamp_ntz
Octet	octet

Type Salesforce Marketing Cloud	Type Delta
Texte	chaîne
E-mail	chaîne
Adresse e-mail	chaîne
Téléphone	chaîne
Locale	chaîne
Nombre	entier
LongNumber	long
Décimal(p, s)	decimal(min(p, 38), min(s, 18))
Booléen	booléen
Date	timestamp_ntz
Octet	octet

remarque

Les APIs Marketing Cloud ne fournissent pas d'informations sur le fuseau horaire des Timestamp. Par conséquent, le connecteur stocke les Timestamp sans fuseau horaire (TimestampNTZ).

Champs d'authentification requis

Lorsque vous créez une connexion Unity Catalog pour Salesforce Marketing Cloud, fournissez les parameters suivants :

Champ	Description
Sous-domaine	Le sous-domaine de 28 caractères de votre instance Marketing Cloud, commençant par mc de l'URI de base d'authentification (par exemple, mc1234abcdzz9t0k5l7m8n9p0q)
ID marketing (MID)	L'ID Marketing de votre compte professionnel, visible dans le coin supérieur droit de l'interface Salesforce Marketing Cloud
ID client	L'ID client du package d'intégration API
Secret du client	Le secret client du package d'intégration d'API

Champ	Description
Sous-domaine	Le sous-domaine de 28 caractères de votre instance Marketing Cloud, commençant par mc de l'URI de base d'authentification (par exemple, mc1234abcdzz9t0k5l7m8n9p0q)
ID marketing (MID)	L'ID Marketing de votre compte professionnel, visible dans le coin supérieur droit de l'interface Salesforce Marketing Cloud
ID client	L'ID client du package d'intégration API
Secret du client	Le secret client du package d'intégration d'API

Schémas pour les tables default

Pour les schémas détaillés de toutes les tables par default prises en charge (y compris les noms de champs et les types de données), consultez les sections suivantes :

parcours

Clé primaire composite : (id, version).

Champ	Type de données
ID	chaîne
Version	entier
Clé	chaîne
Nom	chaîne
lastPublishedDate	Horodatage
Statut	chaîne
Description	chaîne
date de création	Horodatage
Date de modification	Horodatage
workflowApiVersion	entier
activités	array<struct>
Trigger	array<struct>
Objectifs	array<string>
quitte	array<string>
notificateurs	array<string>
statistiques	structure
healthStatus	structure
entryMode	chaîne
definitionType	chaîne
Canal	chaîne
default	structure
métadonnées	chaîne
executionMode	chaîne
categoryId	entier
definitionId	chaîne
scheduledStatus	chaîne
campagnes	array<string>

Champ	Type de données
ID	chaîne
Version	entier
Clé	chaîne
Nom	chaîne
lastPublishedDate	Horodatage
Statut	chaîne
Description	chaîne
date de création	Horodatage
Date de modification	Horodatage
workflowApiVersion	entier
activités	array<struct>
Trigger	array<struct>
Objectifs	array<string>
quitte	array<string>
notificateurs	array<string>
statistiques	structure
healthStatus	structure
entryMode	chaîne
definitionType	chaîne
Canal	chaîne
default	structure
métadonnées	chaîne
executionMode	chaîne
categoryId	entier
definitionId	chaîne
scheduledStatus	chaîne
campagnes	array<string>

Campagnes

Champ	Type de données
ID	chaîne
date de création	Horodatage
Date de modification	Horodatage
Nom	chaîne
Description	chaîne
campaignCode	chaîne
couleur	chaîne
favori	booléen

Champ	Type de données
ID	chaîne
date de création	Horodatage
Date de modification	Horodatage
Nom	chaîne
Description	chaîne
campaignCode	chaîne
couleur	chaîne
favori	booléen

e-mail

Champ	Type de données
ID	long
customerKey	chaîne
objectID	chaîne
type de contenu	chaîne
assetTypeId	entier
assetTypeName	chaîne
Nom d'affichage du type d'actif	chaîne
Nom	chaîne
Propriétaire	structure
Créé par	structure
date de création	Horodatage
modifié par	structure
Date de modification	Horodatage
enterpriseId	long
Statut	chaîne
thumbnailUrl	chaîne
contenu	chaîne
Contenu de pré-en-tête	chaîne
subjectlineViewContent	chaîne
htmlViewContent	chaîne
Encodage de caractères	chaîne

Champ	Type de données
ID	long
customerKey	chaîne
objectID	chaîne
type de contenu	chaîne
assetTypeId	entier
assetTypeName	chaîne
Nom d'affichage du type d'actif	chaîne
Nom	chaîne
Propriétaire	structure
Créé par	structure
date de création	Horodatage
modifié par	structure
Date de modification	Horodatage
enterpriseId	long
Statut	chaîne
thumbnailUrl	chaîne
contenu	chaîne
Contenu de pré-en-tête	chaîne
subjectlineViewContent	chaîne
htmlViewContent	chaîne
Encodage de caractères	chaîne

automatisations

Clé primaire composite : (id, view).

La colonne view est une colonne synthétique ajoutée par le connecteur. Il distingue les types d'enregistrements au sein de la même entrée d'automatisation (normal vs. targetdes).

Champ	Type de données
ID	chaîne
Afficher	chaîne
Clé	chaîne
Nom	chaîne
Description	chaîne
categoryId	entier
Type	chaîne
ID de type	entier
Statut	chaîne
ID de statut	entier
Planification	struct<typeId: integer, startDate: timestamp_ntz, endDate: timestamp_ntz, scheduledTime: timestamp_ntz>
lastRunTime	timestamp_ntz
lastRunInstanceId	chaîne
automationTrigger	structure
fileTrigger	structure
targetDataExtensions	array<struct>

Champ	Type de données
ID	chaîne
Afficher	chaîne
Clé	chaîne
Nom	chaîne
Description	chaîne
categoryId	entier
Type	chaîne
ID de type	entier
Statut	chaîne
ID de statut	entier
Planification	struct<typeId: integer, startDate: timestamp_ntz, endDate: timestamp_ntz, scheduledTime: timestamp_ntz>
lastRunTime	timestamp_ntz
lastRunInstanceId	chaîne
automationTrigger	structure
fileTrigger	structure
targetDataExtensions	array<struct>

Tables d'événements

Toutes les tables d'événements (click_events, sent_events, open_events, bounce_events, unsubscribe_events, not_sent_events) partagent des schémas similaires avec les champs suivants :

• ID de lot (entier)
• Date de l'événement (Timestamp)
• SendID (entier)
• SubscriberKey (Chaîne)
• TriggeredSendDefinitionObjectID (string)

Les champs supplémentaires varient en fonction du type d’événement. Pour les schémas complets, reportez-vous à la documentation de l'API Salesforce Marketing Cloud.