- تمثيل 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 |
الحد الأقصى للعمر المطلوب إدراجه لا يلزم تحديد حد أقصى للعمر. وفي حال تحديد ذلك، يجب أن يكون الحدّ الأقصى للعمر أكبر من الحد الأدنى للعمر، وتكون القيم المسموح بها هي 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 |
يتم تحديد الجمهور ضمن مجموعة مواد عرض محدّدة. |