Documentações Oficiais Facebook/Meta

Dashboard Principal

A principal área de análise com gráficos e dados detalhados:

Cards Principais:

Gráficos e Visualizações:

• Vendas por Hora: Gráfico de linha com atualização progressiva ao longo do dia, das 00:00 às 23:59, das quantidades de venda e outra linha para pix gerados.
• Vendas por Produto: Metrificação por produto, com gráficos de rosca com a distribuição percentual, valor total vendido e quantidade total das vendas.
• Conversão por Método de Pagamento: Metrificação por método de pagamento, com boxes comparativos de conversão e faturamento por PIX, Cartão de Crédito e Boleto.
• Gráfico de Funil de Vendas: Mostra as conversões por etapa do funil (front, upsell1, upsell2 etc.), com base nas tags cadastradas na aba "Produtos".

Estrutura Organizacional

Dividido em 4 setores:

• Contas de Anúncio
• Campanhas
• Conjuntos
• Anúncios

Ações Individuais:

• Ativar/desativar
• Editar nome
• Ver métricas da última hora cheia (linha adicional)
• Ver métricas detalhadas do dia (abre modal lateral)
• Fixar linha no topo
• Renomear
• Editar orçamento

Filtros Disponíveis:

• Filtro por Data: Selecionar período específico de análise
• Filtro por Produto: Filtrar campanhas relacionadas a produtos específicos
• Filtro por Conta de Anúncio: Selecionar contas específicas para visualização
• Filtro por Nome: Buscar campanhas, conjuntos ou anúncios por nome

Ações em Massa:

• Ativar / Desativar
• Duplicar
• Alterar orçamento
• Modo comparativo (adiciona linha com dados da última hora)
• Configurar colunas visíveis
• Excluir
• Editar orçamento
• Copiar ID (útil para debug avançado)

Botão de Engrenagem (Configuração de Colunas):

Permite personalizar as colunas exibidas no gerenciador de campanhas:

• Adicionar Colunas: Incluir métricas adicionais disponíveis na API do Facebook
• Remover Colunas: Ocultar colunas que não são relevantes para o usuário
• Reordenar Colunas: Organizar a sequência de exibição das métricas
• Salvar Layout: Manter a configuração personalizada para futuras sessões

Step 1 (Configuração Geral):

• Nome da Regra
• Produto (filtro por produtos específicos)
• Contas (filtro por contas de anúncio)
• Aplicar regra a: campanhas ativas/inativas, conjuntos ativos/inativos ou anúncios ativos/inativos
• Filtro por nome da campanha/conjunto/anúncio

Step 2 (Ação e Condição):

• Ações: desligar, ligar, aumentar orçamento, diminuir orçamento
• Orçamento pode ser ajustado por valor fixo ou percentual
• Condições: comparar métricas com valores (maior que, menor que, maior/igual, menor/igual)

Step 3 (Tempo):

• Período de cálculo: dados de hoje, últimos 2 dias etc.
• Frequência de execução: ex. a cada 10 minutos / a cada 30 minutos / a cada hora
• Período de execução: podendo escolher períodos de horários em que a regra é ativa, mas por padrão vindo o dia inteiro
• Limite de execuções por dia

Exportar e Importar Regras de Automação:

Funcionalidade para compartilhar e reutilizar configurações de automação entre usuários e contas.

Exportar Regras:

• Salvar Configuração: Salvar a regra de automação atual em nosso sistema
• ID Único: Geramos um ID único que representa aquela configuração específica
• Compartilhamento: Usuário pode compartilhar o ID com amigos ou outras contas

Importar Regras:

• Por ID: Inserir o ID da regra compartilhada para importar automaticamente
• Por CSV: Aceitar arquivos CSV no padrão do UTMify (concorrente)
• Compatibilidade: Sistema converte automaticamente o formato UTMify para nosso padrão
• Validação: Verificação automática da estrutura e dados do arquivo

Padrão UTMify Suportado:

• Estrutura CSV: Colunas padrão do UTMify para regras de automação
• Conversão Automática: Mapeamento inteligente dos campos para nossa plataforma
• Migração Facilitada: Usuários podem migrar facilmente do UTMify para o Bullster
• Preservação de Dados: Mantém toda a lógica e configurações das regras

Anúncios (Perfis do Facebook)

Essa seção é responsável por conectar o perfil do Facebook do usuário ao aplicativo oficial da Bullster na Meta. Com essa integração, conseguimos:

• Exibir os perfis conectados
• Listar as contas de anúncio associadas
• Acessar e gerenciar campanhas, conjuntos e anúncios diretamente da plataforma

Permissões solicitadas:

Para funcionar corretamente, o aplicativo da Meta solicitará as seguintes permissões:

• email
• read_insights
• pages_show_list
• ads_management
• ads_read
• business_management
• pages_read_engagement
• pages_read_user_content
• pages_manage_ads

Funcionalidades:

• Produtos não podem ser manualmente adicionados ou removidos
• Tags padrão: Front, Upsell 1, Upsell 2, Upsell 3
• Usuário pode adicionar tags aos produtos
• Tags são usadas para construir o gráfico de funil na dashboard

Integração Automática:

O sistema adiciona novos produtos automaticamente ao detectar uma nova venda via webhook da plataforma integrada.

Configuração de Taxas:

• Tipo: percentual (%) ou valor fixo (R$) por venda
• A cada venda, o valor da taxa cadastrada é descontado do faturamento bruto
• Gera o valor do Faturamento Líquido

Comportamento Padrão:

Caso não exista nenhuma taxa, no Faturamento Líquido será exibido o valor do somatório das vendas recebidas normalmente, sem nenhum desconto.

Funcionalidades:

• Filtro por tipo de UTM: utm_campaign, utm_source, utm_medium, utm_content, utm_term
• Seção separada para vendas não trackeadas
• Acesso rápido para vendas não trackeadas diretamente da aba Campanhas

Etapas de Configuração:

1. Contas

Selecionar as contas integradas à dashboard

2. Pixels

Selecionar os pixels que serão rastreados

3. Checkout

Selecionar os checkouts usados para vendas

4. Resumo

• Visualização da configuração atual
• Exibição do endpoint de webhook
• Exibição do script de integração do funil
• Teste de integração

Teste de Integração:

• Usuário informa URL do funil
• Sistema abre popup com parâmetro de teste
• Usuário realiza simulação de venda
• Se identificarmos o parâmetro no webhook da venda, a integração é confirmada
• Caso contrário, exibimos que a integração falhou

Planos Disponíveis:

Descontos por Periodicidade:

• Mensal: valor cheio sem desconto
• Trimestral: 10% de desconto
• Semestral: 15% de desconto
• Anual: 25% de desconto

Exibição Dinâmica do Progresso:

• Mostramos uma barra de progresso indicando o faturamento total atual da conta do usuário
• Abaixo da barra, exibimos quanto falta para atingir a próxima meta de faturamento
• O usuário também verá um contador de quantas conquistas já desbloqueou

Conquistas por Faturamento:

Cada conquista representa um marco de faturamento:

• R$ 100.000
• R$ 500.000
• R$ 1.000.000
• R$ 5.000.000
• R$ 10.000.000

Visualização das Etapas:

• Cada etapa aparece em uma box separada, exibindo as imagens das plaquinhas de faturamento
• As etapas ainda não conquistadas aparecem bloqueadas 🔒
• Indicamos exatamente quantos reais faltam para desbloqueá-las

Estrutura do Suporte:

Ela é composta por uma série de boxes de vídeos tutoriais, sem mais complicações.

Cada box inclui:

• Um título claro (ex: "Como conectar sua conta de anúncio")
• Uma descrição curta do conteúdo abordado
• Um player de vídeo embutido (ou link para assistí-lo)
• Exibe o tipo do vídeo, se é tutorial para Campanhas, ou se é para Integrações, entre outros
• E também o tempo total do vídeo

Objetivo Principal:

Garantir que qualquer usuário, mesmo sem experiência anterior, consiga configurar e utilizar o sistema com facilidade.

Funcionalidade:

Indique o Bullster para seus amigos e ganhe 10% de comissão recorrente sobre todas as assinaturas ativas durante 6 meses!

Link de Indicação:

Logo no topo da página estará disponível o link exclusivo de indicação do usuário. Ele poderá copiar e compartilhar esse link livremente com quem quiser.

Cards Resumo:

Abaixo do link de indicação, serão exibidos 4 cards principais que acompanham o progresso e ganhos do usuário:

• Cadastros Ativos – Número total de pessoas que se cadastraram usando o link de indicação
• Assinaturas Ativas – Quantidade de indicados que possuem uma assinatura ativa no momento
• Saldo a Receber – Total acumulado de comissões ainda não disponíveis
• Disponível para Sacar – Quantia já liberada para saque

Tabelas Informativas:

Ao final da seção, teremos duas tabelas:

• Tabela de Indicados – Mostra nome, data de cadastro, status da assinatura e valor acumulado de comissão por indicado
• Histórico de Saques – Exibe a lista completa dos saques realizados pelo usuário, com data, valor e status do pagamento

Informações exibidas:

• E-mail cadastrado (exibição apenas – não pode ser alterado diretamente)
• Senha (com opção de alteração por meio de campo de redefinição)
• Celular (campo editável)
• Apelido (campo editável)

Controle de privacidade:

• Switch com a opção: "Aparecer no ranking público"
• Quando ativado, o apelido será exibido no ranking da dashboard inicial
• Importante: no ranking será mostrado apenas o faturamento total, sem divulgar qualquer outra informação pessoal ou operacional

Objetivo:

Essa página visa garantir transparência ao usuário sobre como suas informações são utilizadas, oferecendo controle e personalização da própria conta.

Estrutura dos Planos:

Nossos planos funcionam com um valor mensal fixo e um limite de vendas aprovadas por mês. Caso esse limite seja extrapolado, o usuário não é cancelado ou travado, mas sim cobrado um valor adicional por venda extra.

Exemplo de Funcionamento:

• Plano Premium (R$99,90/mês): Limite de 1.000 vendas aprovadas por mês
• Vendas Extras: R$0,15 por venda adicional após o limite

Sistema de Cobrança:

• Cobrança Recorrente: Renovação automática mensal do valor base do plano
• Cobrança de Vendas Extras: Calculada e cobrada 1 vez por semana, para não deixar acumular.
• Histórico de Pagamentos: Todos os pagamentos são salvos e registrados para auditoria
• Notificações: Usuário é notificado sobre vendas extras e cobranças adicionais

Vantagens do Sistema:

• Flexibilidade: Usuário pode exceder o limite sem interrupção do serviço
• Transparência: Cobrança clara e previsível por venda extra
• Escalabilidade: Sistema se adapta ao crescimento do usuário
• Continuidade: Sem interrupções por atingir limites

Cards Principais:

• Exibição de 8 cards principais com dados filtrados por padrão para o mês atual
• Total de usuários cadastrados, assinaturas ativas, receita total da plataforma
• Taxa de conversão geral, novos usuários do mês, churn rate
• MRR (Receita Recorrente Mensal), produtos ativos

Gráficos e Relatórios:

• Gráfico com os dados enviados para o Facebook ao longo das horas do dia
• Dois gráficos comparativos: Top 5 produtos mais vendidos e Top 5 contas da plataforma
• Tabela de usuários recentes e gráfico de pizza com distribuição percentual dos planos
• Seção de Health do sistema, exibindo o status dos principais serviços

Funcionalidades:

• Tabela completa de todos os usuários cadastrados
• Apelido, e-mail, status da assinatura, tipo de plano, data de cadastro, último login
• Botões de ação: Bloquear conta, Acessar dados da conta
• Ao clicar em "Acessar dados", é aberta uma tela dedicada com todas as informações

Funcionalidades:

• Tabelão listando todos os produtos da plataforma
• Nome, total de vendas, receita gerada, taxa de conversão

Funcionalidades:

• Tabela com todas as assinaturas ativas e inativas
• Nome do usuário e e-mail, tipo e ciclo do plano, data de início da assinatura
• Próxima cobrança, forma de pagamento utilizada

Funcionalidades:

• Tabela listando todos os pixels da plataforma
• Nome do pixel, total de eventos enviados, total de conversões, dono (nome + e-mail)

Funcionalidades:

• Tabela de faturamento total dos usuários
• Nome, e-mail, total faturado, tipo de plano, data da última venda

Funcionalidades:

• Upload de banners e imagens do sistema
• Upload de vídeos tutoriais e de onboarding
• Edição dos conteúdos exibidos na seção de Suporte

Funcionalidades:

• Tabela com as solicitações de saque feitas pelos usuários
• Nome e e-mail, valor solicitado, status (Pago ou Não Pago)
• Ação para marcar como "pago" ou "não pago", filtro por status