Conexión personalizada de Personalization custom-personalization-connection
Registro de cambios de destino changelog
Utilice este registro de cambios para realizar un seguimiento de las actualizaciones en el destino de Personalization personalizado.
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 ejecuten en sitios web de clientes recuperen la información de audiencia de Adobe Experience Platform.
Requisitos previos prerequisites
Este destino requiere uno de los siguientes métodos de recopilación de datos, según la implementación:
- Use Adobe Experience Platform Web SDK para recopilar datos de su sitio web.
- Use Adobe Experience Platform Mobile SDK para recopilar datos de su aplicación móvil.
- Utilice la API de Edge Network si no utiliza Web SDK o Mobile SDK, o si desea personalizar la experiencia del usuario en función de los atributos del perfil.
Audiencias compatibles supported-audiences
En la tabla siguiente se enumeran los tipos de audiencia que puede exportar a este destino.
Esta categoría incluye todos los orígenes de audiencia fuera de las audiencias generadas a través de Segmentation Service. Obtenga información acerca de varios orígenes de audiencia. Algunos ejemplos son:
- audiencias de carga personalizadas importadas a Experience Platform desde archivos CSV,
- audiencias de similitud,
- audiencias federadas,
- audiencias generadas en otras aplicaciones de Experience Platform, como Adobe Journey Optimizer,
- y más.
Audiencias compatibles por tipo de datos de audiencia:
Tipo y frecuencia de exportación export-type-frequency
En la tabla siguiente se describe el tipo y la frecuencia de exportación para este destino.
Conectar con el 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:
- Name: rellene el nombre preferido para este destino.
- Description: escriba una descripción para el destino. Por ejemplo, puede mencionar para qué campaña está usando este destino. Este campo es opcional.
- Integration alias: una cadena requerida que identifica este destino en la respuesta de personalización. El valor de alias se devuelve al sitio web o aplicación junto con las audiencias (y, si se configura, los atributos) asociados a este destino. Utilice el alias en el código del lado del cliente o del lado del servidor para localizar y procesar el objeto de personalización correcto cuando varios destinos de personalización estén activos en la misma secuencia de datos. El alias debe ser único dentro de una zona protegida en todos los destinos personalizados de Personalization.
- Datastream: 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
Active las alertas para recibir notificaciones sobre el estado del flujo de datos a este 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 Next.
Activar públicos en este destino activate
Lea Activar perfiles y audiencias en destinos de personalización 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 Experience Platform Web SDK, use la funcionalidad enviar evento completado. La acción de Custom Code 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 Experience Platform Web SDK, use respuestas de comandos para ver los datos exportados.
Analice la respuesta JSON de Adobe Experience Platform para encontrar el alias de integración de la aplicación que integra con Adobe Experience Platform. Pase los ID de audiencia al código de la aplicación como parámetros de segmentación. A continuación se muestra un ejemplo de cómo se ve 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 example-response-attributes
Al usar Custom Personalization With Attributes, la respuesta de la API será similar al ejemplo siguiente.
La diferencia entre Custom Personalization With Attributes y Custom Personalization 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.