Nutzerdaten formatieren

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

• UserData: Von Nutzern bereitgestellte Daten wie eine E-Mail-Adresse oder Telefonnummer.

• IpData: IP-Daten wie eine IP-Adresse und zugehörige Zeitstempel.

• PairData: Publisher Advertiser Identity Reconciliation (PAIR)-IDs.

• MobileData: Daten, die ein Mobilgerät identifizieren.

Anforderungen für UserData

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

UserIdentifier
email_address	Format string In Kleinbuchstaben umwandeln. Wenn die E‑Mail-Adresse die Domain gmail.com oder googlemail.com hat: Entfernen Sie alle Punkte (.) vor dem Symbol @. Entfernen Sie das Pluszeichen (+) aus dem lokalen Teil und alle Zeichen, die darauf folgen. Beispiel: [e-mail] → [e-mail] Wenn die E-Mail-Adresse eine andere Domain als gmail.com oder googlemail.com hat, entfernen Sie keine Punkte oder Pluszeichen. Beispiel: [e-mail] → [e-mail] Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen sowie Leerzeichen innerhalb. Hashing Hashen Sie die Daten mit dem SHA-256-Algorithmus und codieren Sie die Hash-Bytes.
phone_number	Format string Verwenden Sie das E.164-Format. Geben Sie das Pluszeichen (+) und die Landesvorwahl an. Alle Zeichen nach dem Pluszeichen müssen Ziffern sein. Die US-amerikanische Telefonnummer [phone] sollte beispielsweise so formatiert und normalisiert werden: [phone]. Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen. Hashing Hashen Sie die Daten mit dem SHA-256-Algorithmus und codieren Sie die Hash-Bytes.
address	AddressInfo-Objekt Weitere Informationen finden Sie in der AddressInfo-Formatspezifikation.

Format: AddressInfo

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

AddressInfo
given_name	Format string In Kleinbuchstaben umwandeln. Verwenden Sie keine Präfixe wie Mrs.. Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen. Hashing Hashen Sie die Daten mit dem SHA-256-Algorithmus und codieren Sie die Hash-Bytes.
family_name	Format string In Kleinbuchstaben umwandeln. Verwenden Sie keine Suffixe wie Jr.. Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen. Hashing Hashen Sie die Daten mit dem SHA-256-Algorithmus und codieren Sie die Hash-Bytes.
region_code	Format string Ein aus zwei Zeichen bestehender ISO-3166-1-Alpha-2-Code. Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen. Hashing Hashen Sie region_code nicht.
postal_code	Format string Sowohl US-amerikanische als auch internationale Postleitzahlen sind zulässig. Verwenden Sie für US-Adressen entweder 5 Ziffern oder 5 Ziffern gefolgt von einer 4-stelligen Erweiterung. Eine vierstellige Erweiterung kann die Abgleichsrate verbessern. Für alle anderen Länder: Darf keine Postleitzahlerweiterungen enthalten. Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen. Hashing Hashen Sie postal_code nicht.
address_line	Format string Wird nur für Google Analytics verwendet. Straße und Hausnummer der Adresse des Nutzers. In Kleinbuchstaben umwandeln. Entfernen Sie Symbolzeichen. Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen. Hashing Hashen Sie die Daten mit dem SHA-256-Algorithmus und codieren Sie die Hash-Bytes.
city	Format string Wird nur für Google Analytics verwendet. Die Stadt der Adresse des Nutzers. In Kleinbuchstaben umwandeln. Entfernen Sie Symbolzeichen. Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen. Hashing Hashen Sie city nicht.
administrative_area	Format string Wird nur für Google Analytics verwendet. Das Verwaltungsgebiet (Bundesland oder Provinz) der Adresse des Nutzers. Verwenden Sie entweder die Abkürzung mit zwei Buchstaben (z. B. ca) oder den vollständigen Namen (z. B. california). In Kleinbuchstaben umwandeln. Entfernen Sie Symbolzeichen. Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen. Hashing Hashen Sie administrative_area nicht.

Anforderungen für IpData

Ein IpData-Objekt hat die folgenden Attribute.

IpData
ip_address	Format string IPv4- oder IPv6-Adresse. Bei IPv6-Adressen wird Groß- und Kleinschreibung nicht berücksichtigt. Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen. Hashing Hashen Sie ip_address nicht.

Anforderungen für PairData

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

1. Hashen Sie die im Daten-Cleanroom bereitgestellten personenidentifizierbaren Informationen 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 der Hex- oder Base64-Codierung.

Anforderungen für MobileData

Füllen Sie das Feld mobile_ids eines MobileData-Objekts mit einer Liste von mobilen IDs. Hashen Sie keine mobilen IDs.

Zeitstempelformat

Wenn Sie das JSON-Format für Timestamp-Felder wie timestamp und last_updated_timestamp von Event verwenden, verwenden Sie das RFC 3339-Format. Hier sind einige Beispiele für die UTC-Zeit des 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 liegt und keine Sommerzeit hat: 2025-08-08T22:18:44.291+09:00

Wenn Sie das Protokollzwischenspeicher-Format verwenden, legen Sie beim Erstellen des Timestamp den seconds und optional den 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:

• seconds: 1754683124

• nanos: 291000000

Codierung

Die Codierungsanforderungen hängen davon ab, ob Sie Nutzerdaten verschlüsseln:

• Unverschlüsselte Nutzerdaten:Codieren Sie die SHA-256-Hash-Bytes entweder mit der hexadezimalen Codierung (Hex) oder der Base64-Codierung.

• Verschlüsselte Nutzerdaten: Wenn Sie Nutzerdaten verschlüsseln, müssen Sie die Roh-Hash-Bytes vor der Verschlüsselung Base64-codieren. Die hexadezimale Codierung wird für den Hash vor der Verschlüsselung nicht unterstützt. Anschließend können Sie den resultierenden Geheimtext entweder mit der Hexadezimal- oder der Base64-Codierung codieren.

Hinweis: Bei der hexadezimalen Codierung spielt die Groß- und Kleinschreibung der Codierungsausgabe keine Rolle.