Pixel do Afiliado

Atualiza os url_tags de um anúncio (ad) Meta — por exemplo para colocar os parâmetros do link rastreado. NÃO gera o link (isso é só no painel): recebe os url_tags prontos. DRY-RUN com dry_run:true. Requer plano Pro.

Detalha UMA campanha Meta a partir do cache: status efetivo, objetivo e orçamento diário (centavos de BRL). Informe o ID externo da campanha (descubra com pixel_get_campaigns).

Lista as campanhas Meta espelhadas no cache da conta (id externo, nome, status efetivo, objetivo e orçamento diário em centavos). Paginação: total/count/offset/has_more/next_offset.

Estado do envio de eventos ao Meta CAPI: contagem por status de entrega (sent/pending/failed) e os eventos mais recentes (event_id = conversionId garante dedup no Meta).

Comissão (centavos de BRL) no período quebrada por campanha Meta, com pedidos, itens, GMV, spend e ROAS (basis points). netCommission == totalCommission (afiliado direto).

Lista SÓ as conversões com clique CASADO (atribuição completa: clique → venda), com campanha/adset/ad herdados do clique e o status de envio ao CAPI. Para a lista completa de vendas (inclusive sem clique), use pixel_get_shopee_sales. Paginação: total/count/offset/has_more.

Série temporal diária de uma métrica no período (para detectar tendências/anomalias). Métricas: commission, orders, clicks, spend (valores em centavos quando monetários).

Visão geral da conta no período: investimento (spend Meta), cliques rastreados, vendas Shopee, comissão, ROAS, EPC e taxa de conversão. Valores monetários em centavos de BRL.

Lista os links rastreados da conta com o PRODUTO detectado de cada um. Por link: apelido (label), URL (https://…/r/{slug}), modo (edge=rastreado | static=estático), campanha/adset/ad associados, cliques (total + último) e o produto da Shopee (nome, imagem, preço em centavos, comissão em basis points, disponibilidade e quando foi checado). Filtros por status e campanha; paginação total/count/offset/has_more/next_offset.

Lista os produtos vendidos no período (por productId): itens, pedidos, comissão e GMV em centavos. Útil para descobrir os itens que mais geram comissão a partir do tráfego pago.

Calcula o ROAS (comissão ÷ spend Meta) no período, por nível (campaign/adset/ad). Inclui spend, comissão, GMV (centavos), pedidos, cliques e derivadas em basis points. Base para escalar/pausar.

Lista TODAS as vendas Shopee rastreadas do período (grão = item da conversão), inclusive as sem clique casado. Mostra status, GMV e comissão (centavos) e a atribuição (campaign/adset/ad) quando disponível. Paginação: total/count/offset/has_more/next_offset.

Pausa uma campanha Meta (status PAUSED). DRY-RUN com dry_run:true (mostra o efeito sem aplicar); executa somente quando dry_run for false. Requer plano Pro para executar.

Enfileira (ou reenfileira) os eventos Purchase/Refund elegíveis ao Meta CAPI da org. O dedup por event_id=conversionId garante idempotência (reenvio não duplica). DRY-RUN com dry_run:true. Requer plano Pro.

Reativa uma campanha Meta (status ACTIVE). DRY-RUN por padrão; executa só com dry_run:false. Requer plano Pro para executar.

Dispara um evento de teste ao Meta CAPI usando test_event_code (aparece em Test Events do Gerenciador de Eventos; NÃO afeta produção/otimização). Útil para validar a integração do Pixel/CAPI.

Altera o orçamento DIÁRIO de uma campanha (CBO) ou adset Meta. Valor em CENTAVOS de BRL (integer > 0). DRY-RUN por padrão; executa só com dry_run:false. Requer plano Pro.

Enfileira o pipeline de sincronização (pull Shopee → match → produto → insights Meta → push CAPI → agregação), o mesmo do "Sincronizar agora" do painel. ASSÍNCRONO: responde imediatamente e a cadeia roda em ~1–2 min; consulte pixel_get_dashboard_summary depois. Liberado a partir do plano Starter.