Preguntas frecuentes
Esta guía proporciona respuestas a preguntas que se plantean a menudo sobre el SDK web de Adobe Experience Platform.
¿Qué es el SDK web de Adobe Experience Platform?
El SDK web de Adobe Experience Platform es una biblioteca JavaScript del lado del cliente que le permite interactuar con los distintos servicios de Adobe Experience Cloud.
El SDK web envía datos de forma independiente de la solución (XDM) al Edge Network de Experience Platform, que a su vez asigna los datos a formatos y destinos específicos de la solución y los envía en tiempo real.
Vea el siguiente vídeo para obtener más información sobre el SDK web: Conozca Alloy.js y no vuelva a etiquetar para un eVar o Mbox.
¿En qué se diferencian el SDK web de Adobe Experience Platform de las soluciones anteriores?
Antes del SDK web de Experience Platform
Actualmente, debe implementar diferentes bibliotecas de JavaScript basadas en cada solución individual.
- Cada solución tiene su propia biblioteca, esquema y dominio de JavaScript.
- Ninguna de estas bibliotecas se creó para funcionar entre sí.
- Los casos de uso entre soluciones y Adobe Experience Platform requieren que estas bibliotecas dispares sean interdependientes, lo que provoca fricciones en la implementación.
Aunque las etiquetas en Platform facilitan al máximo la implementación y administración de estas bibliotecas, aún hay problemas con:
- Tamaño de la biblioteca (demasiado código de Adobe en una página)
- Rendimiento (los sitios tardan demasiado en cargarse)
- Varias llamadas para un solo caso de uso
- Esperar el retorno de ECID antes de las llamadas de personalización (causa un retraso)
- Recopilación de datos fraccionada (¿qué es una evar?)
- Confusión de esquemas entre soluciones (A4T)
- Muchas otras cosas menos óptimas
Además, actualmente no hay ninguna biblioteca de JavaScript que envíe datos directamente a Adobe Experience Platform.
Con SDK web de Experience Platform
El nuevo SDK web envía datos para las siguientes soluciones a un único destino (Edge Network de Experience Platform) y resuelve los casos de uso de soluciones mencionados con más frecuencia.
- Adobe Analytics
- Adobe Audience Manager
- Adobe Target
- ID de visitante
- Adobe Experience Platform
A continuación se presentarán otras soluciones.
El SDK web de Adobe Experience Platform también puede enviar datos directamente a Adobe Experience Platform. Estos datos están en formato XDM y se asignan al esquema de soluciones del lado del servidor.
¿Cuál es el valor de este nuevo SDK web?
Rendimiento: El SDK web es más pequeño que todas las bibliotecas de Adobe actuales y proporciona cargas de página considerablemente más rápidas.
Simplicidad: La combinación de XDM, SDK web, etiquetas, Edge Network, soluciones de Adobe Experience Cloud y Adobe Experience Platform crea una historia de recopilación de datos fácil de entender y seguir.
- XDM: esquema independiente de soluciones que usa para enviar datos al Adobe. Se acabaron las etiquetas para evars y mboxes.
- SDK web: facilita el envío y la recepción de datos al Edge Network de Adobe Experience Platform.
- Etiquetas: simplifica la implementación y configuración del SDK web (y cualquier otra etiqueta JavaScript) en un sitio.
- Edge Network: enrute fácilmente los datos a Adobe Experience Platform y a las soluciones en el formato que necesitan.
- Soluciones de Adobe y Adobe Experience Platform: Habilite su propuesta de valor.
Control: Como todos los datos utilizan una única secuencia de datos conectada, puede seguir y controlar lógicamente el aspecto de los datos en cada milisegundo de su recorrido, desde y hacia aplicaciones.
Moderno y listo para el futuro: El SDK web y su conexión con el Edge Network han permitido a Adobe modernizar de manera significativa la forma en que Adobe trata la recopilación de datos, la personalización, el consentimiento y el futuro de las cookies de terceros. (Habilita un dominio de origen, administrado por Adobe).
El Adobe Tiempo de obtención del valor: ha trabajado duro (y seguirá haciéndolo) para que sea lo más fácil posible implementar el SDK web mediante etiquetas y asignar datos del lado del cliente a XDM. Una vez finalizado ese trabajo, todas las demás soluciones de Adobe y servicios de Adobe Experience Platform se pueden activar o desactivar en el lado del servidor. Por ejemplo, si utiliza esto para Adobe Analytics y desea activar Target o Experience Platform, simplemente puede activar una opción en la configuración del flujo de datos y activar esos casos de uso.
¿Qué es alloy.js?
alloy.js es el nombre de la biblioteca JavaScript del SDK web. Se hace referencia a él dentro del código fuente y del nombre de archivo del SDK.
¿Necesitan los clientes comprar Adobe Experience Platform para usar Web SDK?
No. Cualquier cliente de Adobe Digital Experience puede utilizar el SDK web de Adobe Experience Platform de forma gratuita. Los clientes que deseen utilizar Web SDK deberán configurar los permisos adecuados para crear esquemas, conjuntos de datos, áreas de nombres de identidad y flujos de datos en la IU de recopilación de datos o la IU del Experience Platform.
Para obtener más información sobre la configuración de estos permisos, consulte nuestra documentación sobre administración de permisos de recopilación de datos.
¿Quién debe utilizar el SDK web?
El SDK web de Adobe Experience Platform se ha desarrollado para los siguientes clientes:
-
Usuarios de Adobe Experience Platform
- Si necesita enviar datos directamente desde un dispositivo a Adobe Experience Platform, esta es la forma recomendada oficialmente.
- Adobe es consciente de que el uso del conector de Adobe Analytics es más rápido si ya tiene Adobe Analytics, pero no es la estrategia a largo plazo para la recopilación de datos.
-
clientes de la solución Adobe Experience Cloud
- Los nuevos clientes de Adobe Analytics, Adobe Audience Manager y Adobe Target deben empezar con el nuevo SDK web y no utilizar bibliotecas heredadas.
- Los clientes existentes que deseen obtener la implementación más optimizada posible deben utilizar el nuevo SDK web.
¿Cómo obtengo acceso al SDK web?
El SDK web está disponible actualmente para el público en general y se puede utilizar para enviar datos a productos de Adobe Experience Cloud. La capacidad de enviar datos a soluciones de terceros está disponible en un futuro próximo.
El SDK no supone ningún coste y se aloja en el Adobe de forma gratuita. Si es necesario, puede descargarlo y alojarlo en sus propios servidores sin coste alguno.
El SDK web requiere acceso a configuraciones de secuencia de datos y al generador de esquemas XDM🔗 del Experience Platform para que los servidores de Adobe administren correctamente los datos entrantes procedentes del SDK. Si desea obtener acceso, póngase en contacto con el equipo de su cuenta de Adobe para iniciar el proceso de solicitud.
¿Qué casos de uso admite actualmente el SDK web?
El SDK web evoluciona rápidamente. Se están trabajando en más casos de uso. Aquí puede encontrar la lista de casos de uso actualmente admitidos.
¿Los clientes actuales tienen que volver a etiquetar sus sitios?
Depende de ti. El SDK web de Adobe Experience Platform se puede implementar en dos estilos diferentes. Un documento de migración futuro proporcionará detalles adicionales.
-
Solo otra etiqueta: Si el sitio ya está etiquetado para soluciones y no puede volver a etiquetar, pero desea enviar datos al Edge Network de Adobe Experience Platform para casos de uso del Experience Platform o para las próximas funciones de reenvío de eventos (ver a continuación), puede agregar la etiqueta
alloy.jsal sitio, donde funciona como "solo otra etiqueta". -
La única etiqueta: Si desea usar el SDK web para una solución de Experience Cloud, debe usarlo para todas las soluciones de esa página. Por ejemplo: Si su sitio ya está etiquetado para Adobe Analytics y desea utilizarlo para Target, debe utilizarlo tanto para como para cualquier otro en el futuro.
En otras palabras, si decide utilizar el SDK web de Adobe Experience Platform para casos de uso que no sean de solución, puede etiquetar el sitio con alloy.js y continuar como si fuera una nueva solución. Si desea utilizarlo para Adobe Analytics, Target o Audience Manager, o para casos de uso de aplicaciones, es posible que tenga que eliminar cualquiera del código heredado en su página.
¿Puedo migrar los ECID cuando empiece a utilizar el SDK web para que los visitantes del sitio web no empiecen a mostrarse como nuevos visitantes?
Sí, el SDK web de Adobe Experience Platform proporciona una función de migración de identidad. Siga las instrucciones para la migración de ID en la documentación de identidad del SDK web de Platform para obtener más información.
¿En qué se diferencia el SDK web de las etiquetas?
-
Las etiquetas del Experience Platform administran el código del dispositivo. Utilícelos para implementar el código con mayor facilidad. Son libres y poderosos.
-
SDK web de Adobe Experience Platform es el nombre oficial del nuevo código que implementarían las etiquetas para los casos de uso de Adobe. También es libre y poderoso.
-
alloy.jses el nombre de archivo del código SDK web de Adobe Experience Platform.
¿Tengo que utilizar etiquetas para implementar el SDK web?
No. Puede descargar el archivo de alloy.js usted mismo.
Sin embargo:
-
El SDK web de Adobe Experience Platform requiere un elemento denominado ID de flujo de datos para que la red perimetral pueda identificar el flujo y determinar qué hacer con los datos. Este ID se crea en el Experience Platform. Esto no significa que tenga que utilizar la interfaz de usuario para crear propiedades o implementar el código JavaScript, pero sí necesita utilizar etiquetas para crear un ID de configuración.
-
Las etiquetas no solo son el mejor administrador de etiquetas y SDK disponible, sino que también facilita la implementación de
alloy.jsy la asignación de datos a esquemas XDM. Si decide no utilizar etiquetas, deberá administrar la implementación dealloy.js, los eventos y la asignación de los datos en XDM antes de enviarlos. Este es un proceso mucho más difícil que usar etiquetas. -
Se recomienda usar etiquetas para implementar
alloy.js, incluso si es la única etiqueta para la que se usa.
¿Qué es el reenvío de eventos?
Si utiliza nuestros SDK y envía XDM al Edge Network, estas nuevas funciones y el reenvío de eventos le permiten instalar nuevas extensiones del lado del servidor y asignar esos datos a cualquier cosa (y enviarlos a cualquier lugar) desde nuestra red perimetral. Considérelo como "recopilación de datos como un servicio". Esto estará disponible por un coste adicional y se incluirá como parte de Adobe Experience Platform.
¿Qué es un CNAME o dominio de origen y por qué importa?
Encontrará más información sobre un CNAME en la documentación de Adobe
¿Utiliza cookies el SDK web de Adobe Experience Platform? En caso afirmativo, ¿qué cookies utiliza?
Sí, actualmente el SDK web utiliza entre una y siete cookies en función de su implementación. A continuación se muestra una lista de las cookies que puede ver con el SDK web y la forma en que se utilizan:
idMigrationEnabled para obtener más información.Al utilizar el SDK web, el Edge Network establece una o más de las cookies anteriores. El Edge Network establece todas las cookies con los atributos secure y sameSite="none".
Si actualmente tiene secciones seguras y no seguras en su sitio web, esto podría interferir con la identificación del usuario. Cuando un usuario navega de una sección segura del sitio a una sección no segura, el Edge Network genera un nuevo(a) ECID con la solicitud.
¿Con qué exploradores es compatible el SDK web de Adobe Experience Platform?
El SDK web de Adobe Experience Platform está diseñado para funcionar de forma óptima en las últimas versiones de Google Chrome, Safari, Firefox y Microsoft Edge Chromium. Es posible que tenga problemas al utilizar determinadas funciones en versiones anteriores de exploradores o exploradores obsoletos, como Internet Explorer.