Show Menu
TEMAS×

Transferencias de datos salientes en tiempo real

El proceso de transferencia de datos en tiempo real saliente ofrece datos de usuario como una serie de mensajes con JSON 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 pueda escalarse para recibir un gran volumen de mensajes de Audience Manager;
  • Debe aceptar los datos en JSON formato ( Content-type: application/json );
  • Debe aceptar transferencias HTTPS de datos seguras. 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 entregan mientras el usuario está en línea y es visible activamente para la red de Audience Manager Edge. Opcionalmente, 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 por lotes y en tiempo real se envían al mismo extremo y utilizan el mismo formato de mensaje. Cuando se habilitan las transferencias por lotes, la plataforma de destino verá un pico en el volumen de mensajes mientras se entregan los mensajes por lotes. Muchas de las cualificaciones de los segmentos que se envían a través de mensajes en tiempo real se repetirán en los mensajes por lotes. Las transferencias por lotes incluyen únicamente las cualificaciones de los segmentos (o anulaciones de cualificaciones) que han 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 provocar la pérdida de datos.

Respuestas obligatorias

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

Parámetros

La siguiente tabla define los elementos del archivo de datos que se envían al destino JSON .
Parámetro Tipo de datos Descripción
ProcessTime
DateTime
Hora a la que se ejecutó la solicitud.
User_DPID
Número entero
ID que indica el tipo de ID de dispositivo contenido en el mensaje, en la propiedad User.DataPartner_UUID.
  • ID de Android (GAID): 20914
  • ID de iOS (IDFA): 20915
  • ID de web/cookie: 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 en la plataforma de destino.
AAM_Destination_ID
Número entero
ID del objeto "destino" de Audience Manager. Este ID se origina en 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 contendrá entre 1 y 10 usuarios, para mantener el tamaño óptimo del mensaje.
User.AAM_UUID
Cadena
UUID de Audience Manager .
User.DataPartner_UUID
Cadena
UUID de plataforma de destino o ID de dispositivo global.
User.AAM_Regions Matriz ID de región de Audience Manager donde 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 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. En el caso de los mensajes por lotes, la matriz solo contiene cambios de segmentos 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 Audience Manager (un entero). En algunos casos, si la plataforma de destino lo permite, los clientes pueden definir el identificador de segmento en la interfaz de usuario de 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 elegido o no segmentado.
Los usuarios no están segmentados cuando:
  • Se ha eliminado de un segmento en función de 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 en los últimos 120 días.
  • Eliminado debido a una solicitud de cambio de privacidad (por ejemplo, RGPD )
Todos los ID de socio sincronizados con un ID de Audience Manager recibirán el "Status":"0" indicador cuando un usuario no esté segmentado.
Segment.DateTime
DateTime
Hora en la que se verificó más recientemente la cualificación de segmento de usuario.

Seguridad

Puede asegurar el proceso de transferencia de datos saliente en tiempo real firmando solicitudes HTTP con claves privadas o haciendo que Audience Manager se autentique 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"
        }]
    }]
}