DocumentaciónTargetGuía para desarrolladores de Target

Inicializar SDK

Última actualización: 5 de mayo de 2025
  • Temas:
  • APIs/SDKs

Creado para:

  • Experimentado
  • Desarrollador

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.

CONSEJO
Haga clic en las imágenes de este tema para expandirlas a pantalla completa.

Inicializar diagrama de SDK

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.

NOTA
Los números de paso de la siguiente ilustración corresponden a las secciones siguientes. Los números de paso no están en un orden particular y no reflejan el orden de los pasos realizados en la interfaz de usuario de Target al crear la actividad.

Inicializar diagrama de SDK

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

Este paso ayuda a garantizar que la biblioteca VisitorAPI.js se carga, configura e inicializa correctamente.

Ver detalles

Cargar diagrama de SDK de API de visitante

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étodo Visitor.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

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.

Ver detalles

Establecer ID de cliente

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

  • Sincronización de perfiles en tiempo real para mbox3rdPartyId

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

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.

Ver detalles

Configurar solicitud automática de carga de página

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

Este paso ayuda a garantizar que no haya parpadeo en la página al enviar experiencias.

Ver detalles

Configurar diagrama de control de parpadeo

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 establecer bodyHiddenStyle y bodyHidingEnabled.

Vuelva al diagrama situado en la parte superior de esta página.

1.5: Configurar asignación de datos

Este paso ayuda a garantizar que se establezcan todos los datos que deben enviarse a Target.

Ver detalles

Diagrama de asignación de datos

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.
  • 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

Agregue elementos promocionados y controle su ubicación en sus Target Recommendations diseños.

Ver detalles

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

Haga recomendaciones basadas en el contenido del carro de compras del usuario.

Ver detalles

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

  • Basado en el carro de compras

Vuelva al diagrama situado en la parte superior de esta página.

1.8: Criterios basados en popularidad

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.

Ver detalles

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

  • Basado en popularidad

Vuelva al diagrama situado en la parte superior de esta página.

1.9: Criterios basados en elementos

Haga recomendaciones basadas en la búsqueda de artículos similares a los que el usuario está viendo o ha visto recientemente.

Ver detalles

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

  • Basado en elemento

Vuelva al diagrama situado en la parte superior de esta página.

1.10: Criterios basados en el usuario

Haga recomendaciones basadas en el comportamiento del usuario.

Ver detalles

Criterios disponibles

  • Recently Viewed Items
  • Recommended for You

Se requieren parámetros de entidad

  • entity.id

Lecturas

  • Basado en usuario

Vuelva al diagrama situado en la parte superior de esta página.

1.11: Criterios personalizados

Cree recomendaciones basadas en un archivo personalizado que haya cargado.

Ver detalles

Criterios disponibles

  • Custom algorithm

Se requieren parámetros de entidad

entity.id o el atributo utilizado como clave para el algoritmo personalizado

Lecturas

  • Criterios personalizados

Vuelva al diagrama situado en la parte superior de esta página.

1.12: Proporcionar atributos utilizados en las reglas de inclusión

Ver detalles

Lecturas

  • Usar reglas de inclusión dinámicas y estáticas

Vuelva al diagrama situado en la parte superior de esta página.

1.13: Proporcionar excludedIds

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.

Ver detalles

Lecturas

  • ¿Puedo excluir dinámicamente una entidad?

Vuelva al diagrama situado en la parte superior de esta página.

1.14: pasar el parámetro entity.event.detailsOnly=true

Use los atributos de entidad para pasar la información de producto o contenido a Target Recommendations.

Ver detalles

Lecturas

  • Atributos de entidad

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.

Ver detalles

Diagrama de asignación de datos remotos

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

función targetPageParams

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

Este paso garantiza que la biblioteca JavaScript at.js se cargue e inicialice.

Ver detalles

Cargar diagrama at.js de Adobe Target

Requisitos previos

  • Descargue o solicite a su equipo de marketing digital el archivo de biblioteca JavaScript at.js 2.*x*.

Lecturas

  • Cómo funciona Target
  • Cómo funciona at.js
  • Implementación de Target sin un administrador de etiquetas

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.

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3