Ajuda & Documentação
Guia completo da plataforma AdVortex Programmatic Hub — conceitos, fluxos de trabalho, módulos e referências técnicas.
🏠 Visão Geral da Plataforma
O que é o AdVortex?
O AdVortex é o hub de serviços da Go Inside para gestão de inventário publicitário digital. Funciona como uma plataforma integrada que combina um CRM comercial, uma SSP (Supply-Side Platform) própria, um agente preditivo de floor price (Optiad) e ferramentas de análise programática.
A plataforma foi desenhada para publishers digitais que vendem inventário publicitário de forma direta e programática, permitindo gerir todo o ciclo comercial — desde a negociação até à faturação — num único ambiente.
Importante
Módulos disponíveis
Fluxo geral de trabalho
O fluxo típico de um deal programático no AdVortex segue estas etapas:
Deal criado
Agência fornece
AdVortex SSP
Agência activa
Automático
Clearing + Fatura
Para deals diretos, o fluxo é mais simples: o publisher cria o deal no CRM, associa as orders do Ad Manager e emite a fatura directamente ao cliente.
🤝 CRM Comercial
Introdução ao CRM
O módulo CRM (Customer Relationship Management) é o centro de gestão comercial da plataforma. Aqui são registados todos os negócios (deals) com agências e anunciantes, tanto diretos como programáticos.
O CRM distingue dois tipos de entidades comerciais: agências (que detêm o orçamento e operam a DSP) e anunciantes diretos (que compram inventário sem intermediário). Esta distinção é fundamental para determinar a quem emitir a fatura e como configurar o deal programático.
Tipos de Deal
Dica
Pipeline e Estados
Cada deal passa por um conjunto de estados que reflectem o progresso da negociação:
Criar um Novo Deal
Para criar um novo deal, clica no botão "+ Novo Deal" no CRM ou no portal. O formulário multi-passo guia-te pelos campos necessários:
Tipo de Deal
Selecciona Direto, PG, PMP ou Preferred. O tipo determina os campos seguintes.
Dados Comerciais
Nome do deal, cliente (agência ou anunciante), canal, período e valor bruto.
Contacto & Briefing
Nome, email e telefone do contacto principal. Orçamento do cliente e notas de briefing.
Configuração Programática
Apenas para deals PG/PMP/Preferred: SSP, DSP, Buyer Seat ID e floor price (CPM).
Revisão
Confirmação de todos os dados antes de guardar.
Detalhe do Deal
Ao clicar num deal na lista, abre o ecrã de detalhe com os seguintes tabs:
Faturação e Pagamento
O tab Faturação no detalhe do deal controla todo o ciclo de billing. Os estados possíveis são:
Atenção
🔗 Publicidade Programática
O que é publicidade programática?
A publicidade programática é a compra e venda automatizada de inventário publicitário digital através de tecnologia. Em vez de negociações manuais, os anunciantes (via DSP) e os publishers (via SSP) transaccionam em tempo real através de leilões electrónicos (RTB — Real-Time Bidding).
No modelo programático, o publisher não cria as orders no Ad Manager — é a agência que o faz através da sua DSP. O publisher apenas configura o Deal ID na SSP e aguarda que a agência active a campanha.
Nota
Deal ID — Como funciona
O Deal ID é um identificador único gerado pela SSP que permite a uma agência específica licitar no inventário do publisher. É o "contrato digital" que materializa o acordo comercial no ecossistema programático.
CRM
AdVortex SSP
Email/Portal
Campanha
RTB
O Deal ID tem o formato DID-AV-YYYYMMDD-XXX quando gerado pelo AdVortex SSP. Este ID deve ser partilhado com a agência para que ela o configure na sua DSP.
Buyer Seat ID
O Buyer Seat ID é o identificador da conta da agência na sua DSP. É fornecido pela agência ao publisher durante a negociação e é associado ao Deal ID para garantir que apenas essa agência pode licitar no inventário reservado.
Cada DSP tem o seu formato de Seat ID. Por exemplo: dv360-seat-12345 para o DV360, ttd-seat-ABCDE para o The Trade Desk.
Dica
Floor Price e CPM
O floor price é o preço mínimo por mil impressões (CPM — Cost Per Mille) abaixo do qual o publisher não aceita licitações. É configurado na SSP para cada deal ou para o inventário em geral.
O Agente Optiad analisa a procura actual, o histórico de deals similares e a disponibilidade de inventário para recomendar o floor price ótimo que maximiza o yield sem sacrificar o fill rate.
RTB — Leilão em Tempo Real
O RTB (Real-Time Bidding) é o processo pelo qual o inventário publicitário é vendido em leilão em menos de 100 milissegundos — o tempo que demora a carregar uma página web.
Impressão disponível
<10ms
<50ms
<80ms
Maior bid > floor
<100ms total
O AdVortex SSP suporta o protocolo OpenRTB 2.6, que é o standard da indústria para comunicação entre SSPs e DSPs.
ads.txt e sellers.json
O ads.txt (Authorized Digital Sellers) é um ficheiro de texto público alojado no domínio do publisher que lista todos os vendedores autorizados do seu inventário. É obrigatório para cada SSP com que o publisher trabalha.
Exemplo de linha ads.txt:
advortex.goinside.pt, AV-PUB-001, DIRECT, AV-CERT-001
rubiconproject.com, 17960, RESELLER
O sellers.json é o ficheiro complementar, alojado no domínio da SSP, que lista todos os publishers que vendem inventário através dessa SSP. Juntos, ads.txt e sellers.json formam a cadeia de transparência do ecossistema programático.
⭐ AdVortex SSP
SSP Própria vs. SSP Externa
Uma SSP (Supply-Side Platform) é a tecnologia que o publisher usa para gerir o seu inventário e conectar-se a compradores (DSPs). Existem duas opções:
Importante
Integração com GAM
O AdVortex SSP integra com o Google Ad Manager (GAM) para sincronizar orders e line items programáticas. Quando uma agência activa um Deal ID na sua DSP, a line item correspondente aparece automaticamente no GAM associada ao Deal ID.
No GAM, as orders programáticas aparecem com o tipo "Programmatic" e o advertiser é o anunciante final (não a agência). A order foi criada pela agência — não pelo publisher.
Protocolo OpenRTB 2.6
O OpenRTB 2.6 é o protocolo standard da IAB (Interactive Advertising Bureau) para comunicação entre SSPs e DSPs em leilões em tempo real. O AdVortex suporta as seguintes funcionalidades do OpenRTB 2.6:
🤖 Agente Optiad
O que é o Optiad?
O Optiad é o agente preditivo de floor price integrado no AdVortex. Analisa continuamente a procura programática, o histórico de deals e a disponibilidade de inventário para recomendar o floor price que maximiza o yield do publisher.
O Optiad está integrado no CRM e no módulo de Supply Flow, aparecendo como um painel de sugestões em tempo real durante a negociação de deals e na configuração de floor prices na SSP.
Calculadora de Floor Price
O módulo Optiad Floor Price (acessível em Optiad Floor) permite simular o impacto de diferentes floor prices no yield e no fill rate. A calculadora considera:
Análise Preditiva
No detalhe de cada deal programático, o Optiad apresenta um histórico de análises com as recomendações feitas em cada fase da negociação (proposta inicial, negociação, fecho). Isto permite comparar o preço negociado com o preço recomendado e calcular o impacto no yield.
Dica
📋 Ad Manager (GAM)
Integração com GAM
O Google Ad Manager (GAM) é o ad server usado pelo publisher para servir anúncios no seu inventário. O AdVortex integra com o GAM para sincronizar orders, line items e dados de entrega.
No tab Ad Manager de cada deal, podes ver as orders GAM associadas, o estado de entrega (impressões entregues vs. reservadas) e a receita por order.
Orders e Line Items
No GAM, uma Order é o contentor de uma campanha. Cada order contém uma ou mais Line Items, que definem o targeting, o formato, o período e o preço.
Orders Programáticas
Para deals programáticos (PG, PMP, Preferred), a order no GAM é criada pela agência através da sua DSP — não pelo publisher. O publisher apenas vê a order aparecer no GAM quando a agência a activa.
As orders programáticas têm o tipo "Programmatic" no GAM e estão associadas ao Deal ID configurado na SSP. O Advertiser mostrado é o anunciante final, mas a order foi submetida pela agência.
Nota
💶 Faturação e Billing
Fluxo de Faturação
O fluxo de faturação no AdVortex segue estas etapas após a conclusão de um deal:
Clearing
Confirmação da entrega real vs. reservada. O clearing é feito pela SSP ou pelo GAM.
Emissão da Fatura
Fatura emitida à entidade correcta (ver secção abaixo). Estado muda para 'Fatura Emitida'.
Pagamento
Recepção do pagamento. Clicar em 'Marcar como Pago' no tab Faturação do deal.
Encerramento
Deal financeiramente encerrado. Estado 'Pago' registado com data de pagamento.
Estados de Faturação
A quem facturar?
A entidade a facturar depende do tipo de deal e da SSP utilizada:
Importante
📖 Glossário
A – D
E – P
Q – Z
📺 Linear → Programático
Contexto e Problema
O AdVortex surge no contexto de um ambiente de broadcasting tradicional (TV linear), onde a monetização de inventário publicitário é baseada em modelos clássicos como GRPs, planeamento manual e segmentação limitada. O objetivo estratégico é transformar esse inventário linear em inventário digitalmente ativável, permitindo a sua comercialização através de plataformas programáticas (DSPs).
Posicionamento do AdVortex
O AdVortex não é um SSP tradicional. Deve ser entendido como uma plataforma de activação programática para inventário broadcast (Linear + Advanced TV) — uma bridge entre o broadcasting e as DSPs.
Importante
Arquitectura de 5 Camadas
A arquitectura funcional do AdVortex para inventário linear organiza-se em 5 camadas sequenciais:
Core Layer
Audiência
Linear → Digital
Camada SSP
Exposição
Dica
Fluxo Operacional
O fluxo operacional de um deal de inventário linear no AdVortex segue 7 etapas:
Definição de Inventário
Breaks e programação linear identificados e catalogados.
Segmentação & Enriquecimento
Audiências transformadas em segmentos ativáveis.
Criação de Pacotes
Inventário empacotado por audiência e contexto.
Publicação de Deals
Deals criados no sistema programático com preços e regras.
Compra via DSP
Agências compram com base em segmentos e garantias.
Entrega nos Breaks
Anúncios inseridos nos breaks reais de broadcast.
Medição & Optimização
Performance analisada e preços ajustados continuamente.
Roadmap de Implementação
Atenção
Arquitectura Técnica Detalhada
Importante
A stack técnica organiza-se em quatro camadas principais, desde os sistemas de broadcast até às DSPs:
O fluxo técnico de execução segue 8 passos: (1) broadcast schedule entra no sistema; (2) Ad Decision Engine identifica ad breaks; (3) Inventory Abstraction gera unidades programáticas; (4) Audience Layer atribui segmentos; (5) Deal Layer expõe inventário a DSPs; (6) DSP faz bidding ou aceita deal; (7) anúncio é inserido no break de broadcast; (8) métricas são recolhidas e enviadas de volta.
Requisitos não funcionais críticos: Performance (latência < 200ms, 99.9%+ uptime), Escalabilidade (múltiplos canais simultâneos, pico em eventos live), Resiliência (fallback de anúncios locais, redundância de decisão) e Compliance (GDPR, consent management integrado).
Integrações com Ecossistema Externo
O AdVortex deve suportar integração com os principais actores do ecossistema de publicidade digital e broadcast:
Nota
Arquitectura Técnica OTT / Streaming
Importante
A arquitectura OTT organiza-se em três camadas distintas que trabalham em conjunto:
SDK de Integração
O SDK do AdVortex é a componente instalada na aplicação do publisher (app móvel iOS/Android, Smart TV, web player). A sua função principal é recolher sinais contextuais e de utilizador, gerir o consentimento GDPR e comunicar com o ad decision engine do AdVortex.
Fluxo técnico do SDK: (1) Player detecta ad break via VAST cue point ou VMAP; (2) SDK verifica consentimento TCF; (3) SDK construí ad request com sinais disponíveis; (4) Ad request enviado ao AdVortex Decision Engine; (5) AdVortex faz bid request a DSPs via OpenRTB; (6) DSP responde com criativo e CPM; (7) AdVortex retorna VAST URL ao SDK ou ao SSAI; (8) Anúncio é entregue ao utilizador.
Atenção
SSAI — Server-Side Ad Insertion
O SSAI (Server-Side Ad Insertion) é a tecnologia que insere anúncios directamente no stream de vídeo no lado do servidor, antes de o stream chegar ao dispositivo do utilizador. Ao contrário do CSAI (Client-Side Ad Insertion), o SSAI é imune a ad blockers e garante uma experiência de visualização sem interrupções.
Fluxo técnico SSAI: (1) Utilizador inicia reprodução; (2) Player solicita manifesto ao servidor de SSAI; (3) SSAI detecta ad break no manifesto original; (4) SSAI envia ad request ao AdVortex com contexto do stream; (5) AdVortex decide criativo via OpenRTB; (6) SSAI faz stitching do criativo no manifesto; (7) Player recebe manifesto unificado; (8) Anúncio reproduzido sem interrupção; (9) Beacons enviados para tracking.
Nota
Consentimento GDPR em Contexto de Streaming
O GDPR (General Data Protection Regulation) tem implicacões específicas para plataformas OTT que recolhem dados de utilizador para fins publicitários. O AdVortex implementa o IAB TCF v2.2 como framework de consentimento, garantindo compliance em todos os dispositivos e mercados europeus.
Impacto do consentimento na receita: A taxa de opt-in em plataformas OTT europeias varia tipicamente entre 55–75%. Uma taxa de opt-in de 65% com CPM contextual 50% inferior resulta num CPM efectivo ponderado de aproximadamente 82.5% do CPM com consentimento total. O AdVortex reporta a taxa de consentimento como KPI operacional e optimiza a apresentação do CMP para maximizar opt-in sem violar as guidelines do TCF.
Atenção
Nota