Conexión de personalización personalizada custom-personalization-connection

Registro de cambios de destino changelog

Mes de lanzamiento
Tipo de actualización
Descripción
Mayo de 2023
Actualización de funcionalidad y documentación
A partir de mayo de 2023, la Personalización personalizada compatibilidad de conexión 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 utilizar la variable API del servidor de red perimetral al configurar el Personalización personalizada destino para la personalización basada en atributos. Todas las llamadas a la API de servidor deben realizarse en un contexto autenticado.
Si ya utiliza el SDK web o el SDK móvil para la integración, puede recuperar atributos mediante la API del servidor añadiendo una integración del lado del servidor.
Si no cumple los requisitos anteriores, la personalización se basará únicamente en el abono a audiencia.

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

Esta integración funciona con el SDK web de Adobe Experience Platform o el SDK de Adobe Experience Platform Mobile. Debe utilizar uno de estos SDK para utilizar este destino.

IMPORTANT
Antes de crear una conexión de personalización personalizada, lea la guía sobre cómo activar datos de audiencia en destinos de personalización de 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 supported-audiences

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

Origen de audiencia
Admitido
Descripción
Segmentation Service
Audiencias generadas mediante el Experience Platform Servicio de segmentación.
Cargas personalizadas
Audiencias importado en el Experience Platform desde archivos CSV.

Tipo y frecuencia de exportación export-type-frequency

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 Adobe de flujos de datos de recopilación.
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 connect

IMPORTANT
Para conectarse al destino, necesita el Ver destinos y Administrar destinos permisos de control de acceso. Lea el información general de 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 la sección tutorial de configuración de destino.

Parámetros de conexión parameters

While configuración Para este destino, debe proporcionar la siguiente información:

  • Nombre: complete el nombre preferido para este destino.
  • Descripción: introduzca 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 flujo de datos: Determina en qué flujo 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 de suscripción a alertas de destinos mediante la IU.

Cuando haya terminado de proporcionar detalles para la conexión de destino, seleccione Siguiente.

Activar públicos en este destino activate

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

Leer Activación de perfiles y audiencias en destinos de personalización de Edge para obtener instrucciones sobre cómo activar audiencias en este destino.

Datos exportados exported-data

Si está utilizando Etiquetas en Adobe Experience Platform para implementar el SDK web de Experience Platform, utilice el enviar evento completado y la acción de Custom Code tendrá un event.destinations que puede utilizar para ver los datos exportados.

Este es un valor de muestra para event.destinations variable:

[
   {
      "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 está utilizando Etiquetas para implementar el SDK web de Experience Platform, utilice 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 Personalización personalizada con atributos

Al utilizar Personalización personalizada con atributos Sin embargo, la respuesta de la API tendrá un aspecto similar al ejemplo siguiente.

La diferencia entre Personalización personalizada con atributos y Personalización personalizada es la inclusión de attributes de 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

Todo Adobe Experience Platform Los destinos de cumplen con las políticas de uso de datos al gestionar los datos. Para obtener información detallada sobre cómo Adobe Experience Platform aplica la gobernanza de datos, lea la Resumen de gobernanza de datos.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6