Rastreamento de Cliques e Impressões
O módulo Patrocinadores conta automaticamente quantas vezes cada patrocinador é exibido (impressões) e quantas vezes os visitantes clicam no logo ou no botão "Visitar Site" de um patrocinador (cliques). Ambas as contagens são armazenadas como meta post no post do patrocinador e visíveis na tela de edição do patrocinador.
Chaves de Meta
Chave de Meta | Descrição |
| Número total de vezes que este patrocinador foi exibido a um visitante |
| Número total de vezes que um visitante clicou neste patrocinador |
Ambos os valores são somente leitura na interface de administração. Eles aparecem na meta box Detalhes da barra lateral na tela de edição do patrocinador como campos de texto simples rotulados Impressões e Cliques. Os campos são renderizados com readonly="readonly" — eles não podem ser editados manualmente.
Rastreamento de Impressões
As impressões são contadas na função sp_set_post_impressions(). Cada vez que um template de patrocinador é renderizado, esta função é chamada com o ID do post do patrocinador. Ela lê o valor atual de meta sp_impressions, incrementa em 1 e o escreve de volta com update_post_meta().
Se o valor de meta ainda não existir para um patrocinador, ele é inicializado como 0 antes de ser incrementado.
Rastreamento de Cliques
Os cliques são rastreados via uma requisição AJAX acionada por JavaScript quando um visitante clica no logo ou no link "Visitar Site" de um patrocinador. O código do lado do cliente envia uma requisição POST para admin-ajax.php com:
action=sp_clickspost_id= o ID do post do patrocinadornonce= um valor nonce (sp_clicks_{post_id})
O handler do lado do servidor é SportsPress_Sponsors::sp_clicks(). Ele verifica o nonce, depois chama sp_set_post_clicks() que incrementa o valor de meta sp_clicks em 1 usando o mesmo padrão do rastreamento de impressões.
Excluindo Usuários Logados
Duas configurações em SportsPress → Configurações → Patrocinadores controlam se a atividade de usuários logados é contada:
Impressões — Excluir usuários logados (ID da opção:
sportspress_exclude_authenticated_sponsor_impressions, padrão: não) — Quando habilitado,sp_set_post_impressions()retorna antecipadamente seis_user_logged_in()for verdadeiro.Cliques — Excluir usuários logados (ID da opção:
sportspress_exclude_authenticated_sponsor_clicks, padrão: não) — Quando habilitado,sp_set_post_clicks()retorna antecipadamente seis_user_logged_in()for verdadeiro.
Visualizando os Dados
Abra a tela de edição de qualquer patrocinador. A meta box Detalhes da barra lateral mostra as contagens atuais de Impressões e Cliques para aquele patrocinador. Os mesmos valores aparecem como colunas classificáveis na tela de lista de Patrocinadores.