Uso Adobe Target con la variable Platform Web SDK

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

IMPORTANTE

La variable Documentación de Adobe Target incluye temas que contienen información específica del SDK web de plataforma en relación con las funciones y funcionalidades de Target.

Se han probado las siguientes funciones, que actualmente son compatibles con Target:

Platform Web SDK diagrama del sistema

El diagrama siguiente le ayuda a comprender el flujo de trabajo de Target y Platform Web SDK decisión de borde.

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

La llamada Detalles
1 El dispositivo carga la variable Platform Web SDK. La variable Platform Web SDK envía una solicitud a la red perimetral con datos XDM, el ID de entorno de Datastreams, los parámetros transferidos y el ID de cliente (opcional). La página (o los contenedores) está oculta previamente.
2 La red perimetral 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 La red perimetral envía la solicitud de personalización enriquecida al Target borde con el ID de visitante y parámetros transferidos.
4 Los scripts de perfil se ejecutan y luego se incluyen en Target almacenamiento de perfiles. El almacenamiento de perfiles obtiene segmentos del Biblioteca de audiencias (por ejemplo, segmentos compartidos desde Adobe Analytics, Adobe Audience Manager, el 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 mostrar para el visitante en la vista de página actual y para futuras vistas de recuperación previa. Target a continuación, lo devuelve a la red perimetral.
6 a. La red perimetral envía 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. El contenido personalizado para las vistas que se muestran como resultado de las acciones del usuario en una aplicación de una sola página (SPA) se almacena en caché para que se pueda aplicar instantáneamente sin una llamada al servidor adicional cuando se activan las vistas.
c. La red perimetral envía el ID de visitante y otros valores en cookies, como consentimiento, ID de sesión, identidad, comprobación de cookies, personalización, etc.
7 La red perimetral reenvía Analytics para Target Detalles (de actividad, experiencia y metadatos de conversión) de (A4T) Analytics borde.

Habilitación Adobe Target

Para habilitar Target, haga lo siguiente:

  1. Habilitar Target en su datastream con el código de cliente apropiado.
  2. Agregue la variable renderDecisions a sus eventos.

A continuación, opcionalmente, también puede añadir las siguientes opciones:

  • decisionScopes: Recupere actividades específicas (útil para actividades creadas con el compositor basado en formularios) añadiendo esta opción a los eventos.
  • Preocultación de fragmento: Oculte solo ciertas partes de la página.

Uso del VEC de Adobe Target

Para usar el VEC con un Platform Web SDK implementación, instale y active Firefox o Chrome Extensión de VEC Helper.

Para obtener más información, consulte Extensión del Helper del Compositor de experiencias visuales en el Guía de Adobe Target.

Representación de contenido personalizado

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

Audiencias en XDM

Al definir audiencias para su Target actividades que se entregan mediante la variable Platform Web SDK, XDM debe definirse y utilizarse. Después de definir esquemas XDM, clases y grupos de campos de esquema, puede crear una Target regla de audiencia definida por los datos XDM para la segmentación. Within Target, los datos XDM se muestran en la variable Audience Builder como parámetro personalizado. El XDM se serializa mediante notación de puntos (por ejemplo, web.webPageDetails.name).

Si tiene Target Las actividades con audiencias predefinidas que utilizan parámetros personalizados o un perfil de usuario no se envían correctamente a través del SDK. En lugar de usar parámetros personalizados o el perfil de usuario, debe utilizar XDM en su lugar. Sin embargo, hay campos de segmentación de audiencia integrados que se admiten mediante la variable Platform Web SDK que no requieren XDM. Estos campos están disponibles en la Target IU que no requieren XDM:

  • Biblioteca de segmentos
  • Geografía
  • Red
  • Operating System
  • Páginas del sitio
  • Explorador
  • Fuentes de tráfico
  • Lapso de tiempo

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

Tokens de respuesta

Los tokens de respuesta se utilizan principalmente para enviar metadatos a terceros como Google, Facebook, etc. Los tokens de respuesta se devuelven en la variable 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 alloy.sendEvent promesa, iterar hasta propositions
y extraiga los detalles de items -> meta. Cada proposition tiene un renderAttempted campo booleano que indica si la variable proposition se ha procesado 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 el procesamiento automático está habilitado, la matriz de propuestas contiene:

Al cargar la página:

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

On View - change (para vistas en caché):

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

Cuando se deshabilita el procesamiento automático, la matriz de propuestas contiene:

Al cargar la página:

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

On View - change (para vistas en caché):

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

Actualización de perfil único

La variable Platform Web SDK permite actualizar el perfil al Target y al Platform Web SDK como evento de experiencia.

Para actualizar un Target , asegúrese de que los datos de perfil se pasen de la siguiente manera:

  • En “data {“
  • En “__adobe.target”
  • Prefijo “profile.” por ejemplo, como se muestra a continuación
Clave Tipo Descripción
renderDecisions Booleano Indica al componente de personalización si debe interpretar las acciones DOM
decisionScopes Matriz <String> Una lista de ámbitos para recuperar decisiones
xdm Objeto Datos formateados en XDM que llegan al SDK web de plataforma como evento de experiencia
data Objeto Pares de clave/valor arbitrarios enviados a Target soluciones en la clase target.

Típico Platform Web SDK el código que utiliza este comando tiene el siguiente aspecto:

sendEventcon datos de perfil

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

Envío de atributos de perfil a Adobe Target:

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

Solicitar recomendaciones

Las siguientes listas de tabla Recommendations y si cada uno es compatible mediante la variable Platform Web SDK:

Categoría Atributo Estado de asistencia
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
Página o categoría de elemento para la afinidad de la categoría user.categoryId Admitido

Envío de atributos de Recommendations a Adobe Target:

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

Depuración

mboxTrace y mboxDebug ya no se utilizan. Uso Platform Web SDK depuración.

Terminología

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

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

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

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

En esta página