Aplicar al carrito

Los widgets de Fanplayr son capaces de aplicar códigos de oferta directamente al carrito de tu tienda si es compatible. Al admitir esta función, aumentas la facilidad con la que tus visitantes pueden convertirse en clientes de pago.

Cómo Funciona

1. Proporcionas a Fanplayr una URL especial applyToCartUrl como parte de tu implementación de seguimiento de usuarios.

   Ej. https://example.com/applyOffer.php?code=%c

2. Los widgets de oferta que utilizan la función "Aplicar al carrito" redirigirán el navegador a esta URL, reemplazando la variable %c con el código de oferta a aplicar.

3. Al navegar a esta URL, el software de tu carrito debe:

   1. Aplicar el código de oferta especificado al carrito.
   2. Redirigir al usuario a la página del carrito.
   3. Mejor Práctica: Si la oferta no se aplica correctamente al carrito, muestra un mensaje informativo al usuario explicando por qué la oferta no se aplicó.

Ejemplo

El siguiente ejemplo muestra cómo podrías configurar el aspecto de seguimiento de usuarios de Fanplayr para admitir la función "Aplicar al carrito".

Si al usuario se le presenta una oferta de Envío Gratuito dirigida con el código FREESHIP, el widget navegará el navegador a https://example.com/applyOffer.php?code=FREESHIP cuando esta función se active.

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

Manejador personalizado

A veces, es posible que no puedas simplemente acceder a una URL para aplicar un cupón. En este caso, puedes proporcionar un manejador de función a la plataforma Fanplayr para usarlo cuando un usuario haga clic en el botón Aplicar.

Manejador simple

// 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.applyToCart = function (event) {
    // Hacer algo con `event.code`
    console.log(event.code);
  };
};

Manejador con una devolución de llamada

// Se puede aceptar una función de devolución de llamada `doneFn()` como segundo argumento.
// Esto debe llamarse una vez que tu manejador haya terminado su trabajo.
// Esto permite a Fanplayr evitar que el manejador se llame varias veces
// y deshabilitar cualquier interfaz de usuario asociada al manejador.
window.fanplayr_ready = function () {
  window.fanplayr.platform.capabilities.applyToCart = function (event, doneFn) {
    // `event.code` es el código de cupón a aplicar
    $.ajax({
      type: 'GET',
      url: '/api/apply-code-to-cart',
      data: {
        code: event.code
      },
      complete: function () {
        // Notificar a Fanplayr que el manejador ha terminado.
        doneFn();
      }
    });
  };
};