구글 광고(애드워즈) 데이터 커넥터

문서

빠른 세부 정보

데이터 커넥터 기술 API (구글 애즈 API v10)
데이터 분류(세분화)

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

  • 국가
  • 캠페인
  • 하위 캠페인 (광고 그룹)
  • 하위 광고 네트워크(광고 네트워크 유형).

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

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

데이터 매핑

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

  • 기본 구성은 국가입니다. 다른 구성을 선택하려면 Singular 지원팀에 문의하세요.
  • 메트로(DMA ) 구성은 미국 기반 광고에만 유용합니다(DMA 정보는 미국에서만 사용할 수 있음). 캠페인의 일부 또는 전부가 미국 이외의 지역에서 운영되는 경우, 대신 도시 구성을 사용하세요.
  • 키워드 제휴매체사 구성에는 구글 애즈 API 제한으로 인해 UAC 캠페인에 대한 데이터가 포함되지 않습니다.
  • 키워드제휴매체사 구성에는 국가 또는 기타 위치 기준이 포함되지 않지만, 타겟팅 국가 설정에 따라 Singular에서 국가를 제공할 수 있습니다.
  • 연령 또는 성별 분석은 별도의 인구통계학적 분석(예: 여성/남성, 20~29세 등)으로 사용할 수 있습니다.

용어에 대한 팁:

  • Singular의 크리에이티브는 구글 광고의 광고에 해당합니다.
  • Singular의 새로운 어셋 기준은 구글 애드워즈의 어셋에 해당합니다. Google에서는 UAC(모바일 앱) 광고와 같은 일부 유형의 광고에 여러 개의 에셋이 포함되어 있기 때문에 이 새로운 수준의 세분성을 추가했습니다.
  • Singular 보고의 모든 필드에 대한 설명은 Singular 지표 및 측정기준 용어집을 참조하세요.
  • Google에서 크리에이티브 보고서를 실행하는 방법에 대한 자세한 팁은 메타 및 Google 광고에서 크리에이티브 보고서를 실행하는 방법을참조하세요 .
국가 메트로(DMA) 도시 키워드 키워드+품질평가 점수 제휴매체사 쇼핑 동영상

Singular UI의 필드 Singular API의 필드 Google 국가 분류의 필드
기준
계정 ID adn_account_id customer.id
계정 이름 adn_account_name 고객.설명명
앱 사이트 ID app_site_id 캠페인.앱캠페인설정.앱아이디
에셋 ID asset_id asset.id
에셋 이름 asset_name asset.name(동영상 유형의 에셋의 경우 "asset.youtubeVideoAsset.youtubeVideoTitle" 사용)
캠페인 URL adn_campaign_url ad.finalUrl
사용할 수 없는 경우, ad.trackingUrlTemplate
국가 country_field geographicView.countryCriterionId
크리에이티브 형식 크리에이티브_포맷 ad.type
크리에이티브 ID creative_id 광고그룹광고.ad.id
크리에이티브 이름 creative_name 광고그룹광고.ad.이름
보고된 크리에이티브 URL 크리에이티브_보고된_URL adGroupAd.ad.finalUrls.0
날짜 date_field segments.date
최종 URL final_url campaign.finalUrls OR
광고그룹기준.최종유로 또는
adGroup.ad.finalUrls
네트워크 캠페인 ID adn_campaign_id campaign.id
네트워크 캠페인 이름 adn_campaign_name campaign.name
네트워크 크리에이티브 ID adn_creative_id 광고그룹광고.ad.id
네트워크 크리에이티브 이름 adn_creative_name adGroupAd.ad.name
네트워크 하위 캠페인 ID adn_sub_campaign_id adGroup.id
네트워크 하위 캠페인 이름 adn_sub_campaign_name 광고그룹.이름
OS os 캠페인.앱캠페인설정.앱스토어
플랫폼 플랫폼 campaign.appCampaignSetting.appStore와 segments.device의 조합
퍼블릭 ID 사이트_공개_ID 캠페인.앱캠페인설정.앱아이디
리타겟팅 리텐션 캠페인.광고채널서브유형 == 'APP_CAMPAIGN_FOR_ENGAGEMENT_'
하위 광고 네트워크 adn_subadnetwork 세그먼트.광고 네트워크 유형
타겟 국가 target_countries_str 국가 보기
텍스트 creative_text 이 필드를 만들기 위해 광고 유형에 따라 다를 수 있는 광고에서 사용 가능한 모든 텍스트 필드를 가져옵니다. 예를 들어, UAC의 경우 Google 광고의 필드는 asset.textAsset.text입니다. 텍스트가 두 개 이상인 경우(예: 헤드라인 + 설명), 이를 하나의 문자열로 연결합니다.
시간대 adn_timezone customer.timeZone
(Singular형은 클라이언트 시간대의 애드워즈에서 시간 데이터를 수신하여 UTC로 변환합니다.)
추적 URL tracking_url adGroupAd.ad.trackingUrlTemplate
자산 실적
asset_performance performance_label
Metrics
비용 adn_cost metrics.costMicro
네트워크 클릭 수 adn_clicks metrics.clicks
네트워크 노출 수 adn_impressions metrics.impressions
네트워크 설치 adn_installs metrics.conversions / metrics.allConversions
오리지널 비용 adn_original_cost metrics.costMicro
원래 통화 adn_original_currency customer.currencyCode
동영상 조회수 video_views metrics.videoViews
완료된 동영상 조회수 completed_video_views metrics.video_quartile_p100_rate
동영상 조회수 - 25% video_views_25pct metrics.video_quartile_p25_rate
동영상 조회수 - 50% video_views_50pct metrics.video_quartile_p50_rate
동영상 조회수 - 75% video_views_75pct metrics.video_quartile_p75_rate

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

특별 설정 지침

인증

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

애드워즈 데이터 커넥터를 설정할 때 Google 광고 계정을 사용하여 로그인하라는 메시지가 표시됩니다. Google 광고 관리자 계정(이전의 MCC 계정)으로 로그인하는 것을 적극 권장합니다.

Google 관리자 계정(MCC)을 사용하면 모든 광고 계정에 한 번에 액세스할 수 있습니다. 그런 다음 목록에서 Singular 보고서에 포함할 계정을 선택할 수 있습니다. 관리자 계정(MCC)을 사용하지 않는 경우 각 광고 계정에 대해 별도의 데이터 커넥터를 추가해야 합니다.

고객 ID(관리자 및 개별 계정 모두)를 찾으려면 다음과 같이 하세요:

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

전환 이벤트

위 표의 기본 지표 외에도 Singular는 Google 광고에서 필요한 모든 지표를 가져와서 Singular 보고서에 해당 통계를 표시할 수 있습니다.

에셋 수준에서 더 자세한 인사이트를 얻고 싶다면 '입찰 가능 앱-설치 후 전환'을 이벤트로 추가하는 것을 고려해 보세요. 이 데이터는 Google Ad의 API에서 가져옵니다. 이 기능을 사용하면 '인앱 액션' 이벤트에 대한 추가 데이터를 각 캠페인으로 가져올 수 있습니다. 전환 이벤트에는 코호트 데이터가 없으며 '실제' 코호트 기간과만 연결된다는 점에 유의해야 합니다."

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

  1. Singular에서 설정 > 이벤트로 이동합니다. 사용자 지정 이벤트전환 이벤트 탭이 모두 있는 경우 전환 이벤트를 선택합니다.
  2. 새 이벤트를 클릭합니다.
  3. 애드워즈 드롭다운에 애드워즈에서 사용할 수 있는 지표 목록이 표시됩니다. 각 활동을 별도의 Singular 이벤트에 매핑하거나 여러 지표를 Singular 이벤트로 결합할 수 있습니다.

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

  4. Singular가 새 전환 이벤트에 일부 데이터를 채운 후 보고서 페이지에서 보고서를 실행할 때 이벤트 드롭다운에서 전환 이벤트를 선택합니다.

FAQ 및 문제 해결

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

고객 ID(관리자 및 개인 계정 모두)를 찾으려면 다음과 같이 하세요:

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

자세한 내용은 Google 문서에서 Google 광고 관리자 계정에 대한 정보를 참조하세요.

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

Google 광고 관리자 계정에서 설정 > 네트워크 설정으로 이동합니다. API 액세스를 사용하도록 설정했는지 확인합니다. 그런 다음 Singular에서 구글 광고 관리자 계정 인증을 다시 시도합니다.

google_auth.png

다른 분류를 사용 중인데도 보고서에서 국가 데이터가 계속 표시되는 이유는 무엇인가요?

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

  1. 캠페인이 한 국가를 타겟팅하는 경우, 보고서에서 해당 국가를 표시합니다.
  2. 여러 국가를 타겟팅하고 동일한 캠페인에 대한 트래커 데이터도 있는 경우, 트래커 데이터의 국가별 설치 비율을 기준으로 국가별 비용을 추정합니다. 국가별 비용 지표는 어떻게 계산되나요?
Singular는 애드워즈 캠페인에 대한 네트워크 설치 수를 어떻게 가져옵니까?

Google 광고는 앱 다운로드, 사용자 가입, 구매 등 다양한 유형의 '전환 활동'을 추적합니다. 기본적으로 대부분의 고객이 앱 설치에 관심이 있기 때문에 다운로드 유형의 전환을 가져와 보고서의 네트워크 설치 필드에 해당 지표를 표시합니다.

참고: 네트워크 설치는 광고 네트워크에서 보고한 설치 수를 반영하는 Singular 지표로, 일반적으로 어트리뷰션 트래커의 데이터를 기반으로 하는 인스톨과 혼동하지 마세요. 애드워즈의 경우, 네트워크 설치는 애드워즈에서 보고한 '첫_오픈' 전환 수입니다.

보고서 쿼리를 작성할 때 소스 지표 섹션에서 네트워크 설치를 선택할 수 있습니다. 자세한 내용은 소스 지표란 무엇인가요? 를 참조하세요.

Singular는 애드워즈에서 크리에이티브를 가져오나요?

예. Singular는 광고 소재 자체(이미지, 텍스트, 동영상 등)뿐만 아니라 크리에이티브 지표를 가져옵니다. 이는 이전 버전의 애드워즈 연동을 사용하든 새 버전을 사용하든 마찬가지입니다. 단, 새 연동에서는 UAC 캠페인용 크리에이티브만 표시됩니다.

애드워즈 맥락에서 ' 광고 소재 ' 란 무엇인가요? '광고 소재'와 '자산'의 차이점은 무엇인가요?

Singular의 크리에이티브는 Google Ads의 광고에 해당합니다.

Singular의 새로운 애셋 기준은 구글 애즈의 애셋에 해당합니다. Google에서는 UAC(모바일 앱) 광고와 같은 일부 유형의 광고에 여러 애셋이 포함되어 있기 때문에 이 새로운 수준의 세분성을 추가했습니다. 에셋에 대해 보고된 인스톨은 "biddable_app_install_conversions" 지표에서 가져온 것으로,"metrics.conversions"를 사용하는 다른 세분성과는 다릅니다.

Singular는 어떤 Google 광고 유형을 지원하나요?

Singular는 다음과 같은 구글 광고 유형을 지원합니다:

광고 유형 포함된 광고 자산
텍스트 이미지 동영상
Gmail
호텔
Local
텍스트
확장 텍스트
확장된 동적 검색
쇼핑 제품
스마트 쇼핑
통화 전용
HTML5 업로드
동적 HTML5
반응형 검색
레거시 반응형 검색
레거시 앱 설치
반응형 디스플레이
비디오
비디오 범퍼
스트림에서 건너뛸 수 없는 동영상
비디오 아웃스트림
비디오 트루뷰 디스커버리
스트림 내 비디오 트루뷰
비디오 반응형
(UAC)
앱 인게이지먼트 (UAC - 딥링크 광고)
앱 사전 등록

참고: 광고 유형('앱 인게이지먼트', '반응형 검색' 등)에 대한 Google의 이름은 Singular 리포트에 표시되지 않습니다. 보고서에 표시되는 광고 소재 유형 기준은 광고 소재가 이미지, 텍스트 또는 동영상인지 여부를 보여줍니다.

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

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

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

  1. 해당 Google 광고 API 엔드포인트(이 경우 국가 정보를 제공하는 location_view 엔드포인트)에서 선택한 분류의 데이터를 가져옵니다.
  2. Google의 캠페인 엔드포인트에서 동일한 캠페인에 대한 데이터를 가져와 전체 지표를 가져옵니다.
  3. 각 캠페인의 지표를 비교하고 필요한 경우 행을 추가하여 데이터를 정렬합니다. 예시는 아래 그림을 참조하세요. 캠페인 수준 데이터는 신뢰할 수 있는 출처로 간주됩니다.

Screen_Shot_2019-12-01_at_19.29.13.png

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

Google의 개인정보 처리방침에 따라 YouTube 동영상을 다운로드할 수 없습니다. 따라서 동영상 크리에이티브의 경우 동영상 썸네일과 YouTube 동영상 링크가 포함됩니다.

동영상 조회수와 25%, 50%, 75%의 차이는 무엇인가요? 동영상 조회수가 완료된 동영상 조회수보다 높거나 낮을 수 있나요?

동영상 조회수 측정지표는 동영상 조회수가 시작된 횟수를 계산한 것입니다. 동영상 전체를 보았는지 또는 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 크리에이티브의 경우 Google은 이름 대신 ID만 제공합니다.