빠른 세부 정보
데이터 커넥터 기술 | API(구글 애즈 API v10) |
데이터 분류(세분화) |
기본 구성에서 데이터는 다음과 같은 기준으로 분류됩니다:
다른 구성을 선택하려면 아래의 데이터 매핑을참조하세요. |
데이터를 가져오는 기간 | 싱귤러는 매일 7일 전의 데이터를 가져옵니다. 일주일에 한 번 월요일에 Singular는 30일 전의 데이터를 가져옵니다. |
시간대 | 고객이 Google 설정에서 계정별로 정의합니다. |
크리에이티브(광고) 수준에서 데이터를 사용할 수있나요? | 예 |
싱귤러는 크리에이티브 에셋을 표시하나요? | 예(단, 싱귤러가 썸네일만 표시하는 YouTube 동영상은 제외) |
알려진 제한사항 |
|
데이터 매핑
여러 세분화 구성 중 하나로 데이터를 가져올 수 있으며, 각 구성은 서로 다른 차원 세트를 제공하고 각각 고유한 장점과 제한 사항이 있습니다.
- 기본 구성은 국가입니다. 다른 구성을 선택하려면 Singular 지원팀에 문의하세요.
- 메트로(DMA ) 구성은 미국 기반 광고에만 유용합니다(DMA 정보는 미국에서만 사용할 수 있음). 캠페인의 일부 또는 전부가 미국 이외의 지역에서 운영되는 경우, 대신 도시구성을 사용하세요.
- 키워드 및 제휴매체사 구성에는 구글 애즈 API 제한으로 인해 UAC 캠페인에 대한 데이터가 포함되지 않습니다.
- 키워드 및 제휴매체사 구성에는 국가 또는 기타 위치 차원이 포함되지 않지만, 타겟팅 국가 설정에 따라 싱귤러에서 국가를 제공할 수 있습니다.
용어에 대한 팁:
- 싱귤러의 크리에이티브는 구글 애즈의 광고에 해당합니다.
- 싱귤러의 새로운 애셋 차원은 구글 애즈의 애셋에 해당합니다. Google에서 이 새로운 세분화 수준을 추가한 이유는 UAC(모바일 앱) 광고와 같은 일부 유형의 광고에는 여러 개의 에셋이 포함되어 있기 때문입니다.
- 단수 보고의 모든 필드에 대한 설명은 단수 지표 및 측정기준 용어집을 참조하세요.
Field in Singular UI | Field in Singular API | Field in Google Country Breakdown |
Dimensions | ||
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 (for assets of type Video we use “asset.youtubeVideoAsset.youtubeVideoTitle”) |
Campaign URL | adn_campaign_url | ad.finalUrl if not available, then 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 | A combination of campaign.appCampaignSetting.appStore and 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 | See country |
Text | creative_text | To create this field, we take any available text fields in the ad, which may differ based on the ad type. E.g., for UAC, the field in Google Ads is asset.textAsset.text. If there is more than one text (e.g. headline + description), we concatenate them into one string. |
Timezone | adn_timezone | customer.timeZone (Singular receives time data from Adwords in the client's timezone and converts it to UTC.) |
Tracking URL | tracking_url | adGroupAd.ad.trackingUrlTemplate |
Asset Performance
|
asset_performance | performance_label |
Metrics | ||
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 |
Field in Singular UI | Field in Singular API | Field in Google Metro Breakdown |
Dimensions | ||
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 (for assets of type Video we use “asset.youtubeVideoAsset.youtubeVideoTitle”) |
Campaign URL | adn_campaign_url | ad.finalUrl if not available, then 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 | A combination of campaign.appCampaignSetting.appStore and 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 | See country |
Text | creative_text | To create this field, we take any available text fields in the ad, which may differ based on the ad type. E.g., for UAC, the field in Google Ads is asset.textAsset.text. If there is more than one text (e.g. headline + description), we concatenate them into one string. |
Timezone | adn_timezone | customer.timeZone (with some extra logic) |
Tracking URL | tracking_url | adGroupAd.ad.trackingUrlTemplate |
Metrics | ||
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 |
Field in Singular UI | Field in Singular API | Field in Google City Breakdown |
Dimensions | ||
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 (for assets of type Video we use “asset.youtubeVideoAsset.youtubeVideoTitle”) |
Campaign URL | adn_campaign_url | ad.finalUrl if not available, then 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 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 | A combination of campaign.appCampaignSetting.appStore and 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 | See country |
Text | creative_text | To create this field, we take any available text fields in the ad, which may differ based on the ad type. E.g., for UAC, the field in Google Ads is asset.textAsset.text. If there is more than one text (e.g. headline + description), we concatenate them into one string. |
Timezone | adn_timezone | customer.timeZone (with some extra logic) |
Tracking URL | tracking_url | adGroupAd.ad.trackingUrlTemplate |
Metrics | ||
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 |
Field in Singular UI | Field in Singular API | Field in Google Keyword Breakdown |
Dimensions | ||
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 (for assets of type Video we use “asset.youtubeVideoAsset.youtubeVideoTitle”) |
Campaign URL | adn_campaign_url | ad.finalUrl if not available, then 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 OR adGroupCriterion.finalUrls OR 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 | A combination of campaign.appCampaignSetting.appStore and 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 | See country |
Text | creative_text | To create this field, we take any available text fields in the ad, which may differ based on the ad type. E.g., for UAC, the field in Google Ads is asset.textAsset.text. If there is more than one text (e.g. headline + description), we concatenate them into one string. |
Timezone | adn_timezone | customer.timeZone (with some extra logic) |
Tracking URL | tracking_url | adGroupAd.ad.trackingUrlTemplate |
Metrics | ||
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 |
Field in Singular UI | Field in Singular API | Field in Google Keyword + Quality Score Breakdown |
Dimensions | ||
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 (for assets of type Video we use “asset.youtubeVideoAsset.youtubeVideoTitle”) |
Campaign URL | adn_campaign_url | ad.finalUrl if not available, then 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 OR adGroupCriterion.finalUrls OR 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 | A combination of campaign.appCampaignSetting.appStore and 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 | See country |
Text | creative_text | To create this field, we take any available text fields in the ad, which may differ based on the ad type. E.g., for UAC, the field in Google Ads is asset.textAsset.text. If there is more than one text (e.g. headline + description), we concatenate them into one string. |
Timezone | adn_timezone | customer.timeZone (with some extra logic) |
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 |
Metrics | ||
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 |
Field in Singular UI | Field in Singular API | Field in Google Publisher Breakdown |
Dimensions | ||
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 (for assets of type Video we use “asset.youtubeVideoAsset.youtubeVideoTitle”) |
Campaign URL | adn_campaign_url | ad.finalUrl if not available, then 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 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 | A combination of campaign.appCampaignSetting.appStore and 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 | See country |
Text | creative_text | To create this field, we take any available text fields in the ad, which may differ based on the ad type. E.g., for UAC, the field in Google Ads is asset.textAsset.text. If there is more than one text (e.g. headline + description), we concatenate them into one string. |
Timezone | adn_timezone | customer.timeZone (with some extra logic) |
Tracking URL | tracking_url | adGroupAd.ad.trackingUrlTemplate |
Metrics | ||
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 |
Field in Singular UI | Field in Singular API | Field in Google Shopping Breakdown |
Dimensions | ||
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 (for assets of type Video we use “asset.youtubeVideoAsset.youtubeVideoTitle”) |
Brand | brand | brand |
Campaign URL | adn_campaign_url | ad.finalUrl if not available, then 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 OR adGroupCriterion.finalUrls OR 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 | A combination of campaign.appCampaignSetting.appStore and 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 | See country |
Text | creative_text | To create this field, we take any available text fields in the ad, which may differ based on the ad type. E.g., for UAC, the field in Google Ads is asset.textAsset.text. If there is more than one text (e.g. headline + description), we concatenate them into one string. |
Timezone | adn_timezone | customer.timeZone (with some extra logic) |
Tracking URL | tracking_url | adGroupAd.ad.trackingUrlTemplate |
Metrics | ||
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 |
Field in Singular UI | Field in Singular API | Field in Google Video Breakdown |
Dimensions | ||
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 (for assets of type Video we use “asset.youtubeVideoAsset.youtubeVideoTitle”) |
Campaign URL | adn_campaign_url | ad.finalUrl if not available, then 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 OR adGroupCriterion.finalUrls OR 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 | A combination of campaign.appCampaignSetting.appStore and 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 | See country |
Text | creative_text | To create this field, we take any available text fields in the ad, which may differ based on the ad type. E.g., for UAC, the field in Google Ads is asset.textAsset.text. If there is more than one text (e.g. headline + description), we concatenate them into one string. |
Timezone | adn_timezone | customer.timeZone (with some extra logic) |
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 |
Metrics | ||
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 |
특별 설정 지침
인증
데이터 커넥터 설정에 대한 일반적인 정보는 데이터 커넥터 FAQ를참조하세요.
애드워즈 데이터 커넥터를 설정할 때 Google 광고 계정을 사용하여 로그인하라는 메시지가 표시됩니다. Google 광고 관리자 계정(이전의 MCC 계정)으로 로그인하는 것을 적극 권장합니다.
Google 관리자 계정(MCC)을 사용하면 모든 광고 계정에 한 번에 액세스할 수 있습니다. 그런 다음 목록에서 단수 보고서에 포함할 계정을 골라 선택할 수 있습니다. 관리자 계정(MCC)을 사용하지 않는 경우 각 광고 계정에 대해 별도의 데이터 커넥터를 추가해야 합니다.
고객 ID(관리자 및 개별 계정 모두)를 찾으려면 다음과 같이 하세요:
- Google 광고 계정에 로그인합니다.
- 오른쪽 상단의 도움말 아이콘을 클릭합니다.
- 메뉴 하단에서 고객 ID를 찾습니다.
전환 이벤트
위 표의 기본 지표 외에도 Singular는 구글 애즈에서 필요한 모든 지표를 가져와서 싱귤러 보고서에 해당 통계를 표시할 수 있습니다.
에셋 수준에서 더 자세한 인사이트를 얻고 싶다면, '입찰 가능 앱-설치 후 전환'을 이벤트로 추가하는 것을 고려해 보세요. 이 데이터는 Google Ad의 API에서 가져옵니다. 이 기능을 사용하면 '인앱 액션' 이벤트에 대한 추가 데이터를 해당 캠페인으로 가져올 수 있습니다. 전환 이벤트에는 코호트 데이터가 없으며 '실제' 코호트 기간과만 연결된다는 점에 유의해야 합니다."
싱귤러에서 전환 이벤트를 설정하려면 다음 단계를 따르세요:
- 단수에서 설정 > 이벤트로 이동합니다. 사용자 지정 이벤트 및 전환 이벤트탭이 모두 있는 경우 전환 이벤트를 선택합니다.
- 새 이벤트를 클릭합니다.
-
애드워즈 드롭다운에 애드워즈에서 사용할 수 있는 지표 목록이 표시됩니다. 각 활동을 별도의 단일 이벤트에 매핑하거나 여러 지표를 단일 이벤트로 결합할 수 있습니다.
다음날 싱귤러가 계정에 대한 일일 데이터를 가져올 때 이러한 활동의 통계도 함께 가져옵니다.
- 싱귤러가 새 전환 이벤트에 일부 데이터를 채운 후 보고서 페이지에서 보고서를 실행할 때 이벤트 드롭다운에서 전환 이벤트를 선택합니다.
FAQ 및 문제 해결
고객 ID(관리자 및 개인 계정 모두)를 찾으려면 다음과 같이 하세요:
- Google 광고 계정에 로그인합니다.
- 오른쪽 상단의 도움말 아이콘을 클릭합니다.
- 메뉴 하단에서 고객 ID를 찾습니다.
자세한 내용은 Google 문서에서 Google 광고 관리자 계정에대한 정보를 참조하세요.
Google 광고 관리자 계정에서 설정> 네트워크 설정으로 이동합니다. API 액세스를 사용하도록 설정했는지 확인합니다. 그런 다음 단수에서 구글 애즈 매니저 계정 인증을 다시 시도합니다.
국가 정보를 제공하지 않는 분류를 사용하는 경우, 싱귤러는 Google 및/또는 트래커 데이터 (있는 경우)의 캠페인 타겟팅 설정을 확인하여 국가 세분화를 제공하려고 시도합니다:
- 캠페인이 한 국가를 타겟팅하는 경우 보고서에 해당 국가를 표시합니다.
- 여러 국가를 타겟팅하고 동일한 캠페인에 대한 트래커 데이터도 있는 경우, 트래커 데이터의 국가별 인스톨 비율에 따라 국가별 비용을 추정합니다. 국가별 비용 지표는 어떻게 계산되나요?
구글 광고는 앱 다운로드, 사용자 가입, 구매 등 다양한 유형의 '전환 액션'을 추적합니다. 기본적으로 대부분의 고객이 앱 설치에 관심이 있기 때문에 다운로드 유형의 전환을 가져와서 보고서의 네트워크 설치필드에 해당 지표를 표시합니다.
참고: 네트워크 설치는 광고 네트워크에서 보고한 설치 수를 반영하는 단수 지표로, 일반적으로 어트리뷰션 트래커의 데이터를 기반으로 하는 설치 수와 혼동하지 말아야 합니다. 애드워즈의 경우 네트워크 설치는 애드워즈에서 보고한 '첫_오픈' 전환 수입니다.
보고서 쿼리를 작성할 때 소스 지표 섹션에서 네트워크 인 스톨을 선택할 수 있습니다. 자세한 내용은 소스 지표란 무엇인가요?를 참조하세요.
예. 싱귤러는 광고 소재 자체(이미지, 텍스트, 동영상 등)뿐만 아니라 크리에이티브 지표도 가져옵니다. 이는 이전 버전의 애드워즈 통합을 사용하든 새 버전을 사용하든 마찬가지입니다. 그러나 새 통합 프로그램에서만 UAC 캠페인용 광고 소재가 표시됩니다.
싱귤러의 크리에이티브는 구글 애즈의 광고에 해당합니다.
싱귤러의 새로운 애셋 차원은 구글 애즈의 애셋에 해당합니다. 구글에서 이 새로운 세분화 수준을 추가한 이유는 UAC(모바일 앱) 광고와 같은 일부 유형의 광고가 여러 개의 에셋을 포함하고 있기 때문입니다. 에셋에 대해 보고되는 인스톨은 "biddable_app_install_conversions" 지표에서 가져온 것으로,"metrics.conversions"를 사용하는 다른 세분성과는 다릅니다.
싱귤러가 지원하는 Google 광고 유형은 다음과 같습니다:
광고 유형 | 포함된 광고 자산 | ||
텍스트 | 이미지 | 동영상 | |
Gmail | |||
호텔 | |||
호텔 | |||
텍스트 | |||
확장 텍스트 | |||
확장된 동적 검색 | |||
쇼핑 제품 | |||
스마트 쇼핑 | |||
통화 전용 | |||
HTML5 업로드 | |||
동적 HTML5 | |||
반응형 검색 | |||
레거시 반응형 검색 | |||
레거시 앱 설치 | |||
반응형 디스플레이 | |||
비디오 | |||
비디오 범퍼 | |||
스트림에서 건너뛸 수 없는 동영상 | |||
비디오 아웃스트림 | |||
비디오 트루뷰 디스커버리 | |||
스트림 내 비디오 트루뷰 | |||
반응형 비디오 | |||
앱 (UAC) | |||
앱 인게이지먼트 (UAC - 딥링크 광고) | |||
앱 사전 등록 |
참고: 광고 유형에 대한 구글의 이름('앱 인게이지먼트', '반응형 검색' 등)은 싱글 리포트에 표시되지 않습니다. 보고서에 표시되는 광고 소재 유형 차원은 광고 소재가 이미지, 텍스트 또는 동영상인지 여부를 표시하는 것으로, 광고 소재와는 관련이 없습니다.
이는 동일한 캠페인에 대해 서로 다른 엔드포인트에서 Google이 제공하는 데이터 간에 불일치가 있을 때 발생할 수 있습니다.
싱귤러는 Google 광고 API에서 데이터를 가져올 때 다음 단계를 수행합니다:
- 해당 Google 광고 API 엔드포인트(이 경우 국가 정보를 제공하는 location_view엔드포인트)에서 선택한 분류의 데이터를 가져옵니다.
- Google의 캠페인엔드포인트에서 동일한 캠페인에 대한 데이터를 가져와 전체 지표를 가져옵니다.
- 각 캠페인의 지표를 비교하고 필요한 경우 행을 추가하여 데이터를 정렬합니다. 아래 그림에서 예를 참조하세요. 캠페인 수준 데이터는 신뢰할 수 있는 출처로 간주됩니다.
Google의 개인정보 처리방침에 따라 YouTube 동영상을 다운로드할 수 없습니다. 따라서 동영상 크리에이티브의 경우 동영상 썸네일과 YouTube 동영상 링크가 포함됩니다.
동영상 조회수 측정지표는 동영상 조회가 시작된 횟수를 계산한 것입니다. 동영상 전체를 보았는지 또는 1초만 보았는지 여부에 관계없이 동영상의 모든 노출 횟수를 계산합니다.
동영상 조회수 - 25%, 50%, 75% 지표는 각각 25%, 50%, 75% 표시까지 동영상을 시청한 사람들의 노출 수를 계산합니다. 마찬가지로, 완료된 동영상 조회수 지표는 동영상이 전체적으로 시청된 노출 수만 계산합니다. 이러한 값을 계산하기 위해 Google에서 제안한 공식인 노출 수 * 동영상 조회수 비율을사용합니다.
필요에 따라 동영상 조회수 지표 대신 백분율 지표 중 하나를 사용할 수 있습니다. Google 문서에서'동영상 재생 대상' 섹션을 참조하세요.
참고: YouTube 동영상의 조회수와 Google 광고 계정에 표시되는 조회수 사이에는 본질적인 차이가 있습니다. YouTube 조회수와 Google 광고 계정 조회수는 서로 다른 지표를 사용하여 계산됩니다.
- YouTube에서는 누군가가 30초 이상 또는 동영상이 끝날 때까지 중 먼저 도달하는 시간까지 동영상을 시청한 것으로 조회수를 계산합니다.
- Google 광고는 광고가 YouTube 또는 파트너 사이트에 게재될 때 집계되는 광고 노출 수로 조회수를 계산합니다.
- 따라서 YouTube 애널리틱스에 보고되는 조회수와 Google 광고 계정에 표시되는 조회수에 차이가 있을 수 있습니다.
- 또한 YouTube 애널리틱스는 실시간으로 업데이트되는 반면, Google 광고 데이터는 업데이트하는 데 최대 48시간이 걸릴 수 있습니다.
또한 YouTube 광고 및 조회수 측정지표는 기존 온라인 광고와 다르게 작동합니다. YouTube 광고를 실행할 때 누군가가 30초 동안 광고를 시청하거나 콜투액션 오버레이 또는 동반 배너를 클릭하는 등 어떤 식으로든 광고와 상호 작용할 때만 비용이 청구됩니다. 따라서 YouTube 광고의 효과를 측정하려면 단순한 조회수보다는 조회율 및 획득한 액션과 같은 참여 지표에 초점을 맞추는 것이 중요합니다 .
미디어 번들은 '이미지', '텍스트', '동영상'과 함께 또 다른 유형의 크리에이티브입니다. 광고 소재가 미디어 번들인 경우, 구글 애즈 API가 해당 소재를 제공하지 않기 때문에 이러한 소재에 대한 지표는 볼 수 있지만, 소재 자체는 볼 수 없습니다.
UAC 크리에이티브의 경우, 구글은 이름 대신 ID만 제공합니다.