סוג הדוח: productGroup

מדדי ביצועים ומאפייני תצורה בקבוצות מוצרים. דוחות של קבוצות מוצרים שונים מהדוחות של מילות מפתח בכמה דרכים; למידע נוסף

ניתן להחזיר את הדוח הזה רק באמצעות בקשה אסינכרונית (כלומר, בשיטה Reports.request() ).

בקשת קטע

שליחה של גוף בקשה רגיל של Reports.request() , אבל ציון של "reportType": "productGroup".

{
...
  "reportType": "productGroup",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

לכל עמודה שרוצים להחזיר או לסנן בדוח, צריך לציין את columnName בטבלה שבהמשך. אפשר גם לציין headerText, startDate ו-endDate. חשוב לזכור שלא ניתן לסנן חלק מהעמודות. עיינו בעמודה 'ניתן לסינון' בטבלה שבהמשך.

columnName	תיאור	התנהגות	סוג	אפשר לסנן
status	הסטטוס של קבוצת המוצרים. תמיד Active.	מאפיין	Status	כן
engineStatus	הסטטוס הנוסף של קבוצת המוצרים בחשבון מנוע החיפוש החיצוני. סטטוסים אפשריים (בהתאם לסוג החשבון החיצוני) כוללים את review, campaign paused וכדומה.	מאפיין	String	כן
creationTimestamp	חותמת הזמן של יצירת קבוצת המוצרים, בפורמט ISO 8601.	מאפיין	Timestamp	כן
lastModifiedTimestamp	חותמת הזמן של השינוי האחרון שבוצע בקבוצת המוצרים, בפורמט ISO 8601.	מאפיין	Timestamp	כן
agency	שם הסוכנות.	מאפיין	String	כן
agencyId	מזהה סוכנות ב-DS.	מאפיין	ID	כן
advertiser	שם המפרסם.	מאפיין	String	כן
advertiserId	מזהה מפרסם ב-DS.	מאפיין	ID	כן
account	שם חשבון מנוע החיפוש.	מאפיין	String	כן
accountId	מספר חשבון מנוע חיפוש ב-DS.	מאפיין	ID	כן
accountEngineId	המזהה של החשבון בחשבון מנוע החיפוש החיצוני.	מאפיין	String	כן
accountType	סוג חשבון מנוע החיפוש: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu או Comparison Shopping.	מאפיין	Engine type	כן
campaign	שם קמפיין.	מאפיין	String	כן
campaignId	מזהה קמפיין ב-DS.	מאפיין	ID	כן
campaignStatus	הסטטוס של הקמפיין שמכיל את הפריט הזה.	מאפיין	Status	כן
adGroup	שם קבוצת המודעות.	מאפיין	String	כן
adGroupId	מזהה קבוצת מודעות ב-DS.	מאפיין	ID	כן
adGroupStatus	הסטטוס של קבוצת המודעות שמכילה את הפריט הזה.	מאפיין	Status	כן
productGroupId	מזהה קבוצת מוצרים ב-DS. מערכת DS יוצרת את המזהים האלה, גם אם עץ קבוצת המוצרים שנוצר לא ישתנה. מידע נוסף	מאפיין	ID	כן
productGroup	הקריטריונים ששימשו להגדרה של קבוצת המוצרים, כגון AND(CATEGORY="אלקטרוניקה",BRAND = "example").	מאפיין	String	לא
productGroupPartitionType	סוג החלוקה של קבוצת המוצרים: Subdivided, Excluded או Biddable.	מאפיין	Product group partition type	כן
productGroupLandingPage	דף הנחיתה של קבוצת המוצרים. כדאי לעיין בכתובות של דפי נחיתה וכתובות אתרים של שרתי קליקים.	מאפיין	String	כן
productGroupClickserverUrl	כתובת ה-URL שמשמשת את DS למעקב אחר פעילות. משתמש שלוחץ על מודעה יכול קודם לבקר בכתובת ה-URL של שרת הקליקים, ולאחר מכן יופנה לדף הנחיתה הסופי. כדאי לעיין בכתובות של דפי נחיתה וכתובות אתרים של שרתי קליקים.	מאפיין	String	כן
productGroupMaxCpc	מחזירה את העלות המקסימלית לקליק שהוגדרה עבור קבוצת המוצרים הזו, אם קיימת קבוצה כזו. אם לא הוגדרה עלות מקסימלית לקליק עבור קבוצת המוצרים הזו, השדה הזה ריק וקבוצת המוצרים יורשת את הגדרת המחיר המקסימלי לקליק מקבוצת המודעות.	מאפיין	Money	כן
effectiveProductGroupMaxCpc	העלות המקסימלית לקליק (CPC) שמוגדרת כרגע בקבוצת המוצרים הזו. הערך הזה יהיה זהה למחיר המקסימלי לקליק של קבוצת המודעות, או אם יעד המוצר מבטל את ההגדרה של קבוצת המודעות, הוא המחיר המקסימלי לקליק של יעד המוצר עצמו.	מאפיין	Money	כן
productGroupMaxBid	אם קבוצת המוצרים הזו מנוהלת באמצעות שיטת בידינג ב-DS, הצעת המחיר אף פעם לא תגדיל את הצעות המחיר מעבר למגבלה הזו. איך להחיל שיטת בידינג על קבוצת מוצרים	מאפיין	Money	כן
productGroupMinBid	אם קבוצת המוצרים הזו מנוהלת באמצעות שיטת בידינג ב-DS, שיטת הבידינג לעולם לא תקטין את הצעות המחיר מתחת למגבלה הזו. איך להחיל שיטת בידינג על קבוצת מוצרים	מאפיין	Money	כן
effectiveBidStrategyId	מזהה DS של שיטת הבידינג שהוקצתה לישות הזו, או שעברה בירושה על ידי הישות הזו.	מאפיין	ID	כן
effectiveBidStrategy	השם של שיטת הבידינג שהוקצתה לישות הזו או שעברה בירושה של הישות הזו.	מאפיין	String	כן
bidStrategyInherited	מציין אם שיטת הבידינג של הישות הזו עוברת בירושה.	מאפיין	Boolean	כן
effectiveLabels	השמות של כל התוויות שהועברו בירושה או הוקצו ישירות לקבוצת המוצרים הזו.	מאפיין	String list	כן
dfaActions	המספר הכולל של פעולות ב-Campaign Manager.	ערך	Integer	כן
dfaRevenue	ההכנסה המצטברת שנוצרה על ידי עסקאות ב-Campaign Manager.	ערך	Money	כן
dfaTransactions	המספר הכולל של עסקאות ב-Campaign Manager.	ערך	Integer	כן
dfaWeightedActions	סכום משוקלל של הפעולות ב-Campaign Manager.	ערך	Number	כן
dfaActionsCrossEnv	המספר הכולל של פעולות Campaign Manager בסביבות שונות.	ערך	Number	כן
dfaRevenueCrossEnv	ההכנסה המצטברת שנוצרת מעסקאות של Campaign Manager בסביבות שונות.	ערך	Money	כן
dfaTransactionsCrossEnv	המספר הכולל של עסקאות Campaign Manager בסביבות שונות.	ערך	Number	כן
dfaWeightedActionsCrossEnv	סכום משוקלל של פעולות Campaign Manager בסביבות שונות.	ערך	Number	כן
avgCpc	עלות ממוצעת לקליק.	ערך	Money	כן
avgCpm	עלות ממוצעת לאלף חשיפות.	ערך	Money	כן
avgPos	מיקום ממוצע בדף.	ערך	Number	כן
clicks	קליקים מצטברים.	ערך	Integer	כן
cost	העלות המצטברת לתשלום לחשבונות מנוע החיפוש.	ערך	Money	כן
ctr	שיעור הקליקים הממוצע.	ערך	Number	כן
impr	מספר החשיפות הכולל.	ערך	Integer	כן
adWordsConversions	הנתונים שהמפרסם הגדיר כדוחות בעמודת ההמרות ב-Google Ads. כשיוצרים פעולת המרה ב-Google Ads, המפרסם יכול לבחור אם לספור את ההמרות האלה בעמודה 'דיווח המרות'.	ערך	Number	כן
adWordsConversionValue	הערך המצטבר של המרות ב-Google Ads.	ערך	Number	כן
adWordsViewThroughConversions	המספר הכולל של המרות לאחר צפייה ב-Google Ads.	ערך	Integer	כן
visits	המספר הכולל של ביקורים ב-DS.	ערך	Integer	כן
date	דוח זה מפולח לפי ימים. כל שורה והמדדים המצטברים שלה מחולקים למספר שורות, אחת לכל יום. העמודה הזו מחזירה את התאריך של כל שורה.	פלח	Date	כן
monthStart	מפלח את הדוח לפי חודשים; כל שורה והמדדים המצטברים שלה מחולקים למספר שורות, אחת לכל חודש. העמודה הזו מחזירה את היום הראשון בכל חודש.	פלח	Date	כן
monthEnd	מפלח את הדוח לפי חודשים; כל שורה והמדדים המצטברים שלה מחולקים למספר שורות, אחת לכל חודש. העמודה הזו מחזירה את היום האחרון בכל חודש.	פלח	Date	כן
quarterStart	לפלח את הדוח לפי רבעים. כל שורה והמדדים המצטברים שלה מחולקים למספר שורות – אחת לכל רבעון. העמודה הזו מחזירה את היום הראשון בכל רבעון.	פלח	Date	כן
quarterEnd	לפלח את הדוח לפי רבעים. כל שורה והמדדים המצטברים שלה מחולקים למספר שורות – אחת לכל רבעון. העמודה הזו מחזירה את היום האחרון בכל רבעון.	פלח	Date	כן
weekStart	הדוח מתחלק לפי שבועות (ראשון עד שבת). כל שורה והמדדים המצטברים שלה מחולקים למספר שורות – אחת לכל שבוע. העמודה הזו מחזירה את היום הראשון (יום ראשון) של כל שורה.	פלח	Date	כן
weekEnd	הדוח מתחלק לפי שבועות (ראשון עד שבת). כל שורה והמדדים המצטברים שלה מחולקים למספר שורות – אחת לכל שבוע. העמודה הזו מחזירה את היום האחרון (כל יום) של כל שורה.	פלח	Date	כן
yearStart	לפלח את הדוח לפי שנים; כל שורה והמדדים המצטברים שלה מחולקים למספר שורות, אחת לכל שנה. העמודה הזו מחזירה את היום הראשון בשנה של כל שורה.	פלח	Date	כן
yearEnd	לפלח את הדוח לפי שנים; כל שורה והמדדים המצטברים שלה מחולקים למספר שורות, אחת לכל שנה. העמודה הזו מחזירה את היום האחרון בשנה של כל שורה.	פלח	Date	כן
deviceSegment	הפילוח של הדוח מתבצע לפי מכשיר. כל שורה והמדדים המצטברים שלה מחולקים למספר שורות, אחת לכל פלח של מכשיר. העמודה הזו מחזירה את הפלח של המכשיר בכל שורה.	פלח	Device segment	כן