UserData

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

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

object ( UserIdentifier )

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

شناسه کاربری

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

نمایش 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 )

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

پایان میدان‌های ناسازگار.

اطلاعات آدرس

اطلاعات آدرس برای کاربر.

نمایش 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

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

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

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

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

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

object ( UserIdentifier )

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

شناسه کاربری

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

نمایش 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 )

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

پایان میدان‌های ناسازگار.

اطلاعات آدرس

اطلاعات آدرس برای کاربر.

نمایش 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

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

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

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