Google Ads (AdWords) 데이터 커넥터

 

빠른 세부 정보

데이터 커넥터 기술 API (Google Ads API v19)
데이터 분석(세분화)

기본 구성에서 데이터는 다음 기준으로 분류됩니다:

  • 국가
  • 캠페인
  • 하위 캠페인 (Ad Group)
  • 하위 광고 네트워크 (Ad Network Type).

다른 구성을 선택하려면 아래 데이터 매핑을 참조하세요.

데이터를 얼마나 오래 거슬러 올라가는지 Singular는 매일 7일 전까지의 데이터를 가져옵니다. 매주 월요일에는 30일 전까지의 데이터를 가져옵니다.
시간대 Google 설정에서 고객이 계정별로 정의
크리에이티브(광고) 수준에서 데이터를 사용할 수 있나요?
Singular는 내 크리에이티브 에셋을 표시하나요? 예(YouTube 동영상 제외, 썸네일만 표시됩니다)
알려진 제한 사항
  • 크리에이티브에는 국가 세분화를 사용할 수 없습니다.
  • 크리에이티브 리포트에서 에셋 세분화 수준의 Installs 메트릭은 biddable_app_install_conversions"에서 매핑되며, 이는 다음을 사용하는 다른 세분화 수준과 다릅니다: "metrics.conversions"

데이터 매핑

여러 분류 구성 중 하나를 선택하여 데이터를 받을 수 있으며, 각 구성은 서로 다른 기준 세트를 제공하고 각각 고유한 장점과 제한 사항이 있습니다.

  • 기본 구성은 Country입니다. 다른 구성을 선택하려면 Singular 지원팀에 문의하세요.
  • Metro (DMA) 구성은 미국 대상 광고에만 유용합니다(DMA 정보는 미국에서만 제공됩니다). 캠페인의 일부 또는 전부가 미국 외 지역에서 운영되는 경우 대신 City 구성을 사용하세요.
  • Keyword Publisher 구성은 UAC 캠페인의 데이터를 포함하지 않습니다 (Google Ads API의 제한 때문입니다).
  • KeywordPublisher 구성에는 국가 또는 기타 위치 기준이 포함되지 않지만, Singular가 타겟 국가 설정을 기반으로 국가를 제공할 수 있습니다.
  • 연령 또는 성별 분류는 별도의 인구통계 분류로 제공됩니다(예: 여성/남성, 20-29 등).   

용어 관련 팁:

  • Singular의 Creative는 Google Ads의 Ad에 해당합니다.
  • Singular의 새로운 Asset 기준은 Google Ads의 Asset에 해당합니다. Google에서는 UAC(모바일 앱) 광고처럼 일부 광고 유형이 여러 에셋을 포함하기 때문에 이 새로운 세분화 수준을 추가했습니다.
  • Singular 리포팅의 모든 필드에 대한 설명은 Singular 메트릭 및 기준 용어집을 참조하세요.
  • Google에서 크리에이티브 리포트를 실행하는 방법에 대한 추가 팁은 Meta 및 Google Ads에서 크리에이티브 리포트를 실행하는 방법
Country Metro (DMA) City Keyword Keyword+Quality Score Publisher Shopping Video

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

Singular는 이 파트너의 캠페인 속성 가져오기도 지원합니다. 자세한 내용은 여기를 참조하세요.

특별 설정 안내

인증

데이터 커넥터 설정에 대한 일반적인 정보는 데이터 커넥터 FAQ를 참조하세요.

AdWords 데이터 커넥터를 설정할 때 Google Ads 계정으로 로그인하라는 메시지가 표시됩니다. Google Ads 관리자 계정(이전 명칭 MCC 계정)으로 로그인하는 것을 적극 권장합니다.

Google 관리자 계정(MCC)을 사용하면 모든 광고 계정에 한 번에 접근할 수 있습니다. 그런 다음 목록에서 Singular 리포트에 포함할 계정을 선택할 수 있습니다. 관리자 계정(MCC)을 사용하지 않으면 광고 계정마다 별도의 데이터 커넥터를 추가해야 합니다.

고객 ID를 찾으려면(관리자 계정과 개별 계정 모두):

  1. 다음에 로그인합니다: Google Ads 계정.
  2. 오른쪽 상단의 도움말 아이콘을 클릭합니다.
  3. 메뉴 하단에서 Customer ID를 찾습니다.

전환 이벤트

위 표의 기본 메트릭 외에도, Singular는 Google Ads에서 필요한 모든 메트릭을 가져와 Singular 리포트에 통계를 표시할 수 있습니다.

에셋 수준에서 더 자세한 인사이트가 필요하다면 'biddable-app-post-install-conversion'을 이벤트로 추가하는 것을 고려하세요. 이 데이터는 Google Ads API에서 가져옵니다. 이 기능을 사용하면 '인앱 액션' 이벤트에 대한 추가 데이터를 해당 캠페인에 반영할 수 있습니다. 단, 전환 이벤트에는 코호트 데이터가 없으며 '실제' 코호트 기간에만 연결된다는 점에 유의하세요.

Singular에서 전환 이벤트를 설정하려면 다음 단계를 따르세요:

  1. Singular에서 다음으로 이동합니다: Settings > Events. Custom EventsConversion Events 탭이 모두 있는 경우 Conversion Events를 선택합니다.
  2. New Event를 클릭합니다.
  3. AdWords 드롭다운에서 AdWords에서 사용할 수 있는 메트릭 목록을 확인할 수 있습니다. 각 활동을 개별 Singular 이벤트에 매핑하거나 여러 메트릭을 하나의 이벤트로 결합할 수 있습니다.

    다음 날 Singular가 계정의 일일 데이터를 가져올 때 이러한 활동의 통계도 함께 가져옵니다.

  4. Singular가 새 전환 이벤트에 데이터를 채운 후, Reports 페이지에서 리포트를 실행할 때 Events 드롭다운에서 해당 전환 이벤트를 선택하세요.

FAQ 및 문제 해결

관리자 계정 ID(MCC ID)는 어떻게 찾나요?

고객 ID를 찾으려면(관리자 계정과 개별 계정 모두):

  1. 다음에 로그인합니다: Google Ads 계정.
  2. 오른쪽 상단의 도움말 아이콘을 클릭합니다.
  3. 메뉴 하단에서 Customer ID를 찾습니다.

자세한 내용은 Google 문서의 Google Ads 관리자 계정 정보를 참조하세요.

Google Ads 관리자 계정을 인증 할 수 없는 이유는 무엇인가요?

Google Ads 관리자 계정에서 다음으로 이동합니다: Settings > Network Settings. API access가 켜져 있는지 확인하세요. 그런 다음 Singular에서 Google Ads 관리자 계정을 다시 인증해 보세요.

google_auth.png

다른 분류 기준을 사용하는데도 리포트에 국가 데이터가 계속 표시되는 이유는 무엇인가요?

국가 정보를 제공하지 않는 분류 기준을 사용하는 경우에도 Singular는 Google의 캠페인 타겟팅 설정 및/또는 트래커 데이터 (보유한 경우)를 확인하여 국가 세분화를 제공하려고 시도합니다:

  1. 캠페인이 한 국가를 타겟팅하는 경우, 리포트에 해당 국가를 표시합니다.
  2. 여러 국가를 타겟팅하고 동일한 캠페인의 트래커 데이터도 보유한 경우, 트래커 데이터의 국가별 설치 비율을 기준으로 국가별 비용을 추정합니다. 다음을 참조하세요: 국가별 비용 메트릭은 어떻게 계산되나요?
Singular는 AdWords 캠페인의 Network Installs를 어떻게 가져오나요?

Google Ads는 “전환 액션”이라고 부르는 다양한 유형(앱 다운로드, 사용자 가입, 구매 등)을 트래킹합니다. 대부분의 고객이 앱 설치에 관심이 있으므로, 기본적으로 Singular는 download 유형의 전환을 가져와 리포트의 Network Installs 필드에 해당 메트릭을 표시합니다.

참고: Network Installs 는 광고 네트워크가 보고한 설치 수를 나타내는 Singular 메트릭이며, Installs와 혼동해서는 안 됩니다. 후자는 일반적으로 어트리뷰션 트래커의 데이터를 기반으로 합니다. AdWords의 경우 Network Installs는 AdWords가 보고한 "first_open" 전환 수입니다.

리포트 쿼리를 작성할 때 Network InstallsSource Metrics 섹션에서 선택할 수 있습니다. 자세한 내용은 Source Metrics란 무엇인가요?를 참조하세요.

Singular는 AdWords에서 크리에이티브를 가져오나요?

예, Singular는 크리에이티브 메트릭뿐 아니라 크리에이티브 자체(이미지, 텍스트, 동영상 등)도 가져옵니다. 이는 이전 버전의 AdWords 연동을 사용하든 새 버전을 사용하든 마찬가지입니다. 다만 UAC 캠페인의 크리에이티브는 새 연동에서만 표시됩니다.

AdWords 맥락에서 "creative" 란 무엇인가요? “creative”와 “asset”의 차이는 무엇인가요?

Singular의 Creative는 Google Ads의 Ad에 해당합니다.

Singular의 새로운 Asset 기준은 Google Ads의 Asset에 해당합니다. Google에서는 UAC(모바일 앱) 광고처럼 일부 광고 유형이 여러 에셋을 포함하기 때문에 이 새로운 세분화 수준을 추가했습니다. 에셋에 대해 보고되는 설치 수는 "biddable_app_install_conversions" 메트릭에서 가져오며, 이는 다음을 사용하는 다른 세분화 수준과 다릅니다: "metrics.conversions"

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 - deep linked ads) 포함 포함 포함
APP PRE REGISTRATION 포함 포함 포함

참고: Google의 광고 유형 이름(“App Engagement”, “Responsive Search” 등)은 Singular 리포트에 표시되지 않습니다. 리포트에 표시되는 Creative Type 기준은 이와 무관하며, 크리에이티브가 이미지인지 텍스트인지 동영상인지를 나타냅니다.

국가 분류를 가져오고 있습니다. 국가 정보가 없는 행이 표시되는 이유는 무엇인가요?

이는 동일한 캠페인에 대해 Google이 서로 다른 엔드포인트에서 제공하는 데이터 간에 차이가 있을 때발생할 수 있습니다.

Singular는 Google Ads API에서 데이터를 가져올 때 다음 단계를 수행합니다:

  1. 선택한 분류 기준의 데이터를 해당 Google Ads API 엔드포인트에서 가져옵니다. 이 경우에는 국가 정보를 제공하는 location_view 엔드포인트입니다.
  2. 전체 메트릭을 얻기 위해 동일한 캠페인의 데이터를 Google의 campaign 엔드포인트에서 가져옵니다.
  3. 각 캠페인의 메트릭을 비교하고 필요한 경우 데이터를 정렬하기 위해 행을 추가합니다. 예시는 아래 그림을 참조하세요. 캠페인 수준 데이터가 신뢰할 수 있는 기준으로 간주된다는 점에 유의하세요.

Screen_Shot_2019-12-01_at_19.29.13.png

크리에이티브 리포트에서 동영상을 볼 수 없는 이유는 무엇인가요?

Google의 개인정보 보호정책상 YouTube 동영상을 다운로드할 수 없습니다. 따라서 동영상 크리에이티브의 경우 동영상 썸네일과 YouTube 동영상 링크를 제공합니다.

video viewsvideo views - 25%, 50%, 75%의 차이는 무엇인가요? video viewsvideo views - completed보다 많거나 적을 수 있나요?

video views 메트릭은 시작된 동영상 조회 수를 집계합니다. 동영상이 끝까지 재생되었는지, 1초만 시청되었는지와 관계없이 동영상의 모든 노출을 집계합니다.

video views - 25%, 50%, and 75% 메트릭은 다음을 계산합니다: 해당 노출 중 동영상을 각각 25%, 50%, 75% 지점까지 시청한 사람의 수입니다. 마찬가지로, completed video views 메트릭은 다음만 계산합니다: 동영상이 끝까지 재생된 노출입니다. 이러한 값을 계산할 때는 Google이 제안한 공식을 사용합니다: impressions * video_view_rate.

필요에 따라 동영상 조회 수 메트릭 대신 백분율 메트릭 중 하나를 사용할 수도 있습니다. Google 문서의 "Video played to" 섹션을 참조하세요.

참고: YouTube 동영상의 조회 수와 Google Ads 계정에 표시되는 조회 수 사이에는 본질적인 차이가 있습니다. YouTube 조회 수와 Google Ads 계정 조회 수는 서로 다른 메트릭으로 계산됩니다.

  • YouTube는 동영상을 30초 이상 시청하거나 동영상이 끝날 때까지 시청한 경우(둘 중 먼저 도달한 시점)를 1회 조회로 집계합니다.
  • Google Ads는 YouTube 또는 파트너 사이트에 광고가 표시될 때 집계되는 광고 노출을 1회 조회로 집계합니다.
  • 그 결과 YouTube 애널리틱스에 보고된 조회 수와 Google Ads 계정에 표시되는 조회 수 사이에 차이가 발생할 수 있습니다.
  • 또한 YouTube 애널리틱스는 실시간으로 업데이트되지만, Google Ads 데이터는 업데이트에 최대 48시간이 걸릴 수 있습니다.

그 밖에도 YouTube 광고와 조회 메트릭은 기존 온라인 광고와 다르게 작동합니다. YouTube 광고를 게재할 때는 누군가 광고를 30초 이상 시청하거나 클릭 유도 오버레이 또는 컴패니언 배너를 클릭하는 등 어떤 방식으로든 상호작용한 경우에만 비용이 청구됩니다. 따라서 YouTube 광고의 효과를 판단할 때는 단순 조회 수보다 조회율(view-through rate)이나 획득 액션(earned actions) 같은 참여 메트릭에 집중하는 것이 중요합니다.

크리에이티브 리포트에서 Media Bundles을 볼 수 없는 이유는 무엇인가요?

Media Bundle은 "Image", "Text", "Video"와 함께 또 다른 크리에이티브 유형입니다. 광고 크리에이티브 중 미디어 번들이 있는 경우 해당 크리에이티브의 메트릭은 확인할 수 있지만, Google Ads API가 크리에이티브를 제공하지 않으므로 크리에이티브 자체는 볼 수 없습니다.

Creative Name 기준을 항상 사용할 수 없는 이유는 무엇인가요?

UAC 크리에이티브의 경우 Google은 이름을 제공하지 않고 ID만 제공합니다.