Référence du connecteur LinkedIn Ads

info

Beta

This feature is in Beta. Workspace admins can control access to this feature from the Previews page. See Manage Databricks previews.

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`	Monthly	`campaign_id`, `member_company_size`, `month`	`MEMBER_COMPANY_SIZE`
`monthly_ad_analytics_by_member_country_report`	Monthly	`campaign_id`, `member_country`, `month`	`MEMBER_COUNTRY_V2`
`monthly_ad_analytics_by_member_industry_report`	Monthly	`campaign_id`, `member_industry`, `month`	`MEMBER_INDUSTRY`
`monthly_ad_analytics_by_member_job_function_report`	Monthly	`campaign_id`, `member_job_function`, `month`	`MEMBER_JOB_FUNCTION`
`monthly_ad_analytics_by_member_seniority_report`	Monthly	`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`	Monthly	`campaign_id`, `member_company_size`, `month`	`MEMBER_COMPANY_SIZE`
`monthly_ad_analytics_by_member_country_report`	Monthly	`campaign_id`, `member_country`, `month`	`MEMBER_COUNTRY_V2`
`monthly_ad_analytics_by_member_industry_report`	Monthly	`campaign_id`, `member_industry`, `month`	`MEMBER_INDUSTRY`
`monthly_ad_analytics_by_member_job_function_report`	Monthly	`campaign_id`, `member_job_function`, `month`	`MEMBER_JOB_FUNCTION`
`monthly_ad_analytics_by_member_seniority_report`	Monthly	`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.
Money columns are decimal and are denominated in the currency named by the column. For example, cost_in_usd is in US dollars and cost_in_local_currency is in the ad account's currency.

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`

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.

All seven reports carry a _sync_timestamp column, which is part of each report's cursor. LinkedIn revises a period's metrics in place as late conversions arrive, so a re-fetched row keeps the same day or month. Without a strictly increasing companion value, the destination MERGE would treat the revision as unchanged and drop it. The timestamp advances on every update, so the newer version always wins.

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	Value form
`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	Value form
`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)	Zero-padded year and month, `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)	Zero-padded year and month, `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	Value form
`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	Value form
`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, registrations, and 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, registrations, and 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é.

Tables prises en charge​

Tables d'entités​

Tables de rapports prédéfinies​

Conventions de type de données​

Schémas de tables d’entités​

account_history​

campaign_group_history​

campaign_history​

creative_history​

account_user_history​

Signaler les schémas de table​

Rapports quotidiens​

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

Colonnes de métriques​

Options de configuration du rapport​

Ressources supplémentaires​