DocumentaciónAudience ManagerGuía del usuario de Audience Manager

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

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

El proceso saliente de transferencia de datos en tiempo real envía 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 extremo URL que se pueda escalar para recibir un gran volumen de mensajes del Audience Manager;
  • Debe aceptar datos en formato JSON (Content-type: application/json);
  • Debe aceptar transferencias de datos seguras de HTTPS. Audience Manager no enviará mensajes a través del protocolo no seguro HTTP.

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 el código 200 OK para indicar que la confirmación se ha realizado correctamente. Otros códigos se interpretarán como errores. Esta respuesta se espera dentro de los 3000 milisegundos. En respuesta a un error, Audience Manager realizará un solo intento de reintento.

Parámetros

En la tabla siguiente se definen los elementos del archivo de datos JSON que se envían 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.

  • Android ID (GAID): 20914
  • ID de iOS (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 solicitud POST.
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 UUID Audience Manager.
User.DataPartner_UUID
Cadena
UUID de la plataforma de destino o ID del dispositivo global.
User.AAM_Regions
Matriz
El ID de región Audience Manager en el que hemos visto este dispositivo. Por ejemplo, si el dispositivo tuviera alguna actividad en París (Europa), el ID de región sería 6. Consulte 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 eliminó de un segmento en función del intervalo de duración del segmento.
  • Se mueve a un estado inactivo si no se han visto en los últimos 120 días.
  • Se eliminó debido a una solicitud de cambio de privacidad (es decir, RGPD)

Todos los identificadores de socio sincronizados con un identificador de Audience Manager recibirán el marcador "Status":"0" cuando un usuario no esté segmentado.

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 firmando solicitudes HTTP con claves privadas o haciendo que Audience Manager se autentique a través del protocolo OAuth 2.0.

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