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.
  • 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. Jede UserIdentifier hat genau eines der Attribute in der folgenden Tabelle.

UserIdentifier
email_address
Format
string
In Kleinbuchstaben umwandeln.
Leerzeichen Entfernen Sie voran-, nachgestellte und dazwischenliegende Leerzeichen.
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.
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 Formatspezifikation für AddressInfo.

Format: AddressInfo

Verwenden Sie die folgenden Formatierungsrichtlinien, um das address-Attribut 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 ISO 3166-1 Alpha-2-Code mit zwei Zeichen.
Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen.
Hashing Erstellen Sie keinen Hash von 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.
Verwenden Sie für alle anderen Länder keine Erweiterungen für Postleitzahlen.
Leerzeichen Entfernen Sie voran- und nachgestellte Leerzeichen.
Hashing Erstellen Sie keinen Hash von postal_code.

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 von 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.

Wenn Sie das Protokollpufferformat verwenden, legen Sie beim Erstellen von Timestamp die seconds und optional die nanos fest.

Nächste Schritte