Audience

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

تمثيل JSON 
{
  "resourceName": string,
  "id": string,
  "status": enum (AudienceStatus),
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  },
  "scope": enum (AudienceScope),
  "assetGroup": string,
  "name": string
}
الحقول
resourceName

string

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

customers/{customerId}/audiences/{audience_id}
id

string (int64 format)

النتائج فقط. رقم تعريف شريحة الجمهور.
status

enum (AudienceStatus)

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

string

وصف هذا الجمهور.
dimensions[]

object (AudienceDimension)

الأبعاد الموجبة التي تحدّد تكوين الجمهور
exclusionDimension

object (AudienceExclusionDimension)

سمة سلبية تحدّد تكوين الجمهور
scope

enum (AudienceScope)

تُحدِّد النطاق الذي يمكن استخدام هذا الجمهور فيه. النطاق هو CUSTOMER تلقائيًا. يمكن إنشاء شرائح الجمهور باستخدام النطاق ASSET_GROUP للاستخدام الحصري من خلال مجموعة مواد عرض واحدة. يمكن تغيير النطاق من ASSET_GROUP إلى CUSTOMER ولكن ليس من CUSTOMER إلى ASSET_GROUP.
assetGroup

string

غير قابل للتغيير. مجموعة مواد العرض التي يتم تحديد نطاق هذا الجمهور ضمنها. يجب ضبطها فقط إذا كان النطاق ASSET_GROUP. غير قابل للتغيير بعد الإنشاء. في حال ترقية جمهور بنطاق ASSET_GROUP إلى نطاق CUSTOMER، سيتم محو هذا الحقل تلقائيًا.
name

string

اسم الجمهور. ويجب أن يكون فريدًا على مستوى جميع شرائح الجمهور داخل الحساب. يجب أن يبلغ طوله 1 كحد أدنى و255 طولاً كحد أقصى. مطلوب عند عدم ضبط النطاق أو ضبطه على CUSTOMER. لا يمكن الضبط أو تعديله عندما يكون النطاق ASSET_GROUP.

AudienceStatus

يتضمن هذا التعداد أنواع حالات الجمهور المحتملة.

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

AudienceDimension

سمة إيجابية تحدّد جمهور المستخدِم

تمثيل JSON 
{

  // Union field dimension can be only one of the following:
  "age": {
    object (AgeDimension)
  },
  "gender": {
    object (GenderDimension)
  },
  "householdIncome": {
    object (HouseholdIncomeDimension)
  },
  "parentalStatus": {
    object (ParentalStatusDimension)
  },
  "audienceSegments": {
    object (AudienceSegmentDimension)
  }
  // End of list of possible types for union field dimension.
}
الحقول
حقل الاتحاد dimension سمة تحدّد المستخدمين الذين ينتمون إلى الجمهور. يمكن أن يكون الحقل "dimension" واحدًا فقط مما يلي:
age

object (AgeDimension)

سمة تحدد المستخدمين حسب أعمارهم.
gender

object (GenderDimension)

سمة تحدّد المستخدمين حسب الجنس
householdIncome

object (HouseholdIncomeDimension)

السمة التي تحدّد المستخدمين حسب دخل الأسرة.
parentalStatus

object (ParentalStatusDimension)

سمة تحدد المستخدمين حسب حالتهم الأبوية.
audienceSegments

object (AudienceSegmentDimension)

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

AgeDimension

سمة تحدد المستخدمين حسب أعمارهم.

تمثيل JSON 
{
  "ageRanges": [
    {
      object (AgeSegment)
    }
  ],
  "includeUndetermined": boolean
}
الحقول
ageRanges[]

object (AgeSegment)

فئة عمرية متجاورة سيتم تضمينها في السمة.
includeUndetermined

boolean

تضمين المستخدمين الذين لم يتم تحديد أعمارهم.

AgeSegment

الفئة العمرية المتجاورة.

تمثيل JSON 
{
  "minAge": integer,
  "maxAge": integer
}
الحقول
minAge

integer

الحد الأدنى للعمر المطلوب إدراجه يجب تحديد حد أدنى للعمر ويجب ألا يقل عن 18 عامًا. القيم المسموح بها هي 18 و25 و35 و45 و55 و65.
maxAge

integer

الحد الأقصى للعمر المطلوب إدراجه لا يلزم تحديد حد أقصى للعمر. وفي حال تحديد ذلك، يجب أن يكون الحدّ الأقصى للعمر أكبر من الحد الأدنى للعمر، وتكون القيم المسموح بها هي 24 و34 و44 و54 و64.

GenderDimension

سمة تحدّد المستخدمين حسب الجنس

تمثيل JSON 
{
  "genders": [
    enum (GenderType)
  ],
  "includeUndetermined": boolean
}
الحقول
genders[]

enum (GenderType)

تم تضمين شرائح الخصائص الديمغرافية الجنس.
includeUndetermined

boolean

تضمين المستخدمين الذين لم يتم تحديد جنسهم.

HouseholdIncomeDimension

السمة التي تحدّد المستخدمين حسب دخل الأسرة.

تمثيل JSON 
{
  "incomeRanges": [
    enum (IncomeRangeType)
  ],
  "includeUndetermined": boolean
}
الحقول
incomeRanges[]

enum (IncomeRangeType)

تم تضمين الشرائح الديمغرافية لدخل الأسرة.
includeUndetermined

boolean

تضمين المستخدمين الذين لم يتم تحديد دخل أسرتهم.

ParentalStatusDimension

سمة تحدد المستخدمين حسب حالتهم الأبوية.

تمثيل JSON 
{
  "parentalStatuses": [
    enum (ParentalStatusType)
  ],
  "includeUndetermined": boolean
}
الحقول
parentalStatuses[]

enum (ParentalStatusType)

تم تضمين الشرائح الديمغرافية للحالة الأبوية.
includeUndetermined

boolean

تضمين المستخدمين الذين لم يتم تحديد حالتهم الأبوية.

AudienceSegmentDimension

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

تمثيل JSON 
{
  "segments": [
    {
      object (AudienceSegment)
    }
  ]
}
الحقول
segments[]

object (AudienceSegment)

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

AudienceSegment

شريحة من الجمهور إيجابية

تمثيل JSON 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  },
  "userInterest": {
    object (UserInterestSegment)
  },
  "lifeEvent": {
    object (LifeEventSegment)
  },
  "detailedDemographic": {
    object (DetailedDemographicSegment)
  },
  "customAudience": {
    object (CustomAudienceSegment)
  }
  // End of list of possible types for union field segment.
}
الحقول
حقل الاتحاد segment شريحة الجمهور الإيجابي. يمكن أن يكون الحقل "segment" واحدًا فقط مما يلي:
userList

object (UserListSegment)

شريحة قائمة المستخدمين
userInterest

object (UserInterestSegment)

شريحة من الجمهور ذي الاهتمامات المشتركة أو شريحة من الجمهور في السوق
lifeEvent

object (LifeEventSegment)

شريحة من الجمهور لأحداث البث المباشر
detailedDemographic

object (DetailedDemographicSegment)

شريحة الخصائص الديمغرافية المفصّلة
customAudience

object (CustomAudienceSegment)

شريحة جمهور مخصّصة:

UserListSegment

شريحة قائمة المستخدمين سيبدأ إيقاف ميزة "الجمهور المشابه" نهائيًا في أيار (مايو) 2023. يُرجى الاطّلاع على https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html للتعرّف على خيارات أخرى.

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

string

مورد قائمة المستخدمين.

UserInterestSegment

شريحة اهتمامات المستخدِمين

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

string

المرجع الخاص باهتمامات المستخدمين

LifeEventSegment

جزء الحدث المباشر

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

string

مرجع الأحداث في الحياة

DetailedDemographicSegment

شريحة الخصائص الديمغرافية المفصّلة

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

string

المورد الديموغرافي التفصيلي.

CustomAudienceSegment

شريحة جمهور مخصّصة:

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

string

مرجع الجمهور المخصّص

AudienceExclusionDimension

سمة سلبية تحدد المستخدمين لاستبعادهم من الجمهور.

تمثيل JSON 
{
  "exclusions": [
    {
      object (ExclusionSegment)
    }
  ]
}
الحقول
exclusions[]

object (ExclusionSegment)

شريحة الجمهور المطلوب استبعادها.

ExclusionSegment

شريحة جمهور سيتم استبعادها من شريحة جمهور معيّنة.

تمثيل JSON 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  }
  // End of list of possible types for union field segment.
}
الحقول
حقل الاتحاد segment الشريحة التي سيتم استبعادها. يمكن أن يكون الحقل "segment" واحدًا فقط مما يلي:
userList

object (UserListSegment)

شريحة قائمة المستخدمين المراد استبعادها.

AudienceScope

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

عمليات التعداد
UNSPECIFIED لم يتم تحديد النطاق.
UNKNOWN القيمة المُستلَمة غير معروفة في هذا الإصدار.
CUSTOMER يتم تحديد نطاق الجمهور على مستوى العميل.
ASSET_GROUP يتم تحديد الجمهور ضمن مجموعة مواد عرض محدّدة.