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 المستخدمون الذين ثبَّتوا تطبيقًا للأجهزة الجوّالة.