Usar Adobe Target y Web SDK para personalización

Adobe Experience Platform Web SDK puede entregar y procesar experiencias personalizadas administradas en Adobe Target al canal web. Puede usar un editor WYSIWYG, llamado Compositor de experiencias visuales (VEC), o una interfaz no visual, Compositor de experiencias basadas en formularios, para crear, activar y entregar sus actividades y experiencias de personalización.

IMPORTANT
Obtenga información sobre cómo migrar su implementación de Target al SDK web de Platform con el tutorial Migrar Target de at.js 2.x al SDK web de Platform.
Aprenda a implementar Target por primera vez con el tutorial Implementar Adobe Experience Cloud con SDK web. Para obtener información específica de Target, consulte la sección del tutorial titulada Configurar Target con el SDK web de Platform.

Las siguientes características se han probado y actualmente son compatibles con Target:

Diagrama del sistema Web SDK

El diagrama siguiente le ayuda a comprender el flujo de trabajo de Target y Web SDK Edge Decisioning.

Diagrama de la toma de decisiones perimetral de Adobe Target con el SDK web de Platform

Llamada
Detalles
1
El dispositivo carga Web SDK. Web SDK envía una solicitud al Edge Network con datos XDM, el ID de entorno de flujos de datos, los parámetros pasados y el ID de cliente (opcional). La página (o los contenedores) está oculta previamente.
2
El Edge Network envía la solicitud a los servicios Edge para enriquecerla con el ID del visitante, el consentimiento y otra información de contexto del visitante, como la geolocalización y los nombres descriptivos del dispositivo.
3
El Edge Network envía la solicitud de personalización enriquecida al perímetro de Target con el ID de visitante y los parámetros proporcionados.
4
Se ejecutan los scripts de perfil y se incluyen en el almacenamiento de perfiles Target. El almacenamiento de perfiles recupera segmentos de la biblioteca de audiencias (por ejemplo, segmentos compartidos de Adobe Analytics, Adobe Audience Manager, Adobe Experience Platform).
5
En función de los parámetros de solicitud de URL y los datos de perfil, Target determina qué actividades y experiencias se mostrarán al visitante en la vista de página actual y en futuras vistas previamente recuperadas. Target devuelve esto al Edge Network.
6
a. El Edge Network devuelve la respuesta de personalización a la página, incluyendo, de forma opcional, los valores de perfil para una personalización adicional. El contenido personalizado de la página actual se muestra lo más rápido posible y sin parpadeo del contenido predeterminado.
b. SPA El contenido personalizado para vistas que se muestran como resultado de acciones del usuario en una aplicación de una sola página () se almacena en caché para que se pueda aplicar instantáneamente sin una llamada al servidor adicional cuando se activan las vistas.
c. El Edge Network envía el ID de visitante y otros valores en cookies, como el consentimiento, el ID de sesión, la identidad, la comprobación de cookies y la personalización.
7
El SDK web envía la notificación del dispositivo al Edge Network.
8
El Edge Network reenvía detalles de Analytics for Target (A4T) (metadatos de actividad, experiencia y conversión) al perímetro de Analytics.

Habilitando Adobe Target

Para habilitar Target, haga lo siguiente:

  1. Habilite Target en su secuencia de datos con el código de cliente apropiado.
  2. Agregue la opción renderDecisions a los eventos.

A continuación, de forma opcional, también puede añadir las siguientes opciones:

  • decisionScopes: recupere actividades específicas (útiles para las actividades creadas con el compositor basado en formularios) agregando esta opción a los eventos.
  • Fragmento preocultado: oculta solo ciertas partes de la página.

Uso del VEC de Adobe Target

Para usar el VEC con una implementación de Web SDK, instale y active la extensión Firefox o la extensión Chrome VEC Helper.

Para obtener más información, consulte la extensión de ayuda del Compositor de experiencias visuales en la guía de Adobe Target.

Representación de contenido personalizado

Consulte Procesamiento de contenido personalizado para obtener más información.

Audiencias en XDM

Al definir audiencias para las actividades Target que se entregan mediante Web SDK, se debe definir y utilizar XDM. Después de definir esquemas XDM, clases y grupos de campos de esquema, puede crear una regla de audiencia Target definida por datos XDM para el direccionamiento. En Target, los datos XDM se muestran en Generador de audiencias como un parámetro personalizado. El XDM se serializa usando notación de puntos (por ejemplo, web.webPageDetails.name).

Si tiene Target actividades con audiencias predefinidas que utilizan parámetros personalizados o un perfil de usuario, estos no se entregan correctamente a través del SDK. En lugar de utilizar parámetros personalizados o el perfil de usuario, debe utilizar XDM. Sin embargo, hay campos de segmentación de audiencia predeterminados admitidos a través de Web SDK que no requieren XDM. Estos campos están disponibles en la interfaz de usuario de Target que no requieren XDM:

  • Biblioteca de objetivos
  • Geo
  • Red
  • Sistema operativo
  • Páginas del sitio
  • Explorador
  • Fuentes de tráfico
  • Lapso de tiempo

Para obtener más información, consulte Categorías para audiencias en la guía de Adobe Target.

Tokens de respuesta

Los tokens de respuesta se utilizan para enviar metadatos a terceros, como Google o Facebook. Se devuelven tokens de respuesta
en el campo meta dentro de propositions -> items. Este es un ejemplo:

{
  "id": "AT:eyJhY3Rpdml0eUlkIjoiMTI2NzM2IiwiZXhwZXJpZW5jZUlkIjoiMCJ9",
  "scope": "__view__",
  "scopeDetails": ...,
  "renderAttempted": true,
  "items": [
    {
      "id": "0",
      "schema": "https://ns.adobe.com/personalization/dom-action",
      "meta": {
        "experience.id": "0",
        "activity.id": "126736",
        "offer.name": "Default Content",
        "offer.id": "0"
      }
    }
  ]
}

Para recopilar los tokens de respuesta, debe suscribirse a la promesa alloy.sendEvent, iterar a través de propositions y extraer los detalles de items -> meta.

Cada proposition tiene un campo booleano renderAttempted que indica si proposition se representó o no. Consulte el siguiente ejemplo:

alloy("sendEvent",
  {
    "renderDecisions": true,
    "decisionScopes": [
      "hero-container"
    ]
  }).then(result => {
    const { propositions } = result;

    // filter rendered propositions
    const renderedPropositions = propositions.filter(proposition => proposition.renderAttempted === true);

    // collect the item metadata that represents the response tokens
    const collectMetaData = (items) => {
      return items.filter(item => item.meta !== undefined).map(item => item.meta);
    }

    const pageLoadResponseTokens = renderedPropositions
      .map(proposition => collectMetaData(proposition.items))
      .filter(e => e.length > 0)
      .flatMap(e => e);
  });

Cuando se habilita la representación automática, la matriz de propuestas contiene:

Al cargar la página:

  • Basado en el compositor basado en formularios propositions con el indicador renderAttempted establecido en false
  • Propuestas basadas en el Compositor de experiencias visuales con el indicador renderAttempted establecido en true
  • Propuestas basadas en el Compositor de experiencias visuales para una vista de aplicación de una sola página con el indicador renderAttempted establecido en true

Al ver - cambiar (para vistas en caché):

  • Propuestas basadas en el Compositor de experiencias visuales para una vista de aplicación de una sola página con el indicador renderAttempted establecido en true

Cuando la representación automática está desactivada, la matriz de propuestas contiene:

Al cargar la página:

  • propositions basado en Form-based Composer con el marcador renderAttempted establecido en false
  • Propuestas basadas en Visual Experience Composer con el indicador renderAttempted establecido en false
  • Propuestas basadas en Visual Experience Composer para una vista de aplicación de una sola página con el indicador renderAttempted establecido en false

Al ver - cambiar (para vistas en caché):

  • Propuestas basadas en el Compositor de experiencias visuales para una vista de aplicación de una sola página con el indicador renderAttempted establecido en false

Actualización de perfil único

El Web SDK le permite actualizar el perfil al perfil Target y al Web SDK como un evento de experiencia.

Para actualizar un perfil Target, asegúrese de que los datos del perfil se pasen con lo siguiente:

  • En "data {"
  • En "__adobe.target"
  • Prefijo "profile."
Clave
Tipo
Descripción
renderDecisions
Booleano
Indica al componente de personalización si debe interpretar las acciones del DOM
decisionScopes
Matriz <String>
Una lista de ámbitos para los que recuperar decisiones
xdm
Objeto
Datos con formato XDM que aterrizan en el SDK web como un evento de experiencia
data
Objeto
Pares arbitrarios de clave/valor enviados a Target soluciones bajo la clase de destino.

Retraso al guardar los parámetros de perfil o entidad hasta que se muestre el contenido al usuario final

Para retrasar el registro de atributos en el perfil hasta que se muestre el contenido, establezca data.adobe.target._save=false en su solicitud.

Por ejemplo: su sitio web contiene tres ámbitos de decisión que corresponden a tres vínculos de categoría en el sitio web (hombres, mujeres y niños) y desea rastrear la categoría que visitó finalmente el usuario. Envíe estas solicitudes con el indicador __save establecido en false para evitar que se mantenga la categoría en el momento en que se solicita el contenido. Una vez visualizado el contenido, envíe la carga útil adecuada (incluidos eventToken y stateToken) para que se registren los atributos correspondientes.

El ejemplo siguiente envía un mensaje de estilo trackEvent, ejecuta scripts de perfil, guarda atributos y registra inmediatamente el evento.

alloy ( "sendEvent" , {
  renderDecisions : true,
  data : {
    __adobe : {
      target : {
        "profile.gender" : "female",
        "profile.age" : 30,
        "entity.name" : "T-shirt" ,
        "entity.id" : "1234" ,
        "track": {
          "scopes": [ "mbox1", "mbox2"],
          "type": "display|click|..."
        }
      }
    }
  }
} ) ;
NOTE
Si se omite la directiva __save, el guardado de los atributos de perfil y entidad se produce inmediatamente, como si la solicitud se hubiera ejecutado, incluso si el resto de la solicitud es una recuperación previa de personalización. La directiva __save solo es relevante para los atributos de perfil y entidad. Si el objeto track está presente, se omite la directiva __save. Los datos se guardan inmediatamente y se registra la notificación.

sendEventcon datos de perfil

alloy("sendEvent", {
   renderDecisions: true|false,
   xdm: { // Experience Event XDM data },
   data: { // Freeform data }
});

Cómo enviar atributos de perfil a Adobe Target:

alloy("sendEvent", {
  "renderDecisions": true,
  "data": {
    "__adobe": {
      "target": {
        "profile.gender": "female",
        "profile.age": 30
      }
    }
  }
});

Solicitar recomendaciones

La tabla siguiente enumera Recommendations atributos y si cada uno de ellos es compatible a través de Web SDK:

Categoría
Atributo
Estado de soporte
Recommendations: atributos de entidad predeterminados
entity.id
Admitido
entity.name
Admitido
entity.categoryId
Admitido
entity.pageUrl
Admitido
entity.thumbnailUrl
Admitido
entity.message
Admitido
entity.value
Admitido
entity.inventory
Admitido
entity.brand
Admitido
entity.margin
Admitido
entity.event.detailsOnly
Admitido
Recommendations: atributos de entidad personalizados
entity.yourCustomAttributeName
Admitido
Recommendations: parámetros de mbox/página reservados
excludedIds
Admitido
cartIds
Admitido
productPurchasedId
Admitido
Categoría de página o elemento para la afinidad de la categoría
user.categoryId
Admitido

Cómo enviar atributos de Recommendations a Adobe Target:

alloy("sendEvent", {
  "renderDecisions": true,
  "data": {
    "__adobe": {
      "target": {
        "entity.id": "123",
        "entity.genre": "Drama"
      }
    }
  }
});

Depuración

mboxTrace y mboxDebug han quedado obsoletos. En su lugar, use un método de depuración del SDK web.

Terminología

Propuestas: En Adobe Target, las propuestas se correlacionan con la experiencia seleccionada de una actividad.

Esquema: El esquema de una decisión es el tipo de oferta de Adobe Target.

Ámbito: Ámbito de la decisión. En Adobe Target, el ámbito es mBox. El mBox global es el ámbito __view__.

XDM: El XDM se serializa en notación de puntos y luego se coloca en Adobe Target como parámetros mBox.

recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636