Monitoraggio delle pagine

Monitora il comportamento dell'utente mentre naviga tra le pagine del tuo sito.

Template

Il seguente template di codice Javascript deve essere posizionato su tutte le pagine, eccetto la pagina di conferma dell'ordine.

<script>
  (function (d, w, s) {
    var f = (w.fanplayr = w.fanplayr || { _i: [] });
    f._i.push({
      version: 3,
      accountKey: '',
      applyToCartUrl: '',
      sessionOfferUrl: '',
      userConsentMode: false,
      // userConsentStatus: true
      // allowNegativeCurrencyAmounts: true
      data: {
        lineItemCount: 0,
        numItems: 0,
        gross: 0.0,
        discount: 0.0,
        discountCode: '',
        pageType: '',
        categoryId: '',
        categoryName: '',
        productId: '',
        productName: '',
        productSku: '',
        productPrice: 0.0,
        productUrl: '',
        productImage: '',
        currency: '',
        products: [
          {
            id: '',
            sku: '',
            price: 0.0,
            qty: 1,
            name: ''
          }
        ],
        cartAction: 'override',
        searchQuery: ''
      },
      custom_data: {
        // ...
      }
    });
    var js = d.createElement(s);
    var fjs = d.getElementsByTagName(s)[0];
    js.async = true;
    js.src = 'https://cdn.fanplayr.com/client/production/loader.js';
    fjs.parentNode.insertBefore(js, fjs);
  })(document, window, 'script');
</script>

Configurazione

version

• Tipo: integer
• Ambito: Tutte le pagine
• Obbligatorio

Identificatore della versione del formato di tracciamento utilizzato dalla piattaforma Fanplayr. Deve essere impostato a 3.

accountKey

• Tipo: string
• Ambito: Tutte le pagine
• Obbligatorio

Stringa univoca utilizzata per identificare il tuo account con la piattaforma Fanplayr.

storeDomain

• Tipo: string
• Ambito: Tutte le pagine
• Predefinito: Valore di window.location.hostname

Può essere utilizzato per sovrascrivere opzionalmente il dominio che Fanplayr associa alla sessione.

connect

• Tipo: object
• Ambito: Tutte le pagine
• Predefinito: undefined

Il percorso della pagina server-side per l'Identificazione utente avanzata.

applyToCartUrl

• Tipo: string
• Ambito: Tutte le pagine
• Predefinito: undefined

Se fornito, questo permetterà ai widget di Fanplayr di applicare i codici offerta direttamente al tuo carrello. Questo può aumentare la facilità con cui i tuoi visitatori si convertono in clienti paganti. Per maggiori dettagli, consulta la sezione Applica offerta al carrello.

sessionOfferUrl

• Tipo: string
• Ambito: Tutte le pagine
• Predefinito: undefined

Se fornito, questo permetterà a Fanplayr di utilizzare il metodo di sicurezza dell'Offerta di Sessione. Per maggiori dettagli, consulta la sezione Offerte di Sessione.

allowOfferPrompt

• Tipo: boolean | function
• Ambito: Tutte le pagine
• Predefinito: undefined

I widget Offer Flyout possono essere configurati per invitare gli utenti ad applicare le offerte raccolte al carrello forzando l'apertura del wallet quando nessuna offerta è stata applicata. Per impostazione predefinita, questa funzione viene attivata solo nella pagina del carrello.

Questa opzione viene utilizzata per abilitare o disabilitare questa funzione per la pagina corrente (indipendentemente dal tipo di pagina). Se viene fornita una funzione, viene utilizzato il valore di ritorno.

Valori Possibili

• true - Consente le richieste di offerta nella pagina corrente, incluse le pagine non di carrello.
• false - Disabilita le richieste di offerta nella pagina corrente.

Indipendentemente dal valore, la funzione di richiesta offerta verrà utilizzata solo se non è presente alcuna offerta attualmente applicata al carrello.

userConsentMode

• Tipo: boolean
• Ambito: Tutte le pagine
• Predefinito: undefined

Determina se a Fanplayr è richiesto di considerare il consenso dell'utente per memorizzare i suoi dati.

Si prega di consultare user-consent-for-data per i dettagli.

userConsentStatus

• Tipo: boolean
• Ambito: Tutte le pagine
• Predefinito: undefined

Se userConsentMode è impostato su true, allora questo definirà se l'utente ha acconsentito alla memorizzazione dei suoi dati.

Si prega di consultare user-consent-for-data per i dettagli.

allowNegativeCurrencyAmounts

• Tipo: boolean
• Ambito: Tutte le pagine
• Predefinito: false

Per impostazione predefinita, i valori negativi per le variabili di valuta non sono consentiti e vengono invece sempre convertiti nel loro valore positivo assoluto. Ad esempio, specificare -100.00 per gross verrebbe convertito in 100.00 (positivo).

Se desideri disattivare questo comportamento e consentire il tracciamento di importi negativi di valuta (come il tracciamento di un totale carrello negativo), imposta allowNegativeCurrencyAmounts su true.

Questo comportamento influisce sulle seguenti variabili di tracciamento:

• gross
• discount

Variabili di tracciamento

Le seguenti variabili devono essere fornite nell'oggetto data. Esempio:

{
  version: 3,
  accountKey: '7e43c8cddccade2b95ee5286ba89758a',
  data: {
    lineItemCount: 2,
    numItems: 2,
    gross: 89.90,
    discount: 10.00
  }
}

lineItemCount

• Tipo: integer
• Ambito: Tutte le pagine
• Obbligatorio

Il numero di prodotti unici attualmente aggiunti al carrello.

numItems

• Tipo: integer
• Ambito: Tutte le pagine
• Obbligatorio

La quantità totale di tutti gli articoli aggiunti al carrello.

gross

• Tipo: float
• Ambito: Tutte le pagine
• Obbligatorio

Il valore totale (nella valuta specificata) degli articoli attualmente nel carrello. Più specificamente, il totale complessivo degli articoli nel carrello prima di sconti, spedizioni e tasse.

discount

• Tipo: float
• Ambito: Tutte le pagine
• Obbligatorio

Questo è il valore totale degli sconti applicati al carrello. Ciò significa che sconti come la spedizione gratuita o sconti sulla spedizione non dovrebbero modificare questo valore.

discountCode

• Tipo: string
• Ambito: Tutte le pagine
• Obbligatorio

Il codice sconto applicato al carrello (se presente). Se sono stati applicati più codici sconto, separarli con delle virgole.

pageType

• Tipo: string
• Ambito: Tutte le pagine
• Obbligatorio

Il tipo di pagina corrente. I valori validi sono:

• home – La homepage.
• prod – Una pagina prodotto.
• cat – Una pagina categoria o un elenco di prodotti.
• srch – Una pagina di ricerca specifica o una pagina di risultati di ricerca.
• cart – La pagina del carrello.
• checkout - Una pagina nel flusso di checkout, ma non la pagina di conferma dell'ordine.
• blog - Una pagina del blog.
• page – Qualsiasi altra pagina. Es. 'Chi siamo', 'Contatti' ecc.

currency

• Tipo: string
• Ambito: Tutte le pagine
• Predefinito: "USD"

Il codice valuta ISO 4217 dei valori di prodotto e carrello tracciati.

brands

• Tipo: string[]
• Ambito: Pagine Home, Prodotto e Categoria

Un array di nomi di brand associati alla pagina corrente.

categories

• Tipo: string[]
• Ambito: Pagine Prodotto e Categoria
• Obbligatorio

Un array di nomi di categoria associati alla pagina corrente.

Le categorie a cui appartiene questo prodotto. Un prodotto può appartenere a più categorie. Fornire il percorso completo della categoria — piuttosto che solo la categoria foglia — migliora significativamente la qualità dei consigli e della ricerca.

Usa > per separare i livelli della gerarchia. Se > appare in un nome di categoria, sostituiscilo con un altro carattere come "|".

"categories": [
  "Shoes & Accessories > Shoes",
  "Sports & Fitness > Athletic Clothing > Shoes"
]

categoryId

• Tipo: string
• Ambito: Pagine Prodotto e Categoria
• Deprecato. Utilizza categories invece.

ID della categoria corrente. Questo dovrebbe essere specificato nelle pagine di categoria e prodotto.

categoryName

• Tipo: string
• Ambito: Pagine Prodotto e Categoria
• Deprecato. Utilizza categories invece.

Nome della categoria corrente se disponibile.

productId

• Tipo: string
• Ambito: Pagine prodotto
• Obbligatorio

Un identificatore di prodotto singolo e univoco. Utilizzato per differenziare i prodotti nel carrello o nell'ordine.

Questo viene utilizzato anche per collegare le visualizzazioni delle singole pagine prodotto ai prodotti aggiunti al carrello. Consulta Product.id per maggiori informazioni.

productSku

• Tipo: string
• Ambito: Pagine prodotto
• Obbligatorio

Lo SKU del prodotto. Questo può essere lo stesso di productId, ma è anche reso disponibile come opzione di segmentazione.

productPrice

• Tipo: float
• Ambito: Pagine prodotto
• Obbligatorio

Il prezzo unitario del prodotto visibile all'utente.

Per i carrelli che implementano un prezzo base e un prezzo scontato/di vendita, usa il prezzo scontato se è il prezzo mostrato agli utenti quando aggiungono il prodotto al carrello.

productName

• Tipo: string
• Ambito: Pagine prodotto
• Obbligatorio

Il nome del prodotto attualmente in fase di navigazione. Es. "Scarpe Rosse".

productUrl

• Tipo: string
• Ambito: Pagine prodotto
• Obbligatorio

URL della pagina che mostra i dettagli completi del prodotto. Questa proprietà dovrebbe essere utilizzata quando si traccia una "visualizzazione rapida" di un prodotto in modo che l'URL effettivo della pagina prodotto sia catturato correttamente.

productImage

• Tipo: string
• Ambito: Pagine prodotto
• Obbligatorio

URL dell'immagine del prodotto.

customerEmail

• Tipo: string
• Ambito: Tutte le pagine

L'indirizzo email dell'utente corrente.

customerId

• Tipo: string
• Ambito: Tutte le pagine
• Deprecato

Questo è un identificatore dell'utente interno al tuo sito. Viene utilizzato per tracciare gli utenti nuovi e quelli ricorrenti.

INFO

Questa proprietà è deprecata ed è stata sostituita dalla funzione Identità dell'Utente. Specifica un identificatore dell'utente loggato utilizzando la speciale identità $user.

products

• Tipo: Array<Product>| string
• Ambito: Tutte le pagine
• Predefinito: []

Un array di oggetti (o JSON) che rappresentano i prodotti attualmente nel carrello.

Per maggiori dettagli sui valori da memorizzare in questo array, consulta l'oggetto Prodotto.

cartAction

• Tipo: CartAction
• Ambito: Tutte le pagine
• Predefinito: "override"

Questa è una variabile speciale che determina come Fanplayr tratterà i dati relativi al carrello per la chiamata di tracciamento corrente. Può essere utilizzata per riportare i dettagli del carrello (valore totale nel carrello, prodotti nel carrello, ecc.) dalla visualizzazione della pagina precedente se non sono disponibili per la chiamata di tracciamento corrente.

identities

• Tipo: IdentityMap
• Ambito: Tutte le pagine

Un oggetto di mappa delle identità che ti consente di associare altre identità utente all'identificatore utente di Fanplayr per migliorare i segnali che Fanplayr utilizza per identificare gli utenti di ritorno. Per maggiori dettagli, consulta la documentazione Gestione delle identità.

searchQuery

• Tipo: string
• Ambito: Pagine di ricerca

Utilizzato per acquisire eventuali termini di ricerca o query che l'utente ha inserito in una pagina di risultati di ricerca sul sito web. Vedi la proprietà pageType.

Dati Personalizzati

Se necessario, Fanplayr è in grado di acquisire dati personalizzati durante il monitoraggio del comportamento dell'utente sul tuo sito. Questi dati possono essere utilizzati per segmentare su dati non ancora supportati nativamente da Fanplayr.

Un esempio di utilizzo potrebbe essere il passaggio dello stato di "loggato" di un utente, informazioni di segmentazione interna o quale sia il negozio corrente (ad esempio, utilizzando Magento Enterprise).

Per utilizzare questa funzione, contatta Fanplayr in modo che possiamo aiutarti a configurarla.

{
  accountKey: '7e43c8cddccade2b95ee5286ba89758a',
  // ...
  custom_data: {
    is_logged_in: '1',
    internal_segment: 'general_user',
    store: 'french',
  }
}

Esempio

Il seguente esempio potrebbe essere utilizzato per tracciare:

• Un utente che sta attualmente navigando nella pagina del prodotto "Scarpe Rosse"
• Con due articoli già aggiunti al carrello:
  • Due tazze del valore di $10 ciascuna
  • Una maglietta del valore di $45
• Un codice coupon, "WINTER5", che applica uno sconto di $5 al carrello

<script>
  (function (d, w, s) {
    var f = (w.fanplayr = w.fanplayr || { _i: [] });
    f._i.push({
      version: 3,
      accountKey: '7e43c8cddccade2b95ee5286ba89758a',
      data: {
        lineItemCount: 2,
        numItems: 3,
        gross: 65.0,
        total: 60.0,
        discount: 5.0,
        couponCode: 'WINTER5',
        pageType: 'prod',
        categoryId: '45',
        categoryName: "Women's Shoes",
        productId: 'WRS001',
        productName: 'Red Shoes',
        productSku: 'WRS001',
        productPrice: 59.0,
        productUrl: 'https://example.com/women/shoes/001.html',
        productImage: 'https://example.com/images/products/WRS001.jpg',
        currency: 'USD',
        products: [
          {
            id: 'cup001',
            price: 10.0,
            qty: 2,
            name: 'Boring Old Cup'
          },
          {
            id: 'tshirt001',
            price: 45.0,
            qty: 1,
            name: 'Really Expensive T-Shirt'
          }
        ]
      }
    });
    var js = d.createElement(s);
    var fjs = d.getElementsByTagName(s)[0];
    js.async = true;
    js.src = 'https://cdn.fanplayr.com/client/production/loader.js';
    fjs.parentNode.insertBefore(js, fjs);
  })(document, window, 'script');
</script>

Siti Dinamici

Quando il codice di tracciamento sopra descritto viene implementato correttamente, Fanplayr traccierà le pagine dopo che sono state caricate mentre un utente naviga nel sito web. Questo è sufficiente per la maggior parte dei siti, ma potrebbero essere necessari passaggi aggiuntivi per i siti che caricano contenuti dinamicamente.

Ad esempio, i siti che caricano i dettagli del prodotto in un overlay popup invece di reindirizzare l'utente a una nuova pagina, dovranno implementare un passaggio aggiuntivo per tracciare correttamente le visualizzazioni del prodotto.

Ulteriori visualizzazioni di pagina possono essere tracciate dinamicamente dopo che la visualizzazione di pagina iniziale è stata tracciata da Fanplayr, passando i dati di tracciamento al metodo fanplayr.reinitialize().

I dati di tracciamento seguono lo stesso formato dettagliato sopra. Tieni presente che tutte le proprietà richieste devono essere presenti.

// Questo metodo è disponibile dopo che lo script fanplayr è stato caricato.
fanplayr.reinitialize({
  type: 'st',
  accountKey: '7e43c8cddccade2b95ee5286ba89758a',
  data: {
    pageType: 'prod',
    productId: '56_b2',
    // Molte proprietà richieste sono omesse per brevità
    ...
  }
});