Alertas e Conciliação no cPixel
Como o cPixel me avisa que o rastreamento quebrou?
O cPixel lista os problemas na página Início, em Precisa da sua atenção, e envia um e-mail para o endereço de contato da sua loja Shopify sobre os críticos: um token de acesso rejeitado, os pedidos do plano Free esgotados, ou pedidos que continuam chegando depois de 24 horas sem eventos da loja. Suas verificações rodam todas as noites. Nos planos pagos, a Conciliação compara seus pedidos da Shopify com o que cada plataforma recebeu.
Somente o alerta do Meta aqui é enviado por e-mail; um evento rejeitado é um aviso.
Quais alertas chegam por e-mail, e onde?
Somente os alertas críticos são enviados por e-mail, no máximo uma vez por dia para cada tipo; os demais ficam no app.
| Alerta | O que dispara | Enviado por e-mail |
|---|---|---|
| Token de acesso inválido | Uma plataforma rejeita o token em um envio, ou na reverificação noturna de uma conta inativa há 7 dias; os envios do servidor dessa conta param até você reconectar | Sim |
| Sem eventos da loja | Os pedidos continuam chegando, mas não há eventos da loja há 24 horas | Sim |
| Pedidos do plano Free esgotados | A franquia mensal do Free foi usada, então os envios do servidor pausam | Sim |
| 80% e 95% dos pedidos mensais | Os pedidos atingem essa fração da franquia do seu plano | Não |
| Envio descartado | Uma plataforma recusa um evento de imediato, ou cinco tentativas falham | Não |
| App embed desligado | Você publica um tema com o app embed do cPixel desligado | Não |
| Pedidos de fora do seu checkout online | Pedidos de PDV, rascunho ou API chegam enquanto o cPixel os ignora | Não |
| Outro remetente encontrado | A varredura diária da loja encontra outro rastreamento para uma plataforma à qual o cPixel envia | Não |
Os e-mails vêm do cPixel, em inglês, para o e-mail de contato da sua loja na Shopify. Cada um diz o que quebrou e traz um link para o app, sem dados de eventos ou detalhes de clientes. O cPixel aprende o endereço quando você abre o app pela primeira vez e quando os dados da sua loja mudam, então uma loja que nunca abriu o cPixel pode não receber nenhum. Não há um endereço separado para configurar.
Dica: Não recebeu e-mail? Verifique sua pasta de spam; todo alerta também aparece no Início.
Com que frequência o cPixel verifica?
Uma vez por noite, às 03h00 UTC, o cPixel procura lojas silenciosas, reverifica tokens de contas inativas, faz uma varredura por outro rastreamento e fecha a Conciliação. Não é um monitoramento contínuo.
As falhas de envio são registradas no momento em que o cPixel envia, não à noite; as temporárias, como um limite de taxa, são tentadas novamente cinco vezes primeiro, em intervalos de um minuto a seis horas.
Os avisos se fecham sozinhos após 7 dias sem recorrência. Os alertas críticos ficam até você dispensá-los, e um alerta de token também se fecha quando Testar conexão passa. Um alerta dispensado volta se o problema voltar.
O que devo fazer quando um alerta chega?
O botão de cada alerta, como Abrir configurações, abre a página que resolve o problema; os três alertas críticos exigem uma ação sua.
Um token de acesso rejeitado
A plataforma recusou o token como inválido, por exemplo porque foi revogado ou expirou. Os envios do servidor para essa conta param até você substituí-lo, e o rastreamento pelo navegador continua rodando. Para o Meta, somente uma resposta de token inválido gera esse alerta; outras recusas, como um erro de permissão, aparecem como aviso, e os envios seguintes continuam.
- No Início, clique em Corrigir Meta (ou o nome da sua plataforma), ou em Abrir configurações no alerta.
- Crie um novo token nas ferramentas da própria plataforma. Para o Meta, veja como substituir um token do Meta rejeitado; cada doc de conexão cobre sua plataforma.
- Cole-o no campo do token, que mostra Salvo — cole um novo para substituir.
- Clique em Continuar, depois em Salvar e continuar. Os envios do servidor para essa conta são retomados.
Para confirmar, rode Testar conexão antes de salvar (Meta e TikTok exigem um código de evento de teste), ou acompanhe cada envio no Ao vivo.
Pedidos chegando sem eventos da loja
O pixel do cPixel parou de reportar a partir da sua loja. Inicie uma sessão em Ao vivo e navegue pela sua loja em outra aba. Se nada chegar, verifique se a Shopify ainda lista o pixel cPixel em Settings → Customer events, depois entre em contato com o suporte por Obter ajuda no Início.
Os pedidos do plano Free se esgotaram
Os envios do servidor pausam até o mês reiniciar; o rastreamento pelo navegador continua. Para retomar agora, mude para um plano pago em Ver plano.
O que a Conciliação mostra?
A Conciliação compara seus pedidos da Shopify com o que os envios do servidor do cPixel entregaram a cada plataforma, nos últimos 30 dias completos. Está disponível em todo plano pago. Os dias são em UTC e fecham durante a noite, então os pedidos de hoje aparecem amanhã.
| Seção | O que ela mostra |
|---|---|
| Recuperado pelo rastreamento no servidor | Pedidos pagos que seu pixel não reportou e que uma plataforma aceitou vindos do servidor do cPixel: quantidade, fração dos pedidos mensuráveis e valor dos pedidos |
| Para onde foram seus pedidos | Todo pedido, como Seu pixel informou, Recuperados por nós, Não chegaram a nenhuma plataforma ou Não mensurável |
| Entrega por conta | Aceitos, Falharam, Ignorados e Taxa de aceitação por conta. Ignorados significa que o cPixel optou por não enviar (consentimento recusado, ou franquia esgotada) |
| Por dia | Os mesmos números por dia em UTC |
| Receita por clique em anúncio | Pedidos que chegam com um clique de anúncio do Meta, OpenAI Ads, TikTok ou outra plataforma. Um pedido com cliques de duas plataformas conta nas duas, então as linhas não somam; não é atribuição |
Um traço significa que o cPixel não conseguiu medir, não zero: dias pausados, e pedidos de PDV, rascunho e API, não têm lado do navegador para comparar. Exportar CSV e Exportar JSON baixam os números.
Nenhum alerta dispara quando os números não batem: é uma página que você mesmo verifica. No Free, ela mostra A conciliação faz parte do plano pago. No Starter e no Growth, ela trava 72 horas depois que você ultrapassa a franquia mensal, até você subir de plano ou um novo ciclo de 30 dias começar; o envio continua normalmente.
Por que nem todo pedido perdido pode ser recuperado?
O cPixel só consegue enviar o que a Shopify e o navegador do comprador lhe deram, enquanto a plataforma ainda aceitar.
- Consentimento: uma recusa registrada no checkout é respeitada.
- Regras de pedido: pedidos de teste, cancelados, de PDV, rascunho e API são ignorados por padrão (regras de pedido).
- GA4: sem a sessão do navegador do checkout, o Ao vivo mostra “Dados insuficientes para montar o payload deste destino”.
- Google Ads: é só pelo navegador, então uma tag bloqueada não deixa nada para reenviar.
- Limites de tempo: as novas tentativas, e os pedidos retidos enquanto o Free estava pausado, vão apenas para plataformas cuja janela ainda está aberta.
- Notificações perdidas: toda noite o cPixel reenvia os pedidos pagos de ontem que a Shopify nunca reportou a ele; lacunas mais antigas permanecem.
- Pedidos anteriores: pedidos de antes de você instalar o cPixel ou conectar uma plataforma nunca são enviados.
