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.
<!-- 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:
{
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
- Tipo:
Array<Product>
| string
Un array de objetos (o JSON) que representan los productos del pedido.
cartAction
- Tipo:
CartAction
- 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 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
:
{
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
<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>