O perfil médio das dez redes

GET

/v1/t/{tenantID}/publicos/redes

curl --request GET \
  --url https://dash.owiew.com/v1/t/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/publicos/redes \
  --header 'Authorization: Bearer <token>'

• Produção

Para onde a base de cada rede pende quando nada é dito, com os índices de custo.

Duas leituras erradas, e as duas custam dinheiro. O perfil é MÉDIO: descreve o ponto de partida de quem não segmentou, não uma regra sobre um anúncio. E custo_cpm_relativo é um ÍNDICE em que 1,00 é a mediana das dez — não reais, não previsão. Tratá-lo como preço é como um orçamento nasce errado.

Catálogo curado, servido do código: não vem de plataforma nenhuma e não muda com a janela.

Exige a permissão publico.read.

Authorizations

• tokenDeAcesso

Parameters

Path Parameters

tenantID

required

string format: uuid

O cliente. Vem SEMPRE do caminho — nunca de cabeçalho, nunca de cookie. Ele é conferido contra o token: um identificador que não bata com o do token devolve 403, e não uma resposta vazia.

Responses

200

OK

Media typeapplication/json

object

redes

Array<object>

O perfil MÉDIO de uma rede: para onde a base dela pende quando nada é dito. Não é regra sobre um anúncio — é o ponto de partida de quem ainda não segmentou nada.

object

id

Ex.: meta_instagram.

string

plataforma

string

Allowed values: meta google tiktok linkedin x pinterest kwai

idade_nucleo

[inicio, fim] POSICIONAL, não objeto: onde está a maior parte da base.

Array<integer>

>= 2 items <= 2 items

idade_cauda

[inicio, fim]: até onde a rede ainda entrega volume, com custo maior.

Array<integer>

>= 2 items <= 2 items

classes

Classes predominantes, em ordem de peso. Não se traduzem.

Array<string>

custo_cpm_relativo

ÍNDICE RELATIVO, nunca reais: 1,00 é a mediana destas dez redes. Ler 0,60 como previsão de preço é como um orçamento nasce errado — a rede mais barata por mil impressões pode ser a mais cara por venda.

number

custo_cpc_relativo

Índice relativo. Ver custo_cpm_relativo.

number

custo_cpl_relativo

Índice relativo. Ver custo_cpm_relativo.

number

intencao

Em que estado de intenção a pessoa está quando encontra o anúncio. declarada é quem foi procurar; descoberta é quem não estava procurando nada.

string

Allowed values: descoberta consideracao declarada planejamento mista

teto_de_ticket

Acima desta faixa a rede entrega volume sem venda. Vazio significaria sem teto conhecido.

string

piso_de_ticket

Abaixo desta faixa o custo da rede não fecha a conta.

string

serve_b2b

boolean

exige_video_nativo

Quando verdadeiro, peça estática não roda ali. É custo de produção e entra na decisão antes do orçamento.

boolean

sofre_em_regiao_pequena

boolean

tangibilidades

As tangibilidades em que a rede vai bem. Vazio ou null significa TODAS, e não nenhuma.

Array<string>

Example

{
  "redes": [
    {
      "plataforma": "meta",
      "intencao": "descoberta"
    }
  ]
}

401

Token ausente, malformado ou vencido.

Media typeapplication/json

object

error

object

code

Código estável, seguro para comparar.

string

message

Texto para pessoa. Pode mudar entre versões — não decida nada a partir dele.

string

trace_id

Identificador da ocorrência. Cite-o ao pedir suporte.

string

Example ^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "trace_id": "example"
  }
}

403

O token é válido, e o escopo não. Ou ele foi emitido para outro cliente, ou o papel não inclui a permissão da rota. NÃO é 404 de propósito: esconder um erro de escopo atrás de ‘não encontrado’ faz quem integra procurar o problema no lugar errado.

Media typeapplication/json

object

error

object

code

Código estável, seguro para comparar.

string

message

Texto para pessoa. Pode mudar entre versões — não decida nada a partir dele.

string

trace_id

Identificador da ocorrência. Cite-o ao pedir suporte.

string

Example ^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "trace_id": "example"
  }
}