DokumentationAudience ManagerBenutzerhandbuch für Audience Manager

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

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Der ausgehende Echtzeit-Datenübertragungsprozess stellt Benutzerdaten als eine Reihe von 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 einen Endpunkt URL bereitstellen, der skaliert werden kann, um eine große Anzahl von Nachrichten von Audience Manager zu erhalten.
  • Es muss Daten im Format JSON (Content-type: application/json) akzeptieren.
  • Es muss sichere HTTPS Datenübertragungen akzeptieren. Audience Manager sendet keine Nachrichten über das 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 den Code 200 OK zurückgeben, um den 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

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 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-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 UUID Audience Manager .
User.DataPartner_UUID
Zeichenfolge
Ziel-Plattform-UUID oder die globale Geräte-ID.
User.AAM_Regions
Array
Die Regions-ID Audience Manager, in der wir dieses Gerät gesehen haben. Wenn das Gerät beispielsweise eine Aktivität in Paris (Europa) aufweist, 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 dem Time-to-Live-Intervall des Segments basiert.
  • 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 -ID synchronisiert werden, erhalten die "Status":"0" -Markierung, wenn die Segmentierung eines Benutzers aufgehoben wird.

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-Anfragen mit privaten Schlüsseln oder durch die Authentifizierung von Audience Manager über das Protokoll OAuth 2.0 sichern.

Anfrage

Eine Echtzeitanforderung 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