AdGroupCriterion

معيار مجموعة إعلانية. لا يعرض تقرير معيار المجموعة الإعلانية سوى المعايير التي تمت إضافتها بشكلٍ صريح إلى المجموعة الإعلانية.

تمثيل JSON 
{
  "resourceName": string,
  "displayName": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "systemServingStatus": enum (CriterionSystemServingStatus),
  "approvalStatus": enum (AdGroupCriterionApprovalStatus),
  "disapprovalReasons": [
    string
  ],
  "labels": [
    string
  ],
  "effectiveCpcBidSource": enum (BiddingSource),
  "effectiveCpmBidSource": enum (BiddingSource),
  "effectiveCpvBidSource": enum (BiddingSource),
  "effectivePercentCpcBidSource": enum (BiddingSource),
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "cpmBidMicros": string,
  "cpvBidMicros": string,
  "percentCpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "effectiveCpmBidMicros": string,
  "effectiveCpvBidMicros": string,
  "effectivePercentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "placement": {
    object (PlacementInfo)
  },
  "mobileAppCategory": {
    object (MobileAppCategoryInfo)
  },
  "mobileApplication": {
    object (MobileApplicationInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "incomeRange": {
    object (IncomeRangeInfo)
  },
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "youtubeVideo": {
    object (YouTubeVideoInfo)
  },
  "youtubeChannel": {
    object (YouTubeChannelInfo)
  },
  "topic": {
    object (TopicInfo)
  },
  "userInterest": {
    object (UserInterestInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "appPaymentModel": {
    object (AppPaymentModelInfo)
  },
  "customAffinity": {
    object (CustomAffinityInfo)
  },
  "customIntent": {
    object (CustomIntentInfo)
  },
  "customAudience": {
    object (CustomAudienceInfo)
  },
  "combinedAudience": {
    object (CombinedAudienceInfo)
  },
  "audience": {
    object (AudienceInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "language": {
    object (LanguageInfo)
  }
  // End of list of possible types for union field criterion.
}
الحقول
resourceName

string

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

customers/{customerId}/adGroupCriteria/{adGroupId}~{criterionId}
displayName

string

النتائج فقط. الاسم المعروض للمعيار.

يتم تجاهل هذا الحقل لعمليات التبديل.
status

enum (AdGroupCriterionStatus)

حالة المعيار.

هذه هي حالة كيان معيار المجموعة الإعلانية، الذي حدّده العميل. ملاحظة: قد تتضمّن تقارير واجهة المستخدم معلومات إضافية تؤثّر في ما إذا كان المعيار مؤهَّلاً للعرض. في بعض الحالات، ما زال المعيار الذي تمت إزالته في واجهة برمجة التطبيقات يظهر على أنّه مفعّل في واجهة المستخدم. على سبيل المثال، يتم عرض الحملات تلقائيًا للمستخدمين من جميع الفئات العمرية ما لم يتم استبعادها. ستعرض واجهة المستخدم كل فئة عمرية على أنها "مفعّلة"، بما أنها مؤهَّلة لمشاهدة الإعلانات، إلا أنّ حالة قاعدة بيانات الإعلان: "تمت الإزالة"، بسبب عدم إضافة أي معيار إيجابي.
qualityInfo

object (QualityInfo)

النتائج فقط. تمثّل هذه السمة معلومات عن جودة المعيار.
type

enum (CriterionType)

النتائج فقط. نوع المعيار.
systemServingStatus

enum (CriterionSystemServingStatus)

النتائج فقط. حالة عرض المعيار
approvalStatus

enum (AdGroupCriterionApprovalStatus)

النتائج فقط. حالة الموافقة على المعيار
disapprovalReasons[]

string

النتائج فقط. قائمة بأسباب رفض المعيار

يمكن الاطّلاع على الأسباب المختلفة لرفض معيار على الرابط التالي: https://support.google.com/adspolicy/answer/6008942

هذا الحقل للقراءة فقط.
labels[]

string

النتائج فقط. أسماء موارد التصنيفات المرفقة بمعيار المجموعة الإعلانية هذا.
effectiveCpcBidSource

enum (BiddingSource)

النتائج فقط. مصدر عرض السعر الفعال للنقرة.
effectiveCpmBidSource

enum (BiddingSource)

النتائج فقط. مصدر عرض السعر الفعال لكل ألف ظهور.
effectiveCpvBidSource

enum (BiddingSource)

النتائج فقط. مصدر عرض سعر المشاهدة الفعّال.
effectivePercentCpcBidSource

enum (BiddingSource)

النتائج فقط. مصدر عرض السعر الفعال للنقرة بالنسبة المئوية.
positionEstimates

object (PositionEstimates)

النتائج فقط. تقديرات عروض أسعار المعايير في مواضع مختلفة.
finalUrls[]

string

قائمة عناوين URL النهائية المحتملة بعد جميع عمليات إعادة التوجيه عبر النطاقات للإعلان.
finalMobileUrls[]

string

قائمة بعناوين URL النهائية للجوّال بعد جميع عمليات إعادة التوجيه عبر النطاقات.
urlCustomParameters[]

object (CustomParameter)

قائمة عمليات الربط المستخدَمة لاستبدال علامات المَعلمات المخصَّصة في trackingUrlTemplate أو finalUrls أو mobile_final_urls.
criterionId

string (int64 format)

النتائج فقط. رقم تعريف المعيار.

يتم تجاهل هذا الحقل لعمليات التبديل.
adGroup

string

غير قابل للتغيير. المجموعة الإعلانية التي ينتمي إليها المعيار.
negative

boolean

غير قابل للتغيير. تحديد ما إذا كان سيتم استهداف (false) أو استبعاد (true) المعيار.

هذا الحقل غير قابل للتغيير. لتبديل معيار من موجب إلى سالب، عليك إزالته ثم إعادة إضافته.
bidModifier

number

معدِّل عرض السعر عندما يتطابق المعيار. يجب أن يكون المعدَّل ضمن النطاق: 0.1 - 10.0. تتوافق معظم أنواع المعايير القابلة للاستهداف مع المعدِّلات.
cpcBidMicros

string (int64 format)

عرض سعر النقرة.
cpmBidMicros

string (int64 format)

عرض السعر لكل ألف ظهور.
cpvBidMicros

string (int64 format)

عرض سعر المشاهدة.
percentCpcBidMicros

string (int64 format)

مبلغ عرض سعر النقرة، يتم التعبير عنه كجزء من السعر المُعلَن عنه لبعض السلع أو الخدمات. النطاق الصالح للكسر هو [0,1) والقيمة المخزنة هنا هي 1,000,000 * [fraction].
effectiveCpcBidMicros

string (int64 format)

النتائج فقط. عرض سعر النقرة الفعّال.
effectiveCpmBidMicros

string (int64 format)

النتائج فقط. عرض سعر التكلفة الفعلية لكل ألف ظهور.
effectiveCpvBidMicros

string (int64 format)

النتائج فقط. عرض سعر المشاهدة الفعّال
effectivePercentCpcBidMicros

string (int64 format)

النتائج فقط. مبلغ عرض السعر الفعلي للنقرة.
finalUrlSuffix

string

نموذج عنوان URL لإلحاق المَعلمات برابط عنوان URL النهائي
trackingUrlTemplate

string

نموذج عنوان URL لإنشاء عنوان URL للتتبّع.

حقل الاتحاد criterion معيار المجموعة الإعلانية.

يجب ضبط واحد بالضبط. يمكن أن يكون الحقل "criterion" واحدًا فقط مما يلي:
keyword

object (KeywordInfo)

غير قابل للتغيير. الكلمة الرئيسية.
placement

object (PlacementInfo)

غير قابل للتغيير. الموضع:
mobileAppCategory

object (MobileAppCategoryInfo)

غير قابل للتغيير. فئة تطبيقات الأجهزة الجوّالة.
mobileApplication

object (MobileApplicationInfo)

غير قابل للتغيير. تطبيق للأجهزة الجوّالة.
listingGroup

object (ListingGroupInfo)

غير قابل للتغيير. مجموعة البيانات
ageRange

object (AgeRangeInfo)

غير قابل للتغيير. الفئة العمرية.
gender

object (GenderInfo)

غير قابل للتغيير. الجنس.
incomeRange

object (IncomeRangeInfo)

غير قابل للتغيير. نطاق الدخل.
parentalStatus

object (ParentalStatusInfo)

غير قابل للتغيير. الحالة الأبوية.
userList

object (UserListInfo)

غير قابل للتغيير. قائمة المستخدمين.
youtubeVideo

object (YouTubeVideoInfo)

غير قابل للتغيير. فيديو YouTube
youtubeChannel

object (YouTubeChannelInfo)

غير قابل للتغيير. قناة YouTube
topic

object (TopicInfo)

غير قابل للتغيير. الموضوع.
userInterest

object (UserInterestInfo)

غير قابل للتغيير. اهتمام المستخدم
webpage

object (WebpageInfo)

غير قابل للتغيير. صفحة ويب
appPaymentModel

object (AppPaymentModelInfo)

غير قابل للتغيير. نموذج دفع رسوم التطبيق
customAffinity

object (CustomAffinityInfo)

غير قابل للتغيير. الجمهور المخصّص ذو اهتمامات مشتركة.
customIntent

object (CustomIntentInfo)

غير قابل للتغيير. مخصّص حسب نيّة الشراء.
customAudience

object (CustomAudienceInfo)

غير قابل للتغيير. الجمهور المخصّص:
combinedAudience

object (CombinedAudienceInfo)

غير قابل للتغيير. الجمهور المشترك.
audience

object (AudienceInfo)

غير قابل للتغيير. الجمهور
location

object (LocationInfo)

غير قابل للتغيير. الموقع الجغرافي.
language

object (LanguageInfo)

غير قابل للتغيير. اللغة

AdGroupCriterionStatus

الحالات المحتملة لمعيار المجموعة الإعلانية.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة.
UNKNOWN

القيمة المُستلَمة غير معروفة في هذا الإصدار.

هذه قيمة للاستجابة فقط.
ENABLED معيار المجموعة الإعلانية مفعّل.
PAUSED معيار المجموعة الإعلانية متوقف مؤقتًا.
REMOVED تتم إزالة معيار المجموعة الإعلانية.

QualityInfo

حاوية لمعلومات جودة معايير المجموعة الإعلانية

تمثيل JSON 
{
  "creativeQualityScore": enum (QualityScoreBucket),
  "postClickQualityScore": enum (QualityScoreBucket),
  "searchPredictedCtr": enum (QualityScoreBucket),
  "qualityScore": integer
}
الحقول
creativeQualityScore

enum (QualityScoreBucket)

النتائج فقط. أداء الإعلان مقارنةً بالمعلنين الآخرين.
postClickQualityScore

enum (QualityScoreBucket)

النتائج فقط. نقاط جودة الصفحة المقصودة.
searchPredictedCtr

enum (QualityScoreBucket)

النتائج فقط. نسبة النقر إلى الظهور مقارنةً لنسبة النقر إلى الظهور الخاصة بالمعلنين الآخرين.
qualityScore

integer

النتائج فقط. نقاط الجودة.

قد لا تتم تعبئة هذا الحقل إذا لم يكن لدى Google معلومات كافية لتحديد قيمة.

CriterionSystemServingStatus

لتعداد حالات عرض نظام المعيار.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN القيمة غير معروفة في هذا الإصدار.
ELIGIBLE مؤهل
RARELY_SERVED حجم البحث منخفض.

AdGroupCriterionApprovalStatus

لتعداد حالات الموافقة على معيار المجموعة الإعلانية.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN القيمة غير معروفة في هذا الإصدار.
APPROVED موافَق عليه.
DISAPPROVED مرفوض.
PENDING_REVIEW في انتظار المراجعة.
UNDER_REVIEW قيد المراجعة.

PositionEstimates

تقديرات عروض أسعار المعايير في مواضع مختلفة.

تمثيل JSON 
{
  "firstPageCpcMicros": string,
  "firstPositionCpcMicros": string,
  "topOfPageCpcMicros": string,
  "estimatedAddClicksAtFirstPositionCpc": string,
  "estimatedAddCostAtFirstPositionCpc": string
}
الحقول
firstPageCpcMicros

string (int64 format)

النتائج فقط. تقدير عرض سعر النقرة المطلوب لظهور الإعلان في الصفحة الأولى من نتائج البحث.
firstPositionCpcMicros

string (int64 format)

النتائج فقط. تقدير عرض سعر النقرة المطلوب لعرض الإعلان في الموضع الأعلى، أعلى الصفحة الأولى من نتائج البحث.
topOfPageCpcMicros

string (int64 format)

النتائج فقط. تقدير عرض سعر النقرة المطلوب لعرض الإعلان أعلى الصفحة الأولى من نتائج البحث.
estimatedAddClicksAtFirstPositionCpc

string (int64 format)

النتائج فقط. تقدير عدد النقرات التي قد تحصل عليها أسبوعيًا عند تغيير عرض سعر الكلمة الرئيسية إلى القيمة في firstPositionCpcMicros.
estimatedAddCostAtFirstPositionCpc

string (int64 format)

النتائج فقط. تقدير لكيفية تغيّر التكلفة في الأسبوع عند تغيير عرض سعر الكلمة الرئيسية إلى القيمة في firstPositionCpcMicros.

ListingGroupInfo

معيار مجموعة بيانات.

تمثيل JSON 
{
  "type": enum (ListingGroupType),
  "caseValue": {
    object (ListingDimensionInfo)
  },
  "parentAdGroupCriterion": string,
  "path": {
    object (ListingDimensionPath)
  }
}
الحقول
type

enum (ListingGroupType)

نوع مجموعة البيانات
caseValue

object (ListingDimensionInfo)

قيمة السمة التي تعمل بها مجموعة البيانات هذه على تحسين عنصرها الرئيسي. غير معرَّف للمجموعة الجذر.
parentAdGroupCriterion

string

اسم المورد لمعيار المجموعة الإعلانية، وهو القسم الفرعي من مجموعة البيانات الرئيسية. قيمة فارغة للمجموعة الجذر.
path

object (ListingDimensionPath)

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

ListingGroupType

نوع مجموعة البيانات.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
SUBDIVISION قسم فرعي من المنتجات إلى جانب بعض سمات البيانات لا تُستخدم هذه العُقد عن طريق العرض على إدخالات قائمة الهدف، ولكنها تُستخدم فقط لتعريف هيكل الشجرة.
UNIT وحدة مجموعة البيانات التي تحدِّد عرض السعر.

ListingDimensionPath

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

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

object (ListingDimensionInfo)

المسار الكامل للسمات من خلال العرض الهرمي لمجموعة البيانات، من الجذر (باستثناء الجذر نفسه) إلى مجموعة البيانات هذه.

AppPaymentModelInfo

معيار نموذج الدفع للتطبيق

تمثيل JSON 
{
  "type": enum (AppPaymentModelType)
}
الحقول
type

enum (AppPaymentModelType)

نوع نموذج الدفع للتطبيق

AppPaymentModelType

يشير هذا التعداد إلى وصف نماذج الدفع المحتملة للتطبيقات.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
PAID يُمثِّل هذه السمة التطبيقات المدفوعة.

CustomIntentInfo

معيار مخصّص حسب نيّة الشراء. لا يمكن استهداف معيار من هذا النوع إلا.

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

string

اسم المورد Custominterest (اسم المورد المخصّص للاهتمامات).