Show Menu
THEMEN×

Ausgehende Datenübertragungen in Echtzeit

Der ausgehende Echtzeit-Datenübertragungsprozess gibt Benutzerdaten als eine Reihe von JSON Objekten zurück, die mit einer POST Methode übergeben werden.

Empfehlungen

Zur Verwendung dieser Methode empfehlen wir Ihrem Datenpartner,
  • Akzeptiert Daten im JSON Format.
  • Stellt eine URL bereit, die vom POST Aufruf zum Zurückgeben von Daten verwendet werden kann.
  • Akzeptiert sichere HTTPS Datenübertragungen. Audience Manager wird diese Datei nicht mit dem unsicheren HTTP Protokoll senden.

Häufigkeit

Mit dieser Datenübertragungsmethode können Daten in Echtzeit gesendet werden, wenn Benutzer sich für Segmente qualifizieren. Darüber hinaus kann diese Methode Stapel von Offline- oder Onboarded-Daten genauso oft wie alle 24 Stunden senden.

Erforderliche Antworten

Standardmäßig muss der Empfängerserver den 200 OK Code zurückgeben, um eine erfolgreiche Quittung anzuzeigen. Andere Codes werden als Fehler interpretiert. Diese Antwort wird innerhalb von 3000 Millisekunden erwartet. Bei einem Fehler Audience Manager wird nur ein Wiederholungsversuch durchgeführt.

Parameter

Die folgende Tabelle definiert die Elemente in der zurückgegebenen JSON Datendatei.
Parameter Datentyp Beschreibung
ProcessTime
DateTime
Zeitpunkt der Ausführung der Anforderung.
user_DPID
Ganzzahl
Eine ID, die angibt, ob die Datei Android- oder iOS-IDs enthält. Verwendet die folgenden ID-Werte:
  • Android-IDs (GAID): 20914
  • iOS-IDs (IDFA): 20915
client_ID
Zeichenfolge
Client-ID, die von dem System verwendet wird, an das Sie Daten senden.
AAM_Destination_ID
Ganzzahl
Die ID, die Ihnen von Ihrem Zielpartner zugewiesen wurde.
User_count
Ganzzahl
Gesamtzahl der Benutzer in der POST -Anforderung.
Benutzer
Array
Ein Array von Benutzerobjekten.
AAM_UUID
Zeichenfolge
Die UUID für Audience Manager .
DataPartner_UUID
Zeichenfolge
UUID des Datenpartners. Lassen Sie das Feld leer, wenn Ihr Datenpartner keine UUID hat.
AAM_Regions Array Die Audience Manager -Regions-ID, in der wir dieses Gerät gesehen haben. Wenn das Gerät z. B. in Paris (Europa) aktiv wäre, wäre die Regions-ID 6 . Siehe DCS Region IDs, Locations, and Host Names .
Segmente
Array
Ein Array von Segmentobjekten.
Segment_ID
Ganzzahl
Die Segment-ID-Zielzuordnung.
Status
Ganzzahl
Definiert den Status eines Benutzers im Segment. akzeptiert Folgendes:
  • 1 : Aktiv (Standard)
  • 0 : Inaktiv, ausgeschaltet oder nicht segmentiert.
Benutzer sind nicht segmentiert, wenn sie:
  • Aus einem Segment entfernt, das auf der Segmentregel basiert.
  • Aus einem Segment entfernt, basierend auf dem Time-to-Live-Intervall des Segments.
  • In einen inaktiven Status verschoben, wenn sie in den letzten 120 Tagen nicht gesehen wurden.
Alle Partner-IDs, die mit einer Audience Manager -ID synchronisiert werden, erhalten das Flag "Status":"0" , wenn ein Benutzer nicht segmentiert ist.
DateTime
DateTime
Der Zeitpunkt der letzten Segmentqualifizierung.

Sicherheit

Sie können Ihren ausgehenden Datenübertragungsprozess in Echtzeit durch Signieren von HTTP-Anfragen mit privaten Schlüsseln oder durch Audience Manager Authentifizierung über das OAuth 2.0 -Protokoll sichern.

Codebeispiel

Eine Echtzeitdatenantwort kann wie folgt aussehen:
{
"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"
        }]
    }]
}