Tracciamento ordini

Traccia gli ordini effettuati sul tuo sito.

Fanplayr può facilmente tracciare le conversioni effettuate sul tuo negozio eCommerce che, insieme al nostro tracciamento del comportamento degli utenti, possono essere utilizzate per analizzare il tuo negozio e identificare opportunità per migliorare il tuo business, indirizzando profili di clienti non convertiti.

Modello di Codice di Tracciamento

Il seguente modello di codice Javascript deve essere posizionato sulla pagina di conferma dell'ordine per tracciare le conversioni. Questa dovrebbe essere la pagina visualizzata dai clienti dopo che il processo d'ordine è completo. Ad esempio, questa potrebbe essere una pagina a cui i tuoi clienti vengono reindirizzati dopo un gateway di pagamento esterno come PayPal.

<!-- inizio Tracciamento Conversioni Fanplayr -->
<script>
  (function (d, w, s) {
    if (!w.fp_sales_orders) {
      w.fp_sales_orders = {
        version: 3,
        accountKey: '',
        storeDomain: '',
        userConsentMode: false,
        // statoConsensoUtente: true
        // abilitaImportiNegativiValuta: true
        data: {
          orderId: '',
          orderNumber: '',
          gross: 0.0,
          total: 0.0,
          discount: 0.0,
          discountCode: '',
          shipping: 0.0,
          tax: 0.0,
          currency: '',
          orderEmail: '',
          firstName: '',
          lastName: '',
          customerEmail: '',
          customerId: '',
          products: [
            {
              id: '',
              sku: '',
              price: 0.0,
              qty: 1,
              name: ''
            }
          ],
          cartAction: 'override',
          custom_data: {
            // ...
          }
        }
      };
      var js = d.createElement(s);
      var fjs = d.getElementsByTagName(s)[0];
      js.async = true;
      js.src = 'https://cdn.fanplayr.com/client/production/fp_custom_orders.js';
      fjs.parentNode.insertBefore(js, fjs);
    }
  })(document, window, 'script');
</script>
<!-- fine Tracciamento Conversioni Fanplayr -->

Configurazione

version

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

Identificatore della versione del formato di tracciamento utilizzato dalla piattaforma Fanplayr. Deve essere impostato su 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 all'ordine.

INFO

Alcuni negozi potrebbero utilizzare domini diversi per il loro sistema di checkout. Ad esempio, gli utenti potrebbero navigare nel tuo negozio su https://www.example.com, ma il checkout e gli ordini potrebbero essere effettuati su https://www.checkout.com/example. In questo caso, sarebbe necessario impostare storeDomain su "example.com" (lo stesso dominio collegato alla tua campagna Fanplayr) in modo che la piattaforma Fanplayr possa tracciare senza problemi l'utente e gli ordini che effettua su questi domini.

connect

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

Il percorso della pagina lato server per l'Identificazione Utente Avanzata.

userConsentMode

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

Determina se Fanplayr è tenuto a considerare il consenso dell'utente per archiviare i suoi dati.

Si prega di consultare consenso-utente-per-i-dati per i dettagli.

userConsentStatus

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

Se userConsentMode è impostato su true, questo definirà se l'utente ha acconsentito all'archiviazione dei propri dati.

Si prega di consultare consenso-utente-per-i-dati 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 assoluto positivo. Ad esempio, specificando -100.00 per gross verrebbe convertito in 100.00 (positivo).

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

Questo comportamento influisce sulle seguenti variabili di tracciamento:

• gross
• total
• discount
• shipping
• tax

Variabili di tracciamento

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

{
  version: 3,
  accountKey: '7e43c8cddccade2b95ee5286ba89758a',
  data: {
    orderId: '005921',
    orderNumber: '005921',
    gross: 89.90,
    total: 79.90,
    discount: 10.00
  }
}

orderId

• Tipo: string
• Obbligatorio

L'identificatore univoco dell'ordine utilizzato internamente dal tuo sistema. Questo può essere utilizzato in seguito per fare riferimento alle transazioni nel tuo sistema interno.

Questo può essere diverso da orderNumber, che è il numero di conferma dell'ordine fornito ai tuoi utenti.

orderNumber

• Tipo: string
• Obbligatorio

Il numero di conferma dell'ordine come visualizzato dall'utente. Questo può essere uguale o diverso da orderId.

gross

• Tipo: float
• Obbligatorio

Il valore totale (nella valuta specificata) degli articoli nell'ordine. Più specificamente, la somma totale degli articoli nell'ordine prima di sconti, spedizione e tasse.

total

• Tipo: float
• Obbligatorio

Questo è il valore totale (nella valuta specificata) degli articoli nell'ordine. Più specificamente, la somma totale degli articoli nell'ordine prima della spedizione e delle tasse, ma dopo gli sconti.

discount

• Tipo: float
• 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
• Obbligatorio

Il codice sconto applicato all'ordine (se presente). Se sono applicati più codici sconto, separarli con delle virgole.

shipping

• Tipo: float
• Predefinito: 0

L'importo totale della spedizione, dopo l'applicazione di qualsiasi sconto specifico per la spedizione.

tax

• Tipo: float
• Predefinito: 0

Il totale di tutte le tasse applicate all'ordine.

currency

• Tipo: string
• Predefinito: "USD"

Il codice valuta ISO 4217 dei valori del prodotto e dell'ordine tracciati.

orderEmail

• Tipo: string

L'indirizzo email fornito dall'utente per l'ordine. Questo può essere diverso da customerEmail.

firstName

• Tipo: string

Il nome dell'utente che ha effettuato l'ordine. Es. "John".

lastName

• Tipo: string

Il cognome dell'utente che ha effettuato l'ordine. Es. "Smith".

customerEmail

• Tipo: string

L'indirizzo email dell'utente corrente.

customerId

• Tipo: string

Questo è un identificatore dell'utente che è interno al tuo sito. Questo viene utilizzato per tracciare utenti nuovi e ricorrenti.

products

• Tipo: Array<Product>| string

Un array di oggetti (o JSON) che rappresentano i prodotti nell'ordine.

cartAction

• Tipo: CartAction
• 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.

Dati Personalizzati

Puoi tracciare dettagli aggiuntivi dell'ordine come dati personalizzati utilizzando l'oggetto custom_data:

{
  accountKey: '<ACCOUNT_ID>',
  data: {
    // ...
  },
  custom_data: {
    // Aggiungi coppie chiave/valore di dettagli aggiuntivi da tracciare
    order_notes: 'Please leave at front door'
  }
}

Esempio

L'esempio seguente potrebbe essere utilizzato per tracciare:

• Un ordine per un totale di $79.90 USD dopo l'applicazione dello sconto di $10 "SUMMER10".
• Composto da un singolo prodotto:
  • Scarpe rosse, al prezzo di $89.90

<script>
  (function (d, w, s) {
    if (!w.fp_sales_orders) {
      w.fp_sales_orders = {
        version: 3,
        accountKey: '7e43c8cddccade2b95ee5286ba89758a',
        storeDomain: 'example.com',
        data: {
          orderId: '005921',
          orderNumber: '005921',
          gross: 89.9,
          total: 79.9,
          discount: 10.0,
          discountCode: 'SUMMER10',
          shipping: 0.0,
          tax: 0.0,
          currency: 'USD',
          orderEmail: 'john.smith@gmail.com',
          firstName: 'John',
          lastName: 'Smith',
          customerEmail: 'john.smith@gmail.com',
          customerId: '10204723',
          products: [
            {
              id: 'WRS001',
              sku: 'WRS001',
              price: 89.9,
              qty: 1,
              name: 'Red Shoes'
            }
          ]
        }
      };
      var js = d.createElement(s);
      var fjs = d.getElementsByTagName(s)[0];
      js.async = true;
      js.src = 'https://cdn.fanplayr.com/client/production/fp_custom_orders.js';
      fjs.parentNode.insertBefore(js, fjs);
    }
  })(document, window, 'script');
</script>