Nutzerdaten formatieren

Mit der Data Manager API können verschiedene Arten von Nutzerdaten hochgeladen werden. Halten Sie die Formatierungs-, Hashing- und Codierungsanforderungen für jedes Datenelement ein, 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: PAIR-IDs (Publisher Advertiser Identity Reconciliation, Identitätsabgleich zwischen Publishern und Werbetreibenden).
  • MobileData: Daten zur Identifizierung eines Mobilgeräts.

UserData-Anforderungen

Ein UserData-Objekt ist eine Sammlung von UserIdentifier-Objekten. Jedes 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 danach folgen.
    • Beispiel: cloudy.sanfrancisco+shopping@gmail.com → cloudysanfrancisco@gmail.com
  • Wenn die E-Mail-Adresse eine andere Domain als gmail.com oder googlemail.com hat, 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 alle Leerzeichen innerhalb.
Hashing Hashen Sie die Daten mit dem SHA-256-Algorithmus. Codieren Sie die Hash-Bytes mit Hex- oder Base64-Codierung.
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-Telefonnummer (800)555-0100 sollte beispielsweise so formatiert und normalisiert werden: +18005550100.
Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen.
Hashing Hashen Sie die Daten mit dem SHA-256-Algorithmus. Codieren Sie die Hash-Bytes mit Hex- oder Base64-Codierung.
address
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.
Geben Sie keine Präfixe wie Mrs. an.
Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen.
Hashing Hashen Sie die Daten mit dem SHA-256-Algorithmus. Codieren Sie die Hash-Bytes mit Hex- oder Base64-Codierung.
family_name
Format
string
In Kleinbuchstaben umwandeln.
Geben Sie keine Suffixe wie Jr. an.
Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen.
Hashing Hashen Sie die Daten mit dem SHA-256-Algorithmus. Codieren Sie die Hash-Bytes mit Hex- oder Base64-Codierung.
region_code
Format
string
Ein zweistelliger ISO 3166-1-Alpha-2-Code.
Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen.
Hashing Erstellen Sie keinen Hash für region_code.
postal_code
Format
string
Sowohl US-amerikanische als auch internationale Postleitzahlen sind zulässig.
Bei Adressen in den USA können Sie entweder 5 Ziffern oder 5 Ziffern gefolgt von einer 4-stelligen Erweiterung verwenden. Eine 4-stellige Erweiterung kann die Abgleichsrate verbessern.
Für alle anderen Länder: Darf keine Postleitzahlerweiterungen enthalten.
Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen.
Hashing Erstellen Sie keinen Hash für postal_code.
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. Codieren Sie die Hash-Bytes mit Hex- oder Base64-Codierung.
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 Erstellen Sie keinen Hash für city.
administrative_area
Format
string
Wird nur für Google Analytics verwendet.
Das Verwaltungsgebiet (Bundesland oder Provinz) der Adresse des Nutzers.
Verwenden Sie entweder die aus zwei Buchstaben bestehende Abkürzung (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 Erstellen Sie keinen Hash für administrative_area.

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 voran- und nachgestellte Leerzeichen.
Hashing Erstellen Sie keinen Hash für ip_address.

PairData-Anforderungen

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

  1. Hashen Sie die im Cleanroom bereitgestellten personenidentifizierbaren Informationen mit dem SHA-256-Algorithmus.
  2. Verschlüsseln Sie die Hash-Bytes mit einer kommutativen EC-Verschlüsselung mit 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 Feld mobile_ids eines MobileData-Objekts mit einer Liste von mobilen IDs. Mobile 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 sind 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 liegt und in der es keine Sommerzeit gibt: 2025-08-08T22:18:44.291+09:00

Wenn Sie das Protokollzwischenspeicherformat verwenden, legen Sie beim Erstellen von Timestamp die seconds und optional die nanos fest. Hier sind die seconds- und nanos-Werte für die UTC-Zeit am 8. August 2025 um 17:18:44.291:

  • seconds: 1754683124
  • nanos: 291000000

Codierung

Beachten Sie beim Codieren von Daten Folgendes:

  • Die Groß- und Kleinschreibung der Codierungsausgabe spielt bei Verwendung der hexadezimalen Codierung (Hex) keine Rolle.
  • Die Groß- und Kleinschreibung der Codierungsausgabe ist wichtig, wenn Sie die Base64-Codierung verwenden.
Zurück
Ziele und Header konfigurieren
Weiter
Nutzerdaten verschlüsseln