Ofertas de sesión

Con un paso de integración sencillo adicional, Fanplayr puede ayudar a evitar que usuarios no autorizados reclamen descuentos en su tienda.

Este mecanismo tiene como objetivo resolver el problema que muchas tiendas en línea han enfrentado con sitios de cupones compartidos como Coupons.com y RetailMeNot. Fanplayr logra esto limitando las ofertas que presenta a sus usuarios para que solo sean válidas durante la visita actual.

Cómo funciona

Usted diseña una forma de identificar códigos de oferta que son exclusivos de Fanplayr en su sistema.

1. Fanplayr notificará a su sistema cuando se le presente una oferta al usuario. Su sistema recuerda estas ofertas durante la duración de la sesión del usuario.
2. Cuando un usuario intenta aplicar un código de oferta de Fanplayr, su sistema solo lo permite si recuerda el código del paso anterior.

Diagrama de flujo de ofertas de sesión

Flujo de ejemplo

Un método simple para identificar códigos de oferta exclusivos de Fanplayr es anteponerles un prefijo especial.

1. Por ejemplo, podría usar "FP_" como prefijo y tener un código de envío gratuito, "FP_FREESHIP", definido en su sistema.

2. Usted proporciona a Fanplayr una sessionOfferUrl como parte de su implementación de seguimiento de usuarios.

   Por ejemplo, la URL de oferta de sesión podría ser: https://example.com/allowOffer.php?code=%c

3. Cuando Fanplayr presente una oferta a sus usuarios, invocará la URL (como una solicitud GET) para notificar a su sistema que el código de oferta es válido en la sesión actual.

   Su sistema debe almacenar el código de oferta en un array que persista durante la duración de la sesión del usuario. Nos referiremos a este como el array validSessionCodes.

   Fanplayr reemplazará el parámetro %c en la URL con el código de oferta real. P. ej. https://example.com/allowOffer.php?code=FP_FREESHIP

4. Su sistema debe validar los códigos de oferta antes de aplicarlos al carrito. Al intentar aplicar un código de Fanplayr (por ejemplo, si comienza con el prefijo "FP_"), solo debe aplicarse al carrito si el código existe en el array validSessionCodes.

   Si un código de Fanplayr no existe en el array, el código debe considerarse inválido y ser rechazado por el sistema.

Ejemplo de implementación

1. Configuración

El primer paso en este proceso es proporcionar la sessionOfferUrl al fragmento de seguimiento de usuarios de Fanplayr. Esta URL se invocará con cada código de oferta que se presente al usuario. El parámetro %c será reemplazado por el código de oferta real.

P. ej. https://example.com/allowOffer.php?code=%c se convertirá en https://example.com/allowOffer.php?code=FP_FREESHIP

Este paso de configuración no se aplica a los adaptadores de Javascript personalizados creados por nosotros. En este caso, deberá proporcionarnos la sessionOfferUrl para que podamos actualizar su integración.

{
  type: 'st',
  accountKey: '7e43c8cddccade2b95ee5286ba89758a',
  sessionOfferUrl: 'https://example.com/allowOffer.php?code=%c',
  data: {
    // Datos de seguimiento de usuario
  }
}

2. Almacenando ofertas de sesión en su sistema

A continuación, deberá implementar un nuevo endpoint en su sistema que capture los códigos de oferta de Fanplayr a medida que se presentan a sus usuarios y los agregue a un array durante la duración de la sesión del usuario.

La URL que especifique en la variable sessionOfferUrl será invocada como una solicitud GET por el widget de Fanplayr.

3. Validar ofertas que se aplican al carrito

Para el paso final, deberá realizar un pequeño cambio en su sistema para que valide todos los códigos de oferta antes de aplicar sus descuentos.

Hemos proporcionado un ejemplo de implementación de un método que podría usarse para validar códigos que comienzan con el prefijo FP_. Solo se verificarán los códigos que comiencen con este prefijo para asegurar que realmente fueron presentados por Fanplayr durante la sesión del usuario. Todos los demás códigos sin prefijo se considerarán válidos inmediatamente.

Este método debe usarse en todo su sistema en cualquier lugar donde se pueda aplicar un código de oferta al carrito.

Alternativa de JavaScript

Si una URL del lado del servidor no es adecuada (por ejemplo, si necesita almacenar códigos de oferta de sesión en localStorage o invocar una API de carrito del lado del cliente), puede implementar la capacidad sessionOffer en JavaScript en lugar de proporcionar una sessionOfferUrl.

Consulte Capacidades — Oferta de sesión para obtener todos los detalles y ejemplos.