CustomAudience

جمهور مخصّص: هذه قائمة بالمستخدمين حسب الاهتمامات.

تمثيل JSON 
{
  "resourceName": string,
  "id": string,
  "status": enum (CustomAudienceStatus),
  "name": string,
  "type": enum (CustomAudienceType),
  "description": string,
  "members": [
    {
      object (CustomAudienceMember)
    }
  ]
}
الحقول
resourceName

string

غير قابل للتغيير. اسم مورد الجمهور المخصّص. وتكون أسماء موارد شرائح الجمهور المخصّصة على النحو التالي:

customers/{customerId}/customAudiences/{custom_audience_id}
id

string (int64 format)

النتائج فقط. رقم تعريف الجمهور المخصّص.
status

enum (CustomAudienceStatus)

النتائج فقط. حالة هذا الجمهور المخصّص. يشير إلى ما إذا كان الجمهور المخصّص مفعَّلاً أو تمت إزالته.
name

string

اسم الجمهور المخصّص ويجب أن يكون فريدًا لجميع الجماهير المخصّصة التي أنشأها العميل. هذا الحقل مطلوب لإنشاء العمليات.
type

enum (CustomAudienceType)

نوع الجمهور المخصّص (غير مسموح بالنوع "INTEREST" أو "PURCHASE_INTENT" للجمهور المخصّص الذي تم إنشاؤه حديثًا، ولكن يتم الاحتفاظ به لشرائح الجمهور الحالية)
description

string

وصف هذا الجمهور المخصّص.
members[]

object (CustomAudienceMember)

قائمة بأعضاء الجمهور المخصّص الذي يتألف منه هذا الجمهور المخصّص. يمكن إضافة الأعضاء أثناء إنشاء "الجمهور المخصّص". في حال مشاركة الأعضاء في عملية UPDATE، سيتم تجاهل الأعضاء الحاليين.

CustomAudienceStatus

قيم تعداد تتضمّن حالات الجماهير المخصّصة المحتملة

عمليات التعداد
UNSPECIFIED غير محدَّد.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
ENABLED الحالة مفعّلة: الجمهور المخصّص مفعّل ويمكن استهدافه.
REMOVED الحالة "تمت الإزالة" - تمت إزالة الجمهور المخصّص ولا يمكن استخدامه للاستهداف.

CustomAudienceType

قيم تعداد تتضمّن أنواع جماهير مخصّصة محتملة

عمليات التعداد
UNSPECIFIED غير محدَّد.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
AUTO وستختار "إعلانات Google" تلقائيًا أفضل تفسير في وقت العرض.
INTEREST يطابق المستخدِمين حسب اهتماماتهم.
PURCHASE_INTENT يطابق المستخدِمين حسب المواضيع التي يبحثون عنها أو المنتجات التي يفكّرون في شرائها.
SEARCH يطابق المستخدمين حسب ما بحثوا عنه على "بحث Google".

CustomAudienceMember

عضو في جمهور مخصّص يمكن أن يكون العضو كلمة رئيسية أو عنوان URL أو PLACE_CATEGORY أو APP. يمكن فقط إنشاؤه أو إزالته ولكن لا يمكن تغييره.

تمثيل JSON 
{
  "memberType": enum (CustomAudienceMemberType),

  // Union field value can be only one of the following:
  "keyword": string,
  "url": string,
  "placeCategory": string,
  "app": string
  // End of list of possible types for union field value.
}
الحقول
memberType

enum (CustomAudienceMemberType)

نوع عضو الجمهور المخصّص، الكلمة الرئيسية، أو عنوان URL، أو PLACE_CATEGORY، أو APP.
حقل الاتحاد value قيمة Custom AudienceMember تتم تعبئة حقل واحد استنادًا إلى نوع العضو. يمكن أن تكون السمة "value" واحدة فقط مما يلي:
keyword

string

كلمة رئيسية أو عبارة مستخدمة ككلمة رئيسية - 10 كلمات و80 حرفًا كحد أقصى. يُسمح باللغات التي تحتوي على أحرف مزدوجة العرض، مثل الصينية أو اليابانية أو الكورية، باستخدام 40 حرفًا تصف اهتمامات المستخدم أو أفعاله.
url

string

عنوان URL يستخدم HTTP يتضمّن بروتوكولاً، وهو 2048 حرفًا كحدّ أقصى، ويتضمّن المحتوى الذي يهتم به المستخدمون.
placeCategory

string (int64 format)

نوع مكان محدّد حسب فئة مكان يزورها المستخدمون.
app

string

اسم حزمة لتطبيقات Android التي ثبّتها المستخدمون، مثل com.google.example.

CustomAudienceMemberType

يشير هذا المقياس إلى قيم تعداد تتضمّن أنواع أعضاء الجمهور المخصّصة المحتمَلة.

عمليات التعداد
UNSPECIFIED غير محدَّد.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
KEYWORD المستخدمون الذين يتم وصف اهتماماتهم أو إجراءاتهم بكلمة رئيسية
URL المستخدمون الذين لديهم اهتمامات مرتبطة بمحتوى الموقع الإلكتروني.
PLACE_CATEGORY المستخدمون الذين يزورون أنواع الأماكن الموضّحة حسب فئة المكان.
APP المستخدمون الذين ثبَّتوا تطبيقًا متوافقًا مع الأجهزة الجوّالة