LinkedIn広告コネクタの概念

備考

ベータ版

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

Lakeflow Connect のマネージド LinkedIn Ads コネクタの仕組みについて学習します。

コネクタの仕組み

LinkedIn Ads コネクタは、LinkedIn Marketing API を使用して LinkedIn Ads から Databricks にデータを取り込みます。API バージョン 202604 にピン留めされています。このコネクタは 2 種類のテーブルをサポートしています。

• エンティティテーブル:これらのテーブルには、キャンペーン、クリエイティブ、アカウントユーザーなどの広告アカウントの設定データが含まれています。エンティティテーブルはパイプラインの更新ごとに完全に更新されます。これらは段階的摂取や病歴追跡(SCDタイプ2)をサポートしていません。
• 事前構築済みレポートテーブル：これらのテーブルには、インプレッション、クリック、支出などのパフォーマンスおよびデモグラフィックメトリクスが含まれています。レポートテーブルは、遅れて到着したリビジョンを取り込むための構成可能なルックバック期間を使用した増分取り込みをサポートしています。

サポートされているテーブルとそのスキーマのリストについては、「LinkedIn Ads コネクタ リファレンス」を参照してください。

ソース名前空間

コネクターは2種類の名前空間でソーステーブルを公開します。パイプラインオブジェクトを定義する際、指定した source_schema がテーブルのどの名前空間からのものかを決定します:

• default: 認証トークンがアクセス可能なすべての広告アカウントをカバーする、ソース全体の単一テーブル account_history が含まれます。
• アカウントごとの名前空間：スポンサー広告アカウントごとに1つの名前空間があり、スポンサー広告アカウントIDに基づいて命名されます。この名前空間名は、パイプライン仕様でsource_schemaとして設定した値です。残りの4つのエンティティテーブルと7つのレポートテーブルはすべてここに配置されます。

12のテーブルのうち11個がアカウントごとに分かっているため、複数の広告アカウントを取り込むパイプラインは、それぞれのアカウントごとに異なる source_schema で同じテーブル定義を繰り返します。

スポンサー広告アカウントIDを見つけるには、LinkedIn Campaign Manager でアカウントを開きます。数値 ID はアカウント名の下、およびページ URL の /accounts/ の後に表示されます (例: https://www.linkedin.com/campaignmanager/accounts/512345678/)。

増分取り込みとルックバック期間

LinkedInは遅延コンバージョンや帰属更新が届くたびにその日のメトリクスを修正するため、コネクターがすでに取り込んだ行が後で変更されることがあります。これらの改訂を反映させるため、各増分更新では、新しい日付を取得するだけでなく、既に同期済みの過去の日付のウィンドウを再読み込みします。

最初の更新では、報告書の開始日から昨日まで読み上げます。その後の更新では、各グレー(レポートによりますが広告アカウントまたはキャンペーン)は、最後にコミットしたカーソルから lookback_window_daysを引いたところからレポート開始日にフロアが戻ります。The default lookback is 7日間で、0から365までの任意の値を設定できます。組織のコンバージョンアトリビューション期間以上の長さに設定することで、遅れて発生したコンバージョンもテーブルに反映されます。

進捗はテーブル単位ではなくグレイン単位で追跡されます。つまり、更新の途中で失敗した場合でも、レポート全体を再起動するのではなく、すでに完了したグレインが保持されます：

• ad_analytics_by_campaign_report 広告アカウントごとの進捗状況を追跡します。
• クリエイティブ レポートおよび5つのデモグラフィック レポートすべてで、キャンペーンごとの進捗状況を追跡します。

進捗は粒度単位であるため、最初の更新後に sync_start_date を下げても、すでに同期済みのレポートはバックフィルされません。初めて表示されるアカウントまたはキャンペーンのみが、新しい日付から起動されます。以前の履歴を再取り込みするには、テーブルで完全更新を手動でランします。

家族を報告する

7つの事前構築済みレポートは、形状の異なる2つのファミリーに分類されます。

• 日次パフォーマンスレポートは、ピボットエンティティごとに1日1行を生成します。day 列には ISO 日付が保持され、エンティティ列にはレポートのピボット名が付けられるため、キャンペーンレポートは campaign_id で、クリエイティブレポートは creative_id でキー設定されます。
• 月次の会員属性レポートは、月ごとに、キャンペーンおよび属性値の組み合わせにつき1行を生成します。LinkedInの属性回答にはキャンペーン情報が含まれないため、コネクタはクエリー対象のキャンペーンから campaign_id を属性として付与します。

月次レポートを暦月より小さい単位に絞り込むことはできません。LinkedIn では、月次粒度で月未満の範囲を指定しても行が返されないため、月の中間に該当する sync_start_date はその月の初日に調整され、その月に対して返される行は 1 か月分の集計となります。

データ保持期間

LinkedInでは、各レポートファミリーが読み取れる期間が制限されています。これらはLinkedIn側の制限であり、コネクタの制限ではありません：

• 日々のパフォーマンスデータは10年間保存されます。
• 専門的な人口統計データは 2 年間保持されます。

レポートに適用される期間よりも古い sync_start_date は読み取りに失敗します。これは、それ以前のデータを API から取得できないためです。エラーメッセージには、使用可能な最も早い日付が記載されています。

タイムゾーン

コネクタは、すべてのレポートの日付境界を広告アカウントのタイムゾーンではなく UTC で評価します。この設定は上書きできません。広告アカウントが UTC 以外のタイムゾーンでレポートを作成している場合、同じ暦日であっても、日次合計が LinkedIn Campaign Manager UI に表示される内容と異なる可能性があります。