AudienceMember

تمثّل هذه السمة الفرد من الجمهور الذي سيتم إجراء العملية عليه.

تمثيل JSON 
{
  "destinationReferences": [
    string
  ],
  "consent": {
    object (Consent)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "userData": {
    object (UserData)
  },
  "pairData": {
    object (PairData)
  },
  "mobileData": {
    object (MobileData)
  },
  "userIdData": {
    object (UserIdData)
  },
  "ppidData": {
    object (PpidData)
  },
  "compositeData": {
    object (CompositeData)
  },
  "googleUserIdData": {
    object (GoogleUserIdData)
  },
  "partnerProvidedIdData": {
    object (PartnerProvidedIdData)
  }
  // End of mutually exclusive fields.
}
الحقول
destinationReferences[]

string

اختياريّ. تحدّد هذه السمة Destination التي سيتم توجيه المستخدم إليها.
consent

object (Consent)

اختياريّ. إعداد الموافقة للمستخدم
تمثّل هذه السمة نوع البيانات التعريفية المطلوب إجراء عملية عليها. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
userData

object (UserData)

البيانات المقدَّمة من المستخدم والتي تحدّد هويته
pairData

object (PairData)

معرّفات Publisher Advertiser Identity Reconciliation (PAIR)

لا تتوفّر هذه الميزة إلا لشركاء البيانات.
mobileData

object (MobileData)

تشير هذه السمة إلى البيانات التي تحدّد الأجهزة الجوّالة للمستخدم.
userIdData

object (UserIdData)

بيانات مرتبطة بمعرّفات فريدة لمستخدِم، كما يحدّدها المعلِن
ppidData

object (PpidData)

البيانات ذات الصلة بالمعرّفات المقدَّمة من الناشر

لا تتوفّر هذه الميزة إلا لشركاء البيانات.
compositeData

object (CompositeData)

مجموعة من أنواع المعرّفات المتعددة
googleUserIdData

object (GoogleUserIdData)

أرقام تعريف المستخدمين في Google المشفّرة
partnerProvidedIdData

object (PartnerProvidedIdData)

المعرّفات المقدَّمة من الشريك
نهاية الحقول التي يستبعد كلّ منها الآخر

PairData

معرّفات PAIR الخاصة بالجمهور يجب توفير رقم تعريف PAIR واحد على الأقل.

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

تمثيل JSON 
{
  "pairIds": [
    string
  ]
}
الحقول
pairIds[]

string

الحقل مطلوب. بيانات معلومات التعريف الشخصية المقدَّمة من Clean Room، والتي تم تجزئتها باستخدام SHA256 وتشفيرها باستخدام تشفير تبادلي منحنى إهليلجي باستخدام مفتاح الناشر لقائمة مستخدمي PAIR يمكن تقديم 10 pairIds كحد أقصى في AudienceMember واحد.

MobileData

معرّفات الأجهزة الجوّالة للجمهور يجب توفير معرّف جهاز جوّال واحد على الأقل.

تمثيل JSON 
{
  "mobileIds": [
    string
  ]
}
الحقول
mobileIds[]

string

الحقل مطلوب. قائمة بمعرّفات الأجهزة الجوّالة (المعرّف الإعلاني على Android أو معرّف المعلِنين على iOS لقوائم مستخدمي "مطابقة العملاء"، والمعرّف الإعلاني على Android أو معرّف المعلِنين على iOS أو معرّف Xbox أو Microsoft أو معرّف Amazon Fire TV أو معرّف Roku أو معرّف الجهاز العام لقوائم المستخدمين الأساسية) يمكن تقديم 10 mobileIds كحد أقصى في AudienceMember واحد.

UserIdData

بيانات رقم تعريف المستخدم التي تتضمّن رقم تعريف المستخدم

تمثيل JSON 
{
  "userId": string
}
الحقول
userId

string

الحقل مطلوب. معرّف فريد للمستخدِم، كما يحدّده المعلِن.

PpidData

بيانات المعرّفات المقدَّمة من الناشر التي تتضمّن معرّفات PPID يجب توفير معرّف واحد على الأقل.

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

تمثيل JSON 
{
  "ppids": [
    string
  ]
}
الحقول
ppids[]

string

الحقل مطلوب. قائمة بالمعرّفات المقدَّمة من الناشر لمستخدِم معيّن.

CompositeData

بيانات مركّبة تحتوي على معرّفات وبيانات مرتبطة بمستخدم. يجب توفير سمة واحدة على الأقل من userData أو ipData.

تمثيل JSON 
{
  "userData": {
    object (UserData)
  },
  "ipData": [
    {
      object (IpData)
    }
  ]
}
الحقول
userData

object (UserData)

اختياريّ. البيانات المقدَّمة من المستخدم والتي تحدّد هويته
ipData[]

object (IpData)

اختياريّ. بيانات عناوين IP التي تمثّل تفاعل العملاء والمستخدَمة لإنشاء شريحة الجمهور

IpData

معلومات عنوان IP للمستخدم ننصحك بتضمين observeStartTime وobserveEndTime للمساعدة في تحسين نِسب المطابقة في "مطابقة العملاء".

تمثيل JSON 
{
  "ipAddress": string,
  "observeStartTime": string,
  "observeEndTime": string
}
الحقول
ipAddress

string

الحقل مطلوب. عنوان IP الذي تم تسجيله في وقت تفاعل العميل يقبل تنسيقات السلاسل العادية لكل من IPv4 وIPv6.
observeStartTime

string (Timestamp format)

اختياريّ. وقت أول تفاعل تم تسجيله من عنوان IP هذا في جلسة

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف 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 في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".

GoogleUserIdData

بيانات أرقام تعريف مستخدمي Google التي تتضمّن أرقام تعريف مشفّرة لمستخدمي Google يجب توفير معرّف مستخدم Google واحد على الأقل.

تمثيل JSON 
{
  "googleUserIds": [
    string
  ]
}
الحقول
googleUserIds[]

string

الحقل مطلوب. قائمة بأرقام تعريف مستخدمي Google المشفرة

PartnerProvidedIdData

بيانات يقدّمها الشريك تتضمّن المعرّفات التي يقدّمها الشريك يجب توفير معرّف واحد على الأقل من المعرّفات التي يقدّمها الشريك.

تمثيل JSON 
{
  "partnerProvidedIds": [
    string
  ]
}
الحقول
partnerProvidedIds[]

string

الحقل مطلوب. قائمة المعرّفات المقدَّمة من الشريك