설명서Experience Platform소스 커넥터 안내서

Google Ads​(V2)

마지막 업데이트: 2026년 10월 2일

작성 대상:

  • Developer
IMPORTANT
Google Ads 원본은 Customer Journey Analytics SKU의 일부로 사용할 수 있습니다.

Google Ads​(V2)은(는) 광고 계정, 캠페인, 광고 그룹, 광고, 에셋, 경험 및 성과 데이터를 Google Ads API에서 Experience Platform으로 수집하는 Adobe Experience Platform 유료 미디어 소스 커넥터입니다.

커넥터는 Google Ads 데이터를 표준화된 유료 미디어 XDM(Experience Data Model) 구조에 매핑하므로 다른 광고 네트워크, 웹 속성, 상거래 시스템 및 고객 응용 프로그램의 데이터와 함께 Google Ads 데이터를 분석할 수 있습니다.

Google Ads​(V2)은(는) 읽기 전용 액세스를 사용하여 보고 데이터 및 광고 메타데이터를 검색합니다. Google Ads 리소스를 만들거나 수정하거나 삭제하지 않습니다.

사용 사례 예시

사용 사례
목표
Google Ads​(V2)이(가) 도움이 되는 방법
크로스 채널 광고 분석
Google Ads 성능을 Meta Ads 및 다른 유료 미디어 채널과 비교합니다.
각 엔터티 수준에서 표준화된 식별자를 사용하여 Google Ads 데이터를 일반 유료 미디어 XDM 구조로 수집합니다.
미디어 믹스 모델링 및 속성
비즈니스 결과에 대한 유료 미디어의 기여도를 평가합니다.
다운스트림 분석을 위해 노출 횟수, 클릭 수, 지출, 전환 및 전환 값을 포함한 캠페인 및 광고 성능 데이터를 제공합니다.
캠페인 및 예산 최적화
어떤 캠페인, 입찰 전략 및 타기팅 구성이 가장 좋은 결과를 산출하는지 이해합니다.
캠페인 메타데이터, 예산, 입찰 전략, 채널 유형, 상태, 날짜 및 선택한 타겟팅 기준을 수집합니다.
Creative 및 에셋 성능
성과가 가장 좋은 크리에이티브 자산, 광고 형식 및 경험을 식별합니다.
자산 연결, 유형 및 성능 레이블을 포함한 광고 수준 크리에이티브 메타데이터를 수집합니다.
성능 최대 분석
성과 최대 자산 그룹 및 관련 자산을 분석합니다.
성과 최대 자산 그룹 데이터를 사용하여 Google Ads이(가) 기존 광고 수준 구조를 표시하지 않는 자산 그룹 성과 및 경험 관계를 나타냅니다.
고객 여정 분석
광고 참여를 웹, 상거래, CRM 및 기타 고객 이벤트와 연결합니다.
Google Ads개의 데이터를 다운스트림 분석 및 활성화 워크플로에서 사용할 수 있도록 합니다.

사전 요구 사항

Google Ads​(V2)을(를) Experience Platform에 연결하기 전에 다음 항목이 있는지 확인하십시오.

Experience Platform에 대한 권한 구성

Experience Platform 계정에 대해 소스 보기 및 소스 관리 권한을 모두 활성화해야 합니다.

필요한 권한이 없는 경우 제품 관리자에게 문의하십시오. 자세한 내용은 액세스 제어 UI 안내서를 참조하십시오.

Experience Platform은 Google Ads​(V2)에 대한 OAuth 2.0 권한 부여 흐름을 관리합니다. Google Cloud 프로젝트, OAuth 클라이언트 또는 새로 고침 토큰은 만들지 않습니다.

다음을 보유해야 합니다.

  • 올바른 Google Ads 개발자 토큰입니다.
  • 수집하려는 Google Ads 광고주 계정에 대한 액세스 권한.
  • Google Ads 또는 Google Ads 관리자 계정을 통해 관련 광고주 계정에 액세스할 수 있는 권한입니다.

관리자-계정 액세스

광고주 계정이 Google Ads 관리자 계정을 통해 액세스되는 경우 적절한 관리자 고객 ID도 loginCustomerId(으)로 제공하십시오.

OAuth 인증 사용자가 대상 광고주 계정에 직접 액세스할 수 있고 관리자 계층 구조가 필요하지 않은 경우에는 loginCustomerId이(가) 필요하지 않습니다.

Google Ads​(V2)은(는) 액세스 가능한 계정을 열거하고, 관리자 계정을 식별하고, 관리자-계정 계층 구조를 통과하고, 수집에 사용할 수 있는 광고주 계정을 확인합니다.

필요한 자격 증명 수집

Google Ads​(V2)을(를) Experience Platform에 연결하려면 다음 값을 입력하십시오.

자격 증명
설명
developerToken
API 요청 인증에 사용되는 Google Ads 개발자 토큰입니다.
loginCustomerId
광고주 계정에 액세스하는 데 사용되는 관리자 계정의 숫자 고객 ID입니다. 관리자-계정 액세스에 이 자격 증명이 필요합니다.

인증 및 계정 검색

Google Ads​(V2)은(는) OAuth 2.0을 사용하여 Google Ads API에 대한 액세스를 승인합니다. Experience Platform은 인증 흐름을 관리하므로 Google Ads측에서 OAuth 범위 또는 권한을 구성하지 않습니다.

계정을 인증하면 Experience Platform에서 개발자 토큰을 사용하여 Google Ads 보고 리소스에 액세스합니다. 관리자 계정 구성의 경우 커넥터가 계정 계층 구조를 확인하고 수집에 사용할 수 있는 광고주 계정을 식별합니다.

계정 검색 워크플로에는 다음 작업이 포함됩니다.

  1. 승인된 사용자가 액세스할 수 있는 계정을 열거합니다.
  2. 액세스 가능한 계정이 관리자 계정인지 확인합니다.
  3. 관리자-계정 계층 구조를 트래버스합니다.
  4. 관리자가 아닌 광고주 계정을 식별합니다.
  5. 요청이 관리자 계정 계층 구조를 통해 라우팅되면 적절한 loginCustomerId을(를) 사용합니다.
  6. 계정 ID, 계정 이름, 통화 및 시간대 등 계정 메타데이터를 검색합니다.

Google Ads​(V2)이(가) 읽기 전용 API 작업을 수행합니다. Google Ads 리소스에 대해 변경, 만들기, 업데이트 또는 삭제 요청을 실행하지 않습니다.

데이터 선택 및 수집

Google Ads​(V2)은 Google Ads 쿼리 언어(GAQL)를 사용하여 계정 메타데이터, 캠페인 메타데이터 및 보고 데이터를 검색합니다.

커넥터는 리소스별 쿼리를 사용하여 각 엔티티에 필요한 속성, 세그먼트 및 지표를 검색합니다. 커넥터는 증분 행 처리가 유용한 보고 리소스 및 큰 결과 집합에 SearchStream을(를) 사용합니다.

지원되는 쿼리 인벤토리는 다음과 같은 리소스를 포함합니다.

  • customer
  • customer_client
  • campaign
  • campaign_budget
  • campaign_criterion
  • geo_target_constant
  • ad_group
  • ad_group_criterion
  • ad_group_ad
  • ad_group_ad_asset_view
  • ad_group_ad_asset_combination_view
  • asset
  • asset_group
  • asset_group_asset
  • change_status

성능 지표는 segments.date과(와) 같은 날짜 기반 세그먼트를 사용하여 검색합니다.

스키마 구성

Google Ads​(V2)은(는) 소스 데이터를 표준화된 유료 미디어 XDM 구조에 매핑합니다. 커넥터는 메타데이터 및 성능 지표를 계정, 캠페인, 광고 그룹, 광고, 에셋 및 경험 레코드 전반에 연결할 수 있도록 데이터를 엔티티 수준별로 구성합니다.

엔티티
기본 Google Ads 리소스
표시된 데이터
계정
customer, customer_client
계정 ID, 계정 이름, 통화, 시간대, 관리자 상태 및 계정 메타데이터.
캠페인
campaign, campaign_budget, campaign_criterion
캠페인 이름, 상태, 광고 채널, 하위 유형, 목표, 예산, 입찰 전략, 날짜, URL 추적 및 타겟팅 구성.
광고 그룹
ad_group, ad_group_criterion
광고 그룹 ID, 이름, 상태, 입찰, 타겟팅, 키워드, 배치 및 캠페인 관계.
광고
ad_group_ad
광고 ID, 광고 유형, 광고 콘텐츠, 대상 URL, 게재 상태, 정책 및 검토 정보, 캠페인/광고 그룹 관계.
자산
asset, ad_group_ad_asset_view, asset_group_asset
에셋 ID, 에셋 유형, 텍스트, 이미지 또는 비디오 메타데이터, 차원, 사용, 성능 레이블 및 관련 광고 또는 캠페인.
경험
ad_group_ad_asset_combination_view, asset_group, asset_group_asset
파생된 크리에이티브 구성, 제공된 에셋, 헤드라인, 설명, 콜 투 액션, 랜딩 페이지 URL 및 경험 관계.
요약 지표
리소스별 metrics.* 필드 및 segments.date
날짜 수준 노출 횟수, 클릭 수, 지출, 전환, 전환 값, CTR, CPC, CPM, 비디오 지표 및 기타 지원되는 성능 측정 단위입니다.

식별자 규칙

V2 매핑은 유료 미디어 엔터티에 대해 플랫폼으로 정규화된 식별자를 정의합니다. 예:

  • 커넥터는 Google Ads 고객 ID에서 계정 식별자를 파생합니다.
  • 캠페인 식별자는 Google Ads 고객 ID와 캠페인 ID를 결합합니다.
  • 광고 그룹 및 광고 식별자에는 상위 계층이 포함됩니다.
  • 자산 식별자는 Google Ads 고객 ID와 자산 ID를 결합합니다.
  • 커넥터는 크리에이티브 조합 또는 에셋 그룹 컨텍스트에서 경험 식별자를 파생합니다.
  • 계층 경로는 계정, 캠페인, 광고 그룹, 광고, 경험 및 자산 엔티티 간의 관계를 나타냅니다.

성능 최대 데이터

성과 최대 캠페인이 기존 캠페인 유형과 동일한 엔티티 관계를 항상 표시하는 것은 아닙니다.

성능 최대 데이터의 경우:

  • asset_group은(는) 자산의 기본 그룹화를 나타냅니다.
  • asset_group_asset은(는) 자산 대 그룹 관계를 나타냅니다.
  • 자산 그룹 지표는 자산 성과를 분석하는 데 필요한 컨텍스트를 제공합니다.
  • 자산 그룹은 기본 경험 엔티티를 사용할 수 없는 경우 경험 프록시 역할을 합니다.

데이터 제한 사항 및 고려 사항

Google Ads​(V2) 구현을 계획할 때 다음 제한 사항을 고려하십시오.

리소스 특정 지표 지원

Google Ads은(는) 모든 리소스에 대한 모든 지표를 표시하지 않습니다. 예를 들어 일부 리소스는 지표 또는 세그먼트를 지원하지 않지만, 다른 리소스는 제한된 지표 세트만 지원합니다.

지표 가용성은 광고, 에셋, 경험, 캠페인 및 성능 최대 쿼리 사이에도 다릅니다.

파생된 경험 레코드

Google Ads은(는) 유료 미디어 XDM 스키마에서 사용하는 경험 모델에 해당하는 단일 유니버설 경험 엔터티를 제공하지 않습니다.

커넥터는 사용 가능한 광고, 에셋 조합 및 에셋 그룹 데이터에서 경험 기록을 파생합니다.

비디오 메타데이터

Google Ads API는 비디오 식별자 및 관련 자산 참조를 제공합니다. 그러나 비디오 지속 시간, 코덱, 비트율, 프레임 속도 및 오디오 상태 등의 일부 미디어 속성은 Google Ads API를 통해 직접 사용할 수 없습니다.

이 필드는 승인된 데이터 보강 서비스를 추가하지 않으면 null입니다.

자산 가용성

에셋 메타데이터 및 성능 지원은 에셋 유형에 따라 다릅니다. 예를 들어, 이미지 및 텍스트 메타데이터는 직접 사용할 수 있지만 일부 비디오 속성에는 추가 데이터 보강이 필요합니다.

Google 관련 필드

직접 유료 미디어 XDM에 해당하는 항목이 없는 Google Ads 개념은 승인된 매핑에 따라 additionalDetails을(를) 사용하여 표시되거나 null로 설정됩니다.

열거형 매핑

커넥터가 정확한 일치, 정확한 의미 일치 또는 승인된 대체 값을 사용하여 Google Ads API 열거형 값을 XDM 값에 매핑합니다. 지원되지 않거나, 알 수 없거나, 더 이상 사용되지 않거나, 지정되지 않은 값은 건너뛰거나 null로 설정합니다.

다음 단계

Google Ads 자격 증명 및 계정 액세스 모델을 확인한 후 연결을 만들어 Google Ads Experience Platform UI를 사용하여합니다.

recommendation-more-help
experience-platform-help-sources