סוג הדוח: מוצר שפורסם

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

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

בקשת קטע

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

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

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

columnName	תיאור	התנהגות	סוג	אפשר לסנן
status	הסטטוס של המוצר כפי שצוין בחשבון המלאי: Active או Removed.	מאפיין	Status	כן
creationTimestamp	חותמת הזמן של המוצר כפי שהוא מופיע בחשבון המלאי, בפורמט ISO 8601.	מאפיין	Timestamp	כן
lastModifiedTimestamp	חותמת הזמן האחרונה של המוצר כפי שצוינה בחשבון המלאי, עם שינוי בפורמט ISO 8601.	מאפיין	Timestamp	כן
agency	שם הסוכנות.	מאפיין	String	כן
agencyId	מזהה סוכנות ב-DS.	מאפיין	ID	כן
advertiser	שם המפרסם.	מאפיין	String	כן
advertiserId	מזהה מפרסם ב-DS.	מאפיין	ID	כן
productId	מזהה הפריט של המוצר.	מאפיין	String	כן
productCountry	המדינה הרשומה עבור פיד המלאי של המוצר.	מאפיין	String	כן
productLanguage	השפה שרשומה בפיד המלאי של המוצר.	מאפיין	String	כן
productMpn	המאפיין MPN (מספר החלק של היצרן) של פריט מוצר.	מאפיין	String	כן
productColor	מאפיין color [צבע] של פריט מוצר.	מאפיין	String	כן
productSize	המאפיין size [מידה] של פריט מוצר.	מאפיין	String	כן
productMaterial	מאפיין material [חומר] של פריט מוצר.	מאפיין	String	כן
productPattern	המאפיין pattern [דוגמת_עיצוב] של פריט מוצר.	מאפיין	String	כן
productAvailability	מאפיין availability [זמינות] של פריט מוצר.	מאפיין	Product availability	כן
productGender	מאפיין המגדר של פריט מוצר.	מאפיין	String	כן
productAgeGroup	מאפיין age_group [קבוצת גיל] של פריט מסוים במוצר.	מאפיין	String	כן
productLandingPageUrl	מאפיין דף הנחיתה של פריט המוצר.	מאפיין	String	כן
productCategory	מאפיין קטגוריית המוצר ב-Google של פריט מוצר.	מאפיין	String	כן
productCategoryLevel1	מאפיין קטגוריית המוצר ב-Google 1 של פריט מוצר.	מאפיין	String	כן
productCategoryLevel2	מאפיין קטגוריית המוצר ב-Google 2 של פריט מוצר.	מאפיין	String	כן
productCategoryLevel3	מאפיין קטגוריית המוצר ב-Google 3 של פריט מוצר.	מאפיין	String	כן
productCategoryLevel4	מאפיין קטגוריית המוצר ב-Google 4 של פריט מוצר.	מאפיין	String	כן
productCategoryLevel5	מאפיין קטגוריית המוצר ב-Google 5 של פריט מוצר.	מאפיין	String	כן
productBrand	מאפיין המותג של פריט המוצר.	מאפיין	String	כן
productGtin	המאפיין GTIN (מספר פריט מסחרי גלובלי) של פריט.	מאפיין	String	כן
productPrice	המאפיין price [מחיר] של פריט מוצר.	מאפיין	Money	כן
productSalePrice	המאפיין price [מחיר] של פריט מוצר.	מאפיין	Money	כן
productTypeLevel1	מאפיין סוג המוצר 1 של פריט מוצר.	מאפיין	String	כן
productTypeLevel2	המאפיין סוג המוצר 2 של פריט מוצר.	מאפיין	String	כן
productTypeLevel3	מאפיין סוג המוצר 3 של פריט מוצר.	מאפיין	String	כן
productTypeLevel4	מאפיין סוג המוצר leve 4 של פריט מוצר.	מאפיין	String	כן
productTypeLevel5	מאפיין סוג המוצר 5 של פריט מוצר.	מאפיין	String	כן
productCondition	מאפיין המצב של פריט המוצר.	מאפיין	String	כן
productCustomLabel0	מאפיין custom label 0 של פריט מוצר.	מאפיין	String	כן
productCustomLabel1	מאפיין custom label 1 של פריט המוצר.	מאפיין	String	כן
productCustomLabel2	מאפיין custom_label_2 [תווית מותאמת אישית 2] של פריט מוצר.	מאפיין	String	כן
productCustomLabel3	מאפיין custom_label_3 [תווית_מותאמת_אישית_3] של פריט מוצר.	מאפיין	String	כן
productCustomLabel4	מאפיין custom label 4 של פריט מוצר.	מאפיין	String	כן
productCostOfGoodsSold	העלות הכוללת של מכירת מוצר, כפי שמצוין בפיד המלאי.	מאפיין	Money	כן
productStoreId	החנות שעבורה פורסם מוצר במודעת מלאי של חנות מקומית. הוא צריך להיות זהה למזהי החנות שמופיעים בפיד המוצרים של החנויות המקומיות.	מאפיין	String	כן
productChannel	מאפיין ערוץ המכירות של פריט מוצר: Online או Local.	מאפיין	Product channel	כן
productChannelExclusivity	מאפיין בלעדיות של פריט במוצר.	מאפיין	Product channel exclusivity	כן
productItemGroupId	מאפיין המזהה של קבוצת פריטים עבור פריט מוצר.	מאפיין	String	כן
productTitle	מאפיין שם הפריט של פריט.	מאפיין	String	כן
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	כן
floodlightGroup	המערכת תפלח את הדוח לפי קבוצות Floodlight. כל שורה והמדדים המצטברים שלה יפוצלו למספר שורות, אחת לכל קבוצת Floodlight. העמודה הזו מחזירה את השם של קבוצת Floodlight בכל שורה. לתשומת ליבכם: חלק מהמדדים לא כוללים ערכים מפולחים של Floodlight, כמו קליקים וביקורים.	פלח	String	כן
floodlightGroupId	המערכת תפלח את הדוח לפי קבוצות Floodlight. כל שורה והמדדים המצטברים שלה יפוצלו למספר שורות, אחת לכל קבוצת Floodlight. עמודה זו מחזירה את מזהה הקבוצה ב-DS Floodlight בכל שורה. לתשומת ליבכם: חלק מהמדדים לא כוללים ערכים מפולחים של Floodlight, כמו קליקים וביקורים.	פלח	ID	כן
floodlightGroupTag	המערכת תפלח את הדוח לפי קבוצות Floodlight. כל שורה והמדדים המצטברים שלה יפוצלו למספר שורות, אחת לכל קבוצת Floodlight. העמודה הזו מחזירה את התג של קבוצת Floodlight בכל שורה. לתשומת ליבכם: חלק מהמדדים לא כוללים ערכים מפולחים של Floodlight, כמו קליקים וביקורים.	פלח	String	כן
floodlightActivity	מפלח את הדוח לפי פעילויות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים למספר שורות, עד אחת לכל פעילות ב-Floodlight. העמודה הזו מחזירה את השם של פעילות ב-Floodlight בכל שורה. לתשומת ליבכם: חלק מהמדדים לא כוללים ערכים מפולחים של Floodlight, כמו קליקים וביקורים.	פלח	String	כן
floodlightActivityId	מפלח את הדוח לפי פעילויות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים למספר שורות, עד אחת לכל פעילות ב-Floodlight. העמודה הזו מחזירה את מזהה הפעילות ב-Floodlight ב-DS בכל שורה. לתשומת ליבכם: חלק מהמדדים לא כוללים ערכים מפולחים של Floodlight, כמו קליקים וביקורים.	פלח	ID	כן
floodlightActivityTag	מפלח את הדוח לפי פעילויות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים למספר שורות, עד אחת לכל פעילות ב-Floodlight. העמודה הזו מחזירה את תג הפעילות ב-Floodlight בכל שורה. לתשומת ליבכם: חלק מהמדדים לא כוללים ערכים מפולחים של Floodlight, כמו קליקים וביקורים.	פלח	String	כן
accountId	מספר חשבון מנוע חיפוש ב-DS.	פלח	ID	כן
campaignId	פילוח הדוח לפי קמפיין. השורה הזו מחזירה את מזהה הקמפיין ב-DS המשויך לשורה.	פלח	ID	כן
adGroupId	פילוח הדוח לפי קבוצת מודעות. שורה זו מחזירה את מזהה קבוצת המודעות המשויכת לשורה.	פלח	ID	כן