Référence du connecteur Marketo

info

Bêta

Cette fonctionnalité est en version bêta. Les administrateurs de Workspace peuvent contrôler l’accès à cette fonctionnalité depuis la page Aperçus . Consultez Gérer les aperçus Databricks.

Trouvez des informations de référence sur le connecteur Marketo, notamment les tables prises en charge, les options de connecteur et les schémas de destination.

Tables sources prises en charge

Le connecteur Marketo prend en charge les tables sources suivantes :

Table source	Clé primaire	Description	Mode de synchronisation	Champ de curseur
leads	id	Enregistrements de personnes dans votre instance Adobe Marketo Engage, incluant les champs d’identité, démographiques et de scoring de leads. Ingéré via l’API Bulk Extract.	Incrémentiel	updatedAt
static_lists	id	Listes statiques utilisées pour le ciblage et la segmentation d’audience. Ingéré via l’API REST.	Full refresh uniquement
activity_<typeId>	marketoGUID	Une table par type d'activité Adobe Marketo Engage, où <typeId> est l'ID numérique du type d'activité (par exemple, activity_1). Chaque table partage un ensemble de colonnes fixes et ajoute des colonnes d'attributs spécifiques au type. Ingéré via l'API Bulk Extract.	Incrémentiel	activityDate
<customObjectApiName>	marketoGUID	Une table par objet personnalisé, nommée selon son nom d'API Adobe Marketo Engage. Le schéma est découvert au moment de l'exécution. Ingéré via l'API Bulk Extract.	Incrémentiel	updatedAt

Table source	Clé primaire	Description	Mode de synchronisation	Champ de curseur
leads	id	Enregistrements de personnes dans votre instance Adobe Marketo Engage, incluant les champs d’identité, démographiques et de scoring de leads. Ingéré via l’API Bulk Extract.	Incrémentiel	updatedAt
static_lists	id	Listes statiques utilisées pour le ciblage et la segmentation d’audience. Ingéré via l’API REST.	Full refresh uniquement
activity_<typeId>	marketoGUID	Une table par type d'activité Adobe Marketo Engage, où <typeId> est l'ID numérique du type d'activité (par exemple, activity_1). Chaque table partage un ensemble de colonnes fixes et ajoute des colonnes d'attributs spécifiques au type. Ingéré via l'API Bulk Extract.	Incrémentiel	activityDate
<customObjectApiName>	marketoGUID	Une table par objet personnalisé, nommée selon son nom d'API Adobe Marketo Engage. Le schéma est découvert au moment de l'exécution. Ingéré via l'API Bulk Extract.	Incrémentiel	updatedAt

Options du connecteur

Définissez l'option suivante sur un objet de table dans votre définition de pipeline. Voir Définir la date de start de la synchronisation initiale.

Option

Description

sync_start_date

La date de start de la synchronisation initiale, au format YYYY-MM-DD. Il s'agit de la date la plus ancienne à partir de laquelle synchroniser les données historiques. Si vous ne le définissez pas, le connecteur ingère deux ans d’historique par « default ». Cette option s’applique uniquement au remplissage initial : après la première synchronisation d’une table, sa modification n’a aucun effet, sauf si vous exécutez un refresh complet.

Option

Description

sync_start_date

La date de start de la synchronisation initiale, au format YYYY-MM-DD. Il s'agit de la date la plus ancienne à partir de laquelle synchroniser les données historiques. Si vous ne le définissez pas, le connecteur ingère deux ans d’historique par « default ». Cette option s’applique uniquement au remplissage initial : après la première synchronisation d’une table, sa modification n’a aucun effet, sauf si vous exécutez un refresh complet.

Schémas de table de destination

leads

Clé principale : id Champ de curseur : updatedAt

Champ	Type de données
id	STRING
firstName	STRING
lastName	STRING
email	STRING
leadScore	BIGINT
unsubscribed	BOOLEAN
leadSource	STRING
company	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP

Champ	Type de données
id	STRING
firstName	STRING
lastName	STRING
email	STRING
leadScore	BIGINT
unsubscribed	BOOLEAN
leadSource	STRING
company	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP

static_lists

Clé principale : id Mode de synchronisation : Full refresh uniquement

Champ	Type de données
id	BIGINT
name	STRING
description	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
programName	STRING
workspaceName	STRING

Champ	Type de données
id	BIGINT
name	STRING
description	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
programName	STRING
workspaceName	STRING

activity_<typeId>

Clé principale : marketoGUID Champ de curseur : activityDate

Chaque table d'activité inclut les colonnes fixes suivantes :

Champ	Type de données
marketoGUID	STRING
leadId	STRING
activityDate	TIMESTAMP
activityTypeId	STRING
campaignId	STRING
primaryAttributeValueId	STRING
primaryAttributeValue	STRING

Champ	Type de données
marketoGUID	STRING
leadId	STRING
activityDate	TIMESTAMP
activityTypeId	STRING
campaignId	STRING
primaryAttributeValueId	STRING
primaryAttributeValue	STRING

Chaque table d’activité ajoute également une colonne par attribut défini pour ce type d’activité dans Adobe Marketo Engage. Le connecteur découvre ces attributs à partir des métadonnées d’Adobe Marketo Engage, conserve leurs noms d’origine et mappe leurs types à l’aide du mappage des types de données Adobe Marketo Engage vers les types Spark.

<customObjectApiName>

Clé principale : marketoGUID Champ de curseur : updatedAt

Les schémas d’objets personnalisés sont découverts au moment de l’exécution depuis Adobe Marketo Engage et varient selon l’instance. Chaque table d’objets personnalisés inclut marketoGUID, createdAt et updatedAt, suivis des champs spécifiques à l’objet définis dans votre abonnement. Les types de champs suivent le mappage des types de données Adobe Marketo Engage vers les types Spark.

Mappage des types de données Adobe Marketo Engage vers les types Spark

Le connecteur mappe les types de données Adobe Marketo Engage vers les types Spark pour toutes les colonnes découvertes au moment de l’exécution, telles que les attributs d’activité et les champs d’objets personnalisés. La correspondance ne fait pas la distinction entre majuscules et minuscules.

Type de données Adobe Marketo Engage	Type Spark
integer	BIGINT
string, text, email, url, phone, reference	STRING
float	DOUBLE
currency	DECIMAL(38, 4)
boolean	BOOLEAN
date	DATE
datetime	TIMESTAMP
array, email_list	ARRAY<STRING>
Tout autre type	STRING

Type de données Adobe Marketo Engage	Type Spark
integer	BIGINT
string, text, email, url, phone, reference	STRING
float	DOUBLE
currency	DECIMAL(38, 4)
boolean	BOOLEAN
date	DATE
datetime	TIMESTAMP
array, email_list	ARRAY<STRING>
Tout autre type	STRING