Pixel de ventas (script)

Pixel de ventas (script)

Warning
Estas instrucciones van dirigidas a personas con un mínimo conocimiento de lenguaje de programación web:  HTML y JAVASCRIPT.  Si no es tu caso, recomendamos que te pongas en contacto con tus desarrolladores y les facilites estas instrucciones. La instalación será muy fácil para ellos. 

Oct8ne permite monitorizar si una sesión de chat con un cliente, ha finalizado con una venta.

Para ello, se deberá realizar una petición hacia los servidores de Oct8ne mediante la introducción de un código javascript (snippet) en la página del comercio, donde se sepa con certeza que se ha finalizado una venta (página de confirmación de pedido, 'thank you page', etc.…).

A continuación, vemos un ejemplo un ejemplo del script final que se debe introducir en la página en cuestión:

  1. <script id="oct8ne-sale-notification" type="text/javascript" src='https://static.oct8ne.com/api/source/js/ext/sale-notification.js?license=XXXXXXXXXXXXXXXXXXXXXXXXXX&CurrencyCode=EUR&locale=es-ES&value=589,32€ &reference=KHWLILZLL&customerId=382442&contextInfo=%7B%27key1%27%3A%27value1% 27%2C%27key2%27%3A%27value2%27%7D'>
  2. </script>

Vamos a explicar cada elemento paso a paso.
La etiqueta script, tiene que contener el id "oct8ne-sale-notification", OBLIGATORIAMENTE.

El atributo src, se construye con diferentes elementos. Contiene los parametros que realizarán la petición, asi que es importante que se construya correctamente.

Ejemplo de src:

  1. https://[OCT8NE-STATIC-SERVER-HERE]api/source/js/ext/sale-notification.js?license=[YOUR- LICENSE]&currencyCode=[CURRENCY_ISO_CODE]&locale=[LOCALE]&value=[CART_VALUE]&ref erence=[ORDER_ID]&customerId=[CUSTOMER_ID]&contextInfo=[CONTEXT_INFO]

Info
 La variable [OCT8NE-STATIC-SERVER-HERE] hace referencia al servidor de Oct8ne en el que está dado de alta. Oct8ne trabaja con distintos servidores, en USA y en EU.

Una vez dentro del panel de control de Oct8ne, observe la dirección (url) del navegador:
Si es del tipo ‘backoffice.oct8ne.com’, le corresponde el servidor USA.
Si por el contrario es ‘backoffice-eu.oct8ne.com’, le corresponde el servidor EU.

El valor de la variable en función del servidor es
En EU,  [OCT8NE-STATIC-SERVER-HERE] → static-eu.oct8ne.com
En USA,  [OCT8NE-STATIC-SERVER-HERE] → static.oct8ne.com

Respecto a los parámetros de la petición del src:

license: Código de licencia que se le suministró en el momento de registrarse. [YOUR- LICENSE] (obligatorio)
currencyCode : Código estándar de la moneda en la que deben obtenerse los precios del detalle de pedido, por ejemplo “USD o “EUR”. Si no se indica, se usará la moneda por defecto del sitio web. [CURRENCY_ISO_CODE] (opcional)
locale: Código estándar del idioma en el que deben retornarse los resultados de la consulta, por ejemplo, “es-ES” o “en-US”. Si no se indica, se usará el idioma por defecto del sitio web. [LOCALE] (opcional)
value: Valor final del pedido realizado. Ejemplo: "1237,59 €". [CART_VALUE] (opcional)
reference: Identificador del pedido en el comercio. [ORDER_ID] (opcional)
customerId: Identificador del cliente en el comercio. [CUSTOMER_ID] (opcional)
contextInfo: Información adicional que se quiera guardar. Se trata de un objeto serializado como JSON con pares clave/valor arbitrarias Ejemplo: "{'key1':'value1','key2':'value2'}".  [CONTEXT_INFO] (opcional)


Info
El script ha de contener el id "oct8ne-sale-notification", OBLIGATORIAMENTE y el único parametro obligatorio es "license" . (ambos son requisitos!)
El valor del campo “license” está disponible en la sección Management > Instalación > CÓDIGO dentro del panel de control de Oct8ne. Es un valor ‘alfanumérico’ de 32 dígitos.
Los demás parametros se deben programar de manera que se obtengan de la propia web. 


    • Related Articles

    • Instalación de Oct8ne en tu página web

      Oct8ne se puede integrar en cualquier página web de tres formas distintas en función de tu plataforma y necesidades. 1.- Mediante Plugin. Si tu web está reallizada en una de las plataformas mas comunes, oct8ne pone a disposicion un "plugin / addon" ...

    • API Oct8ne de integración con CSM a medida

      Documentación del API Oct8ne Versión del API 2.4 (Octubre 2024 / rev05) Índice de contenidos 1. Introducción 2. Arquitectura 3. Vista general 3.1. Descargar e instalar plugin/extensión 3.2. Registro como desarrollador y activación de la plataforma ...

    • Integración de Oct8ne con Google Analytics 4

      Integración de Oct8ne con Google Analytics 4 Introducción Oct8ne permite la integración directa con Google Analytics versión 4 (GA4) a través del envío de eventos. Estos aportan información vital sobre las interacciones que se realizan dentro de ...

    • Instalar Oct8ne a través de Google Tag Manager (GTM)

      Integración de Oct8ne mediante Google Tag Manager (GTM) Para mostrar el código de Oct8ne en su página través Google Tag Manager (GTM) se deberán seguir los siguientes pasos: 1.- Entramos al Área de trabajo de GTM, y escogeremos la opción del menú ...

    • Información de contexto

      Estas instrucciones van dirigidas a personas con un mínimo conocimiento de lenguaje de programación web: HTML y CSS. Si no es tu caso, recomendamos que te pongas en contacto con tus desarrolladores y les facilites estas instrucciones. La instalación ...