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)

أرقام تعريف حلّ Publisher Advertiser Identity Reconciliation (PAIR)

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

object (MobileData)

البيانات التي تحدّد الأجهزة الجوّالة للمستخدم
userIdData

object (UserIdData)

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

object (PpidData)

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

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

object (CompositeData)

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

PairData

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

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

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

string

الحقل مطلوب. بيانات تحديد الهوية الشخصية (PII) المقدَّمة من الغرفة النظيفة، والتي تم تجزئتها باستخدام SHA256 وتشفيرها باستخدام تشفير تبادلي EC باستخدام مفتاح الناشر لقائمة مستخدمي حلّ PAIR يمكن تقديم 10 pairIds على الأكثر في AudienceMember واحد.

MobileData

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

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

string

الحقل مطلوب. قائمة بأرقام تعريف الأجهزة الجوّالة (المعرّف الإعلاني/معرّف المعلِن) يمكن تقديم 10 mobileIds على الأكثر في AudienceMember واحد.

UserIdData

بيانات رقم تعريف المستخدم التي تحتوي على رقم تعريف المستخدم

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

string

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

PpidData

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

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

تمثيل 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".