Applica al carrello

I widget Fanplayr sono in grado di applicare codici offerta direttamente al carrello del tuo negozio, se supportato. Supportando questa funzionalità, aumenti la facilità con cui i tuoi visitatori possono convertirsi in clienti paganti.

Come Funziona

1. Fornisci a Fanplayr uno speciale URL applyToCartUrl come parte della tua implementazione di tracciamento utente.

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

2. I widget offerta che utilizzano la funzionalità "Applica al Carrello" reindirizzeranno il browser a questo URL, sostituendo la variabile %c con il codice offerta da applicare.

3. Una volta navigato a questo URL, il software del tuo carrello deve:

   1. Applicare il codice offerta specificato al carrello.
   2. Reindirizzare l'utente alla pagina del carrello.
   3. Buona Prassi: Se l'offerta non viene applicata correttamente al carrello, mostra un messaggio informativo all'utente spiegando perché l'offerta non è stata applicata.

Esempio

Il seguente esempio mostra come potresti configurare l'aspetto di tracciamento utente di Fanplayr per supportare la funzionalità "Applica al Carrello".

Se all'utente viene presentata un'offerta mirata di Spedizione Gratuita con il codice FREESHIP, il widget navigherà il browser a https://example.com/applyOffer.php?code=FREESHIP quando questa funzionalità è attivata.

{
  type: 'st',
  accountKey: '7e43c8cddccade2b95ee5286ba89758a',
  applyToCartUrl: 'https://example.com/applyOffer.php?code=%c',
  data: {
    // Dati di tracciamento utente
  }
}

Handler personalizzato

A volte potresti non essere in grado di semplicemente colpire un URL per applicare un coupon. In questo caso, puoi fornire una funzione handler alla piattaforma Fanplayr da utilizzare quando un utente clicca sul pulsante Applica.

Handler semplice

// La funzione `fanplayr_ready` viene chiamata una volta caricati gli script principali di Fanplayr.
window.fanplayr_ready = function () {
  window.fanplayr.platform.capabilities.applyToCart = function (event) {
    // Fai qualcosa con `event.code`
    console.log(event.code);
  };
};

Handler con callback

// Una funzione di callback `doneFn()` può accettare un secondo argomento.
// Questa dovrebbe essere chiamata una volta che il tuo handler ha terminato il suo lavoro.
// Ciò consente a Fanplayr di impedire che l'handler venga chiamato più volte
// e di disabilitare qualsiasi interfaccia utente allegata all'handler.
window.fanplayr_ready = function () {
  window.fanplayr.platform.capabilities.applyToCart = function (event, doneFn) {
    // `event.code` è il codice coupon da applicare
    $.ajax({
      type: 'GET',
      url: '/api/apply-code-to-cart',
      data: {
        code: event.code
      },
      complete: function () {
        // Notifica a Fanplayr che l'handler ha terminato.
        doneFn();
      }
    });
  };
};