AdGroup

קבוצת מודעות.

ייצוג JSON 
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "optimizedTargetingEnabled": boolean,
  "displayCustomBidDimension": enum (TargetingDimension),
  "targetingSetting": {
    object (TargetingSetting)
  },
  "audienceSetting": {
    object (AudienceSetting)
  },
  "effectiveTargetCpaSource": enum (BiddingSource),
  "effectiveTargetRoasSource": enum (BiddingSource),
  "labels": [
    string
  ],
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "primaryStatus": enum (AdGroupPrimaryStatus),
  "primaryStatusReasons": [
    enum (AdGroupPrimaryStatusReason)
  ],
  "id": string,
  "name": string,
  "baseAdGroup": string,
  "trackingUrlTemplate": string,
  "campaign": string,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "cpmBidMicros": string,
  "targetCpaMicros": string,
  "cpvBidMicros": string,
  "targetCpmMicros": string,
  "targetRoas": number,
  "percentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "effectiveTargetCpaMicros": string,
  "effectiveTargetRoas": number
}
שדות
resourceName

string

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

customers/{customerId}/adGroups/{adGroupId}
status

enum (AdGroupStatus)

הסטטוס של קבוצת המודעות.
type

enum (AdGroupType)

בלתי משתנה. הסוג של קבוצת המודעות.
adRotationMode

enum (AdGroupAdRotationMode)

מצב סבב המודעות של קבוצת המודעות.
urlCustomParameters[]

object (CustomParameter)

רשימת המיפויים שמשמשת להחלפת תגי פרמטרים מותאמים אישית ב-trackingUrlTemplate, ב-finalUrls או ב-mobile_final_urls.
optimizedTargetingEnabled

boolean

הערך הוא True אם מופעלת אופטימיזציית טירגוט. אופטימיזציית הטירגוט תחליף את התכונה 'הרחבת קהל'.
displayCustomBidDimension

enum (TargetingDimension)

מאפשר למפרסמים לציין מאפיין מיקוד שבו יגדירו הצעות מחיר מוחלטות. הדבר רלוונטי רק לקמפיינים שמטרגטים רק את רשת המדיה, ולא את רשת החיפוש.
targetingSetting

object (TargetingSetting)

הגדרה לטירגוט לתכונות קשורות.
audienceSetting

object (AudienceSetting)

בלתי משתנה. הגדרה לתכונות שקשורות לקהל.
effectiveTargetCpaSource

enum (BiddingSource)

פלט בלבד. המקור של יעד העלות להמרה בפועל. השדה הזה הוא לקריאה בלבד.
effectiveTargetRoasSource

enum (BiddingSource)

פלט בלבד. המקור של יעד ההחזר בפועל על הוצאות הפרסום. השדה הזה הוא לקריאה בלבד.
labels[]

string

פלט בלבד. שמות המשאבים של התוויות שמצורפות לקבוצת המודעות הזו.
excludedParentAssetFieldTypes[]

enum (AssetFieldType)

סוגי השדות של הנכסים שצריך להחריג מקבוצת המודעות הזו. קישורי נכסים עם סוגי השדות האלה לא יעברו בירושה לקבוצת המודעות הזו מהרמות העליונות.
excludedParentAssetSetTypes[]

enum (AssetSetType)

הסוגים של קבוצות הנכסים שצריך להחריג מקבוצת המודעות הזו. קישורים לקבוצות נכסים מהסוגים האלה לא יעברו בירושה לקבוצת המודעות הזו מהרמות העליונות. סוגי קבוצות לפי מיקום (GMB_DYNAMIC_LOCATION_GROUP , CHAIN_DYNAMIC_LOCATION_GROUP ו-ENDIC_LOCATION_GROUP) הם סוגים צאצאים של LOCATION_SYNC. לכן, אם הוגדר LOCATION_SYNC בשדה הזה, לא ניתן לקשר את כל קבוצות הנכסים של קבוצות לפי מיקום לקבוצת המודעות הזו, וכל תוספי המיקום (LE) ותוספי המיקום של השותפים העצמאיים (ALE) לא יוצגו בקבוצת המודעות הזו. כרגע יש תמיכה רק ב-LOCATION_SYNC.
primaryStatus

enum (AdGroupPrimaryStatus)

פלט בלבד. מספק תמונה מקיפה לגבי הסיבה לכך שקבוצת מודעות לא מוצגת או לא מוצגת באופן אופטימלי.
primaryStatusReasons[]

enum (AdGroupPrimaryStatusReason)

פלט בלבד. מציין מדוע קבוצת מודעות לא מוצגת או לא מוצגת באופן אופטימלי.
id

string (int64 format)

פלט בלבד. המזהה של קבוצת המודעות.
name

string

השם של קבוצת המודעות.

זהו שדה חובה ולא יכול להיות ריק כשיוצרים קבוצות מודעות חדשות.

היא חייבת להכיל פחות מ-255 תווים ברוחב מלא מסוג UTF-8.

היא לא יכולה להכיל תווים מסוג null (נקודת קוד 0x0), פיד שורה של NL (נקודת קוד 0xA) או תווים של חזרה לתחילת השורה (נקודת קוד 0xD).
baseAdGroup

string

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

בקבוצות מודעות בסיסיות, השדה הזה זהה לשם המשאב של קבוצת המודעות.

השדה הזה הוא לקריאה בלבד.
trackingUrlTemplate

string

התבנית של כתובת ה-URL ליצירת כתובת URL למעקב.
campaign

string

בלתי משתנה. הקמפיין שאליו שייכת קבוצת המודעות.
cpcBidMicros

string (int64 format)

הצעת המחיר המקסימלית לקליק.
effectiveCpcBidMicros

string (int64 format)

פלט בלבד. הערך יהיה זהה לערך של הצעת המחיר לקליק (CPC) כאשר שיטת הבידינג היא 'עלות ידנית לקליק (CPC)', 'אופטימיזציית עלות לקליק (eCPC)', 'דף ראשון' או 'יעד נתח הובלה בדירוג', אחרת הערך יהיה null.
cpmBidMicros

string (int64 format)

הצעת המחיר המקסימלית לאלף חשיפות (CPM)
targetCpaMicros

string (int64 format)

יעד עלות להמרה (CPA). אם שיטת הבידינג שמוגדרת בקמפיין היא 'יעד עלות להמרה' או 'מקסימום המרות' (עם השדה 'יעד עלות להמרה'), השדה הזה מבטל את יעד העלות להמרה שצוין בשיטת הבידינג של הקמפיין. אחרת, המערכת תתעלם מהערך הזה.
cpvBidMicros

string (int64 format)

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

string (int64 format)

הסכום הממוצע במיליוניות שהמפרסם מוכן לשלם על כל אלף פעמים שהמודעה מוצגת.
targetRoas

number

שינוי מברירת המחדל של יעד ההחזר על הוצאות הפרסום (ROAS). אם שיטת הבידינג ברמת הקמפיין של קבוצת המודעות היא TargetRoas או מיקסום המרות (עם השדה targetRoas מוגדר בשדה הזה), השדה הזה מבטל את יעד ההחזר על הוצאות הפרסום שצוין בשיטת הבידינג של הקמפיין. אחרת, המערכת תתעלם מהערך הזה.
percentCpcBidMicros

string (int64 format)

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

string

תבנית לכתובת URL להוספת פרמטרים לכתובת URL סופית.
effectiveTargetCpaMicros

string (int64 format)

פלט בלבד. יעד העלות להמרה בפועל. השדה הזה הוא לקריאה בלבד.
effectiveTargetRoas

number

פלט בלבד. יעד ההחזר בפועל על הוצאות הפרסום (ROAS). השדה הזה הוא לקריאה בלבד.

AdGroupStatus

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

טיפוסים בני מנייה (enums)
UNSPECIFIED הסטטוס לא צוין.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתגובה בלבד.
ENABLED קבוצת המודעות מופעלת.
PAUSED קבוצת המודעות מושהית.
REMOVED קבוצת המודעות תוסר.

AdGroupAdRotationMode

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין מצב סבב מודעות.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתגובה בלבד.
OPTIMIZE מבצעים אופטימיזציה של מודעות בקבוצת המודעות על סמך קליקים או המרות.
ROTATE_FOREVER סובב באופן שווה לנצח.

AudienceSetting

הגדרות לטירגוט לפי קהל.

ייצוג JSON 
{
  "useAudienceGrouped": boolean
}
שדות
useAudienceGrouped

boolean

בלתי משתנה. אם הערך הוא True, קבוצת המודעות הזו משתמשת במשאב 'קהל' לצורך טירגוט לפי קהל. אם הערך הוא False, קבוצת המודעות הזו יכולה להשתמש במקום זאת בקריטריונים של פלחים של קהל היעד.

AdGroupPrimaryStatus

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
ELIGIBLE קבוצת המודעות כשירה להצגה.
PAUSED קבוצת המודעות מושהית.
REMOVED קבוצת המודעות תוסר.
PENDING ייתכן שקבוצת המודעות הזו תוצג בעתיד.
NOT_ELIGIBLE קבוצת המודעות אינה כשירה להצגת מודעות.
LIMITED ההצגה של קבוצת המודעות מוגבלת.

AdGroupPrimaryStatusReason

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
CAMPAIGN_REMOVED סטטוס הקמפיין שצוין על ידי המשתמש הוסר. תורם ל-adgroupPrimaryStatus.NOT_ELIGIBLE.
CAMPAIGN_PAUSED סטטוס הקמפיין שצוין על ידי המשתמש מושהה. תורם ל-adgroupPrimaryStatus.NOT_ELIGIBLE.
CAMPAIGN_PENDING הזמן שצוין על ידי המשתמש להתחלה של הקמפיין חל בעתיד. תורם ל-adgroupPrimaryStatus.NOT_ELIGIBLE
CAMPAIGN_ENDED הזמן שצוין על ידי המשתמש לסיום הקמפיין הזה חלף. תורם ל-adgroupPrimaryStatus.NOT_ELIGIBLE.
AD_GROUP_PAUSED הסטטוס של קבוצת המודעות שציין המשתמש מושהה. תורם ל-adgroupPrimaryStatus.PAUSED.
AD_GROUP_REMOVED המערכת מסירה את הסטטוס של קבוצת המודעות שציין המשתמש. תורמת לערך קבוצת המודעותPrimaryStatus.REMOVED.
AD_GROUP_INCOMPLETE בניית קבוצת המודעות הזו עדיין לא הושלמה. תורם ל-adgroupPrimaryStatus.NOT_ELIGIBLE.
KEYWORDS_PAUSED כל הסטטוסים של מילות המפתח שצוינו בקבוצת המודעות מושהים. תורם ל-adgroupPrimaryStatus.NOT_ELIGIBLE.
NO_KEYWORDS אין מילות מפתח כשירות בקבוצת המודעות הזו. תורם ל-adgroupPrimaryStatus.NOT_ELIGIBLE.
AD_GROUP_ADS_PAUSED כל הסטטוסים של מודעות קבוצת המודעות שצוינו בקבוצת המודעות מושהים. תורם ל-adgroupPrimaryStatus.NOT_ELIGIBLE.
NO_AD_GROUP_ADS אין מודעות כשירות בקבוצת מודעות זו. תורם ל-adgroupPrimaryStatus.NOT_ELIGIBLE.
HAS_ADS_DISAPPROVED הסיבה לסטטוס המדיניות כשמודעה אחת לפחות נדחתה. תורם לסטטוס קבוצת מודעות כללית מרובים.
HAS_ADS_LIMITED_BY_POLICY הסיבה לסטטוס המדיניות כשמודעה אחת לפחות מוגבלת בעקבות המדיניות. תורם לסטטוס קבוצת מודעות כללית מרובים.
MOST_ADS_UNDER_REVIEW הסיבה לסטטוס המדיניות כאשר רוב המודעות ממתינות לבדיקה. תורם ל-adgroupPrimaryStatus.PENDING.
CAMPAIGN_DRAFT קבוצת המודעות שייכת לטיוטה של קמפיין. תורם ל-adgroupPrimaryStatus.NOT_ELIGIBLE.
AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY קבוצת המודעות הושהתה עקב פעילות נמוכה וממושכת של הצגת מודעות. תורם ל-adgroupPrimaryStatus.PAUSED.