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.
Obtenga información sobre cómo migrar la implementación de Target al SDK web de Platform con Migración de Target de at.js 2.x al SDK web de Platform tutorial.
Obtenga información sobre cómo implementar Target por primera vez con Implementar Adobe Experience Cloud con SDK web tutorial. Para obtener información específica de Target, consulte la sección del tutorial titulada Configuración de Target con el SDK web de Platform.
Las siguientes funciones se han probado y actualmente son compatibles con Target:
El diagrama siguiente le ayuda a comprender el flujo de trabajo de Target y Platform Web SDK edge decisioning.
La llamada | Detalles |
---|---|
1 | El dispositivo carga el Platform Web SDK. El Platform Web SDK envía una solicitud a la red perimetral con datos XDM, el ID de entorno de flujos de datos, 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 de 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 a Target Edge con el ID de visitante y los parámetros proporcionados. |
4 | Se ejecutan los scripts de perfil y se incluyen en Target almacenamiento de perfiles. El almacenamiento de perfiles recupera 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 se mostrarán al visitante en la vista de página actual y en futuras vistas previamente recuperadas. Target a continuación, lo devuelve a la red de edge. |
6 | a. La red perimetral envía la respuesta de personalización de vuelta 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. SPA b. El contenido personalizado para vistas que se muestran como resultado de acciones del usuario en una aplicación de una sola página () 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 el consentimiento, el ID de sesión, la identidad, la comprobación de cookies, la personalización, etc. |
7 | La red de Edge reenvía Analytics for Target (A4T) detalla (actividad, experiencia y metadatos de conversión) en Analytics edge. |
Para habilitar Target, haga lo siguiente:
renderDecisions
a sus eventos.A continuación, de forma opcional, también puede añadir las siguientes opciones:
decisionScopes
: Recupere actividades específicas (útiles para actividades creadas con el compositor basado en formularios) añadiendo esta opción a los eventos.Para utilizar el VEC con un Platform 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.
Consulte Representación de contenido de personalización para obtener más información.
Al definir audiencias para su Target actividades que se entregan a través de Platform 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 Platform 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.
Los tokens de respuesta se utilizan principalmente para enviar metadatos a terceros, como Google, Facebook, etc. 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 propositions
y extraer 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:
propositions
con renderAttempted
indicador establecido en false
renderAttempted
indicador establecido en true
renderAttempted
indicador establecido en true
renderAttempted
indicador establecido en true
Cuando la representación automática está desactivada, la matriz de propuestas contiene:
propositions
con renderAttempted
indicador establecido en false
renderAttempted
indicador establecido en false
renderAttempted
indicador establecido en false
renderAttempted
indicador establecido en false
El Platform Web SDK permite actualizar el perfil a Target y a la Platform Web SDK como un evento de experiencia.
Para actualizar una Target , asegúrese de que los datos de perfil se pasan con lo siguiente:
"data {"
"__adobe.target"
"profile."
por ejemplo, como se muestra a continuaciónClave | Tipo | Descripción |
---|---|---|
renderDecisions |
Booleano | Indica al componente de personalización si debe interpretar las acciones del DOM |
decisionScopes |
Matriz <String> |
Una lista de ámbitos para los que recuperar decisiones |
xdm |
Objeto | Datos con formato XDM que aterrizan en el SDK web de Platform como un evento de experiencia |
data |
Objeto | Pares arbitrarios de clave/valor enviados a Target soluciones en la clase de destino. |
Típico Platform Web SDK el código que utiliza este comando tiene el siguiente aspecto:
sendEvent
con 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
}
}
}
});
La siguiente tabla enumera Recommendations y si cada uno de ellos es compatible mediante los atributos Platform Web SDK:
Categoría | Atributo | Estado de soporte |
---|---|---|
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 | |
Categoría de página o 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"
}
}
}
});
mboxTrace y mboxDebug han quedado obsoletos. Uso Platform Web SDK depuración.
Propuestas: Entrada 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 Target.
Ámbito: Ámbito de la decisión. Entrada 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 Target como parámetros mBox.