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.

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.

Habilitando Adobe Target

Para habilitar Target, haga lo siguiente:

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

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:

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:

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

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

Al cargar la página:

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

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:

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": {
        "xdm": { // Experience Event XDM data },
            "__adobe": {
                "target": {
                    " __save": true|false,
                    //defaults to true if omitted
                    "profile.gender": "female",
                    "profile.age": 30,
                    "entity.name": "T-shirt",
                    "entity.id": "1234"
                }
            }
        }
    }
})

Solicitar recomendaciones

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

Cómo enviar atributos de Recommendations a Adobe Target:

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

Mostrar métricas de conversión de mbox display-mbox-conversion-metrics

El siguiente ejemplo muestra cómo se puede hacer un seguimiento de las conversiones de mbox de visualización y enviar parámetros de perfil a Adobe Target, sin necesidad de calificar para ningún contenido o actividad.

alloy("sendEvent", {
    "xdm": {
        "_experience": {
            "decisioning": {
                "propositions": [{
                    "scope": "conversion-step-1" //example scope name
                }],
                "propositionEventType": {
                    "display": 1
                }
            }
        },
        "eventType": "decisioning.propositionDisplay"
    }
});

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.