LinkedIn広告コネクタのリファレンス

備考

ベータ版

この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。

このページでは、Lakeflow Connectの管理型LinkedIn Adsコネクタに関する参照情報を提供しており、対応するテーブル、列定義、データ型が含まれます。

サポートされているテーブル

LinkedIn広告コネクタは、2つのカテゴリに分類される12個のテーブルをサポートしています。

• エンティティテーブル：キャンペーンやクリエイティブなど、広告アカウントに関する構成データ。これらのテーブルは、パイプラインの更新ごとに完全に更新されます。
• 事前構築済みレポートテーブル：LinkedInの adAnalytics Endpointからのパフォーマンスおよびデモグラフィックメトリクス。これらのテーブルは増分取り込みをサポートしています。

各テーブルは、default 名前空間、またはスポンサー付き広告アカウント ID にちなんで名付けられたアカウントごとの名前空間のいずれかに存在します。ソース名前空間を参照してください。

エンティティテーブル

テーブル名	名前空間	プライマリーキー	説明
account_history	default	id	認可トークンがアクセス可能なスポンサー広告アカウント。
campaign_group_history	アカウントごと	id	予算および目的の設定を含むキャンペーングループ。
campaign_history	アカウントごと	id	ターゲティング基準、予算、ランのスケジュールを含むキャンペーン。
creative_history	アカウントごと	id	コンテンツやレビュー状況を含むクリエイティブ。
account_user_history	アカウントごと	account, user	広告アカウントにおけるユーザーごとのロール。

テーブル名	名前空間	プライマリーキー	説明
account_history	default	id	認可トークンがアクセス可能なスポンサー広告アカウント。
campaign_group_history	アカウントごと	id	予算および目的の設定を含むキャンペーングループ。
campaign_history	アカウントごと	id	ターゲティング基準、予算、ランのスケジュールを含むキャンペーン。
creative_history	アカウントごと	id	コンテンツやレビュー状況を含むクリエイティブ。
account_user_history	アカウントごと	account, user	広告アカウントにおけるユーザーごとのロール。

構築済みレポートテーブル

7つのレポートはすべてアカウント単位であり、増分取り込みをサポートしています。

テーブル名	粒度	プライマリーキー	ピボット
ad_analytics_by_campaign_report	日次	campaign_id, day	CAMPAIGN
ad_analytics_by_creative_report	日次	creative_id, day	CREATIVE
monthly_ad_analytics_by_member_company_size_report	毎月	campaign_id、member_company_size、 month	MEMBER_COMPANY_SIZE
monthly_ad_analytics_by_member_country_report	毎月	campaign_id、member_country、 month	MEMBER_COUNTRY_V2
monthly_ad_analytics_by_member_industry_report	毎月	campaign_id、member_industry、 month	MEMBER_INDUSTRY
monthly_ad_analytics_by_member_job_function_report	毎月	campaign_id、member_job_function、 month	MEMBER_JOB_FUNCTION
monthly_ad_analytics_by_member_seniority_report	毎月	campaign_id、member_seniority、 month	MEMBER_SENIORITY

テーブル名	粒度	プライマリーキー	ピボット
ad_analytics_by_campaign_report	日次	campaign_id, day	CAMPAIGN
ad_analytics_by_creative_report	日次	creative_id, day	CREATIVE
monthly_ad_analytics_by_member_company_size_report	毎月	campaign_id、member_company_size、 month	MEMBER_COMPANY_SIZE
monthly_ad_analytics_by_member_country_report	毎月	campaign_id、member_country、 month	MEMBER_COUNTRY_V2
monthly_ad_analytics_by_member_industry_report	毎月	campaign_id、member_industry、 month	MEMBER_INDUSTRY
monthly_ad_analytics_by_member_job_function_report	毎月	campaign_id、member_job_function、 month	MEMBER_JOB_FUNCTION
monthly_ad_analytics_by_member_seniority_report	毎月	campaign_id、member_seniority、 month	MEMBER_SENIORITY

データ型の規則

次の規則は、すべての宛先テーブルに適用されます。

• 主キー列を除くすべての列は NULL 値を許容します。
• createdAt および lastModifiedAt はLinkedInの監査 Timestampであり、Timestampではなくエポックミリ秒 long 値として取り込まれます。
• targetingCriteria、content、およびinlineContentはvariant列として取り込まれます。このコネクターは、Deltaのバリアントテーブル機能を有効にして、それらを搭載するテーブルに搭載します。
• 金額列は decimal であり、列名で指定された通貨単位で表示されます。たとえば、cost_in_usd は米ドル、cost_in_local_currency は広告アカウントの通貨です。

エンティティテーブルのスキーマ

account_history

列	Spark型
id	long (主キー)
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

列	Spark型
id	long (主キー)
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

列	Spark型
id	long (主キー)
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

列	Spark型
id	long (主キー)
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

注記

この表では、dailyBudget は通貨構造体ではなく、単なる decimal(19,2) です。campaign_historyでは、同じ列名がstruct<amount, currencyCode>です。この非対称性は、LinkedInのAPIが各リソースに対して返す形状を反映している。

campaign_history

列	Spark型
id	long (主キー)
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

列	Spark型
id	long (主キー)
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

列	Spark型
id	string (主キー)
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

列	Spark型
id	string (主キー)
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

列	Spark型
account	string (主キー)
user	string (主キー)
role	string
createdAt	long
lastModifiedAt	long

列	Spark型
account	string (主キー)
user	string (主キー)
role	string
createdAt	long
lastModifiedAt	long

テーブルスキーマのレポート

すべてのレポートには、同じ114個のメトリクス列と、それぞれの先頭キー列が含まれます。LinkedInはすべてゼロの行を省略し、存在しないメトリクスをNULLにするため、メトリクス列はすべてNULLを許容します。

7つのレポートすべてに _sync_timestamp 列が含まれており、これは各レポートのカーソルの一部です。LinkedIn は遅れて到着したコンバージョンに応じて期間のメトリクスをその場で修正するため、再取得された行は同じ day または month を保持します。厳密に増加するコンパニオン値がない場合、送信先の MERGE はリビジョンが変更されていないと見なして破棄します。Timestampは更新のたびに進むため、常に新しいバージョンが優先されます。

日次レポート

各日次レポートには、ピボット対象のディメンション名が付けられたエンティティ列が正確に 1 つ含まれます。

列	Spark型	注
エンティティ列	long (主キー)	ピボット値。以下の表を参照してください。
day	string (主キー)	ISO日付、yyyy-MM-dd。
_sync_timestamp	timestamp	更新のたびにコネクタによって生成されます。
114のメートル法列	long、decimal、または double

列	Spark型	注
エンティティ列	long (主キー)	ピボット値。以下の表を参照してください。
day	string (主キー)	ISO日付、yyyy-MM-dd。
_sync_timestamp	timestamp	更新のたびにコネクタによって生成されます。
114のメートル法列	long、decimal、または double

レポート	エンティティ列	Spark型	価値形式
ad_analytics_by_campaign_report	campaign_id	long	ピボットURNからのベアID。
ad_analytics_by_creative_report	creative_id	long	ピボットURNからのベアID。

レポート	エンティティ列	Spark型	価値形式
ad_analytics_by_campaign_report	campaign_id	long	ピボットURNからのベアID。
ad_analytics_by_creative_report	creative_id	long	ピボットURNからのベアID。

月次会員人口統計レポート

各デモグラフィックレポートには、ピボット対象のディメンション名が付けられたメンバー列が1つだけ含まれます。

列	Spark型	注
campaign_id	long (主キー)	コネクタがクエリーを実行したキャンペーンから属性付けされます。
メンバーディメンション列	long または string（主キー）	ピボット値。以下の表を参照してください。
month	string (主キー)	年と月をゼロ埋めしたもの、yyyy-MM。
_sync_timestamp	timestamp	更新のたびにコネクタによって生成されます。
114のメートル法列	long、decimal、または double

列	Spark型	注
campaign_id	long (主キー)	コネクタがクエリーを実行したキャンペーンから属性付けされます。
メンバーディメンション列	long または string（主キー）	ピボット値。以下の表を参照してください。
month	string (主キー)	年と月をゼロ埋めしたもの、yyyy-MM。
_sync_timestamp	timestamp	更新のたびにコネクタによって生成されます。
114のメートル法列	long、decimal、または double

レポート	メンバー列	Spark型	価値形式
monthly_ad_analytics_by_member_company_size_report	member_company_size	string	SIZE_11_TO_50 などのリテラル列挙型。
monthly_ad_analytics_by_member_country_report	member_country	long	ピボットURNからのベアID。
monthly_ad_analytics_by_member_industry_report	member_industry	long	ピボットURNからのベアID。
monthly_ad_analytics_by_member_job_function_report	member_job_function	long	ピボットURNからのベアID。
monthly_ad_analytics_by_member_seniority_report	member_seniority	long	ピボットURNからのベアID。

レポート	メンバー列	Spark型	価値形式
monthly_ad_analytics_by_member_company_size_report	member_company_size	string	SIZE_11_TO_50 などのリテラル列挙型。
monthly_ad_analytics_by_member_country_report	member_country	long	ピボットURNからのベアID。
monthly_ad_analytics_by_member_industry_report	member_industry	long	ピボットURNからのベアID。
monthly_ad_analytics_by_member_job_function_report	member_job_function	long	ピボットURNからのベアID。
monthly_ad_analytics_by_member_seniority_report	member_seniority	long	ピボットURNからのベアID。

メトリクス列

7 つのレポートすべてが同じメトリクスセットを返します。列名は、LinkedIn の camelCase メトリクス名を snake_case に名前変更したものです。たとえば、costInLocalCurrency は cost_in_local_currency になります。次の表は、メトリクスをテーマ別にグループ化したものです。

グループ	例となる列
コアパフォーマンス	impressions、clicks、cost_in_local_currency、cost_in_usd、approximate_member_reach、 audience_penetration
エンゲージメント	likes、comments、shares、reactions、follows、total_engagements、other_engagements、 comment_likes
サーフェス別のクリック数	landing_page_clicks、company_page_clicks、text_url_clicks、headline_clicks、card_clicks、ad_unit_clicks、action_clicks、download_clicks、 subscription_clicks
動画	video_views、video_starts、video_completions、video_first_quartile_completions、video_midpoint_completions、video_third_quartile_completions、video_watch_time、 average_video_watch_time
イベント	event_views、event_views_over_15_seconds、event_views_over_30_seconds、event_views_over_2_minutes、event_watch_time、 cost_per_event_view
ドキュメント	document_completions、document_first_quartile_completions、document_midpoint_completions、 document_third_quartile_completions
リード、登録、ジョブ	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
変換	external_website_conversions, conversion_value_in_local_currency
バイラル	上記のメトリクスの viral_ がプレフィックスとして付いた各対応項目（viral_impressions、viral_clicks、viral_likes、viral_video_views など） viral_one_click_leads

グループ	例となる列
コアパフォーマンス	impressions、clicks、cost_in_local_currency、cost_in_usd、approximate_member_reach、 audience_penetration
エンゲージメント	likes、comments、shares、reactions、follows、total_engagements、other_engagements、 comment_likes
サーフェス別のクリック数	landing_page_clicks、company_page_clicks、text_url_clicks、headline_clicks、card_clicks、ad_unit_clicks、action_clicks、download_clicks、 subscription_clicks
動画	video_views、video_starts、video_completions、video_first_quartile_completions、video_midpoint_completions、video_third_quartile_completions、video_watch_time、 average_video_watch_time
イベント	event_views、event_views_over_15_seconds、event_views_over_30_seconds、event_views_over_2_minutes、event_watch_time、 cost_per_event_view
ドキュメント	document_completions、document_first_quartile_completions、document_midpoint_completions、 document_third_quartile_completions
リード、登録、ジョブ	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
変換	external_website_conversions, conversion_value_in_local_currency
バイラル	上記のメトリクスの viral_ がプレフィックスとして付いた各対応項目（viral_impressions、viral_clicks、viral_likes、viral_video_views など） viral_one_click_leads

レートと期間はdouble、カウントはlongです。各メトリクスの権威ある意味については、LinkedInの 広告報告スキーマをご覧ください。

レポートの構成オプション

テーブルごとのレポート設定（connector_options.linkedin_ads_optionsまで）：

オプション	デフォルト	境界	目的
sync_start_date	今日から2年前	未来の日付であってはならず、レポートの保持期間よりも古いものであってはなりません	最初の更新が取得する最初の日付
lookback_window_days	7	0 - 365	リビジョンをキャッチするために各インクリメンタル更新が過去に遡って再読み込みする範囲

オプション	デフォルト	境界	目的
sync_start_date	今日から2年前	未来の日付であってはならず、レポートの保持期間よりも古いものであってはなりません	最初の更新が取得する最初の日付
lookback_window_days	7	0 - 365	リビジョンをキャッチするために各インクリメンタル更新が過去に遡って再読み込みする範囲

保持期間はレポートファミリーによって異なります。これらはLinkedIn側の制限であり、コネクタの制限ではありません：

ファミリー	保持期間	効果
日次パフォーマンスレポート	10年間	今日から10年以上前の sync_start_date は却下されます。
月次メンバーデモグラフィックレポート	2 年間	今日から2年以上前の sync_start_date は拒否されます。

ファミリー	保持期間	効果
日次パフォーマンスレポート	10年間	今日から10年以上前の sync_start_date は却下されます。
月次メンバーデモグラフィックレポート	2 年間	今日から2年以上前の sync_start_date は拒否されます。

その他のリソース

• LinkedIn広告コネクタの概念
• LinkedIn Ads コネクタの制限事項
• LinkedIn広告からデータを取り込む