Skip to content

Seguimiento de pedidos

Realiza un seguimiento de los pedidos realizados en tu sitio.

Fanplayr puede rastrear fácilmente las conversiones realizadas en tu tienda de eCommerce, lo que, junto con nuestro seguimiento del comportamiento del usuario, se puede utilizar para analizar tu tienda e identificar oportunidades para mejorar tu negocio mediante la segmentación de perfiles de clientes que no realizan conversiones.

Plantilla de Código de Seguimiento

La siguiente plantilla de código Javascript debe colocarse en la página de confirmación de pedido para rastrear las conversiones. Esta debe ser la página que los clientes ven después de que el proceso de pedido se haya completado. Por ejemplo, esta puede ser una página a la que tus clientes regresan después de un proceso de pago externo como PayPal.

html
<!-- iniciar seguimiento de conversiones de 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>
<!-- finalizar seguimiento de conversiones de Fanplayr -->

Configuración

version

  • Tipo: integer
  • Ámbito: Todas las páginas
  • Requerido

Identificador de la versión del formato de seguimiento utilizado por la plataforma Fanplayr. Debe establecerse en 3.

accountKey

  • Tipo: string
  • Ámbito: Todas las páginas
  • Requerido

Cadena única utilizada para identificar tu cuenta en la plataforma Fanplayr.

storeDomain

  • Tipo: string
  • Ámbito: Todas las páginas
  • Predeterminado: Valor de window.location.hostname

Puede usarse para anular opcionalmente el dominio que Fanplayr asocia con el pedido.

Algunas tiendas pueden usar diferentes dominios para su sistema de pago. Por ejemplo, los usuarios pueden navegar por tu tienda en https://www.example.com, pero el proceso de pago y los pedidos pueden realizarse en https://www.checkout.com/example. En este caso, sería necesario establecer storeDomain a "example.com" (el mismo dominio vinculado a tu campaña de Fanplayr) para que la plataforma Fanplayr pueda rastrear sin problemas al usuario y los pedidos que realiza en estos dominios.

connect

  • Tipo: object
  • Ámbito: Todas las páginas
  • Predeterminado: undefined

La ruta a la página del lado del servidor para Enhanced User Identification.

userConsentMode

  • Tipo: boolean
  • Ámbito: Todas las páginas
  • Predeterminado: undefined

Determina si Fanplayr debe considerar el consentimiento del usuario para almacenar sus datos.

Consulta user-consent-for-data para obtener más detalles.

userConsentStatus

  • Tipo: boolean
  • Ámbito: Todas las páginas
  • Predeterminado: undefined

Si userConsentMode se establece en true, entonces esto definirá si el usuario ha dado su consentimiento para que sus datos sean almacenados.

Consulta user-consent-for-data para obtener más detalles.

allowNegativeCurrencyAmounts

  • Tipo: boolean
  • Ámbito: Todas las páginas
  • Predeterminado: false

Por defecto, no se permiten valores negativos para las variables de moneda y, en su lugar, siempre se convierten a su valor positivo absoluto. Por ejemplo, especificar -100.00 para gross se convertiría a 100.00 (positivo).

Si deseas desactivar este comportamiento y permitir que se rastreen cantidades de moneda negativas (como el seguimiento de un total de pedido negativo), establece allowNegativeCurrencyAmounts en true.

Este comportamiento afecta a las siguientes variables de seguimiento:

Variables de seguimiento

Las siguientes variables deben proporcionarse en el objeto data. Ejemplo:

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

orderId

  • Tipo: string
  • Requerido

El identificador único del pedido que utiliza internamente tu sistema. Esto se puede utilizar más adelante para referenciar transacciones en tu sistema interno.

Puede ser diferente de orderNumber, que es el número de confirmación de pedido proporcionado a tus usuarios.

orderNumber

  • Tipo: string
  • Requerido

El número de confirmación de pedido tal como lo ve el usuario. Este puede ser igual o diferente a orderId.

gross

  • Tipo: float
  • Requerido

El valor total (en la moneda especificada) de los artículos en el pedido. Más específicamente, la suma total de los artículos en el pedido antes de descuentos, envío e impuestos.

discount

  • Tipo: float
  • Requerido

Este es el valor total de los descuentos aplicados al carrito. Esto significa que los descuentos como el envío gratuito o los descuentos de envío no deberían cambiar este valor.

discountCode

  • Tipo: string
  • Requerido

El código de descuento aplicado al pedido (si lo hubiera). Si se aplican varios códigos de descuento, sepáralos con comas.

shipping

  • Tipo: float
  • Predeterminado: 0

El importe total del envío, después de aplicar cualquier descuento específico de envío.

tax

  • Tipo: float
  • Predeterminado: 0

El total de todos los impuestos aplicados al pedido.

currency

  • Tipo: string
  • Predeterminado: "USD"

El código de moneda ISO 4217 de los valores de producto y pedido que se están rastreando.

orderEmail

  • Tipo: string

La dirección de correo electrónico que el usuario proporcionó para el pedido. Puede ser diferente de customerEmail.

firstName

  • Tipo: string

El primer nombre del usuario que realizó el pedido. P. ej., "John".

lastName

  • Tipo: string

El apellido del usuario que realizó el pedido. P. ej., "Smith".

customerEmail

  • Tipo: string

La dirección de correo electrónico del usuario actual.

customerId

  • Tipo: string

Este es un identificador del usuario que es interno a tu sitio. Se utiliza para rastrear usuarios nuevos y recurrentes.

products

Un array de objetos (o JSON) que representan los productos del pedido.

cartAction

Esta es una variable especial que determina cómo Fanplayr tratará los datos relacionados con el carrito para la llamada de seguimiento actual. Puede usarse para transferir los detalles del carrito (valor total en el carrito, productos en el carrito, etc.) de la vista de página anterior si no están disponibles para la llamada de seguimiento actual.

Datos Personalizados

Puedes rastrear detalles adicionales del pedido como datos personalizados utilizando el objeto custom_data:

javascript
{
  accountKey: '<ACCOUNT_ID>',
  data: {
    // ...
  },
  custom_data: {
    // Agrega pares clave/valor de detalles adicionales para rastrear
    order_notes: 'Please leave at front door'
  }
}

Ejemplo

El siguiente ejemplo podría usarse para rastrear:

  • Un pedido con un total de $79.90 USD después de aplicar el descuento de $10 "SUMMER10".
  • Que consta de un solo producto:
    • Zapatos Rojos, con un precio de $89.90
html
<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>