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

string (int64 format)

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

string

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

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

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

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

string

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

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

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

string

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

string

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

הצעת המחיר המקסימלית לאלף חשיפות הניתנות לצפייה.
targetCpaMicros

string (int64 format)

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

string (int64 format)

הצעת המחיר לצפייה.
targetCpmMicros

string (int64 format)

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

number

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

string (int64 format)

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

string

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

string (int64 format)

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

number

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

AdGroupStatus

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

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

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

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

AdGroupType

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

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

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

זהו ערך לתגובה בלבד.
SEARCH_STANDARD סוג קבוצת המודעות שמוגדר כברירת מחדל בקמפיינים לרשת החיפוש.
DISPLAY_STANDARD סוג ברירת המחדל של קבוצת מודעות בקמפיינים לרשת המדיה.
SHOPPING_PRODUCT_ADS הסוג של קבוצת המודעות בקמפיינים של שופינג שמציגים מודעות מוצר רגילות.
HOTEL_ADS סוג קבוצת המודעות שמוגדר כברירת מחדל בקמפיינים לקידום מלונות.
SHOPPING_SMART_ADS הסוג של קבוצות המודעות בקמפיינים חכמים לשופינג.
VIDEO_BUMPER מודעות וידאו קצרות שלא ניתן לדלג עליהן.
VIDEO_TRUE_VIEW_IN_STREAM מודעות וידאו TrueView In-stream (ניתנות לדילוג).
VIDEO_TRUE_VIEW_IN_DISPLAY מודעות וידאו מסוג TrueView ברשת המדיה.
VIDEO_NON_SKIPPABLE_IN_STREAM מודעות וידאו In-stream שלא ניתן לדלג עליהן.
VIDEO_OUTSTREAM מודעות וידאו Outstream.
SEARCH_DYNAMIC_ADS סוג קבוצת המודעות בקבוצות של מודעות דינמיות לרשת החיפוש.
SHOPPING_COMPARISON_LISTING_ADS הסוג של קבוצות המודעות בקמפיינים של השוואת מחירים.
PROMOTED_HOTEL_ADS הסוג של קבוצת המודעות בקבוצות של מודעות לקידום מלונות.
VIDEO_RESPONSIVE קבוצות של מודעות וידאו רספונסיביות.
VIDEO_EFFICIENT_REACH קבוצות של מודעות וידאו לשיפור פוטנציאל החשיפה.
SMART_CAMPAIGN_ADS הסוג של קבוצת המודעות בקמפיינים חכמים.
TRAVEL_ADS סוג קבוצת המודעות לקמפיינים ל-Google נסיעות.

AdGroupAdRotationMode

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

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

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

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

AudienceSetting

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

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

boolean

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