מדדי ביצועים, מאפייני הגדרות ומאפייני מלאי של מוצרים שמוגדרים בפיד מלאי ומפורסמות בקמפיין שופינג.
ניתן להחזיר דוח זה רק באמצעות בקשה אסינכרונית (כלומר, דרך המתודה 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 |
כן |