Complemento de Adobe: apl (appendToList)

El complemento apl le permite agregar de forma segura nuevos valores a variables delimitadas por listas, como events, linkTrackVars, list y otras.

• Si el valor que desea agregar no aparece en la variable, el código agrega el valor al final de la cadena.
• Si el valor que desea agregar ya aparece en la variable, este complemento no cambia el valor. Esta función permite que la implementación no incluya valores duplicados.
• Si la variable que desea agregar está vacía, el complemento establece la variable en el nuevo valor.

Adobe recomienda utilizar este complemento si desea añadir valores nuevos a variables existentes que contengan una cadena de valores delimitados. Este complemento no es necesario si prefiere concatenar cadenas para variables que contengan valores delimitados.

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

Adobe ofrece una extensión que le permite disfrutar de los complementos más utilizados.

1. Inicie sesión en launch.adobe.com con sus credenciales de Adobe ID.
2. Haga clic en la propiedad deseada.
3. Vaya a la pestaña 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: Ninguna
   • Evento: Core – Biblioteca cargada (Principio de página)
6. Añada una acción a la regla anterior con la siguiente configuración:
   • Extensión: Common Analytics Plugins
   • Tipo de acción: Inicializar APL (Anexar a lista)
7. Guarde y publique los cambios en la regla.

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

Si no desea utilizar la extensión del complemento, puede utilizar el editor de código personalizado.

1. Inicie sesión en launch.adobe.com con sus credenciales de Adobe ID.
2. Haga clic en la propiedad deseada.
3. Vaya a la pestaña Extensiones y, a continuación, haga clic en el botón Configurar en la extensión de Adobe Analytics.
4. Expanda Configurar seguimiento con el 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 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: apl (appendToList) v4.0 */
function apl(lv,va,d1,d2,cc){var b=lv,d=va,e=d1,c=d2,g=cc;if("-v"===b)return{plugin:"apl",version:"4.0"};var h=function(){if("undefined"!==typeof window.s_c_il)for(var k=0,b;k<window.s_c_il.length;k++)if(b=window.s_c_il[k],b._c&&"s_c"===b._c)return b}();"undefined"!==typeof h&&(h.contextData.apl="4.0");window.inList=window.inList||function(b,d,c,e){if("string"!==typeof d)return!1;if("string"===typeof b)b=b.split(c||",");else if("object"!==typeof b)return!1;c=0;for(a=b.length;c<a;c++)if(1==e&&d===b[c]||d.toLowerCase()===b[c].toLowerCase())return!0;return!1};if(!b||"string"===typeof b){if("string"!==typeof d||""===d)return b;e=e||",";c=c||e;1==c&&(c=e,g||(g=1));2==c&&1!=g&&(c=e);d=d.split(",");h=d.length;for(var f=0;f<h;f++)window.inList(b,d[f],e,g)||(b=b?b+c+d[f]:d[f])}return b};
/******************************************** END CODE TO DEPLOY ********************************************/

Uso del complemento

El método apl utiliza los siguientes argumentos:

• lv (obligatorio, cadena): La variable que contiene una lista delimitada de elementos para agregar un nuevo valor a
• vta (obligatorio, cadena): Una lista delimitada por comas de los nuevos valores que se agregan al valor del argumento lv.
• d1 (opcional, cadena): El delimitador utilizado para separar los valores individuales ya contenidos en el argumento lv. Si no se configura de forma distinta, el valor predeterminado es una coma (,).
• d2 (opcional, cadena): El delimitador de salida. Si no se especifica lo contrario, el valor predeterminado es el mismo que d1.
• cc (opcional, booleano): Indica si se utiliza una comprobación que distingue entre mayúsculas y minúsculas. Con true, la comprobación de duplicaciones distingue entre mayúsculas y minúsculas. Si se selecciona false o no, la comprobación de duplicaciones no distingue entre mayúsculas y minúsculas. El valor predeterminado es false.

El método apl devuelve el valor del argumento lv más cualquier valor no duplicado del argumento vta.

Llamadas de ejemplo

Ejemplo 1

Si…

s.events = "event22,event24";

… y se ejecuta el siguiente código…

s.events = s.apl(s.events, "event23");

… el valor final de s.events es:

s.events = "event22,event24,event23";

Ejemplo 2

Si…

s.events = "event22,event23";

… y se ejecuta el siguiente código…

s.events = s.apl(s.events, "event23");

… el valor final de s.events sigue siendo:

s.events = "event22,event23";

En este ejemplo, la llamada de apl no realiza cambios en s.events porque s.events ya contiene “event23”.

Ejemplo 3

Si…

s.events = ""; //blank value

… y se ejecuta el siguiente código…

s.events = s.apl(s.events, "event23");

… el valor final de s.events es…

s.events = "event23";

Ejemplo 4

Si…

s.prop4 = "hello|people";

… y se ejecuta el siguiente código…

s.eVar5 = s.apl(s.prop4, "today", "|");

… el valor final de s.prop4 sigue siendo…

s.prop4 = "hello|people";

… pero el valor final de s.eVar5 es

s.eVar5 = "hello|people|today";

Tenga en cuenta que el complemento solo devuelve un valor; no necesariamente “restablece” la variable pasada a través del argumento lv.

Ejemplo 5

Si…

s.prop4 = "hello|people";

… y se ejecuta el siguiente código…

s.prop4 = s.apl(s.prop4, "today");

… el valor final de s.prop4 es…

s.prop4 = "hello|people,today";

Asegúrese de mantener el mismo delimitador entre lo que hay en el valor del argumento lv y lo que hay en los argumentos d1/d2.

Ejemplo 6

Si…

s.events = "event22,event23";

… y se ejecuta el siguiente código…

s.events = s.apl(s.events,"EVenT23", ",", ",", true);

… el valor final de s.events es:

s.events = "event22,event23,EVentT23";

Aunque este ejemplo no es práctico, demuestra la necesidad de tener cuidado al utilizar el indicador que distingue entre mayúsculas y minúsculas.

Ejemplo 7

Si…

s.events = "event22,event23";

… y se ejecuta el siguiente código…

s.events = s.apl(s.events, "event23,event24,event25");

… el valor final de s.events es:

s.events = "event22,event23,event24,event25");

El complemento no añade “event23” a s.events porque ya existe en s.events. Sin embargo, sí añade event24 y event25 a s.events porque no se incluyeron en s.events anteriormente.

Ejemplo 8

Si…

s.linkTrackVars = "events,eVar1";

… y se ejecuta el siguiente código…

s.linkTrackVars = s.apl(s.linkTrackVars, "campaign", ",", ",", false);

… el valor final de s.linkTrackVars es:

s.linkTrackVars = "events,eVar1,campaign";

Los tres últimos argumentos (p. ej. “,”, “,”, false) al final de esta llamada de apl no son necesarios, pero tampoco “dañan nada” al configurarse, ya que coinciden con los valores de argumento predeterminados.

Ejemplo 9

Si…

s.events = "event22,event24";

… y se ejecuta el siguiente código…

s.apl(s.events, "event23");

… el valor final de s.events sigue siendo:

s.events = "event22,event24";

La ejecución del complemento por sí sola (sin asignar el valor devuelto a una variable) no “restablece” realmente la variable pasada a través del argumento lv.

Ejemplo 10

Si…

s.list2 = "casesensitivevalue|casesensitiveValue"

… y se ejecuta el siguiente código…

s.list2 = s.apl(s.list2, "CasESensiTiveValuE", "|", "-", true);

… el valor final de s.list2 es:

s.list2 = "casesensitivevalue-casesensitiveValue-CasESensiTiveValuE"

Dado que los dos argumentos delimitadores son diferentes, el valor pasado se delimita por el primer argumento delimitador (“|”) y luego se une por el segundo argumento delimitador (“-”).

Historial de versiones

4.0 (19 de marzo de 2021)

• Se ha añadido el número de versión como datos de contexto.

3.2 (25 de septiembre de 2019)

• Se han corregido problemas de compatibilidad con llamadas apl que usaban versiones anteriores del complemento.
• Se han eliminado las advertencias de la consola para reducir el tamaño.
• Se ha añadido inList 2.1.

3.1 (22 de abril de 2018)

• El argumento d2 ahora se establece de forma predeterminada en el valor del argumento d1 cuando, si no se especifica lo contrario.

3.0 (16 de abril de 2018)

• Reanálisis y reescritura completos del complemento
• Se ha agregado la comprobación avanzada de errores.
• El argumento vta ahora acepta varios valores al mismo tiempo.
• Se ha agregado el argumento d2 para dar formato al valor devuelto.
• Se ha cambiado el argumento cc, ahora es booleano.

2.5 (18 de febrero de 2016)

• Ahora se utiliza el método inList para el procesamiento de comparación.

2.0 (26 de enero de 2016)

• El argumento d (delimitador) ahora es opcional (el valor predeterminado es una coma).
• El argumento u (indicador de distinción entre mayúsculas y minúsculas) ahora es opcional (de forma predeterminada distingue entre mayúsculas y minúsculas).
• Independientemente del argumento u (indicador de distinción entre mayúsculas y minúsculas), el complemento ya no añade un valor a una lista si este ya existe en dicha lista.