Painel do Afiliado

Visão geral do período: cliques, pedidos, itens, comissão (BRL), vendas/GMV (BRL), conversão, EPC e ticket médio — totais e por marketplace (maior comissão primeiro). É o ponto de partida para entender a conta. Conversão/EPC do total consideram só marketplaces com cliques.

Compara o período com outro (default: o período imediatamente anterior, de mesma duração): comissão, vendas, pedidos, cliques, conversão e EPC, com variação absoluta e % no total e por marketplace. Use para "como foi esta semana vs. a passada?" ou "outubro vs. setembro" (informe compare_start_date/compare_end_date).

Compara os marketplaces lado a lado no período (cliques, pedidos, comissão, GMV, EPC, conversão, ticket médio), do que mais rende para o que menos rende. Use para perguntas tipo "qual loja rende mais?".

Comissão, vendas, pedidos e cliques por MÊS, com variação % sobre o mês anterior, no total e por marketplace. `firstDate` depois do dia 1 indica mês incompleto (conexão recente ou início do histórico do plano) — não compare um mês incompleto como se fosse cheio.

Ranking de produtos nas janelas FIXAS de 7 e 30 dias (não aceita período): comissão, pedidos, cliques, EPC ou conversão. Única fonte de cliques/EPC/conversão POR PRODUTO. Para um período escolhido (ex.: "mês passado"), use painel_get_products_by_period.

Produtos que venderam no período escolhido, com pedidos, comissão (BRL) e última venda — sem cancelados. Aceita filtro por marketplace, categoria e nome. Cliques/EPC por produto não existem por período arbitrário (para isso use painel_get_top_products).

Série temporal diária de uma métrica (comissão, pedidos, cliques ou vendas) por marketplace no período. Use para detectar tendências, picos e quedas ao longo dos dias.

Desempenho por etiqueta de rastreamento (sub-IDs unificados entre marketplaces, criados pelo usuário no painel) no período: cliques, pedidos, comissão, conversão e EPC por etiqueta. Use para avaliar campanhas/canais rastreados.

Vendas agrupadas pelo VALOR BRUTO de um nível de sub_id (Shopee Sub_id1..5 e equivalentes): pedidos, itens, comissão e GMV por valor — os 50 de maior comissão. Use quando o afiliado marca campanha/grupo/post no sub_id e ainda não criou etiquetas. `availableLevels` diz quais níveis têm dado.

Comissão e vendas (BRL) por CATEGORIA de produto no período, de todos os marketplaces que informam categoria (as demais vão para "Outros").

Vendas PENDENTES (comissão a receber), NÃO PAGAS da Shopee (unpaid: aguardando pagamento, fora dos totais) e CANCELADAS/não efetivadas (comissão perdida) por marketplace, com taxa de cancelamento e totais. Mercado Livre entra pelo KPI diário de não efetivadas; Amazon não informa status e não entra.

Insights gerados automaticamente pela IA do painel (anomalias, recomendações, tendências, digests), mais recentes primeiro.

Metas de vendas (GMV) do mês corrente que o usuário definiu por marketplace, com o realizado, % atingido, quanto falta e quanto falta por dia até o fim do mês. Na Shopee traz também as faixas do bônus. Lista vazia = nenhuma meta definida (o usuário define em Metas, no painel).

Takes no parameters.

Funil por CANAL de divulgação (Telegram, WhatsApp, Instagram, Websites…): cliques, pedidos, conversão, vendas, comissão e EPC por canal. Fonte: relatórios da Shopee (Canal/Referenciador) e origem do Magalu — marketplaces sem essa dimensão não aparecem.

Distribuição por HORA do dia (0–23, fuso de Brasília): pedidos, itens e comissão por hora (de todos os pedidos com timestamp) e cliques por hora (quando o relatório de cliques informa hora). Use para recomendar horários de postagem.

Pedidos do período agrupados por status normalizado: pending (a receber), confirmed (concluídos), unpaid ("não pago" da Shopee — aguardando pagamento, FORA dos totais, como no relatório da Shopee) e cancelled (cancelados), com itens, comissão e GMV de cada grupo.

Vendas DIRETAS (produto/loja do próprio link) vs INDIRETAS (outro produto/loja comprado após o clique), quebradas por marketplace em `byMarketplace[]`. Fontes: Amazon (relatório de Categorias, em ITENS; sem comissão separada), Shopee ("Tipo de atribuição": mesma loja vs loja diferente, em produtos, COM comissão separada — directCommissionBrl/indirectCommissionBrl) e Mercado Livre (quantity_direct/quantity_not_direct, em pedidos). Cada item traz direct, indirect e directShare (0–1).

Vendas das REDES de afiliados (AWIN, CityAds, Rakuten) quebradas por ANUNCIANTE/programa (ex.: "Kabum BR", "Nike BR") no período: pedidos, itens, comissão e GMV por programa.

Links de afiliado do AliExpress que mais renderam no período (sem cancelados): pedidos, vendas, comissão, compradores distintos e produtos vendidos por link. `coverage` diz quantos pedidos vieram com o link identificado. Só AliExpress (os outros marketplaces não informam o link da venda).

Lista pedidos INDIVIDUAIS no período (paginado, mais recentes primeiro por padrão), com produto, quantidade, venda, comissão, status, referenciador e anunciante. Um pedido com vários itens aparece em várias linhas. Filtros: marketplace, status, busca por nome de produto. Limitação: Amazon e Mercado Livre não têm pedidos individuais (são pré-agregados). Para totais, use painel_get_sales_summary — não some páginas.