워크플로 소개
Google Ads API를 이용한 SEO 키워드 생성 워크플로우
**"검색량으로 새 키워드 생성"**이라는 제목의 이 n8n 워크플로우 템플릿은 디지털 마케터, SEO 전문가 및 성장 팀이 평균 월간 검색량, 경쟁 수준 및 입찰가 추정치와 같은 중요한 지표로 보강된 잠재력 높은 키워드를 Google Ads API에서 직접 발견할 수 있도록 설계된 강력한 자동화 도구입니다. SEO 조사 및 캠페인 계획의 모범 사례를 기반으로 구축된 이 워크플로우는 Google의 공식 광고 인프라를 활용하여 키워드 아이디어 구상을 간소화합니다.
워크플로우 기능
이 워크플로우는 시드 키워드 목록(예: "워크플로우 자동화 소프트웨어")을 가져와 이를 사용하여 Google의 키워드 아이디어 API (generateKeywordIdeas)를 통해 수백 개의 관련 키워드 제안을 생성합니다. 검색량, 경쟁 수준 및 클릭당 비용(CPC) 범위와 같은 풍부한 데이터를 검색한 다음 결과를 처리하고 저장하여 SEO 전략 구축, 콘텐츠 캘린더 최적화 또는 유료 광고 캠페인 활성화에 이상적입니다.
생성된 모든 키워드는 추출되어 깔끔한 필드로 재포맷되고 Google 스프레드시트에 자동으로 업서트되어 쉽게 액세스하고 보고할 수 있습니다.
주요 기능 및 역량
- ✅ 자동화된 키워드 조사: 입력 시드에 기반한 실시간 키워드 아이디어를 가져오기 위해 Google Ads의 공식 API를 활용합니다.
- ✅ 검색량 및 경쟁 데이터:
avgMonthlySearches,competition,competitionIndex및 CPC 추정치(lowTopOfPageBidMicros,highTopOfPageBidMicros)를 추출합니다. - ✅ 데이터 변환: JavaScript 표현식을 사용하여 마이크로 단위 입찰가(센트 단위)를 읽기 쉬운 달러 금액으로 변환합니다.
- ✅ 구조화된 출력: 복잡한 JSON 응답을
keyword,avgMonthlySearches등과 같은 평평하고 사용 가능한 필드로 매핑합니다. - ✅ Google 스프레드시트 통합: 처리된 키워드 데이터를 미리 정의된 Google 스프레드시트에 자동으로 추가하여 장기 추적을 용이하게 합니다.
- ✅ 확장 가능한 입력 처리: 한 번에 여러 시드 키워드를 수락하고 배치 로직을 통해 각 키워드를 처리합니다.
- ✅ 잘 문서화된 설정: 구성, 인증 및 문제 해결을 안내하는 자세한 스티키 노트를 포함합니다.
주요 노드 및 목적
| 노드 이름 | 유형 | 목적 |
|---|---|---|
| 트리거 | executeWorkflowTrigger |
워크플로우를 수동으로 시작합니다. 테스트 실행 또는 통합 트리거의 진입점으로 사용됩니다(웹훅으로 대체 가능). |
| 키워드 설정 | set |
입력 키워드 배열(트리거를 통해 전송됨)을 다운스트림 노드에서 액세스할 수 있는 구조화된 형식으로 추출합니다. |
| 새 키워드 생성 | httpRequest |
적절한 헤더와 페이로드를 사용하여 Google Ads generateKeywordIdeas 엔드포인트를 호출합니다. OAuth2를 통해 인증합니다. 시드 키워드 및 위치/언어 타겟팅 매개변수를 보냅니다. |
| 분할 | splitOut |
반환된 키워드 아이디어 배열(results)을 분할하여 각 제안이 개별적으로 처리되도록 합니다. |
| 필드 편집 | set |
원시 API 응답을 사용자 친화적인 필드로 재포맷합니다. 입찰 마이크로 → 달러로 변환하고, 텍스트, 경쟁 및 검색량을 추출합니다. |
| 업서트 | googleSheets |
정리된 키워드 데이터를 "SEO DOCTOR: Keyword Tool"이라는 Google 스프레드시트의 특정 탭에 추가합니다. 필드 정렬을 위해 자동 매핑을 사용합니다. |
| 스티키 노트 (5개) | stickyNote |
캔버스 내에 사용 지침, 설정 단계, 문제 해결 팁 및 데이터 흐름에 대한 컨텍스트를 제공하는 문서를 제공합니다. |
사용 사례 및 이점
이상적인 대상:
- 📈 SEO 전략가: 실제 검색 수요가 있는 미개척 롱테일 키워드를 발견합니다.
- 💬 콘텐츠 마케터: 데이터를 기반으로 주제 클러스터 및 블로그 개요를 구축합니다.
- 🔍 PPC 관리자: Google Ads 캠페인을 시작하기 전에 키워드 유효성을 평가합니다.
- 🛠️ 자동화 컨설턴트: 이 템플릿을 클라이언트 전반에 걸쳐 재사용하여 확장 가능한 키워드 분석을 수행합니다.
비즈니스 이점:
- ⏱️ 시간 절약: 수동 스크래핑 또는 정확도가 제한된 타사 도구 사용을 제거합니다.
- 💡 정확도 향상: 추정치가 아닌 Google 자체 데이터 소스를 사용합니다.
- 🧩 유연하고 확장 가능: 더 큰 워크플로우(예: CMS 게시, 순위 추적, 경쟁사 분석)에 통합할 수 있습니다.
- 🗃️ 중앙 집중식 보고: 모든 출력이 Google 스프레드시트에 저장되어 공유, 시각화 및 공동 작업이 용이합니다.
단계별 워크플로우 로직
-
워크플로우 시작
- 트리거 노드가 실행을 시작합니다. 예시에서는
"n8n workflow automation"및"hr process automation"과 같은 20개의 시드 키워드를 포함하는 테스트 데이터가 고정되어 있습니다.
- 트리거 노드가 실행을 시작합니다. 예시에서는
-
시드 키워드 추출
- 키워드 설정 노드는 들어오는
.query.Keyword배열을Keyword라는 필드로 매핑하여 HTTP 요청에서 사용할 수 있도록 합니다.
- 키워드 설정 노드는 들어오는
-
Google Ads API 호출
- 새 키워드 생성 노드는 다음으로 POST 요청을 보냅니다.
https://googleads.googleapis.com/v18/customers/{customer-id}:generateKeywordIdeas - 요청 본문에는 다음이 포함됩니다.
- 타겟 국가:
geoTargetConstants/2840(미국) - 언어:
languageConstants/1000(영어) - 네트워크:
GOOGLE_SEARCH - 이전 단계의 시드 키워드
- 타겟 국가:
- 인증은 저장된 OAuth2 자격 증명 및 필수 헤더를 사용합니다.
developer-tokenlogin-customer-idcontent-type: application/json
- 새 키워드 생성 노드는 다음으로 POST 요청을 보냅니다.
-
결과 배열 처리
- API는
results아래에 키워드 아이디어 목록을 반환합니다. 분할 노드는 이 배열을 개별 항목으로 분할하여 각 키워드를 별도로 처리할 수 있도록 합니다.
- API는
-
데이터 정리 및 포맷
- 필드 편집 노드는 단순화된 출력 필드를 생성합니다.
keyword: 제안된 키워드 텍스트avgMonthlySearches: 월평균 검색 횟수competition: 높음/중간/낮음 경쟁 지표competitionIndex: 경쟁력의 숫자 인덱스lowTopOfPageBidMicros/highTopOfPageBidMicros: 마이크로에서 USD로 변환(1,000,000으로 나눔)
- 필드 편집 노드는 단순화된 출력 필드를 생성합니다.
-
Google 스프레드시트에 결과 저장
- 업서트 노드는 각 포맷된 키워드 레코드를 **"SEO DOCTOR: Keyword Tool"**이라는 Google 스프레드시트, 특히 GID
1475484115이고 "Keyword"로 레이블이 지정된 시트에 씁니다. - 필드 매핑은 열 이름을 기준으로 자동입니다.
- 업서트 노드는 각 포맷된 키워드 레코드를 **"SEO DOCTOR: Keyword Tool"**이라는 Google 스프레드시트, 특히 GID
-
검토 및 반복
- 사용자는 Google 스프레드시트에서 직접 결과를 검토할 수 있습니다.
- 스티키 노트는 다른 지역, 언어, 고객 ID 또는 대체 트리거(웹훅과 같은)에 대한 재구성을 안내합니다.
💡 팁: 기본 트리거를 웹훅 노드로 교체하여 외부 시스템(CRM, 양식 또는 대시보드 등)이 동적으로 키워드 요청을 보낼 수 있도록 합니다.
이 워크플로우는 n8n이 엔터프라이즈급 API에 대한 노코드/로우코드 액세스를 어떻게 제공하는지 보여줍니다. 복잡한 SEO 작업을 반복 가능하고 자동화된 파이프라인으로 전환합니다. 최소한의 설정으로 팀은 그 어느 때보다 빠르게 실행 가능한 인사이트를 생성할 수 있습니다.
사용 방법: JSON을 다운로드한 뒤 n8n에서 “파일에서 가져오기”를 선택하세요.