Sugestões de desempenho (ROAS real × alvo)

GET

/v1/t/{tenantID}/sugestoes-de-desempenho

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

• Produção

Compara o ROAS real do período (receita ÷ gasto, SOMADOS — nunca média de ROAS) ao ROAS alvo: o roas_desejado dos Dados do projeto (origem_do_alvo: projeto), senão a premissa roas_alvo do plano vigente que cobre o período (plano), senão o padrão do segmento (segmento, com acao_da_meta convidando a defini-la). A RECEITA vem de uma hierarquia de fontes com confiança explícita (fonte_da_receita): vendas conciliadas do commerce (alta), receita de compra do GA4 nos canais pagos, bruta menos reembolso (média; baixa se o detector de GA4 desconfigurado achar problema) ou valor de conversão das plataformas (baixa, com aviso de dupla contagem entre redes); o bloco traz o porquê, os avisos e o que falta para subir de confiança. situacao: abaixo (< 85% do alvo), normal (85% a 115%), acima (> 115%) ou incerto (nenhuma fonte de receita serve — com o motivo, nunca 500; havendo gasto, as sugestoes são de base: CPA contra o cpa_maximo, campanha sem conversão e concentração de gasto, e sugestoes_de_base é true). Cada sugestão tem chave estável roas:<situacao>:<acao> ou base:<tema>:<acao>, que vira dica_chave ao virar tarefa. Sem de/ate: os últimos 30 dias (America/Sao_Paulo).

Exige a permissão insights.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.

Query Parameters

de

string format: date

Primeiro dia, AAAA-MM-DD.

ate

string format: date

Último dia, AAAA-MM-DD, inclusivo. Janela máxima de 180 dias.

Responses

200

OK

Media typeapplication/json

object

Example ^generated

{}

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