Complemento de Adobe: pt
El complemento pt ejecuta una función o un método en una lista de variables de Analytics. Por ejemplo, puede ejecutar la función clearVars de forma selectiva en varias variables sin llamar manualmente a la función cada vez. Otros complementos dependen de este código para ejecutarse correctamente. Este complemento no es necesario si no necesita ejecutar una función específica en más de una variable de Analytics a la vez o si no utiliza ningún complemento dependiente.
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 pt
-
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: pt v3.0 */
function pt(l,de,cf,fa){var b=l,d=de,f=cf,g=fa;if("-v"===b)return{plugin:"pt",version:"3.0"};a:{if("undefined"!==typeof window.s_c_il){var a=0;for(var c;a<window.s_c_il.length;a++)if(c=window.s_c_il[a],c._c&&"s_c"===c._c){a=c;break a}}a=void 0}if("undefined"!==typeof a&&(a.contextData.pt="3.0",b&&a[f])){b=b.split(d||",");d=b.length;for(var e=0;e<d;e++)if(c=a[f](b[e],g))return c}};
/******************************************** END CODE TO DEPLOY ********************************************/
Uso del complemento
La función pt utiliza los siguientes argumentos:
l(obligatorio, cadena): Una lista de variables con las que se puede ejecutar la función contenida en el argumentocf.de(opcional, cadena): El delimitador que separa la lista de variables del argumentol. El valor predeterminado es una coma (,).cf(obligatorio, cadena): El nombre de la función de llamada de retorno contenida en el objeto AppMeasurement al que se va a llamar en relación con cada una de las variables contenidas en el argumentol.fa(opcional, cadena): Si la función del argumentocfnecesita argumentos adicionales cuando se ejecute, inclúyalos aquí. El valor predeterminado esundefined.
La llamada a esta función hace que se devuelva un valor si la función de llamada de retorno (en el argumento cf) devuelve un valor.
Llamadas de ejemplo
Ejemplo 1
El código siguiente forma parte del complemento getQueryParam. Ejecuta la función de ayuda getParameterValue con cada uno de los pares clave-valor que se encuentran en la cadena de consulta de la dirección URL (fullQueryString). Para extraer cada par clave-valor, fullQueryString debe estar delimitado y dividido por un carácter ampersand “&”. El parámetro parameterKey hace referencia al parámetro de cadena de consulta que el complemento intenta extraer específicamente de la cadena de consulta.
returnValue = pt(fullQueryString, "&", "getParameterValue", parameterKey)
La línea anterior es un método abreviado para ejecutar código similar a esto:
var returnValue = "",
parameters = fullQueryString.split("&"),
parametersLength = parameters.length;
for(var i = 0; i < parametersLength; i++)
{
returnValue = getParameterValue(parameters[i], parameterKey);
if(returnValue !== "") break;
}
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 (24 de septiembre de 2019)
- Cambios menores en el código para reducir el tamaño total.
2.0 (17 de abril de 2018)
- Versión puntual (compilada de nuevo, con un tamaño de código más pequeño).
- Se ha agregado soporte para el código H y con AppMeasurement.
1.0 (23 de septiembre de 2013)
- Versión inicial.