Google Ads (AdWords) 설정

지출 집계
데이터 커넥터 설정

상세 내용 개요

데이터 커넥터 기술	API (Google Ads API v10)
데이터 세분화 (분할)	기본 설정으로써, 데이터는 다음과 같이 분할됩니다. Country Campaign Sub Campaign (Ad Group) Sub Ad Network (Ad Network Type) 다른 설정을 선택하고 싶다면, 하단의 데이터 매핑을 참고하세요.
데이터를 가져올 수 있는 최대일 수	매일 Singular는 과거 7일의 데이터를 가져옵니다. Singular는 일주일에 한 번, 월요일에 과거 30일의 데이터를 가져옵니다.
시간대	광고주측이 계정 당 구글 설정에 정의한 시간대에 기반하여 설정됩니다.
소재(광고) 레벨의 데이터도 사용할 수 있을까요?	가능합니다.
소재 에셋을 표시할까요?	표시합니다. (Singular에서 썸네일만 표시하고 있는 YouTube 비디오 제외)
알려진 제한사항	Country 세분성은 소재에서는 사용할 수 없습니다. 소재 리포트의 인스톨 메트릭은 에셋 세분성에서는 사용할 수 없습니다. (즉, 에셋 당 인스톨 값이 보이도록 리포트를 실행할 수 없습니다.)

데이터 매핑

여러 세분성 설정 중 한 데이터를 얻을 수 있으며, 각 세분성은 각기 다른 디멘션 세트를 제공하고 각각의 장점과 제한 사항이 있습니다.

기본 설정은 국가(Country) 입니다. 국가를 선택하기 위해서는 Singular 서포트 팀에 문의하세요.
Metro (DMA) 설정은 US 기반 광고일 경우에만 유용한 설정입니다. (DMA 정보는 미국에서만 사용되기 때문입니다) 만약 일부 또는 모든 캠페인을 US 외의 국가에서 운영한다면, Metro 대신 도시(City)를 선택하세요.
키워드와 퍼블리셔 설정은 Google Ads API 제한으로 인해 UAC 캠페인 데이터를 포함하지 않습니다.
키워드와 퍼블리셔 설정은 국가 또는 다른 위치 디멘션을 포함하지 않으나, Singular는 타깃 국가 설정에 기반한 국가를 제공할 수 있습니다.

용어 관련 팁:

Singular의 소재는 Google Ads의 광고(Ad)에 해당합니다.
Singular의 신규 소재 디멘션은 Google Ads의 에셋(Asset)에 해당합니다. 신규 레벨 세분성(granularity)를 추가한 이유는 Google의 UAC(모바일 앱)광고와 같은 일부 광고들이 여러 에셋들을 갖기 때문입니다.
Singular 리포트의 모든 필드에 대한 설명은, Singular 메트릭과 디멘션 용어사전을 참고하세요.

Singular UI필드	Singular API 필드	Google 국가 세분성 필드
디멘션
Account ID	adn_account_id	customer.id
Account Name	adn_account_name	customer.descriptiveName
App Site ID	app_site_id	campaign.appCampaignSetting.appId
Asset ID	asset_id	asset.id
Asset Name	asset_name	asset.name (비디오 유형의 에셋에는 다음을 사용: “asset.youtubeVideoAsset.youtubeVideoTitle”)
Campaign URL	adn_campaign_url	ad.finalUrl를 사용할 수 없다면, ad.trackingUrlTemplate를 사용
Country	country_field	geographicView.countryCriterionId
Creative Format	creative_format	ad.type
Creative ID	creative_id	adGroupAd.ad.id
Creative Name	creative_name	adGroupAd.ad.name
Creative Reported URL	creative_reported_url	adGroupAd.ad.finalUrls.0
Date	date_field	segments.date
Final URL	final_url	campaign.finalUrls OR adGroupCriterion.finalUrls OR adGroup.ad.finalUrls
Network Campaign ID	adn_campaign_id	campaign.id
Network Campaign Name	adn_campaign_name	campaign.name
Network Creative ID	adn_creative_id	adGroupAd.ad.id
Network Creative Name	adn_creative_name	adGroupAd.ad.name
Network Sub Campaign ID	adn_sub_campaign_id	adGroup.id
Network Sub Campaign Name	adn_sub_campaign_name	adGroup.name
OS	os	campaign.appCampaignSetting.appStore
Platform	platform	campaign.appCampaignSetting.appStore 과 segments.device의 혼합
Public Id	site_public_id	campaign.appCampaignSetting.appId
Retargeting	retention	campaign.advertisingChannelSubType == ‘APP_CAMPAIGN_FOR_ENGAGEMENT_’
Sub Ad Network	adn_subadnetwork	segments.adNetworkType
Target Countries	target_countries_str	country 참고
Text	creative_text	본 필드 생성을 위해서, 광고에 제공되는 모든 텍스트 필드를 가져오며, 이는 광고 유형(ad type)에 기반한 필드와 상이할 수 있습니다. 예시) UAC의 경우, 해당 필드는 Google Ads에서 asset.textAsset.text입니다. 하나 이상의 텍스트가 존재한다면 (예시, 헤드라인 + 설명), Singular는 그 텍스트들을 하나의 문자열로 연결합니다.
Timezone	adn_timezone	customer.timeZone (Singular는 광고주의 시간대를 기반으로 Adwords에서 시간 데이터를 가져오며 UTC로 변경합니다.)
Tracking URL	tracking_url	adGroupAd.ad.trackingUrlTemplate
메트릭
Cost	adn_cost	metrics.costMicro
Network Clicks	adn_clicks	metrics.clicks
Network Impressions	adn_impressions	metrics.impressions
Network Installs	adn_installs	metrics.conversions / metrics.allConversions
Original Cost	adn_original_cost	metrics.costMicro
Original Currency	adn_original_currency	customer.currencyCode
Video Views	video_views	metrics.videoViews
Completed Video Views	completed_video_views	metrics.video_quartile_p100_rate
Video Views - 25%	video_views_25pct	metrics.video_quartile_p25_rate
Video Views - 50%	video_views_50pct	metrics.video_quartile_p50_rate
Video Views - 75%	video_views_75pct	metrics.video_quartile_p75_rate

Singular UI 필드	Singular API 필드	Google 메트로 세분화 필드
디멘션
Account ID	adn_account_id	customer.id
Account Name	adn_account_name	customer.descriptiveName
App Site ID	app_site_id	campaign.appCampaignSetting.appId
Asset ID	asset_id	asset.id
Asset Name	asset_name	asset.name (비디오 유형의 에셋에는 다음을 사용: “asset.youtubeVideoAsset.youtubeVideoTitle”)
Campaign URL	adn_campaign_url	ad.finalUrl 를 사용할 수 없다면 ad.trackingUrlTemplate를 사용
Country	country_field	geographicView.countryCriterionId
Creative Format	creative_format	ad.type
Creative ID	creative_id	adGroupAd.ad.id
Creative Name	creative_name	adGroupAd.ad.name
Creative Reported URL	creative_reported_url	adGroupAd.ad.finalUrls.0
Date	date_field	segments.date
DMA Name	dma_name_field	geo_target_metro
Final URL	final_url	campaign.finalUrls OR adGroupCriterion.finalUrls OR adGroup.ad.finalUrls
Network Campaign ID	adn_campaign_id	campaign.id
Network Campaign Name	adn_campaign_name	campaign.name
Network Creative ID	adn_creative_id	adGroupAd.ad.id
Network Creative Name	adn_creative_name	adGroupAd.ad.name
Network Sub Campaign ID	adn_sub_campaign_id	adGroup.id
Network Sub Campaign Name	adn_sub_campaign_name	adGroup.name
OS	os	campaign.appCampaignSetting.appStore
Platform	platform	campaign.appCampaignSetting.appStore와 segments.device의 혼합
Public Id	site_public_id	campaign.appCampaignSetting.appId
Region	region_field	geo_target_state
Retargeting	retention	campaign.advertisingChannelSubType == ‘APP_CAMPAIGN_FOR_ENGAGEMENT_’
Sub Ad Network	adn_subadnetwork	segments.adNetworkType
Target Countries	target_countries_str	country 참고
Text	creative_text	본 필드 생성을 위해서, 광고에 제공되는 모든 텍스트 필드를 가져오며, 이는 광고 유형(ad type)에 기반한 필드와 상이할 수 있습니다. 예시) UAC의 경우, 해당 필드는 Google Ads에서 asset.textAsset.text입니다. 하나 이상의 텍스트가 존재한다면 (예시, 헤드라인 + 설명), Singular는 그 텍스트들을 하나의 문자열로 연결합니다.
Timezone	adn_timezone	customer.timeZone (와 일부 추가 로직)
Tracking URL	tracking_url	adGroupAd.ad.trackingUrlTemplate
메트릭
Cost	adn_cost	metrics.costMicro
Network Clicks	adn_clicks	metrics.clicks
Network Impressions	adn_impressions	metrics.impressions
Network Installs	adn_installs	metrics.conversions / metrics.allConversions
Original Cost	adn_original_cost	metrics.costMicro
Original Currency	adn_original_currency	customer.currencyCode
Video Views	video_views	metrics.videoViews
Completed Video Views	completed_video_views	metrics.video_quartile_p100_rate
Video Views - 25%	video_views_25pct	metrics.video_quartile_p25_rate
Video Views - 50%	video_views_50pct	metrics.video_quartile_p50_rate
Video Views - 75%	video_views_75pct	metrics.video_quartile_p75_rate

Singular UI 필드	Singular API 필드	Google 도시 세분성 필드
디멘션
Account ID	adn_account_id	customer.id
Account Name	adn_account_name	customer.descriptiveName
App Site ID	app_site_id	campaign.appCampaignSetting.appId
Asset ID	asset_id	asset.id
Asset Name	asset_name	asset.name (비디오 유형의 에셋에는 다음을 사용: “asset.youtubeVideoAsset.youtubeVideoTitle”)
Campaign URL	adn_campaign_url	ad.finalUrl 를 사용할 수 없다면 ad.trackingUrlTemplate를 사용
City	city_field	geo_target_city
Country	country_field	geographicView.countryCriterionId
Creative Format	creative_format	ad.type
Creative ID	creative_id	adGroupAd.ad.id
Creative Name	creative_name	adGroupAd.ad.name
Creative Reported URL	creative_reported_url	adGroupAd.ad.finalUrls.0
Date	date_field	segments.date
Final URL	final_url	campaign.finalUrls 또는 adGroupCriterion.finalUrls 또는 adGroup.ad.finalUrls
Network Campaign ID	adn_campaign_id	campaign.id
Network Campaign Name	adn_campaign_name	campaign.name
Network Creative ID	adn_creative_id	adGroupAd.ad.id
Network Creative Name	adn_creative_name	adGroupAd.ad.name
Network Sub Campaign ID	adn_sub_campaign_id	adGroup.id
Network Sub Campaign Name	adn_sub_campaign_name	adGroup.name
OS	os	campaign.appCampaignSetting.appStore
Platform	platform	campaign.appCampaignSetting.appStore와 segments.device의 혼합
Public Id	site_public_id	campaign.appCampaignSetting.appId
Region	region_field	geo_target_region
Retargeting	retention	campaign.advertisingChannelSubType == ‘APP_CAMPAIGN_FOR_ENGAGEMENT_’
Sub Ad Network	adn_subadnetwork	segments.adNetworkType
Target Countries	target_countries_str	country 참고
Text	creative_text	본 필드 생성을 위해서, 광고에 제공되는 모든 텍스트 필드를 가져오며, 이는 광고 유형(ad type)에 기반한 필드와 상이할 수 있습니다. 예시) UAC의 경우, 해당 필드는 Google Ads에서 asset.textAsset.text입니다. 하나 이상의 텍스트가 존재한다면 (예시, 헤드라인 + 설명), Singular는 그 텍스트들을 하나의 문자열로 연결합니다.
Timezone	adn_timezone	customer.timeZone (와 일부 추가 로직)
Tracking URL	tracking_url	adGroupAd.ad.trackingUrlTemplate
메트릭
Cost	adn_cost	metrics.costMicro
Network Clicks	adn_clicks	metrics.clicks
Network Impressions	adn_impressions	metrics.impressions
Network Installs	adn_installs	metrics.conversions / metrics.allConversions
Original Cost	adn_original_cost	metrics.costMicro
Original Currency	adn_original_currency	customer.currencyCode
Video Views	video_views	metrics.videoViews
Completed Video Views	completed_video_views	metrics.video_quartile_p100_rate
Video Views - 25%	video_views_25pct	metrics.video_quartile_p25_rate
Video Views - 50%	video_views_50pct	metrics.video_quartile_p50_rate
Video Views - 75%	video_views_75pct	metrics.video_quartile_p75_rate

Singular UI 필드	Singular API 필드	Google 키워드 세분화 필드
디멘션
Account ID	adn_account_id	customer.id
Account Name	adn_account_name	customer.descriptiveName
App Site ID	app_site_id	campaign.appCampaignSetting.appId
Asset ID	asset_id	asset.id
Asset Name	asset_name	asset.name (비디오 유형의 에셋에는 다음을 사용: “asset.youtubeVideoAsset.youtubeVideoTitle”)
Campaign URL	adn_campaign_url	ad.finalUrl 를 사용할 수 없다면, ad.trackingUrlTemplate를 사용
Creative Format	creative_format	ad.type
Creative ID	creative_id	adGroupAd.ad.id
Creative Name	creative_name	adGroupAd.ad.name
Creative Reported URL	creative_reported_url	adGroupAd.ad.finalUrls.0
Date	date_field	segments.date
Final URL	final_url	campaign.finalUrls 또는 adGroupCriterion.finalUrls 또는 adGroup.ad.finalUrls
Keyword	keyword	ad_group_criterion.keyword.text
Keyword ID	keyword_id	ad_group_criterion.criterion_id
Keyword Match Type	keyword_match_type	ad_group_criterion.keyword.match_type
Network Campaign ID	adn_campaign_id	campaign.id
Network Campaign Name	adn_campaign_name	campaign.name
Network Creative ID	adn_creative_id	adGroupAd.ad.id
Network Creative Name	adn_creative_name	adGroupAd.ad.name
Network Sub Campaign ID	adn_sub_campaign_id	adGroup.id
Network Sub Campaign Name	adn_sub_campaign_name	adGroup.name
OS	os	campaign.appCampaignSetting.appStore
Platform	platform	campaign.appCampaignSetting.appStore와 segments.device의 혼합
Public Id	site_public_id	campaign.appCampaignSetting.appId
Retargeting	retention	campaign.advertisingChannelSubType == ‘APP_CAMPAIGN_FOR_ENGAGEMENT_’
Sub Ad Network	adn_subadnetwork	segments.adNetworkType
Target Countries	target_countries_str	country 참고
Text	creative_text	본 필드 생성을 위해서, 광고에 제공되는 모든 텍스트 필드를 가져오며, 이는 광고 유형(ad type)에 기반한 필드와 상이할 수 있습니다. 예시) UAC의 경우, 해당 필드는 Google Ads에서 asset.textAsset.text입니다. 하나 이상의 텍스트가 존재한다면 (예시, 헤드라인 + 설명), Singular는 그 텍스트들을 하나의 문자열로 연결합니다.
Timezone	adn_timezone	customer.timeZone (와 일부 추가 로직)
Tracking URL	tracking_url	adGroupAd.ad.trackingUrlTemplate
메트릭
Cost	adn_cost	metrics.costMicro
Network Clicks	adn_clicks	metrics.clicks
Network Impressions	adn_impressions	metrics.impressions
Network Installs	adn_installs	metrics.conversions / metrics.allConversions
Original Cost	adn_original_cost	metrics.costMicro
Original Currency	adn_original_currency	customer.currencyCode
Video Views	video_views	metrics.videoViews
Completed Video Views	completed_video_views	metrics.video_quartile_p100_rate
Video Views - 25%	video_views_25pct	metrics.video_quartile_p25_rate
Video Views - 50%	video_views_50pct	metrics.video_quartile_p50_rate
Video Views - 75%	video_views_75pct	metrics.video_quartile_p75_rate

Singular UI 필드	Singular API 필드	Google 키워드 필드 + Quality Score 세분화
디멘션
Account ID	adn_account_id	customer.id
Account Name	adn_account_name	customer.descriptiveName
App Site ID	app_site_id	campaign.appCampaignSetting.appId
Asset ID	asset_id	asset.id
Asset Name	asset_name	asset.name (비디오 유형의 에셋에는 다음을 사용: “asset.youtubeVideoAsset.youtubeVideoTitle”)
Campaign URL	adn_campaign_url	ad.finalUrl 를 사용할 수 없는 경우, ad.trackingUrlTemplate를 사용
Creative Format	creative_format	ad.type
Creative ID	creative_id	adGroupAd.ad.id
Creative Name	creative_name	adGroupAd.ad.name
Creative Reported URL	creative_reported_url	adGroupAd.ad.finalUrls.0
Date	date_field	segments.date
Final URL	final_url	campaign.finalUrls 또는 adGroupCriterion.finalUrls 또는 adGroup.ad.finalUrls
Keyword	keyword	ad_group_criterion.keyword.text
Keyword ID	keyword_id	ad_group_criterion.criterion_id
Keyword Match Type	keyword_match_type	ad_group_criterion.keyword.match_type
Network Campaign ID	adn_campaign_id	campaign.id
Network Campaign Name	adn_campaign_name	campaign.name
Network Creative ID	adn_creative_id	adGroupAd.ad.id
Network Creative Name	adn_creative_name	adGroupAd.ad.name
Network Sub Campaign ID	adn_sub_campaign_id	adGroup.id
Network Sub Campaign Name	adn_sub_campaign_name	adGroup.name
OS	os	campaign.appCampaignSetting.appStore
Platform	platform	campaign.appCampaignSetting.appStore와 segments.device의 혼합
Public Id	site_public_id	campaign.appCampaignSetting.appId
Quality Score	quality_score	historicalQualityScore
Retargeting	retention	campaign.advertisingChannelSubType == ‘APP_CAMPAIGN_FOR_ENGAGEMENT_’
Sub Ad Network	adn_subadnetwork	segments.adNetworkType
Target Countries	target_countries_str	country 참고
Text	creative_text	본 필드 생성을 위해서, 광고에 제공되는 모든 텍스트 필드를 가져오며, 이는 광고 유형(ad type)에 기반한 필드와 상이할 수 있습니다. 예시) UAC의 경우, 해당 필드는 Google Ads에서 asset.textAsset.text입니다. 하나 이상의 텍스트가 존재한다면 (예시, 헤드라인 + 설명), Singular는 그 텍스트들을 하나의 문자열로 연결합니다.
Timezone	adn_timezone	customer.timeZone (와 일부 추가 로직)
Tracking URL	tracking_url	adGroupAd.ad.trackingUrlTemplate
Search Impression Share (Google)	search_impression_share	search_impression_share
Search Top Impression Share (Google)	search_top_impression_share	search_top_impression_share
Search Absolute Top Impression Share (Google)	search_absolute_top_impression_share	search_absolute_top_impression_share
메트릭
Cost	adn_cost	metrics.costMicro
Network Clicks	adn_clicks	metrics.clicks
Network Impressions	adn_impressions	metrics.impressions
Network Installs	adn_installs	metrics.conversions / metrics.allConversions
Original Cost	adn_original_cost	metrics.costMicro
Original Currency	adn_original_currency	customer.currencyCode
Video Views	video_views	metrics.videoViews
Completed Video Views	completed_video_views	metrics.video_quartile_p100_rate
Video Views - 25%	video_views_25pct	metrics.video_quartile_p25_rate
Video Views - 50%	video_views_50pct	metrics.video_quartile_p50_rate
Video Views - 75%	video_views_75pct	metrics.video_quartile_p75_rate

Singular UI 필드	Singular API 필드	Google 퍼블리셔 세분화 필드
디멘션
Account ID	adn_account_id	customer.id
Account Name	adn_account_name	customer.descriptiveName
App Site ID	app_site_id	campaign.appCampaignSetting.appId
Asset ID	asset_id	asset.id
Asset Name	asset_name	asset.name (비디오 유형의 에셋에는 다음을 사용: “asset.youtubeVideoAsset.youtubeVideoTitle”)
Campaign URL	adn_campaign_url	ad.finalUrl 를 사용할 수 없는 경우, ad.trackingUrlTemplate를 사용
Creative Format	creative_format	ad.type
Creative ID	creative_id	adGroupAd.ad.id
Creative Name	creative_name	adGroupAd.ad.name
Creative Reported URL	creative_reported_url	adGroupAd.ad.finalUrls.0
Date	date_field	segments.date
Final URL	final_url	campaign.finalUrls 또는 adGroupCriterion.finalUrls 또는 adGroup.ad.finalUrls
Network Campaign ID	adn_campaign_id	campaign.id
Network Campaign Name	adn_campaign_name	campaign.name
Network Creative ID	adn_creative_id	adGroupAd.ad.id
Network Creative Name	adn_creative_name	adGroupAd.ad.name
Network Sub Campaign ID	adn_sub_campaign_id	adGroup.id
Network Sub Campaign Name	adn_sub_campaign_name	adGroup.name
OS	os	campaign.appCampaignSetting.appStore
Platform	platform	campaign.appCampaignSetting.appStore와 segments.device의 혼합
Public Id	site_public_id	campaign.appCampaignSetting.appId
Publisher Site Name	publisher_site_name	adGroupCriterion.placement.url
Retargeting	retention	campaign.advertisingChannelSubType == ‘APP_CAMPAIGN_FOR_ENGAGEMENT_’
Sub Ad Network	adn_subadnetwork	segments.adNetworkType
Target Countries	target_countries_str	country 참고
Text	creative_text	본 필드 생성을 위해서, 광고에 제공되는 모든 텍스트 필드를 가져오며, 이는 광고 유형(ad type)에 기반한 필드와 상이할 수 있습니다. 예시) UAC의 경우, 해당 필드는 Google Ads에서 asset.textAsset.text입니다. 하나 이상의 텍스트가 존재한다면 (예시, 헤드라인 + 설명), Singular는 그 텍스트들을 하나의 문자열로 연결합니다.
Timezone	adn_timezone	customer.timeZone (와 일부 추가 로직)
Tracking URL	tracking_url	adGroupAd.ad.trackingUrlTemplate
메트릭
Cost	adn_cost	metrics.costMicro
Network Clicks	adn_clicks	metrics.clicks
Network Impressions	adn_impressions	metrics.impressions
Network Installs	adn_installs	metrics.conversions / metrics.allConversions
Original Cost	adn_original_cost	metrics.costMicro
Original Currency	adn_original_currency	customer.currencyCode
Video Views	video_views	metrics.videoViews
Completed Video Views	completed_video_views	metrics.video_quartile_p100_rate
Video Views - 25%	video_views_25pct	metrics.video_quartile_p25_rate
Video Views - 50%	video_views_50pct	metrics.video_quartile_p50_rate
Video Views - 75%	video_views_75pct	metrics.video_quartile_p75_rate

Singular UI 필드	Singular API 필드	Google 쇼핑 세분화 필드
디멘션
Account ID	adn_account_id	customer.id
Account Name	adn_account_name	customer.descriptiveName
App Site ID	app_site_id	campaign.appCampaignSetting.appId
Asset ID	asset_id	asset.id
Asset Name	asset_name	asset.name (본 유형 비디오 에셋에는, “asset.youtubeVideoAsset.youtubeVideoTitle”를 사용)
Brand	brand	brand
Campaign URL	adn_campaign_url	ad.finalUrl를 사용하며 이를 사용할 수 없는 경우, ad.trackingUrlTemplate를 사용
City	city_field	geo_target_city
Country	country_field	geographicView.countryCriterionId
Creative Format	creative_format	ad.type
Creative ID	creative_id	adGroupAd.ad.id
Creative Name	creative_name	adGroupAd.ad.name
Creative Reported URL	creative_reported_url	adGroupAd.ad.finalUrls.0
Date	date_field	segments.date
DMA Name	dma_name_field	geo_target_metro
Final URL	final_url	campaign.finalUrls 또는 adGroupCriterion.finalUrls 또는 adGroup.ad.finalUrls
Keyword	keyword	ad_group_criterion.keyword.text
Merchant ID	merchant_id	merchant_id
Network Campaign ID	adn_campaign_id	campaign.id
Network Campaign Name	adn_campaign_name	campaign.name
Network Creative ID	adn_creative_id	adGroupAd.ad.id
Network Creative Name	adn_creative_name	adGroupAd.ad.name
Network Sub Campaign ID	adn_sub_campaign_id	adGroup.id
Network Sub Campaign Name	adn_sub_campaign_name	adGroup.name
OS	os	campaign.appCampaignSetting.appStore
Platform	platform	campaign.appCampaignSetting.appStore와 segments.device의 혼합
Product Item ID	product_item_id	product_item_id
Public Id	site_public_id	campaign.appCampaignSetting.appId
Publisher Site Name	publisher_site_name	adGroupCriterion.placement.url
Retargeting	retention	campaign.advertisingChannelSubType == ‘APP_CAMPAIGN_FOR_ENGAGEMENT_’
Sub Ad Network	adn_subadnetwork	segments.adNetworkType
Target Countries	target_countries_str	country 참고
Text	creative_text	본 필드 생성을 위해서, 광고에 제공되는 모든 텍스트 필드를 가져오며, 이는 광고 유형(ad type)에 기반한 필드와 상이할 수 있습니다. 예시) UAC의 경우, 해당 필드는 Google Ads에서 asset.textAsset.text 입니다. 하나 이상의 텍스트가 존재한다면 (예시, 헤드라인 + 설명), Singular는 그 텍스트들을 하나의 문자열로 연결합니다.
Timezone	adn_timezone	customer.timeZone (와 일부 추가 로직)
Tracking URL	tracking_url	adGroupAd.ad.trackingUrlTemplate
메트릭
Cost	adn_cost	metrics.costMicro
Network Clicks	adn_clicks	metrics.clicks
Network Impressions	adn_impressions	metrics.impressions
Network Installs	adn_installs	metrics.conversions / metrics.allConversions
Original Cost	adn_original_cost	metrics.costMicro
Original Currency	adn_original_currency	customer.currencyCode
Video Views	video_views	metrics.videoViews
Completed Video Views	completed_video_views	metrics.video_quartile_p100_rate
Video Views - 25%	video_views_25pct	metrics.video_quartile_p25_rate
Video Views - 50%	video_views_50pct	metrics.video_quartile_p50_rate
Video Views - 75%	video_views_75pct	metrics.video_quartile_p75_rate

Singular UI 필드	Singular API 필드	Google 비디오 세분화 필드
디멘션
Account ID	adn_account_id	customer.id
Account Name	adn_account_name	customer.descriptiveName
App Site ID	app_site_id	campaign.appCampaignSetting.appId
Asset ID	asset_id	asset.id
Asset Name	asset_name	asset.name (비디오 유형의 에셋에는 다음을 사용: “asset.youtubeVideoAsset.youtubeVideoTitle”)
Campaign URL	adn_campaign_url	ad.finalUrl 를 사용할 수 없다면, ad.trackingUrlTemplate를 사용
City	city_field	geo_target_city
Country	country_field	geographicView.countryCriterionId
Creative Format	creative_format	ad.type
Creative ID	creative_id	adGroupAd.ad.id
Creative Name	creative_name	adGroupAd.ad.name
Creative Reported URL	creative_reported_url	adGroupAd.ad.finalUrls.0
Date	date_field	segments.date
DMA Name	dma_name_field	geo_target_metro
Final URL	final_url	campaign.finalUrls 또는 adGroupCriterion.finalUrls 또는 adGroup.ad.finalUrls
Keyword	keyword	ad_group_criterion.keyword.text
Network Campaign ID	adn_campaign_id	campaign.id
Network Campaign Name	adn_campaign_name	campaign.name
Network Creative ID	adn_creative_id	adGroupAd.ad.id
Network Creative Name	adn_creative_name	adGroupAd.ad.name
Network Sub Campaign ID	adn_sub_campaign_id	adGroup.id
Network Sub Campaign Name	adn_sub_campaign_name	adGroup.name
OS	os	campaign.appCampaignSetting.appStore
Platform	platform	campaign.appCampaignSetting.appStore와 segments.device 혼합
Public Id	site_public_id	campaign.appCampaignSetting.appId
Publisher Site Name	publisher_site_name	adGroupCriterion.placement.url
Retargeting	retention	campaign.advertisingChannelSubType == ‘APP_CAMPAIGN_FOR_ENGAGEMENT_’
Sub Ad Network	adn_subadnetwork	segments.adNetworkType
Target Countries	target_countries_str	country 참고
Text	creative_text	본 필드 생성을 위해서, 광고에 제공되는 모든 텍스트 필드를 가져오며, 이는 광고 유형(ad type)에 기반한 필드와 상이할 수 있습니다. 예시) UAC의 경우, 해당 필드는 Google Ads에서 asset.textAsset.text 입니다. 하나 이상의 텍스트가 존재한다면 (예시, 헤드라인 + 설명), Singular는 그 텍스트들을 하나의 문자열로 연결합니다.
Timezone	adn_timezone	customer.timeZone (와 일부 추가 로직)
Tracking URL	tracking_url	adGroupAd.ad.trackingUrlTemplate
Video ID	video_id	video_id
Video Channel ID	video_channel_id	video_channel_id
Video Duration Millis	video_duration_millis	video_duration_millis
Video Title	video_title	video_title
메트릭
Cost	adn_cost	metrics.costMicro
Network Clicks	adn_clicks	metrics.clicks
Network Impressions	adn_impressions	metrics.impressions
Network Installs	adn_installs	metrics.conversions / metrics.allConversions
Original Cost	adn_original_cost	metrics.costMicro
Original Currency	adn_original_currency	customer.currencyCode
Video Views	video_views	metrics.videoViews
Completed Video Views	completed_video_views	metrics.video_quartile_p100_rate
Video Views - 25%	video_views_25pct	metrics.video_quartile_p25_rate
Video Views - 50%	video_views_50pct	metrics.video_quartile_p50_rate
Video Views - 75%	video_views_75pct	metrics.video_quartile_p75_rate

특별 설정 지침

인증

데이터 커넥터 설정에 관한 일반적인 정보는 Data Connectors 데이터 커넥터 FAQ를 참고하세요.

AdWords 데이터 커넥터를 설정할 때 Google Ads 계정을 사용하여 로그인하도록 요청됩니다. 그러므로, Google Ads 매니저 계정(과거 MCC 계정)으로 로그인하는 것을 강력히 권장합니다.

Google 매니저 계정(MCC)은 Singular에 광고 계정들을 한 페이지에서 볼 수 있는 권한을 제공합니다. 이후, Singular 리포트에 포함하고 싶은 계정을 리스트에서 고르세요. 매니저 계정(MCC)을 사용하지 않을 경우, 각 광고 계정마다 데이터 커넥터를 각각 추가해야 합니다.

고객 ID(매니저와 개인 계정)은 다음에서 찾을 수 있습니다.

Google Ads 계정으로 로그인합니다.
우측 상단에 위치한 도움 아이콘을 클릭합니다.
메뉴 하단의 Customer ID를 찾습니다.

컨버전 이벤트

상단의 테이블의 기본사항 메트릭에 추가로, 고객이 필요한 어떤 Google Ads 메트릭이든 가져와 해당 메트릭 값을 Singular 리포트에 표시할 수도 있습니다.

추가 메트릭들을 가져오기 위해서는, Singular에서 컨버전 이벤트(conversion events)를 설정해야 합니다.

Singular에서 Settings > Events로 가세요. 커스텀 이벤트(Custom Events)와 컨버전 이벤트(Conversion Events) 탭이 모두 존재한다면, 컨버전 이벤트를 선택하세요.
New Event를 클릭하세요.
AdWords 드롭다운에서 Adwords에서 사용할 수 있는 메트릭 목록을 볼 수 있습니다. 각 활동을 별개의 Singular 이벤트로 매핑하거나 다수의 메트릭을 한 이벤트로 묶을 수 있습니다.

다음 날, Singular가 계정에서 일별 데이터를 가져올 때 해당 활동들의 데이터도 가져옵니다.
리포트(Reports) 페이지에서 리포트를 실행하여, Singular가 신규 이벤트들과 더불어 일부 데이터를 채우면, 이후 이벤트(Events) 드롭다운에서 컨버전 이벤트들을 선택하세요.

FAQ와 트러블슈팅

Manager account ID (MCC ID)를 어떻게 찾을까요?

고객 ID(매니저용과 개인 계정용 모두 해당)를 찾으려면 다음을 참고하세요.

Google Ads 계정으로 로그인하세요.
우측 상단의 도움 아이콘을 클릭하세요.
메뉴 밑에 위치한 Customer ID를 확인하세요.

상세 정보는 Google의 도큐먼트 내 Google Ads 매니저 계정에 대하여를 참고하세요.

왜 Google Ads 매니저 계정을 인증할 수 없을까요?

Google Ads 매니저 계정의 Settings > Network Settings에서, API access를 토글 했는지 확인하세요. 이후, Singular 내 Google Ads 매니저 계정을 다시 인증해보세요.

다른 세분화를 사용할 때 왜 국가 데이터가 리포트에 표시될까요?

국가 정보를 제공하지 않는 세분화를 사용할 때도, Singular는 Google 내 캠페인 타깃 설정이나 트래커 데이터(해당하는 경우)를 통해 국가 세분성을 제공하려 하기 때문입니다:

만약 캠페인이 한 국가에서만 타깃 된다면, Singular는 리포트에서 해당 국가를 표시합니다.
복수 국가가 타깃 되고 동일 캠페인에 대해 트래커 데이터가 있는 경우라면, Singular는 국가 당 지출을 트래커 데이터 내 국가 당 인스톨 비율에 기반하여 예측합니다. 국가 당 지출 메트릭은 어떻게 계산될까요?를 참고.

Singular는 AdWords 캠페인에 대한 매체 인스톨(Network Installs)을 어떻게 가져올까요?

Google Ads는 앱 다운로드, 유저 로그인, 구매 등 여러 "컨버전 액션" 유형들을 추적합니다. 일반적으로, 대부분의 고객들은 앱 인스톨에 관심이 있기 때문에, 해당 유형 다운로드의 컨버전들을 가져와 리포트에서 매체 인스톨(Network Installs) 내 컨버전들의 메트릭들을 표시합니다.

참고: 매체 인스톨(Network Installs) 은 Singular에서 광고 매체에 의해 보고된 인스톨 수를 의미합니다. 이를 첫 어트리뷰션 트래커 데이터에 기반하는 인스톨과 헷갈리지 않도록 합니다. Adwords를 예로 들면, 매체 인스톨은 Adwords가 의해 보고한 "first_open" 컨버전 수 입니다.

리포트 쿼리를 빌드할 때, 소스 메트릭(Source Metrics)의 매체 인스톨을 선택할 수 있습니다. 소스 메트릭이란 무엇인가요?를 통해 더 자세한 내용을 참고하세요.

Singular는 Adwords에서 소재를 가져오나요?

네, Singular는 소재 (이미지, 텍스트, 비디오, 등) 자체 뿐 아니라 소재 메트릭도 가져옵니다. 이는 구 Adwords 연동이든 신규 연동이든 상관없이 적용되는 부분입니다. 하지만, 신규 연동에서만 UAC캠페인에 대한 소재를 표시합니다.

Adwords에서 "소재"는 무엇에 해당하나요? "소재"와 "에셋"의 차이점은 무엇인가요?

Singular의 소재(creative)는 Google Ads의 광고(Ad)에 해당합니다.

Singular의 신규 에셋(asset) 디멘션은 Google Ads의 에셋(asset)에 해당합니다. Singular에서 이 세분성의 신규 레벨을 추가한 이유는 Google이 UAC(모바일 앱) 광고와 같은 일부 광고들에서 복수 에셋을 갖기 때문입니다.

참고: Google Ads API 제한으로 인해, 에셋에 따른 인스톨을 세분화하여 볼 수 없으며, 소재에 따른 인스톨만 볼 수 있습니다. 즉, 에셋 ID(Asset ID) 또는 에셋 명(Asset Name)을 포함하여 리포트를 실행하면, 다른 메트릭들은 볼 수 있으나 인스톨은 볼 수 없게 된다는 의미입니다.

Singular는 어떤 Google 광고 유형을 지원할까요?

Singular는 다음 Google 광고 유형들을 지원합니다.

광고 유형	포함되는 광고 에셋(들)
광고 유형	텍스트	이미지	비디오
Gmail
Hotel
Local
Text
Expanded Text
Expanded Dynamic Search
Shopping Product
Shopping Smart
Call Only
HTML5 Upload
Dynamic HTML5
Responsive Search
Legacy Responsive Search
Legacy App Install
Responsive Display
Video
VIDEO BUMPER
VIDEO NON SKIPPABLE IN STREAM
VIDEO OUTSTREAM
VIDEO TRUEVIEW DISCOVERY
VIDEO TRUEVIEW IN STREAM
VIDEO RESPONSIVE
App (UAC)
App Engagement (UAC - 딥링크 된 광고)
APP PRE REGISTRATION

참고: 광고 유형에 대한 Google의 이름은 (“App Engagement”, “Responsive Search” 등) Singular 리포트에 표시되지 않습니다. 리포트에서 보이는 소재 유형 디멘션은 이와 관련이 없으며 - 소재 유형은 해당 소재가 이미지, 텍스트, 또는 비디오인지를 나타냅니다.

국가 세분성을 가져오려 합니다. 왜 국가 정보가 없는 행들이 보일까요?

동일한 캠페인에 대해 Google의 여러 엔드포인트에서 제공하는 데이터 중 불일치가 발생할 경우 발생할 수 있는 현상입니다.

Singular가 Google Ads API에서 데이터를 가져올 때, 다음 과정들을 거칩니다.

선택한 세분성과 상응하는 Google Ads API 엔드포인트로부터 데이터를 가져오며, 이 경우 location_view 엔드포인트에서 국가 정보를 제공합니다.
총 메트릭 정보를 가져오기 위해 Google 캠페인 엔드포인트로부터 동일 캠페인에 대한 데이터를 가져옵니다.　
각 캠페인에 대한 메트릭을 비교하여, 필요한 경우 데이터와 결과가 일치하도록 한 행을 추가합니다. 하단의 삽화를 예시로 참고하세요. 캠페인 레벨 데이터가 데이터 진실성을 가늠하는 척도가 됩니다.

Screen_Shot_2019-12-01_at_19.29.13.png

소재 리포트에서 왜 비디오를 볼 수 없나요?

Google의 프라이버시 정책에 의해 YouTube 비디오를 다운로드 할 수 없습니다. 그러므로, 비디오 소재에는 비디오 썸네일 + YouTube 비디오에 대한 링크를 포함합니다.

소재 리포트에서는 왜 미디어 번들(Media Bundles)을 볼 수 없을까요?

미디어 번들은 "이미지", "텍스트", "비디오"와 같이 소재의 한 종류입니다. 보유한 광고 소재가 미디어 번들이라면, 해당 소재들에 대한 메트릭은 볼 수 있으나 해당 소재 자체는 볼 수 없습니다. 왜냐하면, Google Ads API가 해당 소재를 제공하지 않기 때문입니다.

소재명(Creative Name) 디멘션은 왜 항상 제공되지는 않을까요?

UAC 소재에 대해 Google은 ID는 제공하나 소재 명은 제공하지 않기 때문입니다.