DokumentationAudience ManagerBenutzerhandbuch für Audience Manager

Ausgehende Datenübertragungen in Echtzeit real-time-outbound-data-transfers

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Der ausgehende Echtzeit-Datenübertragungsprozess stellt Benutzerdaten als eine Reihe JSON formatierten Nachrichten an eine Zielplattform bereit.

Empfehlungen

Um diese Methode verwenden zu können, muss die Zielplattform die folgenden Anforderungen erfüllen:

  • Sie muss eine Endpunkt-URL bereitstellen, die für den Empfang einer großen Anzahl von Nachrichten von Audience Manager skalierbar ist.
  • Sie muss Daten im JSON Format (Content-type: application/json) akzeptieren.
  • Sie muss sichere HTTPS Datenübertragungen akzeptieren. Audience Manager senden keine Nachrichten über das Protokoll „Unsicheres HTTP".

Häufigkeit

Diese Datenübertragungsmethode kann Daten nahezu in Echtzeit senden, da Benutzende für Segmente qualifiziert sind. Echtzeitnachrichten werden nur dann bereitgestellt, wenn der/die Benutzende online ist und im Audience Manager Edge-Netzwerk aktiv angezeigt wird. Optional kann diese Methode auch Batches von Offline- oder Onboarding-Daten so häufig wie alle 24 Stunden senden.

Batch-Übertragungen

Sowohl Echtzeit- als auch Batch-Übertragungen werden an denselben Endpunkt gesendet und verwenden dasselbe Nachrichtenformat. Wenn Batch-Übertragungen aktiviert sind, weist die Zielplattform beim Versand der Batch-Nachrichten eine Spitze beim Nachrichtenvolumen auf. Viele der Segmentqualifikationen, die über Echtzeitnachrichten gesendet werden, werden in den Batch-Nachrichten wiederholt. Stapelübertragungen umfassen nur die Segmentqualifikationen (oder Aufhebungen von Qualifikationen), die sich seit der letzten Batch-Lieferung geändert haben.

Ratenbeschränkungen

Für den Durchsatz der zugestellten Nachrichten wurden keine Ratenbeschränkungen festgelegt. Das Festlegen von Ratenbeschränkungen kann zu Datenverlust führen.

Erforderliche Antworten

Standardmäßig muss der Empfänger-Server den 200 OK-Code zurückgeben, um einen erfolgreichen Empfang anzuzeigen. Andere Codes werden als Fehler interpretiert. Diese Antwort wird innerhalb von 3000 Millisekunden erwartet. Als Reaktion auf einen Fehler unternimmt Audience Manager nur einen Wiederholungsversuch.

Parameter

In der folgenden Tabelle werden die Elemente in der JSON-Datendatei definiert, die Sie an das Ziel senden.

Parameter
Datentyp
Beschreibung
ProcessTime
DateTime
Zeitpunkt, zu dem die Anfrage ausgeführt wurde.
User_DPID
Ganzzahl

Eine ID, die den Typ der in der Nachricht enthaltenen Geräte-IDs in der Eigenschaft User.DataPartner_UUID angibt.

  • Android-IDs (GAID): 20914
  • iOS-IDs (IDFA): 20915
  • Web-/Cookie-IDs: variiert je nach Zielplattform
Client_ID
Zeichenfolge
Stellt das Zielkonto in der Zielplattform dar. Diese ID stammt von der Zielplattform.
AAM_Destination_ID
Ganzzahl
Die ID des Audience Manager-„Ziel“-Objekts. Diese ID stammt aus Audience Manager.
User_count
Ganzzahl
Gesamtzahl der Benutzer in der POST.
Users
Array
Ein Array von Benutzerobjekten. Standardmäßig enthält jede Nachricht zwischen 1 und 10 Benutzer, um die Nachrichtengröße optimal zu halten.
User.AAM_UUID
Zeichenfolge
Die Audience Manager UUID.
User.DataPartner_UUID
Zeichenfolge
Zielplattform-UUID oder die globale Geräte-ID.
User.AAM_Regions
Array
Die Audience Manager-Regions-ID, in der wir dieses Gerät gesehen haben. Wenn das Gerät beispielsweise in Paris (Europa) aktiv war, würde die Regions-ID 6. Siehe von DCS-Regions-IDs, Standorten und Hostnamen.
Segments
Array
Ein Array von Segmentobjekten. Bei Echtzeitnachrichten enthält das Array alle Segmente, zu denen der Benutzer gehört. Bei Batch-Nachrichten enthält das -Array nur Segmentänderungen seit dem letzten Batch.
Segment.Segment_ID
Ganzzahl
Die Kennung für das Segment. In den meisten Fällen ist dies die von Audience Manager generierte Segment-ID (eine Ganzzahl). Wenn es die Zielplattform zulässt, können Kundinnen und Kunden in einigen Fällen die Segmentkennung in der Audience Manager-Benutzeroberfläche definieren (offenes Textfeld), die dann in dieser Eigenschaft widergespiegelt wird.
Segment.Status
Ganzzahl

Definiert den Status eines Benutzers im Segment. Akzeptiert die folgenden Werte:

  • 1: Aktiv (Standard)
  • 0: Inaktiv, Abgewählt oder nicht segmentiert.

Benutzende werden nicht segmentiert, wenn sie:

  • Aus einem Segment entfernt, basierend auf der Segmentregel.
  • Aus einem Segment entfernt, basierend auf dem Time-to-Live-IntervallSegments.
  • In einen inaktiven Status verschoben, wenn sie in den letzten 120 Tagen nicht gesehen wurden.
  • Wegen einer Datenschutzänderungsanfrage (d. h. DSGVO)

Alle Partner-IDs, die mit einer Audience Manager ID synchronisiert werden, erhalten die "Status":"0"-Markierung, wenn eine Benutzerin oder ein Benutzer nicht segmentiert ist.

Segment.DateTime
DateTime
Der Zeitpunkt, zu dem die Benutzersegmentqualifikation zuletzt überprüft wurde.

Sicherheit

Sie können Ihren in Echtzeit ausgehenden Datenübertragungsprozess schützen, indem Sie HTTP-Anfragen signieren private Schlüssel verwenden oder sich über das Audience ManagerOAuth 2.0-Protokoll authentifizieren ​.

Anfrage

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