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์ž…๋‹ˆ๋‹ค.

ad_group

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

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

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

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

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

ad_group_label

ad_group_label

ํ…Œ์ด๋ธ”:
p_sa_AdGroupLabel_customer_id
์กฐํšŒ์ˆ˜:
sa_AdGroupLabel_customer_id

age_range_view

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

asset_set_asset

ํ…Œ์ด๋ธ”:
p_sa_AccountConversionActionAndAssetStats_customer_id
p_sa_AssetSetStats_customer_id
์กฐํšŒ์ˆ˜:
sa_AccountConversionActionAndAssetStats_customer_id
sa_AssetSetStats_customer_id

bidding_strategy

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

campaign_asset

ํ…Œ์ด๋ธ”:
p_sa_CampaignAssetStats_customer_id
p_sa_CampaignConversionActionAndAssetStats_customer_id
์กฐํšŒ์ˆ˜:
sa_CampaignAssetStats_customer_id
sa_CampaignConversionActionAndAssetStats_customer_id

campaign_audience_view

campaign_audience_view

ํ…Œ์ด๋ธ”:
p_sa_CampaignAudienceConversionActionAndDeviceStats_customer_id
p_sa_CampaignAudienceDeviceStats_customer_id
์กฐํšŒ์ˆ˜:
sa_CampaignAudienceConversionActionAndDeviceStats_customer_id
sa_CampaignAudienceDeviceStats_customer_id

campaign_criterion

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

campaign_label

campaign_label

ํ…Œ์ด๋ธ”:
p_sa_CampaignLabel_customer_id
์กฐํšŒ์ˆ˜:
sa_CampaignLabel_customer_id

cart_data_sales_view

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

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

customer_asset

ํ…Œ์ด๋ธ”:
p_sa_AccountAssetStats_customer_id
์กฐํšŒ์ˆ˜:
sa_AccountAssetStats_customer_id

gender_view

gender_view

ํ…Œ์ด๋ธ”:
p_sa_GenderConversionActionAndDeviceStats_customer_id
p_sa_GenderDeviceStats_customer_id
์กฐํšŒ์ˆ˜:
sa_GenderConversionActionAndDeviceStats_customer_id
sa_GenderDeviceStats_customer_id

keyword_view

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

location_view

ํ…Œ์ด๋ธ”:
p_sa_LocationConversionActionAndDeviceStats_customer_id
p_sa_LocationDeviceStats_customer_id
์กฐํšŒ์ˆ˜:
sa_LocationConversionActionAndDeviceStats_customer_id
sa_LocationDeviceStats_customer_id

product_group_view

product_group_view

ํ…Œ์ด๋ธ”:
p_sa_ProductGroup_customer_id
p_sa_ProductGroupStats_customer_id
์กฐํšŒ์ˆ˜:
sa_ProductGroup_customer_id
sa_ProductGroupStats_customer_id

shopping_performance_view

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

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_level ๊ณ ๊ฐ์˜ ๊ณ„์ • ์ˆ˜์ค€์ž…๋‹ˆ๋‹ค(๊ด€๋ฆฌ์ž, ํ•˜์œ„ ๊ด€๋ฆฌ์ž, ๋ณด์กฐ ๊ด€๋ฆฌ์ž ๋˜๋Š” ์„œ๋น„์Šค ๊ณ„์ •).
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_manager_descriptive_name ๊ด€๋ฆฌ์ž์˜ ์„ค๋ช… ์ด๋ฆ„์ž…๋‹ˆ๋‹ค.
customer_sub_manager_descriptive_name ํ•˜์œ„ ๊ด€๋ฆฌ์ž์˜ ์„ค๋ช… ์ด๋ฆ„์ž…๋‹ˆ๋‹ค.
customer_associate_manager_descriptive_name ์—ฐ๊ฒฐ๋œ ๊ด€๋ฆฌ์ž์˜ ์„ค๋ช… ์ด๋ฆ„์ž…๋‹ˆ๋‹ค.
customer_engine_id ์™ธ๋ถ€ ์—”์ง„ ๊ณ„์ •์˜ ๊ณ„์ • ID์ž…๋‹ˆ๋‹ค.
customer_id ๊ณ ๊ฐ์˜ ID์ž…๋‹ˆ๋‹ค.
customer_manager_id ๊ด€๋ฆฌ์ž์˜ ๊ณ ๊ฐ ID์ž…๋‹ˆ๋‹ค.
customer_sub_manager_id ํ•˜์œ„ ๊ด€๋ฆฌ์ž์˜ ๊ณ ๊ฐ ID์ž…๋‹ˆ๋‹ค.
customer_associate_manager_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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 2024-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์ž…๋‹ˆ๋‹ค. ์ด ํ•„๋“œ๋Š” SearchAds 360 ๊ณ„์ •์—๋งŒ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. ์˜ˆ: Yahoo Japan, Microsoft, Baidu 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์ž…๋‹ˆ๋‹ค. ์ด ํ•„๋“œ๋Š” SearchAds 360 ๊ณ„์ •์—๋งŒ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. ์˜ˆ: Yahoo Japan, Microsoft, Baidu 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_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 ์ธก์ •ํ•ญ๋ชฉ์ด ์ ์šฉ๋˜๋Š” ๊ธฐ๊ธฐ์ž…๋‹ˆ๋‹ค.

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์ž…๋‹ˆ๋‹ค. ์ด ํ•„๋“œ๋Š” SearchAds 360 ๊ณ„์ •์—๋งŒ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. ์˜ˆ: Yahoo Japan, Microsoft, Baidu 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 ํ˜•์‹). ์˜ˆ: 2024-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์ž…๋‹ˆ๋‹ค. ์ด ํ•„๋“œ๋Š” Google Ads ์ด์™ธ์˜ ๊ณ„์ •์—๋งŒ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. ์˜ˆ: Yahoo Japan, Microsoft, Baidu 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์ž…๋‹ˆ๋‹ค. ์ด ํ•„๋“œ๋Š” Google Ads ์ด์™ธ์˜ ๊ณ„์ •์—๋งŒ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. ์˜ˆ: Yahoo Japan, Microsoft, Baidu 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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 2024-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์ž…๋‹ˆ๋‹ค. ์ด ํ•„๋“œ๋Š” Google Ads ์ด์™ธ์˜ ๊ณ„์ •์—๋งŒ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. ์˜ˆ: Yahoo Japan, Microsoft, Baidu 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์ž…๋‹ˆ๋‹ค. ์ด ํ•„๋“œ๋Š” Google Ads ์ด์™ธ์˜ ๊ณ„์ •์—๋งŒ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. ์˜ˆ: Yahoo Japan, Microsoft, Baidu 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 ํ˜•์‹). ์˜ˆ: 2024-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์ž…๋‹ˆ๋‹ค. ์ด ํ•„๋“œ๋Š” Google Ads ์ด์™ธ์˜ ๊ณ„์ •์—๋งŒ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. ์˜ˆ: Yahoo Japan, Microsoft, Baidu 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 ํ˜•์‹). ์˜ˆ: 2024-04-17
segments_device ์ธก์ •ํ•ญ๋ชฉ์ด ์ ์šฉ๋˜๋Š” ๊ธฐ๊ธฐ์ž…๋‹ˆ๋‹ค.

Search Ads 360 ํ…Œ์ด๋ธ” ์ด๋ฆ„: AdGroupLabel

Search Ads 360 API ๋ฆฌ์†Œ์Šค: ad_group_label

Search Ads 360 ํ•„๋“œ ์ด๋ฆ„์„ค๋ช…
ad_group_label_ad_group ๋ผ๋ฒจ์ด ์—ฐ๊ฒฐ๋œ ๊ด‘๊ณ  ๊ทธ๋ฃน์ž…๋‹ˆ๋‹ค.
ad_group_label_label ๊ด‘๊ณ  ๊ทธ๋ฃน์— ํ• ๋‹น๋œ ๋ผ๋ฒจ์ž…๋‹ˆ๋‹ค.
ad_group_label_owner_customer_id ๋ผ๋ฒจ์„ ์†Œ์œ ํ•œ ๊ณ ๊ฐ์˜ ID์ž…๋‹ˆ๋‹ค.
ad_group_label_resource_name ๊ด‘๊ณ  ๊ทธ๋ฃน ๋ผ๋ฒจ์˜ ๋ฆฌ์†Œ์Šค ์ด๋ฆ„์ž…๋‹ˆ๋‹ค. ๊ด‘๊ณ  ๊ทธ๋ฃน ๋ผ๋ฒจ ๋ฆฌ์†Œ์Šค ์ด๋ฆ„์˜ ํ˜•์‹์€ customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}์ž…๋‹ˆ๋‹ค.
campaign_id ์บ ํŽ˜์ธ์˜ ID์ž…๋‹ˆ๋‹ค.
customer_id ๊ณ ๊ฐ์˜ ID์ž…๋‹ˆ๋‹ค.

Search Ads 360 ํ…Œ์ด๋ธ” ์ด๋ฆ„: AdGroupStats

Search Ads 360 API ๋ฆฌ์†Œ์Šค: ad_group

Search Ads 360 ํ•„๋“œ ์ด๋ฆ„์„ค๋ช…
ad_group_engine_id ์™ธ๋ถ€ ์—”์ง„ ๊ณ„์ •์˜ ๊ด‘๊ณ  ๊ทธ๋ฃน ID์ž…๋‹ˆ๋‹ค. ์ด ํ•„๋“œ๋Š” Google Ads ์ด์™ธ์˜ ๊ณ„์ •์—๋งŒ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. ์˜ˆ: Yahoo Japan, Microsoft, Baidu 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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 2024-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_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(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_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

Search Ads 360 ํ…Œ์ด๋ธ” ์ด๋ฆ„: Campaign

Search Ads 360 API ๋ฆฌ์†Œ์Šค: campaign

Search Ads 360 ํ•„๋“œ ์ด๋ฆ„์„ค๋ช…
accessible_bidding_strategy_id ์ž…์ฐฐ ์ „๋žต์˜ ID์ž…๋‹ˆ๋‹ค.
accessible_bidding_strategy_name ์ž…์ฐฐ ์ „๋žต์˜ ์ด๋ฆ„์ž…๋‹ˆ๋‹ค.
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์ž…๋‹ˆ๋‹ค. ์ด ํ•„๋“œ๋Š” Google Ads ์ด์™ธ์˜ ๊ณ„์ •์—๋งŒ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. ์˜ˆ: Yahoo Japan, Microsoft, Baidu 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์ž…๋‹ˆ๋‹ค. ์ด ํ•„๋“œ๋Š” Google Ads ์ด์™ธ์˜ ๊ณ„์ •์—๋งŒ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. ์˜ˆ: Yahoo Japan, Microsoft, Baidu 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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 2024-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์ž…๋‹ˆ๋‹ค. ์ด ํ•„๋“œ๋Š” Google Ads ์ด์™ธ์˜ ๊ณ„์ •์—๋งŒ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. ์˜ˆ: Yahoo Japan, Microsoft, Baidu 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 ํ˜•์‹). ์˜ˆ: 2024-04-17

Search Ads 360 ํ…Œ์ด๋ธ” ์ด๋ฆ„: CampaignConversionActionAndDeviceStats

Search Ads 360 API ๋ฆฌ์†Œ์Šค: campaign

Search Ads 360 ํ•„๋“œ ์ด๋ฆ„์„ค๋ช…
bidding_strategy_id ์ž…์ฐฐ ์ „๋žต์˜ ID์ž…๋‹ˆ๋‹ค.
campaign_engine_id ์™ธ๋ถ€ ์—”์ง„ ๊ณ„์ •์˜ ์บ ํŽ˜์ธ ID์ž…๋‹ˆ๋‹ค. ์ด ํ•„๋“œ๋Š” Google Ads ์ด์™ธ์˜ ๊ณ„์ •์—๋งŒ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. ์˜ˆ: Yahoo Japan, Microsoft, Baidu Google Ads ํ•ญ๋ชฉ์˜ ๊ฒฝ์šฐ "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 ์ธก์ •ํ•ญ๋ชฉ์ด ์ ์šฉ๋˜๋Š” ๊ธฐ๊ธฐ์ž…๋‹ˆ๋‹ค.

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์ž…๋‹ˆ๋‹ค. ์ด ํ•„๋“œ๋Š” Google Ads ์ด์™ธ์˜ ๊ณ„์ •์—๋งŒ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. ์˜ˆ: Yahoo Japan, Microsoft, Baidu 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 ํ˜•์‹). ์˜ˆ: 2024-04-17
segments_device ์ธก์ •ํ•ญ๋ชฉ์ด ์ ์šฉ๋˜๋Š” ๊ธฐ๊ธฐ์ž…๋‹ˆ๋‹ค.

Search Ads 360 ํ…Œ์ด๋ธ” ์ด๋ฆ„: CampaignLabel

Search Ads 360 API ๋ฆฌ์†Œ์Šค: campaign_label

Search Ads 360 ํ•„๋“œ ์ด๋ฆ„์„ค๋ช…
campaign_id ์บ ํŽ˜์ธ์˜ ID์ž…๋‹ˆ๋‹ค.
campaign_label_campaign ๋ผ๋ฒจ์ด ์—ฐ๊ฒฐ๋œ ์บ ํŽ˜์ธ์ž…๋‹ˆ๋‹ค.
campaign_label_label ์บ ํŽ˜์ธ์— ํ• ๋‹น๋œ ๋ผ๋ฒจ์ž…๋‹ˆ๋‹ค.
campaign_label_owner_customer_id ๋ผ๋ฒจ์„ ์†Œ์œ ํ•œ ๊ณ ๊ฐ์˜ ID์ž…๋‹ˆ๋‹ค.
campaign_label_resource_name ๋ฆฌ์†Œ์Šค์˜ ์ด๋ฆ„์ž…๋‹ˆ๋‹ค. ์บ ํŽ˜์ธ ๋ผ๋ฒจ ๋ฆฌ์†Œ์Šค ์ด๋ฆ„์˜ ํ˜•์‹์€ customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}์ž…๋‹ˆ๋‹ค.
customer_id ๊ณ ๊ฐ์˜ ID์ž…๋‹ˆ๋‹ค.

Search Ads 360 ํ…Œ์ด๋ธ” ์ด๋ฆ„: CampaignStats

Search Ads 360 API ๋ฆฌ์†Œ์Šค: campaign

Search Ads 360 ํ•„๋“œ ์ด๋ฆ„์„ค๋ช…
bidding_strategy_id ์ž…์ฐฐ ์ „๋žต์˜ ID์ž…๋‹ˆ๋‹ค.
campaign_engine_id ์™ธ๋ถ€ ์—”์ง„ ๊ณ„์ •์˜ ์บ ํŽ˜์ธ ID์ž…๋‹ˆ๋‹ค. ์ด ํ•„๋“œ๋Š” Google Ads ์ด์™ธ์˜ ๊ณ„์ •์—๋งŒ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. ์˜ˆ: Yahoo Japan, Microsoft, Baidu 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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 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)์ž…๋‹ˆ๋‹ค.

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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 2024-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์ž…๋‹ˆ๋‹ค. ์ด ํ•„๋“œ๋Š” SearchAds 360 ๊ณ„์ •์—๋งŒ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. ์˜ˆ: Yahoo Japan, Microsoft, Baidu 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์ž…๋‹ˆ๋‹ค. ์ด ํ•„๋“œ๋Š” SearchAds 360 ๊ณ„์ •์—๋งŒ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. ์˜ˆ: Yahoo Japan, Microsoft, Baidu 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_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 ์ธก์ •ํ•ญ๋ชฉ์ด ์ ์šฉ๋˜๋Š” ๊ธฐ๊ธฐ์ž…๋‹ˆ๋‹ค.

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์ž…๋‹ˆ๋‹ค. ์ด ํ•„๋“œ๋Š” SearchAds 360 ๊ณ„์ •์—๋งŒ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. ์˜ˆ: Yahoo Japan, Microsoft, Baidu 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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 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)์ž…๋‹ˆ๋‹ค.

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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 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 ํด๋ฆญ๋œ ์ œํ’ˆ์ด ํฌํ•จ๋œ 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 ํ˜•์‹). ์˜ˆ: 2024-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 ํ˜•์‹). ์˜ˆ: 2024-04-17
segments_device ์ธก์ •ํ•ญ๋ชฉ์ด ์ ์šฉ๋˜๋Š” ๊ธฐ๊ธฐ์ž…๋‹ˆ๋‹ค.

Search Ads 360 ๋ฐ์ดํ„ฐ ์ด๋™ ์ƒ‰์ธ

Search Ads 360 ๋ฐ์ดํ„ฐ ์ด๋™ ์ƒ‰์ธ์€ ์†์„ฑ ํ•„๋“œ(์„ค์ • ๋˜๋Š” ๋‹ค๋ฅธ ์ˆ˜์ • ๋ฐ์ดํ„ฐ๋ฅผ ํฌํ•จํ•˜๋Š” ํ•„๋“œ)๋งŒ ํฌํ•จํ•˜๋Š” ํ…Œ์ด๋ธ”์ด๋ฉฐ, ์‚ฌ์šฉ์ž๊ฐ€ ๊ณ„์ • ๊ตฌ์กฐ ์ •๋ณด๋ฅผ ์ฟผ๋ฆฌํ•  ์ˆ˜ ์žˆ๋„๋ก ์ •์˜๋ฉ๋‹ˆ๋‹ค. ์ƒˆ๋กœ๊ณ ์นจ ์ฐฝ์„ ์‚ฌ์šฉํ•˜๊ฑฐ๋‚˜ ๋ฐฑํ•„์„ ์˜ˆ์•ฝํ•  ๊ฒฝ์šฐ ๋ฐ์ดํ„ฐ ์ด๋™ ์ƒ‰์ธ ์Šค๋ƒ…์ƒท์ด ์—…๋ฐ์ดํŠธ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

๋‹ค์Œ์€ Search Ads 360 ์ „์†ก์˜ ๋ฐ์ดํ„ฐ ์ด๋™ ์ƒ‰์ธ ๋ชฉ๋ก์ž…๋‹ˆ๋‹ค.

  • ๊ณ„์ •
  • ๊ด‘๊ณ 
  • AdGroup
  • AdGroupCriterion
  • ๋ชจ๋“  ID ๋งคํ•‘ ํ…Œ์ด๋ธ”
  • ํ™•์žฅ ์†Œ์žฌ
  • BidStrategy
  • ์บ ํŽ˜์ธ
  • CampaignCriterion
  • ConversionAction
  • ํ‚ค์›Œ๋“œ
  • NegativeAdGroupKeyword
  • NegativeAdGroupCriterion
  • NegativeCampaignKeyword
  • NegativeCampaignCriterion
  • ProductGroup