Commit inicial - upload de todos os arquivos da pasta

2026-02-14 11:31:10 -03:00
parent e388183601
commit 0d3cd64142
29 changed files with 4386 additions and 364 deletions
--- a/regras_auditoria_old-boa.md
+++ b/regras_auditoria_old-boa.md
@@ -0,0 +1,106 @@
+Aqui está o documento de **REGRAS DE AUDITORIA (GAS v3)** atualizado, integrando o rigor da **Regra de Ferro** para palavras-chave, o novo critério de **Relevância Temática** e a redistribuição de pesos para totalizar 10 pontos.
+
+---
+
+# REGRAS DE AUDITORIA — Google Ads Scorecard (GAS v3)
+
+Avalie cada critério abaixo considerando TODOS os ad_groups. A nota final (0 a 10) é a soma ponderada dos pesos abaixo:
+
+## 1. Keyword Match - Regra de Ferro (Peso 4.0 — máx 4.0 pontos)
+
+* Em cada grupo, pelo menos 5 títulos (headlines) devem ser **IDÊNTICOS** às keywords de fundo de funil do grupo.
+* **CRITÉRIO ELIMINATÓRIO:** Proibido adicionar qualquer palavra, hífen, ou adjetivo antes ou depois da keyword nesses 5 títulos.
+* **Penalidade:** Se um título "enfeitar" a keyword (ex: mudou "advogado guarda" para "advogado guarda em SP"), a nota deste critério para o grupo será **ZERO**.
+
+## 2. Relevância Temática e Isolamento (Peso 3.0 — máx 3.0 pontos)
+
+* **Isolamento de Tema:** Avalie se os 3 grupos possuem temas realmente distintos. Keywords e títulos de um AdGroup não podem "contaminar" outros grupos (ex: termo "inventário" dentro do grupo de "divórcio").
+* **Penalidade:** -1.0 para cada ocorrência de mistura de temas entre grupos.
+
+## 3. Compliance Editorial (Peso 1.5 — máx 1.5 pontos)
+
+* Ausência total de termos proibidos: "grátis", "gratuito", sinônimos (em todos os grupos).
+* Sem formatação proibida: excesso de pontuação (!!!, ???), CAIXA ALTA indevida (exceto siglas como SP, OAB).
+* **Penalidade:** Se houver a palavra "grátis" ou "gratuito" em qualquer grupo, a nota deste critério é **0 automaticamente**.
+
+## 4. Aproveitamento de Espaço (Peso 1.0 — máx 1.0 ponto)
+
+* Descrições devem ter entre 80 e 90 caracteres. Títulos próximos de 30 caracteres.
+* **Penalidade:** -0.2 para cada descrição abaixo de 80 caracteres que desperdiça espaço visual.
+
+## 5. Extensões e Ativos (Peso 0.5 — máx 0.5 ponto)
+
+* Sitelinks devem ter descrições preenchidas (description1 e description2).
+* Callouts devem ser focados em benefícios reais, autoridade e agilidade.
+
+---
+
+## INSTRUÇÕES DE EXECUÇÃO
+
+1. **Auditoria por Grupo:** A IA deve analisar cada `ad_group` individualmente antes de consolidar a nota.
+2. **Indicação de Falhas:** Nas falhas, SEMPRE indique em qual grupo o problema foi encontrado (ex: "Grupo 'Divórcio': Título 3 alterou keyword...").
+3. **Simulação:** Gere uma **Simulação de Anúncio** para CADA grupo, mostrando a composição visual final.
+
+## FORMATO DE RETORNO (JSON)
+
+Retorne o resultado EXATAMENTE neste formato JSON:
+
+```json
+{
+  "nota_final": 0.0,
+  "criterios": [
+    {
+      "nome": "Keyword Match (Regra de Ferro)",
+      "peso": 4.0,
+      "nota": 0.0,
+      "nota_maxima": 4.0,
+      "falhas": [],
+      "sugestoes": []
+    },
+    {
+      "nome": "Relevância Temática",
+      "peso": 3.0,
+      "nota": 0.0,
+      "nota_maxima": 3.0,
+      "falhas": [],
+      "sugestoes": []
+    },
+    {
+      "nome": "Compliance Editorial",
+      "peso": 1.5,
+      "nota": 0.0,
+      "nota_maxima": 1.5,
+      "falhas": [],
+      "sugestoes": []
+    },
+    {
+      "nome": "Aproveitamento de Espaço",
+      "peso": 1.0,
+      "nota": 0.0,
+      "nota_maxima": 1.0,
+      "falhas": [],
+      "sugestoes": []
+    },
+    {
+      "nome": "Extensões e Ativos",
+      "peso": 0.5,
+      "nota": 0.0,
+      "nota_maxima": 0.5,
+      "falhas": [],
+      "sugestoes": []
+    }
+  ],
+  "resumo": "",
+  "simulacoes_anuncio": [
+    {
+      "grupo": "",
+      "titulo_linha_1": "",
+      "titulo_linha_2": "",
+      "titulo_linha_3": "",
+      "url_display": "",
+      "descricao": ""
+    }
+  ]
+}
+
+```