테스트 계정을 사용하면 프로덕션 환경에서 변경사항을 구현하기 전에 새 API 구현 또는 계정 구성을 사용해 볼 수 있습니다.
프로덕션 계정은 결제가 필요하고 사용자에게 렌더링되는 광고를 게재하는 반면, 테스트 계정은 활성 결제가 없고 사용자에게 광고를 렌더링하지 않으므로 Google Ads UI에 해지된 계정으로 표시됩니다.
테스트 계정과 프로덕션 계정은 어떤 방식으로도 상호작용할 수 없으므로 기존 프로덕션 관리자 계정에서 테스트 계정을 사용할 수 없습니다. 테스트 계정을 사용하려면 테스트 관리자 계정을 루트로 하는 새 계정 계층 구조가 필요합니다.
테스트 계정이 필요한가요?
별도의 테스트 계정 계층 구조를 만들기 전에 사용 사례에 가장 적합한 테스트 옵션을 확인하세요.
- 첫 번째 API 호출을 하거나 실제 계정을 대상으로 테스트하는 경우(하루 최대 2,880회 작업): 탐색기 액세스에서 제한된 기능(예: 계정 생성, 사용자 관리, 키워드 플래너, 결제)을 테스트하지 않는 한 테스트 계정이 필요하지 않습니다. Google Cloud 콘솔의 Google Ads API 개요 페이지에서 자동 탐색기 액세스 수준을 신청하여 프로덕션 계정을 직접 쿼리하고 관리합니다.
- 데이터를 변경하지 않고 요청 문법 및 정책 준수 검증:
GoogleAdsService.Search또는 mutate 요청에서validate_only필드를 설정합니다(프로덕션 계정을 타겟팅할 때는 최소한 탐색 도구 액세스 권한이 필요함). - 테스트 액세스 프로젝트로 개발하거나 무료 샌드박스에서 전체 캠페인 생성 테스트: 이 페이지의 단계에 따라 테스트 관리자 계정과 테스트 고객 계정을 만듭니다.
테스트 계정을 사용하는 이유
테스트 계정은 게재 중인 광고에 영향을 미치지 않으며 계정에 비용을 청구하지 않습니다. 활성 개발 중에 다음과 같은 이점을 제공합니다.
- 프로덕션 계정과 마찬가지로 계층 구조로 설정하고 구성할 수 있습니다.
- 프로덕션 계정과 마찬가지로 Google Ads UI에서 보고 조작할 수 있습니다.
- Google Cloud 프로젝트에 프로덕션 API 액세스 승인이 필요하지 않으므로 프로젝트에 테스트 액세스 수준이 있는 동안 즉시 API를 실험할 수 있습니다. 테스트 액세스 권한이 있는 Google Cloud 프로젝트가 프로덕션 계정을 호출하려고 하면 API는
v25부터AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION를 반환하거나v24이전에는AuthorizationError.ACTION_NOT_PERMITTED를 반환합니다. - 광고를 게재하거나 어떤 방식으로든 프로덕션 계정과 상호작용할 수 없습니다. 이렇게 하면 광고 게재 계정에 영향을 주지 않고 코드 또는 구성 변경사항을 테스트할 수 있는 안전한 환경이 제공됩니다.
- 프로덕션 계정과 동일한 제한사항(비율 제한 포함)이 적용됩니다.
테스트 계정에는 예산이 없으므로 관리자 계정에서 테스트 하위 계정을 만들 때 오류가 표시될 수 있습니다. 이 오류는 무시해도 됩니다.
테스트 계정 및 캠페인 만들기
다음 안내에 따라 테스트 관리자 계정, 테스트 고객 계정, 테스트 고객 계정을 채우기 위한 몇 가지 캠페인을 만듭니다. 이러한 계정 유형에 대한 자세한 설명은 계정 유형을 참조하세요.
테스트 관리자 계정 만들기를 클릭하여 Google Ads 계정 선택 페이지를 엽니다. 메시지가 표시되면 프로덕션 Google Ads 관리자 계정에 연결되지 않은 Google 계정으로 로그인하거나 로그인 메시지에서 Google 계정을 만듭니다.
계정 선택 페이지에서 새 Google Ads 계정을 클릭합니다(또는 계정 설정 완료 대화상자가 표시되면 새 계정 만들기를 클릭). 계정 선택 페이지에는 테스트 표시기가 표시되지 않지만 테스트 관리자 계정 만들기에서 열면 테스트 관리자 계정을 만들도록 가입 과정이 구성됩니다.
비즈니스 정보 확인 페이지에서 계정 표시 이름을 입력하고 계정의 기본 용도 옵션을 선택한 후 국가, 시간대, 통화를 선택합니다. 오른쪽 상단에 있는 빨간색 테스트 계정 라벨을 확인하고 제출을 클릭한 다음 계정 살펴보기를 클릭하여 테스트 관리자 계정 대시보드를 엽니다.
테스트 관리자 계정에서 테스트 고객 계정을 만듭니다. 계정 > > 새 계정 만들기를 클릭합니다. 계정 이름을 입력하고 국가, 시간대, 통화를 선택한 후 계정을 저장합니다. 테스트 관리자 계정에서 만드는 모든 고객 계정은 자동으로 테스트 계정이 됩니다.
후속 보고서 쿼리가 샘플 데이터를 반환하도록 테스트 고객 계정에서 테스트 캠페인을 하나 이상 만듭니다.
API 구성에 사용할 Google Ads UI의 10자리 고객 ID(하이픈 제외)를 모두 기록합니다.
customer_id(대상 고객 계정): 테스트 캠페인을 만든 새 테스트 고객 계정의 10자리 고객 ID를 사용합니다(캠페인을 쿼리하거나 변경하는 API 호출은 관리자 계정이 아닌 고객 계정을 타겟팅해야 함).login-customer-id(관리자 계정): 테스트 관리자 계정에 연결된 Google 계정 또는 서비스 계정으로 인증하는 경우login-customer-id를 테스트 관리자 계정의 10자리 고객 ID로 설정합니다.
첫 번째 API 호출하기에 따라 클라이언트 라이브러리 또는 REST 사용자 인증 정보를 구성하고 새 테스트 고객 계정에 대해 테스트 쿼리를 실행합니다.
테스트 계정 보기
Google Ads UI의 테스트 관리자 계정에서 테스트 고객 계정을 보려면 해지된 계정을 표시하도록 선택하여 계정을 숨기기 해제합니다.
관리자 계정 설정 중 및 일부 Google Ads UI 보기에서 테스트 계정에는 빨간색 테스트 계정 라벨이 표시됩니다.
API를 통해 계정이 테스트 계정인지 확인하려면 GoogleAdsService.Search 또는 GoogleAdsService.SearchStream 메서드를 사용하여 customer.test_account 필드를 쿼리합니다.
SELECT customer.id, customer.test_account
FROM customer
LIMIT 1
테스트 관리자 계정 또는 테스트 고객 계정에 대해 이 쿼리를 실행할 수 있습니다. 테스트 관리자 계정을 통해 테스트 고객 계정을 쿼리할 때 login-customer-id 헤더에 관리자 계정 ID를 포함합니다. 테스트 관리자 및 테스트 고객 계정은 customer.test_account에 대해 true를 반환하는 반면 프로덕션 계정은 false를 반환합니다.
제한사항
테스트 계정을 사용할 때는 다음 제한사항에 유의하세요.
- 테스트 계정은 광고를 게재하거나 어떤 방식으로든 프로덕션 계정과 상호작용할 수 없으므로 노출수, 전환수, 비용 데이터와 같은 게재 측정항목이 비어 있습니다.
- 입찰 시뮬레이션, 전환 업로드, 결제 등 특정 기능은 테스트 계정에서 테스트할 수 없습니다. 테스트 계정은 서빙 데이터를 생성하지 않으므로 추천을 비롯한 다른 기능은 테스트 계정 내에서 기능이 제한됩니다.
- 테스트 관리자 계정 계층 구조에는 최대 50개의 테스트 계정이 포함될 수 있습니다. 테스트 계정이 더 필요한 경우 다른 테스트 관리자 계정을 만들 수 있습니다.
- 대량의 연속 요청을 생성하는 테스트 계정은 예고 없이 제한될 수 있습니다.
이러한 제한사항을 해결하는 방법에 관한 안내는 테스트 권장사항을 참고하세요.