Ofertas de sesión

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

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

Cómo funciona

Debes idear una forma de identificar en tu sistema los códigos de oferta que son exclusivos de Fanplayr.

1. Fanplayr notificará a tu sistema cuando se presente una oferta al usuario. Tu sistema recordará estas ofertas durante la sesión del usuario.
2. Cuando un usuario intente aplicar un código de oferta de Fanplayr, tu sistema solo lo permitirá 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 los códigos de oferta que son exclusivos de Fanplayr es anteponerles un prefijo especial.

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

2. Proporcionas a Fanplayr una sessionOfferUrl como parte de tu implementación de seguimiento de usuarios.

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

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

   Tu sistema debe almacenar el código de oferta en un array que se mantenga durante 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. Por ejemplo, https://example.com/allowOffer.php?code=FP_FREESHIP

4. Tu 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 se reemplazará con el código de oferta real.

Por ejemplo, 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 Javascript personalizados creados por nosotros. En este caso, deberás proporcionarnos la sessionOfferUrl para que podamos actualizar tu integración.

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

2. Almacenamiento de ofertas de sesión en tu sistema

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

La URL que especifiques 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 último paso, deberás realizar un pequeño cambio en tu 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 los códigos que comienzan con este prefijo se verificarán para asegurar que fueron presentados realmente 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 tu sistema en cualquier lugar donde un código de oferta pueda aplicarse al carrito.

Uso de POST (o callback)

A veces, es posible que no puedas simplemente acceder a una URL para establecer una Oferta de Sesión (por ejemplo, si mantienes esta información en localStorage). En este caso, puedes proporcionar una función a la plataforma de Fanplayr en lugar de la URL en sessionOfferUrl.

// La función fanplayr_ready se llama una vez que se cargan los scripts principales de Fanplayr
window.fanplayr_ready = function () {
  window.fanplayr.platform.capabilities.deputizeOffer = function (event) {
    // Ahora puedes acceder a event.code
    console.log(event.code);
    // Debes retornar aquí, y cualquier cosa que no sea "false" será tratada
    // como éxito.
    return; // éxito
    // O
    // Esto significa que la configuración de la oferta de sesión ha fallado, y se reintentará
    // en una llamada posterior
    return false; // fallo
  };
};