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 formattati JSON a una piattaforma di destinazione.

Consigli

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

  • Deve fornire un endpoint URL scalabile in modo da ricevere un elevato volume di messaggi dall'Audience Manager;
  • Accetta 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 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.

Trasferimenti in batch

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.

Limiti di velocità

Non sono impostati limiti di velocità sulla velocità effettiva dei messaggi eliminati. L'impostazione di limiti di velocità potrebbe causare la perdita di dati.

Risposte richieste

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

Parametri

La tabella seguente definisce gli elementi nel file di dati JSON inviato 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.

  • ID Android (GAID): 20914
  • ID iOS (IDFA): 20915
  • ID web/cookie: varia in base alla piattaforma di destinazione
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 nella richiesta POST.

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

L' Audience Manager UUID.

User.DataPartner_UUID

Stringa

UUID della piattaforma di destinazione o ID dispositivo globale.

User.AAM_Regions Array L' ID di regione Audience Manager in cui è stato visualizzato 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.

Segmnent.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:

  • 1: Attivo (predefinito)
  • 0: Inattivo, disattivato o non segmentato.

Gli utenti non sono segmentati quando sono:

  • Rimosso da un segmento in base alla regola del segmento.
  • Rimosso da un segmento in base all’ intervallo time-to-live del segmento.
  • Se non sono stati visualizzati negli ultimi 120 giorni, lo stato attivo viene spostato in uno stato inattivo.
  • Rimosso a causa di una richiesta di modifica della privacy (cioè RGPD)

Tutti gli ID partner sincronizzati con un ID Audience Manager riceveranno il flag "Status":"0" quando un utente non è segmentato.

Segment.DateTime

DateTime

Data e ora dell’ultima verifica della qualifica del segmento utente.

Sicurezza

Puoi proteggere il processo di trasferimento dei dati in uscita in tempo reale firmando richieste HTTP utilizzando chiavi private o facendo sì che Audience Manager sia autenticato 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"
        }]
    }]
}

In questa pagina