O processo de transferência de dados de saída em tempo real fornece dados do usuário como uma série de JSON mensagens formatadas para uma plataforma de destino.
Para usar esse método, a plataforma de destino deve atender aos seguintes requisitos:
Content-type: application/json
);HTTPS
transferências de dados. Audience Manager não enviará mensagens por meio da variável não segura HTTP
protocolo.Esse método de transferência de dados pode enviar dados em tempo quase real, à medida que os usuários se qualificam para segmentos. As mensagens em tempo real só são entregues enquanto o usuário está online e ativamente visível para a rede de borda do Audience Manager. Como opção, esse método também pode enviar lotes de dados offline ou integrados com a mesma frequência a cada 24 horas.
As transferências em tempo real e em lote são enviadas para o mesmo endpoint e usam o mesmo formato de mensagem. Quando as transferências em lote estiverem ativadas, a plataforma de destino verá um pico no volume de mensagens enquanto as mensagens em lote forem entregues. Muitas das qualificações de segmento enviadas por mensagens em tempo real serão repetidas nas mensagens em lote. As transferências em lote incluirão apenas as qualificações de segmento (ou não qualificações) que foram alteradas desde que o último lote foi entregue.
Não há limites de taxa definidos na taxa de transferência das mensagens entregues. A definição de limites de taxa pode levar à perda de dados.
Por padrão, o servidor do recipient deve retornar a variável 200 OK
código para indicar recebimento bem-sucedido. Outros códigos serão interpretados como falhas. Essa resposta é esperada em 3000 milissegundos. Em resposta a uma falha, Audience Manager fará apenas uma nova tentativa.
A tabela a seguir define os elementos da variável JSON arquivo de dados enviado ao destino.
Parâmetro | Tipo de dados | Descrição |
---|---|---|
ProcessTime |
DateTime |
Hora em que a solicitação foi executada. |
User_DPID |
Número inteiro |
Uma ID que indica o tipo de IDs de dispositivo contidas na mensagem, na propriedade User.DataPartner_UUID.
|
Client_ID |
String |
Representa a conta de destino na plataforma de destino. Essa ID é originária da plataforma de destino. |
AAM_Destination_ID |
Número inteiro |
A ID do objeto "destination" do Audience Manager. Essa ID é originária do Audience Manager. |
User_count |
Número inteiro |
Número total de usuários na |
Users |
Matriz |
Uma matriz de objetos do usuário. Por padrão, cada mensagem conterá entre 1 e 10 usuários, para manter o tamanho ideal da mensagem. |
User.AAM_UUID |
String |
A variável Audience Manager UUID. |
User.DataPartner_UUID |
String |
UUID da plataforma de destino ou ID do dispositivo global. |
User.AAM_Regions |
Matriz | A variável Audience Manager ID da região na qual vimos este dispositivo. Por exemplo, se o dispositivo tivesse alguma atividade em Paris (Europa), a ID da região seria 6 . Consulte IDs da região do DCS, locais e nomes de host. |
Segments |
Matriz |
Uma matriz de objetos de segmento. Para mensagens em tempo real, a matriz contém todos os segmentos aos quais o usuário pertence. Para mensagens em lote, a matriz contém somente alterações de segmento desde o último lote. |
Segment.Segment_ID |
Número inteiro |
O identificador do segmento. Na maioria dos casos, essa é a ID de segmento gerada pelo Audience Manager (um número inteiro). Em alguns casos, se a plataforma de destino permitir, os clientes poderão definir o identificador de segmento na interface do usuário do Audience Manager (campo de texto aberto), que será refletido nessa propriedade. |
Segment.Status |
Número inteiro |
Define o status de um usuário no segmento. Aceita os seguintes valores:
Os usuários não são segmentados quando:
Todas as IDs de parceiros sincronizadas com um Audience Manager A ID receberá a |
Segment.DateTime |
DateTime |
A hora em que a qualificação do segmento de usuário foi verificada mais recentemente. |
Você pode proteger seu processo de transferência de dados de saída em tempo real assinatura de solicitações HTTP usando chaves privadas ou tendo Audience Manager autenticar por meio da OAuth 2.0 protocolo.
Uma solicitação em tempo real pode ser semelhante ao seguinte:
{
"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"
}]
}]
}