Ir al contenido principal
Scripts Personalizados: ¿Qué Son y Cómo Usarlos?

Los scripts personalizados permiten inyectar secuencias de comandos de terceros en su Flipbook. ¡Sigue leyendo para saber más!

Actualizado esta semana

Los scripts personalizados (custom scripting) te permiten realizar secuencias de comandos para lograr ciertas funcionalidades que caen fuera de las características nativas de la plataforma de iPaper.

Los scripts personalizados son incrustados en las etiquetas de encabezado y pie de página de tu Flipbook.

📖 Esta guía te explica:


¿Cuándo utilizar un script personalizado?

Puedes incrustar cualquier script en tu Flipbook usando el módulo Custom Scripting, lo que significa que el cielo es el límite. Sin embargo, algunos de los casos más comunes para su uso son:

¿Cómo activar un script personalizado en tu cuenta?

Los scripts personalizados están disponibles con todas las suscripciones de iPaper pero sólo los usuarios con permiso de Administrador pueden acceder a ellos.

💡 Si no sabes quién es el administrador de tu cuenta, sigue estos pasos para averiguarlo.

Como administrador de la cuenta, tienes que activar el módulo Custom Scripting (Script personalizado) antes de poder incrustar el código a tu Flipbook:

  1. En la vista general de Flipbooks, haz clic derecho a nivel de cuenta, carpeta o Flipbook, dependiendo en dónde te gustaría incrustar el script personalizado.

  2. Selecciona Edit settings (Editar configuración) del menú desplegable.

  3. Dirígete a la pestaña Modules (Módulos).

  4. Selecciona Custom scripting del menú vertical de la izquierda

  5. En la vista de Custom Scripting, activa el módulo. Una vez que esté en verde, podrás pegar el código en cualquiera de los campos disponibles.

¡No olvides hacer clic en Save changes para guardar tus cambios!

1. Actívalo usando Configuración Heredada

The Inherited Settings feature lets you apply custom scripts across multiple Flipbooks. La configuración heredada te permite aplicar un script personalizado en múltiples Flipbooks.

Si inyectas tu código a nivel de cuenta, podrás utilizarlo en todos tus Flipbooks. A nivel de carpeta, aplicará sólo a Flipbooks y subcarpetas localizadas dentro de la carpeta elegida. Finalmente, puedes inyectarlo directamente en un Flipbook y ver sus efectos sólo ahí.

2. ¿Por qué dos campos para scripts personalizados?

Nuestra plataforma permite utilizar varios scripts personalizados de forma asíncrona.

En general, es recomendable agregar los scripts en el campo Scripts a nivel de Flipbook, carpeta o cuenta. En casos especiales, si necesitas un script particular para ciertos Flipbooks o folders, utiliza el campo Extra Scripts para diferenciar tu script global del local.

Algunas consideraciones al usar scripts personalizados

Los scripts personalizados son increíblemente versátiles, ya que permiten inyectar casi cualquier tipo de secuencia de comandos de terceros en el Flipbook. Sin embargo, al usarlos hay que tener en cuenta algunas cosas:

  • No recomendamos usar un script que interactúe o altere el Modelo de Objetos del Documento (DOM), ya que puede afectar el desempeño del Flipbook y causar problemas de carga o funcionalidad.

⚠️ Los scripts que interactúan con el DOM y son agregados en las etiquetas de encabezado o pie de página se utilizan bajo tu propia responsabilidad. iPaper no puede garantizar su funcionalidad ni ofrecer soporte para ellos. Antes de usarlos, contáctanos y te podremos asesorar con soluciones alternativas.

  • La capa de datos (data layer) no se puede acceder directamente con soluciones de analytics personalizadas, a diferencia de nuestra integración nativa con Google o Adobe Analytics.

⚠️ Para asegurar que tu script personalizado de analytics funcione correctamente, tienes que crear tu propia capa de datos utilizando nuestra JS API. Te recomendamos usar JS API para la integración, ya que los event listeners no son soportados oficialmente.

Convierte tu PDF en una experiencia interactiva de compras en línea

Entiende cómo esta y otras tácticas para Flipbooks pueden ayudarte a atraer e inspirar a tus clientes en nuestro Marco de Éxito.

¿Ha quedado contestada tu pregunta?