Search Ads 360 보고서 전환
이 문서에서는 Search Ads 360에 대해 보고서를 전환하는 방법을 설명합니다.
이전 Search Ads 360 Reporting API를 사용하는 Search Ads 360 보고서 전환을 보려면 Search Ads 360 보고서 전환(지원 중단됨)을 참조하세요.
Search Ads 360 보고서의 테이블 매핑
Search Ads 360 보고서를 BigQuery로 전송하면 보고서가 다음과 같은 BigQuery 테이블과 뷰로 전환됩니다. BigQuery에서 테이블과 뷰를 볼 때 customer_id의 값은 Search Ads 360 고객 ID입니다.
| Search Ads 360 API 리소스(v0) | Search Ads 360 테이블 | BigQuery 뷰 |
|---|---|---|
| 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 |
sa_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 |
| asset |
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 |
| customer |
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 |
| visit |
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 |
Search Ads 360 보고서의 열 세부정보
Search Ads 360 전송으로 생성되는 BigQuery 테이블은 다음 열(필드)로 구성됩니다.
Search Ads 360 테이블 이름: Account
Search Ads 360 API 리소스: customer
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| customer_account_type | 엔진 계정 유형(예: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track 등) |
| 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입니다. |
Search Ads 360 테이블 이름: AccountAssetStats
Search Ads 360 API 리소스: customer_asset
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| customer_asset_asset | 필수 항목입니다. 변경할 수 없습니다. 고객에 연결된 애셋입니다. |
| customer_id | 고객의 ID입니다. |
| metrics_average_cpc | 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. |
| metrics_average_cpm | 평균 CPM(1,000회 노출당비용)입니다. |
| 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)과 1,000회 노출당비용(CPM)의 합계입니다. |
| metrics_ctr | 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. |
| metrics_impressions | Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
Search Ads 360 테이블 이름: AccountConversionActionAndAssetStats
Search Ads 360 API 리소스: asset_set_asset
| Search Ads 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 형식의 날짜입니다(예: 2018-04-17). |
Search Ads 360 테이블 이름: AccountConversionActionAndDeviceStats
Search Ads 360 API 리소스: customer
| Search Ads 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 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: AccountDeviceStats
Search Ads 360 API 리소스: customer
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| customer_engine_id | 외부 엔진 계정의 계정 ID입니다. |
| customer_id | 고객의 ID입니다. |
| metrics_average_cpc | 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. |
| metrics_average_cpm | 평균 CPM(1,000회 노출당비용)입니다. |
| 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)과 1,000회 노출당비용(CPM)의 합계입니다. |
| metrics_ctr | 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. |
| metrics_impressions | Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. |
| metrics_visits | Search Ads 360이 성공적으로 기록하고 광고주의 방문 페이지로 전달한 클릭수입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: AccountStats
Search Ads 360 API 리소스: customer
| Search Ads 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 형식의 날짜입니다(예: 2018-04-17). |
Search Ads 360 테이블 이름: Ad
Search Ads 360 API 리소스: ad_group_ad
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| ad_group_ad_ad_display_url | 일부 광고 형식의 광고 설명에 표시되는 URL입니다. |
| ad_group_ad_ad_expanded_dynamic_search_ad_description1 | 광고 설명의 첫 번째 줄입니다. |
| ad_group_ad_ad_expanded_dynamic_search_ad_description2 | 광고 설명의 두 번째 줄입니다. |
| ad_group_ad_ad_expanded_text_ad_description1 | 광고 설명의 첫 번째 줄입니다. |
| ad_group_ad_ad_expanded_text_ad_description2 | 광고 설명의 두 번째 줄입니다. |
| ad_group_ad_ad_expanded_text_ad_headline | 광고의 제목입니다. |
| ad_group_ad_ad_expanded_text_ad_headline2 | 광고의 두 번째 제목입니다. |
| ad_group_ad_ad_expanded_text_ad_headline3 | 광고의 세 번째 제목입니다. |
| ad_group_ad_ad_final_urls | 광고의 모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다. |
| ad_group_ad_ad_id | 광고의 ID입니다. |
| ad_group_ad_ad_name | 광고의 이름입니다. 이 이름은 광고를 식별하는 데만 사용됩니다. 이름은 고유하지 않아도 되며 게재되는 광고에 영향을 주지 않습니다. 이름 필드는 현재 DisplayUploadAd, ImageAd, ShoppingComparisonListingAd, VideoAd에 대해서만 지원됩니다. |
| ad_group_ad_ad_text_ad_description1 | 광고 설명의 첫 번째 줄입니다. |
| ad_group_ad_ad_text_ad_description2 | 광고 설명의 두 번째 줄입니다. |
| 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입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 SearchAds 360 계정에만 사용됩니다. SearchAds 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입니다. |
Search Ads 360 테이블 이름: AdConversionActionAndDeviceStats
Search Ads 360 API 리소스: ad_group_ad
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| ad_group_ad_ad_id | 광고의 ID입니다. |
| ad_group_ad_engine_id | 외부 엔진 계정의 광고 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 SearchAds 360 계정에만 사용됩니다. SearchAds 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_value | 모든 전환의 가치입니다. |
| metrics_cross_device_conversions | 고객이 하나의 기기에서 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. |
| metrics_cross_device_conversions_value | 교차 기기 전환의 가치의 합계입니다. |
| segments.conversion_action_name | 전환 액션 이름입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: AdDeviceStats
Search Ads 360 API 리소스: ad_group_ad
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| ad_group_ad_ad_id | 광고의 ID입니다. |
| ad_group_ad_engine_id | 외부 엔진 계정의 광고 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 SearchAds 360 계정에만 사용됩니다. SearchAds 360 이외의 항목의 경우 대신 "ad_group_ad.ad.id"를 사용하세요. |
| ad_group_id | 광고 그룹의 ID입니다. |
| campaign_id | 캠페인의 ID입니다. |
| customer_id | 고객의 ID입니다. |
| metrics_average_cpc | 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. |
| metrics_average_cpm | 평균 CPM(1,000회 노출당비용)입니다. |
| 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)과 1,000회 노출당비용(CPM)의 합계입니다. |
| metrics_ctr | 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. |
| metrics_impressions | Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. |
| metrics_visits | Search Ads 360이 성공적으로 기록하고 광고주의 방문 페이지로 전달한 클릭수입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: AdGroup
Search Ads 360 API 리소스: ad_group
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| ad_group_bid_modifier_bid_modifier | 기준이 일치할 때의 입찰가의 한정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 선호 콘텐츠의 경우 범위는 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입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "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 | 광고 그룹의 이름입니다. 이 필드는 필수이며 새 광고 그룹을 만들 때 비어 있지 않아야 합니다. 255자 미만의 UTF-8 전체 너비 문자를 포함해야 합니다. 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입니다. |
Search Ads 360 테이블 이름: AdGroupAssetStats
Search Ads 360 API 리소스: ad_group_asset
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| ad_group_asset_ad_group | 필수 항목입니다. 변경할 수 없습니다. 애셋이 연결된 광고 그룹입니다. |
| ad_group_asset_asset | 필수 항목입니다. 변경할 수 없습니다. 광고 그룹에 연결된 애셋입니다. |
| ad_group_engine_id | 외부 엔진 계정의 광고 그룹 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "ad_group.id"를 사용하세요. |
| ad_group_id | 광고 그룹의 ID입니다. |
| campaign_id | 캠페인의 ID입니다. |
| customer_id | 고객의 ID입니다. |
| metrics_average_cpc | 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. |
| metrics_average_cpm | 평균 CPM(1,000회 노출당비용)입니다. |
| 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)과 1,000회 노출당비용(CPM)의 합계입니다. |
| metrics_ctr | 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. |
| metrics_impressions | Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
Search Ads 360 테이블 이름: AdGroupAudienceConversionActionAndDeviceStats
Search Ads 360 API 리소스: ad_group_audience_view
| Search Ads 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 | 웹페이지 타겟팅을 위한 조건 또는 논리 표현식입니다. 웹페이지 타겟팅 조건 목록은 타겟팅 평가 시 함께 AND로 연결됩니다. 빈 조건 목록은 캠페인 웹사이트의 모든 페이지가 타겟팅되었음을 나타냅니다. 이 필드는 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 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: AdGroupAudienceDeviceStats
Search Ads 360 API 리소스: ad_group_audience_view
| Search Ads 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 | 웹페이지 타겟팅을 위한 조건 또는 논리 표현식입니다. 웹페이지 타겟팅 조건 목록은 타겟팅 평가 시 함께 AND로 연결됩니다. 빈 조건 목록은 캠페인 웹사이트의 모든 페이지가 타겟팅되었음을 나타냅니다. 이 필드는 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(1,000회 노출당비용)입니다. |
| 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)과 1,000회 노출당비용(CPM)의 합계입니다. |
| metrics_ctr | 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. |
| metrics_impressions | Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: AdGroupConversionActionAndAssetStats
Search Ads 360 API 리소스: ad_group_asset
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| ad_group_asset_ad_group | 필수 항목입니다. 변경할 수 없습니다. 애셋이 연결된 광고 그룹입니다. |
| ad_group_asset_asset | 필수 항목입니다. 변경할 수 없습니다. 광고 그룹에 연결된 애셋입니다. |
| ad_group_engine_id | 외부 엔진 계정의 광고 그룹 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "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). |
Search Ads 360 테이블 이름: AdGroupConversionActionAndDeviceStats
Search Ads 360 API 리소스: ad_group
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| ad_group_engine_id | 출력 전용. 외부 엔진 계정의 광고 그룹 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "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 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: AdGroupCriterion
Search Ads 360 API 리소스: ad_group_criterion
| Search Ads 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에 계속 사용 설정된 것으로 표시될 수 있습니다. 예를 들어 기본적으로 캠페인은 제외되지 않는 한 모든 연령의 사용자에게 표시됩니다. 광고 게재가 가능하기 때문에 UI에 연령 범위가 "사용 설정됨"으로 표시되지만 긍정적 기준이 추가되지 않았기 때문에 AdGroupCriterion.status에 "삭제됨"으로 표시됩니다. |
| ad_group_criterion_type | 기준의 유형입니다. |
| ad_group_criterion_user_list_user_list | 사용자 목록 리소스 이름입니다. |
| ad_group_criterion_webpage_conditions | 웹페이지 타겟팅을 위한 조건 또는 논리 표현식입니다. 웹페이지 타겟팅 조건 목록은 타겟팅 평가 시 함께 AND로 연결됩니다. 빈 조건 목록은 캠페인 웹사이트의 모든 페이지가 타겟팅되었음을 나타냅니다. 이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다. |
| ad_group_criterion_webpage_coverage_percentage | 웹사이트 기준 노출 범위 비율입니다. 광고 그룹 및 캠페인에서 웹사이트 대상, 제외 웹사이트 대상, 제외 키워드를 기반으로 계산된 웹사이트 노출 범위 비율입니다. 예를 들어 노출 범위가 1로 반환되었으면 노출 범위가 100%입니다. |
| ad_group_id | 광고 그룹의 ID입니다. |
| ad_group_name | 광고 그룹의 이름입니다. 이 필드는 필수이며 새 광고 그룹을 만들 때 비어 있지 않아야 합니다. 255자 미만의 UTF-8 전체 너비 문자를 포함해야 합니다. null(코드 포인트 0x0), NL 라인 피드(코드 포인트 0xA), 캐리지 리턴(코드 포인트 0xD) 문자는 포함하지 않아야 합니다. |
| ad_group_status | 광고 그룹의 상태입니다. |
| campaign_id | 캠페인의 ID입니다. |
| campaign_name | 캠페인의 이름입니다. 이 필드는 필수 항목이며 새 캠페인을 만들 때 비워두지 않아야 합니다. null(코드 포인트 0x0), NL 라인 피드(코드 포인트 0xA), 캐리지 리턴(코드 포인트 0xD) 문자는 포함하지 않아야 합니다. |
| campaign_status | 캠페인의 상태입니다. |
| customer_account_type | 엔진 계정 유형(예: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track 등) |
| customer_descriptive_name | 고객에 대해 선택적이고 고유하지 않은 설명이 포함된 이름입니다. |
| customer_id | 고객의 ID입니다. |
Search Ads 360 테이블 이름: AdGroupDeviceStats
Search Ads 360 API 리소스: ad_group
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| ad_group_engine_id | 외부 엔진 계정의 광고 그룹 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "ad_group.id"를 사용하세요. |
| ad_group_id | 광고 그룹의 ID입니다. |
| bidding_strategy_id | 입찰 전략의 ID입니다. |
| campaign_id | 캠페인의 ID입니다. |
| customer_id | 고객의 ID입니다. |
| metrics_average_cpc | 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. |
| metrics_average_cpm | 평균 CPM(1,000회 노출당비용)입니다. |
| 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)과 1,000회 노출당비용(CPM)의 합계입니다. |
| metrics_ctr | 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. |
| metrics_impressions | Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. |
| metrics_visits | Search Ads 360이 성공적으로 기록하고 광고주의 방문 페이지로 전달한 클릭수입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: AdGroupStats
Search Ads 360 API 리소스: ad_group
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| ad_group_engine_id | 외부 엔진 계정의 광고 그룹 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "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 형식의 날짜입니다(예: 2018-04-17). |
Search Ads 360 테이블 이름: AgeRangeConversionActionAndDeviceStats
Search Ads 360 API 리소스: age_range_view
| Search Ads 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 | 웹페이지 타겟팅을 위한 조건 또는 논리 표현식입니다. 웹페이지 타겟팅 조건 목록은 타겟팅 평가 시 함께 AND로 연결됩니다. 빈 조건 목록은 캠페인 웹사이트의 모든 페이지가 타겟팅되었음을 나타냅니다. 이 필드는 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 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: AgeRangeDeviceStats
Search Ads 360 API 리소스: age_range_view
| Search Ads 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 | 웹페이지 타겟팅을 위한 조건 또는 논리 표현식입니다. 웹페이지 타겟팅 조건 목록은 타겟팅 평가 시 함께 AND로 연결됩니다. 빈 조건 목록은 캠페인 웹사이트의 모든 페이지가 타겟팅되었음을 나타냅니다. 이 필드는 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(1,000회 노출당비용)입니다. |
| 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)과 1,000회 노출당비용(CPM)의 합계입니다. |
| metrics_ctr | 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. |
| metrics_impressions | Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: Asset
Search Ads 360 API 리소스: asset
| Search Ads 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~35 사이여야 하고(1 및 35 포함) description2도 설정해야 합니다. |
| asset_sitelink_asset.description2 | 사이트링크 설명의 두 번째 줄입니다. 설정된 경우 길이가 1~35 사이여야 하고(1 및 35 포함) description1도 설정해야 합니다. |
| asset_sitelink_asset_link_text | 사이트링크의 URL 표시 텍스트입니다. 이 문자열의 길이는 1~25 사이여야 합니다(1 및 25 포함). |
| asset_status | 애셋의 상태입니다. |
| asset_tracking_url_template | 추적 URL을 만들기 위한 URL 템플릿입니다. |
| customer_id | 고객의 ID입니다. |
Search Ads 360 테이블 이름: AssetSetStats
Search Ads 360 API 리소스: asset_set_asset
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| asset_set_asset_asset | 변경할 수 없습니다. 이 애셋 집합이 연결된 애셋입니다. |
| asset_set_asset_asset_set | 변경할 수 없습니다. 이 애셋 집합이 연결된 애셋 집합입니다. |
| customer_id | 고객의 ID입니다. |
| metrics_average_cpc | 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. |
| metrics_average_cpm | 평균 CPM(1,000회 노출당비용)입니다. |
| 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)과 1,000회 노출당비용(CPM)의 합계입니다. |
| metrics_ctr | 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. |
| metrics_impressions | Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
Search Ads 360 테이블 이름: BidStrategy
Search Ads 360 API 리소스: bidding_strategy
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| bidding_strategy_id | 입찰 전략의 ID입니다. |
| bidding_strategy_name | 입찰 전략의 이름입니다. 한 계정 내의 모든 입찰 전략은 이름이 고유해야 합니다. 이 문자열의 길이는 UTF-8 바이트 단위(공백 삭제)로 1~255 사이(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 | 자동 입찰 시스템으로 지정할 수 있는 가장 높은 CPC 입찰가입니다. 광고주가 입력하는 필수 필드이고 상한을 설정하며 로컬 마이크로 단위로 지정됩니다. |
| 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 사이여야 합니다(0.01 및 1000.0 포함). |
| bidding_strategy_target_spend_cpc_bid_ceiling_micros | 입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다. |
| bidding_strategy_target_spend_target_spend_micros | 클릭수를 최대화할 지출 목표입니다. TargetSpend 입찰자는 이 값 또는 자연 제한 지출 금액 중 더 작은 값을 지출하려고 시도합니다. 지정하지 않으면 예산이 지출 목표로 사용됩니다. 이 필드는 지원 중단되었으며 더 이상 사용하지 않아야 합니다. |
| segments_conversion_action | 전환 액션의 리소스 이름입니다. |
Search Ads 360 테이블 이름: BidStrategyStats
Search Ads 360 API 리소스: bidding_strategy
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| bidding_strategy_id | 입찰 전략의 ID입니다. |
| metrics_all_conversions | 총 전환수입니다. 여기에는 include_in_conversions_metric의 값과 관계없이 모든 전환이 포함됩니다. |
| metrics_all_conversions_value | 모든 전환의 가치입니다. |
| metrics_average_cpc | 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. |
| metrics_average_cpm | 평균 CPM(1,000회 노출당비용)입니다. |
| 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)과 1,000회 노출당비용(CPM)의 합계입니다. |
| metrics_cross_device_conversions | 고객이 하나의 기기에서 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. |
| metrics_cross_device_conversions_value | 교차 기기 전환의 가치의 합계입니다. |
| metrics_ctr | 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. |
| metrics_impressions | Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
Search Ads 360 테이블 이름: Campaign
Search Ads 360 API 리소스: campaign
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| bidding_strategy_id | 입찰 전략의 ID입니다. |
| bidding_strategy_name | 입찰 전략의 이름입니다. 한 계정 내의 모든 입찰 전략은 이름이 고유해야 합니다. 이 문자열의 길이는 UTF-8 바이트 단위(공백 삭제)로 1~255 사이(1 및 255 포함)여야 합니다. |
| campaign_advertising_channel_sub_type | advertising_channel_type에 대한 선택적 미세 조정입니다. 상위 채널 유형의 유효한 하위 유형이어야 합니다. 캠페인을 만들 때만 설정할 수 있습니다. 캠페인을 만든 후에는 필드를 변경할 수 없습니다. |
| campaign_advertising_channel_type | 캠페인 내 광고의 기본 게재 타겟입니다. 타겟팅 옵션은 network_settings에서 미세 조정할 수 있습니다. 이 필드는 필수 항목이며 새 캠페인을 만들 때 비워두지 않아야 합니다. 캠페인을 만들 때만 설정할 수 있습니다. 캠페인을 만든 후에는 필드를 변경할 수 없습니다. |
| campaign_bidding_strategy_type | 입찰 전략의 유형입니다. 입찰 스킴을 설정해서 표준 입찰 전략을 만들거나 bidding_strategy 필드를 설정해서 포트폴리오 입찰 전략을 만드는 방식으로 입찰 전략을 만들 수 있습니다. 이 필드는 읽기 전용입니다. |
| campaign_budget_amount_micros | 예산 금액(계정의 현지 통화)입니다. 금액은 마이크로 단위로 지정되며, 100만은 통화 단위 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입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "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입니다. |
Search Ads 360 테이블 이름: CampaignAssetStats
Search Ads 360 API 리소스: campaign_asset
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| campaign_asset_asset | 변경할 수 없습니다. 캠페인에 연결된 애셋입니다. |
| campaign_asset_campaign | 변경할 수 없습니다. 애셋이 연결된 캠페인입니다. |
| campaign_engine_id | 외부 엔진 계정의 캠페인 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "campaign.id"를 사용하세요. |
| campaign_id | 캠페인의 ID입니다. |
| customer_id | 고객의 ID입니다. |
| metrics_average_cpc | 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. |
| metrics_average_cpm | 평균 CPM(1,000회 노출당비용)입니다. |
| 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)과 1,000회 노출당비용(CPM)의 합계입니다. |
| metrics_ctr | 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. |
| metrics_impressions | Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
Search Ads 360 테이블 이름: CampaignAudienceConversionActionAndDeviceStats
Search Ads 360 API 리소스: campaign_audience_view
| Search Ads 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 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: CampaignAudienceDeviceStats
Search Ads 360 API 리소스: campaign_audience_view
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| campaign_criterion_criterion_id | 기준의 ID입니다. |
| campaign_id | 캠페인의 ID입니다. |
| customer_id | 고객의 ID입니다. |
| metrics_average_cpc | 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. |
| metrics_average_cpm | 평균 CPM(1,000회 노출당비용)입니다. |
| 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)과 1,000회 노출당비용(CPM)의 합계입니다. |
| metrics_ctr | 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. |
| metrics_impressions | Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: CampaignConversionActionAndAssetStats
Search Ads 360 API 리소스: campaign_asset
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| ad_group_id | 광고 그룹의 ID입니다. |
| campaign_asset_campaign | 변경할 수 없습니다. 애셋이 연결된 캠페인입니다. |
| campaign_engine_id | 외부 엔진 계정의 캠페인 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "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 형식의 날짜입니다(예: 2018-04-17). |
Search Ads 360 테이블 이름: CampaignConversionActionAndDeviceStats
Search Ads 360 API 리소스: campaign
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| bidding_strategy_id | 입찰 전략의 ID입니다. |
| campaign_engine_id | 외부 엔진 계정의 캠페인 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "campaign.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). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: CampaignCriterion
Search Ads 360 API 리소스: campaign_criterion
| Search Ads 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입니다. |
Search Ads 360 테이블 이름: CampaignDeviceStats
Search Ads 360 API 리소스: campaign
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| bidding_strategy_id | 입찰 전략의 ID입니다. |
| campaign_engine_id | 외부 엔진 계정의 캠페인 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "campaign.id"를 사용하세요. |
| campaign_id | 캠페인의 ID입니다. |
| customer_id | 고객의 ID입니다. |
| metrics_average_cpc | 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. |
| metrics_average_cpm | 평균 CPM(1,000회 노출당비용)입니다. |
| 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)과 1,000회 노출당비용(CPM)의 합계입니다. |
| metrics_ctr | 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. |
| metrics_impressions | Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. |
| metrics_visits | Search Ads 360이 성공적으로 기록하고 광고주의 방문 페이지로 전달한 클릭수입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: CampaignStats
Search Ads 360 API 리소스: campaign
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| bidding_strategy_id | 입찰 전략의 ID입니다. |
| campaign_engine_id | 외부 엔진 계정의 캠페인 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "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(1,000회 노출당비용)입니다. |
| 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 | '전환수' 필드에 포함된 전환에 대한 전환 가치의 합계입니다. 이 측정항목은 전환 액션의 가치를 입력한 경우에만 유용합니다. |
| metrics_cost_micros | 일정 기간에 발생한 클릭당비용(CPC)과 1,000회 노출당비용(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 | Search Ads 360이 성공적으로 기록하고 광고주의 방문 페이지로 전달한 클릭수입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
Search Ads 360 테이블 이름: CartDataSalesStats
Search Ads 360 API 리소스: cart_data_sales_view
| Search Ads 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 형식의 날짜입니다(예: 2018-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)입니다. |
Search Ads 360 테이블 이름: Conversion
Search Ads 360 API 리소스: conversion
| Search Ads 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를 지정하지 않으면 Search Ads 360이 ID를 생성합니다. 온라인 전환의 경우 광고주의 플러드라이트 지침에 따라 ID 열 또는 floodlight_order_id 열과 동일합니다. |
| conversion_attribution_type | 전환 기인 대상: 방문 또는 키워드+광고. |
| conversion_click_id | 방문 페이지에 클릭 ID URL 매개변수로 전달되며, 전환의 기인 대상이 되는 방문에 대한 고유 문자열입니다. |
| conversion_conversion_date_time | 전환 이벤트의 타임스탬프입니다. |
| conversion_conversion_last_modified_date_time | 전환이 마지막으로 수정된 시간의 타임스탬프입니다. |
| conversion_conversion_quantity | 전환으로 기록된 항목 수입니다. 수량 URL 매개변수에 따라 결정됩니다. 광고주가 매개변수를 동적으로 채워야 하며(예: 전환에서 판매된 항목 수) 그렇지 않은 경우 기본값은 1입니다. |
| conversion_conversion_revenue_micros | 전환 이벤트에 대해 백만 분의 1 단위로 조정된 수익입니다. 항상 광고 게재 계정의 통화로 표시됩니다. |
| conversion_conversion_visit_date_time | 전환의 기인 대상이 되는 방문의 타임스탬프입니다. |
| conversion_criterion_id | Search Ads 360 기준 ID입니다. 값이 0이면 기준이 비구분 상태임을 나타냅니다. |
| conversion_floodlight_order_id | 광고주가 전환을 위해 제공한 플러드라이트 주문 ID입니다. |
| conversion_floodlight_original_revenue | 플러드라이트 통화 안내 수정 전 플러드라이트 이벤트와 연관된 원래의 변경되지 않은 수익입니다(현재 보고서의 통화). |
| conversion_id | 전환의 ID입니다. |
| conversion_merchant_id | 클릭된 제품이 포함된 SearchAds360 인벤토리 계정 ID입니다. 사용자가 SearchAds360에서 인벤토리 계정을 링크할 때 SearchAds360이 이 ID를 생성합니다. |
| conversion_product_channel | 클릭된 제품의 영업 채널: 온라인 또는 로컬. |
| conversion_product_country_code | 클릭한 제품이 포함된 인벤토리 피드에 등록된 국가(ISO-3166 형식)입니다. |
| conversion_product_id | 클릭된 제품의 ID입니다. |
| conversion_product_language_code | 제품에 대한 데이터가 포함된 판매자 센터 피드에 설정된 언어(ISO-639-1)입니다. |
| conversion_product_store_id | 클릭된 오프라인 판매점 인벤토리 광고의 스토어입니다. 오프라인 제품 피드에 사용된 스토어 ID와 일치해야 합니다. |
| conversion_status | 전환의 상태입니다(사용 설정됨 또는 삭제됨). |
| conversion_visit_id | 전환의 기인 대상이 되는 SearchAds360 방문 ID입니다. |
| customer_account_type | 엔진 계정 유형(예: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track 등) |
| customer_descriptive_name | 고객에 대해 선택적이고 고유하지 않은 설명이 포함된 이름입니다. |
| customer_id | 고객의 ID입니다. |
| segments.conversion_action_name | 전환 액션 이름입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: ConversionAction
Search Ads 360 API 리소스: conversion_action
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| conversion_action_creation_time | ISO 8601 형식의 플러드라이트 활동 생성의 타임스탬프입니다. |
| conversion_action_floodlight_settings_activity_group_tag | 전환을 보고할 때 플러드라이트 활동 그룹을 식별하는 데 사용되는 문자열입니다. |
| conversion_action_floodlight_settings_activity_id | DoubleClick Campaign Manager(DCM)의 플러드라이트 활동 ID입니다. |
| conversion_action_floodlight_settings_activity_tag | 전환을 보고할 때 플러드라이트 활동을 식별하는 데 사용되는 문자열입니다. |
| conversion_action_name | 전환 액션의 이름입니다. 이 필드는 필수 항목이며 새 전환 액션을 만들 때 비워 두지 않아야 합니다. |
| conversion_action_status | 전환 이벤트 발생에 대한 이 전환 액션의 상태입니다. |
| conversion_action_type | 이 전환 액션의 유형입니다. |
Search Ads 360 테이블 이름: GenderConversionActionAndDeviceStats
Search Ads 360 API 리소스: gender_view
| Search Ads 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 | 웹페이지 타겟팅을 위한 조건 또는 논리 표현식입니다. 웹페이지 타겟팅 조건 목록은 타겟팅 평가 시 함께 AND로 연결됩니다. 빈 조건 목록은 캠페인 웹사이트의 모든 페이지가 타겟팅되었음을 나타냅니다. 이 필드는 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 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: GenderDeviceStats
Search Ads 360 API 리소스: gender_view
| Search Ads 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 | 웹페이지 타겟팅을 위한 조건 또는 논리 표현식입니다. 웹페이지 타겟팅 조건 목록은 타겟팅 평가 시 함께 AND로 연결됩니다. 빈 조건 목록은 캠페인 웹사이트의 모든 페이지가 타겟팅되었음을 나타냅니다. 이 필드는 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(1,000회 노출당비용)입니다. |
| 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)과 1,000회 노출당비용(CPM)의 합계입니다. |
| metrics_ctr | 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. |
| metrics_impressions | Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: Keyword
Search Ads 360 API 리소스: keyword_view
| Search Ads 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입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 SearchAds 360 계정에만 사용됩니다. SearchAds 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에 계속 사용 설정된 것으로 표시될 수 있습니다. 예를 들어 기본적으로 캠페인은 제외되지 않는 한 모든 연령의 사용자에게 표시됩니다. 광고 게재가 가능하기 때문에 UI에 연령 범위가 "사용 설정됨"으로 표시되지만 긍정적 기준이 추가되지 않았기 때문에 AdGroupCriterion.status에 "삭제됨"으로 표시됩니다. |
| 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 | 자동 입찰 시스템으로 지정할 수 있는 가장 높은 CPC 입찰가입니다. 광고주가 입력하는 필수 필드이고 상한을 설정하며 로컬 마이크로 단위로 지정됩니다. |
| 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입니다. |
Search Ads 360 테이블 이름: KeywordConversionActionAndDeviceStats
Search Ads 360 API 리소스: keyword_view
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| ad_group_criterion_criterion_id | 기준의 ID입니다. |
| ad_group_criterion_engine_id | 외부 엔진 계정의 광고그룹 기준 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 SearchAds 360 계정에만 사용됩니다. SearchAds 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_value | 모든 전환의 가치입니다. |
| metrics_cross_device_conversions | 고객이 하나의 기기에서 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. |
| metrics_cross_device_conversions_value | 교차 기기 전환의 가치의 합계입니다. |
| segments.conversion_action_name | 전환 액션 이름입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: KeywordDeviceStats
Search Ads 360 API 리소스: keyword_view
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| ad_group_criterion_criterion_id | 기준의 ID입니다. |
| ad_group_criterion_engine_id | 외부 엔진 계정의 광고그룹 기준 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 SearchAds 360 계정에만 사용됩니다. SearchAds 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(1,000회 노출당비용)입니다. |
| 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)과 1,000회 노출당비용(CPM)의 합계입니다. |
| metrics_ctr | 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. |
| metrics_impressions | Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. |
| metrics_visits | Search Ads 360이 성공적으로 기록하고 광고주의 방문 페이지로 전달한 클릭수입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: KeywordStats
Search Ads 360 API 리소스: keyword_view
| Search Ads 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 형식의 날짜입니다(예: 2018-04-17). |
Search Ads 360 테이블 이름: LocationConversionActionAndDeviceStats
Search Ads 360 API 리소스: location_view
| Search Ads 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 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: LocationDeviceStats
Search Ads 360 API 리소스: location_view
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| campaign_criterion_criterion_id | 기준의 ID입니다. |
| campaign_id | 캠페인의 ID입니다. |
| customer_id | 고객의 ID입니다. |
| metrics_average_cpc | 모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. |
| metrics_average_cpm | 평균 CPM(1,000회 노출당비용)입니다. |
| 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)과 1,000회 노출당비용(CPM)의 합계입니다. |
| metrics_ctr | 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. |
| metrics_impressions | Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: NegativeAdGroupCriterion
Search Ads 360 API 리소스: ad_group_criterion
| Search Ads 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에 계속 사용 설정된 것으로 표시될 수 있습니다. 예를 들어 기본적으로 캠페인은 제외되지 않는 한 모든 연령의 사용자에게 표시됩니다. 광고 게재가 가능하기 때문에 UI에 연령 범위가 "사용 설정됨"으로 표시되지만 긍정적 기준이 추가되지 않았기 때문에 AdGroupCriterion.status에 "삭제됨"으로 표시됩니다. |
| ad_group_criterion_type | 기준의 유형입니다. |
| ad_group_criterion_user_list_user_list | 사용자 목록 리소스 이름입니다. |
| ad_group_criterion_webpage_conditions | 웹페이지 타겟팅을 위한 조건 또는 논리 표현식입니다. 웹페이지 타겟팅 조건 목록은 타겟팅 평가 시 함께 AND로 연결됩니다. 빈 조건 목록은 캠페인 웹사이트의 모든 페이지가 타겟팅되었음을 나타냅니다. 이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다. |
| ad_group_id | 광고 그룹의 ID입니다. |
| campaign_id | 캠페인의 ID입니다. |
| customer_id | 고객의 ID입니다. |
Search Ads 360 테이블 이름: NegativeAdGroupKeyword
Search Ads 360 API 리소스: ad_group_criterion
| Search Ads 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에 계속 사용 설정된 것으로 표시될 수 있습니다. 예를 들어 기본적으로 캠페인은 제외되지 않는 한 모든 연령의 사용자에게 표시됩니다. 광고 게재가 가능하기 때문에 UI에 연령 범위가 "사용 설정됨"으로 표시되지만 긍정적 기준이 추가되지 않았기 때문에 AdGroupCriterion.status에 "삭제됨"으로 표시됩니다. |
| ad_group_id | 광고 그룹의 ID입니다. |
| campaign_id | 캠페인의 ID입니다. |
| customer_id | 고객의 ID입니다. |
Search Ads 360 테이블 이름: NegativeCampaignCriterion
Search Ads 360 API 리소스: campaign_criterion
| Search Ads 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 | 웹페이지 타겟팅을 위한 조건 또는 논리 표현식입니다. 웹페이지 타겟팅 조건 목록은 타겟팅 평가 시 함께 AND로 연결됩니다. 빈 조건 목록은 캠페인 웹사이트의 모든 페이지가 타겟팅되었음을 나타냅니다. 이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다. |
| campaign_id | 캠페인의 ID입니다. |
| customer_id | 고객의 ID입니다. |
Search Ads 360 테이블 이름: NegativeCampaignKeyword
Search Ads 360 API 리소스: campaign_criterion
| Search Ads 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입니다. |
Search Ads 360 테이블 이름: ProductAdvertised
Search Ads 360 API 리소스: shopping_performance_view
| Search Ads 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)과 1,000회 노출당비용(CPM)의 합계입니다. |
| metrics_ctr | 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. |
| metrics_impressions | Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-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)입니다. |
Search Ads 360 테이블 이름: ProductAdvertisedConversionActionAndDeviceStats
Search Ads 360 API 리소스: shopping_performance_view
| Search Ads 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 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
| segments_product_item_id | 제품의 상품 ID입니다. |
Search Ads 360 테이블 이름: ProductAdvertisedDeviceStats
Search Ads 360 API 리소스: shopping_performance_view
| Search Ads 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)과 1,000회 노출당비용(CPM)의 합계입니다. |
| metrics_ctr | 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. |
| metrics_impressions | Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
| segments_product_item_id | 제품의 상품 ID입니다. |
Search Ads 360 테이블 이름: ProductGroup
Search Ads 360 API 리소스: product_group_view
| Search Ads 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에 계속 사용 설정된 것으로 표시될 수 있습니다. 예를 들어 기본적으로 캠페인은 제외되지 않는 한 모든 연령의 사용자에게 표시됩니다. 광고 게재가 가능하기 때문에 UI에 연령 범위가 "사용 설정됨"으로 표시되지만 긍정적 기준이 추가되지 않았기 때문에 AdGroupCriterion.status에 "삭제됨"으로 표시됩니다. |
| 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}입니다. |
Search Ads 360 테이블 이름: ProductGroupStats
Search Ads 360 API 리소스: product_group_view
| Search Ads 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(1,000회 노출당비용)입니다. |
| 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)과 1,000회 노출당비용(CPM)의 합계입니다. |
| metrics_cross_device_conversions | 고객이 하나의 기기에서 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다. |
| metrics_cross_device_conversions_value | 교차 기기 전환의 가치의 합계입니다. |
| metrics_ctr | 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. |
| metrics_impressions | Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
Search Ads 360 테이블 이름: Visit
Search Ads 360 API 리소스: visit
| Search Ads 360 필드 이름 | 설명 |
|---|---|
| ad_group_criterion_criterion_id | 기준의 ID입니다. |
| ad_group_id | 광고 그룹의 ID입니다. |
| campaign_id | 캠페인의 ID입니다. |
| customer_account_type | 엔진 계정 유형(예: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track 등) |
| customer_descriptive_name | 고객에 대해 선택적이고 고유하지 않은 설명이 포함된 이름입니다. |
| customer_id | 고객의 ID입니다. |
| segments_ad_network_type | 광고 네트워크 유형입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-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 | 클릭된 제품이 포함된 Search Ads 360 인벤토리 계정 ID입니다. 사용자가 Search Ads 360에서 인벤토리 계정을 링크할 때 Search Ads 360이 이 ID를 생성합니다. |
| visit_product_channel | 클릭된 제품의 영업 채널: 온라인 또는 로컬. |
| visit_product_country_code | 클릭한 제품이 포함된 인벤토리 피드에 등록된 국가(ISO-3166 형식)입니다. |
| visit_product_id | 클릭된 제품의 ID입니다. |
| visit_product_language_code | 제품에 대한 데이터가 포함된 판매자 센터 피드에 설정된 언어(ISO-639-1)입니다. |
| visit_product_store_id | 클릭된 오프라인 판매점 인벤토리 광고의 스토어입니다. 오프라인 제품 피드에 사용된 스토어 ID와 일치해야 합니다. |
| visit_visit_date_time | 방문 이벤트의 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다. |
Search Ads 360 테이블 이름: WebpageConversionActionAndDeviceStats
Search Ads 360 API 리소스: webpage_view
| Search Ads 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 | 웹페이지 타겟팅을 위한 조건 또는 논리 표현식입니다. 웹페이지 타겟팅 조건 목록은 타겟팅 평가 시 함께 AND로 연결됩니다. 빈 조건 목록은 캠페인 웹사이트의 모든 페이지가 타겟팅되었음을 나타냅니다. 이 필드는 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 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 테이블 이름: WebpageDeviceStats
Search Ads 360 API 리소스: webpage_view
| Search Ads 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 | 웹페이지 타겟팅을 위한 조건 또는 논리 표현식입니다. 웹페이지 타겟팅 조건 목록은 타겟팅 평가 시 함께 AND로 연결됩니다. 빈 조건 목록은 캠페인 웹사이트의 모든 페이지가 타겟팅되었음을 나타냅니다. 이 필드는 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(1,000회 노출당비용)입니다. |
| 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)과 1,000회 노출당비용(CPM)의 합계입니다. |
| metrics_ctr | 광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. |
| metrics_impressions | Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. |
| segments_date | 측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
| segments_device | 측정항목이 적용되는 기기입니다. |
Search Ads 360 데이터 이동 색인
Search Ads 360 데이터 이동 색인은 속성 필드(설정 또는 다른 수정 데이터를 포함하는 필드)만 포함하는 테이블이며, 사용자가 계정 구조 정보를 쿼리할 수 있도록 정의됩니다. 새로고침 창을 사용하거나 백필을 예약할 경우 데이터 이동 색인 스냅샷이 업데이트되지 않습니다.
다음은 Search Ads 360 전송의 데이터 이동 색인 목록입니다.
- 계정
- 광고
- AdGroup
- AdGroupCriterion
- 모든 ID 매핑 테이블
- 확장 소재
- BidStrategy
- 캠페인
- CampaignCriterion
- ConversionAction
- 키워드
- NegativeAdGroupKeyword
- NegativeAdGroupCriterion
- NegativeCampaignKeyword
- NegativeCampaignCriterion
- ProductGroup