Conexión de API HTTP (Beta)

IMPORTANTE

El destino de la API HTTP en Platform está actualmente en fase beta. La documentación y las funciones están sujetas a cambios.

Información general

El destino de la API HTTP es un Adobe Experience Platform destino de flujo continuo que le ayuda a enviar datos de perfil a extremos HTTP de terceros.

Para enviar datos de perfil a extremos HTTP, primero debe conectarse al destino en Adobe Experience Platform.

Casos de uso

El destino HTTP está dirigido a clientes que necesitan exportar datos de perfil XDM y segmentos de audiencia a extremos HTTP genéricos.

Los extremos HTTP pueden ser sistemas propios de los clientes o soluciones de terceros.

Requisitos previos

IMPORTANTE

Póngase en contacto con los representantes de Adobe o con el Servicio de atención al cliente de Adobe si desea habilitar la funcionalidad beta de destino de la API HTTP para su empresa.

Para utilizar el destino de la API HTTP para exportar datos fuera del Experience Platform, debe cumplir los siguientes requisitos previos:

  • Debe tener un extremo HTTP que admita la API de REST.
  • El extremo HTTP debe admitir el esquema de perfil del Experience Platform. No se admite ninguna transformación en un esquema de carga útil de terceros en el destino de API HTTP. Consulte la datos exportados para ver un ejemplo del esquema de salida del Experience Platform.
  • El extremo HTTP debe admitir encabezados.
  • El extremo HTTP debe admitir Credenciales de cliente de OAuth 2.0 autenticación. Este requisito es válido mientras el destino de la API HTTP está en la fase beta.
  • Las credenciales del cliente deben incluirse en el cuerpo de las solicitudes de POST al extremo, como se muestra en el ejemplo siguiente.
curl --location --request POST '<YOUR_API_ENDPOINT>' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id=<CLIENT_ID>' \
--data-urlencode 'client_secret=<CLIENT_SECRET>'

También puede utilizar Adobe Experience Platform Destination SDK para configurar una integración y enviar datos de perfil de Experience Platform a un extremo HTTP.

Conectarse al destino

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

Parámetros de conexión

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

  • httpEndpoint: el URL del extremo HTTP al que desea enviar los datos de perfil.

    • De forma opcional, puede agregar parámetros de consulta al httpEndpoint URL.
  • authEndpoint: el URL del extremo HTTP utilizado para OAuth2 autenticación.

  • ID de cliente: el clientID parámetro utilizado en OAuth2 credenciales del cliente.

  • Secreto del cliente: el clientSecret parámetro utilizado en OAuth2 credenciales del cliente.

    NOTA

    Solo OAuth2 actualmente se admiten credenciales de cliente.

  • Nombre: introduzca un nombre por el que reconozca este destino en el futuro.

  • Descripción: escriba una descripción que le ayudará a identificar este destino en el futuro.

  • Encabezados personalizados: introduzca los encabezados personalizados que desee incluir en las llamadas de destino, siguiendo este formato: header1:value1,header2:value2,...headerN:valueN.

    IMPORTANTE

    La implementación actual requiere al menos un encabezado personalizado. Esta limitación se resolverá en una actualización futura.

Activar segmentos en este destino

Consulte Activar datos de audiencia en destinos de exportación de perfil de flujo continuo para obtener instrucciones sobre la activación de segmentos de audiencia en este destino.

Atributos de destino

En el Seleccionar atributos paso, Adobe recomienda seleccionar un identificador único de su esquema de unión. Seleccione el identificador único y cualquier otro campo XDM que desee exportar al destino.

Comportamiento de exportación del perfil

Experience Platform optimiza el comportamiento de exportación del perfil al destino de la API HTTP para exportar solo los datos al extremo de la API cuando se hayan producido actualizaciones relevantes en un perfil tras la calificación del segmento u otros eventos significativos. Los perfiles se exportan al destino en las siguientes situaciones:

  • La actualización de perfil se activó mediante un cambio en la pertenencia a segmentos para al menos uno de los segmentos asignados al destino. Por ejemplo, el perfil se ha clasificado para uno de los segmentos asignados al destino o ha salido de uno de los segmentos asignados al destino.
  • La actualización de perfil se activó mediante un cambio en la variable mapa de identidad. Por ejemplo, un perfil que ya se había clasificado para uno de los segmentos asignados al destino se ha añadido una nueva identidad en el atributo de mapa de identidad.
  • La actualización de perfil se activó mediante un cambio en los atributos de al menos uno de los atributos asignados al destino. Por ejemplo, uno de los atributos asignados al destino en el paso de asignación se agrega a un perfil.

En todos los casos descritos anteriormente, solo los perfiles en los que se han producido actualizaciones relevantes se exportan a su destino. Por ejemplo, si un segmento asignado al flujo de destino tiene cien miembros y cinco perfiles nuevos cumplen los requisitos para el segmento, la exportación a su destino es incremental y solo incluye los cinco perfiles nuevos.

Tenga en cuenta que todos los atributos asignados se exportan para un perfil, independientemente de dónde estén los cambios. Por lo tanto, en el ejemplo anterior, todos los atributos asignados para esos cinco perfiles nuevos se exportan incluso si los atributos en sí no han cambiado.

Datos exportados

Su exportación Experience Platform los datos llegan a su HTTP destino en formato JSON. Por ejemplo, la exportación siguiente contiene un perfil que se ha clasificado para un segmento determinado y ha salido de otro, e incluye el nombre, los apellidos, la fecha de nacimiento y la dirección de correo electrónico personal del atributo de perfil. Las identidades de este perfil son ECID y correo electrónico.

{
  "person": {
    "birthDate": "YYYY-MM-DD",
    "name": {
      "firstName": "John",
      "lastName": "Doe"
    }
  },
  "personalEmail": {
    "address": "john.doe@acme.com"
  },
  "segmentMembership": {
    "ups": {
      "7841ba61-23c1-4bb3-a495-00d3g5fe1e93": {
        "lastQualificationTime": "2020-05-25T21:24:39Z",
        "status": "exited"
      },
      "59bd2fkd-3c48-4b18-bf56-4f5c5e6967ae": {
        "lastQualificationTime": "2020-05-25T23:37:33Z",
        "status": "existing"
      }
    }
  },
  "identityMap": {
    "ecid": [
      {
        "id": "14575006536349286404619648085736425115"
      },
      {
        "id": "66478888669296734530114754794777368480"
      }
    ],
    "email_lc_sha256": [
      {
        "id": "655332b5fa2aea4498bf7a290cff017cb4"
      },
      {
        "id": "66baf76ef9de8b42df8903f00e0e3dc0b7"
      }
    ]
  }
}

En esta página