Información general sobre el desarrollo de extensiones

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.

Uno de los objetivos principales de las etiquetas en Adobe Experience Platform es crear un ecosistema abierto en el que los ingenieros que no estén en Adobe puedan exponer las funcionalidades adicionales de sus sitios web y aplicaciones móviles. Esto se logra mediante las extensiones de etiquetas. Una vez instalada una extensión en una propiedad de etiqueta, la funcionalidad de dicha extensión queda disponible para que la utilicen todos los usuarios de la propiedad.

Este documento describe los componentes principales de una extensión y proporciona vínculos a documentación adicional que le ayudará a guiarse en el proceso de desarrollo de la extensión.

Estructura de las extensiones

Una extensión consiste en un directorio de archivos. Específicamente, una extensión consta de un archivo de manifiesto, módulos de biblioteca y vistas.

Archivo de manifiesto

Un archivo de manifiesto (extension.json) debe existir en la raíz del directorio. Este archivo describe la composición de la extensión y dónde se encuentran ciertos archivos dentro del directorio. El manifiesto funciona de manera similar a un package.json archivo en un npm proyecto.

Módulos de biblioteca

Los módulos de biblioteca son los archivos que describen las diferentes componentes que una extensión proporciona (es decir, la lógica que se emitirá dentro de la biblioteca de tiempo de ejecución de etiquetas). El contenido de cada archivo de módulo de biblioteca debe seguir el Estándar del módulo CommonJS.

Por ejemplo, si está generando un tipo de acción llamado "enviar señalización", debe tener un archivo que contenga la lógica que envía la señalización. Si utiliza JavaScript, se podría llamar al archivo sendBeacon.js. El contenido de dicho archivo se emitirá en la biblioteca de tiempo de ejecución de etiquetas.

Puede colocar los archivos del módulo de biblioteca en cualquier lugar que desee dentro del directorio de extensiones, siempre que describa sus ubicaciones en extension.json.

Vistas

Una vista es un archivo de HTML que se puede cargar en una iframe elemento dentro de la aplicación de etiquetas, específicamente a través de la IU de Platform y la IU de recopilación de datos. La vista debe incluir una secuencia de comandos proporcionada por la extensión y ajustarse a una pequeña API para poder comunicarse con la aplicación.

El archivo de vista más importante para cualquier extensión es su configuración. Consulte la sección sobre configuraciones de extensión para obtener más información.

No hay restricciones en cuanto a las bibliotecas que se utilizan en sus vistas. En otras palabras, puede utilizar jQuery, Underscore, React, Angular, Bootstrap u otros. Sin embargo, se recomienda hacer que la extensión tenga una apariencia similar a la de la interfaz de usuario.

Se recomienda colocar todos los archivos relacionados con la vista (HTML, CSS, JavaScript) en un único subdirectorio aislado de los archivos del módulo de biblioteca. Entrada extension.json, puede describir dónde se encuentra este subdirectorio de vista. Entonces, Platform servirá dicho subdirectorio (y solo ese subdirectorio) desde sus servidores web.

Componentes de biblioteca components

Cada extensión define un conjunto de funcionalidades. Estas funcionalidades se implementan al incluirse en un biblioteca que se implementa en el sitio web o la aplicación. Las bibliotecas son una colección de componentes individuales, que incluyen condiciones, acciones, elementos de datos y mucho más. Cada componente de biblioteca es un fragmento de código reutilizable (proporcionado por una extensión) que se emite dentro del tiempo de ejecución de la etiqueta.

Dependiendo de si está desarrollando una extensión web o una extensión Edge, los tipos de componentes disponibles y sus casos de uso difieren. Consulte las subsecciones siguientes para obtener una descripción general de los componentes disponibles para cada tipo de extensión.

Componentes para extensiones web web

En las extensiones web, las reglas se activan mediante eventos que pueden ejecutar acciones específicas si se cumple un conjunto determinado de condiciones. Consulte la descripción general del flujo de módulos en extensiones web para obtener más información.

Además de las módulos principales mediante Adobe, puede definir los siguientes componentes de biblioteca en las extensiones web:

NOTE
Para obtener más información sobre el formato requerido para implementar los componentes de biblioteca en las extensiones web, consulte información general sobre el formato del módulo.

Componentes para extensiones de Edge edge

En las extensiones de Edge, las reglas se activan mediante comprobaciones de condiciones que luego ejecutan acciones específicas si se superan dichas comprobaciones. Consulte la descripción general de la flujo de extensión de Edge para obtener más información.

Puede definir los siguientes componentes de biblioteca en las extensiones de Edge:

NOTE
Para obtener más información sobre el formato requerido para implementar módulos de biblioteca en extensiones de Edge, consulte la descripción general del formato de los módulos.

Configuración de extensión configuration

La configuración de una extensión hace referencia a la manera en que recopila la configuración global de un usuario. La configuración consiste en un componente de vista que exporta y emite la configuración de la biblioteca de tiempo de ejecución de etiquetas como objeto sin formato.

Por ejemplo, considere una extensión que permita al usuario enviar una señalización mediante la acción "Enviar señalización" y la señalización siempre debe contener un ID de cuenta. En lugar de solicitar a los usuarios un ID de cuenta cada vez que configuran una acción "Enviar señalización", la extensión debe solicitar el ID de cuenta una vez desde la vista de configuración de la extensión. Cada vez que se envía una señalización, la acción "Enviar señalización" puede extraer el ID de cuenta de la configuración de la extensión y añadirlo a la señalización.

Cuando los usuarios instalan una extensión en una propiedad de la interfaz de usuario de, se les muestra la vista de configuración de la extensión, que deben completar para finalizar la instalación.

Para obtener más información, consulte la guía de configuraciones de extensión.

Envío de extensiones

Una vez que haya terminado de crear la extensión, puede enviarla para que aparezca en el catálogo de extensiones en Platform. Consulte la resumen del proceso de envío de extensiones para obtener más información.

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