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

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

ניתן להחזיר דוח זה רק באמצעות בקשה אסינכרונית (כלומר, דרך המתודה 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 המאפיין gender [מגדר] של פריט המוצר. שיוך String כן
productAgeGroup המאפיין age group [קבוצת גיל] של פריט המוצר. שיוך String כן
productLandingPageUrl המאפיין דף הנחיתה של פריט המוצר. שיוך String כן
productCategory המאפיין קטגוריית המוצר ב-Google של פריט המוצר. שיוך String כן
productCategoryLevel1 המאפיין רמה 1 של קטגוריית המוצר ב-Google של פריט מוצר. שיוך String כן
productCategoryLevel2 המאפיין רמה 2 של קטגוריית המוצר ב-Google של פריט מוצר. שיוך String כן
productCategoryLevel3 המאפיין רמה 3 של קטגוריית המוצר ב-Google של פריט מוצר. שיוך String כן
productCategoryLevel4 המאפיין רמה 4 של קטגוריית המוצר ב-Google של פריט מסוים. שיוך String כן
productCategoryLevel5 המאפיין רמה 5 של קטגוריית המוצר ב-Google של פריט מוצר. שיוך String כן
productBrand המאפיין brand של הפריט. שיוך String כן
productGtin המאפיין GTIN (מספר פריט מסחרי גלובלי) של פריט מוצר. שיוך String כן
productPrice המאפיין price של פריט מוצר. שיוך Money כן
productSalePrice המאפיין price של פריט מוצר. שיוך Money כן
productTypeLevel1 המאפיין רמה 1 של סוג המוצר של פריט מוצר. שיוך String כן
productTypeLevel2 המאפיין רמה 2 של סוג המוצר של פריט מוצר. שיוך String כן
productTypeLevel3 המאפיין רמה 3 של סוג המוצר של פריט מסוים. שיוך String כן
productTypeLevel4 המאפיין רמה 4 של סוג המוצר של פריט מסוים. שיוך String כן
productTypeLevel5 המאפיין רמה 5 של סוג המוצר של פריט מוצר. שיוך String כן
productCondition המאפיין מצב של פריט המוצר. שיוך String כן
productCustomLabel0 המאפיין תווית מותאמת אישית 0 של פריט מוצר. שיוך String כן
productCustomLabel1 המאפיין תווית מותאמת אישית 1 של פריט מוצר. שיוך String כן
productCustomLabel2 המאפיין תווית מותאמת אישית 2 של פריט מוצר. שיוך String כן
productCustomLabel3 המאפיין תווית מותאמת אישית 3 של פריט מוצר. שיוך String כן
productCustomLabel4 המאפיין תווית מותאמת אישית 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 המספר הכולל של פעולות של מנהל הקמפיין בסביבות שונות. ערך 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 כן
floodlightGroup מפלחים את הדוח לפי קבוצות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל קבוצה ב-Floodlight. העמודה הזו מחזירה את השם של הקבוצה ב-Floodlight של כל שורה. שימו לב שלחלק מהמדדים אין ערכי פילוח של Floodlight, כמו קליקים וביקורים. פלח String כן
floodlightGroupId מפלחים את הדוח לפי קבוצות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל קבוצה ב-Floodlight. העמודה הזו מחזירה את מזהה קבוצת Floodlight של DS של כל שורה. שימו לב שלחלק מהמדדים אין ערכי פילוח של Floodlight, כמו קליקים וביקורים. פלח ID כן
floodlightGroupTag מפלחים את הדוח לפי קבוצות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל קבוצה ב-Floodlight. העמודה הזו מחזירה את תג הקבוצה של Floodlight של כל שורה. שימו לב שלחלק מהמדדים אין ערכי פילוח של Floodlight, כמו קליקים וביקורים. פלח String כן
floodlightActivity לפלח את הדוח לפי פעילויות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל פעילות ב-Floodlight. העמודה הזו מחזירה את השם של הפעילות ב-Floodlight של כל שורה. שימו לב שלחלק מהמדדים אין ערכי פילוח של Floodlight, כמו קליקים וביקורים. פלח String כן
floodlightActivityId לפלח את הדוח לפי פעילויות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל פעילות ב-Floodlight. העמודה הזו מחזירה את מזהה הפעילות ב-DS של כל שורה ב-DS. שימו לב שלחלק מהמדדים אין ערכי פילוח של Floodlight, כמו קליקים וביקורים. פלח ID כן
floodlightActivityTag לפלח את הדוח לפי פעילויות ב-Floodlight. כל שורה והמדדים המצטברים שלה מחולקים לכמה שורות, עד שורה אחת לכל פעילות ב-Floodlight. העמודה הזו מחזירה את תג הפעילות ב-Floodlight של כל שורה. שימו לב שלחלק מהמדדים אין ערכי פילוח של Floodlight, כמו קליקים וביקורים. פלח String כן
accountId מספר חשבון מנוע החיפוש ב-DS. פלח ID כן
campaignId מפלחים את הדוח לפי קמפיין. שורה זו מחזירה את מזהה הקמפיין ב-DS שמשויך לשורה. פלח ID כן
adGroupId מפלחים את הדוח לפי קבוצת מודעות. שורה זו מחזירה את מזהה קבוצת המודעות המשויך לשורה. פלח ID כן