Introducción a la extensión de etiquetas Web SDK
Use tags (anteriormente Launch) de Adobe Experience Platform para enviar datos de evento desde su sitio web a Edge Network y a las soluciones de Adobe posteriores.
Antes de seguir estos pasos, asegúrese de tener acceso a los siguientes derechos de propiedad:
- Develop
- Manage extensions
Además, asegúrese de que tiene todos los permisos en las siguientes categorías:
- Modelado de datos
- Identidades
Creación de un esquema XDM schema
El Modelo de datos de experiencia (XDM) es una especificación de código abierto que proporciona estructuras y definiciones comunes para datos en forma de esquemas. Se recomienda encarecidamente configurar un esquema al enviar datos a Edge Network.
- Inicie sesión en experience.adobe.com con sus credenciales de Adobe ID.
- Vaya a Data Collection > Schemas.
- Seleccione Create schema.
- Seleccione Experience Event y luego seleccione Next.
- Asigne un nombre al esquema y seleccione Finish.
- (Opcional) Puede agregar más campos o grupos de campos para cualquier dato adicional que desee recopilar.
Crear un flujo de datos datastream
Un conjunto de datos es una configuración que indica a Edge Network cómo gestionar los datos que lo envía. Al configurar un conjunto de datos para enviar datos a un producto determinado, el conjunto de datos pasa automáticamente los datos relevantes a cada producto respectivo de una manera que el producto específico entiende.
- Vaya a Data Collection > Datastreams.
- Seleccione New datastream.
- Asigne un nombre al conjunto de datos y seleccione el esquema creado recientemente en Mapping schema.
- Seleccione Save.
Creación de una propiedad de etiqueta
Una vez creados un esquema y una secuencia de datos, puede crear y configurar una propiedad de etiqueta.
- Vaya a Data Collection > Tags.
- Seleccione New property.
- Asigne un nombre y un dominio a la propiedad de etiqueta y seleccione Save.
Instalación de la extensión de etiqueta
La extensión de etiquetas Web SDK está instalada en una propiedad de etiquetas determinada.
- Vaya a Data Collection > Tags > Extensions.
- Seleccione la pestaña Catalog .
- Use la búsqueda para encontrar la extensión Adobe Experience Platform Web SDK.
- Seleccione la tarjeta de extensión y, a continuación, seleccione Install a la derecha.
Configuración de la extensión de etiqueta
Al instalar la extensión de etiquetas Web SDK, se le redirige automáticamente a la página Configuración.
- En la sección Secuencias de datos, seleccione la secuencia de datos que desee para cada entorno.
Todas las demás opciones de configuración se rellenan automáticamente o son opcionales. Defina las opciones de configuración que desee y seleccione Save.
Crear un elemento de datos variable
Adobe recomienda usar los elementos de datos Variable para almacenar la carga útil que desea enviar a Adobe. Los objetos XDM también son elementos de datos disponibles, pero son más antiguos y limitados en los casos de uso aplicables.
-
Vaya a Data Collection > Tags.
-
Seleccione la propiedad de etiquetas que desee.
-
Seleccione Data elements > Create new data element.
-
Asigne al elemento de datos las siguientes propiedades a la izquierda:
- Name: cualquier nombre deseado
- Extension: Adobe Experience Platform Web SDK
- Data element type: Variable
-
Establezca las siguientes propiedades a la derecha:
Tipo de variable: XDM
Sandbox: la zona protegida en la que creó el esquema
Schema: el esquema deseado -
Seleccione Save.
Crear una regla
Las reglas determinan cuándo desea almacenar en déclencheur algo o establecer variables. La creación de una regla que se ejecute cada vez que se carga la biblioteca de permite rellenar fácilmente las variables que desea que contengan un valor en cada página.
-
Vaya a Data Collection > Tags.
-
Seleccione la propiedad de etiquetas que desee.
-
Seleccione Rules > Add rule.
-
Asigne un nombre a la regla.
-
Seleccione el icono '
+' junto a Events. -
Asigne al evento la siguiente configuración:
- Extension: Core
- Event type: Library loaded (page top)
-
Seleccione Keep changes.
Los pasos anteriores establecen la parte de criterios de la regla, que se almacena en déclencheur una vez que se carga la biblioteca. Los siguientes pasos establecen las medidas que deben tomarse cuando se cumplan esos criterios.
-
Seleccione el icono '
+' junto a Actions. -
Asigne a la acción la siguiente configuración a la izquierda:
- Extension: Adobe Experience Platform Web SDK
- Action type: Send event
-
Establezca los siguientes campos a la derecha:
- XDM: elemento de datos de la variable XDM
-
Seleccione Keep changes.
Publicación
La propiedad tag contiene todos los componentes necesarios para enviar datos a Edge Network.
- Vaya a Data Collection > Publishing flow.
- Seleccione Add library.
- Asigne un nombre a la biblioteca. Considere este nombre similar a un nombre de confirmación cuando trabaje en el software de control de versiones.
- Establezca el menú desplegable de entorno en Development.
- Seleccione Add all changed resources.
- Seleccione Save & build to Development.
Los cambios se implementarán en el entorno de desarrollo.
- Vaya a Data Collection > Environments.
- Seleccione el icono de instalación situado junto al entorno de desarrollo de
- Instale el código incrustado en una página web de prueba del sitio.
Una vez que valide que la etiqueta funciona en su entorno de desarrollo, puede utilizar la interfaz Publishing flow para publicar la biblioteca en ensayo y, finalmente, en producción.
- Agregue la extensión y la regla a una biblioteca, créela en un entorno e instale el código incrustado en el sitio.
- Validar con Adobe Experience Platform Debugger.
Ahora tiene una configuración ligera que captura eventos y los envía a Edge Network. Ahora puede seguir creando la implementación añadiendo campos al esquema, añadiendo productos a un conjunto de datos o añadiendo elementos de datos a la propiedad de etiqueta.