Show Menu
THEMEN×

Ausgehende Datenübertragungen in Echtzeit

Der ausgehende Echtzeit-Datenübertragungsprozess liefert Benutzerdaten als eine Reihe JSON formatierter Nachrichten an eine Zielplattform.

Empfehlungen

Um diese Methode zu verwenden, muss die Zielplattform die folgenden Anforderungen erfüllen:
  • Es muss einen Endpunkt bereitstellen, URL der skalierbar sein kann, um ein hohes Volumen an Nachrichten von Audience Manager zu empfangen.
  • Sie muss Daten im JSON Format ( Content-type: application/json ) annehmen.
  • Es muss sichere HTTPS Datenübertragungen akzeptieren. Audience Manager sendet keine Nachrichten über das unsichere HTTP Protokoll.

Häufigkeit

Mit dieser Datenübertragungsmethode können Daten in Echtzeit gesendet werden, wenn Benutzer sich für Segmente qualifizieren. Echtzeit-Nachrichten werden nur gesendet, wenn der Benutzer online ist und aktiv für das Edge-Netzwerk des Audience Managers sichtbar ist. Optional kann diese Methode auch Stapel von Offline- oder Onboarded-Daten so oft wie alle 24 Stunden senden.

Stapelübertragungen

Sowohl Echtzeit- als auch Batch-Übertragungen werden an denselben Endpunkt gesendet und verwenden dasselbe Nachrichtenformat. Wenn Batch-Transfers aktiviert sind, wird der Zielplattform eine Spitze des Nachrichtenvolumens angezeigt, während die Batch-Nachrichten gesendet werden. Viele der Segmentqualifikationen, die durch Echtzeitmeldungen gesendet werden, werden in den Batch-Nachrichten wiederholt. Bei der Stapelübertragung werden nur die Segmentqualifikationen (oder Unqualifikationen) berücksichtigt, die sich seit der letzten Charge geändert haben.

Ratenbeschränkungen

Für den Durchsatz bereitgestellter Nachrichten gibt es keine Ratenbeschränkungen. Das Festlegen von Ratenbeschränkungen könnte zu Datenverlusten führen.

Erforderliche Antworten

Standardmäßig muss der Empfänger-Server 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 JSON Datendatei, die Sie an das Ziel senden.
Parameter Datentyp Beschreibung
ProcessTime
DateTime
Zeitpunkt, zu dem die Anforderung ausgeführt wurde.
User_DPID
Ganzzahl
Eine ID, die den Typ der Geräte-IDs angibt, die in der Meldung in der Eigenschaft User.DataPartner_UUID enthalten sind.
  • Android-IDs (GAID): 20914
  • iOS-IDs (IDFA): 20915
  • Web-/Cookie-IDs: variiert nach Zielplattform
Client_ID
Zeichenfolge
Stellt das Zielgruppen-Konto in der Zielplattform dar. Diese ID stammt von der Zielplattform.
AAM_Destination_ID
Ganzzahl
Die ID des Audience Manager-"target"-Objekts. Diese ID stammt von Audience Manager.
User_count
Ganzzahl
Gesamtzahl der Benutzer in der POST Anforderung.
Users
Array
Ein Array von Benutzerobjekten. Standardmäßig enthält jede Nachricht 1 bis 10 Benutzer, damit die Nachrichtengröße optimal bleibt.
User.AAM_UUID
Zeichenfolge
Der Audience Manager HAT SICH GEEIGNET.
User.DataPartner_UUID
Zeichenfolge
UUID der Zielplattform oder der globalen Geräte-ID.
User.AAM_Regions Array Die Audience Manager -Regions-ID, auf der wir dieses Gerät gesehen haben. Wenn das Gerät z. B. in Paris (Europa) eine Aktivität hätte, wäre die Regions-ID 6 . Siehe DCS Region IDs, Locations, and Host Names .
Segments
Array
Ein Array von Segmentobjekten. Bei Echtzeitmeldungen enthält das Array alle Segmente, denen der Benutzer angehört. Bei Stapelmeldungen enthält das Array nur Segmentänderungen seit dem letzten Stapel.
Segmnent.Segment_ID
Ganzzahl
Der Bezeichner für das Segment. In den meisten Fällen ist dies die vom Audience Manager generierte Segment-ID (eine Ganzzahl). In einigen Fällen können Kunden, sofern die Zielplattform dies zulässt, die Segmentkennung in der Benutzeroberfläche des Audience Managers definieren (Open Text Field), die dann in dieser Eigenschaft übernommen wird.
Segment.Status
Ganzzahl
Definiert den Status eines Benutzers im Segment. Akzeptiert die folgenden Werte:
  • 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.
  • Aufgrund einer Datenschutzdatenschutzanforderung entfernt (d.h. GDPR )
Alle Partner-IDs, die mit einer Audience Manager -ID synchronisiert werden, erhalten das "Status":"0" Flag, wenn ein Benutzer nicht segmentiert ist.
Segment.DateTime
DateTime
Der Zeitpunkt, zu dem die Qualifizierung des Benutzersegments zuletzt überprüft wurde.

Sicherheit

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

Anfrage

Eine Echtzeitanforderung 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",
   "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"
        }]
    }]
}