Skip to content

Latest commit

 

History

History
724 lines (517 loc) · 40.1 KB

TAGGINGPLAN_ES.md

File metadata and controls

724 lines (517 loc) · 40.1 KB

Plan de tagging SDK Android

Tracking de una aplicación webview

En lo que concierne a la navegación en una aplicación de tipo webview en Android (sitio web html/js standard), la URL de apertura debe proporcionar nuestro ID interno para asegurar la continuidad del seguimiento. Para recuperar este valor, el soporte técnico del cliente debe usar la función siguiente definida en nuestro SDK: * Android :

String euidl = EAnalytics.getEUIDL();

Una vez se añade este valor al parámetro ea-euidl-bypass, bloquearemos el sistema de cookies normal para usar el euidl proveniente de la aplicación.

Ejemplo:

http://www.vpg.fr/ios-landing-webview?ea-euidl-bypass=$euidl_de_l_app

Si el ea.js detecta este parámetro, lo utilizará y lo guardará durante toda la sesión, para evitar que el sitio lo reenvíe con cada página visitada. Una vez se pasa este parámetro, el tracking de una aplicación iOS en contexto webview no difiere de los formatos JavaScript que usamos para una web clásica.

La documentación disponible en esta dirección contiene toda la información necesaria para la implementación de nuestros Tags JavaScript.

Tracking de una aplicación nativa

En el caso de una aplicación nativa, nuestra SDK debe incorporarse al código de la aplicación para poder integrar el tipo de marcador siguiente:

EAProperties properties = new EAProperties.Builder("NOM_PAGE”).build();
Eanalytics.getInstance().track(properties);

Nuestra SDK se ha concebido para facilitar al máximo la integración ofreciendo una estructura simple y una documentación detallada. Los parámetros disponibles y las posibilidades son exactamente las mismas. Podrás hacer un seguimiento del rendimiento de tu aplicación como si fuese una web clásica integrando las mismas variables.

Las llamadas generadas por estos marcadores se acercan también a las del colector clásico, y han sido concebidas para ser lo más ligeras posible para no perturbar la aplicación.

Algunos parámetros de nuestro colector son específicos al tracking de una aplicación móvil. Para saber más acerca de esto puedes consultar [esta documentación] (https://eulerian.wiki/doku.php?id=es:collect:technical_implementation:parameters_list).

Nuestra SDK también puede recoger un número ilimitado de interacciones offline y enviarlas una vez el usuario se conecta. Este procedimiento nos permite hacer un seguimiento del usuario incluso si éste usa la aplicación sin conexión. La navegación queda registrada y se reatribuye posteriormente a través de nuestro parámetro ereplay-time.

Règle d'affectation de trafic

Regla de afectación de tráfico

En un sitio web clásico, nuestro sistema identifica y afecta el tráfico en función de la URL sobre la que se llama al marcador. Todavía no tenemos acceso a esta información en el contexto de una aplicación

Para definir la regla de atribución del tráfico, nos basamos en el subdominio de tracking utilizado y pasado en parámetro con el método initialize de nuestra SDK:

public class YourApp extends Application {
     @Override
    public void onCreate() {
        super.onCreate();
        EAnalytics.init(this, "DOMAINE_DE_TRACKING", true);
    }
 }
Esto significa también que si usas el mismo subdominio de tracking para varias de tus aplicaciones, tendremos que distinguirlos añadiendo el parámetro [from] (https://eulerian.wiki/doku.php?id=es:collect:technical_implementation:parameters_list) en nuestros marcadores. Así será automáticamente para una aplicación hibrida que comparte páginas en común con tu sitio web.

Igualmente cabe señalar que la ausencia de URL significa también la ausencia de un nombre de página por defecto. El parámetro path no es opcional sino obligatorio en el seguimiento de una aplicación.

El tráfico generado por tu aplicación se puede rastrear en un sitio de Eulerian dedicado o fusionarse con el de otro sitio web existente. Como se ha indicado anteriormente, si tu aplicación pasa a modo webview para algunas páginas es obligatorio añadir el parámetro from para que podamos redirigir el tráfico correctamente a nuestros sistemas.

Configuración de descargas y actualizaciones

Descripción de parámetros asociados:

  • ea-appname: NOM_APPLICATION, corresponde al nombre de la aplicación. Este último no debe cambiar
  • ea-appversion: VERSION_APPLICATION, corresponde a la versión de la aplicación
  • ea-appinstalled: 1, Este parámetro indica que no deben contarse nuevas instalaciones para este dispositivo. Se utiliza para gestionar la inicialización de los usuarios que ya tenían la aplicación antes de la implementación con Eulerian.

Este parámetro puede ser proporcionado en cualquier momento, en paralelo del appversion y appname, siempre y cuando la aplicación considere que ya ha sido lanzada previamente en este dispositivo/usuario.

La presencia del parámetro ea-appname inicia un tratamiento a nivel de sistema.

El sistema abastecerá el valor descarga si:

  • El usuario no ha estado jamás expuesto al valor del parámetro ea-appname al momento de apertura de la aplicación y el parámetro ea-appinstalled no está presente en la llamada

El sistema abastecerá el valor Actualización si:

  • El usuario ha estado expuesto al parámetro ea-appname y su valor se indica tras la última apertura de la aplicación. En cambio, el valor del parámetro ea-appversion es distinto.

download_upgrade.png

Integración a través de jitpack

Dentro del tracking de aplicaciones móviles, jitpack te permite simplificar el proceso de integración de la.

Instalación

Inserta la SDK Android en la herramienta Gradle.

dependencies {
   compile 'com.eulerian.android.sdk:eanalytics:1.9.0'
}

En el archivo AndroidManifest.xml, añade los permisos siguientes:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

Iniciar Eulerian Analytics

Antes de usar SDK, asegúrate que lo has iniciado con la función onCreate() más abajo.

<!-- in your AndroidManifest.xml-->
<application
   android:name=".DemoApp">
public class DemoApp extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        EAnalytics.init(this, "example.demo.com", false);
    }

}

A partir de ahora es posible integrar todo tipo de tags acompañados de sus parámetros. Por ejemplo, el tag genérico se identifica gracias a EAProperties. Los otros tipos de tags tienen una identificación específica(ex : EACart para la cesta, EAEstimate para el presupuesto, EAProducts para la categoría, etc.).

EASearch search = new EASearch.Builder("/path-example", "banana")
                .setParams(new Params.Builder()
                        .addParam("provenance", "martinique")
                        .addParam("couleur", "jaune")
                        .build())
                .setResults(42)
                .build();

EAnalytics.getInstance().track(search)

Lista de páginas

  • Página genérica
  • Página de producto
  • Página de categoría
  • Página de motor de búsqueda
  • Página de error
  • Página de presupuesto
  • Página de cesta
  • Página de pedido

Página genérica

El marcador a continuación es genérico y debe implementarse en todas las páginas del sitio web excepto en la de la ficha de producto, pedido, presupuesto y cesta iniciada. Esto incluye principalmente la página de inicio y las páginas del túnel de conversión entre la cesta y la confirmación del pedido.

Te permite subir todo el tráfico site-centric, las páginas vistas y las visitas, así como su origen a través de los canales naturales como el acceso directo, la indexación y los referentes.

Nosotros controlamos de forma descentralizada todas las acciones que se implementarán más tarde. De este modo, no necesitamos cambiar el código de la página de tu sitio web para disfrutar de funcionalidades adicionales.

Para tener informes más completos puedes añadir los parámetros a continuación al formato genérico o al conjunto de marcadores colectores descritos en esta documentación.

Liste des paramètres

  • path : (NOM_PAGE) Este parámetro permite nombrar la página para identificarla más tarde en los informes. Para saber más puedes consultar el [artículo siguiente] (https://eulerian.wiki/doku.php?id=es:collect:technical_implementation:parameters_list).
  • uid : (UID) Este parámetro debe completarse con tu ID interna cuando el internauta está conectado para consolidar los datos del historial provenientes de diferentes dispositivos. Puedes reconciliar un clic con la descarga de la aplicación. Para saber más puedes consultar el artículo siguiente.

Implementación

El objeto EAProperties es la categoría que contiene todos los parámetros internos o modificables de nuestro colector de tags.

Para añadir un nuevo parámetro, usa el método nativo setCLE(VALEUR) o el método genérico set("CLE","VALEUR").

Ejemplo:

EAProperties genericTag = new EAProperties.Builder(path: String)
                        .setPageGroup(String)
                        .setUID(String)
                        .setEmail(String)
                        .setProfile(String)
                        .set(String - KEY,String - VALUE)
                        .build();
EAnalytics.getInstance().track(genericTag);

Con valores:

EAProperties genericTag = new EAProperties.Builder("NOM_PAGE")
                        .setPageGroup("MY-PAGEGROUP")
                        .setUID("123asd")
                        .setEmail("test@test.fr")
                        .setProfile("visitor")
                        .set("KEY-CUSTOM-PARAMETER","VALUE")
                        .build();
EAnalytics.getInstance().track(genericTag);;

Página de producto

Este marcador permite recuperar las páginas vistas y las visitas a productos de tu catálogo. Sirve principalmente para abastecer los informes disponibles en la siguiente dirección:

  • Site-centric > Productos > **Adquisición & rendimiento de producto **

También puedes pasar una o varias categorías de producto.

Nota: Se considera una página de producto todo marcador que contenga solamente una referencia de producto sin los parámetros scart estimate ref y amount.

En general, nuestro sistema no reconocerá como marcador de página de producto un marcador colector que contenga uno de los parámetros citados más arriba o varias referencias de producto.

Lista de parámetros

  • path: (NOM_PAGE) Este parámetro permite nombrar la página para identificarla más tarde en los informes. Para saber más puedes consultar el artículo siguiente.
  • uid: (UID) Este parámetro debe completarse con tu ID interna cuando el internauta está conectado para consolidar los datos del historial provenientes de diferentes dispositivos. Puedes reconciliar un clic con la descarga de la aplicación. Para saber más puedes consultar el artículo siguiente.
  • prdref: (ID_PRODUIT) Ce paramètre doit être valorisé avec la référence du produit consulté par l'internaute. Pour plus d'informations, veuillez consulter l'article suivant.
  • prdname : (NOM_PRODUIT) Este parámetro debe valorarse con la referencia de producto consultada por el internauta. Para saber más puedes consultar el artículo siguiente.
  • prdgroup : (GROUPE) Puedes asociar un grupo a una referencia de producto. Este parámetro permite asocia un margen a un producto a través de una asociación a un grupo “A” o “B”. Por tanto, cada una de las etiquetas designa el grupo de margen sin divulgar el total exacto en nuestro colector de tags. Para saber más puedes consultar el artículo siguiente.
  • prdparam-xxxxx: (VALEUR_PARAM, NOM_PARAM) Este parámetro permite asociar una categoría a la referencia del producto. Debes precisar el nombre de la categoría tras el prefijo prdparam-. Por ejemplo, prdparam-universo, prdparam-talla, etc. También puedes añadir tantas categorías como quieras. Para saber más puedes consultar el artículo siguiente.

Implementación

El objeto EAProducts es la categoría dedicada al tracking de páginas de producto.

El producto debe ser creado a través del objeto EAOProduct que se convierte en parámetro obligatorio. Cada objeto Product puedo completarse con un objeto Params para asociarle uno o varios parámetros de producto. Una vez se ha iniciado y completado el producto con los parámetros deseados, intégralo al objeto EAProducts a través del método addProduct.

Ejemplo:

// custom product parameters
Params paramProduct = new Params.Builder()
.addParam(String - key, String - Value) //prdparam-category
.addParam(String - key, String - Value) //prdparam-brand
.build();


Product product1 = new Product.Builder(String - prdref) //prdref
.setName(String -prdname) //prdname
.setGroup(String -prdgroup) //prdgroup
.setParams(Params paramProduct)
.build();


EAProducts productPage = new EAProducts.Builder("NOM_PAGE")
.setPageGroup(String)
.setUID(String)
.setEmail(String)
.setProfile(String)             
.addProduct(produit1)
.build();

EAnalytics.getInstance().track(productPage);

Con valores:

Params paramProduct = new Params.Builder()
.addParam("categoyr", "clothes") //prdparam-category
.addParam("brand", "nike") //prdparam-brand
.build();


Product product1 = new Product.Builder("ref-product") //prdref
.setName("name-product") //prdname
.setGroup("group-product") //prdgroup
.setParams(paramProduct)
.build();


EAProducts productPage = new EAProducts.Builder("NOM_PAGE")
.setPageGroup("my-pagegroup")
.setUID("123asd")
.setEmail("test@test.fr")
.setProfile("looker")             
.addProduct(product1)
.build();

EAnalytics.getInstance().track(productPage);

Page de resultado

Este marcador permite enviar a tus partners las 3 primeras referencias de producto que se muestran en la página de resultados para optimizar el retargeting de internautas en tu página. Su uso se limita principalmente a nuestro producto Eulerian Tag Master y no produce ningún efecto en los informes de adquisición&rendimiento en la DDP de Eulerian.

Nota: Se considera una página de resultado todo marcador que contenga varias referencias de producto sin los parámetros scart estimate ref y amount.

En caso de que tu página de resultado solo tenga una referencia de producto, y por tanto un solo parámetro prdref, nuestro sistema reconocerá el marcador como página de producto y no como página de resultado.

Lista de parámetros

  • path : (NOM_PAGE) Este parámetro permite nombrar la página para identificarla más tarde en los informes. Para saber más puedes consultar el artículo siguiente.
  • uid : (UID) Este parámetro debe completarse con tu ID interna cuando el internauta está conectado para consolidar los datos del historial provenientes de diferentes dispositivos. Puedes reconciliar un clic con la descarga de la aplicación. Para saber más puedes consultar el artículo siguiente.
  • prdref : (ID_PRODUIT) Este parámetro debe valorarse con la referencia de producto consultada por el internauta. Para saber más puedes consultar el artículo siguiente.

Implementación

Usa el objeto EAProducts para este tipo de Tag y pasa los primero X productos mostrados.

El producto debe ser creado a través del objeto Product que se convierte en parámetro obligatorio. Una vez que éste se inicia y se completa con los parámetros deseados, intégralo al objeto EAProducts a través del método addProduct.

Ejemplo:

Product produit1 = new Product.Builder(String - product ref).build(); 
Product produit2 = new Product.Builder(String - product ref).build(); 
Product produit3 = new Product.Builder(String - product ref).build(); 
 
EAProducts resultPage = new EAProducts.Builder(path: String)
.setPageGroup(String!)
.setUID(String!)
.setEmail(String!)             
.addProduct(Product product)
.addProduct(Product product)
.addProduct(Product product)
.build();
 
EAnalytics.getInstance().track(resultPage);

Con valores:

Product produit1 = new Product.Builder("ref-product1").build(); 
Product produit2 = new Product.Builder("ref-product2").build(); 
Product produit3 = new Product.Builder("ref-product3").build(); 
 
EAProducts resultPage = new EAProducts.Builder("nom-de-page")
.setPageGroup("my-pagegroup")
.setUID("123asd")
.setEmail("test@test.fr")             
.addProduct(produit1)
.addProduct(produit2)
.addProduct(produit3)
.build();
 
EAnalytics.getInstance().track(resultPage);

Página de motor de búsqueda

El marcador de motor de búsqueda interna permite abastecer la interfaz con información sobre consultas de los internautas y un número ilimitado de parámetros adicionales. Toda la información se compara con las ventas generadas y los canales de adquisición activados durante la sesión.

Nota: Se considera una página motor de búsqueda interna todo marcador que contenga el parámetro isearchengine.

Debe tenerse en cuenta que el marcador de motor de búsqueda no es exclusivo. Si añades una referencia de producto con el parámetro prdref por ejemplo, nuestro sistema considerará el marcador como página de producto.

Lista de parámetros

  • path: (NOM_PAGE) Este parámetro permite nombrar la página para identificarla más tarde en los informes. Para saber más puedes consultar el artículo siguiente.
  • uid: (UID) Este parámetro debe completarse con tu ID interna cuando el internauta está conectado para consolidar los datos del historial provenientes de diferentes dispositivos. Puedes reconciliar un clic con la descarga de la aplicación. Para saber más puedes consultar el artículo siguiente.
  • isearchengine: (NOM_MOTEUR_INTERNE) Este parámetro permite nombre el motor de búsqueda interna y distinguirlo de los otros campos de búsqueda si hay varios en tu página. Para saber más puedes consultar el artículo siguiente.
  • isearchresults: (NOMBRE_DE_RESULTATS) Este parámetro debe contener el número de resultados de búsqueda generados por el internauta. Para saber más puedes consultar el artículo siguiente.
  • isearchkey : (CLE_DU_PARAMETRE_RECHERCHE) Este parámetro debe completarse con la llave del campo adicional que deseas integrar en tu marcador de búsqueda interna. Para saber más puedes consultar artículo siguiente.
  • isearchdata : (VALEUR_DU_PARAMETRE_RECHERCHE) Este parámetro debe contener el valor del campo isearchkey citado más arriba. A cada campo de búsqueda suplementaria deben añadirse los parámetros isearchkey y isearchdata. Para saber más puedes consultar el artículo siguiente.

Implementación

El objeto EASearch es la categoría dedicada al tracking del motor de búsqueda interna

Crea un objeto Params y usa el método addParam para los parámetros isearchkey, isearchdata.

Ejemplos:

Params param1 = new Params()
.addParam("CLE_DU_PARAMETRE_DE_RECHERCHE_1","VALEUR_DU_PARAMETRE_RECHERCHE_1")
.addParam("CLE_DU_PARAMETRE_DE_RECHERCHE_2","VALEUR_DU_PARAMETRE_RECHERCHE_2")
.addParam("CLE_DU_PARAMETRE_DE_RECHERCHE_3","VALEUR_DU_PARAMETRE_RECHERCHE_3")
.build();

EASearch searchPage = new EASearch.Builder("NOM_PAGE", "NOM_MOTEUR")
.setUID("UID")
.setResults(NOMBRE_DE_RESULTATS)
.setParams(param1)
.build();

EAnalytics.getInstance().track(searchPage);

Con valores:

Params param1 = new Params()
.addParam("motcle","veste")
.addParam("montant_min","100.00")
.addParam("montant_max","400.00")
.build();

EASearch searchPage = new EASearch.Builder("Moteur_interne|veste", "moteur_interne")
.setUID("34678")
.setResults(150)
.setParams(Params)
.build();

EAnalytics.getInstance().track(searchPage);

Página de error 404

El marcador error indica que la aplicación de la página ha generado un error 404. Esto sirve para abastecer los informes disponibles en la página siguiente:

  • Site-centric > Análisis de audiencia > Por página > Página de error

Este tag permite recuperar todas las URLs que han generado una página 404 y te da la posibilidad de hacer las correcciones necesarias para redirigir tu tráfico.

Puedes usarlo para estar al tanto de problemas recurrentes en una etapa concreta del túnel de conversión.

Lista de parámetros

  • error: (Obligatorio) Este parámetro es siempre 1 y puede añadirse a todos los tipos de marcador. Su presencia contabiliza una página vista en el informe más arriba. Para saber más puedes consultar el artículo siguiente.
  • path: (Obligatorio) Este parámetro permite nombrar la página para identificarla más tarde en los informes. Para saber más puedes consultar el artículo siguiente.

Implementación

Utiliza el método set con la clave de error para indicar la página de error.

Ejemplo:

EAProperties errorTag = new EAProperties.Builder("erreur|404")
.set("error","1")
.build();
Eanalytics.getInstance().track(errorTag);

Página de presupuesto

Este marcador contabiliza los presupuestos y el conjunto de informaciones asociadas a este tipo de conversión:

  • Los productos que lo componen
  • El tipo de presupuesto
  • El total global
  • Informaciones contextuales

Cada nuevo presupuesto se detalla con todos los canales del historial de navegación que han conducido a su generación.

Nota: Se eliminarán los dobles de todos los presupuestos en función de la referencia proporcionada con el marcador.

Si usas 2 veces la misma referencia para 2 presupuestos diferentes, se ignorará la segunda llamada en virtud del principio de unicidad de conversión. Eulerian Analytics te permite anular o validar presupuestos para medir el rendimiento real de tus campañas en el tiempo.

Nota: Se considera una página de presupuestos todo marcador que contenga los parámetros ref y estimate.

Lista de parámetros

  • path : (NOM_PAGE) Este parámetro permite nombrar la página para identificarla más tarde en los informes. Para saber más puedes consultar el artículo siguiente.
  • uid : (UID) Este parámetro debe completarse con tu ID interna cuando el internauta está conectado para consolidar los datos del historial provenientes de diferentes dispositivos. Puedes reconciliar un clic con la descarga de la aplicación. Para saber más puedes consultar el artículo siguiente.
  • ref : (REFERENCE_DEVIS) Se trata de una referencia única del presupuesto que permite identificarlo y encontrarlo el nuestro sistema. Para saber más puedes consultar el artículo siguiente.
  • amount : (MONTANT_DEVIS) Este parámetro debe contener el total del presupuesto, IVA incluido. Los decimales se separán por un punto. Para saber más puedes consultar el artículo siguiente.
  • type : (TYPE_DE_DEVIS) Este parámetro permite categorizar el presupuesto según tu propio sistema de referencia. Para saber más puedes consultar el artículo siguiente.
  • prdref : (ID_PRODUIT) Este parámetro debe completarse con la referencia de producto asociada al presupuesto y repetida en cada valor diferente. Para saber más puedes consultar el artículo siguiente.
  • prdamount : (MONTANT_PRODUIT) Este parámetro permite especificar el total unitario de cada producto asociado al presupuesto. Para saber más puedes consultar el artículo siguiente.
  • prdquantity : (QUANTITE_PRODUIT) Este parámetro permite especificar las cantidades de cada producto asociado al presupuesto. Para saber más puedes consultar el artículo siguiente.

Implementación

El objeto EAEstimate es la categoría dedicada al tracking de páginas de presupuesto.

Un presupuesto puede contener uno o varios productos. Cada producto que constituye el presupuesto debe crearse a través del objeto Product que se convierte en parámetro obligatorio. Cada objeto Product debe iniciarse y completarse con los parámetros elegidos antes de ser integrado al objeto EAEstimate a través del método addProduct.

Ejemplo:

Product produit1 = new Product.Builder(String - id-product).build();
Product produit2 = new Product.Builder(String - id-product).build();

EAEstimate estimatePage = new EAEstimate.Builder(String - page-name, String - id-estimate)
.setPageGroup(String!)
.setUID(String!)
.setEmail(String!) 
.setType(String!)
.setAmount(Double!)
.set(String key, String value) //custom param
.addProduct(Product product, Double - amount,Int - quantity)
.addProduct(Product product, Double - amount,Int - quantity)
.build();
 
EAnalytics.getInstance().track(estimatePage);

Con valores:

Product produit1 = new Product.Builder("505").build();

EAEstimate estimatePage = new EAEstimate.Builder("Credit|devis", "C4536567")
.setPageGroup("my-pagegroup")
.setUID("123asd")
.setEmail("test@test.fr") 
.setAmount(5000.00)
.setType("Credit_48mois")
.set("custom-param-KEY", "custom-param-value") //custom param
.addProduct(produit1, 5000.00, 1)
.build();
 
EAnalytics.getInstance().track(estimatePage);

Página de cesta

Este marcador contabiliza las cestas iniciadas y permita calcular la tasa de conversión y de abandono con respecto al marcador de venta.

También puedes pasar los productos y categorías de productos asociados a la cesta del visitante especificando los totales y las cantidades respectivas. Estos parámetros permiten abastecer los informes de productos disponibles en la dirección siguiente:

  • Site-centric > Productos > Adquisición & rendimiento de producto

La duración de vida de una cesta es de 30 minutos durante la sesión del internauta, según [[fr:glossary|nuestra definición]].

Nota: Se considera una página de cesta todo marcador que contenga el parámetro scart.

Lista de parámetros

  • path: (Obligatorio) Este parámetro permite nombrar la página para identificarla más tarde en los informes. Para saber más puedes consultar el artículo siguiente.
  • uid : (Opcional) Este parámetro debe completarse con tu ID interna cuando el internauta está conectado para consolidar los datos del historial provenientes de diferentes dispositivos Puedes reconciliar un clic con la descarga de la aplicación. Para saber más puedes consultar el artículo siguiente.
  • scartcumul : (Obligatorio) El valor de este parámetro indica el modo de contabilización de los productos en la cesta. Cuando es igual a 0, nuestro sistema interpreta los productos pasados por el marcador como constituyentes de la integridad de la cesta. Cuando es igual a 1, los productos pasados por el marcador se añaden a cada llamada sucesiva. Para saber más puedes consultar artículo siguiente.
  • prdref : (Obligatoire) Este parámetro debe completarse con la referencia del producto incluido por el internauta en la cesta y repetido para cada producto diferente. Para saber más puedes consultar el artículo siguiente.
  • prdamount : (Obligatorio) Este parámetro permite especificar el total unitario de cada producto asociado al presupuesto. Para saber más puedes consultar el artículo siguiente.
  • prdquantity : (Obligatorio) Este parámetro permite especificar las cantidades de cada producto asociado al presupuesto. Para saber más puedes consultar el artículo siguiente.

Implementación

El objeto EACart es la categoría dedicada al tracking de la página de cesta iniciada.

Una cesta puede contener uno o varios productos. Cada producto que constituye la cesta debe crease a través del objeto Product que se convierte en parámetro obligatorio. Cada objeto Product debe iniciarse y completarse con los parámetros deseados antes de ser integrado en el objeto EACart a través del método addProduct.

Ejemplo:

Params paramProduct = new Params.Builder()
.addParam(String Key, String value) 
.addParam(StringKey, String value)  
.build();
//add more if more products

Product product1 = new Product.Builder(String ref-product)
.setName(String!)
.setParams(Params paramProduct)
.build(); 
//add more if more products

EACart cartPage = new EACart.Builder(String path)
.setPageGroup(String!)
.setUID(String!)
.setEmail(String!) 
.setProfile(String!)
.setCartCumul(Bool!) 
.addProduct(produit1, Double amount, Int quantity)
//add more if more products
.build();
 
EAnalytics.getInstance().track(cartPage);

Con valores:

Params paramProduct = new Params.Builder()
.addParam("category", "T-Shirt") //prdparam-category
.addParam("brand", "Nike")       //prdparam-brand  
.build();
//add more if more products

Product product1 = new Product.Builder("product-123")
.setName("product-name")
.setParams(paramProduct)
.build(); 
//add more if more products

EACart cartPage = new EACart.Builder("page-name")
.setPageGroup("my-page-group")
.setUID("123asd")
.setEmail("test@test.fr") 
.setProfile("shopper")
.setCartCumul(true or false) 
.addProduct(produit1, 50.30, 2)
//add more if more products
.build();
 
EAnalytics.getInstance().track(cartPage);;

Página de pedido

Este marcador contabiliza las conversiones y permite el cálculo del ROI para el conjunto de canales marketing. Además del total global del pedido, puedes pasar productos asociados, el modo de pago, la divisa o el tipo de venta. Estas prioridades proporcionarán más detalles a tus análisis y podrán explotarse en nuestra suite. Cada nueva conversión aparece detallada con los canales y el historial de navegación.

Nota: Se eliminarán los dobles de todos los pedidos en función de la referencia proporcionada en el marcador de venta.

Si usas 2 veces la misma referencia para 2 pedidos diferentes, se ignorará la segunda llamada en virtud del principio de unicidad de conversión.

Eulerian Analytics te permite anular los pedidos para medir el rendimiento real de tus campañas. Por tanto, se aconseja implementar el marcador de pedido lo antes posible en el proceso de compra si las informaciones para configurar su llamada están disponibles (referencia, total, tipo de pago, etc.).

De hecho, si la plataforma de pago no obliga al internauta a pasar de nuevo por la página de compra para validar su pedido, no siempre se llamará al marcador tras la plataforma de pago.

Nota: Fuera del status del pedido (pendiente, válido o inválido), se puede definir el contenido de un pedido tras haber sido registrado. No podemos añadir o quitar un producto pero sí modificar el total global del pedido.

Nota: Se considera una página de confirmación todo marcador que contenga los parámetros ref y amount y que no contenga scart ni estimate.

Lista de parámetros

  • path: (NOM_PAGE) Este parámetro permite nombrar la página para identificarla más tarde en los informes. Para saber más puedes consultar el artículo siguiente.
  • uid : (UID) Este parámetro debe completarse con tu ID interna cuando el internauta está conectado para consolidar los datos del historial provenientes de diferentes dispositivos. Puedes reconciliar un clic con la descarga de la aplicación. Para saber más puedes consultar el artículo siguiente.
  • ref : (REFERENCE_VENTE) Se trata de una referencia única del presupuesto que permite identificarlo y encontrarlo el nuestro sistema. Para saber más puedes consultar el artículo siguiente.
  • amount : (MONTANT_VENTE) Este parámetro debe contener el total del presupuesto, IVA incluido. Los decimales se separan por un punto. Para saber más puedes consultar el artículo siguiente.
  • payment : (MOYEN_DE_PAIEMENT) Este parámetro permite identificar el tipo de pago usado por el internauta. Para saber más puedes consultar el artículo siguiente.
  • type : (TYPE_DE_VENTE) Este parámetro permite categorizar el presupuesto según tu propio sistema de referencia. Para saber más puedes consultar el artículo siguiente.
  • currency : (DEVISE_DU_MONTANT) Este parámetro permite convertir el total indicado en el parámetro amount si este tiene una divisa diferente a la configurada en la interfaz. Para saber más puedes consultar el artículo siguiente.
  • newcustomer : (0_OU_1) Este parámetro se suele usar en el marcador de pedido para diferenciar los nuevos compradores de los clientes asiduos. Para saber más puedes consultar el artículo siguiente.
  • prdref : (ID_PRODUIT) Este parámetro debe completarse con la referencia de producto asociada al presupuesto y repetida en cada valor diferente. Para saber más puedes consultar el artículo siguiente.
  • prdamount : (MONTANT_PRODUIT) Este parámetro permite especificar el total unitario de cada producto asociado al presupuesto. Para saber más puedes consultar el artículo siguiente.
  • prdquantity : (QUANTITE_PRODUIT) Este parámetro permite especificar las cantidades de cada producto asociado al presupuesto. Para saber más puedes consultar el artículo siguiente.

Implementación

El objeto EAOrder es la categoría dedicada al tracking de la página de confirmación de pedido.

Una venta puede contener uno o varios productos. Cada producto que constituye el presupuesto debe crearse a través del objeto Product que se convierte en parámetro obligatorio. Cada objeto Product debe iniciarse y completarse con los parámetros elegidos antes de ser integrado al objeto EAOrder ** a través del método addProduct.

Ejemplo:

Params paramProduct = new Params.Builder()
.addParam(String Key, String value) 
.addParam(StringKey, String value)  
.build();
//add more if more products

Product product1 = new Product.Builder(String ref-product)
.setName(String!)
.setParams(Params paramProduct)
.build(); 
//add more if more products
 
EAOrder orderPage = new EAOrder.Builder(String path, String id-sale)
.setPageGroup(String!)
.setUID(String!)
.setEmail(String!) 
.setProfile(String!)
.setNewCustomer(Bool!)

.setAmount(Double!)
.setType(String!)
.setPayment(String!)
.setCurrency(String!)

.setEstimateRef(String!)

.set(String key, String value) //custom param
.addProduct(produit1, Double amount, Int quantity)
//add more if more products
.build();
 
EAnalytics.getInstance().track(orderPage);

Con valores:

Params paramProduct = new Params.Builder()
.addParam("category", "T-Shirt") //prdparam-category
.addParam("brand", "Nike")       //prdparam-brand  
.build();
//add more if more products

Product product1 = new Product.Builder("product-123")
.setName("product-name")
.setParams(paramProduct)
.build(); 
//add more if more products

EAOrder orderPage = new EAOrder.Builder("Tunnel|Confirmation", "F654335671")
.setPageGroup("my-pagegroup")
.setUID("123asd")
.setEmail("test@test.fr") 
.setProfile("buyer")
.setNewCustomer(true ou false)

.setAmount(50.30)
.setType("online")
.setPayment("credit card")
.setCurrency("EUR")

.setEstimateRef("asd123qwe")

.set("custom-param-key", "custom-param-value") //custom param
.addProduct(product1, 25.15, 2)
//add more if more products
.build();
 
EAnalytics.getInstance().track(orderPage);

El objeto SiteCentricCFlag es la clase dedicada al "Context Flag"

Puede crear uno o más "Context Flags" a través del objeto SiteCentricCFlag y añadirlos con la función ".setCFlag". La función ".set" toma como argumentos "string key", "string...value" con uno o más valores con un máximo de 10 valores

Exemple:

import com.eulerian.android.sdk.SiteCentricCFlag;

// exemple for a generic tag
EAProperties genericTag = new EAProperties.Builder(path) //path
                        .setUID(UID) // UID
                        .setEmail("email")
                        .setProfile("profile")
                        .set("KEY","VALUE")
                        .set("KEY2","VALU1,VALUE2,VALUE3")
                        .setCFlag(new SiteCentricCFlag.Builder()
                                .set("categorie_1", "rolandgarros", "wimbledon")
                                .set("categorie_2", "tennis")
                                .set("categorie_3", "usopen")
                                .build())
                        .build();