Uso de Adobe Target con el Platform Web SDK

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

Las siguientes funciones se han probado y actualmente son compatibles con Target:

• Pruebas A/B
• Creación de informes de conversión e impresión de A4T
• Actividades de Automated Personalization
• Actividades de segmentación de experiencias
• Pruebas multivariable (MVT)
• Actividades de Recommendations
• Informes de impresión y conversión de Target nativo
• Compatibilidad con VEC

Platform Web SDK diagrama del sistema

El diagrama siguiente le ayuda a comprender el flujo de trabajo de las decisiones de borde Target y Platform Web SDK.

Habilitación de Adobe Target

Para habilitar Target, haga lo siguiente:

1. Habilite Target en su conjunto de datos con el código de cliente apropiado.
2. Agregue la opción renderDecisions a los 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.
• Ocultamiento previo del fragmento: Oculte solo ciertas partes de la página.

Uso del VEC de Adobe Target

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

Para obtener más información, consulte Visual Experience Composer Helper extension en la Guía de Adobe Target.

Representación de contenido personalizado

Consulte Rendering personalization content para obtener más información.

Audiencias en XDM

Al definir audiencias para las actividades Target que se entregan mediante Platform Web SDK, XDM debe definirse y utilizarse. Después de definir esquemas XDM, clases y grupos de campos de esquema, puede crear una regla de audiencia Target definida por los datos XDM para la segmentación. Dentro de Target, los datos XDM se muestran en el Audience Builder como un parámetro personalizado. El XDM se serializa mediante 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, no se entregan correctamente mediante el SDK. En lugar de usar parámetros personalizados o el perfil de usuario, debe utilizar XDM en su lugar. Sin embargo, hay campos de objetivo de audiencia integrados compatibles con el Platform Web SDK que no requieren XDM. Estos campos están disponibles en la interfaz de usuario Target 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 la Guía de Adobe Target.

Tokens de respuesta

Los tokens de respuesta se utilizan principalmente para enviar metadatos a terceros como Google, Facebook, etc. 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 extraiga los detalles de items -> meta. Cada proposition tiene un campo booleano renderAttempted
indicando si el 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 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

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 el indicador renderAttempted 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 indicador renderAttempted establecido en false
• Propuestas basadas en el Compositor de experiencias visuales con el indicador renderAttempted establecido en false
• 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

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 el indicador renderAttempted establecido en false

Actualización de perfil único

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

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

• En “data {“
• En “__adobe.target”
• Prefijo “profile.”, por ejemplo, como se muestra a continuación

El código Platform Web SDK típico 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

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

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. Utilice 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 de aplicación: el ámbito de aplicación de la decisión. En Target, el ámbito es el mBox. El mBox global es el ámbito __view__.

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