DocumentaciónExperience PlatformTutorial de SDK web

Configuración de Adobe Target con el SDK web de Platform

Last update: Fri Jun 28 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Principiante
  • Intermedio
  • Desarrollador

Obtenga información sobre cómo implementar Adobe Target mediante el SDK web de Adobe Experience Platform. Obtenga información sobre cómo ofrecer experiencias y cómo pasar los parámetros adicionales a Target.

Adobe Target es la aplicación de Adobe Experience Cloud que le proporciona todo lo necesario para adaptar y personalizar la experiencia de sus clientes con el fin de maximizar los ingresos de sus sitios web, aplicaciones y otros canales digitales, tanto para PC como para móviles.

Diagrama del SDK web y Adobe Target

Objetivos de aprendizaje

Al final de esta lección, puede hacer lo siguiente con una implementación del SDK web de Target:

  • Añada el fragmento preocultado para evitar el parpadeo
  • Configuración de una secuencia de datos para habilitar la funcionalidad de Target
  • Procesar actividades del compositor de experiencias visuales
  • Procesar actividades del compositor de formularios
  • Pasar datos XDM a Target y comprender la asignación a parámetros de Target
  • Pasar datos personalizados a Target, como parámetros de perfil y de entidad
  • Validar una implementación de Target.
  • Separar solicitudes de personalización de solicitudes de análisis
TIP
Consulte nuestra Migración de Target de at.js 2.x al SDK web de Platform tutorial para obtener una guía paso a paso sobre cómo migrar la implementación de at.js existente.

Requisitos previos

Para completar las lecciones de esta sección, primero debe:

Agregar control de parpadeo

Antes de empezar, determine si se requiere una solución adicional de control de parpadeos en función de cómo se cargue la biblioteca de etiquetas.

NOTE
Este tutorial utiliza el Sitio web de Luma, que tiene una implementación asíncrona de etiquetas y una mitigación de parpadeo. Esta sección es una referencia para comprender cómo funciona la mitigación de parpadeo con el SDK web de Platform.

Implementación asincrónica

Cuando una biblioteca de etiquetas se carga de forma asíncrona, es posible que la página termine de procesarse antes de que Target haya reemplazado el contenido predeterminado por contenido personalizado. Este comportamiento puede llevar a lo que se conoce como "parpadeo", en el que el contenido predeterminado aparece brevemente antes de ser reemplazado por el contenido personalizado. Si desea evitar este parpadeo, Adobe recomienda añadir un fragmento preocultado especial inmediatamente antes del código incrustado de etiqueta asincrónico de.

Este fragmento ya está presente en el sitio de Luma, pero echemos un vistazo más de cerca para comprender lo que hace este código:

<script>
  !function(e,a,n,t){var i=e.head;if(i){
  if (a) return;
  var o=e.createElement("style");
  o.id="alloy-prehiding",o.innerText=n,i.appendChild(o),setTimeout(function(){o.parentNode&&o.parentNode.removeChild(o)},t)}}
  (document, document.location.href.indexOf("adobe_authoring_enabled") !== -1, ".personalization-container { opacity: 0 !important }", 3000);
</script>

El fragmento de preocultación crea una etiqueta de estilo en el encabezado de la página con la definición CSS que elija. Esta etiqueta de estilo se elimina cuando se recibe una respuesta de Target o se alcanza el tiempo de espera.

El comportamiento de preocultación se controla mediante dos configuraciones al final del fragmento.

  • body { opacity: 0 !important } especifica la definición de CSS que se utiliza para la preocultación hasta que se carga Target. De forma predeterminada, toda la página está oculta. Puede actualizar esta definición a los selectores que desea ocultar previamente junto con cómo desea ocultarlos. Puede incluir varias definiciones, ya que este valor es simplemente lo que se inserta en la etiqueta de estilo de ocultamiento previo. Si tiene un elemento contenedor fácil de identificar que incluya el contenido debajo de su navegación, puede utilizar este ajuste para limitar la preocultación a ese elemento contenedor.
  • 3000 especifica el tiempo de espera en milisegundos para la preocultación. Si no se recibe una respuesta de Target antes del tiempo de espera, se elimina la etiqueta de estilo de ocultamiento previo. No es habitual alcanzar este tiempo de espera.
NOTE
El fragmento de preocultación para el SDK web de Platform es ligeramente diferente del utilizado con la biblioteca at.js de Target. Asegúrese de utilizar el fragmento correcto para el SDK web de Platform, ya que utiliza un ID de estilo diferente de alloy-prehiding. Si se utiliza el fragmento de ocultamiento previo para at.js, es posible que no funcione correctamente.

El fragmento de ocultamiento previo también está disponible en las etiquetas:

  1. Vaya a la Extensiones sección de etiquetas

  2. Seleccionar Configurar para la extensión SDK para web de Adobe Experience Platform

  3. Seleccione el Copiar fragmento de ocultamiento previo en el portapapeles botón

    Fragmento de ocultamiento previo de Target para implementaciones asíncronas

    note note
    NOTE
    El fragmento de ocultamiento previo predeterminado copiado de la extensión del SDK web de Platform puede incluir una definición de CSS que no existe en el sitio, como .personalization-container { opacity: 0 !important }. Asegúrese de comprobar y modificar correctamente el fragmento de preocultación para su sitio.

Implementación sincrónica

El Adobe recomienda implementar las etiquetas de forma asíncrona, tal como se muestra en el sitio de Luma. Sin embargo, si la biblioteca de etiquetas se carga sincrónicamente, el fragmento de ocultamiento previo no es necesario. En su lugar, el estilo de ocultamiento previo se especifica en la configuración de la extensión del SDK web de Platform.

El estilo de preocultación para implementaciones sincrónicas se puede configurar de la siguiente manera:

  1. Vaya a la Extensiones sección de etiquetas

  2. Seleccione el Configurar para la extensión del SDK web de Platform

  3. Seleccione el Editar estilo de ocultamiento previo botón

    Fragmento de ocultamiento previo de Target para implementaciones asíncronas

  4. Modifique el CSS para incluir los selectores y los métodos de ocultación que desee utilizar, por ejemplo: body { opacity: 0 !important } si desea ocultar previamente todo el cuerpo de la página.

  5. Guarde los cambios y cree una biblioteca

NOTE
La configuración de estilo de preocultación solo está pensada para utilizarse en implementaciones sincrónicas. Este estilo debe estar en blanco o comentado si utiliza una implementación asíncrona de etiquetas.

Para obtener más información sobre cómo el SDK web de Platform puede administrar el parpadeo, consulte la sección de la guía: administración del parpadeo para experiencias personalizadas.

Configuración de la secuencia de datos

Target debe estar habilitado en la configuración de la secuencia de datos para que el SDK web de Platform pueda entregar cualquier actividad de Target.

Para configurar Target en el conjunto de datos:

  1. Vaya a la Recopilación de datos interfaz

  2. En el panel de navegación izquierdo, seleccione Datastreams

  3. Seleccione el creado anteriormente Luma Web SDK: Development Environment secuencia de datos

    Seleccione la secuencia de datos del SDK web de Luma

  4. Seleccionar Añadir servicio
    Añadir un servicio al conjunto de datos

  5. Seleccionar Adobe Target como el Servicio

  6. Introduzca los detalles opcionales sobre la implementación de Target, si lo desea, siguiendo las directrices que se indican a continuación.

  7. Seleccionar Guardar

    Configuración de flujo de datos de destino

Token de propiedad

Los clientes de Target Premium tienen la opción de administrar permisos de usuario con propiedades. Las propiedades de Target le permiten establecer límites alrededor de donde los usuarios pueden ejecutar actividades de Target. Consulte la Permisos de Enterprise de la documentación de Target para obtener más información.

Para configurar o buscar tokens de propiedad, vaya a Adobe Target > Administration > Propiedades. El </> muestra el código de implementación. El at_property value es el token de propiedad que se utiliza en el conjunto de datos.

Token de propiedad de destino

Solo se puede especificar un token de propiedad por flujo de datos, pero las anulaciones de token de propiedad le permiten especificar tokens de propiedad alternativos para reemplazar el token de propiedad principal definido en el flujo de datos. Una actualización de la sendEvent también es necesaria una acción para anular el conjunto de datos.

Lista de identidad

ID del entorno de destino

Entornos en Target le ayudan a administrar la implementación en todas las etapas de desarrollo. Esta configuración opcional especifica qué entorno de Target va a utilizar con cada conjunto de datos.

El Adobe recomienda configurar el ID de entorno de Target de forma diferente para cada uno de los flujos de datos de desarrollo, ensayo y producción para que las cosas sean sencillas. También puede organizar sus entornos en la interfaz de Target utilizando hosts función.

Para configurar o buscar ID de entorno, vaya a Adobe Target > Administration > Entornos.

Entornos de destino

NOTE
Si no se especifica ningún ID de entorno de destino, se asume el entorno de destino de producción.

Área de nombres de ID de terceros de Target

Esta configuración opcional le permite especificar qué símbolo de identidad utilizar para el ID de terceros de Target. Target solo admite la sincronización de perfiles en un único símbolo de identidad o área de nombres. Para obtener más información, consulte la Sincronización de perfiles en tiempo real para mbox3rdPartyId de la guía de Target.

Los símbolos de identidad se encuentran en la lista de identidades en Recopilación de datos > Cliente > Identidades.

Lista de identidad

Para los fines de este tutorial utilizando el sitio de Luma, utilice el símbolo de identidad lumaCrmId configurado durante la lección acerca de Identidades.

Procesar decisiones de personalización visuales

Las decisiones de personalización visual hacen referencia a las experiencias creadas en el Compositor de experiencias visuales de Adobe Target. En primer lugar, debe comprender la terminología utilizada en las interfaces de Target y de etiquetas:

  • Actividad: un conjunto de experiencias dirigidas a una o más audiencias. Por ejemplo, una prueba A/B simple podría ser una actividad con dos experiencias.
  • Experiencia: conjunto de acciones dirigidas a una o más ubicaciones o ámbitos de decisión.
  • Ámbito de decisión: una ubicación en la que se entrega una experiencia de Target. Los ámbitos de decisión son equivalentes a los "mboxes" si está familiarizado con el uso de versiones anteriores de Target.
  • decisión de Personalization: acción que el servidor determina que debe aplicarse. Estas decisiones pueden basarse en los criterios de audiencia y en la priorización de actividades de Target.
  • Proposición: el resultado de las decisiones tomadas por el servidor, que se entregan en la respuesta del SDK web de Platform. Por ejemplo, intercambiar una imagen de titular sería una propuesta.

Actualice el Enviar evento acción

Las decisiones de personalización visual de Target las entrega el SDK web de Platform, si Target está habilitado en la secuencia de datos. Sin embargo, no se representan automáticamente. Debe actualizar el Enviar evento acción para habilitar el procesamiento automático.

  1. En el Recopilación de datos , abra la propiedad de etiqueta que está utilizando para este tutorial

  2. Abra el all pages - library loaded - send event - 50 regla

  3. Seleccione el Adobe Experience Platform Web SDK - Send event acción

  4. Activar Procesar decisiones de personalización visuales con la casilla de verificación

    Habilitar el procesamiento de decisiones de personalización visual

  5. Guarde los cambios y cree en la biblioteca.

La configuración de decisiones de personalización visual de procesamiento hace que el SDK web de Platform aplique automáticamente cualquier modificación especificada mediante el Compositor de experiencias visuales de Target o "mbox global".

NOTE
Normalmente, la variable Procesar decisiones de personalización visuales La configuración solo debe habilitarse para una única acción Enviar evento por carga de página completa. Si varias acciones Enviar evento tienen esta configuración habilitada, las solicitudes de procesamiento posteriores se omiten.

Si prefiere procesar o actuar sobre estas decisiones por su cuenta utilizando código personalizado, puede dejar el Procesar decisiones de personalización visuales configuración deshabilitada. El SDK web de Platform es flexible y proporciona esta capacidad para ofrecerle un control completo. Puede consultar la guía para obtener más información sobre procesamiento manual del contenido personalizado.

Configurar una actividad de Target con el Compositor de experiencias visuales

Ahora que la parte de implementación básica ha finalizado, cree una actividad de segmentación de experiencias (XT) en Target para comprobar que todo funciona correctamente. Puede consultar el tutorial de Target para creación de actividades de segmentación de experiencias si necesita ayuda.

NOTE
Si utiliza Google Chrome como explorador, la variable Extensión del Compositor de experiencias visuales (VEC) Helper es necesario para cargar el sitio correctamente para editarlo en el VEC.

  1. Vaya a la interfaz de Adobe Target.

  2. Cree una actividad de segmentación de experiencias (XT) usando la página de inicio de Luma para la URL de la actividad

    Crear una nueva actividad XT

  3. Modifique la página, por ejemplo, cambie el texto del banner a pantalla completa de la página de inicio. Cuando termine, seleccione Guardar entonces Siguiente.

    Modificación del VEC de Target

  4. Actualice el nombre del evento y seleccione Siguiente.

    Evento de actualización de VEC de Target

  5. Elija Adobe Analytics como fuente de informes, con el grupo de informes adecuado y la métrica Pedidos como objetivo

    Fuente de informes VEC de Target

    note note
    NOTE
    Si no usa Adobe Analytics, seleccione Target como fuente de informes y elija una métrica diferente como Participación > Vistas de página en su lugar. Se requiere una métrica de objetivo para guardar y previsualizar la actividad.

  6. Guarde la actividad

  7. Si se siente cómodo con los cambios, puede activar su actividad. De lo contrario, si desea previsualizar la experiencia sin activarla, puede copiar el URL de previsualización de QA.

  8. Cargue la página principal de Luma y debería ver los cambios aplicados

  9. Después de unas horas, debería poder ver los datos de actividad de Target y las conversiones en Adobe Analytics. Consulte la Guía de Target para obtener información detallada sobre Creación de informes en Analytics for Target (A4T).

Validación con Debugger

Si configura una actividad de, debería ver el contenido representado en la página. Sin embargo, aunque no haya actividades activas, también puede consultar la llamada de red Enviar evento para confirmar que Target está configurado correctamente.

CAUTION
Si utiliza Google Chrome y tiene el Extensión del Compositor de experiencias visuales (VEC) Helper instalado, asegúrese de que la Inserción de bibliotecas de Target La configuración está deshabilitada. Si habilita esta configuración, se generarán solicitudes de Target adicionales.

  1. Abra la extensión del explorador de Adobe Experience Platform Debugger

  2. Vaya a la Sitio de demostración de Luma y use el depurador para cambie la propiedad de etiquetas del sitio a su propia propiedad de desarrollo

  3. Volver a cargar la página

  4. Seleccione el Red herramienta en Debugger

  5. Filtrar por SDK web de Experience Platform

  6. Seleccione el valor en la fila de eventos para la primera llamada

    Llamada de red en Adobe Experience Platform Debugger

  7. Observe que hay claves debajo de query > personalization y decisionScopes tiene un valor de __view__. Este ámbito es equivalente al de target-global-mbox. Esta llamada del SDK web de Platform solicitó decisiones a Target.

    solicitud decisionScope

  8. Cierre la superposición y seleccione los detalles del evento para la segunda llamada de red. Esta llamada solo está presente si Target devolvió una actividad.

  9. Tenga en cuenta que Target devuelve detalles sobre la actividad y la experiencia. Esta llamada del SDK web de Platform envía una notificación de que se ha procesado una actividad de Target para el usuario e incrementa una impresión.

    Impresión de actividad de Target

Configurar y procesar un ámbito de decisión personalizado

Los ámbitos de decisión personalizados (anteriormente conocidos como "mboxes") se pueden utilizar para entregar contenido de HTML o JSON de forma estructurada mediante el Compositor de experiencias basadas en formularios de Target. El SDK web de Platform no procesa automáticamente el contenido entregado a uno de estos ámbitos personalizados. Se puede procesar con una acción en Etiquetas.

Agregue un ámbito al Acción Enviar evento

Modifique la regla de carga de página para agregar un ámbito de decisión personalizado:

  1. Abra el all pages - library loaded - send event - 50 regla

  2. Seleccione el Adobe Experience Platform Web SDK - Send Event acción

  3. Agregue uno o varios ámbitos que desee utilizar. Para este ejemplo, utilice homepage-hero.

    Ámbito personalizado

  4. Guarde los cambios y cree en la biblioteca.

TIP
Para este tutorial, utilizará un único ámbito definido manualmente para fines de demostración. Si decide utilizar varios ámbitos de decisión destinados a páginas específicas, debe considerar la posibilidad de utilizar un elemento de datos que devuelva una matriz de ámbitos condicionalmente en función de la ruta de página. Este método ayuda a que la implementación sea sencilla y escalable.

Procesar la respuesta de Target

Ahora que ha configurado el SDK web de Platform para solicitar contenido para homepage-hero ámbito, debe hacer algo con la respuesta. La extensión de etiqueta del SDK web de Platform proporciona un Enviar evento completado evento, que se puede utilizar para almacenar en déclencheur inmediatamente una nueva regla cuando una respuesta de un Enviar evento acción recibida.

  1. Cree una regla llamada homepage - send event complete - render homepage-hero.

  2. Añada un evento a la regla. Utilice el SDK web de Adobe Experience Platform y la extensión de Enviar evento completado tipo de evento.

  3. Añada una condición para restringir la regla a la página principal de Luma (la ruta sin cadena de consulta es igual a /content/luma/us/en.html).

  4. Añada una acción a la regla. Utilice el SDK web de Adobe Experience Platform extensión y Aplicar propuestas tipo de acción.

    Procesar regla a pantalla completa de página principal

    note tip
    TIP
    Asigne nombres descriptivos a los eventos, las condiciones y las acciones de la regla en lugar de utilizar los nombres predeterminados. Los nombres sólidos de los componentes de regla hacen que los resultados de búsqueda sean mucho más útiles.

  5. Entrar %event.propositions% en el campo Propuestas, ya que utilizamos el evento "Enviar evento completado" como déclencheur para esta regla.

  6. En la sección "metadatos de propuesta", seleccione la Uso de un formulario

  7. Para el Ámbito entrada de campo homepage-hero

  8. Para el Selector entrada de campo div.heroimage

  9. Para Tipo de acción select Establecer HTML

  10. Seleccionar Conservar cambios

    Procesar acción de héroe de página principal

    Además de procesar la actividad, debe realizar una llamada adicional a Target para indicar que se ha procesado la actividad basada en Forms:

  11. Añada otra acción a la regla. Utilice el Núcleo y la extensión de Custom Code tipo de acción:

  12. Pegue el siguiente código JavaScript:

    code language-javascript 
    var propositions = event.propositions;
var heroProposition;
if (propositions) {
   // Find the hero proposition, if it exists.
   for (var i = 0; i < propositions.length; i++) {
      var proposition = propositions[i];
      if (proposition.scope === "homepage-hero") {
         heroProposition = proposition;
         break;
      }xw
   }
}
// Send a "display" event
if (heroProposition !== undefined){
   alloy("sendEvent", {
      xdm: {
         eventType: "display",
         _experience: {
            decisioning: {
               propositions: [{
                  id: heroProposition.id,
                  scope: heroProposition.scope,
                  scopeDetails: heroProposition.scopeDetails
               }]
            }
         }
      }
   });
}

    Procesar acción de héroe de página principal

  13. Seleccionar Conservar cambios

  14. Guarde los cambios y cree en la biblioteca.

  15. Cargue la página principal de Luma varias veces, lo que debería ser suficiente para crear la nueva homepage-hero registro del ámbito de decisión en la interfaz de Target.

Configurar una actividad de Target con el Compositor de experiencias basadas en formularios

Ahora que tiene una regla para procesar manualmente un ámbito de decisión personalizado, puede crear otra actividad de segmentación de experiencias (XT) en Target. Esta vez use el Compositor de experiencias basadas en formularios.

  1. Abrir Adobe Target

  2. Desactivar la actividad utilizada en la lección anterior

  3. Cree una actividad de segmentación de experiencias (XT) con la opción del Compositor de experiencias basadas en formularios

    Crear una nueva actividad XT

  4. Seleccione el homepage-hero ubicación desde el menú desplegable de ubicación y Crear oferta de HTML en la lista desplegable de contenido. Si la ubicación no está disponible, puede escribirla. Target rellena periódicamente nuevos nombres de ubicación después de recibir solicitudes para esa ubicación o ámbito.

    Crear una nueva actividad XT

  5. Pegue el siguiente código en el cuadro de contenido. Este código es un banner básico a pantalla completa con una imagen de fondo diferente:

    code language-html 
    <div class="we-HeroImage jumbotron" style="background-image: url('/content/luma/us/en/women/_jcr_content/root/hero_image.coreimg.jpeg');">
   <div class="container cq-dd-image">
      <div class="we-HeroImage-wrapper">
         <p class="h3">New Luma Yoga Collection</p>
         <strong class="we-HeroImage-title h1">Be active with style&nbsp;</strong>
         <p>
            <a class="btn btn-primary btn-action" href="/content/luma/us/en/products.html" role="button">Shop Now</a>
         </p>
      </div>
   </div>
</div>

  6. En el Objetivos y configuración , elija Adobe Target como fuente de informes y Participación > Vistas de página como objetivo

  7. Guarde la actividad

  8. Si se siente cómodo con los cambios, puede activar su actividad. De lo contrario, si desea previsualizar la experiencia sin activarla, puede copiar el URL de previsualización de QA.

  9. Cargue la página principal de Luma y debería ver los cambios aplicados

NOTE
El objetivo de conversión "Se hizo clic en mbox" no funciona automáticamente. Dado que el SDK web de Platform no procesa automáticamente ámbitos personalizados, no realiza el seguimiento de los clics a las ubicaciones que elija para aplicar el contenido. Puede crear su propio rastreo de clics para cada ámbito utilizando el icono de "clic" eventType con el aplicable _experience detalles con la variable sendEvent acción.

Validación con Debugger

Si ha activado su actividad, debería ver el procesamiento de contenido en la página. Sin embargo, aunque no haya actividades activas, también puede consultar la Enviar evento llamada de red para confirmar que Target está solicitando contenido para los ámbitos personalizados.

  1. Abra la extensión del explorador de Adobe Experience Platform Debugger.

  2. Vaya a la Sitio de demostración de Luma y use el depurador para cambie la propiedad de etiquetas del sitio a su propia propiedad de desarrollo

  3. Volver a cargar la página

  4. Seleccione el Red en Debugger.

  5. Filtrar por SDK web de Adobe Experience Platform

  6. Seleccione el valor en la fila de eventos para la primera llamada

    Llamada de red en Adobe Experience Platform Debugger

  7. Observe que hay claves debajo de query > personalization y decisionScopes tiene un valor de __view__ como antes, pero ahora también hay un homepage-hero ámbito incluido. Esta llamada del SDK web de Platform solicitaba decisiones de Target para los cambios realizados con el VEC y el específico homepage-hero ubicación.

    solicitud decisionScope

  8. Cierre la superposición y seleccione los detalles del evento para la segunda llamada de red. Esta llamada solo está presente si Target devolvió una actividad.

  9. Tenga en cuenta que Target devuelve detalles sobre la actividad y la experiencia. Esta llamada del SDK web de Platform envía una notificación de que se ha procesado una actividad de Target para el usuario e incrementa una impresión. Se inició con la acción de Custom Code agregada anteriormente.

    Impresión de actividad de Target

Envío de parámetros a Target

En esta sección, se pasarán datos específicos de Target y se examinará más de cerca cómo se asignan los datos XDM a los parámetros de Target.

Parámetros de página (mbox) y XDM

Todos los campos XDM se pasan automáticamente a Target como parámetros de página o parámetros de mbox.

Algunos de estos campos XDM se asignarán a objetos especiales en el backend de Target. Por ejemplo, web.webPageDetails.URL estará disponible automáticamente para crear condiciones de segmentación basadas en URL o como page.url al crear scripts de perfil.

También puede agregar parámetros de página mediante el objeto de datos.

Parámetros especiales y el objeto de datos

Existen algunos puntos de datos que pueden ser útiles para Target que no están asignados desde el objeto XDM. Estos parámetros especiales de Target incluyen:

Estos parámetros deben enviarse en la variable data en lugar de en el xdm objeto. Además, los parámetros de página (o mbox) también se pueden incluir en data objeto.

Para rellenar el objeto de datos, cree el siguiente elemento de datos y reutilice los elementos de datos creados en la variable Creación de elementos de datos lección:

  • data.content mediante el siguiente código personalizado:

    code language-javascript 
    var data = {
   __adobe: {
      target: {
         "entity.id": _satellite.getVar("product.productInfo.sku"),
         "entity.name": _satellite.getVar("product.productInfo.title"),
         "profile.loggedIn": _satellite.getVar("user.profile.attributes.loggedIn"),
         "user.categoryId": _satellite.getVar("product.category")
      }
   }
}
return data;

Actualizar la regla de carga de página

Para pasar datos adicionales para Target fuera del objeto XDM, es necesario actualizar las reglas aplicables. Para este ejemplo, la única modificación que debe realizar es incluir el nuevo data.content elemento de datos a la regla de carga de página genérica y a la regla de vista de página de producto.

  1. Abra el all pages - library loaded - send event - 50 regla

  2. Seleccione el Adobe Experience Platform Web SDK - Send event acción

  3. Añada el data.content al campo Datos.

    Añadir datos de destino a la regla

  4. Guarde los cambios y cree en la biblioteca.

NOTE
El ejemplo anterior utiliza un data objeto que no se rellena completamente en todos los tipos de página. Las etiquetas gestionan correctamente esta situación y omiten las claves que tienen un valor indefinido. Por ejemplo, entity.id y entity.name no se pasaría en ninguna página aparte de los detalles del producto.

División de solicitudes de Personalization y Analytics

La capa de datos del sitio de Luma está completamente definida antes del código incrustado de etiquetas. Esto nos permite utilizar una sola llamada para recuperar contenido personalizado (por ejemplo, de Adobe Target) y enviar datos de análisis (por ejemplo, a Adobe Analytics).

Sin embargo, en muchos sitios web, la capa de datos no se puede cargar con la suficiente antelación o rapidez como para utilizar una sola llamada para ambas aplicaciones. En estas situaciones, puede utilizar dos Enviar evento las acciones de una sola página se cargan y utilizan la primera para la personalización y la segunda para analytics. Dividir los eventos de esta manera permite que el evento de personalización se active lo antes posible, mientras se espera a que la capa de datos se cargue completamente antes de enviar el evento de Analytics. Esto es similar a muchas implementaciones de SDK previas a la web, en las que Adobe Target activaba el target-global-mbox en la parte superior de la página y Adobe Analytics activaría el s.t() llamada de al final de la página

Para crear la solicitud de personalización en la parte superior:

  1. Abra el all pages - library loaded - send event - 50 regla

  2. Abra el Enviar evento acción

  3. Seleccionar Uso de eventos guiados y luego seleccione Solicitar personalización

  4. Esto bloquea el Tipo as Recuperación de propuesta de decisión

    send_decision_request_alone

Para crear la solicitud de análisis en la parte inferior:

  1. Cree una nueva regla llamada all pages - page bottom - send event - 50
  2. Añada un evento a la regla. Utilice el Núcleo y la extensión de Page Bottom tipo de evento
  3. Añada una acción a la regla. Utilice el SDK web de Adobe Experience Platform extensión y Enviar evento tipo de acción
  4. Seleccionar Uso de eventos guiados y luego seleccione Recopilar análisis
  5. Esto bloquea el Incluir notificaciones de visualización pendientes casilla de verificación seleccionada para que se envíe la notificación de visualización en cola de la solicitud de toma de decisiones.

send_decision_request_alone

TIP
Si el evento para el que está recuperando una propuesta de toma de decisiones no tiene un evento Adobe Analytics posterior, utilice el Estilo de evento guiado Sin guía: mostrar todos los campos. Tendrá que seleccionar todas las opciones manualmente, pero la opción se desbloquea para enviar automáticamente una notificación de visualización junto con su solicitud de captura.

Validación con Debugger

Ahora que las reglas se han actualizado, puede validar si los datos se pasan correctamente con el Adobe Debugger.

  1. Vaya a Sitio de demostración de Luma e inicie sesión con el correo electrónico test@adobe.com y contraseña test

  2. Navegar a una página de detalles del producto

  3. Abra la extensión del explorador Adobe Experience Platform Debugger y. cambie la propiedad de etiquetas a su propia propiedad de desarrollo

  4. Volver a cargar la página

  5. Seleccione el Red en Debugger y filtrar por SDK web de Adobe Experience Platform

  6. Seleccione el valor en la fila de eventos para la primera llamada

  7. Observe que hay claves debajo de data > __adobe > target y se rellenan con información sobre el producto, la categoría y el estado de inicio de sesión.

    solicitud decisionScope

Validación en la interfaz de Target

A continuación, consulte la interfaz de Target para confirmar que los datos se han recibido y que están disponibles para su uso en audiencias y actividades. Los datos XDM se asignan automáticamente a parámetros de Target personalizados. Puede validar que Target ha recibido los datos XDM y que están disponibles creando una audiencia.

  1. Abrir Adobe Target

  2. Vaya a Audiencias sección

  3. Cree una audiencia y elija la Personalizado tipo de atributo

  4. Busque en Parámetro campo para web. El menú desplegable debe rellenarse con todos los campos XDM relacionados con los detalles de la página web.

    Validar en el atributo personalizado de Target

A continuación, compruebe que el atributo de perfil del estado de inicio de sesión se haya pasado correctamente.

  1. Elija la Perfil del visitante tipo de atributo

  2. Buscar por loggedIn. Si el atributo está disponible en el menú desplegable, se pasó correctamente a Target. Los nuevos atributos pueden tardar varios minutos en estar disponibles en la IU de Target.

    Validar en el perfil de Target

Si tiene Target Premium, también puede validar que los datos de entidad se hayan pasado correctamente y que los datos de producto se hayan escrito en el catálogo de productos de Recommendations.

  1. Vaya a Recommendations sección

  2. Seleccionar Búsqueda en catálogo en el panel de navegación del lado izquierdo

  3. Busque el SKU o el nombre del producto que visitó anteriormente en el sitio de Luma. El producto debe aparecer en el catálogo de productos. Los nuevos productos pueden tardar varios minutos en buscarse en el catálogo de productos de Recommendations.

    Validar en la búsqueda del catálogo de Target

Validar con Assurance

Además, puede utilizar Assurance cuando corresponda para confirmar que las solicitudes de Target Decisioning obtienen los datos correctos y que las transformaciones del lado del servidor se producen correctamente. También puede confirmar que la información de campaña y experiencia está contenida en las llamadas de Adobe Analytics incluso cuando las llamadas de Target Decisioning y Adobe Analytics se envían por separado.

  1. Abrir Assurance

  2. Inicie una nueva sesión de garantía e introduzca el nombre de sesión e introduzca el url base para su sitio o cualquier otra página que esté probando

  3. Clic Siguiente

    Validar en la nueva sesión de Assurance

  4. Seleccione el método de conexión, en este caso utilizaremos copiar vínculo

  5. Copie el vínculo y péguelo en una nueva pestaña del explorador

  6. Clic Listo

    Validar en el vínculo de conexión de assurance mediante copia

  7. Una vez que se inicie la sesión de Assurance, verá eventos que se rellenan en la pestaña de eventos

  8. Filtrar por "tnta"

  9. Seleccione la llamada más reciente y expanda los mensajes para asegurarse de que se rellenan correctamente y anote los valores "tnta"

    Validar en una visita de Target de garantía

  10. A continuación, mantenga el filtro "tnta" y seleccione el evento analytics.mapping que se produce después del evento de destino que acabamos de ver.

  11. Examine la variable "context.assignedQueryParams".&lt;yourschemaname>" para confirmar que contiene un atributo "tnta" con una cadena concatenada que coincide con los valores "tnta" encontrados en el evento de destino anterior.

    Validar en la visita de assurance Analytics

Esto confirma que la información de A4T que se puso en cola para su posterior transmisión cuando realizamos la llamada de toma de decisiones de Target se envió correctamente cuando la llamada de seguimiento de Analytics se activó más adelante en la página.

Ahora que ha completado esta lección, debe tener una implementación en funcionamiento de Adobe Target mediante el SDK web de Platform.

Siguiente:

NOTE
Gracias por dedicar su tiempo a conocer el SDK web de Adobe Experience Platform. Si tiene preguntas, desea compartir comentarios generales o tiene sugerencias sobre contenido futuro, compártalas en este Entrada de discusión de la comunidad Experience League
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4