DocumentaciónAudience ManagerGuía del usuario de Audience Manager

Transferencias de datos salientes en tiempo real real-time-outbound-data-transfers

Last update: Sat May 20 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

El proceso saliente de transferencia de datos en tiempo real ofrece datos de usuario como una serie de JSON mensajes con formato a una plataforma de destino.

Las actividades de

Para utilizar este método, la plataforma de destino debe cumplir los siguientes requisitos:

  • Debe proporcionar un punto final URL que pueden ampliarse para recibir un gran volumen de mensajes del Audience Manager;
  • Debe aceptar datos en JSON format (Content-type: application/json);
  • Debe aceptar seguro HTTPS transferencias de datos. Audience Manager no enviará mensajes a través de unsecure HTTP protocolo.

Frecuencia

Este método de transferencia de datos puede enviar datos en tiempo casi real a medida que los usuarios cumplen los requisitos para los segmentos. Los mensajes en tiempo real solo se envían mientras el usuario está en línea y es visible de forma activa en la red de Audience Manager Edge. De forma opcional, este método también puede enviar lotes de datos sin conexión o incorporados con la misma frecuencia que cada 24 horas.

Transferencias por lotes

Tanto las transferencias en tiempo real como las por lotes se envían al mismo punto de conexión y utilizan el mismo formato de mensaje. Cuando se habilitan las transferencias por lotes, la plataforma de destino ve un pico en el volumen de mensajes mientras se entregan los mensajes por lotes. Muchas de las clasificaciones de segmentos enviadas a través de mensajes en tiempo real se repetirán en los mensajes por lotes. Las transferencias por lotes solo incluirán las clasificaciones de segmentos (o las que anulen las clasificaciones) que hayan cambiado desde que se entregó el último lote.

Límites de velocidad

No hay límites de velocidad establecidos en el rendimiento de los mensajes enviados. Establecer límites de velocidad podría provocar la pérdida de datos.

Respuestas requeridas

De forma predeterminada, el servidor de destinatarios debe devolver 200 OK código para indicar recepción correcta. Otros códigos se interpretarán como errores. Esta respuesta se espera dentro de los 3000 milisegundos. En respuesta a un error, Audience Manager solo realizará un intento de reintento.

Parámetros

En la tabla siguiente se definen los elementos de JSON archivo de datos que envía al destino.

Parámetro
Tipo de datos
Descripción
ProcessTime
DateTime
Hora a la que se ejecutó la solicitud.
User_DPID
Número entero

Identificador que indica el tipo de identificadores de dispositivo contenidos en el mensaje, en la propiedad User.DataPartner_UUID.

  • ID de Android (GAID): 20914
  • iOS ID (IDFA): 20915
  • ID de cookies/web: varía según la plataforma de destino
Client_ID
Cadena
Representa la cuenta de destino en la plataforma de destino. Este ID se origina desde la plataforma de destino.
AAM_Destination_ID
Número entero
ID del objeto "destination" del Audience Manager. Este ID se origina desde el Audience Manager.
User_count
Número entero
Número total de usuarios en la POST solicitud.
Users
Matriz
Matriz de objetos de usuario. De forma predeterminada, cada mensaje contiene entre 1 y 10 usuarios, para mantener un tamaño de mensaje óptimo.
User.AAM_UUID
Cadena
El Audience Manager UUID.
User.DataPartner_UUID
Cadena
UUID de la plataforma de destino o ID del dispositivo global.
User.AAM_Regions
Matriz
El Audience Manager ID de región donde hemos visto este dispositivo. Por ejemplo, si el dispositivo tenía alguna actividad en París (Europa), el ID de región sería 6. Consulte DCS Region IDs, Locations, and Host Names (ID de región de DCS, ubicaciones y nombres de host).
Segments
Matriz
Matriz de objetos de segmento. Para los mensajes en tiempo real, la matriz contiene todos los segmentos a los que pertenece el usuario. Para los mensajes por lotes, la matriz solo contiene cambios de segmento desde el último lote.
Segment.Segment_ID
Número entero
El identificador del segmento. En la mayoría de los casos, este es el ID del segmento generado por el Audience Manager (un número entero). En algunos casos, si la plataforma de destino lo permite, los clientes pueden definir el identificador del segmento en la interfaz de usuario del Audience Manager (campo de texto abierto), que luego se reflejaría en esta propiedad.
Segment.Status
Número entero

Define el estado de un usuario en el segmento. Acepta los siguientes valores:

  • 1: Activo (predeterminado)
  • 0: Inactivo, excluido o no segmentado.

Los usuarios no están segmentados cuando:

  • Se ha eliminado de un segmento según la regla de segmento.
  • Se ha eliminado de un segmento en función del intervalo de tiempo de vida.
  • Se mueve a un estado inactivo si no se han visto en los últimos 120 días.
  • Se ha eliminado debido a una solicitud de cambio de privacidad (por ejemplo, RGPD)

Todos los ID de socio sincronizados con una Audience Manager El ID recibirá el "Status":"0" marcar cuando un usuario está sin segmentar.

Segment.DateTime
DateTime
Hora a la que se verificó la calificación del segmento de usuario por última vez.

Seguridad

Puede asegurar su proceso de transferencia de datos salientes en tiempo real al firma de solicitudes HTTP usando claves privadas o teniendo Audience Manager autenticarse a través de OAuth 2.0 protocolo.

Solicitud

Una solicitud en tiempo real puede tener un aspecto similar al siguiente:

{
"ProcessTime": "Wed Jul 27 16:17:42 UTC 2016",
"User_DPID": "12345",
"Client_ID": "74323",
"AAM_Destination_Id": "423",
"User_count": "2",
"Users": [{
   "AAM_UUID": "19393572368547369350319949416899715727",
   "DataPartner_UUID": "4250948725049857",
   "AAM_Regions": ["9"],
   "Segments": [{
            "Segment_ID": "14356",
            "Status": "1",
            "DateTime": "Wed Jul 27 16:17:22 UTC 2016"
         },
         {
            "Segment_ID": "12176",
            "Status": "0",
            "DateTime": "Wed Jul 27 16:17:22 UTC 2016"
         }
      ]
   },
   {
   "AAM_UUID": "0578240750487542456854736923319946899715232",
   "DataPartner_UUID": "848457757347734",
   "AAM_Regions": ["9"],
   "Segments": [{
            "Segment_ID": "10329",
            "Status": "1",
            "DateTime": "Wed Jul 27 16:17:21 UTC 2016"
         },
         {
            "Segment_ID": "23954",
            "Status": "1",
            "DateTime": "Wed Jul 27 16:17:21 UTC 2016"
        }]
    }]
}
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695