Show Menu
TEMAS×

Complemento de Adobe: manageVars

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 manageVars complemento le permite manipular los valores de varias variables de Analytics a la vez. También puede definir valores en minúsculas o eliminar caracteres innecesarios de varios valores de variables al mismo tiempo. Adobe recomienda utilizar este complemento si desea limpiar el valor de varias variables a la vez.

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 Extensions y haga clic en el Catalog
  4. Instalación y publicación de la Common Analytics Plugins extensión
  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 manageVars
  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 Extensions ficha y, a continuación, haga clic en el Configure botón situado debajo de la extensión de Adobe Analytics.
  4. Expanda el Configure tracking using custom code acordeón, que muestra el Open Editor botón.
  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: manageVars v2.1 (Requires pt plug-in and other necessary callback plug-ins) */
s.manageVars=function(cb,l,il){var s=this;if(!s[cb])return!1;l=l||"";il=il||!0;var a,d="pageName,purchaseID,channel,server, pageType,campaign,state,zip,events,products,transactionID";for(a=1;76>a;a++)d+=",prop"+a;for(a=1;251>a;a++)d+=",eVar"+a;for(a=1;6>a;a++)d+=",hier"+a;for(a=1;4>a;a++)d+=",list"+a;for(a in s.contextData)d+=",contextData."+a;if(l){if(1==il)d=l.replace("['", ".").replace("']","");else if(0==il){l=l.split(",");il=d.split(",");d="";for(x in l)for(y in-1<l[x].indexOf("contextData")&& (l[x]="contextData."+l[x].split("'")[1]),il)l[x]===il[y]&&(il[y]="");for(y in il)d+=il[y]?","+il[y]:""}s.pt(d,",",cb,0);return!0} return""===l&&il?(s.pt(d,",",cb,0),!0):!1};

/* Adobe Consulting Plugin: lowerCaseVars for manageVars (Requires manageVars plug-in) */
s.lowerCaseVars=function(v){var s=this;s[v]&&("events"!==v&&-1===v.indexOf("contextData")?(s[v]=s[v].toString(),0!== s[v].indexOf("D=")&&(s[v]=s[v].toLowerCase())):-1<v.indexOf("contextData")&&(v=v.substring(v.indexOf(".")+1),s.contextData[v]&& (s.contextData[v]=s.contextData[v].toString().toLowerCase())))};

/* Adobe Consulting Plugin: cleanStr for manageVars (Requires manageVars and cleanStr plug-ins) */
s.cleanStr=function(v){var s=this;s[v]&&"function"!==typeof cleanStr&&(0>v.indexOf("contextData")?s[v]=cleanStr(s[v]): (v=v.substring(v.indexOf(".")+1),s.contextData[v]&&(s.contextData[v]=cleanStr(s.contextData[v].toString()))))};

/* Adobe Consulting Plugin: cleanStr v1.0 */
function cleanStr(str){if("string"===typeof str){str=str.replace(/<\/?[^>]+(>|$)/g,"").trim().replace(/[\u2018\u2019\u201A]/g, "'").replace(/\t+/g,"").replace(/[\n\r]/g," ");for(;-1<str.indexOf("  ");)str=str.replace(/\s\s/g," ");return str}return""};

/* Adobe Consulting Plugin: pt v2.01 */
s.pt=function(l,de,cf,fa){if(l&&this[cf]){l=l.split(de||",");de=l.length;for(var e,c=0;c<de;c++)if(e=this[cf](l[c],fa))return e}};
/******************************************** END CODE TO DEPLOY ********************************************/

Utilizar el complemento

El manageVars método utiliza los siguientes argumentos:
  • cb (requerido, cadena): Nombre de una función de llamada de retorno que el complemento utiliza para manipular las variables de Analytics. Puede utilizar una función de Adobe como cleanStr o su propia función personalizada.
  • l (opcional, cadena): Una lista delimitada por comas de las variables de Analytics que desea manipular. Si no se establece, el valor predeterminado es TODAS las variables de Adobe Analytics, lo que incluye:
    • pageName
    • purchaseID
    • channel
    • server
    • pageType
    • campaign
    • state
    • zip
    • events
    • products
    • transactionID
    • Todas las props
    • Todas las eVars
    • Todas las variables de jerarquía
    • Todas las variables de lista
    • Todas las variables de datos de contexto
  • Il (opcional, booleano): Se configura como false si desea excluir la lista de variables declaradas en el l argumento en lugar de incluirlas. El valor predeterminado es true .
Al llamar a este método no se devuelve nada. En su lugar, cambia los valores de las variables de Analytics en función de la función de llamada de retorno deseada.

Llamadas de ejemplo

Ejemplo n.° 1

El siguiente código...
s.manageVars("lowerCaseVars");

...cambia los valores de todas las variables descritas anteriormente a versiones en minúsculas. La única excepción a esto es la variable events, ya que algunos de los eventos (por ejemplo: scAdd, scCheckout, etc.) distinguen entre mayúsculas y minúsculas y no deben reducirse

Ejemplo n.° 2

El siguiente código...
s.manageVars("lowerCaseVars", "events", false);

...básicamente produce el mismo resultado que el primer ejemplo, ya que la variable events no se reduce de forma predeterminada.

Ejemplo n.° 3

El siguiente código...
s.manageVars("lowerCaseVars", "eVar1,eVar2,eVar3,list2");

...solo cambiarán (por ejemplo, minúsculas) los valores de eVar1, eVar2, eVar3 y list2

Ejemplo n.° 4

El siguiente código...
s.manageVars("lowerCaseVars", "eVar1,eVar2,eVar3,list2", false);

...cambiará (por ejemplo, en minúsculas) los valores de todas las variables descritas anteriormente EXCEPTO para eVar1, eVar2, eVar3 y list2

Ejemplo n.° 5

El siguiente código...
s.manageVars("cleanStr");

...cambia los valores de todas las variables descritas anteriormente, incluidas las variables events. Específicamente, la función de llamada de retorno cleanStr hace lo siguiente en el valor de cada variable:
  • Quita la codificación HTML
  • Elimina los espacios en blanco que se encuentran al principio y al final del valor
  • Reemplaza las comillas simples izquierda/derecha (p. ej. ’) con una simple comilla recta (')
  • Reemplaza caracteres de tabulación, caracteres de nueva línea y caracteres de retorno de carro por espacios
  • Reemplaza todo el doble (o triple, etc.) espacios con espacios únicos

Historial de versiones

2.1 (14 de enero de 2019)

  • Corrección de errores en los navegadores Internet Explorer 11.
  • Cambios para s.cleanStr , que ahora utiliza la cleanStr función regular.

2.0 (7 de mayo de 2018)

  • Versión puntual (incluido el reanálisis/reescritura completo del complemento)
  • Se ha agregado cleanStr función de llamada de retorno