HYPR Audiences

Registra se o plano serviu: nota de 1 a 5, comentário livre e ajustes que o usuário precisou fazer (audiência que faltou, pilar errado, volume estranho). Use ao final do fluxo de plano, depois de perguntar ao usuário em uma linha. Alimenta a calibração do ranking.

rate_plan

Busca audiências da HYPR e retorna a volumetria (audience_volume = pessoas únicas; addresses_count = endereços/locais usados). Busca por palavras no nome, categoria, subcategoria e descrição (ex: 'banco', 'pet', 'posto', 'luxo'). Aceita filtros por categoria, subcategoria, tipo e volume mínimo. Sem query, lista as audiências ordenadas por volume.

search_audiences

Recebe os segment_name das audiências de um plano e devolve soma bruta, alcance único estimado, fator de unicidade e os pares com maior sobreposição (com alerta para quase-duplicatas). Estimativa por composição das audiências (redes, subcategoria, descrição), não medição de devices. Use depois de fechar as camadas do plano.

estimate_overlap

Ficha de uma ou mais audiências (segment_name ou nome): descrição, casos de uso, keywords e volume. Com region (ou state/uf/city), devolve recorte_praca.volume_estimado para a praça (rateio por população da UF). Use para confirmar a volumetria de uma audiência específica num estado.

get_evidence

Recebe o plano de audiências (plan: brand, campaign, objective, where/who/how, layers com audiences, solutions, measurement_mode, overlap, next_steps; mesmo esquema do deck.md do plugin HYPR Audiences) e gera o deck no padrão do HYPR Design System (Urbanist, cards, 14 slides: capa, sumário, contexto, camadas, cards de audiência, ranking, alcance único, plataforma, mensuração, próximos passos). Operação aditiva e segura: só cria um arquivo novo, não altera nem apaga o plano guardado nem nenhum dado existente; pode ser chamada quantas vezes quiser. Devolve um link de download do .pptx válido por alguns dias. O mesmo plano pode ser enviado por POST para https://hypr-audiencias.netlify.app/deck para receber o arquivo direto.

build_deck

Lista as audiências de uma categoria ou subcategoria do catálogo (nomes, IDs, volumes), sem busca semântica. Ex.: category='Health & Fitness', sub_category='Gym' devolve os segmentos de academias. Aceita region (UF, cidade ou região) para o rateio do volume pela população. Use list_categories para ver os nomes válidos.

list_audiences

Lista as categorias e subcategorias disponíveis, com número de audiências e volume somado de cada uma.

list_categories

Faz em uma chamada o que o método pede: ranqueia, infere vertical, monta as camadas Core / Conquista / Afinidade / Expansão com regras fixas, recomenda plataforma e mensuração, estima sobreposição e devolve o plano.json completo do deck, já guardado sob plan_id. O modelo só refina os campos de texto listados em text_todo (sem alterar números) e chama build_deck com plan_id + overrides. Mesmos campos de briefing do rank_audiences.

compose_plan

Devolve o método vigente para montar um plano de audiências HYPR com deck: A) fluxo do plano (briefing, ranking, camadas, overlap, entrega, deck, avaliação), B) esquema do plano.json do deck, C) regras de marca. Chame antes de montar qualquer plano e siga-o; é a fonte única, mantida no servidor. section opcional: fluxo | deck | marca.

get_method

Recebe o briefing de uma marca/campanha (inclusive praça e período) e devolve as audiências HYPR ranqueadas por relevância, cada uma com brand_affinity (0 a 100%, afinidade ESTIMADA a partir do cruzamento do briefing com o catálogo) e faixa Alta/Média/Complementar. A affinity é calibrada pela HYPR Library (histórico de centenas de planos reais): audiências já usadas em planos da mesma vertical sobem e vêm com library_evidence (nº de planos, clientes). Devolve também expansion: audiências que o time de planejamento costuma combinar com as rankeadas (co-ocorrência em planos reais), para a camada Expansão. Também recomenda a plataforma HYPR para o caso, calibrada pela vertical do anunciante: quais IQs (geoIQ, revIQ, adsIQ, askIQ) e se o Demandshift se aplicam, com prioridade e justificativa (revIQ, por exemplo, só onde a venda passa por nota fiscal de varejo físico), e devolve measurement_plan com o modo de prova adequado (vendas, visitas ou marca). Use para planos de audiência e propostas.

rank_audiences