DokumentationAudience ManagerBenutzerhandbuch für Audience Manager

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

Last update: Wed Oct 12 2022 00:00:00 GMT+0000 (Coordinated Universal Time)

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

Empfehlungen

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

  • Sie muss einen Endpunkt bereitstellen URL die skaliert werden können, um eine große Anzahl von Nachrichten von Audience Manager zu erhalten;
  • Sie muss Daten in JSON format (Content-type: application/json);
  • Sie muss sicher sein HTTPS Datenübertragungen. Audience Manager sendet keine Nachrichten über die unsichere HTTP Protokoll.

Häufigkeit

Diese Datenübertragungsmethode kann Daten nahezu in Echtzeit senden, da sich Benutzer für Segmente qualifizieren. Echtzeit-Nachrichten werden nur gesendet, wenn der Benutzer online ist und für das Audience Manager-Edge-Netzwerk aktiv sichtbar ist. Optional kann diese Methode auch Batches von Offline- oder integrierten Daten so oft 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, wird auf der Zielplattform beim Versand der Batch-Nachrichten ein Anstieg des Nachrichtenvolumens festgestellt. Viele der Segmentqualifikationen, die über Echtzeit-Nachrichten gesendet werden, werden in den Batch-Nachrichten wiederholt. Batch-Übertragungen umfassen nur die Segmentqualifikationen (oder Nicht-Qualifikationen), die sich seit der letzten Batch-Bereitstellung geändert haben.

Ratenbeschränkungen

Für den Durchsatz gesendeter Nachrichten gelten keine Ratenbeschränkungen. Das Festlegen von Ratenbeschränkungen könnte zu Datenverlust führen.

Erforderliche Antworten

Standardmäßig muss der Empfängerserver die 200 OK Code, um den erfolgreichen Empfang anzuzeigen. Andere Codes werden als Fehler interpretiert. Diese Antwort wird innerhalb von 3000 Millisekunden erwartet. Als Reaktion auf einen Fehler Audience Manager wird nur einen Wiederholungsversuch unternehmen.

Parameter

Die folgende Tabelle definiert die Elemente in der JSON -Datendatei, die Sie an das Ziel senden.

Parameter
Datentyp
Beschreibung
ProcessTime
DateTime
Zeitpunkt der Ausführung der Anfrage.
User_DPID
Ganzzahl

Eine ID, die den Typ der Geräte-IDs angibt, die in der Nachricht 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 Zielkonto in der Zielplattform dar. Diese ID stammt von der Zielplattform.
AAM_Destination_ID
Ganzzahl
Die ID des Audience Manager-Objekts "Ziel". Diese ID stammt aus Audience Manager.
User_count
Ganzzahl
Gesamtzahl der Benutzer in der POST -Anfrage.
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
Ziel-Plattform-UUID oder die globale Geräte-ID.
User.AAM_Regions
Array
Die Audience Manager Regions-ID, wo wir dieses Gerät gesehen haben. Wenn das Gerät beispielsweise eine Aktivität in Paris (Europa) hätte, wäre die Regions-ID 6. Siehe DCS Region IDs, Locations, and Host Names.
Segments
Array
Ein Array von Segmentobjekten. Bei Echtzeit-Nachrichten 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 vom Audience Manager generierte Segment-ID (eine Ganzzahl). In einigen Fällen können Kunden, wenn die Zielplattform dies zulässt, die Segmentkennung in der Audience Manager-Benutzeroberfläche definieren (geöffnetes Textfeld), was 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, abgemeldet oder nicht segmentiert.

Benutzer werden nicht segmentiert, wenn sie:

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

Alle Partner-IDs, die mit einer Audience Manager Die ID erhält die "Status":"0" kennzeichnen, 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übertragungsprozess in Echtzeit durch Signieren von HTTP-Anforderungen Verwendung privater Schlüssel oder Audience Manager über die OAuth 2.0 Protokoll.

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