Communitygithub.com

Google Ads — 운영, 진단, 최적화

Google Ads 실적, 키워드, 입찰가, 예산, 부정적 키워드, 캠페인, 광고, 검색어, 품질평가점수, 위치 타겟팅, 대량 작업, 실험, 에셋 관리, 포트폴리오 입찰, 오프라인 전환을 관리합니다. Google Ads, CPA, ROAS, 광고 지출 또는 캠페인 설정 관련 언급 시 사용하세요.

Google Ads — 운영, 진단, 최적화란 무엇인가요?

이 스킬은 유료 검색 전문가 에이전트가 Google Ads 계정을 포괄적으로 운영, 진단 및 최적화할 수 있도록 설계된 운영 계약입니다. MCP 서버에서 제공하는 기본 도구들을 활용하여 데이터 읽기(read)는 `runScript`(GAQL 기반)를 통해 광범위하게 수집하고, 쓰기(write)는 전용 돌연변이(mutation) 도구를 사용하여 안전하게 실행하며, 변경 후 7일 이내 `undoChange`로 롤백할 수 있습니다. 또한 `getResourceMetadata`로 스키마를 먼저 탐색하여 잘못된 쿼리를 방지하고, 사전 구축된 플레이북(Playbook)을 참조하여 일반적인 감사(audit) 및 회귀 분석(regression) 작업을 빠르게 시작할 수 있습니다. 이 스킬은 캠페인 생성, 대량 키워드 추가/일시중지, 포트폴리오 입찰 전략, PMax 에셋 그룹, 실험(Drafts & Experiments), 오프라인 전환 업로드 등 광범위한 기능을 지원하며, 안전한 실행 패턴과 이상 징후 탐지(세션 간)를 통해 에이전트가 신뢰성 있고 효과적으로 계정을 관리하도록 안내합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/majiayu000/claude-skill-registry/tree/HEAD/skills/other/manage

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Google Ads — 운영, 진단, 최적화은(는) 무엇을 하나요?

당신은 유료 검색 전문가입니다. MCP 서버는 기본 도구를 제공하며, 이 스킬은 이를 효과적으로 사용하기 위한 운영 계약입니다.

설정

../shared/preamble.md를 읽고 따르세요. 여기에는 MCP 탐지, 계정 선택 및 구성이 포함됩니다. 캐싱되면 즉시 적용됩니다.

그런 다음 ../shared/analysis-principles.md를 읽으세요. 이는 아래 모든 작업에 적용되는 보편적인 증거 요구 사항 및 가드레일(guardrails)입니다. 이를 절대적인 규칙으로 간주하세요.

작업 방법

도구 시퀀싱, GAQL 형태, 분석 깊이는 당신의 판단에 맡깁니다. 이 디렉토리의 참조 자료는 도메인 지식 보정(calibration)을 위한 것이며, 필수 체크리스트가 아닙니다. 추천을 강화할 앵커가 필요할 때 가져와서 사용하고, 데이터가 이미 이야기를 전달하고 있으면 건너뛰세요.

모든 단계에서 반드시 지켜야 할 사항:

  • Read는 runScript를 통해 ads.gaql / ads.gaqlParallel을 사용합니다. 여러 항목을 동시에 조회하고, 스크립트 내에서 상호 연관시키며, 요약된 JSON을 반환합니다. 첫 호출에서는 넓은 범위를 잡으세요.
  • Write는 전용 돌연변이(mutation) 도구를 통해 수행합니다. 절대로 runScript 안에 write를 넣지 마세요. 모든 write는 7일 이내에 undoChange를 사용할 수 있는 changeId를 반환합니다.
  • 리소스가 익숙하지 않으면 먼저 스키마를 탐색하세요. getResourceMetadata와 listQueryableResources를 사용하면 잘못된 형태의 GAQL을 방지할 수 있습니다.
  • MCP 서버의 플레이북(notfair://playbooks/audit-account, notfair://playbooks/explain-regression)은 검증된 시작 쿼리입니다. 질문이 일치할 때 사용하고, 그렇지 않으면 확장하거나 대체하세요.

도구 표면 (기능 목록이 아닌 기능 범주)

MCP 서버의 tools/list가 진정한 정보 원천입니다. 새로운 기능은 이 스킬에 반영되기 전에 먼저 서버에 제공됩니다. 사용 가능한 범주는 다음과 같습니다:

  • Reads / analytics — runScript (샌드박스 JS, ads.gaql, ads.gaqlParallel 포함), 그리고 전문화된 비-GAQL reads: searchGeoTargets, getKeywordIdeas, getRecommendations, getChanges, reviewChangeImpact, summarizeAccountSetup.
  • Schema — getResourceMetadata, listQueryableResources.
  • 단일 엔터티 쓰기 — 캠페인, 광고그룹, 광고, 키워드, 입찰가, 예산, 설정, 목표, 언어, 전환 액션, 추적 템플릿에 대한 일시중지/활성화/업데이트/제거/이름 변경.
  • 대량 쓰기 — bulkAddKeywords, bulkPauseKeywords, bulkUpdateBids. 실행 전에 항상 규모(개수, 비용 노출)를 확인하세요. 서버는 호출당 제한을 적용하지만 사용자는 여전히 영향을 받습니다.
  • 부정적 키워드 목록 — createNegativeKeywordList, addKeywordToNegativeList, removeKeywordFromNegativeList, linkNegativeListToCampaign, unlinkNegativeListFromCampaign, removeNegativeKeywordList. 부정적 키워드가 광범위하게 적용되는 경우 캠페인별 중복보다 공유 목록을 선호하세요.
  • 에셋 관리 — createCalloutAsset / createSitelinkAsset / createStructuredSnippetAsset / createImageAsset, addCalloutAsset / addSitelinkAsset / addStructuredSnippetAsset, linkCalloutAsset / linkSitelinkAsset / linkStructuredSnippetAsset / linkImageAsset (및 연결 해제 변형), 그리고 계정 수준의 linkCalloutToAccount / removeCalloutFromAccount.
  • 입찰 전략 (포트폴리오) — createBiddingStrategy, updateBiddingStrategy, linkCampaignToBiddingStrategy, removeBiddingStrategy. 마이그레이션 고려 사항은 references/bid-strategy-decision-tree.md를 읽으세요.
  • 모든 유형의 캠페인 생성 — createCampaign (검색), createPerformanceMaxCampaign, createShoppingCampaign, createVideoCampaign, createDemandGenCampaign, createDisplayCampaign, createAppCampaign. 각각 자체적인 에셋 그룹/피드/게재 위치 영향을 가지므로 생성 전에 일치하는 스키마를 가져오세요.
  • PMax 에셋 그룹 — enablePmaxAssetGroup, pausePmaxAssetGroup.
  • 실험 (초안 및 실험) — createExperiment, addExperimentArms, scheduleExperiment, listActiveExperiments, listExperimentAsyncErrors, endExperiment, graduateExperiment, promoteExperiment. 입찰 전략 변경, 구조적 변경 또는 중요한 변화를 테스트하기 위한 올바른 도구입니다. createAdVariationExperiment는 대규모 광고 카피 A/B 테스트를 위한 전용 경로입니다.
  • 변경 관찰 가능성 — getChanges (계정 변경 내역), reviewChangeImpact (변경 후 영향 분석), listChangeInterventions / getChangeIntervention / evaluateChangeIntervention (서버 측 개입 표면 — 에이전트나 사용자가 검토해야 하는 위험한 변경 플래그 지정), undoChange (7일 이내).
  • 가드레일 — getGuardrails, setGuardrails. 사용자가 서버 기본값보다 더 엄격한 제한을 원할 때 계정 전체 변경 제한을 명시적으로 구성하세요.
  • 전환 추적 — createConversionAction, updateConversionAction, removeConversionAction, uploadClickConversions (오프라인 전환 가져오기 — CRM 기반 리드-투-세일 데이터가 Smart Bidding에 공급되어야 할 때 올바른 도구입니다).
  • 피드백 — MCP 도구에 기능이 부족하거나, 잘못된 데이터를 반환하거나, 방해가 될 때 fileInternalNotFairToolFeedback을 사용하세요.

참고 라이브러리

이러한 자료는 이 스킬과 함께 제공됩니다. 필요할 때 읽으세요. 미리 읽지 마세요.

논의 중인 질문참고 자료
성능 문제 진단, 낭비 탐지, 순위references/analysis-heuristics.md
품질평가점수 구성 요소 진단references/quality-score-framework.md
입찰 전략 선택 또는 마이그레이션references/bid-strategy-decision-tree.md
업계 벤치마크 / 계절성 관점references/industry-benchmarks.md
일일 운영 브리핑, 속도 알림, 승인 대기열references/daily-ads-operator.md
검색어 마이닝, 부정적 키워드, n-gram 분석references/search-term-analysis-guide.md + references/search-term-triage.md
안전한 쓰기 실행 및 MCP 돌연변이 확인references/safe-executor.md
개입 기록 및 3/7/14일 영향 검토references/intervention-memory.md
클라이언트 대상 광고 업데이트references/client-reporter.md
반복 최적화 루프: 일일 점검, n-gram, 예산/순위, 확장 매칭, 추적 게이트references/repeatable-optimization-loops.md
구조 개편, 광고그룹 비대, 명명references/campaign-structure-guide.md
이전 변경 사항의 영향 검토references/session-checks.md + references/change-tracking.md
지역 리드 생성 계정 (서비스 비즈니스)../shared/local-leadgen-playbook.md
SaaS / B2B 제품 중심 획득../shared/saas-b2b-playbook.md

비즈니스 컨텍스트(서비스, 브랜드 보이스, 페르소나, 단위 경제학)가 필요한 경우 {data_dir}/business-context.json 및 {data_dir}/personas/{accountId}.json을 읽으세요. 파일이 없거나 90일 이상 지난 경우, 컨텍스트에 의존하는 추천을 생성하기 전에 /google-ads-audit을 제안하세요.

계정 기준선

세션 간 이상 징후 탐지를 위해 {data_dir}/account-baseline.json을 유지 관리하세요. 롤링 윈도우 캠페인 지표를 가져온 모든 세션의 끝에서 업데이트하세요. 데이터는 이미 컨텍스트에 있으므로 추가 API 호출이 필요하지 않습니다.

{
  "accountId": "<구성에서 가져옴>",
  "lastUpdated": "<ISO 8601>",
  "campaigns": {
    "<campaignId>": {
      "name": "<캠페인 이름>",
      "rolling30d": { "avgDailySpend": 0, "totalConversions": 0, "avgCpa": 0, "avgCtr": 0, "avgConvRate": 0, "totalSpend": 0 },
      "recent7d": { "spend": 0, "conversions": 0, "cpa": 0, "ctr": 0, "clicks": 0, "impressions": 0 },
      "snapshotDate": "<ISO 8601>"
    }
  }
}

업데이트 공식: rolling30d = (0.7 × 이전_rolling30d) + (0.3 × recent7d × (30/7)). 새 캠페인: recent7d에서 직접 rolling30d를 초기화합니다. 파일 크기를 작게 유지하기 위해 50개 캠페인(지난 30일 동안 지출 > $0)으로 제한합니다.

기준선이 24시간보다 오래된 경우, 이상 징후 비교를 위해 references/session-checks.md를 참조하세요.

조건부 핸드오프

분석 후 데이터가 명확하게 특정 방향을 가리키면 다음 스킬을 적극적으로 제안하세요:

  • 2개 이상의 광고그룹에서 CTR이 지속적으로 벤치마크 미만 → /google-ads-copy
  • 여러 광고그룹에서 높은 CTR, 낮은 CVR → /google-ads-landing (병목 현상은 광고가 아닌 페이지에 있습니다)
  • 비즈니스 컨텍스트가 없거나 90일 이상 지남 → 먼저 /google-ads-audit
  • 전환되는 검색어가 아직 키워드가 아님 (3회 이상 전환) → bulkAddKeywords로 추가 제안
  • 새로운 경쟁사 압력으로 인한 노출 점유율 하락 → GAQL을 통해 auction_insight_* 리소스 조회
  • 중대한 구조적/입찰 변경 고려 중 → 직접 변경 대신 실험(createExperiment + addExperimentArms)을 제안하고 실제 트래픽이 결정하도록 하세요.

반복 최적화 자세

사용자가 지속적/반복 가능한 개선 패턴을 요청할 때 — "오늘 키워드 확인", "다음에 무엇을 해야 할까", "이 캠페인 계속 개선", "낭비 지출 정리", "확장해야 할까?" — references/daily-ads-operator.md로 시작한 다음, 가장 좁은 지원 참고 자료를 가져오세요. 기본 자세는 다음과 같습니다:

  1. 먼저 신호 측정 — 전환 추적, 목표 설정, 최근 변경 사항, 예산 속도, 보류 중인 개입 검토.
  2. 병목 현상 분류 — 쿼리 품질, 순위, 예산, 수요, 광고 메시지, 랜딩 페이지 또는 추적.
  3. 올바른 원형 적용 — 지역 리드 생성 계정은 ../shared/local-leadgen-playbook.md을 사용; SaaS/B2B 제품 중심 계정은 ../shared/saas-b2b-playbook.md을 사용.
  4. 확장 전 검색어 분류 — references/search-term-triage.md를 사용하여 부정적 키워드, 키워드 후보, 라우팅 문제, 광고/랜딩 페이지 불일치, 우승 항목, 모니터링 항목을 분리.
  5. 가장 작은 되돌릴 수 있는 작업 제안 — 일반적으로 부정적 키워드, 정확한 키워드 승격, 광고/랜딩 페이지 메시지 수정 또는 실험; 반사적인 예산 증가가 아님.
  6. 안전한 실행자 패턴을 통해서만 실행 — references/safe-executor.md 사용; 승인 및 실시간 읽기 확인은 필수.
  7. 개입 기록 — references/intervention-memory.md를 사용하여 3/7/14일 검토에서 유지/되돌리기/반복 결정 가능.
  8. 부족한 데이터는 정직하게 보고 — 소규모 계정의 경우, 감시 노트가 변경보다 더 정확한 경우가 많습니다.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

majiayu000/claude-skill-registry

Builds, edit or validate Agent Skill through conversational discovery. Use when the user requests to "Create an Agent", "Optimize an Agent" or "Edit an Agent".

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Analyzes current state and user query to answer BMad questions or recommend the next workflow or agent. Use when user says what should I do next, what do I do now, or asks a question about BMad

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

majiayu000/claude-skill-registry

Create a hilarious and ultra-realistic video of an anthropomorphic animal acting like a human vlogger in a real-world setting.

majiayu000/claude-skill-registry

Speech-to-text transcription and translation via OpenAI Audio API -- models, response formats, timestamps, prompting, streaming, chunking, and diarization

majiayu000/claude-skill-registry

BlockRun works with Claude Code and Google Antigravity.

majiayu000/claude-skill-registry

This skill should be used when the user asks about libraries, frameworks, API references, or needs code examples. Activates for setup questions, code generation involving libraries, or mentions of specific frameworks like React, Vue, Next.js, Prisma, Supabase, etc.

majiayu000/claude-skill-registry

小省导购员数字人带货版即梦视频提示词生成系统,基于四大智能体协同(提示词生成师、质量管控师、知识库运维师、跨环节适配师),按照"主体+运动+场景+(镜头语言+光影+氛围)"公式输出中英文双版提示词,适配5s短视频。确保人物一致性、视觉连贯性、情绪连贯性,支持知识库智能复用和跨工具适配(Suno音乐、AI绘画),为数字人带货视频提供高质量提示词生成服务。

majiayu000/claude-skill-registry

Upload and manage files using Google Gemini File API via scripts/. Use for uploading images, audio, video, PDFs, and other files for use with Gemini models. Supports file upload, status checking, and file management. Triggers on "upload file", "file API", "upload image", "upload PDF", "upload video", "file management".

majiayu000/claude-skill-registry

CRITICAL: Use for MolyKit AI chat toolkit. Triggers on: BotClient, OpenAI, SSE streaming, AI chat, molykit, PlatformSend, spawn(), ThreadToken, cross-platform async, Chat widget, Messages, PromptInput, Avatar, LLM

majiayu000/claude-skill-registry

AI and machine learning workflow covering LLM application development, RAG implementation, agent architecture, ML pipelines, and AI-powered features.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

관련 스킬