Show Menu
TEMAS×

Transferencias de datos salientes en tiempo real

El proceso de transferencia de datos en tiempo real saliente devuelve datos de usuario como una serie de JSON objetos pasados con un POST método.

Las actividades de

Para utilizar este método, recomendamos que el socio de datos:
  • Acepta datos en JSON formato.
  • Proporciona una dirección URL que puede utilizar la POST llamada para devolver datos.
  • Acepta transferencias HTTPS de datos seguras. Audience Manager no enviará este archivo con el 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. Además, este método puede enviar lotes de datos sin conexión o incorporados con la misma frecuencia que cada 24 horas.

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á 1 intento de reintento.

Parámetros

La siguiente tabla define los elementos del archivo JSON de datos devuelto.
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 si el archivo contiene ID de Android o iOS. Utiliza los siguientes valores de ID:
  • ID de Android (GAID): 2014
  • ID de iOS (IDFA): 2015
Client_ID
Cadena
ID de cliente que utiliza el sistema al que envía los datos.
AAM_Destination_ID
Número entero
ID que le ha asignado su socio de destino.
User_count
Número entero
Número total de usuarios en la solicitud POST .
Usuarios
Matriz
Matriz de objetos de usuario.
AAM_UUID
Cadena
UUID de Audience Manager .
DataPartner_UUID
Cadena
UUID del socio de datos. Déjelo en blanco si su socio de datos no tiene un UUID.
AAM_Region 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).
Segmentos
Matriz
Matriz de objetos de segmento.
Segment_ID
Número entero
Asignación del destino de ID de segmento.
Estado
Número entero
Define el estado de un usuario en el segmento. Acepta lo siguiente:
  • 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.
Todos los ID de socio sincronizados con un ID de Audience Manager recibirán el indicador "Estado":"0" cuando un usuario no está segmentado.
DateTime
DateTime
La hora de la clasificación de segmentos más reciente.

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 .

Ejemplo de código

Una respuesta de datos 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",
   "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",
   "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"
        }]
    }]
}