סוג הדוח: 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="Electronics",BRAND = "example").	שיוך	String	לא
productGroupPartitionType	סוג החלוקה של קבוצת המוצרים: Subdivided, Excluded או Biddable.	שיוך	Product group partition type	כן
productGroupLandingPage	דף הנחיתה של קבוצת המוצרים. מידע נוסף זמין בקטע כתובות URL של דפי נחיתה ושל שרת למעקב אחרי קליקים.	שיוך	String	כן
productGroupClickserverUrl	כתובת ה-URL שמשמשת את DS למעקב אחרי פעילות. משתמש שילחץ על מודעה יבקר קודם בכתובת ה-URL של השרת למעקב אחרי קליקים, ואז יופנה לדף הנחיתה הסופי. מידע נוסף זמין בקטע כתובות URL של דפי נחיתה ושל שרת למעקב אחרי קליקים.	שיוך	String	כן
productGroupMaxCpc	הפונקציה מחזירה את העלות המקסימלית לקליק שהוגדרה לקבוצת המוצרים הזו, אם קיימת. אם לא הוגדרה עלות מקסימלית לקליק לקבוצת המוצרים הזו, השדה הזה יהיה ריק וקבוצת המוצרים תקבל בירושה את הגדרת העלות המקסימלית לקליק מקבוצת המודעות.	שיוך	Money	כן
effectiveProductGroupMaxCpc	העלות המקסימלית לקליק (max. 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	המספר הכולל של פעולות של מנהל הקמפיין בסביבות שונות.	ערך	Number	כן
dfaRevenueCrossEnv	ההכנסה המצטברת מעסקאות של Campaign Manager בסביבות שונות שנוצרות.	ערך	Money	כן
dfaTransactionsCrossEnv	המספר הכולל של עסקאות של מנהל קמפיינים בסביבות שונות.	ערך	Number	כן
dfaWeightedActionsCrossEnv	הסכום המשוקלל של פעולות מנהל הקמפיין בסביבות שונות.	ערך	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	כן