O que está sendo contado como conversão

GET

/v1/t/{tenantID}/conversions

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

• Produção

Os totais por categoria (conversions) e o detalhe por tipo de ação reportado pela plataforma (conversion_details, com o papel que explica se a linha soma ou não). O que não estiver classificado não entra em total nenhum.

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

since

string format: date

Primeiro dia, AAAA-MM-DD. Omitido, o servidor escolhe uma janela padrão — não presuma qual: peça explicitamente sempre que o número for comparado com outro.

until

string format: date

Último dia, AAAA-MM-DD. Inclusivo.

Responses

200

OK

Media typeapplication/json

object

since

Primeiro dia efetivamente usado.

string format: date

until

Último dia efetivamente usado, inclusivo.

string format: date

conversions

Array<object>

O total de uma categoria de conversão. Só entram ações canônicas: a mesma venda reportada por mais de um tipo de ação não é contada duas vezes.

object

kind

Como este cliente classificou a ação. O que estiver como não classificado NÃO entra em total nenhum, de propósito.

string

count_micros

Volume, em micros — divida por 1.000.000 em MICROS: divida por 1.000.000 para obter o valor na moeda. 1.500.000 é 1,50. Nunca use ponto flutuante para converter — multiplique e divida como inteiro.

integer format: int64

value_micros

Valor atribuído em MICROS: divida por 1.000.000 para obter o valor na moeda. 1.500.000 é 1,50. Nunca use ponto flutuante para converter — multiplique e divida como inteiro.

integer format: int64

currency

Moeda ISO-4217.

string

outcome

Verdadeiro para resultado de negócio (compra, lead, conversa); falso para métrica de meio de caminho (engajamento, clique, vídeo).

boolean

types

Os tipos de ação, com o nome da rede, que compõem o total.

Array<string>

conversion_details

Array<object>

Uma linha do detalhe por tipo de ação, com o papel que explica por que ela soma ou não.

object

action_type

O nome da ação na plataforma.

string

kind

Como este cliente classificou a ação.

string

role

O papel da linha no total (ex.: canônica).

string

count_micros

Volume, em micros — divida por 1.000.000 em MICROS: divida por 1.000.000 para obter o valor na moeda. 1.500.000 é 1,50. Nunca use ponto flutuante para converter — multiplique e divida como inteiro.

integer format: int64

value_micros

Valor atribuído em MICROS: divida por 1.000.000 para obter o valor na moeda. 1.500.000 é 1,50. Nunca use ponto flutuante para converter — multiplique e divida como inteiro.

integer format: int64

Example ^generated

{
  "since": "2026-04-15",
  "until": "2026-04-15",
  "conversions": [
    {
      "kind": "example",
      "count_micros": 1,
      "value_micros": 1,
      "currency": "example",
      "outcome": true,
      "types": [
        "example"
      ]
    }
  ],
  "conversion_details": [
    {
      "action_type": "example",
      "kind": "example",
      "role": "example",
      "count_micros": 1,
      "value_micros": 1
    }
  ]
}

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