Complemento de Adobe: addProductEvar
El complemento addProductEvar le permite agregar fácilmente a la variable products una eVar de comercialización de Adobe Analytics que utilice sintaxis de producto sin tener que preocuparse de si el contenido ya existente de la variable products se cambiará, moverá o eliminará. Adobe recomienda utilizar este complemento si desea agregar fácilmente eVars de comercialización que utilicen sintaxis de producto a la variable products. No es necesario usar el complemento addProductEvar si no utiliza eVars de comercialización con sintaxis de producto.
Instalación del complemento con el SDK web o la extensión del SDK web
Este complemento aún no es compatible con el SDK web.
Instalación del complemento con la extensión de Adobe Analytics
Adobe ofrece una extensión que le permite utilizar los complementos más utilizados con Adobe Analytics.
-
Inicie sesión en la Recopilación de datos de Adobe Experience Platform con sus credenciales de Adobe ID.
-
Haga clic en la propiedad de etiquetas deseada.
-
Vaya a la pestaña Extensiones y, a continuación, haga clic en el botón Catálogo.
-
Instalación y publicación de la extensión Common Analytics Plugins.
-
Si aún no lo ha hecho, cree una regla con la etiqueta “Inicializar complementos” con la siguiente configuración:
- Condición: Ninguna
- Evento: Core – Biblioteca cargada (Principio de página)
-
Añada una acción a la regla anterior con la siguiente configuración:
- Extensión: Common Analytics Plugins
- Tipo de acción: Inicializar addProductEvar
-
Guarde y publique los cambios en la regla.
Instalación del complemento con el editor de código personalizado de
Si no desea utilizar la extensión de complemento Common Analytics Plugins, puede utilizar el editor de código personalizado.
- Inicie sesión en la Recopilación de datos de Adobe Experience Platform con sus credenciales de Adobe ID.
- Haga clic en la propiedad deseada.
- Vaya a la pestaña Extensiones y, a continuación, haga clic en el botón Configurar en la extensión de Adobe Analytics.
- Expanda Configurar seguimiento con el código personalizado, que muestra el botón Abrir editor.
- 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.
- Guarde y publique los cambios en la extensión de Analytics.
Instalación del complemento con 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 (con s_gi). Conservar los comentarios y los números de versión del código en la implementación ayuda a Adobe a solucionar cualquier posible problema.
/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: addProductEvar v2.0 */
function addProductEvar(en,ev,ap){var e=en,f=ev,d=ap;if("-v"===e)return{plugin:"addProductEvar",version:"2.0"};a:{if("undefined"!==typeof window.s_c_il){var b=0;for(var c;b<window.s_c_il.length;b++)if(c=window.s_c_il[b],c._c&&"s_c"===c._c){b=c;break a}}b=void 0}if("undefined"!==typeof b&&(b.contextData.addProductEvar="2.0","string"===typeof e&&"string"===typeof f&&""!==f))if(d=d||!1,b.products){c=b.products.split(",");var g=c.length;d=d?0:g-1;for(var a;d<g;d++)a=c[d].split(";"),a[5]&&-1<a[5].toLowerCase().indexOf("evar")?a[5]=a[5]+"|"+e+"="+f:a[5]?a[5]=e+"="+f:a[5]||(a[4]||(a[4]=""),a[3]||(a[3]=""),a[2]||(a[2]=""),a[1]||(a[1]=""),a[5]=e+"="+f),c[d]=a.join(";");b.products=c.join(",")}else b.products=";;;;;"+e+"="+f};
/******************************************** END CODE TO DEPLOY ********************************************/
Uso del complemento
El complemento addProductEvar utiliza los siguientes argumentos:
en(obligatorio, cadena): La eVar que se agregará a la última entrada contenida actualmente en la variable products. Si la variable products está en blanco, el complemento crea una entrada de producto “en blanco” con el valor eVar adjunto al final de la entrada.ev(obligatorio, cadena): Valor asignado a la eVar.ap(opcional, booleano): Si la variable products contiene actualmente más de una entrada de producto, un valor de true (o 1) agrega la eVar a todas las entradas de producto. El valor predeterminado es false (o 0), lo que agrega la eVar solo a la última entrada contenida en la variable products.
El complemento addProductEvar no devuelve nada. En su lugar, agrega la eVar especificada en el argumento en y ev y su valor correspondiente a la variable products.
Ejemplos
// Set a merchandising eVar to blue on the last product. The output for the products variable is ";product1;3;300,;product2;2;122,;product3;1;25;;eVar1=blue"
s.products=";product1;3;300,;product2;2;122,;product3;1;25";
addProductEvar("eVar1", "blue");
// Set a merchandising eVar to blue on all products. The output for the products variable is ";product1;3;300;;eVar1=blue,;product2;2;122;;eVar1=blue,;product3;1;25;;eVar1=blue"
s.products=";product1;3;300,;product2;2;122,;product3;1;25";
addProductEvar("eVar1", "blue", true);
// Set multiple merchandising eVars to the last product in the string. The output for the products variable is ";product1;3;300;event2=10;eVar23=large\|eVar24=men|eVar1=blue,;product2;2;122,;product3;1;25;;eVar23=medium|eVar24=women|eVar1=red"
s.products=";product1;3;300;event2=10;eVar23=large|eVar24=men|eVar1=blue,;product2;2;122,;product3;1;25";
addProductEvar("eVar23", "medium");
addProductEvar("eVar24", "women");
addProductEvar("eVar1", "red");
// Set multiple merchandising eVars to all products in the string. The output for the products variable is ";product1;3;300;event2=10;eVar23=large|eVar24=men|eVar1=blue|eVar23=medium|eVar24=women|eVar1=red,;product2;2;122;;eVar23=medium|eVar24=women|eVar1=red,;product3;1;25;;eVar23=medium|eVar24=women|eVar1=red"
s.products=";product1;3;300;event2=10;eVar23=large|eVar24=men|eVar1=blue,;product2;2;122,;product3;1;25";
addProductEvar("eVar23", "medium", true);
addProductEvar("eVar24", "women", true);
addProductEvar("eVar1", "red", true);
// If the products variable is not set, the plug-in creates an empty product string correctly delimited to the merchandising eVar. The output for the products variable is ";;;;;eVar1=blue"
addProductEvar("eVar1", "blue");
Historial de versiones
2.0 (19 de marzo de 2021)
- Se ha añadido el número de versión como datos de contexto.
1.0 (7 de octubre de 2019)
- Versión inicial.