Google 広告コネクタのコンセプト

備考

ベータ版

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

LakeFlow Connectのマネージド Google Ads コネクタの仕組みについて説明します。

コネクタの仕組み

Google 広告コネクタは、Google 広告 API を使用して Google 広告アカウントから Databricks にデータを取り込みます。コネクタは次の 2 種類のテーブルをサポートします。

• リソース テーブル: これらのテーブルには、キャンペーン、広告グループ、広告など、Google 広告アカウントに関する設定データが含まれています。リソース テーブルは増分取り込みをサポートしていません。パイプラインの実行ごとに完全に更新されます。また、履歴追跡 (SCD タイプ 2) もサポートされていません。
• レポート テーブル: これらのテーブルには、インプレッション数、クリック数、コンバージョン数などのパフォーマンス メトリクスが含まれます。 レポート テーブルは、遅いイベントとアトリビューションの更新をキャプチャするための構成可能なルックバック ウィンドウを使用した増分取り込みをサポートします。

サポートされているテーブルのリストについては、 Google 広告コネクタ リファレンスをご覧ください。

アカウント階層

Google 広告コネクタは次のアカウント構造で動作します。

• マネージャー アカウント ID (MCC): 1 つ以上の Google 広告 アカウントを管理する Google 広告 マネージャー アカウントの 10 桁の識別子。 1 つのパイプラインは最大 1 つのマネージャー アカウント ID にマッピングされます。
• 顧客アカウント ID: 特定の Google 広告アカウントの 10 桁の識別子。 マネージャー アカウント ID が複数の顧客アカウント ID にマッピングされている場合は、同じパイプライン内でそれらの異なる顧客アカウント ID から取り込むことができます。

Google 広告では、広告データを次の階層に整理します。

• Manager アカウント : 複数のクライアントの広告アカウント、ユーザー、請求を管理するための Umbrella アカウント。
  • 広告アカウント ：個別の広告アカウント。
    • キャンペーン : 広告の最上位組織単位。
      • 広告グループ : ターゲティング設定を共有する広告のコレクション。
        • 広告 ：個別の広告。
          • アセット : 広告やキャンペーンに添付できる再利用可能なクリエイティブ コンポーネント (見出し、画像、ロゴ、サイトリンク)。

データ取り込みパターン

履歴データの同期

安全により、コネクタはレポート テーブルの 2 年分の履歴データを取り込みます。 これは、 sync_start_date問題を使用して構成できます。 上限はありません。

増分更新とルックバックウィンドウ

Google 広告のコンバージョン データは、事後最大 90 日間変更される可能性があります。たとえば、ユーザーが広告をクリックしてから数日後にコンバージョンに至る場合や、Google 広告がアトリビューションを再計算する場合があります。これらの変更をキャプチャするために、コネクタはパイプラインの更新ごとにデフォルトで過去 30 日間のデータを再チェックします。

このルックバック ウィンドウは、 lookback_window_daysを使用してカスタマイズできます。 この値を設定するときは、組織のコンバージョン アトリビューション ウィンドウを考慮してください。たとえば、組織で 60 日間のコンバージョン ウィンドウを使用している場合は、 lookback_window_days=60を設定して、遅いコンバージョンとアトリビューションの更新がデータに反映されるようにします。

Google 広告での資金の保管

Google 広告では、四捨五入の問題を回避するために、金額をマイクロ単位で保存します。100万マイクロは1通貨単位に相当します。例えば：

• 1,000,000 micros = $1.00 USD
• 5,500,000 micros = $5.50 USD

宛先テーブルのコストと予算のフィールドを操作するときは、1,000,000 で割ってマイクロから通貨に変換します。