Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

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: Vom Nutzer bereitgestellte Daten wie eine E‑Mail-Adresse oder Telefonnummer.
IpData: IP-Daten wie eine IP-Adresse und zugehörige Zeitstempel.
PairData: IDs für den Identitätsabgleich zwischen Publishern und Werbetreibenden (Publisher Advertiser Identity Reconciliation, PAIR).
MobileData: Daten zur Identifizierung eines Mobilgeräts.

`UserData`-Anforderungen

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 voranstehende, nachstehende und dazwischenliegende 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 die Landesvorwahl angeben. Alle Zeichen nach dem Pluszeichen müssen Ziffern sein. Beispiel: Die US-amerikanische Telefonnummer `(800)555-0100` sollte so formatiert und normalisiert werden: `+18005550100`.
Leerzeichen	Entfernen Sie voranstehende und nachstehende 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 eines UserIdentifier-Objekts zu erstellen.

AddressInfo

given_name

Format	`string` In Kleinbuchstaben umwandeln. Keine Anreden wie `Mrs.` verwenden.
Leerzeichen	Entfernen Sie voranstehende und nachstehende 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 voranstehende und nachstehende 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 voranstehende und nachstehende Leerzeichen.
Hashing	`region_code` nicht hashen.

postal_code

Format	`string` Sowohl US-amerikanische als auch internationale Postleitzahlen sind erlaubt. 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 voranstehende und nachstehende Leerzeichen.
Hashing	`postal_code` nicht hashen.

`IpData`-Anforderungen

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.
Leerzeichen	Entfernen Sie voranstehende und nachstehende Leerzeichen.
Hashing	`ip_address` 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:

Hashen Sie die vom 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.

`MobileData`-Anforderungen

Füllen Sie das mobile_ids Feld eines MobileData Objekts mit einer Liste von Mobilgeräte-IDs. Mobilgeräte-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 4 Stunden vor UTC lag: 2025-08-08T13:18:44.291-04:00
Zeitzone PDT, 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, 17:18:44.291 Uhr:

seconds: 1754683124
nanos: 291000000