Google Ads Master

• 새 Google Ads 계정을 설정하거나 기존 계정을 온보딩하면서 무언가를 건드리기 전에 구성, 전환 액션, 예산 및 가드레일을 수집해야 합니다.
• 캠페인 수준 또는 키워드 수준의 성과 보고서(CTR, ROAS, 검색 노출 점유율, CPA)를 혼합된 UI 합계가 아닌 실제 기본 전환 액션을 기준으로 해석하고 싶습니다.
• 낮은 CTR을 조사하거나, 전환 가치 불일치를 진단하거나, 검색어 및 지역 데이터를 분석하여 입찰/제외/분할 결정을 내려야 합니다.
• 구조화된 사양을 기반으로 일시중지 상태의 새 검색 캠페인, 광고 그룹 또는 키워드를 생성하고, 작성 후 GAQL 읽기 검증을 통해 생성된 항목을 확인하고 싶습니다.

• Google Ads 외의 플랫폼이나 검색 외 캠페인 유형을 관리해야 하는 경우—이 스킬은 Google Ads 검색 워크플로우에 한정되어 있습니다.
• 사람의 확인 단계 없이 완전히 자동화된 캠페인 최적화를 원하는 경우—이 스킬은 모든 쓰기 작업 전에 명시적인 허가가 필요합니다.
• 최소 온보딩(고객 ID, 인증, 보고 시간대, 기본 전환 액션)을 아직 완료하지 않은 경우—스킬은 분석 또는 쓰기 작업을 진행하기 전에 이 정보를 요청합니다.

분석이나 계정 변경 작업을 수행하기 전에, Google Ads Master는 최소한의 필수 데이터셋을 수집합니다: 고객 ID, OAuth/인증 경로, 개발자 토큰, 보고 시간대, 비즈니스 모델, 기본 전환 액션, ROAS/CPA 목표값, 그리고 쓰기 권한. 이를 통해 불완전하거나 불일치하는 계정 컨텍스트를 기반으로 작업이 수행되는 것을 방지합니다.

모든 캠페인, 광고 그룹 및 키워드 생성은 사용자가 명시적으로 달리 요청하지 않는 한 기본적으로 일시 중지(PAUSED) 상태로 설정됩니다. 예산과 입찰가는 확인 없이 절대 수정되지 않으며, 모든 쓰기 작업 후에는 ID와 상태를 요약하기 위한 GAQL 재조회가 수행됩니다.

성과 분석은 사용자가 확인한 주요 전환 액션을 기준으로 수행되며, 구매·리드·가입으로 임의 가정하지 않습니다. Google Ads UI에서 혼합된 전환 합계는 사용자가 어떤 액션이 집계 대상인지 확인하기 전까지 신뢰할 수 없는 데이터로 표시됩니다.

이 스킬에는 네 가지 스크립트가 포함되어 있습니다: 공유 클라이언트/설정 헬퍼, 캠페인 요약 보고서 (CTR/ROAS/IS 진단), 키워드 수준의 주요 전환 보고서, 그리고 JSON 사양을 기반으로 한 일시 중지된 검색 캠페인 빌더입니다. 모든 스크립트는 google-ads Python gRPC 클라이언트를 사용합니다.

권장 사항은 일관된 워크플로우를 따릅니다: 사용자의 실제 키워드와 시장을 기반으로 의도 버킷별로 세분화하고, 유지/관찰/축소/일시정지/분할/부정적 키워드 추가 작업을 적용하며, 실행 가능성을 위해 항상 캠페인 및 키워드 이름을 지표와 함께 참조합니다.

이 스킬은 알려진 REST 불완전성 문제를 방지하기 위해 내부 GAQL 패턴 및 API 주의 사항을 참조하며, gRPC 클라이언트를 우선적으로 사용합니다. 쓰기 후 읽기 검증(post-write readback)을 통해 캠페인 ID/이름/상태/예산, 광고 그룹 ID/상태, 키워드 텍스트/매칭/상태를 확인합니다.

새 사용자가 Google Ads 계정을 연결하면, 스킬이 온보딩 체크리스트를 단계별로 안내합니다. 고객 ID, 인증 정보, 전환 액션, 목표 및 가드레일을 수집한 후 report_campaigns.py를 실행하여 기본 CTR, ROAS 및 노출 점유율 요약을 생성합니다.

한 광고주가 UI의 마이크로 전환으로 인해 주요 전환 액션이 희석되고 있다고 의심하고 있습니다. 이 스킬은 확인된 기본 액션에 범위를 지정하여 purchase_keywords.py를 실행하고, 어떤 키워드가 실제 성과를 이끌고 있는지, 그리고 어떤 키워드가 부풀려진 수치를 만들어내는지를 파악합니다.

캠페인 CTR이 하락했으나 원인이 불분명합니다. 이 스킬은 검색어 및 키워드 데이터를 가져와 광고 관련성 문제, 매치 유형 이탈, 또는 순위 손실 노출 점유율(Rank Lost Impression Share) 중 어떤 것이 원인인지 진단하고, 측정 지표 근거와 함께 유지/일시정지/분리/제외 등 구체적인 조치를 권장합니다.

사용자가 예산, 입찰 전략, 키워드 목록, 매치 타입, 제외 키워드, 광고 문구 및 URL이 포함된 캠페인 브리프를 제공합니다. 이 스킬은 JSON 사양서를 형식화하고, 먼저 드라이런(dry-run) 모드로 create_search_skeleton.py를 실행한 후, 구조를 일시 중지(PAUSED) 상태로 생성하고 확인을 위해 모든 ID와 상태를 다시 읽어옵니다.