Exportação de dados: documentação do CheckoutOS

A exportação de dados permite extrair dados do CheckoutOS para usar em ferramentas externas, como Excel, Google Sheets, plataformas de BI ou sistemas de análise personalizados.

Opções de exportação

Formatos disponíveis

CSV — Formato universal de planilhas
Excel (.xlsx) — Formato nativo do Excel com formatação
JSON — Para uso programático
PDF — Relatórios formatados para compartilhar
Google Sheets — Exportação direta para o Sheets

Exportação pelo painel

Acessar os dados

Abra a seção do painel que deseja exportar.

Clicar em exportar

Clique no ícone de exportação no canto superior direito.

Escolher o formato

Selecione o formato de exportação desejado.

Configurar opções

Defina o período, as colunas que serão incluídas e outras opções.

Baixar

Clique em baixar para obter o arquivo.

Dados que podem ser exportados

Dados de pedidos

Exporte dados detalhados dos pedidos, incluindo os recursos do CheckoutOS:

Campos da exportação de pedidos

{
  "export": {
    "type": "orders",
    "fields": [
      "order_id",
      "order_date",
      "customer_id",
      "customer_email",
      "order_subtotal",
      "order_total",
      "checkoutos_revenue",
      "upsells_accepted",
      "bundles_purchased",
      "device_type",
      "traffic_source"
    ],
    "date_range": "last_30_days",
    "filters": {
      "has_checkoutos_feature": true
    }
  }
}

Dados de desempenho das vendas adicionais

Exportação de vendas adicionais

{
  "export": {
    "type": "upsell_performance",
    "fields": [
      "upsell_id",
      "upsell_name",
      "product_offered",
      "times_shown",
      "times_accepted",
      "acceptance_rate",
      "revenue_generated",
      "avg_discount_given"
    ],
    "group_by": ["upsell_id", "date"],
    "date_range": "last_90_days"
  }
}

Dados de testes A/B

Exportação de experimentos

{
  "export": {
    "type": "experiments",
    "fields": [
      "experiment_id",
      "experiment_name",
      "variant_name",
      "visitors",
      "conversions",
      "conversion_rate",
      "revenue",
      "aov",
      "statistical_significance"
    ],
    "include_daily_breakdown": true
  }
}

Exportações agendadas

Configure exportações automáticas em um cronograma:

Exportação agendada

{
  "scheduled_export": {
    "name": "Weekly Performance Export",
    "export_type": "orders",
    "format": "csv",
    "schedule": {
      "frequency": "weekly",
      "day": "monday",
      "time": "06:00",
      "timezone": "UTC"
    },
    "delivery": {
      "method": "email",
      "recipients": ["analytics@yourstore.com"],
      "subject": "Weekly CheckoutOS Data Export"
    },
    "date_range": "previous_week"
  }
}

Acesso à API

Para acesso programático, use a API do CheckoutOS:

Solicitação de exportação via API

curl -X GET "https://api.chargezen.com/v1/analytics/export" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "orders",
    "date_from": "2025-01-01",
    "date_to": "2025-01-31",
    "format": "json",
    "fields": ["order_id", "order_total", "checkoutos_revenue"]
  }'

Limites de requisições da API

As solicitações à API de exportação são limitadas a 100 por hora. Para exportações grandes, use o endpoint de exportação assíncrona, que entrega os resultados por webhook.

Exportações por integração

Exporte diretamente para plataformas de terceiros:

Integrações disponíveis

Google Analytics — Envie eventos e transações
Google Sheets — Sincronização automática com planilhas
Mixpanel — Integração de acompanhamento de eventos
Segment — Sincronização com a plataforma de dados de clientes
Looker — Integração com painéis de BI
BigQuery — Exportação para o data warehouse
Shopify Analytics — Integração nativa

Integração com Google Sheets

{
  "integration": {
    "type": "google_sheets",
    "spreadsheet_id": "1abc...xyz",
    "sheet_name": "CheckoutOS Data",
    "sync_frequency": "daily",
    "include_headers": true,
    "append_or_replace": "append"
  }
}

Privacidade dos dados

Ao exportar dados, considere a privacidade:

Considerações de privacidade

Tratamento de dados pessoais identificáveis — Exportar e-mail, nome e endereço exige consentimento
Anonimização — Opção de aplicar hash ou remover identificadores
Controles de acesso — Limite quem pode exportar dados de clientes
Registro de auditoria — Todas as exportações são registradas
Conformidade com o GDPR — O direito à exclusão afeta as exportações

Dados sensíveis

As exportações de dados pessoais identificáveis dos clientes são registradas e podem exigir permissões adicionais. Considere usar exportações anonimizadas quando não precisar de dados detalhados dos clientes.

Boas práticas

Dicas de exportação

Exporte de forma incremental — Exportações diárias são mais fáceis de gerenciar que mensais
Use nomes consistentes — Inclua datas nos nomes dos arquivos
Automatize quando possível — Exportações agendadas reduzem o trabalho manual
Documente suas exportações — Acompanhe quais dados vão para cada destino
Exclua exportações antigas — Não deixe os arquivos se acumularem

Tópicos relacionados

Referência da API

Documentação completa da API

Saiba mais

Relatórios personalizados

Crie relatórios antes de exportar

Saiba mais