検索広告 360 レポートの変換
このドキュメントでは、検索広告 360 レポートを変換する方法について説明します。
以前の Search Ads 360 Reporting API を使った検索広告 360 レポートの変換については、検索広告 360 レポートの変換（サポート終了）をご覧ください。
検索広告 360 レポートのテーブル マッピング
検索広告 360 レポートを BigQuery に転送すると、レポートは次の BigQuery のテーブルとビューに変換されます。BigQuery でテーブルとビューを表示する場合、customer_id の値は、検索広告 360 の顧客 ID です。
ad_group
- テーブル:
-
p_sa_AdGroup_customer_id
p_sa_AdGroupConversionActionAndDeviceStats_customer_id
p_sa_AdGroupDeviceStats_customer_id
p_sa_AdGroupStats_customer_id - 視聴回数:
-
sa_AdGroup_customer_id
sa_AdGroupConversionActionAndDeviceStats_customer_id
sa_AdGroupDeviceStats_customer_id
sa_AdGroupStats_customer_id
ad_group_ad
- テーブル:
-
p_sa_Ad_customer_id
p_sa_AdConversionActionAndDeviceStats_customer_id
p_sa_AdDeviceStats_customer_id - 視聴回数:
-
a_Ad_customer_id
sa_AdConversionActionAndDeviceStats_customer_id
sa_AdDeviceStats_customer_id
ad_group_asset
- テーブル:
-
p_sa_AdGroupAssetStats_customer_id
p_sa_AdGroupConversionActionAndAssetStats_customer_id - 視聴回数:
-
sa_AdGroupAssetStats_customer_id
sa_AdGroupConversionActionAndAssetStats_customer_id
ad_group_audience_view
- テーブル:
-
p_sa_AdGroupAudienceConversionActionAndDeviceStats_customer_id
p_sa_AdGroupAudienceDeviceStats_customer_id - 視聴回数:
-
sa_AdGroupAudienceConversionActionAndDeviceStats_customer_id
sa_AdGroupAudienceDeviceStats_customer_id
ad_group_criterion
- テーブル:
-
p_sa_AdGroupCriterion_customer_id
p_sa_NegativeAdGroupCriterion_customer_id
p_sa_NegativeAdGroupKeyword_customer_id - 視聴回数:
-
sa_AdGroupCriterion_customer_id
sa_NegativeAdGroupCriterion_customer_id
sa_NegativeAdGroupKeyword_customer_id
age_range_view
- テーブル:
-
p_sa_AgeRangeConversionActionAndDeviceStats_customer_id
p_sa_AgeRangeDeviceStats_customer_id - 視聴回数:
-
sa_AgeRangeConversionActionAndDeviceStats_customer_id
sa_AgeRangeDeviceStats_customer_id
アセット
- テーブル:
- p_sa_Asset_customer_id
- 視聴回数:
- sa_Asset_customer_id
asset_set_asset
- テーブル:
-
p_sa_AccountConversionActionAndAssetStats_customer_id
p_sa_AssetSetStats_customer_id - 視聴回数:
-
sa_AccountConversionActionAndAssetStats_customer_id
sa_AssetSetStats_customer_id
bidding_strategy
- テーブル:
-
p_sa_BidStrategy_customer_id
p_sa_BidStrategyStats_customer_id - 視聴回数:
-
sa_BidStrategy_customer_id
sa_BidStrategyStats_customer_id
campaign
- テーブル:
-
p_sa_Campaign_customer_id
p_sa_CampaignConversionActionAndDeviceStats_customer_id
p_sa_CampaignDeviceStats_customer_id
p_sa_CampaignStats_customer_id - 視聴回数:
-
sa_Campaign_customer_id
sa_CampaignConversionActionAndDeviceStats_customer_id
sa_CampaignDeviceStats_customer_id
sa_CampaignStats_customer_id
campaign_asset
- テーブル:
-
p_sa_CampaignAssetStats_customer_id
p_sa_CampaignConversionActionAndAssetStats_customer_id - 視聴回数:
-
sa_CampaignAssetStats_customer_id
sa_CampaignConversionActionAndAssetStats_customer_id
campaign_audience_view
- テーブル:
-
p_sa_CampaignAudienceConversionActionAndDeviceStats_customer_id
p_sa_CampaignAudienceDeviceStats_customer_id - 視聴回数:
-
sa_CampaignAudienceConversionActionAndDeviceStats_customer_id
sa_CampaignAudienceDeviceStats_customer_id
campaign_criterion
- テーブル:
-
p_sa_CampaignCriterion_customer_id
p_sa_NegativeCampaignCriterion_customer_id
p_sa_NegativeCampaignKeyword_customer_id - 視聴回数:
-
sa_CampaignCriterion_customer_id
sa_NegativeCampaignCriterion_customer_id
sa_NegativeCampaignKeyword_customer_id
cart_data_sales_view
- テーブル:
- p_sa_CartDataSalesStats_customer_id
- 視聴回数:
- sa_CartDataSalesStats_customer_id
conversion
- テーブル:
- p_sa_Conversion_customer_id
- 視聴回数:
- sa_Conversion_customer_id
conversion_action
- テーブル:
- p_sa_ConversionAction_customer_id
- 視聴回数:
- sa_ConversionAction_customer_id
顧客
- テーブル:
-
p_sa_Account_customer_id
p_sa_AccountConversionActionAndDeviceStats_customer_id
p_sa_AccountDeviceStats_customer_id
p_sa_AccountStats_customer_id - 視聴回数:
-
sa_Account_customer_id
sa_AccountConversionActionAndDeviceStats_customer_id
sa_AccountDeviceStats_customer_id
sa_AccountStats_customer_id
customer_asset
- テーブル:
- p_sa_AccountAssetStats_customer_id
- 視聴回数:
- sa_AccountAssetStats_customer_id
gender_view
- テーブル:
-
p_sa_GenderConversionActionAndDeviceStats_customer_id
p_sa_GenderDeviceStats_customer_id - 視聴回数:
-
sa_GenderConversionActionAndDeviceStats_customer_id
sa_GenderDeviceStats_customer_id
keyword_view
- テーブル:
-
p_sa_Keyword_customer_id
p_sa_KeywordConversionActionAndDeviceStats_customer_id
p_sa_KeywordDeviceStats_customer_id
p_sa_KeywordStats_customer_id - 視聴回数:
-
sa_Keyword_customer_id
sa_KeywordConversionActionAndDeviceStats_customer_id
sa_KeywordDeviceStats_customer_id
sa_KeywordStats_customer_id
location_view
- テーブル:
-
p_sa_LocationConversionActionAndDeviceStats_customer_id
p_sa_LocationDeviceStats_customer_id - 視聴回数:
-
sa_LocationConversionActionAndDeviceStats_customer_id
sa_LocationDeviceStats_customer_id
product_group_view
- テーブル:
-
p_sa_ProductGroup_customer_id
p_sa_ProductGroupStats_customer_id - 視聴回数:
-
sa_ProductGroup_customer_id
sa_ProductGroupStats_customer_id
shopping_performance_view
- テーブル:
-
p_sa_ProductAdvertised_customer_id
p_sa_ProductAdvertisedConversionActionAndDeviceStats_customer_id
p_sa_ProductAdvertisedDeviceStats_customer_id - 視聴回数:
-
sa_ProductAdvertised_customer_id
sa_ProductAdvertisedConversionActionAndDeviceStats_customer_id
sa_ProductAdvertisedDeviceStats_customer_id
アクセス
- テーブル:
- p_sa_Visit_customer_id
- 視聴回数:
- sa_Visit_customer_id
webpage_view
- テーブル:
-
p_sa_WebpageConversionActionAndDeviceStats_customer_id
p_sa_WebpageDeviceStats_customer_id - 視聴回数:
-
sa_WebpageConversionActionAndDeviceStats_customer_id
sa_WebpageDeviceStats_customer_id
検索広告 360 レポートの列の詳細
検索広告 360 の転送によって作成される BigQuery テーブルは、次の列（フィールド）で構成されます。
検索広告 360 テーブル名: Account
Search Ads 360 API リソース: customer
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| customer_account_type | エンジン アカウントのタイプ。（例: Google 広告、Microsoft Advertising、Yahoo! JAPAN、Baidu、Facebook、エンジン トラッキング）。 |
| customer_creation_time | この顧客が作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
| customer_currency_code | アカウントが運用されている通貨。ISO 4217 標準の通貨コードのサブセットがサポートされています。 |
| customer_descriptive_name | 顧客の一意でないわかりやすい名前（省略可）。 |
| customer_engine_id | 外部エンジン アカウントのアカウント ID。 |
| customer_id | 顧客の ID。 |
| customer_last_modified_time | この顧客が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
| customer_status | 顧客のステータス。 |
| customer_time_zone | 顧客のローカル タイムゾーン ID。 |
検索広告 360 テーブル名: AccountAssetStats
Search Ads 360 API リソース: customer_asset
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| customer_asset_asset | 必須。不変。顧客に関連付けられているアセット。 |
| customer_id | 顧客の ID。 |
| metrics_average_cpc | すべてのクリックの合計費用を、発生したクリックの合計数で割った値です。 |
| metrics_average_cpm | 平均インプレッション単価（CPM）。 |
| metrics_clicks | クリック数です。 |
| metrics_client_account_conversions | クライアント アカウントのコンバージョン数。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_conversions_value | クライアント アカウントのコンバージョン値。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_cost_micros | 指定された期間における、クリック単価（CPC）による費用とインプレッション単価（CPM）による費用の総額です。 |
| metrics_ctr | 広告から発生したクリック数（クリック数）を、広告が表示された回数（インプレッション数）で割った値です。 |
| metrics_impressions | 検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
検索広告 360 テーブル名: AccountConversionActionAndAssetStats
Search Ads 360 API リソース: asset_set_asset
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| asset_set_asset_asset | 不変。このアセットセットのアセットがリンクしているアセット。 |
| asset_set_asset_asset_set | 不変。このアセットセットのアセットがリンクしているアセットセット。 |
| customer_id | 顧客の ID。 |
| metrics_all_conversions | コンバージョンの合計数です。これには、include_in_conversions_metric の値に関係なく、すべてのコンバージョンが含まれます。 |
| metrics_all_conversions_value | すべてのコンバージョン値。 |
| metrics_cross_device_conversions | ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、all_conversions にすでに含まれています。 |
| metrics_cross_device_conversions_value | クロスデバイス コンバージョンの合計値。 |
| segments.conversion_action_name | コンバージョン アクション名。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
検索広告 360 テーブル名: AccountConversionActionAndDeviceStats
Search Ads 360 API リソース: customer
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| customer_engine_id | 外部エンジン アカウントのアカウント ID。 |
| customer_id | 顧客の ID。 |
| metrics_all_conversions | コンバージョンの合計数です。これには、include_in_conversions_metric の値に関係なく、すべてのコンバージョンが含まれます。 |
| metrics_all_conversions_value | すべてのコンバージョン値。 |
| metrics_cross_device_conversions | ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、all_conversions にすでに含まれています。 |
| metrics_cross_device_conversions_value | クロスデバイス コンバージョンの合計値。 |
| segments.conversion_action_name | コンバージョン アクション名。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: AccountDeviceStats
Search Ads 360 API リソース: customer
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| customer_engine_id | 外部エンジン アカウントのアカウント ID。 |
| customer_id | 顧客の ID。 |
| metrics_average_cpc | すべてのクリックの合計費用を、発生したクリックの合計数で割った値です。 |
| metrics_average_cpm | 平均インプレッション単価（CPM）。 |
| metrics_clicks | クリック数です。 |
| metrics_client_account_conversions | クライアント アカウントのコンバージョン数。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_conversions_value | クライアント アカウントのコンバージョン値。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_view_through_conversions | ビュースルー コンバージョンの合計数。この状況は、ユーザーが画像や動画広告を閲覧した後、別の広告を操作（クリックなど）することなく、サイトでコンバージョンに至ると発生します。 |
| metrics_cost_micros | 指定された期間における、クリック単価（CPC）による費用とインプレッション単価（CPM）による費用の総額です。 |
| metrics_ctr | 広告から発生したクリック数（クリック数）を、広告が表示された回数（インプレッション数）で割った値です。 |
| metrics_impressions | 検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。 |
| metrics_visits | 検索広告 360 で正常に記録され、広告主のランディング ページに転送されたクリック数。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: AccountStats
Search Ads 360 API リソース: customer
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| customer_engine_id | 外部エンジン アカウントのアカウント ID。 |
| customer_id | 顧客の ID。 |
| metrics_content_budget_lost_impression_share | 予算が少なすぎるために、検索ネットワークで表示可能だったものの、表示されなかった回数の推定される割合。注: 検索予算のインプレッション シェア損失率は、0 ～ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。 |
| metrics_content_impression_share | ディスプレイ ネットワークでお客様が実際に獲得したインプレッションの回数を、お客様の広告が表示候補となった推定回数で割ったものです。注: コンテンツのインプレッション シェアは 0.1 ～ 1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。 |
| metrics_content_rank_lost_impression_share | 広告ランクが低いために、広告がディスプレイ ネットワークで獲得できなかったインプレッションの推測割合。注: コンテンツ ランクのインプレッション シェア損失率は 0 ～ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。 |
| metrics_historical_quality_score | 品質スコア（履歴）。 |
| metrics_search_budget_lost_impression_share | 予算が少なすぎるために、検索ネットワークで表示可能だったものの、表示されなかった回数の推定される割合。注: 検索予算のインプレッション シェア損失率は、0 ～ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。 |
| metrics_search_impression_share | 検索ネットワークでお客様が実際に獲得したインプレッションの回数を、お客様の広告が表示候補となった推定回数で割ったものです。注: 検索広告のインプレッション シェアは、0.1 ～ 1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。 |
| metrics_search_rank_lost_impression_share | 広告ランクが低いために、広告が検索ネットワークで獲得できなかったインプレッションの推測割合。注: 検索ランクのインプレッション シェア損失率は、0 ～ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
検索広告 360 テーブル名: 広告
Search Ads 360 API リソース: ad_group_ad
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_ad_ad_display_url | 一部の広告フォーマットの広告説明に表示される URL。 |
| ad_group_ad_ad_expanded_dynamic_search_ad_description1 | 広告の説明欄の 1 行目。 |
| ad_group_ad_ad_expanded_dynamic_search_ad_description2 | 広告の説明欄の 2 行目。 |
| ad_group_ad_ad_expanded_text_ad_description1 | 広告の説明欄の 1 行目。 |
| ad_group_ad_ad_expanded_text_ad_description2 | 広告の説明欄の 2 行目。 |
| ad_group_ad_ad_expanded_text_ad_headline | 広告の見出しです。 |
| ad_group_ad_ad_expanded_text_ad_headline2 | 広告の 2 番目の見出し。 |
| ad_group_ad_ad_expanded_text_ad_headline3 | 広告の 3 番目の見出し。 |
| ad_group_ad_ad_final_urls | 広告のすべてのクロスドメイン リダイレクトの後に可能性のある最終ページ URL のリスト。 |
| ad_group_ad_ad_id | 広告の ID です。 |
| ad_group_ad_ad_name | 広告の名前。広告を識別するためにのみ使用されます。一意である必要はなく、配信される広告には影響しません。name フィールドは現在、DisplayUploadAd、ImageAd、ShoppingComparisonListingAd、VideoAd でのみサポートされています。 |
| ad_group_ad_ad_text_ad_description1 | 広告の説明欄の 1 行目。 |
| ad_group_ad_ad_text_ad_description2 | 広告の説明欄の 2 行目。 |
| ad_group_ad_ad_text_ad_headline | 広告の見出しです。 |
| ad_group_ad_ad_type | 広告タイプ。 |
| ad_group_ad_creation_time | この広告グループの広告が作成されたときのタイムスタンプ。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
| ad_group_ad_engine_id | 外部エンジン アカウントの広告の ID。このフィールドは検索広告 360 アカウント専用です。（例: Yahoo! JAPAN、Microsoft、Baidu）。検索広告 360 以外のエンティティの場合は、代わりに「ad_group_ad.ad.id」を使用します。 |
| ad_group_ad_engine_status | 外部エンジン アカウントの広告の追加ステータス。外部アカウントの種類によって、アクティブ、有効、確認待ちなどのステータスが表示されます。 |
| ad_group_ad_labels | この広告グループの広告に適用されているラベルのリソース名。 |
| ad_group_ad_last_modified_time | この広告グループの広告が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
| ad_group_ad_status | 広告のステータスです。 |
| ad_group_id | 広告グループの ID です。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
検索広告 360 テーブル名: AdConversionActionAndDeviceStats
Search Ads 360 API リソース: ad_group_ad
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_ad_ad_id | 広告の ID です。 |
| ad_group_ad_engine_id | 外部エンジン アカウントの広告の ID。このフィールドは検索広告 360 アカウント専用です。（例: Yahoo! JAPAN、Microsoft、Baidu）。検索広告 360 以外のエンティティの場合は、代わりに「ad_group_ad.ad.id」を使用します。 |
| ad_group_id | 広告グループの ID です。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_all_conversions | コンバージョンの合計数です。これには、include_in_conversions_metric の値に関係なく、すべてのコンバージョンが含まれます。 |
| metrics_all_conversions_by_conversion_date | コンバージョンの合計数です。これには、include_in_conversions_metric の値に関係なく、すべてのコンバージョンが含まれます。この列が日付とともに選択されている場合、日付列の値はコンバージョンの日付を表します。by_conversion_date 列の詳細については、[すべてのコンバージョン] 列についてをご覧ください。 |
| metrics_all_conversions_value | すべてのコンバージョン値。 |
| metrics_all_conversions_value_by_conversion_date | すべてのコンバージョンの値。この列が日付とともに選択されている場合、日付列の値はコンバージョンの日付を表します。by_conversion_date 列の詳細については、[すべてのコンバージョン] 列についてをご覧ください。 |
| metrics_cross_device_conversions | ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、all_conversions にすでに含まれています。 |
| metrics_cross_device_conversions_by_conversion_date | コンバージョンの日付別のクロスデバイス コンバージョン数。by_conversion_date 列の詳細については、[すべてのコンバージョン] 列についてをご覧ください。 |
| metrics_cross_device_conversions_value | クロスデバイス コンバージョンの合計値。 |
| metrics_cross_device_conversions_value_by_conversion_date | コンバージョンの日付別のクロスデバイス コンバージョン値の合計。by_conversion_date 列の詳細については、[すべてのコンバージョン] 列についてをご覧ください。 |
| segments.conversion_action_name | コンバージョン アクション名。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: AdDeviceStats
Search Ads 360 API リソース: ad_group_ad
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_ad_ad_id | 広告の ID です。 |
| ad_group_ad_engine_id | 外部エンジン アカウントの広告の ID。このフィールドは検索広告 360 アカウント専用です。（例: Yahoo! JAPAN、Microsoft、Baidu）。検索広告 360 以外のエンティティの場合は、代わりに「ad_group_ad.ad.id」を使用します。 |
| ad_group_id | 広告グループの ID です。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_average_cpc | すべてのクリックの合計費用を、発生したクリックの合計数で割った値です。 |
| metrics_average_cpm | 平均インプレッション単価（CPM）。 |
| metrics_clicks | クリック数です。 |
| metrics_client_account_conversions | クライアント アカウントのコンバージョン数。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_conversions_value | クライアント アカウントのコンバージョン値。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_view_through_conversions | ビュースルー コンバージョンの合計数。この状況は、ユーザーが画像や動画広告を閲覧した後、別の広告を操作（クリックなど）することなく、サイトでコンバージョンに至ると発生します。 |
| metrics_cost_micros | 指定された期間における、クリック単価（CPC）による費用とインプレッション単価（CPM）による費用の総額です。 |
| metrics_ctr | 広告から発生したクリック数（クリック数）を、広告が表示された回数（インプレッション数）で割った値です。 |
| metrics_impressions | 検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。 |
| metrics_visits | 検索広告 360 で正常に記録され、広告主のランディング ページに転送されたクリック数。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: AdGroup
Search Ads 360 API リソース: ad_group
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_bid_modifier_bid_modifier | 条件が一致した場合の入札の修飾子。修飾子は 0.1 ～ 10.0 の範囲内にする必要があります。PreferredContent の範囲は 1.0 ～ 6.0 です。デバイスタイプをオプトアウトするには、0 を使用します。 |
| ad_group_bid_modifier_device_type | 端末のタイプ。 |
| ad_group_cpc_bid_micros | 最大 CPC（クリック単価）入札。 |
| ad_group_creation_time | この広告グループが作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
| ad_group_end_date | 広告グループの広告配信を終了する日付。デフォルトでは、広告グループは広告グループの終了日に終了します。このフィールドが設定されている場合、ユーザーのタイムゾーンで指定の日付に広告グループが終了します。このフィールドは、Microsoft Advertising アカウントと Facebook ゲートウェイ アカウントでのみ使用できます。形式: YYYY-MM-DD 例: 2019-03-14 |
| ad_group_engine_id | 外部エンジン アカウントの広告グループの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます。（例: Yahoo! JAPAN、Microsoft、Baidu）。Google 広告エンティティの場合は、代わりに「ad_group.id」を使用します。 |
| ad_group_engine_status | 広告グループのエンジン ステータス。 |
| ad_group_id | 広告グループの ID です。 |
| ad_group_labels | この広告グループに適用されているラベルのリソース名。 |
| ad_group_language_code | 広告グループ内の広告とキーワードの言語。このフィールドは、Microsoft Advertising アカウントでのみご利用いただけます。 |
| ad_group_last_modified_time | この広告グループが最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
| ad_group_name | 広告グループの名前です。このフィールドは必須で、新しい広告グループを作成する場合は空にしないでください。含めることができる文字は、UTF-8 の全角で 255 文字未満にする必要があります。null（コードポイント 0x0）、NL ラインフィード（コードポイント 0xA）、改行（コードポイント 0xD）の文字を含めることはできません。 |
| ad_group_start_date | この広告グループの広告配信を開始する日付。デフォルトでは、広告グループの開始日は、現在または開始日のいずれか遅い方になります。このフィールドを設定した場合、ユーザーのタイムゾーンで指定の日付の開始時間に広告グループが開始されます。このフィールドは、Microsoft Advertising アカウントと Facebook ゲートウェイ アカウントでのみ使用できます。形式: YYYY-MM-DD 例: 2019-03-14 |
| ad_group_status | 広告グループのステータス。 |
| ad_group_targeting_setting_target_restrictions | ターゲティング ディメンションごとに、キャンペーンまたは広告グループのリーチを制限する設定。 |
| bidding_strategy_id | 入札戦略の ID。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
検索広告 360 テーブル名: AdGroupAssetStats
Search Ads 360 API リソース: ad_group_asset
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_asset_ad_group | 必須。不変。アセットがリンクされている広告グループ。 |
| ad_group_asset_asset | 必須。不変。広告グループにリンクされているアセットです。 |
| ad_group_engine_id | 外部エンジン アカウントの広告グループの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます。（例: Yahoo! JAPAN、Microsoft、Baidu）。Google 広告エンティティの場合は、代わりに「ad_group.id」を使用します。 |
| ad_group_id | 広告グループの ID です。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_average_cpc | すべてのクリックの合計費用を、発生したクリックの合計数で割った値です。 |
| metrics_average_cpm | 平均インプレッション単価（CPM）。 |
| metrics_clicks | クリック数です。 |
| metrics_client_account_conversions | クライアント アカウントのコンバージョン数。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_conversions_value | クライアント アカウントのコンバージョン値。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_cost_micros | 指定された期間における、クリック単価（CPC）による費用とインプレッション単価（CPM）による費用の総額です。 |
| metrics_ctr | 広告から発生したクリック数（クリック数）を、広告が表示された回数（インプレッション数）で割った値です。 |
| metrics_impressions | 検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
検索広告 360 テーブル名: AdGroupAudienceConversionActionAndDeviceStats
Search Ads 360 API リソース: ad_group_audience_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_criterion_age_range_type | 年齢層のタイプ。 |
| ad_group_criterion_bid_modifier | 条件が一致した場合の入札の修飾子。修飾子は 0.1 ～ 10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。 |
| ad_group_criterion_cpc_bid_micros | クリック単価（CPC）。 |
| ad_group_criterion_criterion_id | 条件の ID。 |
| ad_group_criterion_gender_type | 性別のタイプ。 |
| ad_group_criterion_location_geo_target_constant | 地域ターゲティングの定数リソース名。 |
| ad_group_criterion_user_list_user_list | ユーザーリストのリソース名。 |
| ad_group_criterion_webpage_conditions | ウェブページ ターゲティングの条件または論理式。ターゲティングの評価時に、ウェブページのターゲティング条件のリストが 1 つにまとめられます。条件のリストが空の場合は、キャンペーンのウェブサイトのすべてのページがターゲットに設定されていることを示します。このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
| ad_group_criterion_webpage_coverage_percentage | ウェブサイトの条件カバレッジの割合。広告グループとキャンペーンのウェブサイト ターゲット、除外ウェブサイト ターゲット、除外キーワードに基づいて計算されたウェブサイトのカバレッジの割合。たとえば、カバレッジが 1 の場合は、カバレッジが 100% であることを示します。 |
| ad_group_id | 広告グループの ID です。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_cross_device_conversions | ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、all_conversions にすでに含まれています。 |
| metrics_cross_device_conversions_value | クロスデバイス コンバージョンの合計値。 |
| segments.conversion_action_name | コンバージョン アクション名。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17。 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: AdGroupAudienceDeviceStats
Search Ads 360 API リソース: ad_group_audience_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_criterion_age_range_type | 年齢層のタイプ。 |
| ad_group_criterion_bid_modifier | 条件が一致した場合の入札の修飾子。修飾子は 0.1 ～ 10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。 |
| ad_group_criterion_cpc_bid_micros | クリック単価（CPC）。 |
| ad_group_criterion_criterion_id | 条件の ID。 |
| ad_group_criterion_gender_type | 性別のタイプ。 |
| ad_group_criterion_location_geo_target_constant | 地域ターゲティングの定数リソース名。 |
| ad_group_criterion_user_list_user_list | ユーザーリストのリソース名。 |
| ad_group_criterion_webpage_conditions | ウェブページ ターゲティングの条件または論理式。ターゲティングの評価時に、ウェブページのターゲティング条件のリストが 1 つにまとめられます。条件のリストが空の場合は、キャンペーンのウェブサイトのすべてのページがターゲットに設定されていることを示します。このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
| ad_group_criterion_webpage_coverage_percentage | ウェブサイトの条件カバレッジの割合。広告グループとキャンペーンのウェブサイト ターゲット、除外ウェブサイト ターゲット、除外キーワードに基づいて計算されたウェブサイトのカバレッジの割合。たとえば、カバレッジが 1 の場合は、カバレッジが 100% であることを示します。 |
| ad_group_id | 広告グループの ID です。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_average_cpc | すべてのクリックの合計費用を、発生したクリックの合計数で割った値です。 |
| metrics_average_cpm | 平均インプレッション単価（CPM）。 |
| metrics_clicks | クリック数です。 |
| metrics_client_account_conversions | クライアント アカウントのコンバージョン数。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_conversions_value | クライアント アカウントのコンバージョン値。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_view_through_conversions | ビュースルー コンバージョンの合計数。この状況は、ユーザーが画像や動画広告を閲覧した後、別の広告を操作（クリックなど）することなく、サイトでコンバージョンに至ると発生します。 |
| metrics_cost_micros | 指定された期間における、クリック単価（CPC）による費用とインプレッション単価（CPM）による費用の総額です。 |
| metrics_ctr | 広告から発生したクリック数（クリック数）を、広告が表示された回数（インプレッション数）で割った値です。 |
| metrics_impressions | 検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: AdGroupConversionActionAndAssetStats
Search Ads 360 API リソース: ad_group_asset
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_asset_ad_group | 必須。不変。アセットがリンクされている広告グループ。 |
| ad_group_asset_asset | 必須。不変。広告グループにリンクされているアセットです。 |
| ad_group_engine_id | 外部エンジン アカウントの広告グループの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます。（例: Yahoo! JAPAN、Microsoft、Baidu）。Google 広告エンティティの場合は、代わりに「ad_group.id」を使用します。 |
| ad_group_id | 広告グループの ID です。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_all_conversions | コンバージョンの合計数です。これには、include_in_conversions_metric の値に関係なく、すべてのコンバージョンが含まれます。 |
| metrics_all_conversions_value | すべてのコンバージョン値。 |
| metrics_cross_device_conversions | ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、all_conversions にすでに含まれています。 |
| metrics_cross_device_conversions_value | クロスデバイス コンバージョンの合計値。 |
| segments.conversion_action_name | コンバージョン アクション名。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2018-04-17 |
検索広告 360 テーブル名: AdGroupConversionActionAndDeviceStats
Search Ads 360 API リソース: ad_group
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_engine_id | 出力のみ。外部エンジン アカウントの広告グループの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます。（例: Yahoo! JAPAN、Microsoft、Baidu）。Google 広告エンティティの場合は、代わりに「ad_group.id」を使用します。 |
| ad_group_id | 出力専用。広告グループの ID です。 |
| bidding_strategy_id | 出力のみ。入札戦略の ID。 |
| campaign_id | 出力のみ。キャンペーンの ID です。 |
| customer_id | 出力のみ。顧客の ID。 |
| metrics_all_conversions | コンバージョンの合計数です。これには、include_in_conversions_metric の値に関係なく、すべてのコンバージョンが含まれます。 |
| metrics_all_conversions_value | すべてのコンバージョン値。 |
| metrics_cross_device_conversions | ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、all_conversions にすでに含まれています。 |
| metrics_cross_device_conversions_value | クロスデバイス コンバージョンの合計値。 |
| segments.conversion_action_name | コンバージョン アクション名。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: AdGroupCriterion
Search Ads 360 API リソース: ad_group_criterion
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_criterion_age_range_type | 年齢層のタイプ。 |
| ad_group_criterion_bid_modifier | 条件が一致した場合の入札の修飾子。修飾子は 0.1 ～ 10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。 |
| ad_group_criterion_cpc_bid_micros | クリック単価（CPC）。 |
| ad_group_criterion_creation_time | この広告グループの条件が作成された時点のタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
| ad_group_criterion_criterion_id | 条件の ID。 |
| ad_group_criterion_gender_type | 性別のタイプ。 |
| ad_group_criterion_last_modified_time | この広告グループの条件が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
| ad_group_criterion_location_geo_target_constant | 地域ターゲティングの定数リソース名。 |
| ad_group_criterion_status | 条件のステータス。これは、クライアントが設定した広告グループの条件エンティティのステータスです。注: UI レポートには、条件を実行できるかどうかに影響する追加情報が含まれている場合があります。API では「削除済み」である条件でも、管理画面では有効と表示されることがあります。たとえば、除外していない限り、デフォルトですべての年齢層のユーザーにキャンペーンが表示されます。対象の年齢層は広告が表示されるため、UI には「有効」と表示されます。しかし、非除外条件が追加されていないため、AdGroupCriterion.status には「removed」と表示されます。 |
| ad_group_criterion_type | 条件のタイプ。 |
| ad_group_criterion_user_list_user_list | ユーザーリストのリソース名。 |
| ad_group_criterion_webpage_conditions | ウェブページ ターゲティングの条件または論理式。ターゲティングの評価時に、ウェブページのターゲティング条件のリストが 1 つにまとめられます。条件のリストが空の場合は、キャンペーンのウェブサイトのすべてのページがターゲットに設定されていることを示します。このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
| ad_group_criterion_webpage_coverage_percentage | ウェブサイトの条件カバレッジの割合。広告グループとキャンペーンのウェブサイト ターゲット、除外ウェブサイト ターゲット、除外キーワードに基づいて計算されたウェブサイトのカバレッジの割合。たとえば、カバレッジが 1 の場合は、カバレッジが 100% であることを示します。 |
| ad_group_id | 広告グループの ID です。 |
| ad_group_name | 広告グループの名前です。このフィールドは必須で、新しい広告グループを作成する場合は空にしないでください。含めることができる文字は、UTF-8 の全角で 255 文字未満にする必要があります。null（コードポイント 0x0）、NL ラインフィード（コードポイント 0xA）、改行（コードポイント 0xD）の文字を含めることはできません。 |
| ad_group_status | 広告グループのステータス。 |
| campaign_id | キャンペーンの ID です。 |
| campaign_name | キャンペーンの名前です。新しいキャンペーンを作成する場合、このフィールドは必須です。空にすることはできません。null（コードポイント 0x0）、NL ラインフィード（コードポイント 0xA）、改行（コードポイント 0xD）の文字を含めることはできません。 |
| campaign_status | キャンペーンのステータス。 |
| customer_account_type | エンジン アカウントのタイプ。（例: Google 広告、Microsoft Advertising、Yahoo! JAPAN、Baidu、Facebook、エンジン トラッキング）。 |
| customer_descriptive_name | 顧客の一意でないわかりやすい名前（省略可）。 |
| customer_id | 顧客の ID。 |
検索広告 360 テーブル名: AdGroupDeviceStats
Search Ads 360 API リソース: ad_group
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_engine_id | 外部エンジン アカウントの広告グループの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます。（例: Yahoo! JAPAN、Microsoft、Baidu）。Google 広告エンティティの場合は、代わりに「ad_group.id」を使用します。 |
| ad_group_id | 広告グループの ID です。 |
| bidding_strategy_id | 入札戦略の ID。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_average_cpc | すべてのクリックの合計費用を、発生したクリックの合計数で割った値です。 |
| metrics_average_cpm | 平均インプレッション単価（CPM）。 |
| metrics_clicks | クリック数です。 |
| metrics_client_account_conversions | クライアント アカウントのコンバージョン数。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_conversions_value | クライアント アカウントのコンバージョン値。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_view_through_conversions | ビュースルー コンバージョンの合計数。この状況は、ユーザーが画像や動画広告を閲覧した後、別の広告を操作（クリックなど）することなく、サイトでコンバージョンに至ると発生します。 |
| metrics_cost_micros | 指定された期間における、クリック単価（CPC）による費用とインプレッション単価（CPM）による費用の総額です。 |
| metrics_ctr | 広告から発生したクリック数（クリック数）を、広告が表示された回数（インプレッション数）で割った値です。 |
| metrics_impressions | 検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。 |
| metrics_visits | 検索広告 360 で正常に記録され、広告主のランディング ページに転送されたクリック数。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: AdGroupStats
Search Ads 360 API リソース: ad_group
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_engine_id | 外部エンジン アカウントの広告グループの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます。（例: Yahoo! JAPAN、Microsoft、Baidu）。Google 広告エンティティの場合は、代わりに「ad_group.id」を使用します。 |
| ad_group_id | 広告グループの ID です。 |
| bidding_strategy_id | 入札戦略の ID。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_content_impression_share | ディスプレイ ネットワークでお客様が実際に獲得したインプレッションの回数を、お客様の広告が表示候補となった推定回数で割ったものです。注: コンテンツのインプレッション シェアは 0.1 ～ 1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。 |
| metrics_content_rank_lost_impression_share | 広告ランクが低いために、広告がディスプレイ ネットワークで獲得できなかったインプレッションの推測割合。注: コンテンツ ランクのインプレッション シェア損失率は 0 ～ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。 |
| metrics_historical_quality_score | 品質スコア（履歴）。 |
| metrics_search_impression_share | 検索ネットワークでお客様が実際に獲得したインプレッションの回数を、お客様の広告が表示候補となった推定回数で割ったものです。注: 検索広告のインプレッション シェアは、0.1 ～ 1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。 |
| metrics_search_rank_lost_impression_share | 広告ランクが低いために、広告が検索ネットワークで獲得できなかったインプレッションの推測割合。注: 検索ランクのインプレッション シェア損失率は、0 ～ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17。 |
検索広告 360 テーブル名: AgeRangeConversionActionAndDeviceStats
Search Ads 360 API リソース: age_range_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_criterion_age_range_type | 年齢層のタイプ。 |
| ad_group_criterion_bid_modifier | 条件が一致した場合の入札の修飾子。修飾子は 0.1 ～ 10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。 |
| ad_group_criterion_cpc_bid_micros | クリック単価（CPC）。 |
| ad_group_criterion_criterion_id | 条件の ID。 |
| ad_group_criterion_gender_type | 性別のタイプ。 |
| ad_group_criterion_location_geo_target_constant | 地域ターゲティングの定数リソース名。 |
| ad_group_criterion_user_list_user_list | ユーザーリストのリソース名。 |
| ad_group_criterion_webpage_conditions | ウェブページ ターゲティングの条件または論理式。ターゲティングの評価時に、ウェブページのターゲティング条件のリストが 1 つにまとめられます。条件のリストが空の場合は、キャンペーンのウェブサイトのすべてのページがターゲットに設定されていることを示します。このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
| ad_group_criterion_webpage_coverage_percentage | ウェブサイトの条件カバレッジの割合。広告グループとキャンペーンのウェブサイト ターゲット、除外ウェブサイト ターゲット、除外キーワードに基づいて計算されたウェブサイトのカバレッジの割合。たとえば、カバレッジが 1 の場合は、カバレッジが 100% であることを示します。 |
| ad_group_id | 広告グループの ID です。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_cross_device_conversions | ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、all_conversions にすでに含まれています。 |
| metrics_cross_device_conversions_value | クロスデバイス コンバージョンの合計値。 |
| segments.conversion_action_name | コンバージョン アクション名。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: AgeRangeDeviceStats
Search Ads 360 API リソース: age_range_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_criterion_age_range_type | 年齢層のタイプ。 |
| ad_group_criterion_bid_modifier | 条件が一致した場合の入札の修飾子。修飾子は 0.1 ～ 10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。 |
| ad_group_criterion_cpc_bid_micros | クリック単価（CPC）。 |
| ad_group_criterion_criterion_id | 条件の ID。 |
| ad_group_criterion_gender_type | 性別のタイプ。 |
| ad_group_criterion_location_geo_target_constant | 地域ターゲティングの定数リソース名。 |
| ad_group_criterion_user_list_user_list | ユーザーリストのリソース名。 |
| ad_group_criterion_webpage_conditions | ウェブページ ターゲティングの条件または論理式。ターゲティングの評価時に、ウェブページのターゲティング条件のリストが 1 つにまとめられます。条件のリストが空の場合は、キャンペーンのウェブサイトのすべてのページがターゲットに設定されていることを示します。このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
| ad_group_criterion_webpage_coverage_percentage | ウェブサイトの条件カバレッジの割合。広告グループとキャンペーンのウェブサイト ターゲット、除外ウェブサイト ターゲット、除外キーワードに基づいて計算されたウェブサイトのカバレッジの割合。たとえば、カバレッジが 1 の場合は、カバレッジが 100% であることを示します。 |
| ad_group_id | 広告グループの ID です。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_average_cpc | すべてのクリックの合計費用を、発生したクリックの合計数で割った値です。 |
| metrics_average_cpm | 平均インプレッション単価（CPM）。 |
| metrics_clicks | クリック数です。 |
| metrics_client_account_conversions | クライアント アカウントのコンバージョン数。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_conversions_value | クライアント アカウントのコンバージョン値。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_view_through_conversions | ビュースルー コンバージョンの合計数。この状況は、ユーザーが画像や動画広告を閲覧した後、別の広告を操作（クリックなど）することなく、サイトでコンバージョンに至ると発生します。 |
| metrics_cost_micros | 指定された期間における、クリック単価（CPC）による費用とインプレッション単価（CPM）による費用の総額です。 |
| metrics_ctr | 広告から発生したクリック数（クリック数）を、広告が表示された回数（インプレッション数）で割った値です。 |
| metrics_impressions | 検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: Asset
Search Ads 360 API リソース: asset
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| asset_creation_time | この求人が作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
| asset_engine_status | アセットのエンジン ステータス。 |
| asset_final_urls | すべてのクロスドメイン リダイレクト後の最終ページ URL のリスト。 |
| asset_id | アセットの ID です。 |
| asset_last_modified_time | このアセットが最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
| asset_sitelink_asset.description1 | サイトリンクの説明の 1 行目。設定する場合は、長さを 1～35 の範囲で設定し、description2 も設定する必要があります。 |
| asset_sitelink_asset.description2 | サイトリンクの説明の 2 行目。設定する場合、長さは 1～35 の範囲で指定する必要があります。また、description1 も設定する必要があります。 |
| asset_sitelink_asset_link_text | サイトリンクの URL 表示テキスト。この文字列の長さは 1～25 で指定します。 |
| asset_status | アセットのステータス。 |
| asset_tracking_url_template | トラッキング URL を作成するための URL テンプレート。 |
| customer_id | 顧客の ID。 |
検索広告 360 テーブル名: AssetSetStats
Search Ads 360 API リソース: asset_set_asset
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| asset_set_asset_asset | 不変。このアセットセットのアセットがリンクしているアセット。 |
| asset_set_asset_asset_set | 不変。このアセットセットのアセットがリンクしているアセットセット。 |
| customer_id | 顧客の ID。 |
| metrics_average_cpc | すべてのクリックの合計費用を、発生したクリックの合計数で割った値です。 |
| metrics_average_cpm | 平均インプレッション単価（CPM）。 |
| metrics_clicks | クリック数です。 |
| metrics_client_account_conversions | クライアント アカウントのコンバージョン数。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_conversions_value | クライアント アカウントのコンバージョン値。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_cost_micros | 指定された期間における、クリック単価（CPC）による費用とインプレッション単価（CPM）による費用の総額です。 |
| metrics_ctr | 広告から発生したクリック数（クリック数）を、広告が表示された回数（インプレッション数）で割った値です。 |
| metrics_impressions | 検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
検索広告 360 テーブル名: BidStrategy
Search Ads 360 API リソース: bidding_strategy
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| bidding_strategy_id | 入札戦略の ID。 |
| bidding_strategy_name | 入札戦略の名前。アカウント内のすべての入札戦略は、それぞれ別の名前にする必要があります。この文字列の長さは UTF-8 バイトで 1 ～ 255 の値にする必要があります（トリミングされる）。 |
| bidding_strategy_status | 入札戦略のステータス。 |
| bidding_strategy_target_cpa_cpc_bid_ceiling_micros | 入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略の場合にのみ設定する必要があります。 |
| bidding_strategy_target_cpa_cpc_bid_floor_micros | 入札戦略で設定可能な入札単価の下限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略の場合にのみ設定する必要があります。 |
| bidding_strategy_target_cpa_target_cpa_micros | 平均 CPA の目標値。この目標は、アカウントの通貨に基づき、請求可能な最小単位以上である必要があります。 |
| bidding_strategy_target_impression_share_cpc_bid_ceiling_micros | 自動入札システムで指定できる、最も高いクリック単価。これは上限を設定する広告主が入力する必須項目で、ローカルのマイクロ秒単位で指定します。 |
| bidding_strategy_target_outrank_share_cpc_bid_ceiling_micros | 入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。 |
| bidding_strategy_target_roas_cpc_bid_ceiling_micros | 入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略の場合にのみ設定する必要があります。 |
| bidding_strategy_target_roas_cpc_bid_floor_micros | 入札戦略で設定可能な入札単価の下限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略の場合にのみ設定する必要があります。 |
| bidding_strategy_target_roas_target_roas | 費用単価の選択された収益です（コンバージョン データに基づく）。値は 0.01～1000.0 の範囲で指定する必要があります。 |
| bidding_strategy_target_spend_cpc_bid_ceiling_micros | 入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。 |
| bidding_strategy_target_spend_target_spend_micros | クリック数を最大化するための目標予算。目標予算の入札者は、この値と、自然なスロットリング予算額のうち、少ない方の金額を支出しようとします。指定しない場合、予算が目標予算として使用されます。 このフィールドは非推奨のため使用不可です。 |
| segments_conversion_action | コンバージョン アクションのリソース名。 |
検索広告 360 テーブル名: BidStrategyStats
Search Ads 360 API リソース: bidding_strategy
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| bidding_strategy_id | 入札戦略の ID。 |
| metrics_all_conversions | コンバージョンの合計数です。これには、include_in_conversions_metric の値に関係なく、すべてのコンバージョンが含まれます。 |
| metrics_all_conversions_by_conversion_date | コンバージョンの合計数です。これには、include_in_conversions_metric の値に関係なく、すべてのコンバージョンが含まれます。この列が日付とともに選択されている場合、日付列の値はコンバージョンの日付を表します。by_conversion_date 列の詳細については、[すべてのコンバージョン] 列についてをご覧ください。 |
| metrics_all_conversions_value | すべてのコンバージョン値。 |
| metrics_all_conversions_value_by_conversion_date | すべてのコンバージョンの値。この列が日付とともに選択されている場合、日付列の値はコンバージョンの日付を表します。by_conversion_date 列の詳細については、[すべてのコンバージョン] 列についてをご覧ください。 |
| metrics_average_cpc | すべてのクリックの合計費用を、発生したクリックの合計数で割った値です。 |
| metrics_average_cpm | 平均インプレッション単価（CPM）。 |
| metrics_clicks | クリック数です。 |
| metrics_client_account_conversions | クライアント アカウントのコンバージョン数。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_conversions_value | クライアント アカウントのコンバージョン値。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_view_through_conversions | ビュースルー コンバージョンの合計数。この状況は、ユーザーが画像や動画広告を閲覧した後、別の広告を操作（クリックなど）することなく、サイトでコンバージョンに至ると発生します。 |
| metrics_cost_micros | 指定された期間における、クリック単価（CPC）による費用とインプレッション単価（CPM）による費用の総額です。 |
| metrics_cross_device_conversions | ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、all_conversions にすでに含まれています。 |
| metrics_cross_device_conversions_by_conversion_date | コンバージョンの日付別のクロスデバイス コンバージョン数。by_conversion_date 列の詳細については、[すべてのコンバージョン] 列についてをご覧ください。 |
| metrics_cross_device_conversions_value | クロスデバイス コンバージョンの合計値。 |
| metrics_cross_device_conversions_value_by_conversion_date | コンバージョンの日付別のクロスデバイス コンバージョン値の合計。by_conversion_date 列の詳細については、[すべてのコンバージョン] 列についてをご覧ください。 |
| metrics_ctr | 広告から発生したクリック数（クリック数）を、広告が表示された回数（インプレッション数）で割った値です。 |
| metrics_impressions | 検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
検索広告 360 テーブル名: Campaign
Search Ads 360 API リソース: campaign
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| bidding_strategy_id | 入札戦略の ID。 |
| bidding_strategy_name | 入札戦略の名前。アカウント内のすべての入札戦略は、それぞれ別の名前にする必要があります。この文字列の長さは UTF-8 バイトで 1 ～ 255 の値にする必要があります（トリミングされる）。 |
| campaign_advertising_channel_sub_type | （省略可）advertising_channel_type の絞り込み。親チャネルタイプの有効なサブタイプを指定してください。キャンペーンの作成時にのみ設定できます。キャンペーンを作成した後は変更できません。 |
| campaign_advertising_channel_type | キャンペーン内の広告のメインの配信ターゲット。ターゲティング オプションは network_settings で絞り込むことができます。新しいキャンペーンを作成する場合、このフィールドは必須です。空にすることはできません。キャンペーンの作成時にのみ設定できます。キャンペーンを作成した後は変更できません。 |
| campaign_bidding_strategy_type | 入札戦略のタイプ。入札戦略を作成するには、標準入札戦略を作成する入札スキームを設定するか、ポートフォリオ入札戦略を作成する feedback_strategy フィールドを設定します。このフィールドは読み取り専用です。 |
| campaign_budget_amount_micros | アカウントに対する現地通貨での予算額。金額はマイクロ秒単位で指定します。ここで、100 万が 1 通貨単位に相当します。1 か月の費用の上限はこの金額の 30.4 倍です。 |
| campaign_budget_delivery_method | キャンペーン予算が消費される割合を決定する配信方法。作成オペレーションで指定しない場合のデフォルトは STANDARD です。 |
| campaign_budget_period | 予算を消化する期間です。指定しない場合のデフォルトは DAILY です。 |
| campaign_creation_time | このキャンペーンが作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
| campaign_end_date | ユーザーのタイムゾーンで配信されるキャンペーンの最終日（YYYY-MM-DD 形式）。作成時にはデフォルトで 2037-12-30 に設定され、キャンペーンは無期限に実行されます。既存のキャンペーンを無期限で行うように設定するには、このフィールドを 2037-12-30 に設定します。 |
| campaign_engine_id | 外部エンジン アカウントのキャンペーンの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます。（例: Yahoo! JAPAN、Microsoft、Baidu）。Google 広告エンティティの場合は、代わりに「campaign.id」を使用します。 |
| campaign_id | キャンペーンの ID です。 |
| campaign_labels | このキャンペーンに適用されたラベルのリソース名。 |
| campaign_last_modified_time | このキャンペーンが最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
| campaign_name | キャンペーンの名前です。新しいキャンペーンを作成する場合、このフィールドは必須です。空にすることはできません。null（コードポイント 0x0）、NL ラインフィード（コードポイント 0xA）、改行（コードポイント 0xD）の文字を含めることはできません。 |
| campaign_network_settings_target_content_network | Google ディスプレイ ネットワークの指定したプレースメントに広告を配信するかどうか。プレースメントは、プレースメント条件で指定します。 |
| campaign_network_settings_target_google_search | google.com の検索結果に広告を掲載するかどうか。 |
| campaign_network_settings_target_partner_search_network | Google パートナー ネットワークで広告を配信するかどうか。この機能は、一部の Google パートナー アカウントでのみご利用いただけます。 |
| campaign_network_settings_target_search_network | Google 検索ネットワークのパートナー サイトに広告を配信するかどうか（target_google_search も true にする必要があります）。 |
| campaign_start_date | お客様のタイムゾーンでキャンペーンが配信を開始した日付（YYYY-MM-DD 形式）。 |
| campaign_status | キャンペーンのステータス。 |
| customer_id | 顧客の ID。 |
検索広告 360 テーブル名: CampaignAssetStats
Search Ads 360 API リソース: campaign_asset
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| campaign_asset_asset | 不変。キャンペーンにリンクされているアセット。 |
| campaign_asset_campaign | 不変。アセットがリンクされているキャンペーン。 |
| campaign_engine_id | 外部エンジン アカウントのキャンペーンの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます。（例: Yahoo! JAPAN、Microsoft、Baidu）。Google 広告エンティティの場合は、代わりに「campaign.id」を使用します。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_average_cpc | すべてのクリックの合計費用を、発生したクリックの合計数で割った値です。 |
| metrics_average_cpm | 平均インプレッション単価（CPM）。 |
| metrics_clicks | クリック数です。 |
| metrics_client_account_conversions | クライアント アカウントのコンバージョン数。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_conversions_value | クライアント アカウントのコンバージョン値。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_cost_micros | 指定された期間における、クリック単価（CPC）による費用とインプレッション単価（CPM）による費用の総額です。 |
| metrics_ctr | 広告から発生したクリック数（クリック数）を、広告が表示された回数（インプレッション数）で割った値です。 |
| metrics_impressions | 検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
検索広告 360 テーブル名: CampaignAudienceConversionActionAndDeviceStats
Search Ads 360 API リソース: campaign_audience_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| campaign_criterion_criterion_id | 条件の ID。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_all_conversions | コンバージョンの合計数です。これには、include_in_conversions_metric の値に関係なく、すべてのコンバージョンが含まれます。 |
| metrics_all_conversions_value | すべてのコンバージョン値。 |
| metrics_cross_device_conversions | ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、all_conversions にすでに含まれています。 |
| metrics_cross_device_conversions_value | クロスデバイス コンバージョンの合計値。 |
| segments.conversion_action_name | コンバージョン アクション名。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: CampaignAudienceDeviceStats
Search Ads 360 API リソース: campaign_audience_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| campaign_criterion_criterion_id | 条件の ID。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_average_cpc | すべてのクリックの合計費用を、発生したクリックの合計数で割った値です。 |
| metrics_average_cpm | 平均インプレッション単価（CPM）。 |
| metrics_clicks | クリック数です。 |
| metrics_client_account_conversions | クライアント アカウントのコンバージョン数。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_conversions_value | クライアント アカウントのコンバージョン値。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_view_through_conversions | ビュースルー コンバージョンの合計数。この状況は、ユーザーが画像や動画広告を閲覧した後、別の広告を操作（クリックなど）することなく、サイトでコンバージョンに至ると発生します。 |
| metrics_cost_micros | 指定された期間における、クリック単価（CPC）による費用とインプレッション単価（CPM）による費用の総額です。 |
| metrics_ctr | 広告から発生したクリック数（クリック数）を、広告が表示された回数（インプレッション数）で割った値です。 |
| metrics_impressions | 検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: CampaignConversionActionAndAssetStats
Search Ads 360 API リソース: campaign_asset
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_id | 広告グループの ID です。 |
| campaign_asset_campaign | 不変。アセットがリンクされているキャンペーン。 |
| campaign_engine_id | 外部エンジン アカウントのキャンペーンの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます。（例: Yahoo! JAPAN、Microsoft、Baidu）。Google 広告エンティティの場合は、代わりに「campaign.id」を使用します。 |
| campaign_id | キャンペーンの ID です。 |
| campain_asset_asset | 不変。キャンペーンにリンクされているアセット。 |
| customer_id | 顧客の ID。 |
| metrics_all_conversions | コンバージョンの合計数です。これには、include_in_conversions_metric の値に関係なく、すべてのコンバージョンが含まれます。 |
| metrics_all_conversions_value | すべてのコンバージョン値。 |
| metrics_cross_device_conversions | ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、all_conversions にすでに含まれています。 |
| metrics_cross_device_conversions_value | クロスデバイス コンバージョンの合計値。 |
| segments.conversion_action_name | コンバージョン アクション名。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
検索広告 360 テーブル名: CampaignConversionActionAndDeviceStats
Search Ads 360 API リソース: campaign
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| bidding_strategy_id | 入札戦略の ID。 |
| campaign_engine_id | 外部エンジン アカウントのキャンペーンの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます。（例: Yahoo! JAPAN、Microsoft、Baidu）。Google 広告エンティティの場合は、代わりに「campaign.id」を使用します。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_all_conversions | コンバージョンの合計数です。これには、include_in_conversions_metric の値に関係なく、すべてのコンバージョンが含まれます。 |
| metrics_all_conversions_by_conversion_date | コンバージョンの合計数です。これには、include_in_conversions_metric の値に関係なく、すべてのコンバージョンが含まれます。この列が日付とともに選択されている場合、日付列の値はコンバージョンの日付を表します。by_conversion_date 列の詳細については、[すべてのコンバージョン] 列についてをご覧ください。 |
| metrics_all_conversions_value | すべてのコンバージョン値。 |
| metrics_all_conversions_value_by_conversion_date | すべてのコンバージョンの値。この列が日付とともに選択されている場合、日付列の値はコンバージョンの日付を表します。by_conversion_date 列の詳細については、[すべてのコンバージョン] 列についてをご覧ください。 |
| metrics_cross_device_conversions | ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、all_conversions にすでに含まれています。 |
| metrics_cross_device_conversions_by_conversion_date | コンバージョンの日付別のクロスデバイス コンバージョン数。by_conversion_date 列の詳細については、[すべてのコンバージョン] 列についてをご覧ください。 |
| metrics_cross_device_conversions_value | クロスデバイス コンバージョンの合計値。 |
| metrics_cross_device_conversions_value_by_conversion_date | コンバージョンの日付別のクロスデバイス コンバージョン値の合計。by_conversion_date 列の詳細については、[すべてのコンバージョン] 列についてをご覧ください。 |
| segments.conversion_action_name | コンバージョン アクション名。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: CampaignCriterion
Search Ads 360 API リソース: campaign_criterion
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| campaign_criterion_bid_modifier | 条件が一致した場合の入札の修飾子。修飾子は 0.1 ～ 10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。 |
| campaign_criterion_criterion_id | 条件の ID。 |
| campaign_criterion_last_modified_time | このキャンペーン条件が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
| campaign_criterion_location_geo_target_constant | 地域ターゲティングの定数リソース名。 |
| campaign_criterion_status | 条件のステータス。 |
| campaign_criterion_type | 条件のタイプ。 |
| campaign_criterion_user_list_user_list | ユーザーリストのリソース名。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
検索広告 360 テーブル名: CampaignDeviceStats
Search Ads 360 API リソース: campaign
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| bidding_strategy_id | 入札戦略の ID。 |
| campaign_engine_id | 外部エンジン アカウントのキャンペーンの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます。（例: Yahoo! JAPAN、Microsoft、Baidu）。Google 広告エンティティの場合は、代わりに「campaign.id」を使用します。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_average_cpc | すべてのクリックの合計費用を、発生したクリックの合計数で割った値です。 |
| metrics_average_cpm | 平均インプレッション単価（CPM）。 |
| metrics_clicks | クリック数です。 |
| metrics_client_account_conversions | クライアント アカウントのコンバージョン数。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_conversions_value | クライアント アカウントのコンバージョン値。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_view_through_conversions | ビュースルー コンバージョンの合計数。この状況は、ユーザーが画像や動画広告を閲覧した後、別の広告を操作（クリックなど）することなく、サイトでコンバージョンに至ると発生します。 |
| metrics_cost_micros | 指定された期間における、クリック単価（CPC）による費用とインプレッション単価（CPM）による費用の総額です。 |
| metrics_ctr | 広告から発生したクリック数（クリック数）を、広告が表示された回数（インプレッション数）で割った値です。 |
| metrics_impressions | 検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。 |
| metrics_visits | 検索広告 360 で正常に記録され、広告主のランディング ページに転送されたクリック数。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: CampaignStats
Search Ads 360 API リソース: campaign
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| bidding_strategy_id | 入札戦略の ID。 |
| campaign_engine_id | 外部エンジン アカウントのキャンペーンの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます。（例: Yahoo! JAPAN、Microsoft、Baidu）。Google 広告エンティティの場合は、代わりに「campaign.id」を使用します。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_all_conversions | コンバージョンの合計数です。これには、include_in_conversions_metric の値に関係なく、すべてのコンバージョンが含まれます。 |
| metrics_all_conversions_value | すべてのコンバージョン値。 |
| metrics_average_cpc | すべてのクリックの合計費用を、発生したクリックの合計数で割った値です。 |
| metrics_average_cpm | 平均インプレッション単価（CPM）。 |
| metrics_clicks | クリック数です。 |
| metrics_client_account_conversions | クライアント アカウントのコンバージョン数。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_conversions_value | クライアント アカウントのコンバージョン値。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_view_through_conversions | ビュースルー コンバージョンの合計数。この状況は、ユーザーが画像や動画広告を閲覧した後、別の広告を操作（クリックなど）することなく、サイトでコンバージョンに至ると発生します。 |
| metrics_content_budget_lost_impression_share | 予算が少なすぎるために、検索ネットワークで表示可能だったものの、表示されなかった回数の推定される割合。注: 検索予算のインプレッション シェア損失率は、0 ～ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。 |
| metrics_content_impression_share | ディスプレイ ネットワークでお客様が実際に獲得したインプレッションの回数を、お客様の広告が表示候補となった推定回数で割ったものです。注: コンテンツのインプレッション シェアは 0.1 ～ 1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。 |
| metrics_content_rank_lost_impression_share | 広告ランクが低いために、広告がディスプレイ ネットワークで獲得できなかったインプレッションの推測割合。注: コンテンツ ランクのインプレッション シェア損失率は 0 ～ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。 |
| metrics_conversions | コンバージョン数です。これには、include_in_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_conversions_value | conversions フィールドに含まれるコンバージョンのコンバージョン値の合計。この指標は、コンバージョン アクションに値を設定している場合にのみ有用です。 |
| metrics_cost_micros | 指定された期間における、クリック単価（CPC）による費用とインプレッション単価（CPM）による費用の総額。 |
| metrics_ctr | 広告から発生したクリック数（クリック数）を、広告が表示された回数（インプレッション数）で割った値です。 |
| metrics_historical_quality_score | 品質スコア（履歴）。 |
| metrics_impressions | 検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。 |
| metrics_search_budget_lost_impression_share | 予算が少なすぎるために、検索ネットワークで表示可能だったものの、表示されなかった回数の推定される割合。注: 検索予算のインプレッション シェア損失率は、0 ～ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。 |
| metrics_search_impression_share | 検索ネットワークでお客様が実際に獲得したインプレッションの回数を、お客様の広告が表示候補となった推定回数で割ったものです。注: 検索広告のインプレッション シェアは、0.1 ～ 1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。 |
| metrics_search_rank_lost_impression_share | 広告ランクが低いために、広告が検索ネットワークで獲得できなかったインプレッションの推測割合。注: 検索ランクのインプレッション シェア損失率は、0 ～ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。 |
| metrics_visits | 検索広告 360 で正常に記録され、広告主のランディング ページに転送されたクリック数。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
検索広告 360 テーブル名: CartDataSalesStats
Search Ads 360 API リソース: cart_data_sales_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_id | 広告グループの ID。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_client_account_cross_sell_gross_profit_micros | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_cross_sell_gross_profit_micros |
| metrics_client_account_cross_sell_revenue_micros | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_cross_sell_revenue_micros |
| metrics_client_account_cross_sell_units_sold | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_cross_sell_units_sold |
| metrics_client_account_lead_gross_profit_micros | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_lead_gross_profit_micros |
| metrics_client_account_lead_revenue_micros | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_lead_revenue_micros |
| metrics_client_account_lead_units_sold | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_lead_units_sold |
| metrics_cross_sell_gross_profit_micros | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.cross_sell_gross_profit_micros |
| metrics_cross_sell_revenue_micros | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.cross_sell_revenue_micros |
| metrics_cross_sell_units_sold | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.cross_sell_units_sold |
| metrics_lead_gross_profit_micros | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.lead_gross_profit_micros |
| metrics_lead_revenue_micros | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.lead_revenue_micros |
| metrics_lead_units_sold | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.lead_units_sold |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_product_brand | 商品のブランド。 |
| segments_product_item_id | 商品の商品アイテム ID。 |
| segments_product_sold_brand | 販売した商品のブランド。 |
| segments_product_sold_item_id | 販売した商品の商品アイテム ID。 |
| segments_product_sold_title | 販売した商品のタイトル。 |
| segments_product_sold_type_l1 | 販売した商品のタイプ（レベル 1）。 |
| segments_product_sold_type_l2 | 販売した商品のタイプ（レベル 2）。 |
| segments_product_sold_type_l3 | 販売した商品のタイプ（レベル 3）。 |
| segments_product_sold_type_l4 | 販売した商品のタイプ（レベル 4）。 |
| segments_product_sold_type_l5 | 販売した商品のタイプ（レベル 5）。 |
| segments_product_title | 商品のタイトル。 |
| segments_product_type_l1 | 商品のタイプ（レベル 1）。 |
| segments_product_type_l2 | 商品のタイプ（レベル 2）。 |
| segments_product_type_l3 | 商品のタイプ（レベル 3）。 |
| segments_product_type_l4 | 商品のタイプ（レベル 4）。 |
| segments_product_type_l5 | 商品のタイプ（レベル 5）。 |
検索広告 360 テーブル名: Conversion
Search Ads 360 API リソース: conversion
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_criterion_criterion_id | 条件の ID。 |
| ad_group_id | 広告グループの ID。 |
| campaign_id | キャンペーンの ID。 |
| conversion_ad_id | 広告 ID。値 0 は、広告が関連付けられていないことを示します。 |
| conversion_advertiser_conversion_id | オフライン コンバージョンの場合は、広告主が提供する ID です。このような ID が広告主から指定されていない場合、検索広告 360 によって生成されます。オンライン コンバージョンの場合は、広告主の Floodlight 処理に応じて、id 列または floodlight_order_id 列と同じになります。 |
| conversion_attribution_type | コンバージョンが関連付けられた要素: 「訪問」または「キーワード + 広告」。 |
| conversion_click_id | コンバージョンが関連付けられている訪問の一意の文字列で、click id という URL パラメータとしてランディング ページに渡されます。 |
| conversion_conversion_date_time | コンバージョン イベントのタイムスタンプ。 |
| conversion_conversion_last_modified_date_time | コンバージョンが最後に変更された時刻のタイムスタンプ。 |
| conversion_conversion_quantity | コンバージョンで記録されたアイテムの数量で、qty という URL パラメータによって特定されます。広告主がパラメータ（コンバージョンで販売されたアイテム数など）を動的に入力する必要がありますが、入力しない場合、デフォルトで 1 になります。 |
| conversion_conversion_revenue_micros | コンバージョン イベントの調整された収益（マイクロ秒単位）。これは常に広告配信中アカウントの通貨で表示されます。 |
| conversion_conversion_visit_date_time | コンバージョンが関連付けられた訪問のタイムスタンプ。 |
| conversion_criterion_id | 検索広告 360 の条件 ID。値 0 は、その条件が関連付けられていないことを示します。 |
| conversion_floodlight_order_id | コンバージョンに関して広告主から提供された Floodlight オーダー ID。 |
| conversion_floodlight_original_revenue | Floodlight 通貨指示の変更前の、Floodlight イベントに関連付けられた、変更されていない元の収益（現在のレポートの通貨）。 |
| conversion_id | コンバージョンの ID |
| conversion_merchant_id | クリックされた商品を含む検索広告 360 在庫アカウント ID。この ID は、検索広告 360 で在庫アカウントをリンクしたときに、検索広告 360 によって生成されます。 |
| conversion_product_channel | クリックされた商品の販売チャネル: オンラインまたはローカル。 |
| conversion_product_country_code | クリックされた商品を含む在庫フィードに登録されている国（ISO-3166 形式）。 |
| conversion_product_id | クリックされた商品の ID。 |
| conversion_product_language_code | 商品に関するデータを含む Merchant Center フィードに設定されている言語（ISO-639-1）。 |
| conversion_product_store_id | クリックされたローカル在庫広告のストア。この ID はローカル商品フィードで使用されているストア ID と一致する必要があります。 |
| conversion_status | コンバージョンのステータス（ENABLED または REMOVED）。 |
| conversion_visit_id | コンバージョンが関連付けられた検索広告 360 の訪問 ID。 |
| customer_account_type | エンジン アカウントのタイプ。（例: Google 広告、Microsoft Advertising、Yahoo! JAPAN、Baidu、Facebook、エンジン トラッキング）。 |
| customer_descriptive_name | 顧客の一意でないわかりやすい名前（省略可）。 |
| customer_id | 顧客の ID。 |
| segments.conversion_action_name | コンバージョン アクション名。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: ConversionAction
Search Ads 360 API リソース: conversion_action
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| conversion_action_creation_time | Floodlight アクティビティの作成時点のタイムスタンプ（ISO 8601 形式）。 |
| conversion_action_floodlight_settings_activity_group_tag | コンバージョンのレポート時に Floodlight アクティビティ グループの識別に使用される文字列。 |
| conversion_action_floodlight_settings_activity_id | DoubleClick Campaign Manager（DCM）の Floodlight アクティビティの ID。 |
| conversion_action_floodlight_settings_activity_tag | コンバージョンのレポート時に Floodlight アクティビティを識別するために使用される文字列。 |
| conversion_action_name | コンバージョン アクションの名前。新しいコンバージョン アクションを作成する場合は、このフィールドは必須です。空にすることはできません。 |
| conversion_action_status | コンバージョン イベントの発生に関するこのコンバージョン アクションのステータス。 |
| conversion_action_type | このコンバージョン アクションのタイプ。 |
検索広告 360 テーブル名: GenderConversionActionAndDeviceStats
Search Ads 360 API リソース: gender_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_criterion_age_range_type | 年齢層のタイプ。 |
| ad_group_criterion_bid_modifier | 条件が一致した場合の入札の修飾子。修飾子は 0.1 ～ 10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。 |
| ad_group_criterion_cpc_bid_micros | クリック単価（CPC）。 |
| ad_group_criterion_criterion_id | 条件の ID。 |
| ad_group_criterion_gender_type | 性別のタイプ。 |
| ad_group_criterion_location_geo_target_constant | 地域ターゲティングの定数リソース名。 |
| ad_group_criterion_user_list_user_list | ユーザーリストのリソース名。 |
| ad_group_criterion_webpage_conditions | ウェブページ ターゲティングの条件または論理式。ターゲティングの評価時に、ウェブページのターゲティング条件のリストが 1 つにまとめられます。条件のリストが空の場合は、キャンペーンのウェブサイトのすべてのページがターゲットに設定されていることを示します。このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
| ad_group_criterion_webpage_coverage_percentage | ウェブサイトの条件カバレッジの割合。広告グループとキャンペーンのウェブサイト ターゲット、除外ウェブサイト ターゲット、除外キーワードに基づいて計算されたウェブサイトのカバレッジの割合。たとえば、カバレッジが 1 の場合は、カバレッジが 100% であることを示します。 |
| ad_group_id | 広告グループの ID です。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_cross_device_conversions | ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、all_conversions にすでに含まれています。 |
| metrics_cross_device_conversions_value | クロスデバイス コンバージョンの合計値。 |
| segments.conversion_action_name | コンバージョン アクション名。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: GenderDeviceStats
Search Ads 360 API リソース: gender_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_criterion_age_range_type | 年齢層のタイプ。 |
| ad_group_criterion_bid_modifier | 条件が一致した場合の入札の修飾子。修飾子は 0.1 ～ 10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。 |
| ad_group_criterion_cpc_bid_micros | クリック単価（CPC）。 |
| ad_group_criterion_criterion_id | 条件の ID。 |
| ad_group_criterion_gender_type | 性別のタイプ。 |
| ad_group_criterion_location_geo_target_constant | 地域ターゲティングの定数リソース名。 |
| ad_group_criterion_user_list_user_list | ユーザーリストのリソース名。 |
| ad_group_criterion_webpage_conditions | ウェブページ ターゲティングの条件または論理式。ターゲティングの評価時に、ウェブページのターゲティング条件のリストが 1 つにまとめられます。条件のリストが空の場合は、キャンペーンのウェブサイトのすべてのページがターゲットに設定されていることを示します。このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
| ad_group_criterion_webpage_coverage_percentage | ウェブサイトの条件カバレッジの割合。広告グループとキャンペーンのウェブサイト ターゲット、除外ウェブサイト ターゲット、除外キーワードに基づいて計算されたウェブサイトのカバレッジの割合。たとえば、カバレッジが 1 の場合は、カバレッジが 100% であることを示します。 |
| ad_group_id | 広告グループの ID です。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_average_cpc | すべてのクリックの合計費用を、発生したクリックの合計数で割った値です。 |
| metrics_average_cpm | 平均インプレッション単価（CPM）。 |
| metrics_clicks | クリック数です。 |
| metrics_client_account_conversions | クライアント アカウントのコンバージョン数。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_conversions_value | クライアント アカウントのコンバージョン値。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_view_through_conversions | ビュースルー コンバージョンの合計数。この状況は、ユーザーが画像や動画広告を閲覧した後、別の広告を操作（クリックなど）することなく、サイトでコンバージョンに至ると発生します。 |
| metrics_cost_micros | 指定された期間における、クリック単価（CPC）による費用とインプレッション単価（CPM）による費用の総額です。 |
| metrics_ctr | 広告から発生したクリック数（クリック数）を、広告が表示された回数（インプレッション数）で割った値です。 |
| metrics_impressions | 検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: キーワード
Search Ads 360 API リソース: keyword_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_criterion_cpc_bid_micros | クリック単価（CPC）。 |
| ad_group_criterion_creation_time | この広告グループの条件が作成された時点のタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
| ad_group_criterion_criterion_id | 条件の ID。 |
| ad_group_criterion_effective_cpc_bid_micros | 有効 CPC（クリック単価）入札。 |
| ad_group_criterion_engine_id | 外部エンジン アカウントの広告グループの条件の ID。このフィールドは検索広告 360 アカウント専用です。（例: Yahoo! JAPAN、Microsoft、Baidu）。検索広告 360 以外のエンティティの場合は、代わりに「ad_group_criterion.criterion_id」を使用します。 |
| ad_group_criterion_engine_status | 広告グループのエンジン ステータスの条件。 |
| ad_group_criterion_final_url_suffix | パラメータを最終ページ URL に追加するための URL テンプレート。 |
| ad_group_criterion_final_urls | 広告のすべてのクロスドメイン リダイレクトの後に可能性のある最終ページ URL のリスト。 |
| ad_group_criterion_keyword_match_type | キーワードのマッチ タイプです。 |
| ad_group_criterion_keyword_text | キーワードのテキスト（最大 80 文字、10 単語）。 |
| ad_group_criterion_labels | この広告グループの条件に適用されているラベルのリソース名。 |
| ad_group_criterion_last_modified_time | この広告グループの条件が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
| ad_group_criterion_quality_info_quality_score | 品質スコア。Google が値を決定するための十分な情報を持っていない場合は、このフィールドに値が入力されないことがあります。 |
| ad_group_criterion_status | 条件のステータス。これは、クライアントが設定した広告グループの条件エンティティのステータスです。注: UI レポートには、条件を実行できるかどうかに影響する追加情報が含まれている場合があります。API では「削除済み」である条件でも、管理画面では有効と表示されることがあります。たとえば、除外していない限り、デフォルトですべての年齢層のユーザーにキャンペーンが表示されます。対象の年齢層は広告が表示されるため、UI には「有効」と表示されます。しかし、非除外条件が追加されていないため、AdGroupCriterion.status には「removed」と表示されます。 |
| ad_group_criterion_tracking_url_template | トラッキング URL を作成するための URL テンプレート。 |
| ad_group_id | 広告グループの ID です。 |
| bidding_strategy_id | 入札戦略の ID。 |
| bidding_strategy_target_cpa_cpc_bid_ceiling_micros | 入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略の場合にのみ設定する必要があります。 |
| bidding_strategy_target_cpa_cpc_bid_floor_micros | 入札戦略で設定可能な入札単価の下限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略の場合にのみ設定する必要があります。 |
| bidding_strategy_target_impression_share_cpc_bid_ceiling_micros | 自動入札システムで指定できる、最も高いクリック単価。これは上限を設定する広告主が入力する必須項目で、ローカルのマイクロ秒単位で指定します。 |
| bidding_strategy_target_outrank_share_cpc_bid_ceiling_micros | 入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。 |
| bidding_strategy_target_roas_cpc_bid_ceiling_micros | 入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略の場合にのみ設定する必要があります。 |
| bidding_strategy_target_roas_cpc_bid_floor_micros | 入札戦略で設定可能な入札単価の下限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略の場合にのみ設定する必要があります。 |
| bidding_strategy_target_spend_cpc_bid_ceiling_micros | 入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
検索広告 360 テーブル名: KeywordConversionActionAndDeviceStats
Search Ads 360 API リソース: keyword_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_criterion_criterion_id | 条件の ID。 |
| ad_group_criterion_engine_id | 外部エンジン アカウントの広告グループの条件の ID。このフィールドは検索広告 360 アカウント専用です。（例: Yahoo! JAPAN、Microsoft、Baidu）。検索広告 360 以外のエンティティの場合は、代わりに「ad_group_criterion.criterion_id」を使用します。 |
| ad_group_id | 広告グループの ID です。 |
| bidding_strategy_id | 入札戦略の ID。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_all_conversions | コンバージョンの合計数です。これには、include_in_conversions_metric の値に関係なく、すべてのコンバージョンが含まれます。 |
| metrics_all_conversions_by_conversion_date | コンバージョンの合計数です。これには、include_in_conversions_metric の値に関係なく、すべてのコンバージョンが含まれます。この列が日付とともに選択されている場合、日付列の値はコンバージョンの日付を表します。by_conversion_date 列の詳細については、[すべてのコンバージョン] 列についてをご覧ください。 |
| metrics_all_conversions_value | すべてのコンバージョン値。 |
| metrics_all_conversions_value_by_conversion_date | すべてのコンバージョンの値。この列が日付とともに選択されている場合、日付列の値はコンバージョンの日付を表します。by_conversion_date 列の詳細については、[すべてのコンバージョン] 列についてをご覧ください。 |
| metrics_cross_device_conversions | ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、all_conversions にすでに含まれています。 |
| metrics_cross_device_conversions_by_conversion_date | コンバージョンの日付別のクロスデバイス コンバージョン数。by_conversion_date 列の詳細については、[すべてのコンバージョン] 列についてをご覧ください。 |
| metrics_cross_device_conversions_value | クロスデバイス コンバージョンの合計値。 |
| metrics_cross_device_conversions_value_by_conversion_date | コンバージョンの日付別のクロスデバイス コンバージョン値の合計。by_conversion_date 列の詳細については、[すべてのコンバージョン] 列についてをご覧ください。 |
| segments.conversion_action_name | コンバージョン アクション名。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: KeywordDeviceStats
Search Ads 360 API リソース: keyword_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_criterion_criterion_id | 条件の ID。 |
| ad_group_criterion_engine_id | 外部エンジン アカウントの広告グループの条件の ID。このフィールドは検索広告 360 アカウント専用です。（例: Yahoo! JAPAN、Microsoft、Baidu）。検索広告 360 以外のエンティティの場合は、代わりに「ad_group_criterion.criterion_id」を使用します。 |
| ad_group_id | 広告グループの ID です。 |
| bidding_strategy_id | 入札戦略の ID。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_average_cpc | すべてのクリックの合計費用を、発生したクリックの合計数で割った値です。 |
| metrics_average_cpm | 平均インプレッション単価（CPM）。 |
| metrics_clicks | クリック数です。 |
| metrics_client_account_conversions | クライアント アカウントのコンバージョン数。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_conversions_value | クライアント アカウントのコンバージョン値。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_view_through_conversions | ビュースルー コンバージョンの合計数。この状況は、ユーザーが画像や動画広告を閲覧した後、別の広告を操作（クリックなど）することなく、サイトでコンバージョンに至ると発生します。 |
| metrics_cost_micros | 指定された期間における、クリック単価（CPC）による費用とインプレッション単価（CPM）による費用の総額です。 |
| metrics_ctr | 広告から発生したクリック数（クリック数）を、広告が表示された回数（インプレッション数）で割った値です。 |
| metrics_impressions | 検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。 |
| metrics_visits | 検索広告 360 で正常に記録され、広告主のランディング ページに転送されたクリック数。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: KeywordStats
Search Ads 360 API リソース: keyword_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_criterion_criterion_id | 条件の ID。 |
| ad_group_id | 広告グループの ID です。 |
| bidding_strategy_id | 入札戦略の ID。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_historical_quality_score | 品質スコア（履歴）。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
検索広告 360 テーブル名: LocationConversionActionAndDeviceStats
Search Ads 360 API リソース: location_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| campaign_criterion_criterion_id | 条件の ID。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_all_conversions | コンバージョンの合計数です。これには、include_in_conversions_metric の値に関係なく、すべてのコンバージョンが含まれます。 |
| metrics_all_conversions_value | すべてのコンバージョン値。 |
| metrics_cross_device_conversions | ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、all_conversions にすでに含まれています。 |
| metrics_cross_device_conversions_value | クロスデバイス コンバージョンの合計値。 |
| segments.conversion_action_name | コンバージョン アクション名。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: LocationDeviceStats
Search Ads 360 API リソース: location_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| campaign_criterion_criterion_id | 条件の ID。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_average_cpc | すべてのクリックの合計費用を、発生したクリックの合計数で割った値です。 |
| metrics_average_cpm | 平均インプレッション単価（CPM）。 |
| metrics_clicks | クリック数です。 |
| metrics_client_account_conversions | クライアント アカウントのコンバージョン数。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_conversions_value | クライアント アカウントのコンバージョン値。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_view_through_conversions | ビュースルー コンバージョンの合計数。この状況は、ユーザーが画像や動画広告を閲覧した後、別の広告を操作（クリックなど）することなく、サイトでコンバージョンに至ると発生します。 |
| metrics_cost_micros | 指定された期間における、クリック単価（CPC）による費用とインプレッション単価（CPM）による費用の総額です。 |
| metrics_ctr | 広告から発生したクリック数（クリック数）を、広告が表示された回数（インプレッション数）で割った値です。 |
| metrics_impressions | 検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: NegativeAdGroupCriterion
Search Ads 360 API リソース: ad_group_criterion
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_criterion_age_range_type | 年齢層のタイプ。 |
| ad_group_criterion_creation_time | この広告グループの条件が作成された時点のタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
| ad_group_criterion_criterion_id | 条件の ID。 |
| ad_group_criterion_gender_type | 性別のタイプ。 |
| ad_group_criterion_last_modified_time | この広告グループの条件が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
| ad_group_criterion_location_geo_target_constant | 地域ターゲティングの定数リソース名。 |
| ad_group_criterion_status | 条件のステータス。これは、クライアントが設定した広告グループの条件エンティティのステータスです。注: UI レポートには、条件を実行できるかどうかに影響する追加情報が含まれている場合があります。API では「削除済み」である条件でも、管理画面では有効と表示されることがあります。たとえば、除外していない限り、デフォルトですべての年齢層のユーザーにキャンペーンが表示されます。対象の年齢層は広告が表示されるため、UI には「有効」と表示されます。しかし、非除外条件が追加されていないため、AdGroupCriterion.status には「removed」と表示されます。 |
| ad_group_criterion_type | 条件のタイプ。 |
| ad_group_criterion_user_list_user_list | ユーザーリストのリソース名。 |
| ad_group_criterion_webpage_conditions | ウェブページ ターゲティングの条件または論理式。ターゲティングの評価時に、ウェブページのターゲティング条件のリストが 1 つにまとめられます。条件のリストが空の場合は、キャンペーンのウェブサイトのすべてのページがターゲットに設定されていることを示します。このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
| ad_group_id | 広告グループの ID です。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
検索広告 360 テーブル名: NegativeAdGroupKeyword
Search Ads 360 API リソース: ad_group_criterion
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_criterion_creation_time | この広告グループの条件が作成された時点のタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
| ad_group_criterion_criterion_id | 条件の ID。 |
| ad_group_criterion_keyword_match_type | キーワードのマッチ タイプです。 |
| ad_group_criterion_keyword_text | キーワードのテキスト（最大 80 文字、10 単語）。 |
| ad_group_criterion_last_modified_time | この広告グループの条件が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
| ad_group_criterion_status | 条件のステータス。これは、クライアントが設定した広告グループの条件エンティティのステータスです。注: UI レポートには、条件を実行できるかどうかに影響する追加情報が含まれている場合があります。API では「削除済み」である条件でも、管理画面では有効と表示されることがあります。たとえば、除外していない限り、デフォルトですべての年齢層のユーザーにキャンペーンが表示されます。対象の年齢層は広告が表示されるため、UI には「有効」と表示されます。しかし、非除外条件が追加されていないため、AdGroupCriterion.status には「removed」と表示されます。 |
| ad_group_id | 広告グループの ID です。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
検索広告 360 テーブル名: NegativeCampaignCriterion
Search Ads 360 API リソース: campaign_criterion
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| campaign_criterion_age_range_type | 年齢層のタイプ。 |
| campaign_criterion_criterion_id | 条件の ID。 |
| campaign_criterion_gender_type | 性別のタイプ。 |
| campaign_criterion_last_modified_time | このキャンペーン条件が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
| campaign_criterion_location_geo_target_constant | 地域ターゲティングの定数リソース名。 |
| campaign_criterion_status | 条件のステータス。 |
| campaign_criterion_type | 条件のタイプ。 |
| campaign_criterion_user_list_user_list | ユーザーリストのリソース名。 |
| campaign_criterion_webpage_conditions | ウェブページ ターゲティングの条件または論理式。ターゲティングの評価時に、ウェブページのターゲティング条件のリストが 1 つにまとめられます。条件のリストが空の場合は、キャンペーンのウェブサイトのすべてのページがターゲットに設定されていることを示します。このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
検索広告 360 テーブル名: NegativeCampaignKeyword
Search Ads 360 API リソース: campaign_criterion
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| campaign_criterion_criterion_id | 条件の ID。 |
| campaign_criterion_keyword_match_type | キーワードのマッチ タイプです。 |
| campaign_criterion_keyword_text | キーワードのテキスト（最大 80 文字、10 単語）。 |
| campaign_criterion_last_modified_time | この広告グループの条件が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
| campaign_criterion_status | 条件のステータス。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
検索広告 360 テーブル名: ProductAdvertised
Search Ads 360 API リソース: shopping_performance_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_id | 広告グループの ID。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_average_cpc | すべてのクリックの合計費用を、発生したクリックの合計数で割った値。 |
| metrics_clicks | クリック数。 |
| metrics_client_account_conversions | クライアント アカウントのコンバージョン数。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_conversions_value | クライアント アカウントのコンバージョン値。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_cost_micros | 指定された期間における、クリック単価（CPC）による費用とインプレッション単価（CPM）による費用の総額です。 |
| metrics_ctr | 広告から発生したクリック数（クリック数）を、広告が表示された回数（インプレッション数）で割った値です。 |
| metrics_impressions | 検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_product_bidding_category_level1 | 商品の入札カテゴリ（レベル 1）。 |
| segments_product_bidding_category_level2 | 商品の入札カテゴリ（レベル 2）。 |
| segments_product_bidding_category_level3 | 商品の入札カテゴリ（レベル 3）。 |
| segments_product_bidding_category_level4 | 商品の入札カテゴリ（レベル 4）。 |
| segments_product_bidding_category_level5 | 商品の入札カテゴリ（レベル 5）。 |
| segments_product_brand | 商品のブランド。 |
| segments_product_channel | 商品のチャネル。 |
| segments_product_channel_exclusivity | 商品のチャネル独占性。 |
| segments_product_condition | 商品の状態。 |
| segments_product_country | 商品の販売先の国の地域ターゲティング定数のリソース名。 |
| segments_product_custom_attribute0 | 商品のカスタム属性 0。 |
| segments_product_custom_attribute1 | 商品のカスタム属性 1。 |
| segments_product_custom_attribute2 | 商品のカスタム属性 2。 |
| segments_product_custom_attribute3 | 商品のカスタム属性 3。 |
| segments_product_custom_attribute4 | 商品のカスタム属性 4。 |
| segments_product_item_id | 商品の商品アイテム ID。 |
| segments_product_language | 商品の言語の言語定数のリソース名。 |
| segments_product_store_id | 商品のストア ID。 |
| segments_product_title | 商品のタイトル。 |
| segments_product_type_l1 | 商品のタイプ（レベル 1）。 |
| segments_product_type_l2 | 商品のタイプ（レベル 2）。 |
| segments_product_type_l3 | 商品のタイプ（レベル 3）。 |
| segments_product_type_l4 | 商品のタイプ（レベル 4）。 |
| segments_product_type_l5 | 商品のタイプ（レベル 5）。 |
検索広告 360 テーブル名: ProductAdvertisedConversionActionAndDeviceStats
Search Ads 360 API リソース: shopping_performance_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_id | 広告グループの ID。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_all_conversions | コンバージョンの合計数です。これには、include_in_conversions_metric の値に関係なく、すべてのコンバージョンが含まれます。 |
| metrics_all_conversions_value | すべてのコンバージョン値。 |
| metrics_cross_device_conversions | ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、all_conversions にすでに含まれています。 |
| metrics_cross_device_conversions_value | クロスデバイス コンバージョンの合計値。 |
| segments.conversion_action_name | コンバージョン アクション名。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
| segments_product_item_id | 商品の商品アイテム ID。 |
検索広告 360 テーブル名: ProductAdvertisedDeviceStats
Search Ads 360 API リソース: shopping_performance_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| customer_id | 顧客の ID。 |
| metrics_average_cpc | すべてのクリックの合計費用を、発生したクリックの合計数で割った値。 |
| metrics_clicks | クリック数。 |
| metrics_client_account_conversions | クライアント アカウントのコンバージョン数。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_conversions_value | クライアント アカウントのコンバージョン値。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_cost_micros | 指定された期間における、クリック単価（CPC）による費用とインプレッション単価（CPM）による費用の総額です。 |
| metrics_ctr | 広告から発生したクリック数（クリック数）を、広告が表示された回数（インプレッション数）で割った値です。 |
| metrics_impressions | 検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
| segments_product_item_id | 商品の商品アイテム ID。 |
検索広告 360 テーブル名: ProductGroup
Search Ads 360 API リソース: product_group_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_criterion_cpc_bid_micros | クリック単価（CPC）。 |
| ad_group_criterion_creation_time | 出力のみ。この広告グループの条件が作成された時点のタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
| ad_group_criterion_criterion_id | 出力のみ。条件の ID。 |
| ad_group_criterion_effective_cpc_bid_micros | 出力のみ。有効 CPC（クリック単価）入札。 |
| ad_group_criterion_engine_status | 出力のみ。広告グループのエンジン ステータスの条件。 |
| ad_group_criterion_final_urls | 広告のすべてのクロスドメイン リダイレクトの後に可能性のある最終ページ URL のリスト。 |
| ad_group_criterion_last_modified_time | 出力のみ。この広告グループの条件が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
| ad_group_criterion_listing_group_type | リスティング グループのタイプ。 |
| ad_group_criterion_status | 条件のステータス。これは、クライアントが設定した広告グループの条件エンティティのステータスです。注: UI レポートには、条件を実行できるかどうかに影響する追加情報が含まれている場合があります。API では「削除済み」である条件でも、管理画面では有効と表示されることがあります。たとえば、除外していない限り、デフォルトですべての年齢層のユーザーにキャンペーンが表示されます。対象の年齢層は広告が表示されるため、UI には「有効」と表示されます。しかし、非除外条件が追加されていないため、AdGroupCriterion.status には「removed」と表示されます。 |
| ad_group_criterion_tracking_url_template | トラッキング URL を作成するための URL テンプレート。 |
| ad_group_id | 出力のみ。広告グループの ID です。 |
| campaign_id | 出力のみ。キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| product_group_view_resource_name | 出力のみ。商品グループビューのリソース名。商品グループビューのリソース名の形式は、customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id} です。 |
検索広告 360 テーブル名: ProductGroupStats
Search Ads 360 API リソース: product_group_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_criterion_criterion_id | 出力のみ。条件の ID。 |
| ad_group_id | 出力のみ。広告グループの ID です。 |
| campaign_id | 出力のみ。キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_all_conversions | コンバージョンの合計数です。これには、include_in_conversions_metric の値に関係なく、すべてのコンバージョンが含まれます。 |
| metrics_all_conversions_value | すべてのコンバージョン値。 |
| metrics_average_cpc | すべてのクリックの合計費用を、発生したクリックの合計数で割った値です。 |
| metrics_average_cpm | 平均インプレッション単価（CPM）。 |
| metrics_clicks | クリック数です。 |
| metrics_client_account_conversions | クライアント アカウントのコンバージョン数。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_conversions_value | クライアント アカウントのコンバージョン値。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_view_through_conversions | ビュースルー コンバージョンの合計数。この状況は、ユーザーが画像や動画広告を閲覧した後、別の広告を操作（クリックなど）することなく、サイトでコンバージョンに至ると発生します。 |
| metrics_cost_micros | 指定された期間における、クリック単価（CPC）による費用とインプレッション単価（CPM）による費用の総額です。 |
| metrics_cross_device_conversions | ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、all_conversions にすでに含まれています。 |
| metrics_cross_device_conversions_value | クロスデバイス コンバージョンの合計値。 |
| metrics_ctr | 広告から発生したクリック数（クリック数）を、広告が表示された回数（インプレッション数）で割った値です。 |
| metrics_impressions | 検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
検索広告 360 テーブル名: Visit
Search Ads 360 API リソース: visit
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_criterion_criterion_id | 条件の ID。 |
| ad_group_id | 広告グループの ID。 |
| campaign_id | キャンペーンの ID です。 |
| customer_account_type | エンジン アカウントのタイプ。（例: Google 広告、Microsoft Advertising、Yahoo! JAPAN、Baidu、Facebook、エンジン トラッキング）。 |
| customer_descriptive_name | 顧客の一意でないわかりやすい名前（省略可）。 |
| customer_id | 顧客の ID。 |
| segments_ad_network_type | 広告ネットワークのタイプ。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
| visit_ad_id | 広告 ID。値 0 は、広告が関連付けられていないことを示します。 |
| visit_click_id | クリック ID URL パラメータとしてランディング ページに渡される、訪問ごとの一意の文字列。 |
| visit_criterion_id | Search Ads 360 キーワード ID。値 0 は、キーワードが関連付けられていないことを示します。 |
| visit_id | 訪問の ID。 |
| visit_merchant_id | クリックされた商品を含む検索広告 360 在庫アカウント ID。検索広告 360 内で在庫アカウントをリンクすると、検索広告 360 でこの ID が生成されます。 |
| visit_product_channel | クリックされた商品の販売チャネル: オンラインまたはローカル。 |
| visit_product_country_code | クリックされた商品を含む在庫フィードに登録されている国（ISO-3166 形式）。 |
| visit_product_id | クリックされた商品の ID。 |
| visit_product_language_code | 商品に関するデータを含む Merchant Center フィードに設定されている言語（ISO-639-1）。 |
| visit_product_store_id | クリックされたローカル在庫広告のストア。この ID はローカル商品フィードで使用されているストア ID と一致する必要があります。 |
| visit_visit_date_time | 訪問イベントのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
検索広告 360 テーブル名: WebpageConversionActionAndDeviceStats
Search Ads 360 API リソース: webpage_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_criterion_age_range_type | 年齢層のタイプ。 |
| ad_group_criterion_bid_modifier | 条件が一致した場合の入札の修飾子。修飾子は 0.1 ～ 10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。 |
| ad_group_criterion_cpc_bid_micros | クリック単価（CPC）。 |
| ad_group_criterion_criterion_id | 条件の ID。 |
| ad_group_criterion_gender_type | 性別のタイプ。 |
| ad_group_criterion_location_geo_target_constant | 地域ターゲティングの定数リソース名。 |
| ad_group_criterion_user_list_user_list | ユーザーリストのリソース名。 |
| ad_group_criterion_webpage_conditions | ウェブページ ターゲティングの条件または論理式。ターゲティングの評価時に、ウェブページのターゲティング条件のリストが 1 つにまとめられます。条件のリストが空の場合は、キャンペーンのウェブサイトのすべてのページがターゲットに設定されていることを示します。このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
| ad_group_criterion_webpage_coverage_percentage | ウェブサイトの条件カバレッジの割合。広告グループとキャンペーンのウェブサイト ターゲット、除外ウェブサイト ターゲット、除外キーワードに基づいて計算されたウェブサイトのカバレッジの割合。たとえば、カバレッジが 1 の場合は、カバレッジが 100% であることを示します。 |
| ad_group_id | 広告グループの ID です。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_cross_device_conversions | ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、all_conversions にすでに含まれています。 |
| metrics_cross_device_conversions_value | クロスデバイス コンバージョンの合計値。 |
| segments_conversion_action_name | コンバージョン アクション名。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 テーブル名: WebpageDeviceStats
Search Ads 360 API リソース: webpage_view
| 検索広告 360 フィールド名 | 説明 |
|---|---|
| ad_group_criterion_age_range_type | 年齢層のタイプ。 |
| ad_group_criterion_bid_modifier | 条件が一致した場合の入札の修飾子。修飾子は 0.1 ～ 10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。 |
| ad_group_criterion_cpc_bid_micros | クリック単価（CPC）。 |
| ad_group_criterion_criterion_id | 条件の ID。 |
| ad_group_criterion_gender_type | 性別のタイプ。 |
| ad_group_criterion_location_geo_target_constant | 地域ターゲティングの定数リソース名。 |
| ad_group_criterion_user_list_user_list | ユーザーリストのリソース名。 |
| ad_group_criterion_webpage_conditions | ウェブページ ターゲティングの条件または論理式。ターゲティングの評価時に、ウェブページのターゲティング条件のリストが 1 つにまとめられます。条件のリストが空の場合は、キャンペーンのウェブサイトのすべてのページがターゲットに設定されていることを示します。このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
| ad_group_criterion_webpage_coverage_percentage | ウェブサイトの条件カバレッジの割合。広告グループとキャンペーンのウェブサイト ターゲット、除外ウェブサイト ターゲット、除外キーワードに基づいて計算されたウェブサイトのカバレッジの割合。たとえば、カバレッジが 1 の場合は、カバレッジが 100% であることを示します。 |
| ad_group_id | 広告グループの ID です。 |
| campaign_id | キャンペーンの ID です。 |
| customer_id | 顧客の ID。 |
| metrics_average_cpc | すべてのクリックの合計費用を、発生したクリックの合計数で割った値です。 |
| metrics_average_cpm | 平均インプレッション単価（CPM）。 |
| metrics_clicks | クリック数です。 |
| metrics_client_account_conversions | クライアント アカウントのコンバージョン数。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_conversions_value | クライアント アカウントのコンバージョン値。include_in_client_account_conversions_metric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
| metrics_client_account_view_through_conversions | ビュースルー コンバージョンの合計数。この状況は、ユーザーが画像や動画広告を閲覧した後、別の広告を操作（クリックなど）することなく、サイトでコンバージョンに至ると発生します。 |
| metrics_cost_micros | 指定された期間における、クリック単価（CPC）による費用とインプレッション単価（CPM）による費用の総額です。 |
| metrics_ctr | 広告から発生したクリック数（クリック数）を、広告が表示された回数（インプレッション数）で割った値です。 |
| metrics_impressions | 検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。 |
| segments_date | 指標が適用される日付（yyyy-MM-dd 形式）。例: 2024-04-17 |
| segments_device | 指標が適用されるデバイス。 |
検索広告 360 マッチテーブル
検索広告 360 マッチテーブルは、[属性] フィールド（設定やその他の修正済みデータを含むフィールド）のみを含む表であり、アカウントの構造情報をクエリできるように定義されています。更新ウィンドウを使用した場合や、バックフィルをスケジュールした場合、マッチテーブルのスナップショットは更新されません。
検索広告 360 の転送に含まれるマッチテーブルは次のとおりです。
- Account
- 広告
- AdGroup
- AdGroupCriterion
- 任意の ID マッピング テーブル
- アセット
- BidStrategy
- Campaign
- CampaignCriterion
- ConversionAction
- キーワード
- NegativeAdGroupKeyword
- NegativeAdGroupCriterion
- NegativeCampaignKeyword
- NegativeCampaignCriterion
- ProductGroup