¿Funciona AffiliateWP con el almacenamiento en caché?

¿Afecta la caché al seguimiento de referidos de AffiliateWP? Si bien la caché es esencial para sitios web de carga rápida, a veces puede interferir con el seguimiento si no se configura correctamente. AffiliateWP está diseñado para funcionar con la mayoría de las soluciones de caché, a menudo sin necesidad de cambios. Sin embargo, si las visitas o los referidos no se rastrean correctamente, puede ser necesario realizar algunos ajustes.

Esta guía proporciona pasos específicos del plugin para garantizar un seguimiento preciso manteniendo el rendimiento del sitio.

Cómo afecta la caché al seguimiento

AffiliateWP utiliza cookies para rastrear visitas, referidos y campañas. Si los sistemas de caché manejan estas cookies de forma incorrecta, pueden producirse problemas de seguimiento. Las tres cookies principales que utiliza AffiliateWP son:

• affwp_ref – Almacena el ID del afiliado.
• affwp_ref_visit_id – Rastrea el ID de la visita.
• affwp_campaign – Registra los nombres de las campañas para rastrear esfuerzos de marketing específicos.

Para sitios alojados en Pantheon, Cloudflare o plataformas similares, AffiliateWP ajusta automáticamente los nombres de las cookies para cumplir con las políticas de la plataforma. Por ejemplo, en Pantheon, las cookies se prefijan con wp_, lo que da como resultado wp_affwp_ref, wp_affwp_ref_visit_id y wp_affwp_campaign. Excluir estas cookies de la caché garantiza un seguimiento preciso de los afiliados.

También debes excluir URL específicas relacionadas con AffiliateWP, como el Área de Afiliados, las páginas de registro e inicio de sesión, así como el script de seguimiento de AffiliateWP (/wp-content/plugins/affiliate-wp/assets/js/tracking.min.js).

Ajustes de caché específicos del plugin

WP Rocket

Para garantizar un seguimiento adecuado con WP Rocket:

• Navega a Panel » Ajustes » WP Rocket » Reglas avanzadas.
• En el campo URL que nunca se almacenan en caché, añade los slugs de las páginas del Área de Afiliados, registro e inicio de sesión.
• Añade cada una de las tres cookies (affwp_ref, affwp_ref_visit_id y affwp_campaign) en el campo Cookies que nunca se almacenan en caché, una por línea.
• Guarda los cambios y purga todas las cachés.

Además, WP Rocket permite deshabilitar la caché por página en la configuración de la barra lateral para las páginas que experimentan problemas específicos.

NitroPack

Para ajustar la caché en NitroPack:

• Inicia sesión en el panel de NitroPack y abre la pestaña Ajustes.
• Habilita la opción URL excluidas y añade las URL del Área de Afiliados, registro e inicio de sesión.
• Desplázate hacia abajo hasta Cookies excluidas, habilítala y añade las cookies affwp_ref, affwp_ref_visit_id y affwp_campaign.
• Guarda los cambios y haz clic en el botón Purger la caché en el panel principal.

WP Fastest Cache

Para los usuarios de WP Fastest Cache:

• Abre la pestaña Panel » WP Fastest Cache » Excluir.
• Utiliza el botón Añadir nueva regla para excluir las páginas relacionadas con AffiliateWP.
• De manera similar, excluye las cookies affwp_ref, affwp_ref_visit_id y affwp_campaign añadiéndolas como reglas separadas.
• Guarda los cambios y purga todas las cachés.

Breeze

Para configurar Breeze:

• Ve a Panel » Ajustes » Breeze » Opciones avanzadas.
• Añade las URLs relacionadas con AffiliateWP al campo Nunca caches estas URLs.
• Breeze no admite exclusiones de cookies de forma nativa. Si es necesario, contacta con el equipo de soporte de Breeze o, para usuarios de Cloudways, ajusta las exclusiones de cookies en la configuración de Varnish. Consulta la Guía de exclusión de cookies de Varnish de Cloudways.
• Guarda los cambios y asegúrate de que la opción Purgar Varnish automáticamente esté habilitada.

LiteSpeed Cache

En LiteSpeed Cache:

• Navega a Panel » LiteSpeed Cache » Caché » Exclusiones.
• Añade las slugs de página relacionadas con AffiliateWP al campo No cachear URIs.
• Introduce las cookies affwp_ref, affwp_ref_visit_id y affwp_campaign en el campo No cachear cookies.
• Guarda la configuración y purga todas las cachés.

W3 Total Cache

Para W3 Total Cache:

• Abre Panel » Rendimiento » Caché de página.
• Añade las slugs de página relacionadas con AffiliateWP al campo Nunca caches las siguientes páginas.
• Introduce las cookies affwp_ref, affwp_ref_visit_id y affwp_campaign en el campo Cookies rechazadas.
• Guarda tu configuración y purga todas las cachés.

Cloudflare

Si usas Cloudflare sin un plan enterprise, AffiliateWP puede generar nombres de cookie compatibles con la plataforma (wp_affwp_ref, etc.). Para implementar completamente la omisión de cookies en Cloudflare, necesitarás añadir código personalizado al archivo functions.php de tu tema o a un plugin de fragmentos de código.

Para habilitar los nombres de cookie compatibles con Cloudflare, usa:

add_filter( 'affwp_tracking_cookie_compat_mode', '__return_true' );

Para la integración con WooCommerce, incluye:

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 integraciones que no sean de WooCommerce, usa esto en su lugar:

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 );

Pruebas y solución de problemas

Después de excluir las cookies y las URLs, purga todas las cachés y prueba el sistema haciendo clic en un enlace de referencia y completando una compra de prueba. Si el seguimiento aún no funciona como se esperaba, comprueba si hay capas de caché adicionales (por ejemplo, caché a nivel de servidor) y deshabilita las optimizaciones de scripts que afecten al script de seguimiento de AffiliateWP.

Preguntas frecuentes

---

¡Eso es todo! AffiliateWP funciona a la perfección con el almacenamiento en caché cuando se configura correctamente. Al excluir las cookies, las URL y los scripts esenciales, puede mantener un rendimiento óptimo del sitio y, al mismo tiempo, garantizar un seguimiento preciso de los afiliados.