Transferências de dados de saída em tempo real real-time-outbound-data-transfers
O processo de transferência de dados em tempo real de saída fornece dados do usuário como uma série de JSON mensagens formatadas para uma plataforma de destino.
Recomendações
Para usar esse método, a plataforma de destino deve atender aos seguintes requisitos:
- Ele deve fornecer um ponto de extremidade URL que possa ser dimensionado para receber um grande volume de mensagens do Audience Manager;
- Deve aceitar dados no formato JSON (
Content-type: application/json
); - Ele deve aceitar transferências de dados
HTTPS
seguras. Audience Manager não enviará mensagens por meio do protocoloHTTP
não seguro.
Frequência
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 Audience Manager Edge. 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.
Transferências em lote
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.
Limites de taxa
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.
Respostas necessárias
Por padrão, o servidor de destinatários deve retornar o código 200 OK
para indicar um 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.
Parâmetros
A tabela a seguir define os elementos do arquivo de dados JSON que você envia para o destino.
ProcessTime
User_DPID
Uma ID que indica o tipo de IDs de dispositivo contidas na mensagem, na propriedade User.DataPartner_UUID.
- IDs do Android (GAID):
20914
- IDs do iOS (IDFA):
20915
- IDs da Web/Cookie: varia de acordo com a plataforma de destino
Client_ID
AAM_Destination_ID
User_count
POST
.Users
User.AAM_UUID
User.DataPartner_UUID
User.AAM_Regions
6
. Consulte IDs da região do DCS, locais e nomes de host.Segments
Segment.Segment_ID
Segment.Status
Define o status de um usuário no segmento. Aceita os seguintes valores:
1
: Ativo (padrão)0
: inativo, recusa ou não segmentado.
Os usuários não são segmentados quando:
- Removido de um segmento com base na regra de segmento.
- Removido de um segmento com base no intervalo de vida útil do segmento.
- Movido para um estado inativo se não tiver sido visto nos últimos 120 dias.
- Removido devido a uma solicitação de alteração de privacidade (ou seja, GDPR)
Todas as IDs de parceiros sincronizadas com uma ID de Audience Manager do receberão o sinalizador "Status":"0"
quando um usuário não estiver segmentado.
Segment.DateTime
Segurança
Você pode proteger seu processo de transferência de dados de saída em tempo real assinando solicitações HTTP com chaves privadas ou fazendo com que o Audience Manager seja autenticado por meio do protocolo OAuth 2.0.
Solicitação
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"
}]
}]
}