Show Menu
TEMAS×

Complemento de Adobe:addProductEvent

Este complemento lo proporciona Adobe Consulting por cortesía para ayudarle a obtener más valor de Adobe Analytics. El Servicio de atención al cliente de Adobe no ofrece asistencia técnica con este complemento, incluida la instalación o solución de problemas. Si necesita ayuda con este complemento, póngase en contacto con el administrador de cuentas de su organización. Pueden organizar una reunión con un consultor para obtener ayuda.
El addProductEvent complemento agrega un evento numérico o de moneda a la products variable. Adobe recomienda utilizar este complemento si desea agregar un evento numérico o monetario a la products variable sin preocuparse por el formato de la cadena de producto. Este complemento no es necesario si no se utilizan eventos numéricos o monetarios en la products variable.

Instalación del complemento con la extensión Adobe Experience Platform Launch

Adobe ofrece una extensión que le permite utilizar los complementos más utilizados.
  1. Log in to launch.adobe.com using your AdobeID credentials.
  2. Haga clic en la propiedad que desee.
  3. Vaya a la ficha Extensiones y, a continuación, haga clic en el botón Catálogo
  4. Instalación y publicación de la extensión Common Analytics Plugins
  5. Si aún no lo ha hecho, cree una regla con la etiqueta "Inicializar complementos" con la siguiente configuración:
    • Condición: Ninguno
    • Evento: Core - Biblioteca cargada (Principio de página)
  6. Agregue una acción a la regla anterior con la siguiente configuración:
    • Extensión: Complementos comunes de Analytics
    • Tipo de acción: Inicializar addProductEvent
  7. Guarde y publique los cambios en la regla.

Instalación del complemento con el editor de código personalizado Iniciar

Si no desea utilizar la extensión del complemento, puede utilizar el editor de código personalizado.
  1. Log in to launch.adobe.com using your AdobeID credentials.
  2. Haga clic en la propiedad deseada.
  3. Vaya a la ficha Extensiones y, a continuación, haga clic en el botón Configurar en la extensión de Adobe Analytics.
  4. Expanda el seguimiento Configurar mediante el acordeón de código personalizado, que muestra el botón Abrir editor .
  5. Abra el editor de código personalizado y pegue el código del complemento que se proporciona a continuación en la ventana de edición.
  6. Guarde y publique los cambios en la extensión de Analytics.

Instalación del complemento mediante AppMeasurement

Copie y pegue el siguiente código en cualquier parte del archivo AppMeasurement después de crear una instancia del objeto de seguimiento de Analytics (mediante s_gi ). La conservación de los comentarios y los números de versión del código en la implementación ayuda a Adobe a solucionar cualquier problema potencial.
/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: addProductEvent v1.0 (Requires apl v3.1 and inList v2.0+ plug-ins) */
s.addProductEvent=function(en,ev,ap){var s=this;if("string"===typeof en)if(ev=isNaN(ev)?"1":String(ev),ap=ap||!1,s.events= s.apl(s.events,en),s.products){var e=s.products.split(",");ap=ap?0:e.length-1;for(var a;ap<e.length;ap++)a=e[ap].split(";") ,a[4]&&a[4].includes("event")?a[4]=a[4]+"|"+en+"="+ev:a[5]?a[4]=en+"="+ev:a[4]||(a[3]||(a[3]=""),a[2]||(a[2]=""),a[1]||(a[1]=""),a[4]=en+"="+ev),e[ap]=a.join(";");s.products=e.join(",")}else s.products=";;;;"+en+"="+ev};

/* Adobe Consulting Plugin: apl (appendToList) v3.2 (Requires inList v2.0 or higher) */
s.apl=function(lv,vta,d1,d2,cc){if(!lv||"string"===typeof lv){if("undefined"===typeof this.inList||"string"!==typeof vta||""===vta)return lv;d1=d1||",";d2=d2||d1;1==d2&&(d2=d1,cc||(cc=1));2==d2&&1!=cc&&(d2=d1);vta=vta.split(",");for(var g=vta.length,e=0;e<g;e++)this.inList(lv,vta[e],d1,cc)||(lv=lv?lv+d2+vta[e]:vta[e])}return lv};

/* Adobe Consulting Plugin: inList v2.1 */
s.inList=function(lv,vtc,d,cc){if("string"!==typeof vtc)return!1;if("string"===typeof lv)lv=lv.split(d||",");else if("object"!== typeof lv)return!1;d=0;for(var e=lv.length;d<e;d++)if(1==cc&&vtc===lv[d]||vtc.toLowerCase()===lv[d].toLowerCase())return!0;return!1};
/******************************************** END CODE TO DEPLOY ********************************************/

Utilizar el complemento

El addProductEvent método utiliza los siguientes argumentos:
  • en (requerido, cadena): Evento que se agregará a la última entrada de la products variable. Si la products variable está vacía, se crea una entrada de producto "en blanco" con el evento (y su valor) adjunto.
  • ev (requerido, cadena): El valor asignado al evento numérico o de moneda en el en argumento. El valor predeterminado es 1 cuando no se establece.
  • ap (opcional, booleano): Si la variable products contiene actualmente más de una entrada de producto, un valor de true (o 1 ) agrega el evento a todas las entradas de producto. El valor predeterminado es false cuando no se establece.
El addProductEvent no devuelve nada. En su lugar, agrega el evento y su valor a la products variable. El complemento también agrega automáticamente el evento a la events variable, ya que también se requiere allí.

Cookies

El complemento addProductEvent no crea ni utiliza cookies

Llamadas de ejemplo

Ejemplo #1

Si...
s.products=";product1;3;300,;product2;2;122,;product3;1;25"
s.events="purchase"

...y se ejecuta el siguiente código...
s.addProductEvent("event35", "25");

...el valor final de s.products será:
s.products=";product1;3;300,;product2;2;122,;product3;1;25;event35=25"

...y el valor final de s.events será:
s.events="purchase,event35"

Ejemplo #2

Si...
s.products=";product1;3;300,;product2;2;122,;product3;1;25"

...y se ejecuta el siguiente código...
s.addProductEvent("event35", 25, 1);

...el valor final de s.products será:
s.products=";product1;3;300;event35=25,;product2;2;122;event35=25,;product3;1;25;event35=25"

Cuando el tercer argumento es igual a true (o 1), cada entrada de producto tendrá el evento especificado en la llamada agregada a su valor

Ejemplo #3

Si...
s.products=";product1;3;300;event2=10;eVar33=large|eVar34=men|eVar35=blue,;product2;2;122,;product3;1;25"
s.events="purchase,event2"

...y se ejecuta el siguiente código...
s.addProductEvent("event33", "12");
s.addProductEvent("event34", "10");
s.addProductEvent("event35", "15");

... el valor final de s.products será...
s.products=";product1;3;300;event2=10;eVar33=large|eVar34=men|eVar35=blue,;product2;2;122,;product3;1;25;event33= 12|event34=10|event35=15"

...y s.events se configurarán de la siguiente manera:
s.events="purchase,event2,event33,event34,event35"

Ejemplo #4

Si...
s.products=";product1;3;300;event2=10;eVar33=large|eVar34=men|eVar35=blue,;product2;2;122,;product3;1;25"
s.events="purchase,event2"

...y se ejecuta el siguiente código...
s.addProductEvent("event33", "12", 1);
s.addProductEvent("event34", 10, 1); //The second argument can be an integer or a string representing an integer/number
s.addProductEvent("event35", "15", 1);

... el valor final de s.products será...
s.products=";product1;3;300;event2=10|event33=12|event34=10|event35=15;eVar33=large|eVar34=men|eVar35=blue, ;product2;2;122;event33=12|event34=10|event35=15,;product3;1;25;event33=12|event34=10|event35=15"

...y s.events se configurarán de la siguiente manera:
s.events="purchase,event2,event33,event34,event35"

Ejemplo #5

Si s.products no está configurada y se ejecuta el siguiente código...
s.addProductEvent("event35", "25");

...el valor final de s.products será:
s.products=";;;;event35=25"

En este caso, event35 también se agregará al final de s.events

Historial de versiones

1.0 (7 de octubre de 2019)

  • Versión inicial.