Alertas e Reconciliação no cPixel
Como me diz o cPixel que o rastreio falhou?
O cPixel lista problemas na sua página Início em Precisa da sua atenção e envia um e-mail para o endereço de contacto da sua loja Shopify sobre os críticos: um token de acesso rejeitado, as encomendas do plano Free esgotadas, ou encomendas a continuarem a chegar depois de 24 horas sem eventos da loja. As suas verificações correm todas as noites. Nos planos pagos, a Reconciliação compara as suas encomendas do Shopify com o que cada plataforma recebeu.
Só o alerta do Meta aqui é enviado por e-mail; um evento rejeitado é um aviso.
Que alertas chegam por e-mail, e onde?
Só os alertas críticos são enviados por e-mail, no máximo uma vez por dia para cada tipo; o resto fica na aplicação.
| Alerta | O que o desencadeia | Enviado por e-mail |
|---|---|---|
| Token de acesso inválido | Uma plataforma rejeita o token num envio, ou na reverificação noturna de uma conta inativa há 7 dias; os seus envios do servidor param até voltar a ligar | Sim |
| Sem eventos da loja | As encomendas continuam a chegar, mas sem eventos da loja durante 24 horas | Sim |
| Encomendas do plano Free esgotadas | A quota mensal do Free esgotou-se, por isso os envios do servidor pausam | Sim |
| 80% e 95% das encomendas mensais | As encomendas chegam a essa parte da quota do seu plano | Não |
| Envio falhado | Uma plataforma recusa um evento de vez, ou cinco tentativas falham | Não |
| App embed desligado | Publica um tema com o app embed do cPixel desligado | Não |
| Encomendas fora do seu checkout online | Chegam encomendas de POS, rascunho ou API enquanto o cPixel as ignora | Não |
| Outro emissor encontrado | O rastreio diário da loja encontra outro rastreio para uma plataforma a que o cPixel envia | Não |
Os e-mails vêm do cPixel, em inglês, para o e-mail de contacto da sua loja no Shopify. Cada um diz o que falhou e liga para dentro da aplicação, sem dados de eventos nem detalhes de clientes. O cPixel aprende o endereço quando abre a aplicação pela primeira vez e quando os detalhes da sua loja mudam, por isso uma loja que nunca abriu o cPixel pode não receber nenhum. Não há um endereço separado para definir.
Dica: Sem e-mail? Verifique a pasta de spam; todos os alertas também estão em Início.
Com que frequência verifica o cPixel?
Uma vez por noite, às 03:00 UTC, o cPixel procura lojas silenciosas, reverifica tokens em contas inativas, procura outro rastreio e fecha a Reconciliação. Não é uma monitorização contínua.
As falhas de envio são registadas quando o cPixel envia, não à noite; as temporárias, como um limite de taxa, são primeiro repetidas cinco vezes, com intervalos de um minuto a seis horas.
Os avisos fecham-se sozinhos passados 7 dias sem reincidência. Os alertas críticos ficam até os dispensar, e um alerta de token também fecha quando Testar ligação passa. Um alerta dispensado regressa se o problema regressar.
O que devo fazer quando chega um alerta?
O botão de cada alerta, como Abrir definições, abre a página que o corrige; os três alertas críticos precisam de 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é o substituir, e o rastreio no navegador continua a funcionar. Para o Meta, só uma resposta de token inválido dispara este alerta; outras recusas, como um erro de permissão, aparecem como um aviso e os envios seguintes continuam.
- Em Início, clique em Corrigir Meta (ou o nome da sua plataforma), ou Abrir definições no alerta.
- Crie um novo token nas próprias ferramentas da plataforma. Para o Meta, veja substituir um token do Meta rejeitado; cada guia de ligação cobre a sua plataforma.
- Cole-o no campo do token, que lê Guardado — cole um novo para o substituir.
- Clique em Continuar, depois Guardar e continuar. Os envios do servidor para essa conta retomam.
Para confirmar, execute Testar ligação antes de guardar (o Meta e o TikTok precisam de um código de evento de teste), ou veja cada envio no Direto.
Encomendas mas sem eventos da loja
O pixel do cPixel deixou de reportar a partir da sua loja. Inicie uma sessão em Direto e navegue na sua loja noutro separador. Se nada chegar, verifique que o Shopify ainda lista o pixel cPixel em Settings → Customer events, depois contacte o suporte em Obter ajuda no Início.
As encomendas do plano Free esgotaram-se
Os envios do servidor pausam até o mês reiniciar; o rastreio no navegador continua. Para retomar já, mude para um plano pago em Ver plano.
O que mostra a Reconciliação?
A Reconciliação compara as suas encomendas do Shopify com o que os envios do servidor do cPixel entregaram a cada plataforma, ao longo dos últimos 30 dias inteiros. Está em todos os planos pagos. Os dias são em UTC e fecham durante a noite, por isso as encomendas de hoje aparecem amanhã.
| Secção | O que mostra |
|---|---|
| Recuperado pelo rastreio do lado do servidor | Encomendas pagas que o seu pixel não reportou e que uma plataforma aceitou do servidor do cPixel: contagem, parte das encomendas mensuráveis, e valor da encomenda |
| Para onde foram as suas encomendas | Cada encomenda, como O seu pixel reportou-a, Recuperado por nós, Não chegou a nenhuma plataforma ou Não mensurável |
| Envios por conta | Aceites, Falhados, Ignorados e Taxa de aceitação por conta. Ignorados significa que o cPixel optou por não enviar (consentimento recusado, ou quota esgotada) |
| Por dia | Os mesmos números por dia UTC |
| Receita por clique de anúncio | Encomendas que chegam com um clique de anúncio do Meta, OpenAI Ads, TikTok ou outra plataforma. Uma encomenda com cliques de duas plataformas conta em ambas, por isso as linhas não somam; não é atribuição |
Um traço significa que o cPixel não conseguiu medir, não zero: os dias em pausa, e as encomendas de POS, rascunho e API, não têm lado de navegador para comparar. Exportar CSV e Exportar JSON descarregam os números.
Nenhum alerta dispara quando os números não coincidem: é uma página que verifica. No Free lê A Reconciliação faz parte dos planos pagos. No Starter e no Growth bloqueia 72 horas depois de passar a quota mensal, até mudar para um plano superior ou começar um novo ciclo de 30 dias; o envio continua.
Porque é que nem toda a encomenda em falta pode ser recuperada?
O cPixel só consegue enviar o que o Shopify e o navegador do comprador lhe deram, enquanto a plataforma ainda o aceitar.
- Consentimento: uma recusa registada no checkout é respeitada.
- Regras de encomendas: as encomendas de teste, canceladas, POS, rascunho e API são ignoradas por predefinição (regras de encomendas).
- GA4: sem a sessão de navegador do checkout, o Direto mostra “Dados insuficientes para construir o payload deste destino”.
- Google Ads: é só do navegador, por isso uma tag bloqueada não deixa nada para reenviar.
- Limites de tempo: as repetições, e as encomendas retidas enquanto o Free estava em pausa, só vão para plataformas cuja janela ainda esteja aberta.
- Notificações perdidas: todas as noites o cPixel reenvia as encomendas pagas de ontem que o Shopify nunca lhe reportou; as lacunas mais antigas ficam.
- Encomendas anteriores: encomendas de antes de instalar o cPixel ou ligar uma plataforma nunca são enviadas.
