UserData

داده‌هایی که کاربر را شناسایی می‌کنند. حداقل یک شناسه لازم است.

نمایش JSON
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ]
}
فیلدها
userIdentifiers[]

object ( UserIdentifier )

الزامی. شناسه‌های کاربر. می‌توان چندین نمونه از یک نوع داده (مثلاً چندین آدرس ایمیل) ارائه داد. برای افزایش احتمال تطابق، تا حد امکان شناسه‌های بیشتری ارائه دهید. حداکثر 10 userIdentifiers می‌توان در یک AudienceMember یا Event ارائه داد.

شناسه کاربری

یک شناسه واحد برای کاربر.

نمایش JSON
{

  // Union field identifier can be only one of the following:
  "emailAddress": string,
  "phoneNumber": string,
  "address": {
    object (AddressInfo)
  }
  // End of list of possible types for union field identifier.
}
فیلدها
identifier فیلد Union. دقیقاً یکی باید مشخص شود. identifier فقط می‌تواند یکی از موارد زیر باشد:
emailAddress

string

آدرس ایمیل هش شده با استفاده از تابع هش SHA-256 پس از نرمال‌سازی.

phoneNumber

string

شماره تلفن هش شده با استفاده از تابع هش SHA-256 پس از نرمال‌سازی (استاندارد E164).

address

object ( 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

الزامی. کد منطقه دو حرفی در استاندارد ISO-3166-1 alpha-2 مربوط به آدرس کاربر.

postalCode

string

الزامی. کد پستی آدرس کاربر.

addressLine

string

اختیاری. خیابان و شماره آدرس کاربر. فقط برای گوگل آنالیتیکس استفاده می‌شود. این فیلد هش شده و احتمالاً رمزگذاری شده است.

قبل از هش کردن، مقدار را نرمال‌سازی کنید:

  • حذف کاراکترهای نماد
  • تبدیل به حروف کوچک
  • حذف فضای خالی ابتدا و انتهای متن
city

string

اختیاری. شهر آدرس کاربر. فقط برای گوگل آنالیتیکس استفاده می‌شود.

مقدار باید به این صورت نرمال‌سازی شود:

  • حذف کاراکترهای نماد
  • تبدیل به حروف کوچک
  • حذف فضای خالی ابتدا و انتهای متن
administrativeArea

string

اختیاری. منطقه اداری (ایالت/استان) آدرس کاربر. فقط برای گوگل آنالیتیکس استفاده می‌شود.

مقدار باید به این صورت نرمال‌سازی شود:

  • حذف کاراکترهای نماد
  • تبدیل به حروف کوچک
  • حذف فضای خالی ابتدا و انتهای متن