Información general sobre la extensión Common Web SDK Plugins
Este documento explica cómo configurar la extensión de etiquetas de complementos del SDK web y cómo utilizarla para aumentar el Extensión de SDK web de Adobe Experience Platform.
Configurar la extensión de complementos de SDK web comunes
Esta sección proporciona una referencia sobre las opciones disponibles al configurar la extensión de complementos del SDK web.
Añadir complementos a la extensión SDK para web de Adobe Experience Platform
No es necesario realizar ninguna configuración para inicializar o agregar un complemento a la biblioteca fuera de mediante los siguientes elementos de datos nativos que proporciona la extensión de complementos de SDK web comunes:
getAndPersistValue
Le permite configurar el getAndPersistValue Complemento de Analytics. El getAndPersistValue Un elemento de datos almacena un valor en una cookie que se puede recuperar más adelante durante una visita.
El getAndPersistValue El elemento de datos de proporciona los siguientes argumentos:
vtp(obligatorio): El valor que se va a mantener de página en página.cn(opcional): El nombre de la cookie para almacenar el valor. Si no se establece este argumento, se llamará a la cookie"s_gapv".ex(opcional): Número de días antes de que caduque la cookie. Si este argumento está establecido en0o no, la cookie caduca al final de la visita (a los 30 minutos de inactividad).
Si la variable en vtp se establece, el elemento de datos establece la cookie y devuelve el valor de la cookie. Si la variable en vtp no está establecido, el elemento de datos solo devuelve el valor de la cookie.
getGeoCoordinates
Le permite configurar el getGeoCoordinates Complemento de Analytics. El getGeoCoordinates El elemento de datos de captura la latitud y longitud de los dispositivos de los visitantes.
El getGeoCoordinates El elemento de datos no utiliza ningún argumento. Devuelve uno de los siguientes valores:
"geo coordinates not available": Para dispositivos que no tienen datos de localización geográfica disponibles cuando se ejecuta el complemento. Este valor es habitual en la primera visita, especialmente cuando los visitantes deben consentir por primera vez que se rastree su ubicación."error retrieving geo coordinates": Cuando el complemento encuentra algún error al intentar recuperar la ubicación del dispositivo."latitude=[LATITUDE] | longtitude=[LONGITUDE]": Donde [LATITUDE]/[LONGITUDE] representan la latitud y la longitud, respectivamente.
getNewRepeat
Le permite configurar el getNewRepeat Complemento de Analytics. El getNewRepeat Un elemento de datos determina si un visitante del sitio es un visitante nuevo o repetitivo en un número determinado de días.
El getNewRepeat El elemento de datos utiliza los siguientes argumentos:
d(entero, opcional): el número mínimo de días entre visitas que restablece a los visitantes de nuevo como"New". Si no se establece este argumento, el valor predeterminado es de 30 días.
Este elemento de datos devuelve el valor de "New" si la cookie configurada por el elemento de datos no existe o ha caducado. Devuelve el valor de "Repeat" si la cookie configurada por el elemento de datos existe y el tiempo desde la visita actual y el tiempo establecido en la cookie es bueno a los 30 minutos. Este método devuelve el mismo valor para una visita completa.
getPageName
Le permite configurar el getPageName Complemento de Analytics. El getPageName crea una versión fácil de leer y con formato sencillo de la dirección URL actual.
El getPageName El elemento de datos utiliza los siguientes argumentos:
si(opcional, cadena): un ID insertado al principio de la cadena que representa el ID del sitio. Este valor puede ser un ID numérico o un nombre sencillo. Si no se establece, el valor predeterminado es el dominio actual.qv(opcional, cadena): una lista delimitada por comas de parámetros de cadena de consulta que, si se encuentran en la dirección URL, se agregan a la cadenahv(opcional, cadena): una lista delimitada por comas de parámetros encontrados en el hash de la URL que, si se encuentran en la dirección URL, se agregan a la cadenade(opcional, cadena): el delimitador para dividir partes individuales de la cadena. Valores predeterminados de una barra vertical (|).
El elemento de datos devuelve una cadena que contiene una versión de la dirección URL con formato sencillo. Esta cadena se suele asignar a la variable pageName, pero también se puede utilizar en otras variables.
getPreviousValue
Le permite configurar el getPreviousValue Complemento de Analytics. El getPreviousValue Un elemento de datos establece una variable en un valor establecido en una visita anterior.
El getPreviousValue El elemento de datos utiliza los siguientes argumentos:
v(cadena, obligatorio): La variable que tiene el valor que desea pasar a la siguiente solicitud de imagen. Una variable común ess.pageNamey se utiliza para recuperar el valor de la página anterior.c(cadena, opcional): El nombre de la cookie que almacena el valor. Si no se establece este argumento, el valor predeterminado es"s_gpv".
Al llamar a este elemento de datos, devuelve el valor de cadena contenido en la cookie. A continuación, el complemento restablece la caducidad de la cookie y le asigna el valor de variable del argumento v. La cookie caduca tras 30 minutos de inactividad.
getQueryParam
Le permite configurar el getQueryParam Complemento de Analytics. El getQueryParam El elemento de datos extrae el valor de cualquier parámetro de cadena de consulta contenido en una dirección URL. Resulta útil para extraer códigos de campaña, tanto internos como externos, de las direcciones URL de las páginas de aterrizaje. También resulta útil al extraer términos de búsqueda u otros parámetros de cadena de consulta. Este elemento de datos proporciona funciones sólidas para analizar direcciones URL complejas, incluidos hashes y direcciones URL que contienen varios parámetros de cadena de consulta.
El getQueryParam El elemento de datos utiliza los siguientes argumentos:
qsp(obligatorio): Una lista delimitada por comas de parámetros de cadena de consulta que se buscarán en la dirección URL. Sin distinción de mayúsculas y minúsculas.de(opcional): El delimitador que se usará si coinciden varios parámetros de cadena de consulta. El valor predeterminado es una cadena vacía.url(opcional): Una dirección URL, cadena o variable personalizada desde la que extraer los valores de parámetro de cadena de consulta. El valor predeterminado eswindow.location.
Llamar a este elemento de datos devuelve un valor según los argumentos anteriores y la dirección URL:
- Si no se encuentra un parámetro de cadena de consulta coincidente, el método devuelve una cadena vacía.
- Si se encuentra un parámetro de cadena de consulta coincidente, el método devuelve el valor del parámetro de cadena de consulta.
- Si se encuentra un parámetro de cadena de consulta coincidente pero el valor está vacío, el método devuelve
true. - Si se encuentran varios parámetros de cadena de consulta coincidentes, el método devuelve una cadena con cada valor de parámetro delimitado por la cadena en el argumento
de.
getTimeParting
Le permite configurar el getTimeParting Complemento de Analytics. El getTimeParting Un elemento de datos registra los detalles del momento en el que se produce cualquier actividad que se pueda medir en el sitio. Este elemento de datos es útil cuando desea desglosar métricas para cualquier división de tiempo repetible en un intervalo de fechas determinado. Por ejemplo: puede comparar las tasas de conversión entre dos días diferentes de la semana, como los domingos frente a los jueves. También puede comparar periodos del día, como las mañanas frente a las noches.
El getTimeParting El elemento de datos utiliza el siguiente argumento:
t (opcional pero recomendado, cadena): Nombre del huso horario al que convertir la hora local del visitante. El valor predeterminado es UTC/GMT. Consulte la Lista de zonas horarias de base de datos TZ en Wikipedia para obtener una lista completa de los valores válidos.
Los valores válidos comunes incluyen:
"America/New_York"para la hora del este"America/Chicago"para la hora central"America/Denver"para la hora de montaña"America/Los_Angeles"para la hora del Pacífico
Llamar a este elemento de datos devuelve una cadena que contiene lo siguiente, delimitado por una barra vertical (|):
- El año en curso
- El mes en curso
- El día del mes
- El día de la semana
- La hora (AM/PM)
getTimeSinceLastVisit
Le permite configurar el getTimeSinceLastVisit Complemento de Analytics. El getTimeSinceLastVisit Un elemento de datos de registra el tiempo que un visitante ha tardado en regresar a su sitio después de su última visita.
El getTimeSinceLastVisit El elemento de datos no utiliza ningún argumento. Devuelve el tiempo transcurrido desde la última vez que el visitante accedió al sitio, agrupado en el siguiente formato:
- Un valor entre 30 minutos y una hora desde la última visita se establece en la referencia de medio minuto más cercana. Por ejemplo,
"30.5 minutes","53 minutes" - Un valor entre una hora y un día se redondea a la referencia de cuarto de hora más cercana. Por ejemplo,
"2.25 hours","7.5 hours" - Un valor mayor que un día se redondea a la referencia del día más próximo. Por ejemplo,
"1 day","3 days","9 days","372 days" - Si es la primera visita de un visitante o si el tiempo transcurrido supera los dos años, el valor se establece en
"New Visitor".
getValOnce
Le permite configurar el getValOnce Complemento de Analytics. El getValOnce Un elemento de datos evita que una variable se establezca en el mismo valor más de una vez.
El getValOnce El elemento de datos utiliza los siguientes argumentos:
vtc(obligatorio, cadena): La variable para comprobar y ver si anteriormente se ha definido en un valor idénticocn(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 argumentoep). El valor predeterminado es0, que caduca al final de la sesión del exploradorep(opcional, cadena): Establezca este argumento solo si también establece el argumentoet. Establezca este argumento en"m"si desea que el argumentoetcaduque en minutos en lugar de en días. El valor predeterminado es"d", que establece el argumentoeten días.
Si el argumento vtc y el valor de la cookie coinciden, este método devuelve una cadena vacía. Si el argumento vtc y el valor de la cookie no coinciden, el método devuelve el argumento vtc como una cadena.
getVisitDuration
Le permite configurar el getVisitDuration Complemento de Analytics. El getVisitDuration Un elemento de datos de registra el tiempo en minutos que el visitante ha pasado en el sitio hasta ese momento.
El getVisitDuration El elemento de datos no utiliza ningún argumento. Devuelve uno de los siguientes valores:
"first hit of visit""less than a minute""1 minute""[x] minutes"(donde[x]es el número de minutos transcurridos desde que el visitante accedió al sitio)
getVisitNum
Le permite configurar el getVisitNum Complemento de Analytics. El getVisitNum elemento de datos devuelve el número de la visita de todos los visitantes que acceden al sitio dentro del número de días deseado.
El getVisitNum El elemento de datos utiliza los siguientes argumentos:
-
rp(opcional, entero O cadena): El número de días antes de que se restablezca el contador de números de visitas. Si no se configura de forma distinta, el valor predeterminado es365.- Cuando este argumento es
"w", el contador se restablece al final de la semana (este sábado a las 23:59 h) - Cuando este argumento es
"m", el contador se restablece al final del mes (el último día del mes en curso) - Cuando este argumento es
"y", el contador se restablece al final del año (31 de diciembre)
- Cuando este argumento es
-
erp(opcional, booleano): Cuando el argumentorpes un número, este argumento determina si se debe ampliar la caducidad del número de visita. Si se establece entrue, las posteriores visitas al sitio restablecerán el contador de número de visitas. Si se establece enfalse, las posteriores visitas al sitio no se amplían cuando se restablece el contador de número de visitas. El valor predeterminado estrue. Este argumento no es válido cuando el argumentorpes una cadena.
El número de visitas aumenta cada vez que el visitante regresa al sitio después de 30 minutos de inactividad. Llamar a este método devuelve un entero que representa el número de visita actual.
p_fo (Page First Only)
Le permite configurar el p_fo Complemento de Analytics. El p_fo data element es una utilidad que comprueba la existencia de un objeto JavaScript específico. Si el objeto no existe, el complemento crea el objeto y lo devuelve true. Si el objeto JavaScript ya existe en la página, devuelve false. Este elemento de datos es útil para ejecutar código exactamente una vez en una página.
El p_fo El elemento de datos utiliza los siguientes argumentos:
on(obligatorio, cadena): El nombre del objeto JavaScript que crea el elemento de datos si el objeto aún no existe en la página.
Si el objeto aún no existe, este método devuelve true y crea el objeto. Si el objeto ya existe, este método devuelve false.