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، والمشفّرة باستخدام تشفير تبادلي EC باستخدام مفتاح الناشر لقائمة مستخدمي PAIR يمكن تقديم 10 pairIds كحد أقصى في 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".

GoogleUserIdData

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

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

string

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

PartnerProvidedIdData

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

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

string

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