Decoración de enlaces

Actualmente, la decoración de enlaces es una característica que debe ser configurada por el equipo de Éxito del Cliente de Fanplayr. Contacta a tu gerente si deseas utilizar esta característica.

Fanplayr puede integrarse en múltiples dominios pertenecientes a la misma cuenta. Normalmente, cada dominio correspondería a una campaña separada y a su propia sesión de navegación distinta para esa campaña. Sin embargo, hay escenarios en los que podría ser mejor usar una sola campaña y sesión de navegación en múltiples dominios.

Decoración de enlaces es una característica que permite que una sesión de Fanplayr continúe a través de múltiples dominios. Funciona aumentando los enlaces en la página para que incluyan el identificador de sesión de Fanplayr, asegurando que esta información se transfiera al dominio siguiente.

Se pueden emplear múltiples técnicas para decorar enlaces en las páginas. Estas técnicas se pueden aplicar de forma extensiva a todos los enlaces de la página, o de forma más restringida para dirigirse solo a enlaces específicos. Cada técnica tiene ventajas y desventajas, y su uso dependerá de las necesidades del sitio web y de cómo esté diseñado:

• Reescribiendo enlaces normales (<a href="..."> tags).
• Reescribiendo URLs de acciones de formulario.
• Monitoreando clics en la página, luego, si se hizo clic en un enlace, reescribirlo antes de la navegación.
• Aumentando APIs del navegador como window.open().

La decoración de enlaces se puede habilitar configurando la siguiente estructura JSON como la preferencia de cuenta linkAugmentConfig:

[
  {
    // La configuración solo funciona en nombres de host que coincidan con este patrón RegExp.
    domainPattern: 'store\\.com',
    // Solo decorará los enlaces que coincidan con este patrón RegExp.
    linkPattern: 'other-store\\.com',
    // Envuelve `window.open()` y decora el primer argumento.
    windowOpen: true,
    // Decora todos los anclajes con hrefs que coincidan con el patrón del enlace.
    rewriteHrefs: false,
    // Decora todos los formularios con acciones que coincidan con el patrón del enlace.
    rewriteForms: false,
    // Escucha todos los clics en la página y decora el enlace más cercano.
    monitorClicks: true,
    // Retrasa la inicialización por X milisegundos.
    delay: 1000
  }
];

domainPattern

• Tipo: cadena
• Requerido: Sí

Si la URL actual en el navegador coincide con este patrón, las reglas de la configuración se aplican a la vista de página actual. Solo se utiliza la primera configuración que coincide.

linkPattern

• Tipo: cadena (expresión regular)
• Requerido: Sí

Solo los enlaces que coinciden con este patrón son decorados (modificados) para añadir parámetros que ayuden a continuar la sesión después de la navegación.

delay

• Tipo: entero
• Por defecto: 0

El número de milisegundos a esperar antes de ejecutar los métodos de configuración de decoración de enlaces.

windowOpen

• Tipo: booleano
• Por defecto: false

Método de decoración
Envuelve el método window.open() para observar las llamadas a esta API del navegador. Cualquier URL que coincida con linkPattern se decora antes de pasarla de nuevo al método nativo del navegador.

rewriteHrefs

• Tipo: booleano
• Por defecto: false

Método de decoración
Busca todas las etiquetas <a> en la página y las decora en su lugar si su atributo href coincide con linkPattern.

rewriteForms

• Tipo: booleano
• Por defecto: false

Método de decoración
Busca todas las etiquetas <form> en la página y decora aquellas con un atributo action que coincida con linkPattern.

monitorClicks

• Tipo: booleano
• Por defecto: false

Método de decoración
Adjunta oyentes de eventos click y touchstart al documento utilizando la fase de captura. Cuando el usuario interactúa con cualquier parte del documento, se encuentra la etiqueta <a> más cercana y se decora si su atributo href coincide con linkPattern.