Seguimiento de pedidos

Rastrea los pedidos realizados en su sitio.

Fanplayr puede rastrear fácilmente las conversiones realizadas en su tienda de eCommerce, lo que, junto con nuestro seguimiento del comportamiento del usuario, puede utilizarse para analizar su tienda e identificar oportunidades para mejorar su 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 del pedido para rastrear las conversiones. Esta debe ser la página que los clientes ven después de que el proceso de pedido se ha completado. Por ejemplo, puede ser una página a la que sus clientes regresan después de un sistema de pago externo como PayPal.

<!-- inicio 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,
          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>
<!-- fin Seguimiento de Conversiones de Fanplayr -->

Configuración

versión

• Tipo: integer
• Alcance: Todas las páginas
• Obligatorio

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

accountKey

• Tipo: string
• Alcance: Todas las páginas
• Obligatorio

Cadena única utilizada para identificar su cuenta con la plataforma Fanplayr.

storeDomain;

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

Puede utilizarse 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 su tienda en https://www.example.com, pero la compra y los pedidos pueden realizarse en https://www.checkout.com/example. En este caso, sería necesario establecer storeDomain en "example.com" (el mismo dominio vinculado a su 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
• Alcance: Todas las páginas
• Predeterminado: undefined

La ruta a la página del lado del servidor para la Identificación de Usuario Mejorada.

userConsentMode

• Tipo: boolean
• Alcance: Todas las páginas
• Predeterminado: undefined

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

Consulte consentimiento-del-usuario-para-datos para obtener más detalles.

userConsentStatus

• Tipo: boolean
• Alcance: Todas las páginas
• Predeterminado: undefined

Si userConsentMode se establece en true, esto definirá si el usuario ha consentido que sus datos sean almacenados.

Consulte consentimiento-del-usuario-para-datos para obtener más detalles.

allowNegativeCurrencyAmounts

• Tipo: boolean
• Alcance: Todas las páginas
• Predeterminado: false

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

Si desea inhabilitar este comportamiento y permitir que se rastreen montos de moneda negativos (como el seguimiento de un total de pedido negativo), establezca allowNegativeCurrencyAmounts en true.

Este comportamiento afecta a las siguientes variables de seguimiento:

• gross
• total
• discount
• shipping
• tax

Variables de seguimiento

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

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

orderId

• Tipo: string
• Obligatorio

El identificador de pedido único que utiliza internamente su sistema. Esto puede usarse más adelante para referenciar transacciones en su sistema interno.

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

orderNumber

• Tipo: string
• Obligatorio

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

gross

• Tipo: float
• Obligatorio

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.

total

• Tipo: float
• Obligatorio

Este es 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 del envío e impuestos, pero después de los descuentos.

discount

• Tipo: float
• Obligatorio

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 deben cambiar este valor.

discountCode

• Tipo: string
• Obligatorio

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

shipping

• Tipo: float
• Predeterminado: 0

El monto 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. Ej. "John".

lastName

• Tipo: string

El apellido del usuario que realizó el pedido. 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 su sitio. Se utiliza para rastrear usuarios nuevos y recurrentes.

products

• Tipo: Array<Producto>| string

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

cartAction

• Tipo: AcciónCarrito
• Predeterminado: "override"

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

Datos Personalizados

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

{
  accountKey: '<ACCOUNT_ID>',
  data: {
    // ...
  },
  custom_data: {
    // Añadir pares clave/valor de detalles adicionales para rastrear
    notas_pedido: 'Por favor, dejar en la puerta principal'
  }
}

Ejemplo

El siguiente ejemplo podría usarse para rastrear:

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