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)
    }
  ],
  "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 )

وضعیت معیار.

این وضعیت موجودیت معیار گروه آگهی است که توسط مشتری تنظیم شده است. توجه: گزارش‌های 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 استفاده می‌شوند.

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 ردیابی.

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 تغییر می‌دهید، هزینه‌های شما در هفته چگونه ممکن است تغییر کند.

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.