Concepts du connecteur Salesforce Marketing Cloud
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.
Découvrez comment fonctionne le connecteur Salesforce Marketing Cloud.
Fonctionnement du connecteur
Le connecteur Salesforce Marketing Cloud utilise l’authentification OAuth de serveur à serveur pour se connecter à l’API Marketing Cloud. Après avoir créé une connexion Unity Catalog et configuré un pipeline d'ingestion, le connecteur récupère les données de Salesforce Marketing Cloud et les écrit dans les tables Delta d'Unity Catalog.
Le connecteur prend en charge l'ingestion incrémentielle pour de nombreuses tables et les mises à jour par batch pour d'autres. Pour les tables avec support incrémentiel, le connecteur suit les modifications et ne récupère que les enregistrements nouveaux ou modifiés lors des exécutions de pipeline ultérieures. Pour les tables en mode batch uniquement, le connecteur effectue un refresh complet à chaque mise à jour du pipeline.
Schémas source
Le connecteur Salesforce Marketing Cloud utilise le paramètre source_schema pour faire la distinction entre les différents types de données. Vous pouvez lister plusieurs tables avec différents schémas sources dans le même pipeline.
Le tableau suivant décrit les valeurs de schéma source disponibles :
Schéma source | Description |
|---|---|
| Ingérer des tables principales telles que Campagnes, Clics, Parcours et d'autres objets Marketing Cloud intégrés |
| Ingérer des extensions de données standard qui stockent des données d'abonné, des segments et des données relationnelles |
| Ingérer les extensions de données standard partagées d'une unité commerciale à une autre |
| Ingérez les extensions de données synchronisées automatiquement de Salesforce CRM dans Marketing Cloud (contacts, prospects, etc.) |
| Ingérer les extensions de données créées par les intégrations Salesforce (événements de données Salesforce, objets Salesforce) |
| Ingérer les extensions de données Salesforce partagées entre les unités commerciales |
Remarque : Databricks recommande d'ingérer les extensions de données Salesforce et Salesforce partagées à l'aide du connecteur Lakeflow Connect Salesforce. Le connecteur Salesforce Marketing Cloud ne peut pas ingérer ces extensions de données de manière incrémentielle, mais le connecteur Salesforce le peut.
Extensions de données
Les extensions de données sont des tables dans Salesforce Marketing Cloud qui stockent les données d'abonnés, de segments et relationnelles. Le connecteur prend en charge l'ingestion de plusieurs types d'extensions de données :
- Extensions de données standard : tables personnalisées pour le stockage des données marketing
- Extensions de données partagées : extensions de données partagées entre les unités commerciales
- Extensions de données synchronisées : tables automatiquement synchronisées depuis Salesforce CRM
- **Extensions de données Salesforce** : tables créées par des intégrations Salesforce
Lors de l'ingestion d'extensions de données, vous devez fournir la clé externe (clé client) en tant que nom source_table. L'utilisation du nom d'affichage au lieu de la clé externe entraînera l'échec du pipeline.
Clés principales et suivi de l'historique
Si une clé primaire est définie sur l'extension de données source, le connecteur utilise cette clé pendant l'ingestion. Si aucune clé primaire n'est définie, le connecteur ajoute automatiquement une colonne appelée __databricks_id, qui est un hachage de toutes les colonnes et est utilisée comme clé primaire.
Lorsque __databricks_id est utilisé, le suivi de l'historique (SCD de type 2) n'est pas pris en charge pour cette table. Si la table est configurée pour l'ingestion en mode SCD de type 2, l'ingestion échouera.
Dénomination des tables de destination
Si vous ne fournissez pas de nom de destination_table, le connecteur nomme automatiquement les tables en fonction du source_schema:
Schéma source | Default destination table name |
|---|---|
| Identique au nom de la table source |
|
|
|
|
|
|
|
|
|
|
**Note** : Databricks normalise automatiquement les noms d'affichage des extensions de données, en remplaçant les espaces et les tirets par des tirets bas pour la compatibilité Delta.
Par exemple, la table de destination contenant les données de l'extension de données standard avec le nom d'affichage src_de_c6035790 sera nommée de_src_de_c6035790, à moins que vous ne fournissiez un nom destination_table différent.
Unités commerciales
L'API Marketing cloud renvoie des données pour une seule unité commerciale, y compris les unités commerciales enfants. Si vous avez plusieurs unités commerciales, vous devez créer des connexions Unity Catalog distinctes et configurer des packages d'intégration d'API distincts pour chacun d'eux.