Envío de parámetros a Target mediante el SDK web de Platform
Las implementaciones de Target difieren entre sitios web debido a la arquitectura del sitio, los requisitos comerciales y las características utilizadas. La mayoría de las implementaciones de Target incluyen pasar varios parámetros para información contextual, audiencias y recomendaciones de contenido.
Usemos una página sencilla de detalles del producto y una página de confirmación de pedido para demostrar las diferencias entre las bibliotecas al pasar parámetros a Target.
Supongamos que las dos páginas de ejemplo siguientes utilizan at.js:
code language-html |
---|
|
code language-html |
---|
|
Resumen de asignación de parámetros
Los parámetros de Target para estas páginas se envían de forma diferente mediante el SDK web de Platform. Existen varias formas de pasar parámetros a Target mediante at.js:
- Se establece con la función
targetPageParams()
para el evento de carga de página (utilizado en los ejemplos de esta página) - Se estableció con la función
targetPageParamsAll()
para todas las solicitudes de Target en la página - Enviar parámetros directamente con la función
getOffer()
para una sola ubicación - Envíe parámetros directamente con la función
getOffers()
para una o más ubicaciones
El SDK web de Platform proporciona una forma única y coherente de enviar datos sin necesidad de funciones adicionales. Todos los parámetros deben pasarse en la carga útil con el comando sendEvent
y caer en dos categorías:
- Asignado automáticamente desde el objeto
xdm
- Pasado manualmente con el objeto
data.__adobe.target
La siguiente tabla describe cómo se reasignarán los parámetros de ejemplo mediante el SDK web de Platform:
at_property
sendEvent
.pageName
xdm.web.webPageDetails.name
xdm
y ajustarse a un esquema mediante la clase XDM ExperienceEvent. Los parámetros de mbox no se pueden pasar como parte del objeto data
.profile.gender
data.__adobe.target.profile.gender
data
y tener el prefijo profile.
para que se asignen correctamente.user.categoryId
data.__adobe.target.user.categoryId
data
.entity.id
data.__adobe.target.entity.id
O
xdm.productListItems[0].SKU
data
o asignarse automáticamente a partir del primer elemento de la matriz xdm.productListItems
si su implementación utiliza ese grupo de campos.entity.categoryId
data.__adobe.target.entity.categoryId
data
.entity.customEntity
data.__adobe.target.entity.customEntity
data
.cartIds
data.__adobe.target.cartIds
excludedIds
data.__adobe.target.excludedIds
mbox3rdPartyId
xdm.identityMap
orderId
xdm.commerce.order.purchaseID
orderTotal
xdm.commerce.order.priceTotal
productPurchasedId
data.__adobe.target.productPurchasedId
O
xdm.productListItems[0-n].SKU
mboxPageValue
data.__adobe.target.mboxPageValue
Parámetros personalizados
Los parámetros de mbox personalizados se deben pasar como datos XDM con el comando sendEvent
. Es importante asegurarse de que el esquema XDM incluya todos los campos necesarios para la implementación de Target.
Ejemplo de at.js con targetPageParams()
:
targetPageParams = function() {
return {
"pageName": "product detail"
};
};
Ejemplos de JavaScript del SDK web de Platform usando el comando sendEvent
:
code language-javascript |
---|
|
En las etiquetas, utilice primero un elemento de datos XDM object para asignarlo al campo XDM:
E incluya su objeto XDM en su evento Send acción (se pueden combinarvarios objetos XDM):
xdm
, debe actualizar las audiencias, actividades o scripts de perfil que hagan referencia a estos parámetros de mbox con sus nuevos nombres. Consulte la página Actualizar audiencias de Target y scripts de perfil para la compatibilidad con el SDK web de Platform de este tutorial para obtener más información.Parámetros de perfil
Los parámetros de perfil de destino deben pasarse bajo el objeto data.__adobe.target
en la carga del comando sendEvent
del SDK web de Platform.
De forma similar a at.js, todos los parámetros de perfil deben tener el prefijo profile.
para que el valor se almacene correctamente como un atributo de perfil de Target persistente. El parámetro user.categoryId
reservado para la capacidad Afinidad de categoría de Target lleva el prefijo user.
.
Ejemplo de at.js con targetPageParams()
:
targetPageParams = function() {
return {
"profile.gender": "male",
"user.categoryId": "clothing"
};
};
Ejemplos del SDK web de Platform que usan el comando sendEvent
:
code language-javascript |
---|
|
En las etiquetas, cree primero un elemento de datos para definir el objeto data.__adobe.target
:
E incluya su objeto de datos en su evento de envío acción (se pueden combinar varios objetos):
Parámetros de entidad
Los parámetros de entidad se utilizan para pasar datos de comportamiento e información de catálogo suplementaria para Target Recommendations. Todos los parámetros de entidad admitidos por at.js también son compatibles con el SDK web de Platform. De forma similar a los parámetros de perfil, todos los parámetros de entidad deben pasarse bajo el objeto data.__adobe.target
en la carga del comando sendEvent
del SDK web de Platform.
Los parámetros de entidad para un elemento específico deben tener el prefijo entity.
para que la captura de datos sea correcta. Los parámetros reservados cartIds
y excludedIds
para los algoritmos de Recommendations no deben tener un prefijo y el valor de cada uno debe contener una lista separada por comas de los identificadores de entidad.
Ejemplo de at.js con targetPageParams()
:
targetPageParams = function() {
return {
"entity.id": "SKU-00001-LARGE",
"entity.categoryId": "clothing,shirts",
"entity.customEntity": "some value",
"cartIds": "SKU-00002,SKU-00003",
"excludedIds": "SKU-00001-SMALL"
};
};
Ejemplos del SDK web de Platform que usan el comando sendEvent
:
code language-javascript |
---|
|
En las etiquetas, cree primero un elemento de datos para definir el objeto data.__adobe.target
:
E incluya su objeto de datos en su evento de envío acción (se pueden combinar varios objetos):
commerce
y la matriz productListItems
se incluye en la carga útil XDM, el primer valor SKU
de esta matriz se asigna a entity.id
con el fin de incrementar una vista de producto.Parámetros de compra
Los parámetros de compra se pasan en una página de confirmación de pedido después de un pedido correcto y se utilizan para los objetivos de conversión y optimización de Target. Con una implementación del SDK web de Platform, estos parámetros y se asignan automáticamente a partir de los datos XDM pasados como parte del grupo de campos commerce
.
Ejemplo de at.js con targetPageParams()
:
targetPageParams = function() {
return {
"orderId": "ABC123",
"productPurchasedId": "SKU-00002,SKU-00003"
"orderTotal": 1337.89
};
};
La información de compra se pasa a Target cuando el grupo de campos commerce
tiene purchases.value
establecido en 1
. El id. de pedido y el total del pedido se asignan automáticamente desde el objeto order
. Si la matriz productListItems
está presente, los valores SKU
se utilizan para productPurchasedId
.
Ejemplos del SDK web de Platform que usan el comando sendEvent
:
code language-javascript |
---|
|
En las etiquetas, utilice primero un elemento de datos XDM object para asignarlo a los campos XDM:
E incluya su objeto XDM en su evento Send acción (se pueden combinarvarios objetos XDM):
productPurchasedId
también se puede pasar como una lista separada por comas de identificadores de entidad bajo el objeto data
.ID del cliente (mbox3rdPartyId)
Target permite la sincronización de perfiles entre dispositivos y sistemas mediante un único ID de cliente. Con at.js, se puede establecer como mbox3rdPartyId
en la solicitud de Target o como el primer ID de cliente enviado al servicio de ID de Experience Cloud. A diferencia de at.js, una implementación del SDK web de Platform le permite especificar qué ID de cliente utilizar como mbox3rdPartyId
si hay varios. Por ejemplo, si su empresa tiene un ID de cliente global e ID de cliente independientes para diferentes líneas de negocio, puede configurar qué ID de Target debe utilizar.
Siga algunos pasos para configurar la sincronización de ID para los casos de uso de Atributos de cliente y multidispositivo de Target:
- Crear un área de nombres de identidad para el ID de cliente en la pantalla de recopilación de datos o plataforma de Identidades
- Asegúrese de que el alias de los Atributos del cliente coincida con el símbolo de identidad de su área de nombres
- Especifique el símbolo de identidad como área de nombres de ID de terceros de destino en la configuración de destino de la secuencia de datos
- Ejecutar un comando
sendEvent
mediante el grupo de camposidentityMap
Ejemplo de at.js con targetPageParams()
:
targetPageParams = function() {
return {
"mbox3rdPartyId": "TT8675309"
};
};
Ejemplos del SDK web de Platform que usan el comando sendEvent
:
code language-javascript |
---|
|
El valor ID, estado autenticado y espacio de nombres se capturaron en un elemento de datos de mapa de identidad:
A continuación, se utiliza el elemento de datos Identity Map para establecer el campo identityMap en el elemento de datos XDM object:
El objeto XDM se incluye entonces en la acción Enviar evento de una regla:
En el servicio Adobe Target de su secuencia de datos, asegúrese de establecer el espacio de nombres de ID de terceros de Target en el mismo espacio de nombres utilizado en el elemento de datos mapa de identidad:
Ejemplo de SDK web de Platform
Ahora que comprende cómo se asignan los distintos parámetros de Target mediante el SDK web de Platform, nuestras dos páginas de ejemplo podrían migrarse de at.js al SDK web de Platform, como se muestra a continuación. Las páginas de ejemplo incluyen lo siguiente:
- Fragmento preocultado de Target para una implementación de biblioteca asincrónica
- El código base del SDK web de Platform
- La biblioteca JavaScript del SDK web de Platform
- Un comando
configure
para inicializar la biblioteca - Un comando
sendEvent
para enviar datos y solicitar que se represente el contenido de Target
code language-html |
---|
|
code language-html |
---|
|
A continuación, aprenda a rastrear eventos de conversión de Target con el SDK web de Platform.