Transferencias de datos salientes en tiempo real

El proceso saliente de transferencia de datos en tiempo real ofrece datos de usuario como una serie de mensajes con formato JSON 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 pueda escalarse 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 HTTPS seguras. Audience Manager no enviará mensajes a través del HTTP protocolo no seguro.

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 entregan mientras el usuario está en línea y es visible de forma activa para la red 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

Las transferencias en tiempo real y por lotes se envían al mismo extremo y utilizan el mismo formato de mensaje. Cuando se activan las transferencias por lotes, la plataforma de destino observará un pico en el volumen de mensajes mientras se entregan los mensajes por lotes. Muchas de las cualificaciones de los segmentos enviadas a través de mensajes en tiempo real se repetirán en los mensajes por lotes. Las transferencias por lotes incluirán únicamente las cualificaciones (o anulaciones de cualificaciones) de los segmentos que hayan cambiado desde que se entregó el último lote.

Límites de tasa

No hay límites de velocidad establecidos en el rendimiento de los mensajes entregados. El establecimiento de límites de velocidad podría causar la pérdida de datos.

Respuestas necesarias

De forma predeterminada, el servidor de destinatario debe devolver el código 200 OK para indicar que la recepción se ha realizado correctamente. Otros códigos se interpretarán como errores. Esta respuesta se espera en 3000 milisegundos. En respuesta a un error, Audience Manager solo realizará un intento de reintento.

Parámetros

La tabla siguiente define los elementos del archivo de datos JSON 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

Un ID que indica el tipo de ID de dispositivo que contiene el mensaje, en la propiedad User.DataPartner_UUID .

  • ID de Android (GAID): 20914
  • ID de iOS (IDFA): 20915
  • ID web/de cookies: 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" de Audience Manager. Este ID se origina en 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 el tamaño del mensaje óptimo.

User.AAM_UUID

Cadena

El UUID Audience Manager.

User.DataPartner_UUID

Cadena

UUID de plataforma de destino o ID de dispositivo global.

User.AAM_Regions Matriz El ID de región Audience Manager 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.

Segmnent.Segment_ID

Número entero

Identificador del segmento. En la mayoría de los casos, este es el ID de 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 de 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, no seleccionado o no segmentado.

Los usuarios no están segmentados cuando:

  • Eliminado de un segmento basado en la regla de segmento.
  • Se ha eliminado de un segmento en función del intervalo de tiempo de vida del segmento.
  • Se ha movido a un estado inactivo si no se han visto durante los últimos 120 días.
  • Se ha eliminado debido a una solicitud de cambio de privacidad (p. ej. RGPD)

Todos los ID de socio que se sincronizan con un ID de Audience Manager recibirán el indicador "Status":"0" cuando se anule la segmentación de un usuario.

Segment.DateTime

DateTime

Hora a la que se verificó más recientemente la calificación del segmento de usuario.

Seguridad

Puede proteger el proceso de transferencia de datos salientes en tiempo real firmando solicitudes HTTP con claves privadas o Audience Manager autenticándose mediante el 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"
        }]
    }]
}

En esta página