Tracciamento ordini

Traccia gli ordini effettuati sul tuo sito.

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

Modello del 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 di ordine è completato. Ad esempio, questa potrebbe essere una pagina a cui i 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,
        // userConsentStatus: true
        // allowNegativeCurrencyAmounts: true
        data: {
          orderId: '',
          orderNumber: '',
          gross: 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
• Valore predefinito: Valore di window.location.hostname

Può essere utilizzato per sovrascrivere facoltativamente il dominio che Fanplayr associa all'ordine.

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 interruzioni l'utente e gli ordini effettuati su questi domini.

connect

• Tipo: object
• Ambito: Tutte le pagine
• Valore predefinito: undefined

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

userConsentMode

• Tipo: boolean
• Ambito: Tutte le pagine
• Valore predefinito: undefined

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

Si prega di consultare consenso dell'utente per i dati per i dettagli.

userConsentStatus

• Tipo: boolean
• Ambito: Tutte le pagine
• Valore predefinito: undefined

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

Si prega di consultare consenso dell'utente per i dati per i dettagli.

allowNegativeCurrencyAmounts

• Tipo: boolean
• Ambito: Tutte le pagine
• Valore 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, specificando -100.00 per gross verrebbe convertito in 100.00 (positivo).

Se si desidera disabilitare questo comportamento e consentire il tracciamento di importi negativi di valuta (come il tracciamento di un totale ordine negativo), impostare allowNegativeCurrencyAmounts su true.

Questo comportamento influisce sulle seguenti variabili di tracciamento:

• gross
• 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,
    discount: 10.00
  }
}

orderId

• Tipo: string
• Obbligatorio

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

Questo potrebbe 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 visto dall'utente. Questo potrebbe 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.

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 stati applicati più codici sconto, separarli con delle virgole.

shipping

• Tipo: float
• Valore predefinito: 0

L'importo totale della spedizione, dopo l'applicazione di eventuali sconti specifici per la spedizione.

tax

• Tipo: float
• Valore predefinito: 0

Il totale di tutte le tasse applicate all'ordine.

currency

• Tipo: string
• Valore 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 potrebbe 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 interno al tuo sito. Viene utilizzato per tracciare gli utenti nuovi e quelli ricorrenti.

products

• Tipo: Array<Product>| stringa

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

cartAction

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

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

{
  accountKey: '<ACCOUNT_ID>',
  data: {
    // ...
  },
  custom_data: {
    // Add key/value pairs of additional details to track
    order_notes: 'Please leave at front door'
  }
}

Esempio

Il seguente esempio 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>