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)

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

CustomAudienceStatus

فهرس يحتوي على حالات شرائح الجمهور المخصّصة المحتملة

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

CustomAudienceType

قائمة بأنواع الجمهور المخصّصة المحتمَلة

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

CustomAudienceMember

أحد أفراد شريحة الجمهور المخصّصة يمكن أن يكون العنصر عضوًا في مجموعة على النحو التالي: KEYWORD أو 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)

نوع عضو شريحة الجمهور المخصّصة، أو KEYWORD، أو عنوان URL، أو PLACE_CATEGORY، أو APP
حقل الربط value قيمة CustomAudienceMember. تتم تعبئة حقل واحد استنادًا إلى نوع العضو. يمكن أن يكون 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 المستخدمون الذين ثبَّتوا تطبيقًا متوافقًا مع الأجهزة الجوّالة