Conexión de personalización personalizada custom-personalization-connection
Registro de cambios de destino changelog
Información general overview
Configure este destino para permitir que las plataformas de personalización externas, los sistemas de administración de contenido, los servidores de publicidad y otras aplicaciones que se ejecutan en los sitios web de los clientes recuperen la información de audiencia de Adobe Experience Platform.
Requisitos previos prerequisites
Este destino requiere el uso de uno de los siguientes métodos de recopilación de datos, según la implementación:
- Use Adobe Experience Platform Web SDK si quiere recopilar datos de su sitio web.
- Use Adobe Experience Platform Mobile SDK si quiere recopilar datos de su aplicación móvil.
- Use la API de Edge Network Server si no usa SDK web o SDK móvil, o si desea personalizar la experiencia del usuario según los atributos del perfil.
Audiencias compatibles supported-audiences
Esta sección describe qué tipos de audiencias puede exportar a este destino.
Tipo y frecuencia de exportación export-type-frequency
Conexión al destino connect
Para conectarse a este destino, siga los pasos descritos en el tutorial de configuración de destino.
Parámetros de conexión parameters
Mientras configura este destino, debe proporcionar la siguiente información:
- Nombre: rellene el nombre preferido para este destino.
- Descripción: escribe una descripción para el destino. Por ejemplo, puede mencionar para qué campaña está usando este destino. Este campo es opcional.
- Alias de integración: Este valor se envía al SDK web de Experience Platform como nombre de objeto JSON.
- ID de secuencia de datos: Esto determina en qué secuencia de datos de recopilación de datos se incluirán las audiencias en la respuesta a la página. El menú desplegable muestra solo las secuencias de datos que tienen habilitada la configuración de destino. Consulte Configuración de una secuencia de datos para obtener más información.
Habilitar alertas enable-alerts
Puede activar alertas para recibir notificaciones sobre el estado del flujo de datos a su destino. Seleccione una alerta de la lista a la que suscribirse para recibir notificaciones sobre el estado del flujo de datos. Para obtener más información sobre las alertas, consulte la guía sobre suscripción a alertas de destinos mediante la interfaz de usuario.
Cuando termine de proporcionar detalles para la conexión de destino, seleccione Siguiente.
Activar públicos en este destino activate
Lea Activar perfiles y audiencias para destinos personalizados Edge para obtener instrucciones sobre cómo activar audiencias en este destino.
Datos exportados exported-data
Si usa Etiquetas en Adobe Experience Platform para implementar el SDK web de Experience Platform, use la funcionalidad enviar evento completado y la acción de código personalizado tendrá una variable event.destinations que puede usar para ver los datos exportados.
Este es un valor de muestra para la variable event.destinations:
[
{
"type":"profileLookup",
"destinationId":"7bb4cb8d-8c2e-4450-871d-b7824f547111",
"alias":"personalizationAlias",
"segments":[
{
"id":"399eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
},
{
"id":"499eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
}
]
}
]
Si no usa Tags para implementar el SDK web de Experience Platform, use respuestas de comandos para ver los datos exportados.
La respuesta JSON de Adobe Experience Platform se puede analizar para encontrar el alias de integración correspondiente de la aplicación que está integrando con Adobe Experience Platform. Los ID de audiencia se pueden pasar al código de la aplicación como parámetros de segmentación. A continuación se muestra un ejemplo de cómo sería esto específico de la respuesta de destino.
alloy("sendEvent", {
"renderDecisions": true,
"xdm": {
"commerce": {
"order": {
"purchaseID": "a8g784hjq1mnp3",
"purchaseOrderNumber": "VAU3123",
"currencyCode": "USD",
"priceTotal": 999.98
}
}
}
}).then(function(result) {
if(result.destinations) { // Looking to see if the destination results are there
// Get the destination with a particular alias
var personalizationDestinations = result.destinations.filter(x => x.alias == "personalizationAlias")
if(personalizationDestinations.length > 0) {
// Code to pass the audience IDs into the system that corresponds to personalizationAlias
}
var adServerDestinations = result.destinations.filter(x => x.alias == "adServerAlias")
if(adServerDestinations.length > 0) {
// Code to pass the audience IDs into the system that corresponds to adServerAlias
}
}
})
.catch(function(error) {
// Tracking the event failed.
});
Respuesta de ejemplo para Personalization personalizado con atributos
Al usar Personalization personalizado con atributos, la respuesta de la API será similar al ejemplo siguiente.
La diferencia entre Personalization personalizado con atributos y Personalization personalizado es la inclusión de la sección attributes en la respuesta de la API.
[
{
"type": "profileLookup",
"destinationId": "7bb4cb8d-8c2e-4450-871d-b7824f547130",
"alias": "personalizationAlias",
"attributes": {
"countryCode": {
"value" : "DE"
},
"membershipStatus": {
"value" : "PREMIUM"
}
},
"segments": [
{
"id": "399eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
},
{
"id": "499eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
}
]
}
]
Uso de datos y gobernanza data-usage-governance
Todos los destinos de Adobe Experience Platform cumplen con las políticas de uso de datos al administrar los datos. Para obtener información detallada sobre cómo Adobe Experience Platform aplica el control de datos, lea la Información general sobre el control de datos.