Skip to content
Back to search

fiera-google-ads-rules

MarketplaceWorks with Claude CodeGitHub

Reglas abiertas de Fiera para Google Ads, como Agent Skills y plugin de Claude Code.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/fieradigital--fiera-google-ads-rules/badge.svg)](/listings/fieradigital--fiera-google-ads-rules)

HTML

<a href="/listings/fieradigital--fiera-google-ads-rules"><img src="/api/listings/fieradigital--fiera-google-ads-rules/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 26 lines
  1. {
  2. "name": "fiera-google-ads-rules",
  3. "owner": {
  4. "name": "Fiera",
  5. "url": "https://fiera.digital"
  6. },
  7. "metadata": {
  8. "description": "Reglas abiertas de Fiera para Google Ads, como Agent Skills.",
  9. "version": "1.0.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "fiera-google-ads-rules",
  14. "source": "./",
  15. "description": "Reglas abiertas de Fiera para Google Ads: guía de setup en solo lectura, contexto de cuenta, gotchas de API y GAQL, keywords y negativas, copy, assets y PMax, pujas y medición, y un workflow de auditoría de cuenta en solo lectura.",
  16. "version": "1.0.0",
  17. "license": "CC-BY-4.0",
  18. "category": "marketing",
  19. "tags": [
  20. "google-ads",
  21. "ppc",
  22. "gaql"
  23. ]
  24. }
  25. ]
  26. }
README.md · README · 67 lines
  1. # FIERA - reglas abiertas de Google Ads
  2. Somos Fiera, una consultora de performance marketing de Barcelona. Gestionamos cada día cuentas de Google Ads de empresas de distintos sectores, y estas reglas salen de ese trabajo: comportamientos de la API que la documentación no cuenta, lecturas de datos que engañan y decisiones que hemos visto salir bien y mal.
  3. Las publicamos como Agent Skills para quien ya trabaja, o quiere empezar a trabajar, con un agente conectado a Google Ads. Las personas que gestionan cuentas también pueden leerlas tal cual.
  4. ## Qué hay dentro
  5. ### Empieza aquí
  6. Si es la primera vez que conectas un agente a Google Ads, empieza por estas dos skills:
  7. | Skill | Para qué sirve |
  8. |---|---|
  9. | `google-ads-setup` | Montar el agente desde cero: cómo conectarlo a Google Ads, por qué empezar en solo lectura, cómo instalar estas reglas y cómo comprobar que funciona |
  10. | `google-ads-account-context` | Crear `account-context.md` con el negocio, los objetivos, los buckets de campañas, el contrato de medición y las reglas de marca de una cuenta. Las demás skills lo leen antes de trabajar |
  11. ### Reglas y auditoría
  12. Las otras cinco skills llevan las reglas. Cada una lleva un `SKILL.md` con el índice de sus reglas y una carpeta `references/` con las reglas completas, separadas por tema. El agente lee el índice y abre solo el fichero que necesita.
  13. | Skill | Qué cubre | Reglas |
  14. |---|---|---|
  15. | `google-ads-api-gotchas` | GAQL, cliente Python, historial de cambios, cuotas, mutaciones seguras, creación de campañas, PMax y Demand Gen por API, Auction Insights | 103 |
  16. | `google-ads-keywords-negatives` | Search terms, match types, AI Max, negativas, Keyword Planner y Quality Score | 29 |
  17. | `google-ads-copy-assets-pmax` | Copy de RSA, extensiones, Performance Max, Demand Gen, App, estructura, geo y landing pages | 53 |
  18. | `google-ads-bidding-measurement` | Smart Bidding, portfolios, budgets y pacing, objetivos de conversión, tracking, lag y atribución | 18 |
  19. | `google-ads-account-audit` | Auditoría de una cuenta en doce pasos, en solo lectura | 1 workflow |
  20. ## Cómo instalarlo
  21. En Claude Code, añade el marketplace e instala el plugin:
  22. ```
  23. /plugin marketplace add fieradigital/fiera-google-ads-rules
  24. /plugin install fiera-google-ads-rules@fiera-google-ads-rules
  25. ```
  26. En ChatGPT, instálalo con un clic desde la [ficha del plugin](https://chatgpt.com/plugins/plugins_6afb1685ec2481918aea58af2ceda674).
  27. Si usas otro agente que lea ficheros `SKILL.md`, como Codex o Cursor, copia la carpeta `skills/` en el directorio de skills de tu agente. Cada skill funciona sola, aunque la auditoría cita reglas de las otras y todas leen `account-context.md` si existe.
  28. ## Cómo está escrita cada regla
  29. Todas las reglas siguen el mismo formato:
  30. - **Tipo**: gotcha de API, gotcha de plataforma, regla de decisión, regla de seguridad o error de método.
  31. - **Por qué**: el mecanismo que explica el comportamiento.
  32. - **Cómo detectarlo**: la consulta GAQL, el campo o el paso concreto para verlo en tu cuenta.
  33. - **Qué hacer**: la acción.
  34. - **Evidencia**: en cuántas cuentas lo hemos visto y cuándo.
  35. "Visto en 1 cuenta" quiere decir que lo hemos observado en una sola cuenta. Lo publicamos porque el mecanismo es reproducible, pero conviene comprobarlo en tu cuenta antes de actuar. "Visto en 2-3 cuentas" y "Visto en 4+ cuentas" indican que se ha repetido. Los gotchas de API llevan la versión en la que se comprobaron, casi siempre la v24.
  36. Ninguna regla identifica a un cliente. Hemos quitado nombres, sectores, mercados y cifras absolutas de cuenta.
  37. ## Sin soporte
  38. Puedes usar estas reglas libremente, tal como están. Leemos los issues que se abran, pero no los contestamos uno a uno. Si una regla deja de ser cierta por un cambio de Google, nos ayuda mucho que lo cuentes en un issue.
  39. ## ¿Necesitas más?
  40. Si quieres que un agente aplique estas reglas sobre tus cuentas cada día, con análisis, propuestas y cambios aprobados, mira nuestra [plataforma de agentes](https://fiera.digital/agent-platform?utm_source=github&utm_medium=readme&utm_campaign=rules-v1). Si prefieres que llevemos tus campañas, mira nuestro servicio de [paid media](https://fiera.digital/paid-media?utm_source=github&utm_medium=readme&utm_campaign=rules-v1). Para cualquier otra cosa, [escríbenos](https://fiera.digital/contact?utm_source=github&utm_medium=readme&utm_campaign=rules-v1).
  41. ## Licencia
  42. El texto se publica bajo [Creative Commons Attribution 4.0 International (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/). Puedes copiarlo, adaptarlo y usarlo en proyectos comerciales, siempre que cites a Fiera como autor y enlaces a la licencia. El texto completo está en [`LICENSE`](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.