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

備考

ベータ版

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

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

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

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

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

リソーステーブル

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

テーブル名	説明
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	検索クエリレベルのパフォーマンス メトリクス。
customer_hourly_report	時間単位で分類されたアカウントレベルのパフォーマンスメトリクス。
campaign_hourly_report	時間単位で分類されたキャンペーンレベルのパフォーマンスメトリクス。
ad_group_hourly_report	時間別に分類された広告グループレベルのパフォーマンスメトリクス。
audience_report	オーディエンスレベル（広告グループ基準）のパフォーマンスメトリクス。
click_report	Google Click ID (gclid) でキー設定されたクリックレベルのメトリクス。
landing_page_report	ランディングページ（展開された最終 URL）のパフォーマンスメトリクス。
search_keyword_report	キーワードビューからのキーワードレベルのパフォーマンスメトリクス。

テーブル名	説明
customer_report	アカウントレベルのパフォーマンスメトリクス。
campaign_report	キャンペーンレベルのパフォーマンスメトリクス。
ad_group_report	広告グループレベルのパフォーマンスメトリクス。
ad_report	広告レベルのパフォーマンス メトリクス。
keyword_report	キーワードレベルのパフォーマンスメトリクス。
search_query_report	検索クエリレベルのパフォーマンス メトリクス。
customer_hourly_report	時間単位で分類されたアカウントレベルのパフォーマンスメトリクス。
campaign_hourly_report	時間単位で分類されたキャンペーンレベルのパフォーマンスメトリクス。
ad_group_hourly_report	時間別に分類された広告グループレベルのパフォーマンスメトリクス。
audience_report	オーディエンスレベル（広告グループ基準）のパフォーマンスメトリクス。
click_report	Google Click ID (gclid) でキー設定されたクリックレベルのメトリクス。
landing_page_report	ランディングページ（展開された最終 URL）のパフォーマンスメトリクス。
search_keyword_report	キーワードビューからのキーワードレベルのパフォーマンスメトリクス。

イベントテーブル

テーブル名	説明
call_view	電話アセットおよび電話専用広告から追跡された通話。
lead_form_submission	リードフォームの送信。Google Adsアカウントへの標準アクセス権または管理者アクセス権が必要です。
local_services_lead	Local Services広告のリード。Local Servicesアカウントの行のみを返します。
local_services_lead_conversation	Local サービス 広告のリードに関する会話。Local Services アカウントの行のみを返します。

テーブル名	説明
call_view	電話アセットおよび電話専用広告から追跡された通話。
lead_form_submission	リードフォームの送信。Google Adsアカウントへの標準アクセス権または管理者アクセス権が必要です。
local_services_lead	Local Services広告のリード。Local Servicesアカウントの行のみを返します。
local_services_lead_conversation	Local サービス 広告のリードに関する会話。Local Services アカウントの行のみを返します。

データ型の規則

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

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。
auto_tagging_enabled	boolean	アカウントで自動タグ付けが有効になっているかどうか。
currency_code	string	アカウントの通貨コード。
descriptive_name	string	Google 広告アカウントのわかりやすい名前。
final_url_suffix	string	追跡のために、最終URLにURLサフィックスが追加されます。
manager	boolean	顧客がマネージャーアカウント（MCC）であるかどうか。
optimization_score	double	アカウントの最適化スコア。
pay_per_conversion_eligibility_failure_reasons	array<string>	アカウントがコンバージョン課金入札の対象外となる理由。
test_account	boolean	顧客がテストアカウントであるかどうか。
time_zone	string	アカウントのタイムゾーン。
tracking_url_template	string	トラッキングURLを作成するためのURLテンプレート。

列	データ型	説明
id	long	主キー。顧客アカウントID。
auto_tagging_enabled	boolean	アカウントで自動タグ付けが有効になっているかどうか。
currency_code	string	アカウントの通貨コード。
descriptive_name	string	Google 広告アカウントのわかりやすい名前。
final_url_suffix	string	追跡のために、最終URLにURLサフィックスが追加されます。
manager	boolean	顧客がマネージャーアカウント（MCC）であるかどうか。
optimization_score	double	アカウントの最適化スコア。
pay_per_conversion_eligibility_failure_reasons	array<string>	アカウントがコンバージョン課金入札の対象外となる理由。
test_account	boolean	顧客がテストアカウントであるかどうか。
time_zone	string	アカウントのタイムゾーン。
tracking_url_template	string	トラッキングURLを作成するためのURLテンプレート。

campaign

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

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

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

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	予算の状況。
total_amount_micros	long	予算の総額（マイクロ単位）。1,000,000で割って通貨に換算してください。

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

campaign_criterion

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

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

列	データ型	説明
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	マイクロ単位のターゲット顧客獲得単価。

列	データ型	説明
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	キーワードテキスト。

列	データ型	説明
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）。

列	データ型	説明
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	クリックあたりの平均コスト。

列	データ型	説明
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	コンバージョン数。

列	データ型	説明
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	コストはマイクロ単位です。

列	データ型	説明
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	コストはマイクロ単位です。

列	データ型	説明
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	コンバージョン数。

列	データ型	説明
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	クリック数。

列	データ型	説明
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	クリック数。

customer_hourly_report

時間単位で分類されたアカウントレベルのパフォーマンスメトリクス。

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
date	string	主キー。YYYY-MM-DD 形式の日付。
hour	int	プライマリーキー。時刻（0～23）。
click_type	string	プライマリーキー。クリックタイプ。
device	string	主キー。デバイスの種類。
ad_network_type	string	主キー。広告ネットワークの種類。
impressions	long	インプレッション数。
clicks	long	クリック数。
cost_micros	long	コストはマイクロ単位です。通貨に変換するには 1,000,000 で割ります。
conversions	double	コンバージョン数。
ctr	double	クリックスルー率。

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
date	string	主キー。YYYY-MM-DD 形式の日付。
hour	int	プライマリーキー。時刻（0～23）。
click_type	string	プライマリーキー。クリックタイプ。
device	string	主キー。デバイスの種類。
ad_network_type	string	主キー。広告ネットワークの種類。
impressions	long	インプレッション数。
clicks	long	クリック数。
cost_micros	long	コストはマイクロ単位です。通貨に変換するには 1,000,000 で割ります。
conversions	double	コンバージョン数。
ctr	double	クリックスルー率。

時間別レポートテーブルには、追加のセグメント列 (day_of_week、week、month、quarter、year、interaction_event_types) およびメトリクス列 (interactions、interaction_rate、average_cost、average_cpc、average_cpm、cost_per_conversion、value_per_conversion、conversions_value、conversions_from_interactions_rate、および Active View メトリクス) も含まれます。

campaign_hourly_report

時間単位で分類されたキャンペーンレベルのパフォーマンスメトリクス。customer_hourly_reportと同じ列に加え、以下が含まれます：

列	データ型	説明
id	long	主キー。キャンペーンID。
base_campaign	string	エクスペリメントのベースキャンペーンのリソース名。

列	データ型	説明
id	long	主キー。キャンペーンID。
base_campaign	string	エクスペリメントのベースキャンペーンのリソース名。

ad_group_hourly_report

時間別に分類された広告グループレベルのパフォーマンス指標。customer_hourly_report と同じ列に加え、以下が含まれます：

列	データ型	説明
id	long	主キー。広告グループ ID。
campaign_id	long	関連付けられたキャンペーン ID。

列	データ型	説明
id	long	主キー。広告グループ ID。
campaign_id	long	関連付けられたキャンペーン ID。

audience_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	主キー。広告ネットワークの種類。
campaign_id	long	関連付けられたキャンペーン ID。
impressions	long	インプレッション数。
clicks	long	クリック数。
cost_micros	long	コストはマイクロ単位です。通貨に変換するには 1,000,000 で割ります。
conversions	double	コンバージョン数。
conversions_value	double	合計コンバージョン値。
view_through_conversions	long	ビュースルーコンバージョン。

列	データ型	説明
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	主キー。広告ネットワークの種類。
campaign_id	long	関連付けられたキャンペーン ID。
impressions	long	インプレッション数。
clicks	long	クリック数。
cost_micros	long	コストはマイクロ単位です。通貨に変換するには 1,000,000 で割ります。
conversions	double	コンバージョン数。
conversions_value	double	合計コンバージョン値。
view_through_conversions	long	ビュースルーコンバージョン。

click_report

Google Click ID でキー設定されたクリックレベルのメトリクス。

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
date	string	主キー。YYYY-MM-DD 形式の日付。
gclid	string	プライマリーキー。Google クリック ID。
ad_group_id	long	関連付けられた広告グループ ID。
campaign_id	long	関連付けられたキャンペーン ID。
clicks	long	クリック数。

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
date	string	主キー。YYYY-MM-DD 形式の日付。
gclid	string	プライマリーキー。Google クリック ID。
ad_group_id	long	関連付けられた広告グループ ID。
campaign_id	long	関連付けられたキャンペーン ID。
clicks	long	クリック数。

landing_page_report

展開された最終URLをキーとするランディングページのパフォーマンスメトリクス。

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
date	string	主キー。YYYY-MM-DD 形式の日付。
resource_name	string	主キー。Google 広告のリソース名。
ad_group_id	long	主キー。広告グループ ID。
campaign_id	long	主キー。キャンペーンID。
unexpanded_final_url	string	展開前のランディングページ URL。
impressions	long	インプレッション数。
clicks	long	クリック数。
cost_micros	long	コストはマイクロ単位です。通貨に変換するには 1,000,000 で割ります。
ctr	double	クリックスルー率。
average_cpc	double	クリックあたりの平均コスト。
mobile_friendly_clicks_percentage	double	モバイルフレンドリーなクリックの割合。
speed_score	long	モバイル速度スコア。
valid_accelerated_mobile_pages_clicks_percentage	double	有効なAMPクリックの割合。

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
date	string	主キー。YYYY-MM-DD 形式の日付。
resource_name	string	主キー。Google 広告のリソース名。
ad_group_id	long	主キー。広告グループ ID。
campaign_id	long	主キー。キャンペーンID。
unexpanded_final_url	string	展開前のランディングページ URL。
impressions	long	インプレッション数。
clicks	long	クリック数。
cost_micros	long	コストはマイクロ単位です。通貨に変換するには 1,000,000 で割ります。
ctr	double	クリックスルー率。
average_cpc	double	クリックあたりの平均コスト。
mobile_friendly_clicks_percentage	double	モバイルフレンドリーなクリックの割合。
speed_score	long	モバイル速度スコア。
valid_accelerated_mobile_pages_clicks_percentage	double	有効なAMPクリックの割合。

search_keyword_report

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

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
date	string	主キー。YYYY-MM-DD 形式の日付。
resource_name	string	主キー。Google 広告のリソース名。
ad_group_criterion_criterion_id	long	広告グループ基準（キーワード）ID。
ad_group_id	long	関連付けられた広告グループ ID。
campaign_id	long	関連付けられたキャンペーン ID。
impressions	long	インプレッション数。
clicks	long	クリック数。
cost_micros	long	コストはマイクロ単位です。通貨に変換するには 1,000,000 で割ります。
ctr	double	クリックスルー率。
average_cpc	double	クリックあたりの平均コスト。
conversions_value	double	合計コンバージョン値。
view_through_conversions	long	ビュースルーコンバージョン。

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
date	string	主キー。YYYY-MM-DD 形式の日付。
resource_name	string	主キー。Google 広告のリソース名。
ad_group_criterion_criterion_id	long	広告グループ基準（キーワード）ID。
ad_group_id	long	関連付けられた広告グループ ID。
campaign_id	long	関連付けられたキャンペーン ID。
impressions	long	インプレッション数。
clicks	long	クリック数。
cost_micros	long	コストはマイクロ単位です。通貨に変換するには 1,000,000 で割ります。
ctr	double	クリックスルー率。
average_cpc	double	クリックあたりの平均コスト。
conversions_value	double	合計コンバージョン値。
view_through_conversions	long	ビュースルーコンバージョン。

イベントテーブルのスキーマ

call_view

電話アセットおよび電話専用広告から追跡された通話。

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
resource_name	string	プライマリーキー。Google Ads リソース名（通話 ID）。
ad_group_id	long	プライマリーキー。通話が帰属する広告グループ。
campaign_id	long	プライマリーキー。通話が帰属するキャンペーン。
start_call_date_time	string	呼び出しが開始された日時。
end_call_date_time	string	通話が終了した日時。
caller_country_code	string	発信者の国コード。
caller_area_code	string	発信者の市外局番。
type	string	コールタイプ。
call_status	string	コールステータス。
call_tracking_display_location	string	コールトラッキング番号が表示されていた場所。
call_duration_seconds	long	呼び出し時間（秒）。

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
resource_name	string	プライマリーキー。Google Ads リソース名（通話 ID）。
ad_group_id	long	プライマリーキー。通話が帰属する広告グループ。
campaign_id	long	プライマリーキー。通話が帰属するキャンペーン。
start_call_date_time	string	呼び出しが開始された日時。
end_call_date_time	string	通話が終了した日時。
caller_country_code	string	発信者の国コード。
caller_area_code	string	発信者の市外局番。
type	string	コールタイプ。
call_status	string	コールステータス。
call_tracking_display_location	string	コールトラッキング番号が表示されていた場所。
call_duration_seconds	long	呼び出し時間（秒）。

lead_form_submission

リードフォームの送信。Google Adsアカウントへの標準アクセス権または管理者アクセス権が必要です。

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
id	string	プライマリーキー。リードフォーム送信ID。
ad_group_id	long	プライマリーキー。送信が帰属する広告グループ。
campaign_id	long	プライマリーキー。送信が帰属するキャンペーン。
resource_name	string	Google 広告のリソース名。
submission_date_time	string	フォームが送信されたとき。
ad_id	long	送信を生成した広告。
gclid	string	GoogleクリックID。
lead_form_submission_fields	array<string>	送信された標準フィールド値。
custom_lead_form_submission_fields	array<string>	送信されたカスタムフィールド値。

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
id	string	プライマリーキー。リードフォーム送信ID。
ad_group_id	long	プライマリーキー。送信が帰属する広告グループ。
campaign_id	long	プライマリーキー。送信が帰属するキャンペーン。
resource_name	string	Google 広告のリソース名。
submission_date_time	string	フォームが送信されたとき。
ad_id	long	送信を生成した広告。
gclid	string	GoogleクリックID。
lead_form_submission_fields	array<string>	送信された標準フィールド値。
custom_lead_form_submission_fields	array<string>	送信されたカスタムフィールド値。

local_services_lead

Local Services広告のリード。Local Servicesアカウントの行のみを返します。

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
id	long	プライマリーキー。リードID。
creation_date_time	string	リードが作成されたとき。
category_id	string	サービスカテゴリID。
service_id	string	サービス ID。
locale	string	リードのロケール。
lead_charged	boolean	広告主にリードの料金が請求されたかどうか。
lead_status	string	リードステータス。
lead_type	string	リードタイプ。
credit_details_credit_state	string	異議申し立て時のクレジット状態。
credit_details_credit_state_last_update_date_time	string	クレジットの状態が最後に更新された日時。
note_description	string	メモテキスト。
note_edit_date_time	string	メモが最後に編集されたとき。

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
id	long	プライマリーキー。リードID。
creation_date_time	string	リードが作成されたとき。
category_id	string	サービスカテゴリID。
service_id	string	サービス ID。
locale	string	リードのロケール。
lead_charged	boolean	広告主にリードの料金が請求されたかどうか。
lead_status	string	リードステータス。
lead_type	string	リードタイプ。
credit_details_credit_state	string	異議申し立て時のクレジット状態。
credit_details_credit_state_last_update_date_time	string	クレジットの状態が最後に更新された日時。
note_description	string	メモテキスト。
note_edit_date_time	string	メモが最後に編集されたとき。

local_services_lead_conversation

Local サービス 広告のリードに関する会話。Local Services アカウントの行のみを返します。

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
id	long	プライマリーキー。会話 ID。
event_date_time	string	会話イベントが発生した日時。
local_services_lead_id	long	親リードのID。
conversation_channel	string	会話チャンネル。
participant_type	string	会話を開始したユーザー。
message_details_text	string	メッセージテキスト。
message_details_attachment_urls	array<string>	添付ファイルの URL。
phone_call_details_call_duration_millis	long	通話時間（ミリ秒単位）。
phone_call_details_call_recording_url	string	通話録音URL。

列	データ型	説明
customer_id	long	主キー。顧客アカウントID。
id	long	プライマリーキー。会話 ID。
event_date_time	string	会話イベントが発生した日時。
local_services_lead_id	long	親リードのID。
conversation_channel	string	会話チャンネル。
participant_type	string	会話を開始したユーザー。
message_details_text	string	メッセージテキスト。
message_details_attachment_urls	array<string>	添付ファイルの URL。
phone_call_details_call_duration_millis	long	通話時間（ミリ秒単位）。
phone_call_details_call_recording_url	string	通話録音URL。

増分取り込み

レポートテーブルは、構成可能なルックバック期間を使用した増分取り込みをサポートしています。コネクタは、増分更新を追跡するためのカーソル列として date 列を使用します。リソーステーブルとイベントテーブルは、パイプラインのランごとに完全に更新されます。

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

カスタムレポート構成オプション

カスタムレポートを使用すると、リソースフィールド、セグメント、およびメトリクスの組み合わせで、任意のGoogle Adsリソースを選択できます。destination_table名は必須です。

source_tableをcustom_reportに設定し、connector_options.google_ads_optionsの配下でcustom_report_optionsを指定してください：

オプション	必須	説明
resource	はい	クエリーする Google Ads リソース (例: ad_group_ad、keyword_view、search_term_view)。リソースはメトリクスをサポートしている必要があります。
resource_fields	No	選択するリソースフィールド。完全修飾されたGAQL形式（例：ad_group_ad.ad.id、ad_group_ad.status）。リソース名はdefaultで追加されます。
segments	No	選択するセグメントフィールド（たとえば、segments.date、segments.device）。テーブルの増分カーソルとなるタイムラインセグメント— segments.date、segments.week、またはsegments.month —を少なくとも1つ含める必要があります。
metrics	No	選択するメトリクスフィールド（例：metrics.clicks、metrics.cost_micros）

オプション	必須	説明
resource	はい	クエリーする Google Ads リソース (例: ad_group_ad、keyword_view、search_term_view)。リソースはメトリクスをサポートしている必要があります。
resource_fields	No	選択するリソースフィールド。完全修飾されたGAQL形式（例：ad_group_ad.ad.id、ad_group_ad.status）。リソース名はdefaultで追加されます。
segments	No	選択するセグメントフィールド（たとえば、segments.date、segments.device）。テーブルの増分カーソルとなるタイムラインセグメント— segments.date、segments.week、またはsegments.month —を少なくとも1つ含める必要があります。
metrics	No	選択するメトリクスフィールド（例：metrics.clicks、metrics.cost_micros）

注意事項：

• 宛先列は標準の metrics. および segments. プレフィックスを省略します。リソース フィールドの場合、ピリオドはアンダースコアに変換されます (例: ad_group_ad.ad.id が ad_group_ad_ad_id になります)。
• 各行を識別するために、resource_name 属性は常に含まれます。
• プライマリーキーは、選択されたすべての resource_name と、選択されたすべてのセグメントです。これは、レポートリソース自身の resource_name と、 帰属する リソースごとに 1 つの resource_name を意味します。これは resource で指定されたリソース以外のリソースであり、ad_group_ad レポート上の campaign などが該当します。他のフィールドは主キーの一部ではありません。resource_name はすでにその行を一意に識別しており、アップストリームで変更される値（campaign.name など）をキーにすると、既存の行を更新するのではなく、重複する行が追加されてしまいます。
• 属性リソースからフィールドを選択するには、そのリソースの resource_name も選択してください。例えば、campaign.id を選択する ad_group_ad に関するレポートでは、campaign.resource_name も選択する必要があります。Google Ads は属性値ごとに 1 行を返すため、その resource_name がないと、それらの行は主キーを共有してしまい、更新が失敗します。パイプライン計画ではこれを確認し、追加する resource_name フィールドを一覧表示します。
• カスタム レポートの取り込みは、ルックバック ウィンドウに基づいてインクリメンタルです。
• Google広告は、日次および週次でセグメント化されたデータを37か月間のみ保持します。カスタムレポートでsegments.dateまたはsegments.weekを使用している場合、このウィンドウよりも古いデータは同期できません。古いデータにはsegments.monthを使用してください。
• パイプラインの計画では、Google Adsに対してフィールド名を検証します。タイムラインセグメントの欠落または無効なフィールドにより、更新が失敗します。データを移動せずに構成をテストするには、validate_only設定を使用します。