Google Ads 스크립트는 브라우저 기반 IDE에서 최신 JavaScript(ES6 이상)를 사용하여 Google Ads 데이터를 프로그래매틱 방식으로 관리하고 쿼리할 수 있는 서버리스 자동화 플랫폼을 제공합니다. Google Ads 스크립트를 사용하면 서버를 프로비저닝하거나 개발자 사용자 인증 정보를 관리하지 않고도 하나의 계정 또는 수천 개의 계정에서 일상적인 계정 관리 워크플로를 자동화하고, 맞춤 보고서를 생성하고, Google Ads를 외부 데이터 소스와 통합할 수 있습니다.
Google Ads의 대부분의 기능은 mutate 및 search 호출을 통해 Google Ads 스크립트에서 사용할 수 있습니다. 스크립트를 사용하여 다음을 수행할 수 있습니다.
- 캠페인, 광고 그룹, 키워드, 광고를 관리합니다.
- 실시간 실적 또는 외부 데이터를 기반으로 입찰가, 예산, 상태를 조정합니다.
- Google Ads 쿼리 언어 (GAQL)을 사용하여 쿼리를 실행하여 맞춤 보고서와 대시보드를 생성합니다.
- 자동 실행이 매시간, 매일, 매주, 매월 또는 주문형으로 실행되도록 예약합니다.
- 관리자 스크립트를 사용하여 하위 계정에서 여러 계정 작업을 조정합니다.
- Google Workspace 서비스 (예: Sheets 및 Drive), Google Cloud 서비스 (예: BigQuery), 서드 파티 API에 연결합니다.
스크립트에는 기본 제공 항목 선택기 및 보고서도 포함되어 있습니다.
주요 기술 사양
다음 기술 사양은 Google Ads 스크립트의 실행 환경과 운영 경계를 정의합니다.
| 사양 | 단일 계정 스크립트 | 관리자 계정 스크립트 |
|---|---|---|
| 실행 시간 제한 | 최대 30분 |
executeInParallel 및 콜백을 사용하는 경우 최대 60분
(표준 30분)
|
| 런타임 엔진 | V8 JavaScript 런타임 (ECMAScript 6 이상) | V8 JavaScript 런타임 (ECMAScript 6 이상) |
| 항목 반복기 한도 | 반복기당 기본 항목 50,000개 (보고서 및 검색어는 제외) | 하위 계정당 항목 50,000개 (보고서 및 검색어는 제외) |
| 동시 계정 | 해당사항 없음 (계정 1개) | 최대 50개의 계정을 동시에 실행 |
| 일괄 업로드 한도 | 파일 크기 50MB, 행 1,000,000개 | 파일 크기 50MB, 행 1,000,000개 |
| 승인된 스크립트 | 사용자당 최대 250개의 승인된 스크립트 | 사용자당 최대 250개의 승인된 스크립트 |
| 호스팅 및 인프라 | Google 완전 관리형 (서버리스) | Google 완전 관리형 (서버리스) |
자세한 내용은 한도를 참조하세요.
Google Ads 스크립트가 나에게 적합한 제품인가요?
Google은 Google Ads 계정을 자동화하는 데 도움이 되는 여러 제품을 제공합니다. 다음 표에는 필요에 맞는 제품을 선택하는 데 도움이 되는 일반적인 시나리오와 권장사항이 나와 있습니다.
| 시나리오 | 권장사항 | 주요 특성 |
|---|---|---|
| 자체 소프트웨어 제품을 빌드하거나 Google Ads API와 통합하려는 개발자입니다. 코드를 작성하고 서버 및 데이터베이스를 비롯한 소프트웨어 인프라를 관리하는 데 익숙합니다. | Google Ads API를 사용합니다. | 전체 API 제어, 높은 처리량, 전용 호스팅, OAuth 관리 |
| 코드를 작성하는 데 익숙하지만 자체 소프트웨어 인프라를 관리하고 싶지 않은 개발자입니다. | Google Ads 스크립트를 사용합니다. | Google Ads 내 서버리스 실행, 자동 예약, 브라우저 기반 IDE |
| 개발자는 아니지만 Google Ads를 자동화하기 위해 프로그래밍을 배우는 데 시간을 투자할 의향이 있습니다. | Google Ads 스크립트를 사용합니다. | 간단한 JavaScript 구문, 사전 빌드된 스크립트 템플릿, IDE 자동 완성 및 구문 강조표시 |
| 동영상 캠페인을 프로그래매틱 방식으로 관리하고 싶습니다. | Google Ads 스크립트를 사용합니다. |
`
AdsApp.videoCampaigns()`를 사용하여 동영상 캠페인을 직접 관리합니다.
|
| 활성 사용자 세션이 없어도 실행되도록 작업을 예약하고 싶습니다. | Google Ads 스크립트를 사용합니다. | 자동으로 매시간, 매일, 매주 또는 매월 예약되는 OAuth2 백그라운드 승인 |
| 중첩된 Google Ads 계정에 프로그래매틱 방식으로 액세스하고 싶습니다. | 관리자 스크립트를 사용하여 단일 스크립트에서 게재 하위 계정에 액세스합니다. |
하위 계정 간 순차적 반복 또는
최대 50개의 하위 계정에서 executeInParallel을 사용하여 병렬 실행
|
| Google 소유 또는 서드 파티 API를 Google Ads 관리에 통합하고 싶습니다. | Google Ads 스크립트와 함께 Google API 또는 서드 파티 API를 사용합니다. |
기본 제공 Google Workspace 서비스 (Sheets, Drive, Mail), 고급 Google
API (BigQuery, 애널리틱스, YouTube), 외부 REST API용 UrlFetchApp
|
| Google Ads 보고서를 다운로드하여 추가 분석을 수행하려는 데이터 분석가 (또는 유사한 역할)입니다. | Google Ads용 BigQuery Data Transfer Service를 사용합니다. | 코드가 없는 BigQuery로의 Google Ads 광고 데이터용 예약된 자동 파이프라인 |
| Google Ads를 일괄적으로 관리하고 싶으며 코드를 작성해도 괜찮습니다. | Google Ads 스크립트와 함께 일괄 업로드를 사용합니다. | 최대 1,000,000 개의 행을 지원하는 프로그래매틱 CSV 또는 스프레드시트 업로드 |
| Google Ads를 일괄적으로 관리하고 싶지만 코드를 작성하고 싶지 않습니다. | 자동 규칙, 일괄 업로드, 또는 Google Ads 에디터를 사용합니다. | 일괄 업데이트 및 예약된 규칙을 위한 코드가 없는 데스크톱 또는 UI 도구 |
기본 요건
JavaScript에 대한 기본적인 지식만 있으면 됩니다. IDE는 구문 강조표시, 자동 완성, 미리보기를 지원합니다. 첫 번째 스크립트를 작성하려면 Google Ads 계정만 있으면 됩니다 .
자주 묻는 질문(FAQ)
Google Ads 스크립트 아키텍처, 실행 한도, 통합에 대해 자주 묻는 질문의 답변을 찾아보세요.
Google Ads 스크립트란 무엇인가요?
Google Ads 스크립트는 Google Ads 내에서 서버리스 자동화 환경을 제공합니다. 광고주와 개발자는 서버를 구성하거나, OAuth 토큰을 관리하거나, 인프라 비용을 지불하지 않고도 JavaScript 코드를 작성하여 실적 측정항목을 쿼리하고, 캠페인을 만들고 수정하고, 입찰가와 예산을 업데이트하고, 외부 API에 연결할 수 있습니다.
Google Ads 스크립트는 Google Ads API와 어떻게 다른가요?
Google Ads 스크립트는 JavaScript를 사용하여 Google Ads 계정에서 직접 실행되며, 서버 인프라가 필요하지 않고, 브라우저에서 승인을 자동으로 처리합니다. Google Ads API는 자체 서버에서 실행되고 전용 개발자 토큰과 OAuth 사용자 인증 정보가 필요한 대규모 엔터프라이즈 애플리케이션, 서드 파티 도구, 대용량 데이터 파이프라인을 위해 설계된 REST 및 gRPC API입니다.
Google Ads 스크립트를 실행하려면 서버가 필요한가요?
아니요. Google Ads 스크립트는 추가 비용 없이 Google의 클라우드 인프라에서 완전히 실행됩니다. Google Ads 웹 인터페이스에서 직접 스크립트를 작성하고, 미리보기 모드로 테스트하고, 예약할 수 있습니다.
Google Ads 스크립트의 실행 한도는 얼마인가요?
개별 계정의 표준 스크립트는 실행당 최대 30분 동안 실행할 수 있습니다. executeInParallel을 사용하는 관리자 계정 스크립트는 최대 50개의 하위 계정에서 최대 60분 동안 실행할 수 있습니다 (콜백 함수가 지정된 경우). 스크립트가 시간 초과로 종료되더라도 Google Ads는 취소 전에 적용된 변경사항을 계속 적용합니다. 시간 제한, 할당량, 일괄 업로드 한도에 관한 자세한 내용은 한도
를 참고하세요.
Google Ads 스크립트가 외부 API에 연결할 수 있나요?
예. Google Ads 스크립트에는 Google Sheets를 읽고 쓰는 SpreadsheetApp, 외부 REST API에 HTTP 요청을 보내는 UrlFetchApp, BigQuery 및 YouTube와 같은 서비스와 통합하기 위한 고급 Google API와 같은 기본 제공 서비스가 포함되어 있습니다. 자세한 내용은
서드 파티 API
및 고급 Google API를 참고하세요.
의견
Google Ads 스크립트에 관한 의견이 있으면 언제든지 알려주세요. Discord에서 문의해 주세요.