DocumentazioneAudience ManagerGuida utente di Audience Manager

Trasferimenti di dati in uscita in tempo reale real-time-outbound-data-transfers

Last update: Sat May 20 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Il processo di trasferimento dei dati in uscita in tempo reale fornisce dati utente sotto forma di JSON i messaggi formattati su una piattaforma di destinazione.

Consigli

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

  • Deve fornire un endpoint URL che possono essere adattati per ricevere un elevato volume di messaggi da Audienci Manager;
  • Deve accettare i dati in JSON formato (Content-type: application/json);
  • Deve accettare una protezione HTTPS trasferimenti di dati. Audience Manager non invierà messaggi tramite unsecure HTTP protocollo.

Frequenza

Questo metodo di trasferimento dati può inviare i dati quasi in tempo reale, in quanto gli utenti si qualificano per i segmenti. I messaggi in tempo reale vengono consegnati solo quando l’utente è online e visibile attivamente alla rete Edge di Audience Manager. Facoltativamente, questo metodo può anche inviare batch di dati offline o onboarded ogni 24 ore.

Trasferimenti in batch

I trasferimenti in tempo reale e batch vengono inviati allo stesso endpoint e utilizzano lo stesso formato di messaggio. Quando i trasferimenti batch sono abilitati, la piattaforma di destinazione visualizza 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 non qualifiche) che sono cambiate dall’ultimo batch consegnato.

Limiti di velocità

Non sono stati impostati limiti di velocità per la trasmissione dei messaggi recapitati. L’impostazione dei limiti di velocità potrebbe causare la perdita di dati.

Risposte richieste

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

Parametri

La tabella seguente definisce gli elementi nel JSON file di dati inviato alla destinazione.

Parametro
Tipo di dati
Descrizione
ProcessTime
DateTime
Ora in cui è stata eseguita la richiesta.
User_DPID
Intero

ID che indica il tipo di ID dispositivo contenuti 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 "destination" di Audience Manager. Questo ID ha origine da Audience Manager.
User_count
Intero
Numero totale di utenti nel POST richiesta.
Users
Array
Matrice di oggetti utente. Per impostazione predefinita, ogni messaggio contiene da 1 a 10 utenti, per mantenerne una dimensione ottimale.
User.AAM_UUID
Stringa
Il Audience Manager UUID.
User.DataPartner_UUID
Stringa
UUID della piattaforma di destinazione o ID del dispositivo globale.
User.AAM_Regions
Array
Il Audience Manager ID di regione in cui abbiamo visto questo dispositivo. Ad esempio, se il dispositivo avesse un’attività a Parigi (Europa), l’ID regione sarebbe 6. Consulta ID regioni DCS, posizioni e nomi host.
Segments
Array
Array 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 dei segmenti rispetto all’ultimo batch.
Segment.Segment_ID
Intero
L’identificatore del segmento. Nella maggior parte dei casi, si tratta dell’ID del segmento generato da 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 si rifletterebbe in questa proprietà.
Segment.Status
Intero

Definisce lo stato di un utente nel segmento. Accetta i seguenti valori:

  • 1: Attivo (impostazione predefinita)
  • 0: inattiva, con rinuncia o non segmentata.

Gli utenti vengono rimossi dai segmenti quando sono:

  • Rimosso da un segmento in base alla regola del segmento.
  • Rimosso da un segmento in base al di intervallo time-to-live.
  • Se non sono stati visti negli ultimi 120 giorni, vengono trasferiti a uno stato inattivo.
  • Rimosso a causa di una richiesta di modifica della privacy (ad es. RGPD)

Tutti gli ID partner sincronizzati in un Audience Manager L’ID riceverà "Status":"0" Quando un utente viene rimosso dai segmenti.

Segment.DateTime
DateTime
L’ultima volta che è stata verificata la qualifica utente-segmento.

Sicurezza

Per proteggere il processo di trasferimento dei dati in uscita in tempo reale, utilizza firma delle richieste HTTP utilizzando chiavi private o Audience Manager autenticare tramite OAuth 2.0 protocollo.

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"
        }]
    }]
}
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695