Show Menu
ARGOMENTI×

Trasferimenti dati in uscita in tempo reale

Il processo di trasferimento dei dati in tempo reale in uscita restituisce i dati dell'utente come una serie di JSON oggetti passati con un POST metodo.

Consigli

Per utilizzare questo metodo, consigliamo al partner dati di:
  • Accetta i dati in JSON formato.
  • Fornisce un URL che può essere utilizzato dalla POST chiamata per restituire i dati.
  • Accetta trasferimenti HTTPS di dati sicuri. Audience Manager non invierà questo file con il HTTP protocollo non sicuro.

Frequenza

Questo metodo di trasferimento dei dati può inviare dati in tempo quasi reale, in quanto gli utenti sono idonei per i segmenti. Inoltre, questo metodo può inviare batch di dati offline o caricati con la stessa frequenza che ogni 24 ore.

Risposte richieste

Per impostazione predefinita, il server destinatario deve restituire il 200 OK codice per indicare l'avvenuta ricezione. Altri codici saranno interpretati come errori. Questa risposta è prevista entro 3000 millisecondi. In risposta a un errore, Audience Manager verrà eseguito solo 1 tentativo.

Parametri

La tabella seguente definisce gli elementi nel file di JSON dati restituito.
Parametro Tipo di dati Descrizione
ProcessTime
DateTime
Ora di esecuzione della richiesta.
User_DPID
Intero
Un ID che indica se il file contiene ID Android o iOS. Utilizza i seguenti valori ID:
  • ID Android (GAID): 2014
  • ID iOS (IDFA): 2015
Client_ID
Stringa
ID client utilizzato dal sistema a cui si inviano i dati.
AAM_Destination_ID
Intero
L’ID assegnato al partner di destinazione.
Numero_utente
Intero
Numero totale di utenti nella richiesta POST .
Utenti
Array
Un array di oggetti utente.
AAM_UID
Stringa
L’UUID Audience Manager .
DataPartner_UID
Stringa
UUID partner dati. Lascia vuoto se il tuo partner dati non ha un UUID.
AAM_Region Array L'ID di regione di Audience Manager in cui abbiamo visto questo dispositivo. Ad esempio, se il dispositivo aveva qualche attività a Parigi (Europa), l'ID di regione sarebbe 6 . Consulta ID regioni DCS, posizioni e nomi host .
Segmenti
Array
Un array di oggetti segmento.
Segment_ID
Intero
Mappatura destinazione ID segmento.
Stato
Intero
Definisce lo stato di un utente nel segmento. Accetta quanto segue:
  • 1 : Attivo (predefinito)
  • 0 : Inattivo, escluso o non segmentato.
Gli utenti non sono segmentati quando:
  • Rimosso da un segmento in base alla regola del segmento.
  • Rimosso da un segmento in base all'intervallo time-to-live del segmento .
  • Spostato in uno stato inattivo se non è stato visualizzato negli ultimi 120 giorni.
Tutti gli ID partner sincronizzati con un ID Audience Manager riceveranno il flag "Status":"0" quando un utente non è segmentato.
DateTime
DateTime
Ora della qualifica del segmento più recente.

Sicurezza

È possibile proteggere il processo di trasferimento dei dati in uscita in tempo reale firmando richieste HTTP utilizzando chiavi private o mediante l' Audience Manager autenticazione tramite il protocollo OAuth 2.0 .

Esempio di codice

Una risposta dati in tempo reale può avere un aspetto simile al seguente:
{
"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"
        }]
    }]
}