AudienceMember

مخاطبی که قرار است تحت عمل جراحی قرار گیرد.

نمایش JSON 
{
  "destinationReferences": [
    string
  ],
  "consent": {
    object (Consent)
  },

  // Union field data can be only one of the following:
  "userData": {
    object (UserData)
  },
  "pairData": {
    object (PairData)
  },
  "mobileData": {
    object (MobileData)
  },
  "userIdData": {
    object (UserIdData)
  },
  "ppidData": {
    object (PpidData)
  },
  "compositeData": {
    object (CompositeData)
  }
  // End of list of possible types for union field data.
}
فیلدها
destinationReferences[]

string

اختیاری. مشخص می‌کند که مخاطب به کدام Destination ارسال شود.

consent

object ( Consent )

اختیاری. تنظیم رضایت برای کاربر.

data فیلد یونیون. نوع داده‌های شناسایی که قرار است روی آنها عملیات انجام شود. data می‌توانند فقط یکی از موارد زیر باشند:
userData

object ( UserData )

داده‌های ارائه شده توسط کاربر که کاربر را شناسایی می‌کند.

pairData

object ( PairData )

شناسه‌های تطبیق هویت ناشر و تبلیغ‌کننده (PAIR) .

این ویژگی فقط برای شرکای داده در دسترس است.

mobileData

object ( MobileData )

داده‌هایی که دستگاه‌های تلفن همراه کاربر را شناسایی می‌کنند.

userIdData

object ( UserIdData )

داده‌های مربوط به شناسه‌های منحصر به فرد برای یک کاربر، همانطور که توسط تبلیغ‌کننده تعریف شده است.

ppidData

object ( PpidData )

داده‌های مربوط به شناسه‌های ارائه شده توسط ناشر.

این ویژگی فقط برای شرکای داده در دسترس است.

compositeData

object ( CompositeData )

گروهی از چندین نوع شناسه.

جفت داده

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

این ویژگی فقط برای شرکای داده در دسترس است.

نمایش JSON 
{
  "pairIds": [
    string
  ]
}
فیلدها
pairIds[]

string

الزامی. داده‌های PII ارائه شده توسط Cleanroom، هش شده با SHA256 و رمزگذاری شده با یک رمز جابجایی EC با استفاده از کلید ناشر برای لیست کاربران PAIR . حداکثر 10 pairIds می‌تواند در یک AudienceMember ارائه شود.

موبایل دیتا

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

نمایش JSON 
{
  "mobileIds": [
    string
  ]
}
فیلدها
mobileIds[]

string

الزامی. فهرست شناسه‌های دستگاه‌های تلفن همراه (شناسه تبلیغات/IDFA). حداکثر ۱۰ mobileIds می‌تواند در یک AudienceMember ارائه شود.

شناسه کاربری

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

نمایش JSON 
{
  "userId": string
}
فیلدها
userId

string

الزامی. شناسه‌ای منحصر به فرد برای کاربر، همانطور که توسط تبلیغ‌کننده تعریف شده است.

پی پی دیتا

ناشر، داده‌های شناسه حاوی ppidها را ارائه کرده است. حداقل یک ppid مورد نیاز است.

این ویژگی فقط برای شرکای داده در دسترس است.

نمایش JSON 
{
  "ppids": [
    string
  ]
}
فیلدها
ppids[]

string

الزامی. فهرست شناسه‌های ارائه شده توسط ناشر برای یک کاربر.

کامپوزیت دیتا

داده‌های ترکیبی که شناسه‌ها و داده‌های مرتبط با یک کاربر را در خود نگه می‌دارند. حداقل یکی از userData یا ipData مورد نیاز است.

نمایش JSON 
{
  "userData": {
    object (UserData)
  },
  "ipData": [
    {
      object (IpData)
    }
  ]
}
فیلدها
userData

object ( UserData )

اختیاری. داده‌های ارائه شده توسط کاربر که کاربر را شناسایی می‌کند.

ipData[]

object ( IpData )

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

آی‌پی‌دیتا

اطلاعات آدرس IP برای یک کاربر. توصیه می‌کنیم برای بهبود نرخ تطابق مشتری، observeStartTime و observeEndTime را نیز لحاظ کنید.

نمایش JSON 
{
  "ipAddress": string,
  "observeStartTime": string,
  "observeEndTime": string
}
فیلدها
ipAddress

string

الزامی. آدرس IP در زمان تعامل با مشتری ثبت می‌شود. قالب‌های رشته‌ای استاندارد را برای IPv4 و IPv6 می‌پذیرد.

observeStartTime

string ( Timestamp format)

اختیاری. اولین زمان تعامل ثبت شده از این آدرس IP در یک جلسه.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

observeEndTime

string ( Timestamp format)

اختیاری. آخرین زمان تعامل ثبت شده از این آدرس IP در یک جلسه.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .