Audience

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

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

string

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

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

string (int64 format)

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

enum (AudienceStatus)

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

string

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

string

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

object (AudienceDimension)

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

object (AudienceExclusionDimension)

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

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

الحد الأقصى للسن المسموح به لا يلزم تحديد حد أقصى للعمر. في حال تحديد قيمة maxAge، يجب أن تكون أعلى من minAge، والقيم المسموح بها هي 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)

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