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)

הסטטוס של הקריטריון.

זהו הסטטוס של ישות הקריטריון של קבוצת המודעות, שהוגדרה על ידי הלקוח. הערה: יכול להיות שבדוחות בממשק המשתמש יש מידע נוסף שמשפיע על העמידה של קריטריון מסוים. במקרים מסוימים, קריטריון שהוסר מ-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)

פלט בלבד. המקור של הצעת המחיר בפועל לקליק.
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)

הצעת המחיר לקליק (CPC).
cpmBidMicros

string (int64 format)

הצעת המחיר לאלף חשיפות הניתנות לצפייה (vCPM).
cpvBidMicros

string (int64 format)

הצעת המחיר של עלות לצפייה (CPV).
percentCpcBidMicros

string (int64 format)

סכום הצעת המחיר לקליק, מבוטאת כשבר מהמחיר שפורסם עבור מוצר או שירות כלשהו. הטווח החוקי של השבר הוא [0,1) והערך שמאוחסן כאן הוא 1,000,000 * [fraction].
effectiveCpcBidMicros

string (int64 format)

פלט בלבד. הצעת המחיר האפקטיבית לקליק.
effectiveCpmBidMicros

string (int64 format)

פלט בלבד. הצעת המחיר בפועל לאלף חשיפות (CPM) (עלות לאלף חשיפות הניתנות לצפייה).
effectiveCpvBidMicros

string (int64 format)

פלט בלבד. הצעת המחיר האפקטיבית לצפייה (CPV).
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

הסטטוסים האפשריים של קבוצת מודעות.

טיפוסים בני מנייה (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

מציין את סטטוס האישור של קבוצת המודעות.

טיפוסים בני מנייה (enums)
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

שם המשאב של קריטריון של קבוצת מודעות, שהוא חלוקת המשנה של הקבוצה של כרטיסי המוצר ברמה העליונה. null בקבוצת הבסיס.
path

object (ListingDimensionPath)

נתיב המאפיינים המגדירים את הקבוצה הזו של כרטיסי מוצר.

ListingGroupType

סוג הקבוצה של כרטיסי המוצר.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
SUBDIVISION חלוקת משנה של מוצרים לאורך מאפיין מסוים של כרטיס המוצר. הצמתים האלה לא משמשים לצורך טירגוט ערכים של רישומים, אלא רק כדי להגדיר את מבנה העץ.
UNIT יחידה של קבוצה של כרטיסי מוצר שמגדירה הצעת מחיר.

ListingDimensionPath

נתיב המאפיינים המגדירים קבוצה של כרטיסי מוצר.

ייצוג JSON 
{
  "dimensions": [
    {
      object (ListingDimensionInfo)
    }
  ]
}
שדות
dimensions[]

object (ListingDimensionInfo)

הנתיב המלא של מאפיינים בהיררכיה של הקבוצה של כרטיסי המוצר, מהרמה הבסיסית (root) (לא כולל הרמה הבסיסית) ועד לקבוצה הזו של כרטיסי המוצר.

AppPaymentModelInfo

קריטריון של מודל תשלום לאפליקציה.

ייצוג JSON 
{
  "type": enum (AppPaymentModelType)
}
שדות
type

enum (AppPaymentModelType)

סוג מודל התשלום של האפליקציה.

AppPaymentModelType

דוגמאות למודלים אפשריים של תשלום באפליקציות.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
PAID מייצגות אפליקציות בתשלום.

CustomIntentInfo

קריטריון בהתאמה אישית עם כוונת רכישה. ניתן לטרגט קריטריון מהסוג הזה בלבד.

ייצוג JSON 
{
  "customIntent": string
}
שדות
customIntent

string

שם המשאב של תחום עניין בהתאמה אישית.