Guia de produto.

Mediação.

Para publishers que já trabalham com outras redes, a mediação permite competir redes externas com a AdPluga num waterfall de prioridades — maximizando fill rate e receita.

O que é a mediação.

A mediação é um sistema de waterfall que envia pedidos de anúncio a múltiplas fontes (redes externas e a AdPluga) e selecciona a resposta com maior eCPM. Em vez de depender de uma única rede, o publisher diversifica as fontes de procura e aumenta a concorrência por cada impressão.

Redes suportadas.

A ligação real a procura externa é o adaptador genérico OpenRTB 2.6 (kind «OpenRTB»), que funciona com qualquer SSP/exchange que exponha um endpoint OpenRTB 2.6 server-to-server. As redes de marca (AdMob, Meta, InMobi, Unity, Liftoff) aparecem na lista mas ainda não têm adaptador dedicado — para essas fontes usa o kind OpenRTB apontado ao respectivo endpoint. Cada rede tem credenciais, prioridade e eCPM floor.

Rede OpenRTB 2.6 — o que é e como preencher.

OpenRTB é o protocolo programático do IAB. Este adaptador é server-to-server (S2S): a AdPluga envia um BidRequest 2.6 ao endpoint do SSP e serve o bid vencedor. É procura externa de último recurso — corre depois dos teus anúncios, DIRETO e POOL, e antes do HOUSE. Basta o kind «OpenRTB 2.6 (genérico)» apontado a um SSP; qualquer exchange com endpoint OpenRTB funciona sem adaptador dedicado.

O criativo do SSP é servido tal como vem, sem moderação por-criativo da AdPluga. Controla o que entra pelo eCPM mínimo, prioridade, timeout e pelo interruptor «Activa no waterfall»; o consentimento GDPR/TCF é reencaminhado no pedido. Activa uma rede OpenRTB apenas com um SSP em que confias.

Hoje a mediação serve criativos banner/HTML (imagem), Vídeo (VAST) e native. Define o eCPM floor na moeda contratada com o SSP.

Campos do formulário «Nova rede de mediação»:

endpoint_url — URL absoluto https:// do endpoint OpenRTB 2.6 do SSP (obrigatório).
auth_scheme / auth_value — Como autenticar no SSP: none (público), bearer, basic ou header. O auth_value é o token/segredo; em header indica também o nome do cabeçalho.
publisher_id — O site.publisher.id que o SSP te atribui. Recomendado pela maioria dos SSPs para casar o inventário.
seat_id — Seat/buyer interno do SSP (opcional).
site_domain — Domínio de fallback usado quando o /serve não conhece o site do pedido.
currency — Código ISO-4217 (default USD). É a moeda do bid e do eCPM floor — usa a contratada com o SSP.
user_agent — User-Agent enviado ao SSP. Vazio usa o default do adaptador.
gzip — Envia o BidRequest com Content-Encoding: gzip. Liga apenas se o SSP suportar.

As credenciais são serializadas em JSON e cifradas em repouso (AES-GCM). Depois de guardadas não são mostradas — para substituir um valor, rotaciona-o.

Passo a passo: ligar uma fonte OpenRTB.

Antes de começar, pede ao SSP/exchange o contrato técnico: o endpoint OpenRTB 2.6 S2S, o esquema e a credencial de autenticação, o teu publisher_id (o site.publisher.id que eles atribuem), a moeda e se suportam gzip.

Inventário → Mediação → «Nova rede de mediação» e escolhe «OpenRTB 2.6 (genérico)».
Preenche o endpoint_url (obrigatório) e a autenticação; adiciona publisher_id, seat_id, site_domain, currency e user_agent conforme o contrato do SSP (ver a secção de campos acima).
Define a Prioridade (menor tenta primeiro), o Timeout por adaptador e o eCPM mínimo (floor) na moeda do SSP. Deixa «Activa no waterfall» ligada.
Brand-safety: em Inventário → Slots, edita o slot e preenche as categorias bloqueadas e os domínios de anunciantes bloqueados — são enviados como bcat/badv e filtram a resposta da mediação.
Guarda. As credenciais são cifradas em repouso e a rede entra no waterfall no próximo refresh do snapshot (segundos).
Testa primeiro com o kind «mock» (fill determinístico) para veres o anúncio aparecer no teu layout e só depois aponta ao SSP real.

Como aparece: a mediação corre como último recurso (DIRETO → POOL → mediação → HOUSE). Quando um SSP ganha, o criativo HTML é renderizado no mesmo iframe seguro dos criativos HTML e a imagem via asset. Acompanha em Métricas e em /v1/mediation/stats.

Onde registar-se (SSPs OpenRTB 2.6).

O adaptador OpenRTB é genérico: não traz procura embutida. Precisas de uma parceria com uma SSP/exchange que aceite integração OpenRTB 2.6 server-to-server. Regista-te como Editor/Publisher; após aprovação, o painel da SSP dá-te o endpoint_url e o publisher_id que colocas no formulário da AdPluga.

O formulário da SSP costuma pedir: o URL do teu site/app, o volume mensal (algumas SSPs premium exigem tráfego mínimo — por exemplo 5 a 10 milhões de pageviews/mês — para libertar ligações S2S) e a linha de autorização a acrescentar ao teu ads.txt. Enquanto não tens conta, valida o teu layout com o kind «mock» usando dados fictícios (endpoint_url e publisher_id de teste) e substitui pelos reais quando fores aprovado.

Exemplos de SSPs do mercado com OpenRTB 2.6 S2S: PubMatic, Magnite, Index Exchange, OpenX, Equativ e Criteo, entre outras. Escolhe conforme a tua região, os formatos (hoje banner/HTML) e os requisitos de tráfego.

Como configurar.

No painel, aceda a Inventário → Mediação. Adicione as redes externas com as respectivas credenciais e defina a ordem de prioridade no waterfall. A AdPluga é incluída automaticamente como rede interna. Os pedidos percorrem o waterfall da prioridade mais alta para a mais baixa até uma rede responder acima do floor.

Prioridades e eCPM floor.

Cada rede no waterfall tem uma prioridade (1 = mais alta) e um eCPM floor mínimo. Se a rede com prioridade 1 não responde ou o seu bid está abaixo do floor, o pedido avança para a rede seguinte. Isto garante que cada impressão é vendida ao melhor preço possível.

Métricas e relatórios.

O painel de mediação mostra, por rede: impressões servidas, fill rate, eCPM médio e receita. Compare o desempenho das redes externas com a AdPluga para optimizar a configuração do waterfall ao longo do tempo.