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 retorna os dados do usuário como uma série de JSON objetos passados com um POST método.

Recomendações

Para usar esse método, recomendamos que seu parceiro de dados:
  • Aceita dados no JSON formato.
  • Fornece um URL que pode ser usado pela POST chamada para retornar dados.
  • Aceita transferências de HTTPS dados seguras. Audience Manager não enviará este arquivo com o 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. Além disso, esse método pode enviar lotes de dados offline ou integrados com uma frequência de 24 horas.

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 1 tentativa.

Parâmetros

A tabela a seguir define os elementos no arquivo de JSON dados retornado.
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 se o arquivo contém IDs do Android ou iOS. Usa os seguintes valores de ID:
  • IDs do Android (GAID): 2014
  • IDs do iOS (IDFA): 2015
Client_ID
String
ID do cliente usada pelo sistema para o qual você está enviando dados.
AAM_Destination_ID
Número inteiro
A ID atribuída a você pelo parceiro de destino.
User_count
Número inteiro
Número total de usuários na solicitação POST .
Usuários
Matriz
Uma matriz de objetos de usuário.
AAM_UUID
String
O Audience Manager UUID.
DataPartner_UUID
String
UUID do parceiro de dados. Deixe em branco se seu parceiro de dados não tiver um UUID.
AAM_Regiões 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 .
Segmentos
Matriz
Uma matriz de objetos de segmento.
Segment_ID
Número inteiro
O mapeamento de destino da ID do segmento.
Status
Número inteiro
Define o status de um usuário no segmento. Aceita o seguinte:
  • 1 : Ativo (padrão)
  • 0 : Inativo, excluído ou não segmentado.
Os usuários não são segmentados quando:
Todas as IDs de parceiro sincronizadas com uma ID do Audience Manager receberão o sinalizador "Status":"0" quando um usuário não estiver segmentado.
DateTime
DateTime
A hora da qualificação de segmento mais recente.

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 .

Amostra de código

Uma resposta de dados 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",
   "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"
        }]
    }]
}