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.
Ein UserData-Objekt ist eine Sammlung von UserIdentifier-Objekten. Jedes UserIdentifier-Objekt 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.
- Entfernen Sie das Pluszeichen (
+) aus dem lokalen Teil
und alle Zeichen, die darauf folgen.
- Beispiel:
cloudy.sanfrancisco+shopping@gmail.com →
cloudysanfrancisco@gmail.com
- Wenn die E‑Mail-Adresse eine andere Domain als
gmail.com oder googlemail.com, entfernen Sie keine Punkte oder Pluszeichen.
- Beispiel:
user.name+NYC@Example.com →
user.name+nyc@example.com
|
| Leerzeichen |
Entfernen Sie voran- und nachgestellte Leerzeichen sowie Leerzeichen innerhalb. |
| Hashing |
Mit dem SHA-256-Algorithmus hashen.
Die Hash-Bytes mit Hex- oder Base64-Codierung codieren.
|
|
phone_number |
| Format |
string
Das Pluszeichen (+) und die Landesvorwahl angeben. Alle Zeichen nach dem Pluszeichen müssen Ziffern sein.
Beispiel: Die US-amerikanische Telefonnummer
(800)555-0100
sollte in +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 |
|
Verwenden Sie die folgenden Formatierungsrichtlinien, um das Attribut address eines UserIdentifier-Objekts 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
|
| 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.
Für US-amerikanische 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. |
|
address_line |
| Format |
string
Wird nur für Google Analytics verwendet.
Straße und Hausnummer der Adresse des Nutzers.
In Kleinbuchstaben umwandeln.
Symbolzeichen entfernen.
|
| Leerzeichen |
Entfernen Sie voran- und nachgestellte Leerzeichen. |
| Hashing |
Mit dem SHA-256-Algorithmus hashen.
Die Hash-Bytes mit Hex- oder Base64-Codierung codieren.
|
|
city |
| Format |
string
Wird nur für Google Analytics verwendet.
Die Stadt der Adresse des Nutzers.
In Kleinbuchstaben umwandeln.
Symbolzeichen entfernen.
|
| Leerzeichen |
Entfernen Sie voran- und nachgestellte Leerzeichen. |
| Hashing |
city nicht hashen. |
|
administrative_area |
| Format |
string
Wird nur für Google Analytics verwendet.
Die Verwaltungseinheit (Bundesland oder Provinz) der Adresse des Nutzers.
Verwenden Sie entweder die Abkürzung aus zwei Buchstaben (z. B. ca) oder
den vollständigen Namen (z. B. california).
In Kleinbuchstaben umwandeln.
Symbolzeichen entfernen.
|
| Leerzeichen |
Entfernen Sie voran- und nachgestellte Leerzeichen. |
| Hashing |
administrative_area nicht hashen. |
|
Ein IpData-Objekt hat die folgenden Attribute.
| IpData |
ip_address |
| Format |
string
IPv4- oder IPv6-Adresse.
Bei IPv6-Adressen spielt die Groß-/Kleinschreibung keine Rolle (es können sowohl Groß- als auch Kleinbuchstaben verwendet werden).
|
| Leerzeichen |
Entfernen Sie voran- und nachgestellte Leerzeichen. |
| Hashing |
ip_address nicht hashen. |
|
Füllen Sie das pair_ids Feld eines PairData Objekts mit einer Liste von IDs.
Formatieren Sie jedes Element in der Liste so:
- Hashen Sie die von Cleanroom bereitgestellten personenbezogenen Daten mit dem SHA-256-Algorithmus.
- Verschlüsseln Sie die Hash-Bytes mit einer kommutativen EC-Verschlüsselung und dem Publisher-Schlüssel für die PAIR-Nutzerliste.
- Codieren Sie die verschlüsselten Daten mit Hex- oder Base64-Codierung.
Füllen Sie das mobile_ids Feld eines MobileData Objekts mit einer Liste von
Mobilgeräte-IDs. Mobilgeräte-IDs nicht hashen.
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 um 17:18:44.291 Uhr im RFC 3339-Format und in verschiedenen Zeitzonen:
- UTC-Zeitzone:
2025-08-08T17:18:44.291Z
- EDT-Zeitzone, die zu diesem Zeitpunkt 4 Stunden vor UTC lag:
2025-08-08T13:18:44.291-04:00
- PDT-Zeitzone, die zu diesem Zeitpunkt 7 Stunden vor UTC lag:
2025-08-08T10:18:44.291-07:00
- Zeitzone für Tokio, Japan, die 9 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 um 17:18:44.291 Uhr:
seconds: 1754683124nanos: 291000000
Codierung
Beachten Sie beim Codieren von Daten Folgendes:
- Bei der Groß-/Kleinschreibung der Codierungsausgabe spielt die Hexadezimalcodierung
(Hex) keine Rolle.
- Bei der Base64
-Codierung spielt die Groß-/Kleinschreibung der Codierungsausgabe eine Rolle.
