✅ 1. 개요 (Overview)
- Google Ads API는 Google 광고 캠페인, 광고 그룹, 키워드, 보고서 등의 데이터를 프로그래밍 방식으로 조회·관리할 수 있도록 제공하는 API입니다.
- 매치스플랜에서는 Google Ads API를 통해 광고 데이터를 주기적으로 수집하고, 효율을 분석하여 자동화된 광고 운영 기능을 구축하고자 합니다.
- API 호출은 사용자 로그인을 필요로 하지 않고, 서버-서버 방식(NestJS 백엔드) 으로 정기적으로 수행됩니다.
✅ 2. 아키텍처 개요
- NestJS 기반 백엔드가 스케줄러에 따라 Google Ads API를 주기적으로 호출
- 가져온 데이터를 가공 및 분석한 후 프론트엔드에 전달
- 향후에는 광고 효율 분석 결과를 기반으로 광고 상태(ON/OFF)를 자동 조절하는 기능까지 확장 예정
- 인증은 사용자 로그인을 요구하지 않는 서비스 계정 방식을 사용
📌 아키텍처 다이어그램이 있으면 여기에 첨부하세요.
✅ 3. Google Cloud 프로젝트 구성
- 매치스플랜에서는 하나의 Google Cloud 프로젝트 안에서 광고 관련 서비스를 통합 관리합니다.
- GCP 프로젝트는 API 키, 인증, 결제, IAM 권한 등의 단위를 나누는 기준입니다.
- 서비스 간 권한 분리, 결제 계정 분리, 팀별 관리가 필요하지 않다면 하나의 프로젝트로 통합 관리하는 것이 일반적입니다.
- 향후 요구 사항이 복잡해지면 별도의 프로젝트로 분리하는 것도 고려할 수 있습니다.
✅ 4. Google Ads API 사용 설정