Ausgehende Datenübertragungen in Echtzeit

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

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 ein hohes Volumen an Nachrichten von Audience Manager zu erhalten.
  • Sie muss Daten im JSON-Format (Content-type: application/json) akzeptieren.
  • Sie 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 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 des Audience Managers .

User.DataPartner_UUID

Zeichenfolge

Ziel-Plattform-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 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.

Segmnent.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 in Echtzeit ausgehenden Datenübertragungsprozess durch Signieren von HTTP-Anfragen mithilfe privater Schlüssel oder durch die Authentifizierung von Audience Manager über das Protokoll OAuth 2.0 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"
        }]
    }]
}

Auf dieser Seite