안녕하세요, 아이작입니다. 👋
이번엔 클로드 코드에 구글애즈 API를 연동해서 광고 운영을 보다 효율적으로 할 수 있는 방법을 소개합니다. *사실 계속 클로드코드 시리즈로 소개드리고 있지만, 코덱스나 사용하시는 다른 코딩 에이전트가 있다면 그걸 사용하셔도 무방합니다.
광고 운영하시는 분이라면 한 번쯤 이런 순간 있으셨을 거예요.
- 신규 클라이언트 받았는데 어디서부터 만져야 할지 막막한 날
- 신규 캠페인 세팅 (키워드 수십개, 광고 10개 이상, 사이트링크 4개를 콘솔에 한 줄씩 타이핑하는 시간.)
- 광고가 거절됐는데 정책관리자 들어가서 광고별 거부 사유 일일이 클릭해서 확인하는 답답함.
- 다음 클라이언트 받을 때 지난번 셋업을 처음부터 다시 해야 하는 비효율.
저도 매주 똑같이 겪고 있었어요. 그러다 이번엔 다르게 해보고 싶었습니다.
최근에 네이버SA 키워드 세팅을 구글애즈SA로 마이그레이션했어요. 일예산은 크지 않았지만, 세팅 자체가 손이 많이가는 작업이라 평소 같았으면 최소 3-4시간은 소요됐을 분량인데요. 구글애즈 API를 클로드코드에 연동 후, 키워드 파일과 랜딩 URL 두 개만 던지고, 캠페인 세팅 + 광고문구 세팅까지 훨씬 효율적으로 진행이 가능했습니다.
캠페인 세팅에 포함된 항목들:
(실제로 제가 세팅한 캠페인 세팅한 내역입니다)
| 항목 | 수량 |
|---|---|
| 캠페인 | 1개 |
| 광고그룹 | 10개 |
| 키워드 (Exact) | 83개 |
| 네거티브 키워드 | 29개 |
| RSA 광고 | 10개 (헤드 15·설명 4, DKI 2 포함) |
| 사이트링크 / 콜아웃 / Call Extension | 4 / 8 / 1 |
| 전환 액션 | 1개 (상담 폼) |
| 지역 / 언어 | 한국 · 한국어 |
이 많은 항목들을 API 연동을 하니, 생각보다 간단히 진행이 됐습니다. 제가 한건 많이 없었어요. 아래와 같은 명령어들을 클로드코드에 입력하고 결과를 받고, 검수하면서 진행을 했습니다.
이 사이트 보고 브랜드 캠페인 광고문구랑 사이트링크 만들어줘
정책에 맞게 광고 헤드라인, 문구 검수해줘
문제 없을 경우, 캠페인 활성화 해줘
구글 클라우드 콘솔에서 OAuth 클라리언트 ID 를 발급하기 위해 3분 정도 소요된것 말고는, 나머지는 전부 클로드코드가 했어요.
Google Ads API 로 다룰 수 있는 4가지
구글애즈 UI에서 사람이 할 수 있는 거의 모든 걸 코드로 할 수 있어요. 크게 네 영역입니다.
| 영역 | 무엇을 |
|---|---|
| ① 캠페인 셋업 | 예산·캠페인·광고그룹·키워드·RSA·사이트링크·콜아웃·전환·지역·언어 |
| ② 분석 | GAQL (구글애즈 쿼리어)로 노출·클릭·전환·검색어·정책 상태 한 줄 추출 |
| ③ 리포트 | 채널×캠페인 ROAS·CAC·신규 vs 재구매·시계열 - pandas 로 자동 차트화 |
| ④ 자동화 | 검색어 정리·입찰 조정·예산 재배분·소재 교체 - cron 으로 매일·매주 자동 |
클로드코드의 진짜 강점은 이 네 가지가 같은 세션에서 연결된다는 거예요.
- "어떤 광고가 정책에 걸렸지?" 물으면 → ② 분석으로 GAQL 던져서 답하고,
- 그 답 보고 "우회 표현으로 다시 써줘" 한 마디 → ① 셋업으로 RSA 재생성하고,
- 결과 누적해두면 → ③ 리포트로 매주 정리하고,
- "앞으로 매주 자동으로 검색어 정리해줘" → ④ 자동화 까지.
그런데 연동이 생각만큼 깔끔하지는 않았습니다
API 연동 - "- 해줘" 하면 끝일까요? 생각보다 빠르게 되지는 않았습니다. 아래 짧게 제가 겪은 시행착오와 해결한 방법을 정리했습니다.
| # | 시행착오 | 해법 |
|---|---|---|
| 1 | gcloud 로 OAuth Desktop Client 못 만듦 | 구글 클라우드 콘솔 UI 에서 직접 해결. |
| 2 | Customer ID 와 Login Customer ID 가 다름 (단독 vs MCC) | 401/403 가장 흔한 원인. .env 파일에 에 둘 다 명시 |
| 3 | enhanced_cpc_enabled 는 v24 에서 죽음 (공식 샘플엔 살아있음) | ManualCpc 객체만 할당. EU 정치광고 필드도 체크 필수. |
| 4 | '공유 예산' 기능이 자동활성. | 공유예산을 원치않을 경우, 세팅 시 프롬프트에 직접 명시. |
이것 말고도 아래 무료 가이드에 몇가지 더 추가로 정리해뒀습니다.
API 연동 가이드 정리했습니다
실제로 어떻게 셋업했는지, 어디서 막히고 어떻게 풀었는지를 가이드에 담아뒀습니다.
👉 구글애즈 API + 클로드 코드 연동 가이드 받기 →
앞으로 새로 배우는 것들, 계속 전해드릴게요
이번 편은 단순 시작에 불과합니다. 이제 연동을 했으니, 어떻게 다루고, 어떤 인사이트를 찾을 수 있을지에 대한 부분을 다뤄야겠죠.
앞으로 뉴스레터를 통해 구글애즈, GA4, 빅쿼리, 메타 등 퍼포먼스 마케팅과 데이터 분석 관련해서 딥한 인사이트 계속 나눌 예정입니다.
그럼 또 유익한 퍼포먼스 마케팅/콘텐츠 등 다양한 AI 이야기를 전해드릴게요. 감사합니다.
Let AI work, you think.
— 아이작
혹시 놓치신 분들을 위해: 뉴스레터를 통해 다양한 워크플로우, AI 스킬, 프롬프트 등 소개를 해드리고 있습니다.
의견을 남겨주세요