Documentación Experience Platform Guía de destinos

Conexión de personalización personalizada

Última actualización: 29 de agosto de 2024

Temas:
Destinos

Creado para:

Administrador
Usuario

Registro de cambios de destino

Mes de lanzamiento	Tipo de actualización	Descripción
Mayo de 2023	Actualización de funcionalidad y documentación	En mayo de 2023, la conexión de Personalización personalizada admite la personalización basada en atributos y está disponible para todos los clientes.

IMPORTANT

Los atributos de perfil pueden contener datos confidenciales. Para proteger estos datos, debe usar la API de Edge Network Server al configurar el destino de Personalization personalizado para la personalización basada en atributos. Todas las llamadas a la API de servidor deben realizarse en un contexto autenticado.

Puede recuperar atributos de perfil a través de la API de Edge Network Server agregando una integración del lado del servidor que utiliza la misma secuencia de datos que ya está utilizando para su implementación de SDK web o móvil.

Si no cumple los requisitos anteriores, la personalización se basará únicamente en el abono a audiencias.

Información general

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

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.

IMPORTANT

Antes de crear una conexión de personalización personalizada, lee la guía sobre cómo activar datos de audiencia en destinos de personalización Edge. Esta guía le guía a través de los pasos de configuración necesarios para los casos de uso de personalización de la misma página y de la página siguiente, en varios componentes de Experience Platform.

Audiencias compatibles

Esta sección describe qué tipos de audiencias puede exportar a este destino.

Origen de audiencia	Admitido	Descripción
Segmentation Service	✓	Audiencias generadas a través del Experience Platform Servicio de segmentación.
Cargas personalizadas	✓	Las audiencias importadas en el Experience Platform desde archivos CSV.

Tipo y frecuencia de exportación

Elemento	Tipo	Notas
Tipo de exportación	Profile request	Está solicitando todas las audiencias asignadas en el destino de personalización personalizado para un solo perfil. Se pueden configurar diferentes destinos de personalización personalizados para diferentes flujos de datos de recopilación de datos de Adobe.
Frecuencia de exportación	Transmisión	Los destinos de streaming son conexiones basadas en API "siempre activadas". Tan pronto como se actualiza un perfil en Experience Platform según la evaluación de audiencias, el conector envía la actualización de forma descendente a la plataforma de destino. Más información sobre destinos de streaming.

Conexión al destino

IMPORTANT

Para conectarse al destino, necesita los permisos de control de acceso de Ver destinos] y Administrar destinos[5}. Lea la descripción general del control de acceso o póngase en contacto con el administrador del producto para obtener los permisos necesarios.

Para conectarse a este destino, siga los pasos descritos en el tutorial de configuración de destino.

Parámetros de conexión

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

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

IMPORTANT

Para activar los datos, necesita los permisos de control de acceso, Activar destinos, Ver perfiles y Ver segmentos para. Lea la descripción general del control de acceso o póngase en contacto con el administrador del producto para obtener los permisos necesarios.

Lea Activar perfiles y audiencias para destinos personalizados Edge para obtener instrucciones sobre cómo activar audiencias en este destino.

Datos exportados

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

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.

recommendation-more-help