Complemento de Adobe: getValOnce

El complemento getValOnce evita que una variable se establezca en el mismo valor más de una vez. Adobe recomienda utilizar este complemento cuando desee anular la duplicación de incidencias cuando un visitante actualiza una página o visita una página determinada varias veces. Este complemento no es necesario si no le preocupa la métrica “Ocurrencias” de Analysis Workspace.

Instalación del complemento con etiquetas en Adobe Experience Platform

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

1. Inicie sesión en la IU de recopilación de datos 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 getValOnce
7. 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 del complemento, puede utilizar el editor de código personalizado.

1. Inicie sesión en la IU de recopilación de datos 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: getValOnce v3.0 (Requires AppMeasurement) */
function getValOnce(vtc,cn,et,ep){var e=vtc,k=cn,l=et,m=ep;if(arguments&&"-v"===arguments[0])return{plugin:"getValOnce",version:"3.0"};var c=function(){if("undefined"!==typeof window.s_c_il)for(var b=0,a;b<window.s_c_il.length;b++)if(a=window.s_c_il[b],a._c&&"s_c"===a._c)return a}();"undefined"!==typeof c&&(c.contextData.getValOnce="3.0");window.cookieWrite=window.cookieWrite||function(b,a,d){if("string"===typeof b){var h=window.location.hostname,c=window.location.hostname.split(".").length-1;if(h&&!/^[0-9.]+$/.test(h)){c=2<c?
c:2;var f=h.lastIndexOf(".");if(0<=f){for(;0<=f&&1<c;)f=h.lastIndexOf(".",f-1),c--;f=0<f?h.substring(f):h}}g=f;a="undefined"!==typeof a?""+a:"";if(d||""===a)if(""===a&&(d=-60),"number"===typeof d){var e=new Date;e.setTime(e.getTime()+6E4*d)}else e=d;return b&&(document.cookie=encodeURIComponent(b)+"="+encodeURIComponent(a)+"; path=/;"+(d?" expires="+e.toUTCString()+";":"")+(g?" domain="+g+";":""),"undefined"!==typeof cookieRead)?cookieRead(b)===a:!1}};window.cookieRead=window.cookieRead||function(b){if("string"===
typeof b)b=encodeURIComponent(b);else return"";var a=" "+document.cookie,d=a.indexOf(" "+b+"="),c=0>d?d:a.indexOf(";",d);return(b=0>d?"":decodeURIComponent(a.substring(d+2+b.length,0>c?a.length:c)))?b:""};return e&&(k=k||"s_gvo",l=l||0,m="m"===m?6E4:864E5,e!==this.c_r(k))?(c=new Date,c.setTime(c.getTime()+l*m),cookieWrite(k,e,0===l?0:m),e):""};
/******************************************** END CODE TO DEPLOY ********************************************/

Uso del complemento

La función getValOnce utiliza los siguientes argumentos:

• vtc (obligatorio, cadena): La variable para comprobar y ver si anteriormente se ha definido en un valor idéntico
• cn (opcional, cadena): El nombre de la cookie que contiene el valor que se va a comprobar. El valor predeterminado es "s_gvo"
• et (opcional, entero): La caducidad de la cookie en días (o minutos, según el argumento ep). El valor predeterminado es 0, que caduca al final de la sesión del explorador
• ep (opcional, cadena): Establezca este argumento solo si también establece el argumento et. Establezca este argumento en "m" si desea que el argumento et caduque en minutos en lugar de en días. El valor predeterminado es "d", que establece el argumento et en días.

Si el argumento vtc y el valor de la cookie coinciden, esta función devuelve una cadena vacía. Si el argumento vtc y el valor de la cookie no coinciden, la función devuelve el argumento vtc como una cadena.

Ejemplos

// Prevent the same value from being passed in to the campaign variable more than once in a row for next 30 days
s.campaign = getValOnce(s.campaign,"s_campaign",30);

// Prevent the same value from being passed in to eVar2 more than once in a row for the browser session
s.eVar2 = getValOnce(s.eVar2,"s_ev2");

// Prevent the same value from being passed in to eVar8 more than once in a row for 10 minutes
s.eVar8 = getValOnce(s.eVar8,"s_ev8",10,"m");

Historial de versiones

3.0 (19 de marzo de 2021)

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

2,01

• Se ha corregido un problema con la escritura de cookies.

2,0

• Versión puntual (compilada de nuevo, con un tamaño de código más pequeño).

1,1

• Se ha agregado la opción de elegir minutos o días para la caducidad mediante el parámetro t.
• Se ha corregido el ámbito de la variable k utilizada para restringirla solo al complemento. Este cambio evita posibles interferencias con otro código de la página.