Google Ads API의 계정 유형

이 문서에서는 Google Ads API에서 계정을 설명하는 데 사용되는 다양한 용어와 이러한 용어가 서로 어떻게 관련되어 있는지 설명합니다.

개요

Google Ads API는 여러 용어를 사용하여 계정을 설명하므로 때로는 혼동을 일으킬 수 있습니다. 이러한 차이점을 이해하는 것은 계정을 관리하고 API 응답을 해석하는 데 중요합니다.

계정 유형

다음 정의는 Google Ads API를 사용할 때 접하게 되는 다양한 계정 유형을 명확히 설명합니다.

관리자 계정

관리자 계정은 여러 Google Ads 계정을 관리하는 데 사용되는 기본 계정입니다.

  • 이전 이름: 이전에는 'MCC' (내 고객센터)라고 했습니다. 이 용어는 기존 문서나 토론에서 계속 표시될 수 있습니다.
  • 목적: 단일 계층 구조를 통해 여러 계정을 연결하고 관리하려는 경우 관리자 계정을 사용합니다.
  • API 표현: Customer 리소스로 식별됩니다. 여기서 customer.manager는 true입니다.

광고주 (광고 게재) 계정

광고주 계정 (또는 광고 게재 계정)은 광고 캠페인을 운영하는 개별 Google Ads 계정입니다.

  • 목적: 캠페인, 광고 그룹, 애셋 그룹, 광고가 생성되고 게재되는 곳입니다.
  • API 표현: Customer 리소스로 식별됩니다. 여기서 customer.manager는 false입니다.

고객 계정

고객 계정은 계층 구조 내에서 상위 관리자 계정에 연결되고 관리되는 모든 계정 (광고주 계정 또는 다른 관리자 계정)입니다.

  • 컨텍스트: '고객'이라는 용어는 계층 구조(관리자가 관리함)에서의 관계를 나타내며, 비즈니스적 의미의 '고객'을 의미하지는 않습니다.
  • API 표현: CustomerClient를 쿼리하여 관리자의 계층 구조에 있는 계정을 검사하고 CustomerClientLink를 사용하여 관리자 계정과 고객 계정 간의 연결을 관리합니다.

고객

API 컨텍스트에서 고객은 관리자 계정이든 광고주 계정이든 모든 Google Ads 계정을 나타내는 리소스입니다.

  • 표현: 모든 계정은 Customer 리소스로 표현되며 customer_id로 식별됩니다.
  • 역할: 계정의 성격 (관리자 또는 서빙)은 특정 리소스에 따라 다릅니다.

테스트 계정

테스트 계정은 API 통합을 테스트하기 위해 전용 테스트 관리자 계정으로 구성된 특수한 광고주 계정입니다. 테스트 관리자 계정과 그 아래의 테스트 광고주 계정 모두 customer.test_account 필드가 true로 설정되어 있습니다. 프로덕션 관리자 계정에서는 테스트 계정을 만들 수 없습니다.

  • 목적: 테스트 계정을 사용하면 실제 광고를 게재하거나 비용을 발생시키지 않고 API 호출을 테스트할 수 있습니다. 라이브 광고를 게재하지 않습니다.
  • API 표현: Customer 리소스로 식별됩니다. 여기서 customer.test_account는 true입니다(customer.manager는 테스트 관리자 계정과 테스트 광고주 계정을 구분함).

계층 구조 예시

일반적인 계층 구조는 다음과 같습니다.

  • 관리자 계정 A (최상위 수준)
    • 고객 계정 B (광고주 계정)
    • 고객 계정 C (다른 관리자 계정)
      • 고객 계정 D (광고주 계정)

예를 들면 다음과 같습니다.

  • 계정 A는 관리자 계정입니다.
  • 계정 B, C, D는 상위 계정에 대한 고객 계정입니다.
  • 계정 B와 D는 광고주 (게재) 계정입니다.
  • 계정 C는 고객 계정 (A의 고객 계정)이자 관리자 계정 (D의 관리자 계정)입니다.