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

備考

ベータ版

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

このページでは、サポートされているテーブル、列の定義、データ型など、 LakeFlow Connectのマネージド Google Ads コネクタに関するリファレンス情報を提供します。

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

Google 広告コネクタは次の種類のテーブルをサポートしています。

• リソース テーブル: キャンペーン、広告グループ、広告など、Google 広告アカウントに関する設定データ。これらのテーブルは、パイプラインの実行ごとに完全に更新されます。
• レポート表: インプレッション数、クリック数、コンバージョン数などのパフォーマンス メトリクス。 これらのテーブルは増分取り込みをサポートしています。

リソーステーブル

テーブル名	説明
customer	Google 広告アカウントに関する情報。
campaign	キャンペーンの構成と設定。
campaign_budget	キャンペーンの予算設定。
campaign_criterion	キャンペーンのターゲティング基準。
ad_group	広告グループの設定。
ad_group_criterion	広告グループのターゲティング基準。
ad	個別の広告の詳細と設定。

レポートテーブル

テーブル名	説明
customer_report	アカウントレベルのパフォーマンスメトリクス。
campaign_report	キャンペーンレベルのパフォーマンスメトリクス。
ad_group_report	広告グループレベルのパフォーマンスメトリクス。
ad_report	広告レベルのパフォーマンス メトリクス。
keyword_report	キーワードレベルのパフォーマンスメトリクス。
search_query_report	検索クエリレベルのパフォーマンス メトリクス。

データ型の規則

マネーストレージ（マイクロ）

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

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

_microsサフィックスを持つフィールドにはマイクロ単位で保存された値が含まれます。1,000,000 で割って通貨に変換します。

主キー

テーブルでは、主キーを形成する列を示すために(Primary Key)表記が使用されます。複合主キーは、 (Primary Key)としてマークされた複数の列によって示されます。

リソーステーブルスキーマ

customer

Google 広告アカウントに関する情報。

列	データ型	説明
id	long	主キー。顧客アカウントID。
resource_name	string	Google 広告のリソース名。
descriptive_name	string	Google 広告アカウントのわかりやすい名前。
currency_code	string	アカウントの通貨コード。
time_zone	string	アカウントのタイムゾーン。
status	string	アカウントのステータス。
manager	boolean	この顧客がマネージャーアカウント (MCC) であるかどうか。

campaign

キャンペーンの構成と設定。

列	データ型	説明
id	long	主キー。キャンペーンID。
name	string	キャンペーン名。
status	string	キャンペーンのステータス。
advertising_channel_type	string	広告チャンネルのタイプ。
start_date	string	キャンペーン開始日。
end_date	string	キャンペーン終了日。
campaign_budget	string	関連するキャンペーン予算。
bidding_strategy_type	string	入札戦略の種類。

campaign_budget

キャンペーンの予算設定。

列	データ型	説明
id	long	主キー。予算ID。
resource_name	string	Google 広告のリソース名。
name	string	予算名。
amount_micros	long	予算金額（マイクロ単位）。通貨に変換するには 1,000,000 で割ります。
delivery_method	string	Google が 1 日の予算をどのように使用するか（標準または加速）。
period	string	予算期間。
status	string	予算の状況。

campaign_criterion

キャンペーンのターゲティング基準。

列	データ型	説明
campaign_id	long	主キー。キャンペーンID。
criterion_id	long	主キー。基準ID。
resource_name	string	Google 広告のリソース名。
type	string	基準タイプ。
status	string	基準ステータス。
negative	boolean	この基準によって対象者が除外されるかどうか。
bid_modifier	double	入札調整値。

ad_group

広告グループの設定。

列	データ型	説明
id	long	主キー。広告グループ ID。
name	string	広告グループ名。
status	string	広告グループのステータス。
campaign_id	long	関連付けられたキャンペーン ID。
type	string	広告グループの種類。
cpc_bid_micros	long	クリック単価（マイクロ単位）。
target_cpa_micros	long	マイクロ単位のターゲット顧客獲得単価。

ad_group_criterion

広告グループのターゲティング基準。

列	データ型	説明
criterion_id	long	主キー。基準ID。
ad_group_id	long	主キー。広告グループ ID。
resource_name	string	Google 広告のリソース名。
status	string	基準ステータス。
type	string	基準タイプ。
negative	boolean	この基準によって対象者が除外されるかどうか。
keyword_match_type	string	キーワードの一致タイプ（完全一致、フレーズ一致、部分一致）。
keyword_text	string	キーワードテキスト。

ad

個別の広告の詳細と設定。この表は、Google Ads API のad_group_adに対応しています。

列	データ型	説明
id	long	主キー。広告ID。
ad_group_id	long	主キー。広告グループ ID。
status	string	広告のステータス。
ad_type	string	広告の種類。
final_urls	array<string>	ランディングページ 広告をクリックするとURLが表示されます。
policy_summary_approval_status	string	広告が Google 広告ポリシーに基づいて承認されているかどうか（承認済みまたは不承認）。
policy_summary_review_status	string	Google が広告の審査を完了したかどうか（REVIEW_IN_PROGRESS または REVIEWED）。

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

customer_report

アカウントレベルのパフォーマンスメトリクス。

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
date	string	主キー。YYYY-MM-DD 形式の日付。
device	string	主キー。デバイスの種類。
ad_network_type	string	主キー。広告ネットワークの種類。
impressions	long	インプレッション数。
clicks	long	クリック数。
cost_micros	long	コストはマイクロ単位です。通貨に変換するには 1,000,000 で割ります。
conversions	double	コンバージョン数。
conversions_value	double	合計コンバージョン値。
ctr	double	クリックスルー率。
average_cpc	double	クリックあたりの平均コスト。

campaign_report

キャンペーンレベルのパフォーマンスメトリクス。

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
id	long	主キー。キャンペーンID。
date	string	主キー。YYYY-MM-DD 形式の日付。
device	string	主キー。デバイスの種類。
ad_network_type	string	主キー。広告ネットワークの種類。
campaign_name	string	キャンペーン名。
campaign_status	string	キャンペーンのステータス。
impressions	long	インプレッション数。
clicks	long	クリック数。
cost_micros	long	コストはマイクロ単位です。
conversions	double	コンバージョン数。

ad_group_report

広告グループレベルのパフォーマンスメトリクス。

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
id	long	主キー。広告グループ ID。
date	string	主キー。YYYY-MM-DD 形式の日付。
device	string	主キー。デバイスの種類。
ad_network_type	string	主キー。広告ネットワークの種類。
ad_group_name	string	広告グループ名。
ad_group_status	string	広告グループのステータス。
campaign_id	long	関連付けられたキャンペーン ID。
impressions	long	インプレッション数。
clicks	long	クリック数。
cost_micros	long	コストはマイクロ単位です。

keyword_report

キーワードレベルのパフォーマンスメトリクス。

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
date	string	主キー。YYYY-MM-DD 形式の日付。
ad_group_criterion_criterion_id	long	主キー。基準ID。
ad_group_id	long	主キー。広告グループ ID。
device	string	主キー。デバイスの種類。
ad_network_type	string	主キー。広告ネットワークの種類。
keyword_text	string	キーワードテキスト。
keyword_match_type	string	キーワードの一致タイプ。
impressions	long	インプレッション数。
clicks	long	クリック数。
cost_micros	long	コストはマイクロ単位です。

ad_report

広告レベルのパフォーマンス メトリクス。

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
date	string	主キー。YYYY-MM-DD 形式の日付。
ad_id	long	主キー。広告ID。
ad_group_id	long	主キー。広告グループ ID。
device	string	主キー。デバイスの種類。
ad_network_type	string	主キー。広告ネットワークの種類。
campaign_id	long	関連付けられたキャンペーン ID。
impressions	long	インプレッション数。
clicks	long	クリック数。
cost_micros	long	コストはマイクロ単位です。
conversions	double	コンバージョン数。

search_query_report

検索クエリレベルのパフォーマンス メトリクス。

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
date	string	主キー。YYYY-MM-DD 形式の日付。
resource_name	string	主キー。Google 広告のリソース名。
search_term	string	ユーザーの検索用語。
search_term_match_type	string	キーワードが検索用語とどの程度一致したか。
ad_group_id	long	関連付けられた広告グループ ID。
campaign_id	long	関連付けられたキャンペーン ID。
impressions	long	インプレッション数。
clicks	long	クリック数。

増分取り込み

レポート テーブルは、構成可能なルックバック ウィンドウを使用した増分取り込みをサポートします。コネクタは、増分更新を追跡するためのカーソル列としてdate列を使用します。

増分取り込みとルックバック ウィンドウの詳細については、 Google 広告コネクタのコンセプトをご覧ください。