As listas fechadas do construtor de público

GET

/v1/t/{tenantID}/publicos/taxonomia

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

• Produção

Os cinco eixos aceitos, os limites de tamanho, as bases legais e os pisos de cada plataforma. É a mesma resposta para todo cliente e ela não muda com a janela de datas.

Leia esta rota antes de montar um briefing. Os eixos são validados pelo servidor: valor fora destas listas é recusado na gravação.

Ela também serve o IMPORTADOR: campos_de_lista é o vocabulário do mapeamento de colunas, e bases_legais é o do seletor de base legal.

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

As listas FECHADAS do construtor, os limites de tamanho e os pisos de cada plataforma. É a mesma resposta para todo cliente.

Leia esta rota antes de gravar um briefing. Os cinco eixos são validados pelo servidor na gravação: um valor que não está aqui é recusado na gravação, e não há como descobri-lo por tentativa sem tomar 400.

object

mercados

Array<string>

Allowed values: b2c b2b ambos

naturezas

A natureza da compra.

Array<string>

Allowed values: essencial opcional aspiracional recorrente sazonal emergencial

tangibilidades

Array<string>

Allowed values: fisico alimentar utilidade_pratica emocional servico_profissional infoproduto financeiro saude

tickets

As faixas de ticket, de t1 a t6.

Array<object>

object

id

t1 a t6.

string

de

Piso da faixa, em REAIS — não em micros e não em centavos. É o único lugar da API onde dinheiro não está em micros, porque aqui ele é rótulo de faixa e não valor medido.

integer

ate

Teto da faixa, em reais. 0 significa SEM TETO, e só acontece na t6. Tratar o zero como limite superior faria a faixa mais cara do catálogo virar a mais barata.

integer

abrangencias

Array<string>

Allowed values: nacional estados cidades raio internacional

bases_legais

As bases legais aceitas na importação de lista. São CÓDIGOS: cada um exige uma coisa diferente de quem importa, e a explicação do que cada um exige NÃO vem nesta lista — ela é da interface.

Array<string>

Allowed values: consentimento contrato legitimo_interesse

campos_de_lista

Os campos que uma coluna do CSV pode virar no mapeamento.

nome_completo é campo de ENTRADA apenas. Ele existe porque a maior parte dos CRMs exporta o nome inteiro numa coluna só, e as plataformas casam primeiro nome e sobrenome SEPARADOS — mapear essa coluna como nome produz sobrenome vazio em 100% das linhas, sem erro nenhum. Ele nunca sai como coluna de exportação.

Array<string>

Allowed values: email telefone nome sobrenome nome_completo cidade uf cep pais ignorar

origens

As origens de público que existem. Leia daqui em vez de digitar a lista: é a mesma regra dos outros vocabulários desta rota, e uma origem nova aparece sozinha para quem integra.

Array<string>

Allowed values: montado semelhante

limites

Tetos de tamanho, em caracteres (contados em runas, não em bytes).

object

nome

integer

descricao

integer

nicho

integer

diferenciais

integer

raio_km_maximo

Em quilômetros.

integer

retencao_dias_maxima

Teto de retenção de uma lista, em dias. Acima disso a lista casa mal — as pessoas trocaram de e-mail — e continua sendo dado pessoal de gente que talvez nem seja mais cliente.

integer

minimos_de_plataforma

Quantas linhas APROVEITADAS cada plataforma exige para semear um público semelhante. Não é alcance: quantas ela casa com gente real é ela quem diz, depois do envio, e costuma ser bem menos.

object

meta

integer

meta_recomendado

integer

google

integer

tiktok

integer

Example

{
  "mercados": [
    "b2c"
  ],
  "naturezas": [
    "essencial"
  ],
  "tangibilidades": [
    "fisico"
  ],
  "abrangencias": [
    "nacional"
  ],
  "bases_legais": [
    "consentimento"
  ],
  "campos_de_lista": [
    "email"
  ],
  "origens": [
    "montado"
  ]
}

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"
  }
}