Référence du connecteur LinkedIn Ads

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.

Cette page fournit des informations de référence pour le connecteur LinkedIn Ads géré dans Lakeflow Connect, notamment les tables prises en charge, les définitions de colonnes et les types de données.

Tables prises en charge

Le connecteur LinkedIn Ads prend en charge douze tables réparties en deux catégories :

• Tables d'entités : données de configuration concernant vos comptes publicitaires, telles que les campagnes et les créations. Ces tables sont entièrement actualisées à chaque mise à jour du pipeline.
• Tableaux de rapports préconstruits : indicateurs de performance et démographiques issus du adAnalytics endpoint de LinkedIn. Ces tables supportent l’ingestion progressive.

Chaque table réside soit dans l'espace de noms default, soit dans un espace de noms par compte nommé d'après l'ID du compte publicitaire sponsorisé. Voir Espaces de noms source.

Tables d'entités

Nom de la table	Espace de noms	Clé primaire	Description
account_history	default	id	Comptes publicitaires sponsorisés que le jeton d’autorisation peut atteindre.
campaign_group_history	Par compte	id	Groupes de campagne, y compris la définition du budget et des objectifs.
campaign_history	Par compte	id	Campagnes, y compris les critères de ciblage, les budgets et le calendrier d’exécution.
creative_history	Par compte	id	Créations, incluant le contenu et le statut de révision.
account_user_history	Par compte	account, user	Rôles par utilisateur sur le compte publicitaire.

Nom de la table	Espace de noms	Clé primaire	Description
account_history	default	id	Comptes publicitaires sponsorisés que le jeton d’autorisation peut atteindre.
campaign_group_history	Par compte	id	Groupes de campagne, y compris la définition du budget et des objectifs.
campaign_history	Par compte	id	Campagnes, y compris les critères de ciblage, les budgets et le calendrier d’exécution.
creative_history	Par compte	id	Créations, incluant le contenu et le statut de révision.
account_user_history	Par compte	account, user	Rôles par utilisateur sur le compte publicitaire.

Tables de rapports prédéfinies

Les sept rapports sont par compte et soutiennent l’ingestion progressive.

Nom de la table	Granularité	Clé primaire	Tableau croisé dynamique
ad_analytics_by_campaign_report	Quotidien	campaign_id, day	CAMPAIGN
ad_analytics_by_creative_report	Quotidien	creative_id, day	CREATIVE
monthly_ad_analytics_by_member_company_size_report	Mensuel	campaign_id, member_company_size, month	MEMBER_COMPANY_SIZE
monthly_ad_analytics_by_member_country_report	Mensuel	campaign_id, member_country, month	MEMBER_COUNTRY_V2
monthly_ad_analytics_by_member_industry_report	Mensuel	campaign_id, member_industry, month	MEMBER_INDUSTRY
monthly_ad_analytics_by_member_job_function_report	Mensuel	campaign_id, member_job_function, month	MEMBER_JOB_FUNCTION
monthly_ad_analytics_by_member_seniority_report	Mensuel	campaign_id, member_seniority, month	MEMBER_SENIORITY

Nom de la table	Granularité	Clé primaire	Tableau croisé dynamique
ad_analytics_by_campaign_report	Quotidien	campaign_id, day	CAMPAIGN
ad_analytics_by_creative_report	Quotidien	creative_id, day	CREATIVE
monthly_ad_analytics_by_member_company_size_report	Mensuel	campaign_id, member_company_size, month	MEMBER_COMPANY_SIZE
monthly_ad_analytics_by_member_country_report	Mensuel	campaign_id, member_country, month	MEMBER_COUNTRY_V2
monthly_ad_analytics_by_member_industry_report	Mensuel	campaign_id, member_industry, month	MEMBER_INDUSTRY
monthly_ad_analytics_by_member_job_function_report	Mensuel	campaign_id, member_job_function, month	MEMBER_JOB_FUNCTION
monthly_ad_analytics_by_member_seniority_report	Mensuel	campaign_id, member_seniority, month	MEMBER_SENIORITY

Conventions de type de données

Les conventions suivantes s’appliquent à toutes les tables de destination :

• Toutes les colonnes acceptent les valeurs nulles, à l’exception des colonnes de clé primaire.
• createdAt et lastModifiedAt sont les audit Timestamp de LinkedIn, ingérés sous forme de valeurs de long millisecondes d’époque plutôt que comme Timestamp.
• targetingCriteria, content et inlineContent sont ingérés en tant que colonnes variant. Le connecteur active la fonctionnalité de table Variant de Delta sur les tables qui les contiennent.
• Les colonnes d’argent sont decimal et sont libellées dans la monnaie nommée par la colonne. Par exemple, cost_in_usd est en dollars américains et cost_in_local_currency est dans la monnaie du compte publicitaire.

Schémas de tables d’entités

account_history

Colonne	Type Spark
id	long (clé principale)
name	string
currency	string
type	string
status	string
reference	string
servingStatuses	array<string>
notifiedOnCampaignOptimization	boolean
notifiedOnCreativeApproval	boolean
notifiedOnCreativeRejection	boolean
notifiedOnEndOfCampaign	boolean
notifiedOnNewFeaturesEnabled	boolean
test	boolean
version	struct<versionTag: string>
createdAt	long
lastModifiedAt	long

Colonne	Type Spark
id	long (clé principale)
name	string
currency	string
type	string
status	string
reference	string
servingStatuses	array<string>
notifiedOnCampaignOptimization	boolean
notifiedOnCreativeApproval	boolean
notifiedOnCreativeRejection	boolean
notifiedOnEndOfCampaign	boolean
notifiedOnNewFeaturesEnabled	boolean
test	boolean
version	struct<versionTag: string>
createdAt	long
lastModifiedAt	long

campaign_group_history

Colonne	Type Spark
id	long (clé principale)
account	string
name	string
status	string
objectiveType	string
allowedCampaignTypes	array<string>
servingStatuses	array<string>
runSchedule	struct<start: long, end: long>
totalBudget	struct<amount: decimal(19,2), currencyCode: string>
dailyBudget	decimal(19,2)
budgetOptimization	struct<bidStrategy: string, budgetOptimizationStrategy: string>
backfilled	boolean
test	boolean
createdAt	long
lastModifiedAt	long

Colonne	Type Spark
id	long (clé principale)
account	string
name	string
status	string
objectiveType	string
allowedCampaignTypes	array<string>
servingStatuses	array<string>
runSchedule	struct<start: long, end: long>
totalBudget	struct<amount: decimal(19,2), currencyCode: string>
dailyBudget	decimal(19,2)
budgetOptimization	struct<bidStrategy: string, budgetOptimizationStrategy: string>
backfilled	boolean
test	boolean
createdAt	long
lastModifiedAt	long

remarque

Sur cette table, dailyBudget est un decimal(19,2) nu plutôt qu’une structure monétaire. Sur campaign_history, le même nom de colonne est un struct<amount, currencyCode>. Cette asymétrie reflète la forme que l’API LinkedIn renvoie pour chaque ressource.

campaign_history

Colonne	Type Spark
id	long (clé principale)
account	string
campaignGroup	string
associatedEntity	string
name	string
type	string
status	string
costType	string
format	string
objectiveType	string
optimizationTargetType	string
creativeSelection	string
pacingStrategy	string
politicalIntent	string
audienceExpansionEnabled	boolean
offsiteDeliveryEnabled	boolean
connectedTelevisionOnly	boolean
test	boolean
servingStatuses	array<string>
locale	struct<country: string, language: string>
offsitePreferences	struct<iabCategories: array<string>, publisherRestrictionFiles: array<string>>
runSchedule	struct<start: long, end: long>
dailyBudget	struct<amount: decimal(19,2), currencyCode: string>
totalBudget	struct<amount: decimal(19,2), currencyCode: string>
unitCost	struct<amount: decimal(19,2), currencyCode: string>
targetingCriteria	variant
version	struct<versionTag: string>
createdAt	long
lastModifiedAt	long

Colonne	Type Spark
id	long (clé principale)
account	string
campaignGroup	string
associatedEntity	string
name	string
type	string
status	string
costType	string
format	string
objectiveType	string
optimizationTargetType	string
creativeSelection	string
pacingStrategy	string
politicalIntent	string
audienceExpansionEnabled	boolean
offsiteDeliveryEnabled	boolean
connectedTelevisionOnly	boolean
test	boolean
servingStatuses	array<string>
locale	struct<country: string, language: string>
offsitePreferences	struct<iabCategories: array<string>, publisherRestrictionFiles: array<string>>
runSchedule	struct<start: long, end: long>
dailyBudget	struct<amount: decimal(19,2), currencyCode: string>
totalBudget	struct<amount: decimal(19,2), currencyCode: string>
unitCost	struct<amount: decimal(19,2), currencyCode: string>
targetingCriteria	variant
version	struct<versionTag: string>
createdAt	long
lastModifiedAt	long

creative_history

Colonne	Type Spark
id	string (clé principale)
account	string
campaign	string
name	string
intendedStatus	string
isServing	boolean
isTest	boolean
servingHoldReasons	array<string>
content	variant
inlineContent	variant
review	struct<status: string, rejectionReasons: array<string>>
leadgenCallToAction	struct<destination: string, label: string>
createdBy	string
lastModifiedBy	string
createdAt	long
lastModifiedAt	long

Colonne	Type Spark
id	string (clé principale)
account	string
campaign	string
name	string
intendedStatus	string
isServing	boolean
isTest	boolean
servingHoldReasons	array<string>
content	variant
inlineContent	variant
review	struct<status: string, rejectionReasons: array<string>>
leadgenCallToAction	struct<destination: string, label: string>
createdBy	string
lastModifiedBy	string
createdAt	long
lastModifiedAt	long

account_user_history

Colonne	Type Spark
account	string (clé principale)
user	string (clé principale)
role	string
createdAt	long
lastModifiedAt	long

Colonne	Type Spark
account	string (clé principale)
user	string (clé principale)
role	string
createdAt	long
lastModifiedAt	long

Signaler les schémas de table

Chaque rapport contient les 114 mêmes colonnes de métriques ainsi que ses propres colonnes clés principales. Les colonnes de métriques sont toutes nullables, car LinkedIn omet les lignes composées uniquement de zéros et laisse les métriques absentes à NULL.

Les sept rapports comportent une colonne _sync_timestamp, qui fait partie du curseur de chaque rapport. LinkedIn révise les indicateurs d'une période sur place à mesure que les conversions tardives arrivent, de sorte qu'une ligne récupérée à nouveau conserve le même day ou month. Sans valeur d'accompagnement strictement croissante, le MERGE de destination traiterait la révision comme inchangée et l'ignorerait. Le Timestamp avance à chaque mise à jour, donc la version la plus récente l'emporte toujours.

Rapports quotidiens

Chaque rapport quotidien contient exactement une colonne d'entité, nommée d'après la dimension sur laquelle il pivote.

Colonne	Type Spark	Notes
Colonne entité	long (clé principale)	La valeur pivot. Voir la table suivante.
day	string (clé principale)	Date ISO, yyyy-MM-dd.
_sync_timestamp	timestamp	Généré par le connecteur à chaque mise à jour.
114 colonnes de métriques	long, decimal, ou double

Colonne	Type Spark	Notes
Colonne entité	long (clé principale)	La valeur pivot. Voir la table suivante.
day	string (clé principale)	Date ISO, yyyy-MM-dd.
_sync_timestamp	timestamp	Généré par le connecteur à chaque mise à jour.
114 colonnes de métriques	long, decimal, ou double

Rapport	Colonne entité	Type Spark	Formulaire de valeur
ad_analytics_by_campaign_report	campaign_id	long	Identification nue de l’URN pivot.
ad_analytics_by_creative_report	creative_id	long	Identification nue de l’URN pivot.

Rapport	Colonne entité	Type Spark	Formulaire de valeur
ad_analytics_by_campaign_report	campaign_id	long	Identification nue de l’URN pivot.
ad_analytics_by_creative_report	creative_id	long	Identification nue de l’URN pivot.

Rapports mensuels sur les données démographiques des membres

Chaque rapport démographique comporte exactement une colonne membre, nommée d’après la dimension sur laquelle il pivote.

Colonne	Type Spark	Notes
campaign_id	long (clé principale)	Attribué à partir de la campagne que le connecteur a interrogée.
Colonne de dimension de l’élément	long ou string (clé principale)	La valeur pivot. Voir la table suivante.
month	string (clé principale)	Année et mois complétés par des zéros, yyyy-MM.
_sync_timestamp	timestamp	Généré par le connecteur à chaque mise à jour.
114 colonnes de métriques	long, decimal, ou double

Colonne	Type Spark	Notes
campaign_id	long (clé principale)	Attribué à partir de la campagne que le connecteur a interrogée.
Colonne de dimension de l’élément	long ou string (clé principale)	La valeur pivot. Voir la table suivante.
month	string (clé principale)	Année et mois complétés par des zéros, yyyy-MM.
_sync_timestamp	timestamp	Généré par le connecteur à chaque mise à jour.
114 colonnes de métriques	long, decimal, ou double

Rapport	Colonne membre	Type Spark	Formulaire de valeur
monthly_ad_analytics_by_member_company_size_report	member_company_size	string	Enum littéral, comme SIZE_11_TO_50.
monthly_ad_analytics_by_member_country_report	member_country	long	Identification nue de l’URN pivot.
monthly_ad_analytics_by_member_industry_report	member_industry	long	Identification nue de l’URN pivot.
monthly_ad_analytics_by_member_job_function_report	member_job_function	long	Identification nue de l’URN pivot.
monthly_ad_analytics_by_member_seniority_report	member_seniority	long	Identification nue de l’URN pivot.

Rapport	Colonne membre	Type Spark	Formulaire de valeur
monthly_ad_analytics_by_member_company_size_report	member_company_size	string	Enum littéral, comme SIZE_11_TO_50.
monthly_ad_analytics_by_member_country_report	member_country	long	Identification nue de l’URN pivot.
monthly_ad_analytics_by_member_industry_report	member_industry	long	Identification nue de l’URN pivot.
monthly_ad_analytics_by_member_job_function_report	member_job_function	long	Identification nue de l’URN pivot.
monthly_ad_analytics_by_member_seniority_report	member_seniority	long	Identification nue de l’URN pivot.

Colonnes de métriques

Les sept rapports correspondent au même ensemble de métriques. Les noms de colonnes sont snake_case des renommages des noms de la métrique Camel Case de LinkedIn. Par exemple, costInLocalCurrency devient cost_in_local_currency. Le tableau suivant regroupe les métriques par thème :

Groupe	Exemples de colonnes
Performances principales	impressions, clicks, cost_in_local_currency, cost_in_usd, approximate_member_reach, audience_penetration
Engagement	likes, comments, shares, reactions, follows, total_engagements, other_engagements, comment_likes
Clics par surface	landing_page_clicks, company_page_clicks, text_url_clicks, headline_clicks, card_clicks, ad_unit_clicks, action_clicks, download_clicks, subscription_clicks
Vidéo	video_views, video_starts, video_completions, video_first_quartile_completions, video_midpoint_completions, video_third_quartile_completions, video_watch_time, average_video_watch_time
Événements	event_views, event_views_over_15_seconds, event_views_over_30_seconds, event_views_over_2_minutes, event_watch_time, cost_per_event_view
Documents	document_completions, document_first_quartile_completions, document_midpoint_completions, document_third_quartile_completions
Leads, inscriptions et jobs	one_click_leads, one_click_lead_form_opens, qualified_leads, cost_per_qualified_lead, valid_work_email_leads, talent_leads, registrations, post_click_registrations, post_view_registrations, post_click_job_applications, post_view_job_apply_clicks
Conversions	external_website_conversions, conversion_value_in_local_currency
Viral	Chaque équivalent préfixé par viral_des métriques ci-dessus, tel que viral_impressions, viral_clicks, viral_likes, viral_video_views et viral_one_click_leads

Groupe	Exemples de colonnes
Performances principales	impressions, clicks, cost_in_local_currency, cost_in_usd, approximate_member_reach, audience_penetration
Engagement	likes, comments, shares, reactions, follows, total_engagements, other_engagements, comment_likes
Clics par surface	landing_page_clicks, company_page_clicks, text_url_clicks, headline_clicks, card_clicks, ad_unit_clicks, action_clicks, download_clicks, subscription_clicks
Vidéo	video_views, video_starts, video_completions, video_first_quartile_completions, video_midpoint_completions, video_third_quartile_completions, video_watch_time, average_video_watch_time
Événements	event_views, event_views_over_15_seconds, event_views_over_30_seconds, event_views_over_2_minutes, event_watch_time, cost_per_event_view
Documents	document_completions, document_first_quartile_completions, document_midpoint_completions, document_third_quartile_completions
Leads, inscriptions et jobs	one_click_leads, one_click_lead_form_opens, qualified_leads, cost_per_qualified_lead, valid_work_email_leads, talent_leads, registrations, post_click_registrations, post_view_registrations, post_click_job_applications, post_view_job_apply_clicks
Conversions	external_website_conversions, conversion_value_in_local_currency
Viral	Chaque équivalent préfixé par viral_des métriques ci-dessus, tel que viral_impressions, viral_clicks, viral_likes, viral_video_views et viral_one_click_leads

Les taux et les durées sont double et les nombres sont long. Pour la signification officielle de chaque métrique, consultez le schéma de reporting publicitaire de LinkedIn.

Options de configuration du rapport

Configurez les rapports par table via connector_options.linkedin_ads_options:

Option	Par défaut	Limites	Usage
sync_start_date	Deux ans avant aujourd’hui	Ne doit pas être dans le futur et ne doit pas être antérieur à l'horizon de conservation du rapport	La première date récupérée par la mise à jour initiale
lookback_window_days	7	0 à la 365	Jusqu'où chaque mise à jour incrémentielle relit les données pour détecter les révisions

Option	Par défaut	Limites	Usage
sync_start_date	Deux ans avant aujourd’hui	Ne doit pas être dans le futur et ne doit pas être antérieur à l'horizon de conservation du rapport	La première date récupérée par la mise à jour initiale
lookback_window_days	7	0 à la 365	Jusqu'où chaque mise à jour incrémentielle relit les données pour détecter les révisions

Les horizons de rétention diffèrent selon la famille de rapports. Il s'agit des limites de LinkedIn, et non de celles du connecteur :

Famille	Fidélisation	Effet
Rapports quotidiens de performance	10 ans	Une valeur sync_start_date antérieure à 10 ans par rapport à aujourd'hui est rejetée.
Rapports mensuels sur les membres démographiques	2 ans	Tout sync_start_date antérieur à 2 ans avant aujourd’hui est rejeté.

Famille	Fidélisation	Effet
Rapports quotidiens de performance	10 ans	Une valeur sync_start_date antérieure à 10 ans par rapport à aujourd'hui est rejetée.
Rapports mensuels sur les membres démographiques	2 ans	Tout sync_start_date antérieur à 2 ans avant aujourd’hui est rejeté.

Ressources supplémentaires

• Concepts du connecteur LinkedIn Ads
• Limitations du connecteur LinkedIn Ads
• Ingérer les données des annonces LinkedIn