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)
    }
  ],
  "primaryStatusReasons": [
    enum (AdGroupCriterionPrimaryStatusReason)
  ],
  "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,
  "primaryStatus": enum (AdGroupCriterionPrimaryStatus),

  // 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)

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

هذه هي حالة كيان معيار المجموعة الإعلانية التي ضبطها العميل. ملاحظة: قد تتضمّن تقارير واجهة المستخدم معلومات إضافية تؤثّر في ما إذا كان المعيار مؤهَّلاً للتشغيل. في بعض الحالات، قد يستمر عرض معيار تمت إزالته في واجهة برمجة التطبيقات على أنّه مفعّل في واجهة المستخدم. على سبيل المثال، تظهر الحملات تلقائيًا للمستخدمين من جميع الفئات العمرية ما لم يتم استبعادها. ستظهَر واجهة المستخدِم على أنّها "مفعَّلة" لكلّ فئة عمرية، لأنّهم مؤهَّلون لرؤية الإعلانات. لكن AdGroupCategory.status ستعرض "تمت الإزالة" بسبب عدم إضافة معيار موجب.
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
primaryStatusReasons[]

enum (AdGroupCriterionPrimaryStatusReason)

النتائج فقط. أسباب الحالة الأساسية لمعيار المجموعة الإعلانية.
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)

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

string (int64 format)

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

string

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

string

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

enum (AdGroupCriterionPrimaryStatus)

النتائج فقط. الحالة الأساسية لمعيار المجموعة الإعلانية.

حقل الاتحاد 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.

AdGroupCriterionPrimaryStatus

رقم تعداد يصف الحالة الأساسية المحتملة لمعيار المجموعة الإعلانية. توفِّر إحصاءات عن سبب عدم عرض معيار على مستوى المجموعة الإعلانية أو عدم عرضه على النحو الأمثل.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
ELIGIBLE معيار المجموعة الإعلانية مؤهَّل للعرض.
PAUSED معيار المجموعة الإعلانية متوقف مؤقتًا.
REMOVED تمت إزالة معيار المجموعة الإعلانية.
PENDING معيار المجموعة الإعلانية في انتظار المراجعة.
NOT_ELIGIBLE معيار المجموعة الإعلانية غير مؤهَّل للعرض.

AdGroupCriterionPrimaryStatusReason

رقم تعداد يصف الأسباب الأساسية المحتملة للحالة الأساسية لمعيار المجموعة الإعلانية. يوفِّر هذا التقرير إحصاءات عن سبب عدم عرض معيار المجموعة الإعلانية أو عدم عرضه بالشكل الأمثل. ويتم تجميع هذه الأسباب لتحديد الحالة الأساسية العامة لمعيار المجموعة الإعلانية.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثل قيمة غير معروفة في هذا الإصدار.
CAMPAIGN_PENDING الوقت الذي حدّده المستخدم لبدء هذه الحملة هو في المستقبل. المساهمة في AdGroupcriterionPrimaryStatus.Pending.
CAMPAIGN_CRITERION_NEGATIVE تم إلغاء معيار المجموعة الإعلانية من خلال معيار الحملة السلبية. تساهم في AdGroupCategoryPrimaryStatus.NOT_eligibility.
CAMPAIGN_PAUSED حالة الحملة المحدّدة من جانب المستخدم متوقفة مؤقتًا. تساهم في AdGroupCategoryPrimaryStatus.PAالمستخدم.
CAMPAIGN_REMOVED تمت إزالة حالة الحملة المحدّدة من قِبل المستخدم. المساهمة في AdGroupReferencePrimaryStatus.تمّت الإزالة
CAMPAIGN_ENDED لقد انقضى الوقت الذي حدّده المستخدم لانتهاء هذه الحملة. تساهم في AdGroupCategoryPrimaryStatus.ENDED.
AD_GROUP_PAUSED حالة المجموعة الإعلانية التي يحددها المستخدم متوقفة مؤقتًا. تساهم في AdGroupCategoryPrimaryStatus.PAالمستخدم.
AD_GROUP_REMOVED تتم إزالة حالة المجموعة الإعلانية التي حدّدها المستخدم. المساهمة في AdGroupReferencePrimaryStatus.تمّت الإزالة
AD_GROUP_CRITERION_DISAPPROVED تم رفض معيار المجموعة الإعلانية من قِبل نظام الموافقة على الإعلانات. تساهم في AdGroupCategoryPrimaryStatus.NOT_eligibility.
AD_GROUP_CRITERION_RARELY_SERVED نادرًا ما يتم عرض معيار المجموعة الإعلانية. تساهم في AdGroupCategoryPrimaryStatus.NOT_eligibility.
AD_GROUP_CRITERION_LOW_QUALITY نقاط جودة منخفضة لمعيار المجموعة الإعلانية. يساهم في AdGroupOrganizationPrimaryStatus.LIMITED.
AD_GROUP_CRITERION_UNDER_REVIEW معيار المجموعة الإعلانية قيد المراجعة. المساهمة في AdGroupcriterionPrimaryStatus.Pending.
AD_GROUP_CRITERION_PENDING_REVIEW معيار المجموعة الإعلانية في انتظار المراجعة. تساهم في AdGroupCategoryPrimaryStatus.NOT_eligibility.
AD_GROUP_CRITERION_BELOW_FIRST_PAGE_BID عرض سعر معيار المجموعة الإعلانية أقل من القيمة اللازمة لعرض الإعلانات على الصفحة الأولى. يساهم في AdGroupOrganizationPrimaryStatus.LIMITED.
AD_GROUP_CRITERION_NEGATIVE معيار المجموعة الإعلانية سالب. تساهم في AdGroupCategoryPrimaryStatus.NOT_eligibility.
AD_GROUP_CRITERION_RESTRICTED معيار المجموعة الإعلانية محظور. تساهم في AdGroupCategoryPrimaryStatus.NOT_eligibility.
AD_GROUP_CRITERION_PAUSED حالة معيار المجموعة الإعلانية التي يحددها المستخدم متوقفة مؤقتًا. تساهم في AdGroupCategoryPrimaryStatus.PAالمستخدم.
AD_GROUP_CRITERION_PAUSED_DUE_TO_LOW_ACTIVITY تم إيقاف معيار المجموعة الإعلانية مؤقتًا بسبب انخفاض النشاط لفترة طويلة في العرض. تساهم في AdGroupCategoryPrimaryStatus.PAالمستخدم.
AD_GROUP_CRITERION_REMOVED تمت إزالة حالة معيار المجموعة الإعلانية التي حدّدها المستخدم. المساهمة في AdGroupReferencePrimaryStatus.تمّت الإزالة

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