Analytics de Feed

Visão Geral

O analytics de feed oferece visibilidade sobre como plataformas externas estão consumindo seus feeds de produtos — com que frequência, por quem e com qual taxa de sucesso.

Endpoint

GET /api/v1/feeds/{platform}/analytics

curl "https://app.alana.shopping/api/v1/feeds/google/analytics" \
  -H "X-API-Key: sk_live_sua_chave_api"

const res = await fetch(
  "https://app.alana.shopping/api/v1/feeds/google/analytics",
  { headers: { "X-API-Key": "sk_live_sua_chave_api" } }
);
const analytics = await res.json();

import requests

res = requests.get(
    "https://app.alana.shopping/api/v1/feeds/google/analytics",
    headers={"X-API-Key": "sk_live_sua_chave_api"},
)
analytics = res.json()

Resposta

{
  "platform": "google",
  "period": {
    "from": "2026-02-17T00:00:00Z",
    "to": "2026-03-17T23:59:59Z"
  },
  "total_fetches": 2847,
  "unique_consumers": 3,
  "avg_frequency_hours": 6.2,
  "error_rate": 0.004,
  "last_fetch_at": "2026-03-17T11:45:00Z",
  "product_count_trend": [
    { "date": "2026-03-15", "count": 1420 },
    { "date": "2026-03-16", "count": 1428 },
    { "date": "2026-03-17", "count": 1432 }
  ]
}

Campos da Resposta

Campo	Tipo	Descrição
`total_fetches`	inteiro	Total de downloads do feed no período
`unique_consumers`	inteiro	Número de IPs/agentes consumidores distintos
`avg_frequency_hours`	decimal	Média de horas entre fetches
`error_rate`	decimal	Fração de requisições com erro (0–1)
`last_fetch_at`	ISO 8601	Timestamp do fetch mais recente
`product_count_trend`	array	Snapshots diários de contagem de produtos

Parâmetros de Query

Parâmetro	Padrão	Descrição
`days`	`30`	Janela de lookback (máx: `90`)
`from`	—	Data inicial (ISO 8601)
`to`	—	Data final (ISO 8601)

Retenção de Dados

Os dados de analytics são retidos por 90 dias.

Resumo de Todas as Plataformas

Para obter analytics de todas as plataformas de uma vez:

curl "https://app.alana.shopping/api/v1/feeds/analytics" \
  -H "X-API-Key: sk_live_sua_chave_api"

const res = await fetch(
  "https://app.alana.shopping/api/v1/feeds/analytics",
  { headers: { "X-API-Key": "sk_live_sua_chave_api" } }
);
const resumo = await res.json();

import requests

res = requests.get(
    "https://app.alana.shopping/api/v1/feeds/analytics",
    headers={"X-API-Key": "sk_live_sua_chave_api"},
)
resumo = res.json()
for plataforma in resumo["platforms"]:
    print(plataforma["platform"], plataforma["total_fetches"])

Última modificação em 18 de março de 2026

Visão Geral

Workspace

Membros

Marcas

Dashboards

Catálogos

Produtos

Surfaces

Serviços de IA

Faturamento

Chaves de API

Integrações

Reference

Search API v1

Platform Adapters

Analytics

Feed API

MCP Tools

Data Pipeline

Marketplace Hub

Guias de Plataforma

Visão Geral

Endpoint

Resposta

Campos da Resposta

Parâmetros de Query

Retenção de Dados

Resumo de Todas as Plataformas

​Visão Geral

​Endpoint

​Resposta

​Campos da Resposta

​Parâmetros de Query

​Retenção de Dados

​Resumo de Todas as Plataformas

Visão Geral

Endpoint

Resposta

Campos da Resposta

Parâmetros de Query

Retenção de Dados

Resumo de Todas as Plataformas