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:

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.

Actividades de VEC de procesamiento automático

El Adobe Experience Platform Web SDK tiene el poder de procesar automáticamente las experiencias definidas mediante el VEC de Adobe Target en la web para los usuarios. Para indicar a Experience Platform Web SDK que procese automáticamente las actividades del VEC, envíe un evento con renderDecisions = true:

alloy
("sendEvent", 
  { 
  "renderDecisions": true, 
  "xdm": {
    "commerce": { 
      "order": {
        "purchaseID": "a8g784hjq1mnp3", 
         "purchaseOrderNumber": "VAU3123", 
         "currencyCode": "USD", 
         "priceTotal": 999.98 
         } 
      } 
    }
  }
);

Uso del Compositor basado en formularios

El Compositor de experiencias basadas en formularios es una interfaz no visual que resulta útil para configurar Pruebas A/B, Segmentación de experiencias, Automated Personalization y Recommendations con diferentes tipos de respuestas, como JSON, HTML, Imagen, etc . Según el tipo de respuesta o la decisión devuelta por Target, se puede ejecutar la lógica principal del negocio. Para recuperar decisiones para las actividades del Compositor basado en formularios, envíe un evento con todos los "decisionScopes" para los que desee recuperar una decisión.

alloy
  ("sendEvent", { 
    decisionScopes: [
      "foo", "bar"], 
      "xdm": {
        "commerce": { 
          "order": { 
            "purchaseID": "a8g784hjq1mnp3", 
            "purchaseOrderNumber": "VAU3123", 
            "currencyCode": "USD", 
            "priceTotal": 999.98 
          } 
        } 
      } 
    }
  );

Ámbitos de decisión

decisionScopes defina secciones, ubicaciones o partes de las páginas en las que desea procesar una experiencia personalizada. Estos decisionScopes son personalizables y están definidos por el usuario. Para los clientes actuales de [!DNL Target] , decisionScopes también se conocen como "mboxes". En la interfaz de usuario de [!DNL Target], decisionScopes aparece como "ubicaciones".

El ámbito __view__

El Experience Platform Web SDK proporciona funcionalidad para recuperar acciones del VEC sin depender del SDK para procesar las acciones del VEC por usted. Envíe un evento con __view__ definido como decisionScopes.

alloy("sendEvent", {
      "decisionScopes": ["__view__", "foo", "bar"], 
      "xdm": { 
        "web": { 
          "webPageDetails": { 
            "name": "Home Page"
          }
        } 
      }
    }
  ).then(function(results) {
    for (decision of results.decisions) {
      if (decision.decisionScope === "__view__") {
        console.log(decision.content)
      }
    }
  });

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.

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
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 soluciones Target en la clase de destino.

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 stuff (event & profile) }
});

Código de muestra

alloy("sendEvent", {
  renderDecisions: true,
  xdm: {
    device: {
      screenWidth: 9999
    }
  },
  data: {
    __adobe: {
      target: {
        "profile.gender": "female",
        "profile.age": 30,
	"entity.id" : "123",
	"entity.genre" : "Drama"
      }
    }
  }
}) 
.then(console.log);

Solicitar recomendaciones

La siguiente tabla enumera los atributos Recommendations y si cada uno es compatible a través de 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

Depuración

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

Terminología

Decisiones: en Target, las decisiones se correlacionan con la experiencia seleccionada en 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.

En esta página