UserData

נתונים שמזהים את המשתמש. צריך לציין לפחות מזהה אחד.

ייצוג JSON 
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ]
}
שדות
userIdentifiers[]

object (UserIdentifier)

חובה. המזהים של המשתמש. אפשר לספק כמה מופעים של אותו סוג נתונים (לדוגמה, כמה כתובות אימייל). כדי להגדיל את הסיכוי להתאמה, מומלץ לספק כמה שיותר מזהים. אפשר לספק עד 10 userIdentifiers ב-AudienceMember או ב-Event אחד.

UserIdentifier

מזהה יחיד של המשתמש.

ייצוג JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "emailAddress": string,
  "phoneNumber": string,
  "address": {
    object (AddressInfo)
  }
  // End of mutually exclusive fields.
}
שדות
חובה לציין בדיוק אחד מהם. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. רק אחד מהשדות הבאים יוגדר בתשובה:
emailAddress

string

כתובת אימייל שעברה גיבוב באמצעות פונקציית הגיבוב SHA-256 אחרי נרמול.
phoneNumber

string

מספר טלפון מגובב באמצעות פונקציית הגיבוב SHA-256 אחרי נירמול (תקן E164).
address

object (AddressInfo)

הרכיבים הידועים של כתובת המשתמש. מכיל קיבוץ של מזהים שתואמים בבת אחת.
סוף השדות הבלעדיים.

AddressInfo

פרטי הכתובת של המשתמש.

ייצוג JSON 
{
  "givenName": string,
  "familyName": string,
  "regionCode": string,
  "postalCode": string,
  "addressLine": string,
  "city": string,
  "administrativeArea": string
}
שדות
givenName

string

חובה. השם (הפרטי) של המשתמש, באותיות קטנות, ללא סימני פיסוק, ללא רווחים מובילים או נגררים, ועבר גיבוב לפי תקן SHA-256.
familyName

string

חובה. שם המשפחה של המשתמש, באותיות קטנות בלבד, ללא סימני פיסוק, ללא רווחים מובילים או נגררים, ומגובב כ-SHA-256.
regionCode

string

חובה. קוד האזור בן 2 האותיות לפי תקן ISO 3166-1 alpha-2 של כתובת המשתמש.
postalCode

string

חובה. המיקוד של הכתובת של המשתמש.
addressLine

string

אופציונלי. הרחוב ומספר הבית של הכתובת של המשתמש. הפרמטר הזה משמש רק ל-Google Analytics. השדה הזה עובר גיבוב (hash) ויכול להיות שהוא מוצפן.

לנרמל את הערך לפני הגיבוב:

  • הסרת תווים של סמלים
  • המרה לאותיות קטנות
  • הסרת רווחים לבנים בתחילת הטקסט ובסופו
city

string

אופציונלי. העיר שמופיעה בכתובת של המשתמש. הפרמטר הזה משמש רק ל-Google Analytics.

הערך צריך להיות מנורמל באופן הבא:

  • הסרת תווים של סמלים
  • המרה לאותיות קטנות
  • הסרת רווחים לבנים בתחילת הטקסט ובסופו
administrativeArea

string

אופציונלי. האזור המנהלי (מדינה או מחוז) של הכתובת של המשתמש. הפרמטר הזה משמש רק ל-Google Analytics.

הערך צריך להיות מנורמל באופן הבא:

  • הסרת תווים של סמלים
  • המרה לאותיות קטנות
  • הסרת רווחים לבנים בתחילת הטקסט ובסופו