[Beta]{class="badge informative"}
Google Ads
Google Ads은(는) Google의 온라인 광고 플랫폼으로 검색, YouTube, 지도 및 파트너 웹 사이트를 통해 잠재 고객에게 도달하도록 도와줍니다. 적합한 대상을 타기팅하고, 예산을 제어하고, 결과를 추적하여 인지도, 잠재 고객 및 판매를 촉진할 수 있습니다.
Google Ads 소스를 사용하여 Google Ads API에 대해 인증하고, 광고주 계정 또는 관리자 계정 계층을 연결하고, 다운스트림 분석 및 활성화 워크플로를 위해 Experience Platform에 보고 데이터를 수집합니다.
사전 요구 사항
Google Ads 계정을 Experience Platform에 연결하기 전에 다음 요구 사항을 충족하는지 확인하십시오.
IP 주소
소스를 Experience Platform에 연결하기 전에 지역별 IP 주소를 허용 목록에 추가하다에 추가해야 합니다. 자세한 내용은 Experience Platform에 연결하기 위한 IP 주소 허용 목록에 추가에 대한 안내서를 참조하십시오.
Experience Platform에 대한 권한 구성
Google Ads 계정을 Experience Platform에 연결하려면 계정에 대해 소스 보기 및 소스 관리 권한이 모두 활성화되어야 합니다. 필요한 권한을 얻으려면 제품 관리자에게 문의하십시오. 자세한 내용은 액세스 제어 UI 안내서를 참조하십시오.
Google Ads 액세스 요구 사항
올바른 Google Ads API 자격 증명이 있어야 하며 읽을 Google Ads 계정에 액세스할 수 있어야 합니다. 대상 광고주 계정이 Google Ads관리자 계정(MCC)을 통해 관리되는 경우 올바른 관리자 계층 구조를 통해 요청을 라우팅할 수 있도록 연결에도 올바른 로그인 고객 ID가 포함되어야 합니다.
실제로:
- OAuth 인증 사용자가 대상 광고주 계정에 직접 액세스할 수 있는 경우
loginCustomerId이(가) 필요하지 않을 수 있습니다. - 광고주 계정이 MCC 계층 구조를 통해서만 액세스할 수 있는 경우
loginCustomerId은(는) 해당 하위 계정에 액세스하는 데 사용되는 관리자 계정을 식별해야 합니다. - 관리되는 자식 계정을 쿼리할 때
loginCustomerId이(가) 잘못되거나 누락되면 권한 부여에 실패할 수 있습니다.
필요한 자격 증명 수집
Google Ads을(를) Experience Platform에 연결하려면 다음 연결 속성에 대한 값을 제공해야 합니다.
clientCustomerId123-456-7890 형식을 따릅니다.loginCustomerIddeveloperTokenrefreshTokenclientIdclientSecretgoogleAdsApiVersionv19 이상을 지원합니다.connectionSpec.idd771e9c1-4f26-40dc-8617-ce58c4b53702.loginCustomerId
loginCustomerId 값은 Google Ads 원본에서 가장 중요한 구성 필드 중 하나입니다.
다음과 같은 경우 loginCustomerId을(를) 사용합니다.
- OAuth 인증 사용자는 관리자 계정을 통해 액세스할 수 있습니다.
- 타겟 광고주 계정이 MCC 아래의 하위 계정입니다.
- 계정은 최상위 액세스 가능한 계정으로 직접 반환되지 않습니다.
직접 액세스할 수 있는 광고주 계정에 대해 불필요하게 loginCustomerId을(를) 설정하지 마십시오. 가능하면 먼저 계정에 직접 액세스할 수 있는지 확인하고, 액세스가 해당 계층에 따라 달라지는 경우에만 관리자 ID를 제공하십시오.
인증 및 연결 동작
Google Ads 원본은 OAuth 2.0을 사용하여 Google Ads API에 대한 요청을 인증합니다. Experience Platform은 기본 연결에 연결 세부 정보를 저장하고 제공된 자격 증명을 사용하여 고객을 대신하여 Google Ads API 호출을 승인합니다.
관리자 계정 시나리오의 경우 커넥터가 대상 광고주 계정에 성공적으로 액세스하기 위해 적절한 관리자 계층을 해결해야 할 수 있습니다. 내부적으로 일반적으로 다음과 같은 작업을 수행합니다.
- 액세스 가능한 계정 열거,
- 계정이 관리자 계정인지 확인하는 중,
- 관리자가 아닌 리프 계정 식별,
- MCC 계층 구조를 통해서만 대상 계정에 연결할 수 있을 때 올바른 loginCustomerId 해결.
이 동작은 단일 관리자 계정 구조에서 여러 광고주 계정을 관리하는 고객에게 특히 중요합니다.
데이터 선택 및 보고 동작
Google Ads 데이터 선택은 Google Ads쿼리 언어(GAQL)를 기반으로 합니다. 설정 중에 수집을 위해 검색해야 하는 속성, 세그먼트 및 지표를 지정합니다.
대용량 보고서 가져오기의 경우 Google Ads에서 표준 검색 패턴과 스트리밍 검색 패턴을 모두 지원합니다. 내부적으로 스트리밍 검색은 페이지별로 버퍼링된 페이지가 아니라 보고서 행을 점진적으로 소비할 수 있으므로 더 큰 결과 세트에 선호됩니다.
Experience Platform UI에서 데이터 선택을 구성할 때 Google Ads쿼리 빌더를 사용하여 수집할 리소스 유형과 필드를 선택하고 쿼리의 유효성을 확인한 다음 필수 특성을 소스 워크플로우에 복사합니다.
지원되는 연결 경로
API 또는 사용자 인터페이스를 사용하여 Google Ads을(를) Experience Platform에 연결할 수 있습니다.
API 사용
프로그래밍 방식 설정, 반복 가능한 구성 또는 증분 수집 지원이 필요한 경우 API를 사용합니다. Flow Service 높은 수준에서 API 워크플로는 다음을 포함합니다.
- 기본 연결 만들기,
- 소스 구성 살펴보기,
- 소스 및 타겟 연결 만들기,
- 수집을 위한 데이터 흐름 만들기
UI 사용
UI를 통해 Google Ads에 연결하려는 경우 가이드 설정에 Experience Platform 소스 작업 영역을 사용하십시오. UI 흐름은 자격 증명 입력, 속성 선택, 미리 보기 및 데이터 흐름 생성을 지원합니다. 현재 UI 경로는 베타 상태로 유지되며 일회성 수집만 지원합니다.
알려진 제한 사항 및 참고 사항
- UI의 Google Ads 소스는 현재 베타입니다.
- UI는 현재 일회성 수집만 지원합니다.
- 증분 수집에는 API 기반 경로를 사용합니다.
- Experience Platform은 현재 Google Ads API 버전
v19이상을 지원합니다. - 관리자 계정 계층에서는
loginCustomerId을(를) 신중하게 처리해야 합니다. 값이 잘못되면 하위 광고주 계정에 액세스하지 못할 수 있습니다.
다음 단계
자격 증명을 수집하고 계정 액세스 패턴을 확인한 후 다음 설정 경로 중 하나를 사용하여 계속합니다.