Referencia de objeto satélite

NOTE
Adobe Experience Platform Launch se ha convertido en un conjunto de tecnologías de recopilación de datos en Adobe Experience Platform. Como resultado, se han implementado varios cambios terminológicos en la documentación del producto. Consulte el siguiente documento para obtener una referencia consolidada de los cambios terminológicos.

Este documento sirve como referencia para el objeto _satellite del lado del cliente y las diversas funciones que puede realizar con él.

track

Código

_satellite.track(identifier: string [, detail: *] )

Ejemplo

_satellite.track('contact_submit', { name: 'John Doe' });

track activa todas las reglas utilizando el tipo de evento Direct Call que se ha configurado con el identificador dado de la extensión de etiqueta Core. El ejemplo anterior activa todas las reglas utilizando un tipo de evento Direct Call en el que el identificador configurado es contact_submit. También se transmite un objeto opcional que contiene información relacionada. Se puede acceder al objeto de detalle introduciendo %event.detail% en un campo de texto en una condición o acción o event.detail dentro del editor de código en una condición o acción Custom Code.

getVar

Código

_satellite.getVar(name: string) => *

Ejemplo

var product = _satellite.getVar('product');

En el ejemplo proporcionado, si existe un elemento de datos con un nombre que coincida, se devuelve el valor del elemento de datos. Si no existe ningún elemento de datos que coincida, se verifica si se ha establecido previamente una variable personalizada con un nombre que coincida usando _satellite.setVar(). Si se encuentra una variable personalizada que coincida, se devuelve su valor.

NOTE
Puede utilizar la sintaxis de porcentaje (%) para hacer referencia a variables de muchos campos de formulario en la implementación de etiquetas, lo que reduce la necesidad de llamar a _satellite.getVar(). Por ejemplo, al usar %product% se accederá al valor del elemento de datos del producto o de la variable personalizada.

Cuando un evento déclencheur una regla, puede pasar el objeto event correspondiente de la regla a _satellite.getVar() de la siguiente manera:

// event refers to the calling rule's event
var rule = _satellite.getVar('return event rule', event);

setVar

NOTE
El código setVar es completamente independiente de un elemento de datos especificado en Etiquetas.

Código

_satellite.setVar(name: string, value: *)

Ejemplo

_satellite.setVar('product', 'Circuit Pro');

setVar() establece una variable personalizada con un nombre y un valor determinados. Más adelante se puede acceder al valor de la variable mediante _satellite.getVar().

Si lo desea, puede configurar varias variables a la vez transmitiendo un objeto donde las claves sean nombres de variable y los valores sean los valores de variable correspondientes.

_satellite.setVar({ 'product': 'Circuit Pro', 'category': 'hobby' });

getVisitorId

Código

_satellite.getVisitorId() => Object

Ejemplo

var visitorIdInstance = _satellite.getVisitorId();

Si la extensión Adobe Experience Cloud ID está instalada en la propiedad, este método devuelve la instancia de ID de visitante. Consulte la documentación del servicio de Experience Cloud ID para obtener más información.

logger

Código

_satellite.logger.log(message: string)
_satellite.logger.info(message: string)
_satellite.logger.warn(message: string)
_satellite.logger.error(message: string)

Ejemplo

_satellite.logger.error('No product ID found.');

El objeto logger permite registrar un mensaje en la consola del explorador. El mensaje se muestra únicamente si el usuario habilita la depuración de etiquetas (llamando a _satellite.setDebug(true) o utilizando una extensión adecuada del explorador).

Registro de advertencias de obsolescencia

_satellite.logger.deprecation(message: string)

Ejemplo

_satellite.logger.deprecation('This method is no longer supported, please use [new example] instead.');

Registra una advertencia en la consola del explorador. El mensaje aparece independientemente de si el usuario ha habilitado o no la depuración de etiquetas.

_satellite.cookie contiene funciones para leer y escribir cookies. Es una copia expuesta de la biblioteca de terceros js-cookie. Para obtener más información sobre un uso más avanzado de esta biblioteca, revisa la documentación de js-cookie.

Para establecer una cookie, use _satellite.cookie.set().

Código

_satellite.cookie.set(name: string, value: string[, attributes: Object])
NOTE
En el antiguo método setCookie de establecer cookies, el tercer argumento (opcional) de esta llamada a la función era un entero que indicaba la hora de caducidad de la cookie en días. En este nuevo método, se acepta un objeto "attributes" como tercer argumento. Para establecer una caducidad para una cookie mediante el nuevo método, debe proporcionar una propiedad expires en el objeto de atributos y establecerla en el valor deseado. Esto se muestra en el ejemplo siguiente.

Ejemplo

La siguiente llamada a la función escribe una cookie que caduca en una semana.

_satellite.cookie.set('product', 'Circuit Pro', { expires: 7 });

Para recuperar una cookie, use _satellite.cookie.get().

Código

_satellite.cookie.get(name: string) => string

Ejemplo

La siguiente llamada a la función lee una cookie configurada anteriormente.

var product = _satellite.cookie.get('product');

Para quitar una cookie, use _satellite.cookie.remove().

Código

_satellite.cookie.remove(name: string)

Ejemplo

La siguiente llamada a la función elimina una cookie configurada anteriormente.

_satellite.cookie.remove('product');

buildInfo

Código

_satellite.buildInfo

Este objeto contiene información acerca de la compilación de la biblioteca de tiempo de ejecución de etiquetas actual. El objeto contiene las siguientes propiedades:

turbineVersion

Proporciona la versión de Turbine utilizada dentro de la biblioteca actual.

turbineBuildDate

La fecha ISO 8601 en que se creó la versión de Turbine utilizada dentro del contenedor.

buildDate

La fecha ISO 8601 en que se creó la biblioteca actual.

Este ejemplo muestra los valores de los objetos:

{
  turbineVersion: "14.0.0",
  turbineBuildDate: "2016-07-01T18:10:34Z",
  buildDate: "2016-03-30T16:27:10Z"
}

environment

Este objeto contiene información sobre el entorno en el que está implementada la biblioteca de tiempo de ejecución de etiquetas actual.

Código

_satellite.environment

El objeto contiene las siguientes propiedades:

{
  id: "ENbe322acb4fc64dfdb603254ffe98b5d3",
  stage: "development"
}
Propiedad
Descripción
id
El ID del entorno.
stage
El entorno para el que se creó esta biblioteca. Los valores posibles son development, staging y production.

notify

NOTE
Este método se ha desaprobado. Utilice _satellite.logger.log() en su lugar.

Código

_satellite.notify(message: string[, level: number])

Ejemplo

_satellite.notify('Hello world!');

notify registra un mensaje en la consola del explorador. El mensaje se muestra únicamente si el usuario habilita la depuración de etiquetas (llamando a _satellite.setDebug(true) o utilizando una extensión adecuada del explorador).

Se puede transmitir un nivel de registro opcional que afecte al diseño y al filtrado del mensaje que se registra. Estos son los niveles compatibles:

3 - Mensajes informativos.

4 - Mensajes de advertencia.

5 - Mensajes de error.

Si no proporciona un nivel de registro ni transmite ningún otro valor de nivel, el mensaje se registra como mensaje normal.

setCookie setCookie

IMPORTANT
Este método se ha desaprobado. Utilice _satellite.cookie.set() en su lugar.

Código

_satellite.setCookie(name: string, value: string, days: number)

Ejemplo

_satellite.setCookie('product', 'Circuit Pro', 3);

Establece una cookie en el explorador del usuario. La cookie persistirá durante el número de días especificado.

readCookie

IMPORTANT
Este método se ha desaprobado. Utilice _satellite.cookie.get() en su lugar.

Código

_satellite.readCookie(name: string) => string

Ejemplo

var product = _satellite.readCookie('product');

Lee una cookie desde el explorador del usuario.

removeCookie

NOTE
Este método se ha desaprobado. Utilice _satellite.cookie.remove() en su lugar.

Código

_satellite.removeCookie(name: string)

Ejemplo

_satellite.removeCookie('product');

Quita una cookie del explorador del usuario.

Funciones de depuración

No se debe acceder a las siguientes funciones desde el código de producción. Se han diseñado únicamente con fines de depuración y cambian con el tiempo según sea necesario.

container

Código

_satellite._container

Ejemplo

IMPORTANT
No se debe acceder a esta función desde el código de producción. Se ha diseñado únicamente con fines de depuración y cambia con el tiempo según sea necesario.

monitor

Código

_satellite._monitors

Ejemplo

IMPORTANT
No se debe acceder a esta función desde el código de producción. Se ha diseñado únicamente con fines de depuración y cambia con el tiempo según sea necesario.

Muestra

En la página web que ejecuta una biblioteca de etiquetas, añada un fragmento de código al HTML. Normalmente, el código se inserta en el elemento <head> antes del elemento <script> que carga la biblioteca de etiquetas. Esto permite al monitor capturar los primeros eventos del sistema que se producen en la biblioteca de etiquetas. Por ejemplo:

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>Title</title>
  <script>
    window._satellite = window._satellite || {};
    window._satellite._monitors = window._satellite._monitors || [];
    window._satellite._monitors.push({
      ruleTriggered: function (event) {
        console.log(
          'rule triggered',
          event.rule
        );
      },
      ruleCompleted: function (event) {
        console.log(
          'rule completed',
          event.rule
        );
      },
      ruleConditionFailed: function (event) {
        console.log(
          'rule condition failed',
          event.rule,
          event.condition
        );
      }
    });
  </script>
  <script src="//assets.adobedtm.com/launch-EN5bfa516febde4b22b3e7c6f96f6b439f.min.js"
          async></script>
</head>
<body>
  <h1>Click me!</h1>
</body>
</html>

En el primer elemento de script, ya que la biblioteca de etiquetas aún no se ha cargado, se crea el objeto _satellite inicial y se inicia una matriz en _satellite._monitors. A continuación, el script añade un objeto de monitor a esa matriz. El objeto de monitor puede especificar los siguientes métodos a los que la biblioteca de etiquetas llama posteriormente:

ruleTriggered

Se llama a esta función después de que un evento desencadene una regla, pero antes de que se hayan procesado las condiciones y acciones de la regla. El objeto de evento transmitido a ruleTriggered contiene información sobre la regla activada.

ruleCompleted

Se llama a esta función después de que una regla se haya procesado completamente. En otras palabras, el evento se ha producido, todas las condiciones se han transmitido y todas las acciones se han ejecutado. El objeto de evento enviado a ruleCompleted contiene información acerca de la regla que se ha completado.

ruleConditionFailed

Se llama a esta función después de activar una regla y de que haya fallado una de sus condiciones. El objeto de evento transmitido a ruleConditionFailed contiene información sobre la regla activada y la condición que ha fallado.

Si se llama a ruleTriggered, se llama a ruleCompleted o ruleConditionFailed poco después.

NOTE
Un monitor no tiene que especificar los tres métodos (ruleTriggered, ruleCompleted y ruleConditionFailed). Las etiquetas de Adobe Experience Platform funcionan con los métodos compatibles proporcionados por el monitor.

Prueba del monitor

El ejemplo anterior especifica los tres métodos del monitor. Cuando se los llama, el monitor cierra la información relevante. Para probar esto, configure dos reglas en la biblioteca de etiquetas:

  1. Una regla que tenga un evento de clic y una condición del explorador que se transmita únicamente si el explorador es Chrome.
  2. Una regla que tenga un evento de clic y una condición del explorador que se transmita únicamente si el explorador es Firefox.

Si abre la página en Chrome, abre la consola del explorador y selecciona la página, aparecerá lo siguiente en la consola:

Se pueden añadir nuevos enlaces o información adicional a estos controladores según sea necesario.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743