Trasferimenti di dati in uscita in tempo reale

Il processo di trasferimento dei dati in tempo reale in uscita fornisce i dati utente come una serie di messaggi JSON formattati a una piattaforma di destinazione.

Consigli

Per utilizzare questo metodo, la piattaforma di destinazione deve soddisfare i seguenti requisiti:

• deve fornire un endpoint URL che può essere ridimensionato in modo da ricevere un volume elevato di messaggi Audience Manager;
• Deve accettare i dati in formato JSON (Content-type: application/json);
• Deve accettare trasferimenti di dati HTTPS sicuri. Audience Manager non invierà messaggi tramite 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. I messaggi in tempo reale vengono inviati solo mentre l'utente è online e attivo visibile sulla rete Edge del Audience Manager . Facoltativamente, questo metodo può anche inviare batch di dati offline o caricati con la stessa frequenza con cui ogni 24 ore.

Trasferimenti batch

I trasferimenti in tempo reale e in batch vengono inviati allo stesso endpoint e utilizzano lo stesso formato di messaggio. Quando sono abilitati i trasferimenti batch, la piattaforma di destinazione visualizzerà un picco nel volume dei messaggi mentre i messaggi batch vengono inviati. Molte delle qualifiche del segmento inviate tramite messaggi in tempo reale verranno ripetute nei messaggi batch. I trasferimenti batch includeranno solo le qualifiche del segmento (o le qualifiche non qualificate) che sono state modificate dall'ultima consegna del batch.

Limiti di velocità

Non sono impostati limiti di velocità per il throughput dei messaggi eliminati. La fissazione di limiti di velocità potrebbe comportare una perdita di dati.

Risposte richieste

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

Parametri

La tabella seguente definisce gli elementi nel file di dati JSON che si invia alla destinazione.

Sicurezza

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

Richiesta

Una richiesta 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",
   "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"
        }]
    }]
}