Magento 2

Integración de Fanplayr con su Tienda Magento 2

La instalación de extensiones para Magento 2 es un poco más compleja que con Magento 1.x y debe ser realizada por su desarrollador. Implica tener acceso a la línea de comandos de su proveedor de alojamiento web o entorno de desarrollo.

Descargar la Extensión

Actualmente, sugerimos descargar la extensión directamente desde aquí:

https://cdn.fanplayr.com/integrations/magento2/packages/fanplayr_smartandtargeted-1.6.19.zip

O desde Packagist:

composer require fanplayr/smartandtargeted

Descomprimir en un directorio temporal

Descomprima el contenido de la extensión en un directorio temporal. Mueva o cargue el directorio 'SmartAndTargeted' a la siguiente ubicación:

/app/code/Fanplayr/

Deshabilitar la Caché

Inicie sesión en su Admin area, luego vaya a System / Tools / Cache Management. Seleccione todos los tipos de caché, elija "Disable" de la lista desplegable y luego Submit.

Consola: Ejecutar Actualización

Aunque haya copiado los archivos de la extensión en su instalación de Magento 2, no serán visibles hasta que el sistema los escanee. Para ello, deberá abrir su consola localmente, o en una máquina remota, necesitará acceso a la terminal.

Una vez en la terminal, vaya a la raíz de su instalación de Magento 2. Luego ejecute el siguiente comando:

php ­bin/magento setup:upgrade

Esto actualizará el archivo app/etc/config.php con los detalles de su nuevo módulo.

Este proceso puede pedirle que vuelva a ejecutar Magento compile. Si no se encuentra en un entorno de desarrollo, puede hacerlo con el siguiente comando:

php ­bin/magento setup:di:compile

Si tiene errores de memoria, ejecute de la siguiente manera:

php -d memory_limit=-1 ­bin/magento setup:di:compile

Note: Incluso si su tienda está en developer mode, a veces puede ser necesario ejecutar compile para que Fanplayr finalice la integración.

Añadir su Clave de Cuenta de Fanplayr

En su Admin area, vaya a Stores / Settings / Configuration. Ahora debería ver una nueva opción en el menú de la izquierda, Fanplayr / Smart And Targeted.

Ahora puede introducir la Account Key que le proporcionó su gestor de cuentas de Fanplayr. Asegúrese de hacer clic en Save Config.

Volver a habilitar la Caché

Inicie sesión en su Admin area, luego vaya a System / Tools / Cache Management. Seleccione todos los tipos de caché, elija "Enable" de la lista desplegable y luego Submit.

Pruebas / QA

Una vez que Fanplayr ha sido instalado, debería poder ver la variable fanplayr en su Javascript console. Si esta variable está presente, debemos verificar que toda la información esperada se esté rastreando en cada page type. Esto implicará ir al page type específico y luego observar la variable fanplayr en su Javascript console para verificar que los valores se estén rastreando.

Variables específicas de la página (User Tracking)

La variable específica que desea observar es la siguiente:

fanplayr._i[0].data

Debería verse así:

Página de Inicio

Solo hay una variable que necesita verificar aquí, la pageType que deberá verificar en cada página.

• pageType: "home"

Página de Categoría

Debe verificar algunas páginas de categoría para asegurarse de que el seguimiento sea correcto. Las variables que debe observar:

• pageType: "cat"
• categoryId: Esto debe ser un número
• categoryName: Esto debe ser el nombre de la categoría

Página de Producto

De nuevo, es una buena idea verificar algunas páginas de producto:

• pageType: "prod"
• productId: El ID del producto.
• productImage: Una URL que apunta a la imagen principal del producto.
• productName: El nombre del producto.
• productPrice: El precio del producto. Tenga en cuenta que para configuraciones de VAT/GST, mostrará el precio antes de impuestos.
• productSku: El SKU del producto.
• productUrl: Una URL que debería apuntar a esta página de producto.

Página del Carrito

La configuración para esta prueba es un poco más compleja. Por favor, haga lo siguiente:

• Añada al menos 2 productos
• Asegúrese de que uno de estos productos tenga al menos 2 (cantidad) en el carrito.
• Aplique un cupón al carrito.

Los detalles del carrito se rastrean en todas las páginas, pero verificaremos la página del carrito misma:

• pageType: "cart"
• discount: El importe del descuento aplicado.
• discountCode: El código utilizado para el descuento.
• lineItemCount: El número de artículos de línea.
• numItems: La cantidad total de artículos: artículos de línea X cantidad.
• subTotal: El total del carrito antes de descuentos, envío o impuestos.
• total: El total del carrito antes de envío o impuestos, pero después del descuento.
• products: Una representación JSON de los productos en el carrito, incluyendo los siguientes detalles:
  • id
  • sku
  • name
  • price
  • qty
  • catId

Seguimiento de Pedidos

Para probar que el seguimiento de pedidos funciona, proceda a realizar un pedido de prueba utilizando la misma configuración que utilizó para la prueba de la página del carrito anterior. Es decir, asegúrese de tener varios productos y un descuento aplicado.

Una vez que haya realizado el pedido, se le presentará una página de "Thank You" o "Order Complete". En esta página debería poder ver la siguiente variable en su Javascript console:

fp_sales_orders;

Si esta variable está presente, todo debería haberse rastreado correctamente. Ahora puede iniciar sesión en su cuenta de Fanplayr y ver el pedido yendo a:

• Account / Transactions

Tenga en cuenta que, aunque las transacciones deberían aparecer bastante pronto después de realizarse, el seguimiento de las sesiones tardará un poco más en aparecer en sus analytics. Por favor, verifique que los detalles en Account / Transactions sean correctos.

Ofertas de Sesión

Fanplayr tiene la capacidad de restringir ofertas específicas a sus usuarios para que solo puedan usarse una vez que sean presentadas por Fanplayr. Para más detalles, consulte la guía de implementación:

Ofertas de Sesión

Para probar las Session Offers, cree un cupón con el prefijo que haya configurado en su Fanplayr Configuration.

• Aplique este cupón a su carrito. Debería fallar.
• Observe la variable Javascript fanplayr._i[0].sessionOfferUrl. Debería ser una URL como esta https://myshop.com/fanplayr/coupon/session/?coupon_code=%c, incluyendo el %c al final.
• En una nueva pestaña, vaya a esta URL, reemplazando el %c con el cupón que acaba de intentar usar.
• Intente aplicar este cupón de nuevo. Ahora debería aplicarse correctamente (dadas otras restricciones que tenga en el cupón, como el monto mínimo de compra, etc.).

Si todo lo anterior es como se espera, ¡está listo para continuar! No dude en ponerse en contacto con nosotros si tiene alguna pregunta.

Variables Personalizadas de Fanplayr y JS Pre-ejecución

Dependiendo de la configuración de Magento, es posible que necesite definir variables personalizadas para que Fanplayr las use. Estas se definen en JS en window.fanplayr.custom.

Las variables actualmente disponibles son:

• embedUrl
• doNotTrack
• accountKey
• storeDomain
• applyToCartUrl
• sessionOfferUrl

[Los detalles de lo que hace cada variable se añadirán más adelante]

Dado que Magento 2 no permite fácilmente introducir JS para que aparezca en todas las páginas (a diferencia de Magento 1), hemos añadido la capacidad de agregar un fragmento de JS antes de que se incruste cualquier código específico de Fanplayr.

Puede introducir el código yendo a Stores / Settings / Configuration / Fanplayr / Smart and Targeted / Extras

A continuación se muestra un ejemplo del JS que añadiría para cambiar el embedUrl:

Variables Personalizadas

• embedUrl: Úselo para anular la URL base predeterminada que Fanplayr utilizará para acceder a las llamadas internas de Fanplayr.
• doNotTrack: Si se establece en cualquier valor verdadero, no realizará ningún seguimiento para esta página.
• accountKey: Úselo para anular la Fanplayr Account Key.
• storeDomain: Úselo para anular el dominio. Es decir, rastrear el dominio por idioma.
• applyToCartUrl: Úselo para anular la Apply To Cart URL. Puede ser necesario configurarla si cambia embedUrl.
• sessionOfferUrl: Úselo para anular la Session Offer URL. Puede ser necesario configurarla si cambia embedUrl.