- تمثيل JSON
- AudienceStatus
- AudienceDimension
- AgeDimension
- AgeSegment
- GenderDimension
- HouseholdIncomeDimension
- ParentalStatusDimension
- AudienceSegmentDimension
- AudienceSegment
- UserListSegment
- UserInterestSegment
- LifeEventSegment
- DetailedDemographicSegment
- CustomAudienceSegment
- AudienceExclusionDimension
- ExclusionSegment
- AudienceScope
الجمهور هو خيار استهداف فعّال يتيح لك إجراء تقاطع بين سمات شرائح مختلفة، مثل الخصائص الديمغرافية التفصيلية وشرائح الجمهور ذات الاهتمامات المشتركة، لإنشاء شرائح جمهور تمثّل أقسام شرائحك المستهدَفة.
تمثيل JSON |
---|
{ "resourceName": string, "id": string, "status": enum ( |
الحقول | |
---|---|
resourceName |
غير قابل للتغيير. اسم مورد الجمهور. تكون أسماء شرائح الجمهور على النحو التالي:
|
id |
النتائج فقط. رقم تعريف شريحة الجمهور. |
status |
النتائج فقط. حالة هذا الجمهور. يشير إلى ما إذا كانت شريحة الجمهور مفعَّلة أو تمت إزالتها. |
description |
وصف هذا الجمهور. |
dimensions[] |
سمات إيجابية تحدّد تكوين الجمهور |
exclusionDimension |
بُعد سلبي يحدد تكوين الجمهور. |
scope |
تُحدِّد النطاق الذي يمكن استخدام هذا الجمهور فيه. يكون النطاق هو CUSTOMER تلقائيًا. يمكن إنشاء شرائح الجمهور باستخدام نطاق ASSET_GROUP للاستخدام الحصري من قِبل مجموعة مواد عرض واحدة. يمكن تغيير النطاق من ASSET_GROUP إلى CUSTOMER ولكن ليس من CUSTOMER إلى ASSET_GROUP. |
assetGroup |
غير قابل للتغيير. مجموعة مواد العرض التي تمّ تحديد هذا الجمهور ضمنها. يجب تعيينه فقط إذا كان النطاق ASSET_GROUP. غير قابل للتغيير بعد الإنشاء. في حال ترقية جمهور بنطاق ASSET_GROUP إلى نطاق CUSTOMER، سيتم محو هذا الحقل تلقائيًا. |
name |
اسم الجمهور. ويجب أن يكون فريدًا على مستوى جميع شرائح الجمهور ضمن الحساب. يجب أن يبلغ الحد الأدنى للطول 1 والحد الأقصى للطول هو 255. مطلوب عندما لا يتم ضبط النطاق أو يتم ضبطه على CUSTOMER. لا يمكن التعيين أو تحديثه عندما يكون النطاق ASSET_GROUP |
AudienceStatus
قيم تعداد تتضمّن أنواع حالات الجمهور المحتملة
عمليات التعداد | |
---|---|
UNSPECIFIED |
غير محدَّد. |
UNKNOWN |
يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
ENABLED |
الحالة "مفعّلة": الجمهور مفعّل ويمكن استهدافه. |
REMOVED |
الحالة "تمت الإزالة" - تمت إزالة الجمهور ولا يمكن استخدامه للاستهداف. |
AudienceDimension
سمة إيجابية تحدّد جمهور المستخدم
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد dimension سمة تحدّد المستخدِمين الذين ينتمون إلى الجمهور. يمكن أن تكون السمة "dimension " واحدة فقط مما يلي: |
|
age |
سمة تحدد المستخدمين حسب أعمارهم. |
gender |
سمة تحدد المستخدمين حسب الجنس. |
householdIncome |
سمة تحدّد المستخدمين حسب دخل الأسرة. |
parentalStatus |
سمة تحدد المستخدمين حسب حالتهم الأبوية. |
audienceSegments |
سمة تحدّد المستخدمين حسب عضويتهم في شرائح الجمهور الأخرى. |
AgeDimension
سمة تحدد المستخدمين حسب أعمارهم.
تمثيل JSON |
---|
{
"ageRanges": [
{
object ( |
الحقول | |
---|---|
ageRanges[] |
الفئة العمرية المتجاورة التي يجب تضمينها في السمة. |
includeUndetermined |
تضمين المستخدمين الذين لم يتم تحديد عمرهم. |
AgeSegment
الفئة العمرية المتجاورة.
تمثيل JSON |
---|
{ "minAge": integer, "maxAge": integer } |
الحقول | |
---|---|
minAge |
الحد الأدنى للعمر المطلوب إدراجه يجب تحديد الحد الأدنى للعمر وألّا يقل عن 18 عامًا. القيم المسموح بها هي 18 و25 و35 و45 و55 و65. |
maxAge |
الحد الأقصى للسن المسموح به لا يلزم تحديد حد أقصى للعمر. في حال تحديد قيمة maxAge، يجب أن تكون أعلى من minAge، والقيم المسموح بها هي 24 و34 و44 و54 و64. |
GenderDimension
سمة تحدد المستخدمين حسب الجنس.
تمثيل JSON |
---|
{
"genders": [
enum ( |
الحقول | |
---|---|
genders[] |
تم تضمين شرائح الخصائص الديمغرافية المتعلقة بالجنس. |
includeUndetermined |
ويمكنك تضمين المستخدمين الذين لم يتم تحديد جنسهم. |
HouseholdIncomeDimension
سمة تحدّد المستخدمين حسب دخل الأسرة.
تمثيل JSON |
---|
{
"incomeRanges": [
enum ( |
الحقول | |
---|---|
incomeRanges[] |
تم تضمين شرائح ديموغرافية لدخل الأسرة. |
includeUndetermined |
تضمين المستخدمين الذين لم يتم تحديد دخل أسرتهم. |
ParentalStatusDimension
سمة تحدد المستخدمين حسب حالتهم الأبوية.
تمثيل JSON |
---|
{
"parentalStatuses": [
enum ( |
الحقول | |
---|---|
parentalStatuses[] |
تم تضمين شرائح الخصائص الديمغرافية للحالة الأبوية. |
includeUndetermined |
تضمين المستخدمين الذين لم يتم تحديد حالتهم الأبوية. |
AudienceSegmentDimension
سمة تحدّد المستخدمين حسب عضويتهم في شرائح الجمهور الأخرى.
تمثيل JSON |
---|
{
"segments": [
{
object ( |
الحقول | |
---|---|
segments[] |
شرائح الجمهور المضمّنة ويتم تضمين المستخدِمين إذا كانوا ينتمون إلى شريحة واحدة على الأقل. |
AudienceSegment
شريحة جمهور إيجابية.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد segment شريحة الجمهور الموجبة. يمكن أن تكون السمة "segment " واحدة فقط مما يلي: |
|
userList |
شريحة قائمة المستخدمين. |
userInterest |
شريحة من الجمهور ذي الاهتمامات المشتركة أو شريحة مرتبطة بالسوق |
lifeEvent |
شريحة من الجمهور لأحداث مباشرة |
detailedDemographic |
شريحة الخصائص الديمغرافية التفصيلية |
customAudience |
شريحة جمهور مخصّصة |
UserListSegment
شريحة قائمة المستخدمين. يبدأ إيقاف ميزة "الجمهور المشابه" في شهر أيار (مايو) 2023. يُرجى الرجوع إلى https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html للتعرّف على خيارات أخرى.
تمثيل JSON |
---|
{ "userList": string } |
الحقول | |
---|---|
userList |
مورد قائمة المستخدمين. |
UserInterestSegment
شريحة اهتمامات المستخدِمين:
تمثيل JSON |
---|
{ "userInterestCategory": string } |
الحقول | |
---|---|
userInterestCategory |
المرجع الخاص باهتمامات المستخدمين |
LifeEventSegment
شريحة الحدث المباشر
تمثيل JSON |
---|
{ "lifeEvent": string } |
الحقول | |
---|---|
lifeEvent |
مورد الأحداث في الحياة |
DetailedDemographicSegment
شريحة الخصائص الديمغرافية التفصيلية
تمثيل JSON |
---|
{ "detailedDemographic": string } |
الحقول | |
---|---|
detailedDemographic |
المورد الديموغرافي التفصيلي |
CustomAudienceSegment
شريحة جمهور مخصّصة
تمثيل JSON |
---|
{ "customAudience": string } |
الحقول | |
---|---|
customAudience |
مورد الجمهور المخصّص |
AudienceExclusionDimension
سمة سلبية تحدد المستخدمين لاستبعادها من الجمهور.
تمثيل JSON |
---|
{
"exclusions": [
{
object ( |
الحقول | |
---|---|
exclusions[] |
شريحة الجمهور المطلوب استبعادها. |
ExclusionSegment
شريحة جمهور مطلوب استبعادها من الجمهور.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد segment الشريحة المطلوب استبعادها. يمكن أن تكون السمة "segment " واحدة فقط مما يلي: |
|
userList |
شريحة قائمة المستخدمين المراد استبعادها |
AudienceScope
حقل التعداد الذي يتضمن قيم نطاق الجمهور المحتملة
عمليات التعداد | |
---|---|
UNSPECIFIED |
لم يتم تحديد النطاق. |
UNKNOWN |
القيمة التي تم استلامها غير معروفة في هذا الإصدار. |
CUSTOMER |
يتم تحديد الجمهور على مستوى العميل. |
ASSET_GROUP |
ويتم تحديد الجمهور ضمن مجموعة مواد عرض محدّدة. |