Show Menu
TÓPICOS×

Transferências de dados de saída em tempo real

O processo de transferência de dados em tempo real de saída fornece dados do usuário como uma série de mensagens JSON formatadas para uma plataforma de destino.

Recomendações

Para usar esse método, a plataforma de destino deve atender aos seguintes requisitos:
  • Deve fornecer um terminal URL que possa ser dimensionado para receber um grande volume de mensagens do Audience Manager;
  • Deve aceitar os dados no JSON formato ( Content-type: application/json );
  • Tem de aceitar transferências de HTTPS dados seguras. Audience Manager não enviará mensagens através do HTTP protocolo inseguro.

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 estiver online e ativamente visível à 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.

Transferências em lote

As transferências em tempo real e em lote são enviadas para o mesmo terminal 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 inqualificações) que foram alteradas desde que o último lote foi entregue.

Limites de taxa

Não há limites de taxa definidos na saída de mensagens entregues. A definição de limites de taxa pode levar à perda de dados.

Respostas Obrigatórias

Por padrão, o servidor destinatário deve retornar o 200 OK código para indicar o recebimento bem-sucedido. Outros códigos serão interpretados como falhas. Esta resposta é esperada dentro de 3000 milissegundos. Em resposta a uma falha, Audience Manager fará apenas uma tentativa.

Parâmetros

A tabela a seguir define os elementos no arquivo de JSON dados que você envia para o 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.
  • IDs do Android (GAID): 20914
  • IDs do iOS (IDFA): 20915
  • IDs da Web/Cookie: varia de acordo com a plataforma de destino
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 "destino" do Audience Manager. Essa ID é originária do Audience Manager.
User_count
Número inteiro
Número total de usuários na POST solicitação.
Users
Matriz
Uma matriz de objetos de usuário. Por padrão, cada mensagem conterá entre 1 e 10 usuários, para manter o tamanho da mensagem ótimo.
User.AAM_UUID
String
O Audience Manager UUID.
User.DataPartner_UUID
String
UUID da plataforma de destino ou a ID do dispositivo global.
User.AAM_Regions Matriz A ID da região do Audience Manager onde 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.
Segmnent.Segment_ID
Número inteiro
O identificador do segmento. Na maioria dos casos, essa é a ID do segmento gerada pelo Audience Manager (um número inteiro). Em alguns casos, se a plataforma de destino permitir, os clientes podem definir o identificador de segmento na interface do usuário do Audience Manager (campo de texto aberto), que deve ser refletido nessa propriedade.
Segment.Status
Número inteiro
Define o status de um usuário no segmento. Aceita os seguintes valores:
  • 1 : Ativo (padrão)
  • 0 : Inativo, excluído 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 Explicação do tempo de vida do segmento e da característica de tempo para vida 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 (isto é, RGPD )
Todas as IDs de parceiro sincronizadas com uma ID do Audience Manager receberão o "Status":"0" sinalizador quando um usuário não estiver segmentado.
Segment.DateTime
DateTime
A hora em que a qualificação do segmento de usuário foi verificada recentemente.

Segurança

Você pode proteger seu processo de transferência de dados de saída em tempo real assinando solicitações HTTP usando chaves privadas ou Audience Manager autenticando pelo 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"
        }]
    }]
}