AdGroupCriterion

یک معیار گروه تبلیغاتی گزارش 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 )

وضعیت معیار.

این وضعیت موجودیت معیار گروه آگهی است که توسط مشتری تنظیم شده است. توجه: گزارش‌های UI ممکن است حاوی اطلاعات بیشتری باشد که بر واجد شرایط بودن یک معیار برای اجرا تأثیر می‌گذارد. در برخی موارد، معیاری که در API حذف شده است همچنان می‌تواند در رابط کاربری فعال نشان داده شود. به عنوان مثال، کمپین‌ها به‌طور پیش‌فرض به کاربران در تمام محدوده‌های سنی نشان داده می‌شوند، مگر اینکه حذف شوند. رابط کاربری هر محدوده سنی را به عنوان "فعال" نشان می دهد، زیرا آنها واجد شرایط دیدن تبلیغات هستند. اما AdGroupCriterion.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 )

فقط خروجی منبع پیشنهاد CPC موثر.

effectiveCpmBidSource

enum ( BiddingSource )

فقط خروجی منبع پیشنهاد CPM موثر.

effectiveCpvBidSource

enum ( BiddingSource )

فقط خروجی منبع پیشنهاد CPV موثر.

effectivePercentCpcBidSource

enum ( BiddingSource )

فقط خروجی منبع پیشنهاد درصد CPC موثر.

positionEstimates

object ( PositionEstimates )

فقط خروجی تخمین پیشنهادهای معیار در موقعیت های مختلف.

finalUrls[]

string

لیست URL های نهایی ممکن پس از همه تغییر مسیرهای بین دامنه ای برای تبلیغ.

finalMobileUrls[]

string

فهرست آدرس‌های اینترنتی نهایی تلفن همراه پس از همه تغییر مسیرهای بین دامنه‌ای.

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)

پیشنهاد CPC (هزینه به ازای هر کلیک).

cpmBidMicros

string ( int64 format)

پیشنهاد CPM (هزینه به ازای هر هزار نمایش قابل مشاهده).

cpvBidMicros

string ( int64 format)

پیشنهاد CPV (هزینه به ازای هر بازدید).

percentCpcBidMicros

string ( int64 format)

مبلغ پیشنهادی CPC، که به عنوان کسری از قیمت اعلام شده برای برخی کالاها یا خدمات بیان می شود. محدوده معتبر برای کسری [0،1) است و مقدار ذخیره شده در اینجا 1,000,000 * [کسری] است.

effectiveCpcBidMicros

string ( int64 format)

فقط خروجی پیشنهاد CPC موثر (هزینه به ازای هر کلیک).

effectiveCpmBidMicros

string ( int64 format)

فقط خروجی پیشنهاد CPM موثر (هزینه به ازای هر هزار نمایش قابل مشاهده).

effectiveCpvBidMicros

string ( int64 format)

فقط خروجی پیشنهاد CPV موثر (هزینه به ازای هر بازدید).

effectivePercentCpcBidMicros

string ( int64 format)

فقط خروجی مبلغ پیشنهادی درصد CPC موثر.

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 )

تغییرناپذیر. ویدیوی یوتیوب.

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 )

تغییرناپذیر. زبان.

AdGroupCriterionStatus

وضعیت های ممکن یک AdGroupCriterion.

Enums
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

وضعیت‌های سرویس‌دهی سیستم معیار را برمی‌شمارد.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN مقدار در این نسخه ناشناخته است.
ELIGIBLE واجد شرایط
RARELY_SERVED حجم کم جستجو

AdGroupCriterionApprovalStatus

وضعیت های تأیید AdGroupCriterion را برمی شمارد.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN مقدار در این نسخه ناشناخته است.
APPROVED تصویب شد.
DISAPPROVED تایید نشد.
PENDING_REVIEW در انتظار بررسی.
UNDER_REVIEW در دست بررسی.

تخمین موقعیت

تخمین پیشنهادهای معیار در موقعیت های مختلف.

نمایندگی JSON 
{
  "firstPageCpcMicros": string,
  "firstPositionCpcMicros": string,
  "topOfPageCpcMicros": string,
  "estimatedAddClicksAtFirstPositionCpc": string,
  "estimatedAddCostAtFirstPositionCpc": string
}
فیلدها
firstPageCpcMicros

string ( int64 format)

فقط خروجی تخمین پیشنهاد CPC مورد نیاز برای نمایش آگهی در صفحه اول نتایج جستجو.

firstPositionCpcMicros

string ( int64 format)

فقط خروجی تخمین پیشنهاد CPC مورد نیاز برای نمایش آگهی در موقعیت اول، در بالای صفحه اول نتایج جستجو.

topOfPageCpcMicros

string ( int64 format)

فقط خروجی تخمین پیشنهاد CPC مورد نیاز برای نمایش آگهی در بالای صفحه اول نتایج جستجو.

estimatedAddClicksAtFirstPositionCpc

string ( int64 format)

فقط خروجی تخمین بزنید که با تغییر پیشنهاد کلمه کلیدی خود به مقدار در firstPositionCpcMicros، چند کلیک در هفته ممکن است داشته باشید.

estimatedAddCostAtFirstPositionCpc

string ( int64 format)

فقط خروجی زمانی که پیشنهاد کلمه کلیدی خود را به مقدار در firstPositionCpcMicros تغییر می‌دهید، هزینه‌های شما در هفته چگونه ممکن است تغییر کند.

AdGroupCriterionPrimaryStatus

Enum وضعیت اولیه معیار گروه آگهی ممکن را توصیف می کند. بینشی در مورد اینکه چرا یک معیار گروه تبلیغاتی به طور بهینه ارائه نمی شود یا ارائه نمی دهد.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
ELIGIBLE معیار گروه آگهی واجد شرایط ارائه است.
PAUSED معیار گروه آگهی متوقف شده است.
REMOVED معیار گروه آگهی حذف شده است.
PENDING معیار گروه آگهی در انتظار است.
NOT_ELIGIBLE معیار گروه آگهی واجد شرایط ارائه نیست.

AdGroupCriterionPrimaryStatusReason

فهرستی که دلایل احتمالی وضعیت اولیه معیار گروه آگهی را توضیح می دهد. بینشی در مورد اینکه چرا یک معیار گروه تبلیغاتی به طور بهینه ارائه نمی شود یا ارائه نمی دهد. این دلایل برای تعیین وضعیت اولیه کلی معیار گروه آگهی جمع‌آوری می‌شوند.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
CAMPAIGN_PENDING زمان مشخص شده توسط کاربر برای شروع این کمپین در آینده است. به AdGroupCriterionPrimaryStatus.PENDING کمک می کند.
CAMPAIGN_CRITERION_NEGATIVE معیار گروه تبلیغاتی با معیار کمپین منفی لغو می شود. به AdGroupCriterionPrimaryStatus کمک می کند.NOT_ELIGIBLE.
CAMPAIGN_PAUSED وضعیت کمپین مشخص شده توسط کاربر متوقف شده است. به AdGroupCriterionPrimaryStatus.PAUSED کمک می کند.
CAMPAIGN_REMOVED وضعیت کمپین مشخص شده توسط کاربر حذف شده است. به AdGroupCriterionPrimaryStatus.REMOVED کمک می کند.
CAMPAIGN_ENDED زمان مشخص شده توسط کاربر برای پایان این کمپین گذشته است. به AdGroupCriterionPrimaryStatus.ENDED کمک می کند.
AD_GROUP_PAUSED وضعیت گروه آگهی مشخص شده توسط کاربر متوقف شده است. به AdGroupCriterionPrimaryStatus.PAUSED کمک می کند.
AD_GROUP_REMOVED وضعیت گروه تبلیغاتی مشخص شده توسط کاربر حذف می شود. به AdGroupCriterionPrimaryStatus.REMOVED کمک می کند.
AD_GROUP_CRITERION_DISAPPROVED معیار گروه آگهی توسط سیستم تأیید آگهی تأیید نشده است. به AdGroupCriterionPrimaryStatus کمک می کند.NOT_ELIGIBLE.
AD_GROUP_CRITERION_RARELY_SERVED معیار گروه آگهی به ندرت ارائه می شود. به AdGroupCriterionPrimaryStatus کمک می کند.NOT_ELIGIBLE.
AD_GROUP_CRITERION_LOW_QUALITY معیار گروه آگهی دارای امتیاز کیفیت پایین است. به AdGroupCriterionPrimaryStatus.LIMITED کمک می کند.
AD_GROUP_CRITERION_UNDER_REVIEW معیار گروه آگهی در دست بررسی است. به AdGroupCriterionPrimaryStatus.PENDING کمک می کند.
AD_GROUP_CRITERION_PENDING_REVIEW معیار گروه آگهی در انتظار بررسی است. به AdGroupCriterionPrimaryStatus کمک می کند.NOT_ELIGIBLE.
AD_GROUP_CRITERION_BELOW_FIRST_PAGE_BID قیمت پیشنهادی معیار گروه آگهی کمتر از مقدار لازم برای نمایش در صفحه اول است. به AdGroupCriterionPrimaryStatus.LIMITED کمک می کند.
AD_GROUP_CRITERION_NEGATIVE معیار گروه آگهی منفی است. به AdGroupCriterionPrimaryStatus کمک می کند.NOT_ELIGIBLE.
AD_GROUP_CRITERION_RESTRICTED معیار گروه آگهی محدود است. به AdGroupCriterionPrimaryStatus کمک می کند.NOT_ELIGIBLE.
AD_GROUP_CRITERION_PAUSED وضعیت معیار گروه آگهی مشخص شده توسط کاربر متوقف شده است. به AdGroupCriterionPrimaryStatus.PAUSED کمک می کند.
AD_GROUP_CRITERION_PAUSED_DUE_TO_LOW_ACTIVITY معیار گروه آگهی به دلیل فعالیت کم طولانی مدت در ارائه موقتاً متوقف شده است. به AdGroupCriterionPrimaryStatus.PAUSED کمک می کند.
AD_GROUP_CRITERION_REMOVED وضعیت معیار گروه آگهی مشخص شده توسط کاربر حذف شده است. به AdGroupCriterionPrimaryStatus.REMOVED کمک می کند.

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

نوع گروه فهرست.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
SUBDIVISION تقسیم بندی محصولات در امتداد برخی از ابعاد فهرست بندی. این گره ها با ارائه خدمات برای ورودی های فهرست بندی مورد استفاده قرار نمی گیرند، بلکه صرفاً برای تعریف ساختار درخت هستند.
UNIT فهرست کردن واحد گروه که یک پیشنهاد را تعریف می کند.

ListingDimensionPath

مسیر ابعادی که یک گروه لیست را تعریف می کند.

نمایندگی JSON 
{
  "dimensions": [
    {
      object (ListingDimensionInfo)
    }
  ]
}
فیلدها
dimensions[]

object ( ListingDimensionInfo )

مسیر کامل ابعاد از طریق سلسله مراتب گروه لیست، از ریشه (به استثنای خود ریشه) تا این گروه فهرست.

AppPaymentModelInfo

معیار مدل پرداخت اپلیکیشن

نمایندگی JSON 
{
  "type": enum (AppPaymentModelType)
}
فیلدها
type

enum ( AppPaymentModelType )

نوع مدل پرداخت اپلیکیشن

AppPaymentModelType

Enum مدل‌های پرداخت احتمالی برنامه را توصیف می‌کند.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
PAID نشان دهنده برنامه های پولی است.

CustomIntentInfo

یک معیار قصد سفارشی معیاری از این نوع فقط قابل هدف است.

نمایندگی JSON 
{
  "customIntent": string
}
فیلدها
customIntent

string

نام منبع CustomInterest.