O AffiliateWP funciona com cache?

O cache afeta o rastreamento de indicações do AffiliateWP? Embora o cache seja essencial para sites de carregamento rápido, ele pode, às vezes, interferir no rastreamento se não for configurado corretamente. O AffiliateWP foi projetado para funcionar com a maioria das soluções de cache, muitas vezes sem a necessidade de alterações. No entanto, se as visitas ou indicações não estiverem sendo rastreadas corretamente, alguns ajustes podem ser necessários.

Este guia fornece etapas específicas do plugin para garantir o rastreamento preciso, mantendo o desempenho do site.

Como o Cache Afeta o Rastreamento

O AffiliateWP usa cookies para rastrear visitas, indicações e campanhas. Se os sistemas de cache lidarem incorretamente com esses cookies, problemas de rastreamento podem ocorrer. Os três principais cookies que o AffiliateWP usa são:

• affwp_ref – Armazena o ID do afiliado.
• affwp_ref_visit_id – Rastreia o ID da visita.
• affwp_campaign – Registra nomes de campanha para rastrear esforços de marketing específicos.

Para sites hospedados no Pantheon, Cloudflare ou plataformas semelhantes, o AffiliateWP ajusta automaticamente os nomes dos cookies para cumprir as políticas da plataforma. Por exemplo, no Pantheon, os cookies são prefixados com wp_, resultando em wp_affwp_ref, wp_affwp_ref_visit_id e wp_affwp_campaign. Excluir esses cookies do cache garante o rastreamento preciso de afiliados.

Você também deve excluir URLs específicas relacionadas ao AffiliateWP, como a Área do Afiliado, páginas de registro e login, bem como o script de rastreamento do AffiliateWP (/wp-content/plugins/affiliate-wp/assets/js/tracking.min.js).

Ajustes de Cache Específicos do Plugin

WP Rocket

Para garantir o rastreamento adequado com o WP Rocket:

• Navegue até Painel » Configurações » WP Rocket » Regras Avançadas.
• No campo Nunca cache URLs, adicione os slugs para a Área do Afiliado, páginas de registro e login.
• Adicione cada um dos três cookies (affwp_ref, affwp_ref_visit_id e affwp_campaign) no campo Nunca cache cookies, um por linha.
• Salve as alterações e limpe todos os caches.

Além disso, o WP Rocket permite desativar o cache por página nas configurações da barra lateral para páginas que apresentam problemas específicos.

NitroPack

Para ajustar o cache no NitroPack:

• Faça login no painel do NitroPack e abra a guia Configurações.
• Ative a opção URLs Excluídas e adicione as URLs da Área do Afiliado, páginas de registro e login.
• Role para baixo até Cookies Excluídos, ative-o e adicione os cookies affwp_ref, affwp_ref_visit_id e affwp_campaign.
• Salve as alterações e clique no botão Limpar Cache no painel principal.

WP Fastest Cache

Para usuários do WP Fastest Cache:

• Abra a guia Painel » WP Fastest Cache » Excluir.
• Use o botão Adicionar Nova Regra para excluir páginas relacionadas ao AffiliateWP.
• Da mesma forma, exclua os cookies affwp_ref, affwp_ref_visit_id e affwp_campaign adicionando-os como regras separadas.
• Salve as alterações e limpe todos os caches.

Breeze

Para configurar o Breeze:

• Vá para Painel » Configurações » Breeze » Opções Avançadas.
• Adicione URLs relacionadas ao AffiliateWP ao campo Nunca cache estas URLs.
• O Breeze não suporta exclusões de cookies nativamente. Se necessário, entre em contato com a equipe de suporte do Breeze ou, para usuários do Cloudways, ajuste as exclusões de cookies nas configurações do Varnish. Consulte o Guia de Exclusão de Cookies do Varnish do Cloudways.
• Salve as alterações e certifique-se de que a opção Auto Purge Varnish esteja ativada.

LiteSpeed Cache

No LiteSpeed Cache:

• Navegue até Painel » LiteSpeed Cache » Cache » Exclusões.
• Adicione os slugs de página relacionados ao AffiliateWP ao campo Não Cacher URIs.
• Insira os cookies affwp_ref, affwp_ref_visit_id e affwp_campaign no campo Não Cacher Cookies.
• Salve as configurações e limpe todos os caches.

W3 Total Cache

Para o W3 Total Cache:

• Abra Painel » Performance » Page Cache.
• Adicione os slugs de página relacionados ao AffiliateWP ao campo Nunca cache as seguintes páginas.
• Insira os cookies affwp_ref, affwp_ref_visit_id e affwp_campaign no campo Cookies rejeitados.
• Salve suas configurações e limpe todos os caches.

Cloudflare

Se você estiver usando o Cloudflare sem um plano enterprise, o AffiliateWP pode gerar nomes de cookie compatíveis com a plataforma (wp_affwp_ref, etc.). Para implementar totalmente o bypass de cookies no Cloudflare, você precisará adicionar código personalizado ao arquivo functions.php do seu tema ou a um plugin de snippet de código.

Para ativar nomes de cookie compatíveis com o Cloudflare, use:

add_filter( 'affwp_tracking_cookie_compat_mode', '__return_true' );

Para integração com WooCommerce, inclua:

add_filter( 'affwp_get_referring_affiliate_id', function( $affiliate_id, $reference, $context ) {
   if ( 'woocommerce' === $context ) {
      $affiliate_id = affiliate_wp()->tracking->get_affiliate_id();
   }
   return $affiliate_id;
}, 10, 3 );

Para integrações sem WooCommerce, use isto em vez disso:

add_filter( 'affwp_get_referring_affiliate_id', function( $affiliate_id, $reference, $context ) {
   $affiliate_id = affiliate_wp()->tracking->get_affiliate_id();
   return $affiliate_id;
}, 10, 3 );

Testes e Solução de Problemas

Após excluir cookies e URLs, limpe todos os caches e teste o sistema clicando em um link de referência e concluindo uma compra de teste. Se o rastreamento ainda não estiver funcionando como esperado, verifique camadas de cache adicionais (por exemplo, cache em nível de servidor) e desative otimizações de script que afetam o script de rastreamento do AffiliateWP.

Perguntas Frequentes

---

É isso! O AffiliateWP funciona perfeitamente com o cache quando configurado corretamente. Ao excluir cookies, URLs e scripts essenciais, você pode manter o desempenho ideal do site, garantindo o rastreamento preciso de afiliados.