Il processo di trasferimento dei dati in tempo reale in uscita fornisce i dati utente come serie di JSON messaggi formattati in una piattaforma di destinazione.
Per utilizzare questo metodo, la piattaforma di destinazione deve soddisfare i seguenti requisiti:
Content-type: application/json
);HTTPS
trasferimenti di dati. Audience Manager non invierà i messaggi tramite la modalità non protetta HTTP
protocollo.Questo metodo di trasferimento dati può inviare dati in tempo quasi reale, in quanto gli utenti si qualificano per i segmenti. I messaggi in tempo reale vengono inviati solo quando l’utente è online e attivamente visibile alla rete Audience Manager Edge. Facoltativamente, questo metodo può anche inviare batch di dati offline o onboarded con la stessa frequenza di ogni 24 ore.
I trasferimenti in tempo reale e in batch vengono inviati allo stesso endpoint e utilizzano lo stesso formato di messaggio. Quando i trasferimenti batch sono abilitati, la piattaforma di destinazione visualizzerà un picco nel volume dei messaggi durante la consegna dei messaggi batch. Molte delle qualifiche dei segmenti inviate tramite messaggi in tempo reale verranno ripetute nei messaggi batch. I trasferimenti in batch includeranno solo le qualifiche del segmento (o le qualifiche) modificate dall'ultimo batch consegnato.
Non sono impostati limiti di velocità sulla velocità effettiva dei messaggi eliminati. L'impostazione di limiti di velocità potrebbe causare la perdita di dati.
Per impostazione predefinita, il server destinatario deve restituire 200 OK
codice per indicare l'avvenuta ricezione. Altri codici verranno interpretati come errori. Questa risposta è prevista entro 3000 millisecondi. In risposta a un errore, Audience Manager effettuerà un solo tentativo.
La tabella seguente definisce gli elementi nel JSON file di dati inviati alla destinazione.
Parametro | Tipo di dati | Descrizione |
---|---|---|
ProcessTime |
DateTime |
Ora di esecuzione della richiesta. |
User_DPID |
Intero |
Un ID che indica il tipo di ID dispositivo contenuto nel messaggio, nella proprietà User.DataPartner_UUID.
|
Client_ID |
Stringa |
Rappresenta l'account di destinazione nella piattaforma di destinazione. Questo ID proviene dalla piattaforma di destinazione. |
AAM_Destination_ID |
Intero |
ID dell'oggetto "destinazione" di Audience Manager. L'ID proviene dall'Audience Manager. |
User_count |
Intero |
Numero totale di utenti nel |
Users |
Array |
Matrice di oggetti utente. Per impostazione predefinita, ogni messaggio contiene da 1 a 10 utenti, per mantenere la dimensione ottimale del messaggio. |
User.AAM_UUID |
Stringa |
La Audience Manager UUID. |
User.DataPartner_UUID |
Stringa |
UUID della piattaforma di destinazione o ID dispositivo globale. |
User.AAM_Regions |
Array | La Audience Manager ID di regione in cui abbiamo visto questo dispositivo. Ad esempio, se il dispositivo ha un’attività a Parigi (Europa), l’ID di regione è 6 . Consulta ID regioni DCS, posizioni e nomi host. |
Segments |
Array |
Matrice di oggetti segmento. Per i messaggi in tempo reale, l’array contiene tutti i segmenti a cui appartiene l’utente. Per i messaggi batch, l’array contiene solo le modifiche al segmento dall’ultimo batch. |
Segment.Segment_ID |
Intero |
Identificatore del segmento. Nella maggior parte dei casi, si tratta dell’ID del segmento generato dall’Audience Manager (un numero intero). In alcuni casi, se la piattaforma di destinazione lo consente, i clienti possono definire l’identificatore del segmento nell’interfaccia utente di Audience Manager (campo di testo aperto), che rifletterebbe in questa proprietà. |
Segment.Status |
Intero |
Definisce lo stato di un utente nel segmento. Accetta i seguenti valori:
Gli utenti non sono segmentati quando sono:
Tutti gli ID partner sincronizzati in un Audience Manager L'ID riceverà |
Segment.DateTime |
DateTime |
Data e ora dell’ultima verifica della qualifica del segmento utente. |
Puoi proteggere il processo di trasferimento dei dati in uscita in tempo reale tramite richiesta di firma HTTP utilizzando le chiavi private o Audience Manager autenticare tramite OAuth 2.0 protocollo.
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"
}]
}]
}