Adobe Experience Platform Web SDK puede ofrecer y procesar experiencias personalizadas administradas en Adobe Target al canal web. Puede utilizar un editor WYSIWYG, denominado Compositor de experiencias visuales (VEC), o una interfaz no visual, la variable Compositor de experiencias basadas en formularios, para crear, activar y entregar sus actividades y experiencias de personalización.
La variable Documentación de Adobe Target incluye temas que contienen información específica del SDK web de plataforma en relación con las funciones y funcionalidades de Target.
Se han probado las siguientes funciones, que actualmente son compatibles con Target:
El diagrama siguiente le ayuda a comprender el flujo de trabajo de Target y Platform Web SDK decisión de borde.
La llamada | Detalles |
---|---|
1 | El dispositivo carga la variable Platform Web SDK. La variable Platform Web SDK envía una solicitud a la red perimetral con datos XDM, el ID de entorno de Datastreams, 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 del 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 al Target borde con el ID de visitante y parámetros transferidos. |
4 | Los scripts de perfil se ejecutan y luego se incluyen en Target almacenamiento de perfiles. El almacenamiento de perfiles obtiene 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 mostrar para el visitante en la vista de página actual y para futuras vistas de recuperación previa. Target a continuación, lo devuelve a la red perimetral. |
6 | a. La red perimetral envía la respuesta de personalización 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. b. El contenido personalizado para las vistas que se muestran como resultado de las acciones del usuario en una aplicación de una sola página (SPA) 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 consentimiento, ID de sesión, identidad, comprobación de cookies, personalización, etc. |
7 | La red perimetral reenvía Analytics para Target Detalles (de actividad, experiencia y metadatos de conversión) de (A4T) Analytics borde. |
Para habilitar Target, haga lo siguiente:
renderDecisions
a sus 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.Para usar el VEC con un Platform Web SDK implementación, instale y active Firefox o Chrome Extensión de VEC Helper.
Para obtener más información, consulte Extensión del Helper del Compositor de experiencias visuales en el Guía de Adobe Target.
Consulte Representación de contenido personalizado para obtener más información.
Al definir audiencias para su Target actividades que se entregan mediante la variable Platform Web SDK, XDM debe definirse y utilizarse. Después de definir esquemas XDM, clases y grupos de campos de esquema, puede crear una Target regla de audiencia definida por los datos XDM para la segmentación. Within Target, los datos XDM se muestran en la variable Audience Builder como parámetro personalizado. El XDM se serializa mediante notación de puntos (por ejemplo, web.webPageDetails.name
).
Si tiene Target Las actividades con audiencias predefinidas que utilizan parámetros personalizados o un perfil de usuario no se envían correctamente a través del SDK. En lugar de usar parámetros personalizados o el perfil de usuario, debe utilizar XDM en su lugar. Sin embargo, hay campos de segmentación de audiencia integrados que se admiten mediante la variable Platform Web SDK que no requieren XDM. Estos campos están disponibles en la 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 la variable 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 alloy.sendEvent
promesa, iterar hasta propositions
y 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 el procesamiento automático está habilitado, 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 se deshabilita el procesamiento automático, 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
La variable Platform Web SDK permite actualizar el perfil al Target y al Platform Web SDK como evento de experiencia.
Para actualizar un Target , asegúrese de que los datos de perfil se pasen de la siguiente manera:
“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 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 Target soluciones en la clase target. |
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 }
});
Envío de atributos de perfil a Adobe Target:
alloy("sendEvent", {
renderDecisions: true,
data: {
__adobe: {
target: {
"profile.gender": "female",
"profile.age": 30
}
}
}
});
Las siguientes listas de tabla Recommendations y si cada uno es compatible mediante la variable 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 |
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 ya no se utilizan. Uso Platform Web SDK depuración.
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: El alcance de la decisión. En Target, el ámbito es el 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.