Offerte di sessione

Con un ulteriore semplice passaggio di integrazione, Fanplayr può aiutare a impedire agli utenti non autorizzati di richiedere sconti sul tuo negozio.‌

Questo meccanismo mira a risolvere il problema che molti negozi online hanno affrontato con i siti di condivisione di coupon come Coupons.com e RetailMeNot. Fanplayr raggiunge questo obiettivo limitando le offerte che presenta ai tuoi utenti in modo che siano valide solo durante la visita attuale.‌

Come funziona

‌Tu idei un modo per identificare i codici offerta che sono esclusivi di Fanplayr nel tuo sistema.

1. Fanplayr notificherà il tuo sistema quando un'offerta viene presentata all'utente. Il tuo sistema ricorderà queste offerte per la durata della sessione dell'utente.
2. Quando un utente tenta di applicare un codice offerta Fanplayr, il tuo sistema lo consente solo se ricorda il codice dal passaggio precedente.

Diagramma del flusso delle offerte di sessione

Esempio di flusso

‌Un metodo semplice per identificare i codici offerta esclusivi di Fanplayr è anteporre un prefisso speciale ad essi.

1. Ad esempio, potresti usare "FP_" come prefisso e avere un codice di spedizione gratuita, "FP_FREESHIP", definito nel tuo sistema.

2. Fornisci a Fanplayr una sessionOfferUrl come parte della tua implementazione di tracciamento utente.

   Ad esempio, l'URL dell'offerta di sessione potrebbe essere: https://example.com/allowOffer.php?code=%c​

3. Quando Fanplayr presenta un'offerta ai tuoi utenti, invocherà l'URL (come richiesta GET) per notificare al tuo sistema che il codice offerta è valido nella sessione attuale.

   Il tuo sistema deve archiviare il codice offerta in un array che viene persistito per la durata della sessione utente. Ci riferiremo a questo come all'array validSessionCodes.

   Fanplayr sostituirà il parametro %c nell'URL con il codice offerta effettivo. Es. https://example.com/allowOffer.php?code=FP_FREESHIP​

4. Il tuo sistema deve validare i codici offerta prima di applicarli al carrello. Quando si tenta di applicare un codice Fanplayr (ad esempio, inizia con il prefisso "FP_"), deve essere applicato al carrello solo se il codice esiste nell'array validSessionCodes.

   Se un codice Fanplayr non esiste nell'array, il codice deve essere considerato non valido e rifiutato dal sistema.

Esempio di implementazione

1. Configurazione

Il primo passo in questo processo è fornire la sessionOfferUrl allo snippet di tracciamento utente di Fanplayr. Questo URL verrà richiamato con ogni codice offerta che viene presentato all'utente. Il parametro %c verrà sostituito con il codice offerta effettivo.‌

Es. https://example.com/allowOffer.php?code=%c diventerà https://example.com/allowOffer.php?code=FP_FREESHIP​‌

Questo passaggio di configurazione non si applica agli adattatori Javascript personalizzati creati da noi. In questo caso, dovrai fornirci la sessionOfferUrl in modo che possiamo aggiornare la tua integrazione.

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

2. Memorizzazione delle offerte di sessione nel tuo sistema

‌Successivamente dovrai implementare un nuovo endpoint nel tuo sistema che cattura i codici offerta Fanplayr man mano che vengono presentati ai tuoi utenti e li aggiunge a un array per la durata della sessione utente.‌

L'URL che specifichi nella variabile sessionOfferUrl verrà richiamato come richiesta GET dal widget Fanplayr.

‌3. Convalidare le offerte applicate al carrello

Per il passaggio finale, dovrai apportare una piccola modifica al tuo sistema in modo che validi tutti i codici offerta prima di applicare i loro sconti.‌

Abbiamo fornito un esempio di implementazione di un metodo che potrebbe essere utilizzato per validare i codici che iniziano con il prefisso FP_. Solo i codici che iniziano con questo prefisso verranno controllati per assicurarsi che siano stati effettivamente presentati da Fanplayr durante la sessione dell'utente. Tutti gli altri codici non prefissati verranno considerati validi immediatamente.‌

Questo metodo dovrebbe essere usato in tutto il tuo sistema in qualsiasi punto in cui un codice offerta possa essere applicato al carrello.

Utilizzo di POST (o callback)

‌A volte potresti non essere in grado di richiamare semplicemente un URL per impostare un'Offerta di Sessione (ad esempio se stai mantenendo queste informazioni in localStorage). In questo caso puoi fornire una funzione alla piattaforma Fanplayr invece dell'URL in sessionOfferUrl.

// la funzione fanplayr_ready viene chiamata una volta caricati gli script principali di Fanplayr
window.fanplayr_ready = function () {
  window.fanplayr.platform.capabilities.deputizeOffer = function (event) {
    // Ora puoi accedere a event.code
    console.log(event.code);
    // Devi ritornare qui, e qualsiasi cosa diversa da "false" sarà trattata
    // come successo.
    return; // successo
    // OPPURE
    // Questo significa che l'impostazione dell'offerta di sessione è fallita, e verrà ritentata
    // in una chiamata successiva
    return false; // fallito
  };
};