Nutzerdaten formatieren

Die Data Manager API unterstützt das Hochladen verschiedener Arten von Nutzerdaten. Beachten Sie die Formatierungs-, Hashing- und Codierungsanforderungen für jedes Datenelement, damit Ihre Daten erfolgreich empfangen und verarbeitet werden.

UserData-Anforderungen

Ein UserData-Objekt ist eine Sammlung von UserIdentifier-Objekten. Jede UserIdentifier hat genau eines der Attribute in der folgenden Tabelle.

UserIdentifier
email_address
Format
string
In Kleinbuchstaben umwandeln.
Wenn die E-Mail-Adresse die gmail.com oder googlemail.com Domain hat, entfernen Sie alle Punkte (.) vor dem @-Symbol.
Leerzeichen Entfernen Sie voran- und nachgestellte sowie dazwischen liegende Leerzeichen.
Hashing Mit dem SHA-256-Algorithmus hashen. Die Hash-Bytes mit Hex- oder Base64-Codierung codieren.
phone_number
Format
string
Das E.164-Format verwenden.
Das Pluszeichen (+) und den Ländercode angeben. Alle Zeichen nach dem Pluszeichen müssen Ziffern sein.
Beispiel: Die US-amerikanische Telefonnummer (800)555-0100 sollte als +18005550100 formatiert und normalisiert werden.
Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen.
Hashing Mit dem SHA-256-Algorithmus hashen. Die Hash-Bytes mit Hex- oder Base64-Codierung codieren.
address
AddressInfo -Objekt
Informationen zur Formatierung von AddressInfo

AddressInfo-Format

Verwenden Sie die folgenden Formatierungsrichtlinien, um das Attribut address einer UserIdentifier zu erstellen.

AddressInfo
given_name
Format
string
In Kleinbuchstaben umwandeln.
Keine Anreden wie Mrs. verwenden.
Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen.
Hashing Mit dem SHA-256-Algorithmus hashen. Die Hash-Bytes mit Hex- oder Base64-Codierung codieren.
family_name
Format
string
In Kleinbuchstaben umwandeln.
Keine Namenszusätze wie Jr. verwenden.
Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen.
Hashing Mit dem SHA-256-Algorithmus hashen. Die Hash-Bytes mit Hex- oder Base64-Codierung codieren.
region_code
Format
string
Ein aus zwei Buchstaben bestehender ISO-3166-1 Alpha-2 Code.
Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen.
Hashing region_code nicht hashen.
postal_code
Format
string
Sowohl US-amerikanische als auch internationale Postleitzahlen sind zulässig.
Bei US-amerikanischen Adressen verwenden Sie entweder fünf Ziffern oder fünf Ziffern gefolgt von einer vierstelligen Erweiterung. Durch die Verwendung einer vierstelligen Erweiterung kann sich die Abgleichsrate verbessern.
Für alle anderen Länder dürfen keine Postleitzahl erweiterungen verwendet werden.
Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen.
Hashing postal_code nicht hashen.

PairData-Anforderungen

Füllen Sie das pair_ids Feld eines PairData Objekts mit einer Liste von IDs. Formatieren Sie jedes Element in der Liste so:

  1. Hashen Sie die von Cleanroom bereitgestellten personenbezogenen Daten mit dem SHA-256-Algorithmus.
  2. Verschlüsseln Sie die Hash-Bytes mit einer kommutativen EC-Verschlüsselung und dem Publisher-Schlüssel für die PAIR-Nutzerliste.
  3. Codieren Sie die verschlüsselten Daten mit Hex- oder Base64-Codierung.

MobileData-Anforderungen

Füllen Sie das mobile_ids Feld eines MobileData Objekts mit einer Liste von Mobil-IDs. Mobil-IDs nicht hashen.

Zeitstempelformat

Wenn Sie das JSON-Format für Timestamp-Felder wie timestamp und last_updated_timestamp von Event verwenden, nutzen Sie das RFC 3339-Format. Hier einige Beispiele für die UTC-Zeit vom 8. August 2025, 17:18:44.291 Uhr im RFC 3339-Format und in verschiedenen Zeitzonen:

  • Zeitzone UTC: 2025-08-08T17:18:44.291Z
  • Zeitzone EDT, die zu diesem Zeitpunkt vier Stunden vor UTC lag: 2025-08-08T13:18:44.291-04:00
  • Zeitzone PDT, die zu diesem Zeitpunkt sieben Stunden vor UTC lag: 2025-08-08T10:18:44.291-07:00
  • Zeitzone für Tokio, Japan, die neun Stunden vor UTC lag und keine Sommerzeit hat: 2025-08-08T22:18:44.291+09:00

Wenn Sie das Protokollzwischenspeicher-Format verwenden, legen Sie beim Erstellen des Timestamp die seconds und optional die nanos fest. Hier sind die Werte für seconds und nanos für die UTC-Zeit vom 8. August 2025, 17:18:44.291 Uhr:

  • seconds: 1754683124
  • nanos: 291000000

Codierung

Beachten Sie beim Codieren von Daten Folgendes:

Zurück
Ziele und Header konfigurieren
Weiter
Nutzerdaten verschlüsseln