DocumentaciónAnalyticsGuía de implementación

Complemento de Adobe: getValOnce

Last update: Fri Jan 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Administrador
  • Desarrollador
IMPORTANT
Adobe Consulting proporciona este complemento por cortesía para ayudarle a sacar el máximo partido a 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 equipo de cuentas de Adobe de su organización. Ellos podrán organizar una reunión con un consultor para ayudarle.

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 la extensión del SDK web

Adobe ofrece una extensión que le permite utilizar los complementos más utilizados con el SDK web.

  1. Inicie sesión en la Recopilación de datos de Adobe Experience Platform con sus credenciales de Adobe ID.

  2. Clic Etiquetas a la izquierda, haga clic en la propiedad de etiqueta que desee.

  3. Clic Extensiones a la izquierda y, a continuación, haga clic en Catálogo pestaña

  4. Busque e instale el Complementos comunes del SDK web extensión.

  5. Clic Elementos de datos a la izquierda, haga clic en el elemento de datos deseado.

  6. Establezca el nombre del elemento de datos deseado con la siguiente configuración:

    • Extensión: Common Web SDK Plugins
    • Elemento de datos: getValOnce

  7. Configure los parámetros deseados a la derecha.

  8. Guarde y publique los cambios en el elemento de datos.

Instalación manual del complemento mediante la implementación del SDK web

Este complemento aún no es compatible con una implementación manual del 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.

  1. Inicie sesión en la Recopilación de datos de Adobe Experience Platform con sus credenciales de Adobe ID.

  2. Haga clic en la propiedad de etiquetas 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 de complemento Common Analytics Plugins, puede utilizar el editor de código personalizado.

  1. Inicie sesión en la Recopilación de datos de Adobe Experience Platform 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.1 */
function getValOnce(vtc,cn,et,ep){var e=vtc,i=cn,t=et,n=ep;  if(arguments&&"-v"===arguments[0])return{plugin:"getValOnce",version:"3.1"};var o=function(){if(void 0!==window.s_c_il){for(var e,i=0;i<window.s_c_il.length;i++)if((e=window.s_c_il[i])._c&&"s_c"===e._c)return e}}();if(void 0!==o&&(o.contextData.getValOnce="3.1"),window.cookieWrite=window.cookieWrite||function(e,i,t){if("string"==typeof e){var n=window.location.hostname,o=window.location.hostname.split(".").length-1;if(n&&!/^[0-9.]+$/.test(n)){o=2<o?o:2;var r=n.lastIndexOf(".");if(0<=r){for(;0<=r&&1<o;)r=n.lastIndexOf(".",r-1),o--;r=0<r?n.substring(r):n}}if(g=r,i=void 0!==i?""+i:"",t||""===i){if(""===i&&(t=-60),"number"==typeof t){var f=new Date;f.setTime(f.getTime()+6e4*t)}else f=t}return!!e&&(document.cookie=encodeURIComponent(e)+"="+encodeURIComponent(i)+"; path=/;"+(t?" expires="+f.toUTCString()+";":"")+(g?" domain="+g+";":""),"undefined"!=typeof cookieRead)&&cookieRead(e)===i}},window.cookieRead=window.cookieRead||function(e){if("string"!=typeof e)return"";e=encodeURIComponent(e);var i=" "+document.cookie,t=i.indexOf(" "+e+"="),n=0>t?t:i.indexOf(";",t);return(e=0>t?"":decodeURIComponent(i.substring(t+2+e.length,0>n?i.length:n)))?e:""},e){var i=i||"s_gvo",t=t||0,n="m"===n?6e4:864e5;if(e!==cookieRead(i)){var r=new Date;return r.setTime(r.getTime()+t*n),cookieWrite(i,e,0===t?0:r),e}}return""}
/******************************************** 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.1 (22 de septiembre de 2022)

  • Se ha corregido un error por caducidad

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.
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690