Transferencias de datos salientes en tiempo real real-time-outbound-data-transfers
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 unsecureHTTP
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.
ProcessTime
User_DPID
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
AAM_Destination_ID
User_count
POST
solicitud.Users
User.AAM_UUID
User.DataPartner_UUID
User.AAM_Regions
6
. Consulte DCS Region IDs, Locations, and Host Names (ID de región de DCS, ubicaciones y nombres de host).Segments
Segment.Segment_ID
Segment.Status
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
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"
}]
}]
}