Inicializar SDK
Siga los pasos del diagrama Inicializar SDK para asegurarse de que todas las tareas necesarias para cargar la biblioteca JavaScript at.js de Adobe Target se ejecuten en la secuencia correcta.
Inicializar diagrama de SDK diagram
En el caso de las aplicaciones de varias páginas, este flujo se produce cada vez que la página se vuelve a cargar o el visitante navega a una nueva página del sitio web.
Haga clic en los siguientes vínculos para desplazarse a las secciones deseadas:
- 1.1: cargar el SDK de la API de visitante
- 1.2: Establecer el ID de cliente
- 1.3: Configurar la solicitud automática de carga de página
- 1.4: Configurar la gestión de parpadeos
- 1.5: Configurar asignación de datos
- 1.6: Promoción
- 1.7: Criterios basados en el carro de compras
- 1.8: Criterios basados en popularidad
- 1.9: Criterios basados en elementos
- 1.10: Criterios basados en el usuario
- 1.11: Criterios personalizados
- 1.12: Proporcionar atributos utilizados en las reglas de inclusión
- 1.13: Proporcionar excludedIds
- 1.14: Pasar el parámetro entity.event.detailsOnly=true
- 1.15: Configurar la asignación de datos remotos
- 1.16: cargar at.js
1.1: cargar el SDK de la API de visitante load
Este paso ayuda a garantizar que la biblioteca VisitorAPI.js
se carga, configura e inicializa correctamente.
Requisitos previos
- Para usar el servicio API/ID de visitante, su compañía debe estar habilitada para Adobe Experience Cloud y tener un Organization ID. Para obtener más información, consulte Requisitos del Experience Cloud: ID de organización en la guía Ayuda del servicio de identidad.
- Necesita el archivo
VisitorAPI.js
. Ya debería tener este archivo si tiene Adobe Analytics implementado. Este archivo también se puede agregar mediante la Adobe Experience Platform extensión de etiquetas o se puede descargar desde el Administrador de códigos Adobe Analytics.
Configurar y hacer referencia a VisitorAPI.js
Para obtener más información, consulte Implementar el servicio de Experience Cloud para Target.
Lecturas
- Descripción general del servicio de identidad del Experience Cloud
- Acerca del servicio de ID
- Cookies y el servicio de identidad del Experience Cloud
- Solicitud y configuración de ID con el servicio de identidad de Experience Cloud
- Explicación de la sincronización de ID y tasas de coincidencia
Acciones
- Incruste el archivo
VisitorAPI.js
en sus páginas web. - Obtenga información acerca de las configuraciones disponibles para el servicio API/ID de visitante.
- Una vez cargado el archivo
VisitorAPI.js
, use el métodoVisitor.getInstance
para inicializar con las configuraciones necesarias. - Familiarícese con los métodos disponibles.
Vuelva al diagrama situado en la parte superior de esta página.
1.2: Establecer el ID de cliente set
Este paso ayuda a garantizar que los ID conocidos de los visitantes (ID de CRM, ID de usuario, etc.) estén vinculados al ID anónimo de Adobe para la personalización entre dispositivos.
Requisitos previos
- El ID conocido de los visitantes debe estar disponible en la capa de datos.
Establecer ID de cliente
Para obtener más información, consulte setCustomerIDs.
Lecturas
Acciones
- Use
visitor.setCustomerIDs
para establecer el ID conocido del visitante.
Vuelva al diagrama situado en la parte superior de esta página.
1.3: Configurar la solicitud automática de carga de página automatic
Este paso permite que at.js recupere todas las experiencias que se deben procesar en la página al cargar el archivo de biblioteca JavaScript at.js.
Requisitos previos
- No todos los datos de la capa de datos deben enviarse a Target. Consulte con su equipo empresarial (equipo de marketing digital) para determinar qué datos son valiosos para la experimentación, la optimización y la personalización. Solo se deben enviar estos datos a Target.
- Asegúrese de no enviar ningún dato de información de identificación personal (PII) a Target.
Configurar solicitud automática de carga de página
Para obtener más información, consulte targetGlobalSettings().
Lecturas
Obtenga información acerca de la configuración pageLoadEnabled
en targetGlobalSettings().
Acciones
- Modifique el objeto
window.targetGlobalSettings
para habilitar las solicitudes automáticas de carga de página.
Vuelva al diagrama situado en la parte superior de esta página.
1.4: Configurar la gestión de parpadeos flicker
Este paso ayuda a garantizar que no haya parpadeo en la página al enviar experiencias.
Requisitos previos
- Hable con el equipo responsable del rendimiento de la página web sobre los pros y los contras de controlar el parpadeo mediante el método predeterminado utilizado por at.js. Puede buscar patrones de diseño que le permitan utilizar una solución personalizada de control de parpadeo, como la animación del cargador. Si no encuentra ningún patrón, puede solicitar uno nuevo.
Configurar la administración de parpadeos
Para obtener más información, consulte targetGlobalSettings().
Si se establece bodyHidingEnabled
en true
, se oculta todo el cuerpo de la página mientras la solicitud de carga de página está en curso. Si no ha habilitado la solicitud automática de carga de página por algún motivo (por ejemplo, si los datos no están listos más adelante), es mejor establecer esta configuración en false
.
Si ha deshabilitado bodyHidingEnabled
porque no desea activar el APLR y desea activar la solicitud de página más adelante, o no necesita controlar el parpadeo, debe implementar su propia gestión del parpadeo. Puede controlar el parpadeo de dos formas: ocultando las secciones en prueba o mostrando un pulsador en las secciones en prueba.
Lecturas
- Cómo gestiona at.js el parpadeo
- Obtenga información acerca de los objetos bodyHiddenStyle y bodyHidingEnabled en targetGlobalSettings().
Acciones
- Modifique el objeto
window.targetGlobalSettings
para establecerbodyHiddenStyle
ybodyHidingEnabled
.
Vuelva al diagrama situado en la parte superior de esta página.
1.5: Configurar asignación de datos data-mapping
Este paso ayuda a garantizar que se establezcan todos los datos que deben enviarse a Target.
Requisitos previos
-
La capa de datos debe estar lista con todos los datos que deben enviarse a Target.
-
Recommendations: enriquecer perfil.
- Pase
entity.id
para capturar los datos de los criterios y artículos vistos recientemente según los criterios basados en el último producto visto. - Pase
entity.id
para capturar datos para los criterios de popularidad basados en la categoría de favoritos. - Pase el atributo de perfil si los criterios personalizados se basan en él o se utilizan en el filtrado de reglas de inclusión en cualquier criterio.
- Pase
-
Recommendations: ingerir datos de productos.
- Se pueden pasar otros parámetros de entidad (reservados y personalizados) para introducir o actualizar el catálogo de productos en Recommendations.
- El catálogo de productos también se puede actualizar usando fuentes de entidad usando la interfaz de usuario o la API de Target.
Asignar datos aTarget
Para obtener más información, consulte targetPageParams().
Lecturas
- targetPageParams()
- Planificar e implementar Recommendations
- Configurar el catálogo de Recommendations
Acciones
- Utilice la función
targetPageParams()
para establecer todos los datos necesarios que deben enviarse a Target.
Vuelva al diagrama situado en la parte superior de esta página.
1.6: Promoción promotion
Agregue elementos promocionados y controle su ubicación en sus Target Recommendations diseños.
Opciones disponibles
- Promocionar por ID
- Promocionar por colección
- Promocionar por atributo
Se requieren parámetros de entidad
- El atributo de elemento de la promoción debe pasarse al utilizar la opción "promocionar por atributo".
Vuelva al diagrama situado en la parte superior de esta página.
1.7: Criterios basados en el carro de compras cart
Haga recomendaciones basadas en el contenido del carro de compras del usuario.
Criterios disponibles
- People Who Viewed These, Viewed Those
- People Who Viewed These, Bought Those
- People Who Bought These, Bought Those
Se requieren parámetros de entidad
- cartIds
Lecturas
Vuelva al diagrama situado en la parte superior de esta página.
1.8: Criterios basados en popularidad popularity
Haga recomendaciones basadas en la popularidad general de un elemento en el sitio o en la popularidad de elementos dentro de la categoría, marca, género, etc. favoritos o más vistos de un usuario.
Criterios disponibles
- Most Viewed Across the Site
- Most Viewed by Category
- Most Viewed by Item Attribute
- Top Sellers Across the Site
- Top Sellers by Category
- Top Sellers by Item Attribute
- Top by Analytics Metric
Se requieren parámetros de entidad
entity.categoryId
o el atributo de elemento para popularidad basada en si los criterios se basan en el elemento actual o en el atributo de elemento.- No se debe pasar nada para los más visitados/más vendidos en el sitio.
Lecturas
Vuelva al diagrama situado en la parte superior de esta página.
1.9: Criterios basados en elementos item
Haga recomendaciones basadas en la búsqueda de artículos similares a los que el usuario está viendo o ha visto recientemente.
Criterios disponibles
- People Who Viewed This, Viewed That
- People Who Viewed This, Bought That
- People Who Bought This, Bought That
- Items with Similar Attributes
Se requieren parámetros de entidad
entity.id
o cualquier atributo de perfil utilizado como clave
Lecturas
Vuelva al diagrama situado en la parte superior de esta página.
1.10: Criterios basados en el usuario user
Haga recomendaciones basadas en el comportamiento del usuario.
Criterios disponibles
- Recently Viewed Items
- Recommended for You
Se requieren parámetros de entidad
entity.id
Lecturas
Vuelva al diagrama situado en la parte superior de esta página.
1.11: Criterios personalizados custom
Cree recomendaciones basadas en un archivo personalizado que haya cargado.
Criterios disponibles
- Custom algorithm
Se requieren parámetros de entidad
entity.id
o el atributo utilizado como clave para el algoritmo personalizado
Lecturas
Vuelva al diagrama situado en la parte superior de esta página.
1.12: Proporcionar atributos utilizados en las reglas de inclusión inclusion
Vuelva al diagrama situado en la parte superior de esta página.
1.13: Proporcionar excludedIds exclude
Pase los ID de entidad de las entidades que desee excluir de las recomendaciones. Por ejemplo, quizás desee excluir artículos que ya se encuentren en el carro de compras.
Vuelva al diagrama situado en la parte superior de esta página.
1.14: pasar el parámetro entity.event.detailsOnly=true
true
Use los atributos de entidad para pasar la información de producto o contenido a Target Recommendations.
Lecturas
Vuelva al diagrama situado en la parte superior de esta página.
1.15: Configurar la asignación de datos remota (remota)
Este paso garantiza que todos los datos que deben enviarse a Target estén establecidos.
Requisitos previos
- La capa de datos debe estar lista con todos los datos que deben enviarse a Target.
Configurar proveedores de datos
Para obtener más información, consulte Proveedores de datos.
Lecturas
Acciones
Utilice la función targetPageParams()
para establecer todos los datos necesarios que deben enviarse a Target.
Vuelva al diagrama situado en la parte superior de esta página.
1.16: cargar at.js web
Este paso garantiza que la biblioteca JavaScript at.js se cargue e inicialice.
Requisitos previos
- Descargue o solicite a su equipo de marketing digital el archivo de biblioteca JavaScript
at.js 2.*x*
.
Lecturas
Acciones
Incruste el archivo at.js en todas las páginas web donde se debe llevar a cabo la experimentación, la optimización, la personalización y la recopilación de datos.
Vuelva al diagrama situado en la parte superior de esta página.
Continúe con el paso 2: Configurar la recopilación de datos.