מדדי ביצועים, מאפייני הגדרה ומאפייני מלאי למוצרים שמוגדרים בפיד מלאי ונמכרים כתוצאה מפרסום בחיפוש בתשלום.
ניתן להחזיר דוח זה רק באמצעות בקשה אסינכרונית (כלומר, דרך המתודה Reports.request()).
מאחר שאירועים מתרחשים בתאריכים ספציפיים, בקשה לדוח הזה חייבת לציין timeRange. ניתן לציין אחת מהאפשרויות הבאות:
- startDate ו-endDate.
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp לא תקף לאירועים).
בקשה לקטע
שליחת אימייל רגיל
Reports.request()
גוף הבקשה, אבל יש לציין "reportType": "productLeadAndCrossSell".
{
...
"reportType": "productLeadAndCrossSell",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
}
בכל עמודה שרוצים להחזיר או לסנן בדוח,
לציין את columnName שמפורט בטבלה שלמטה.
אפשר גם לציין
headerText,
startDate,
ו-endDate.
לידיעתכם, יש עמודות שאי אפשר לסנן. לעיין באפשרות 'ניתן לסינון' בטבלה שלמטה.
columnName | תיאור | התנהגות | סוג | ניתן לסינון |
|---|---|---|---|---|
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 |
כן |
crossSellAverageUnitPrice |
המחיר הממוצע שדווח לגבי מכירות של מוצר כשהוא נמכר כתוצאה מפרסום של מוצר אחר | ערך | Money |
כן |
crossSellCostOfGoodsSold |
העלות הכוללת של מכירת מוצר כשהוא נמכר כתוצאה מפרסום של מוצר אחר. | ערך | Money |
כן |
crossSellGrossFromUnitsSold |
ההכנסה הכוללת ממכירות של מוצר מסוים כתוצאה מפרסום של מוצר אחר. | ערך | Money |
כן |
crossSellGrossProfitMargin |
שולי הרווח הגולמי של מוצר ספציפי שנמכר כתוצאה מפרסום של מוצר אחר. | ערך | Number |
כן |
crossSellRevenueFromUnitsSold |
ההכנסה הכוללת שנוצרה ממכירות צולבות (הכנסה שנוצרה כתוצאה מפרסום של מוצר אחר). | ערך | Money |
כן |
crossSellUnitsSold |
מספר היחידות שנמכרו כתוצאה ממכירת מוצר או שירות לא קשור (cross-sell). (מספר היחידות שנמכרו כתוצאה מפרסום של מוצר אחר). | ערך | Number |
כן |
leadAverageUnitPrice |
המחיר הממוצע שדווח למכירות של מוצר כשהוא נמכר כתוצאה מפרסום המוצר. | ערך | Money |
כן |
leadCostOfGoodsSold |
העלות הכוללת של מכירת מוצר כשהוא נמכר כתוצאה מפרסום המוצר. | ערך | Money |
כן |
leadGrossProfitFromUnitsSold |
ההכנסה הכוללת ממכירות של מוצר כתוצאה מפרסום המוצר. | ערך | Money |
כן |
leadGrossProfitMargin |
שולי הרווח הגולמי של מוצר ספציפי כתוצאה ישירה מפרסום המוצר. | ערך | Number |
כן |
leadRevenueFromUnitsSold |
סך כל ההכנסות ממוצר שנמכר כתוצאה מפרסום המוצר הזה. | ערך | Money |
כן |
leadUnitsSold |
מספר היחידות שנמכרו כתוצאה מפרסום המוצר. | ערך | Number |
כן |
productUnitsSold |
המספר הכולל של יחידות שנמכרו עבור מוצר מסוים. | ערך | Number |
כן |
productRevenueFromUnitsSold |
ההכנסה הכוללת שנוצרה ממוצר מסוים (לפי המחיר המדווח של כל מוצר). | ערך | Money |
כן |
productAverageUnitPrice |
המחיר הממוצע שדווח למכירות של מוצר (לפי המחיר המדווח של כל מוצר). | ערך | Money |
כן |
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 |
כן |