Pular para o conteúdo
AchaduDevelopers
API operacionalIr para o site
Painel
Developers/API/analytics_funnel
Analytics

Analisar funil

Agrupa impressão, clique, intenção, compra e comissão por período.

GET/analytics/funnelanalytics:read
COMPORTAMENTO

A leitura respeita os filtros e devolve somente recursos visíveis para a conta vinculada à chave.

EFEITO

Não altera recursos nem dispara publicação.

REPETIÇÃO

A operação é segura para repetição. Em 429 ou 5xx, use backoff exponencial com jitter.

Solicitação

daysinteger · queryJanela de análise em dias.min 1 · max 365 · default 30opcional
AuthorizationBearer ach_live_...
Acceptapplication/json
Escopoanalytics:read

Exemplo executável

curl
curl 'https://achadu.com/api/v1/analytics/funnel' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json'

Resposta e erros

Toda resposta inclui request_id. Listas acrescentam pagination; recursos mutáveis retornam o estado persistido após a operação.

200 application/json
{
  "data": {
    "period_days": 30,
    "offers": 184,
    "publications": 1238,
    "clicks": 4921,
    "commissions": [
      {
        "currency": "BRL",
        "total": 1842.55,
        "count": 93
      }
    ]
  },
  "request_id": "req_01J..."
}
200Operação concluída.
400Parâmetro, corpo ou transição inválida.
401Chave ausente, inválida, expirada ou revogada.
402O plano da conta não libera esta interface.
403A chave precisa do escopo analytics:read.
404Recurso inexistente nesta conta.
409O estado atual impede esta operação.
413O corpo JSON ultrapassa 128 KB.
429A janela de 120 solicitações por minuto foi excedida.