Uso Adobe Target y Web SDK para personalización

Adobe Experience Platform Web SDK puede entregar y procesar experiencias personalizadas gestionadas en Adobe Target al canal web. Puede utilizar un editor WYSIWYG, llamado Compositor de experiencias visuales (VEC), o una interfaz no visual, la variable 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:

Web SDK diagrama del sistema

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 utilizar el VEC con un Web SDK implementación, instale y active el Firefox o Chrome Extensión de VEC Helper.

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

Representación de contenido personalizado

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

Audiencias en XDM

Al definir audiencias para su Target actividades que se entregan a través de Web SDK, XDM debe definirse y utilizarse. Después de definir esquemas XDM, clases y grupos de campos de esquema, puede crear un Target regla de audiencia definida por los datos XDM para la segmentación. En Target, los datos XDM se muestran en Generador de audiencias como parámetro personalizado. El XDM se serializa con 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 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 listos para usar compatibles con el Web SDK que no requieren XDM. Estos campos están disponibles en la variable Target IU que no requieren XDM:

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 para enviar metadatos a terceros, como Google o Facebook. Los tokens de respuesta se devuelven en meta campo 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 de, debe suscribirse a alloy.sendEvent prometer, iterar propositionsy 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 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 permite actualizar el perfil a Target y a la Web SDK como un evento de experiencia.

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

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

Para retrasar el registro de atributos en el perfil hasta que se haya mostrado 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 __save indicador establecido en false para evitar que la categoría persista en el momento en que se solicita el contenido. Una vez visualizado el contenido, envíe la carga útil adecuada (incluido el 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|..."
        }
      }
    }
  }
} ) ;

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 siguiente tabla enumera Recommendations y si cada uno de ellos es compatible mediante los atributos 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 han quedado obsoletos. Utilice un método de Depuración del SDK web en su lugar.

Terminología

Propuestas: Entrada 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. Entrada Adobe Target, el ámbito es mBox. El mBox global es el __view__ ámbito.

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