Method: accounts.reports.search

אחזור דוח שהוגדר על ידי שאילתת חיפוש. התשובה עשויה להכיל פחות שורות ממה שצוין על ידי pageSize. אפשר להסתמך על nextPageToken כדי לקבוע אם יש שורות נוספות שצריך לבקש.

בקשת HTTP

POST https://merchantapi.googleapis.com/reports/v1beta/{parent=accounts/*}/reports:search

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. המזהה של החשבון שממנו בוצעה השיחה. החשבון צריך להיות חשבון עצמאי או חשבון משנה של MCA. פורמט: accounts/{account}

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON
{
  "query": string,
  "pageSize": integer,
  "pageToken": string
}
שדות
query

string

חובה. שאילתה המגדירה דוח לאחזור.

לפרטים על בניית השאילתה, ראו את המדריך 'שפת השאילתות'. הרשימה המלאה של הטבלאות והשדות הזמינים מופיעה בקטע 'השדות הזמינים'.

pageSize

integer

זה שינוי אופציונלי. מספר הReportRows שאפשר לאחזר בדף יחיד. ברירת המחדל היא 1,000. ערכים מעל 5,000 מועתקים ל-5,000.

pageToken

string

זה שינוי אופציונלי. האסימון של הדף לאחזור. אם לא מציינים זאת, מוחזר הדף הראשון של התוצאות. כדי לבקש את דף התוצאות הבא, יש להשתמש בערך שהתקבל מ-nextPageToken בתגובה הקודמת.

גוף התשובה

הודעת תשובה לשיטה ReportService.Search.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON
{
  "results": [
    {
      object (ReportRow)
    }
  ],
  "nextPageToken": string
}
שדות
results[]

object (ReportRow)

שורות שתואמות לשאילתת החיפוש.

nextPageToken

string

אסימון שניתן לשלוח בתור pageToken כדי לאחזר את הדף הבא. אם הוא לא נכלל, אין דפים נוספים.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/content

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

ReportRow

שורת התוצאה שהוחזרה משאילתת החיפוש.

רק ההודעה שתואמת לטבלה של השאילתה מאוכלסת בתשובה. בתוך ההודעה המאוכלסת, רק השדות המבוקשים באופן מפורש בשאילתה יאוכלסו.

ייצוג JSON
{
  "productPerformanceView": {
    object (ProductPerformanceView)
  },
  "nonProductPerformanceView": {
    object (NonProductPerformanceView)
  },
  "productView": {
    object (ProductView)
  },
  "priceCompetitivenessProductView": {
    object (PriceCompetitivenessProductView)
  },
  "priceInsightsProductView": {
    object (PriceInsightsProductView)
  },
  "bestSellersProductClusterView": {
    object (BestSellersProductClusterView)
  },
  "bestSellersBrandView": {
    object (BestSellersBrandView)
  },
  "competitiveVisibilityCompetitorView": {
    object (CompetitiveVisibilityCompetitorView)
  },
  "competitiveVisibilityTopMerchantView": {
    object (CompetitiveVisibilityTopMerchantView)
  },
  "competitiveVisibilityBenchmarkView": {
    object (CompetitiveVisibilityBenchmarkView)
  }
}
שדות
productPerformanceView

object (ProductPerformanceView)

השדות הזמינים לשאילתה בטבלה productPerformanceView.

nonProductPerformanceView

object (NonProductPerformanceView)

השדות הזמינים לשאילתה בטבלה nonProductPerformanceView.

productView

object (ProductView)

השדות הזמינים לשאילתה בטבלה productView.

priceCompetitivenessProductView

object (PriceCompetitivenessProductView)

השדות הזמינים לשאילתה בטבלה priceCompetitivenessProductView.

priceInsightsProductView

object (PriceInsightsProductView)

השדות הזמינים לשאילתה בטבלה priceInsightsProductView.

bestSellersProductClusterView

object (BestSellersProductClusterView)

השדות הזמינים לשאילתה בטבלה bestSellersProductClusterView.

bestSellersBrandView

object (BestSellersBrandView)

השדות הזמינים לשאילתה בטבלה bestSellersBrandView.

competitiveVisibilityCompetitorView

object (CompetitiveVisibilityCompetitorView)

השדות הזמינים לשאילתה בטבלה competitiveVisibilityCompetitorView.

competitiveVisibilityTopMerchantView

object (CompetitiveVisibilityTopMerchantView)

השדות הזמינים לשאילתה בטבלה competitiveVisibilityTopMerchantView.

competitiveVisibilityBenchmarkView

object (CompetitiveVisibilityBenchmarkView)

השדות הזמינים לשאילתה בטבלה competitiveVisibilityBenchmarkView.

ProductPerformanceView

השדות הזמינים לשאילתה בטבלה productPerformanceView.

נתוני ביצועי מוצרים של החשבון שלך, כולל מדדי ביצועים (לדוגמה, clicks) ומאפיינים שלפיהם מפולחים מדדי ביצועים (לדוגמה, offerId). ערכים של מידות המוצר, כמו offerId, משקפים את מצב המוצר בזמן החשיפה.

אי אפשר לבחור שדות פילוח בשאילתות בלי לבחור לפחות שדה אחד של מדד.

הערכים מוגדרים רק לשדות שנדרשים באופן מפורש בשאילתת החיפוש של הבקשה.

ייצוג JSON
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "conversionValue": {
    object (Price)
  },
  "marketingMethod": enum (MarketingMethodEnum),
  "customerCountryCode": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number,
  "conversions": number,
  "conversionRate": number
}
שדות
date

object (Date)

התאריך באזור הזמן של המוכר שעליו המדדים חלים. פילוח.

נדרש תנאי ב-date בסעיף WHERE.

week

object (Date)

היום הראשון בשבוע (שני) של תאריך המדדים באזור הזמן של המוכר. פילוח.

conversionValue

object (Price)

ערך ההמרות שמשויכות למוצר, מדווח בתאריך ההמרה. מדד.

זמין רק למקור התנועה FREE.

marketingMethod

enum (MarketingMethodEnum)

שיטת השיווק שעליה המדדים יחולו. פילוח.

customerCountryCode

string

קוד המדינה שבה הלקוח נמצא בזמן האירוע. מיוצגת בפורמט ISO 3166. פילוח.

אם לא ניתן לקבוע את המדינה של הלקוח, סמל 'ZZ' מיוחד מוחזר קוד,

offerId

string

המזהה של המוצר שסופק על ידי המוכר. פילוח.

title

string

שם המוצר. פילוח.

brand

string

המותג של המוצר. פילוח.

categoryL1

string

קטגוריית מוצר (רמה ראשונה) בטקסונומיית המוצרים של Google. פילוח.

categoryL2

string

קטגוריית מוצרים (רמה שנייה) בטקסונומיית המוצרים של Google. פילוח.

categoryL3

string

קטגוריית מוצר (רמה שלישית) בטקסונומיית המוצרים של Google. פילוח.

categoryL4

string

קטגוריית מוצרים (רמה רביעית) בטקסונומיית המוצרים של Google. פילוח.

categoryL5

string

קטגוריית מוצרים (רמה חמישית) בטקסונומיית המוצרים של Google. פילוח.

productTypeL1

string

סוג המוצר (רמה ראשונה) בטקסונומיית המוצרים של המוכר עצמו. פילוח.

productTypeL2

string

סוג המוצר (רמה שנייה) בטקסונומיית המוצרים של המוכר עצמו. פילוח.

productTypeL3

string

סוג המוצר (רמה שלישית) בטקסונומיית המוצרים של המוכר עצמו. פילוח.

productTypeL4

string

סוג המוצר (רמה רביעית) בטקסונומיית המוצרים של המוכר עצמו. פילוח.

productTypeL5

string

סוג המוצר (רמה חמישית) בטקסונומיית המוצרים של המוכר עצמו. פילוח.

customLabel0

string

תווית מותאמת אישית 0 לקיבוץ מותאם אישית של מוצרים. פילוח.

customLabel1

string

תווית מותאמת אישית 1 לקיבוץ מותאם אישית של מוצרים. פילוח.

customLabel2

string

תווית מותאמת אישית 2 לקיבוץ מוצרים מותאם אישית. פילוח.

customLabel3

string

תווית מותאמת אישית 3 לקיבוץ מותאם אישית של מוצרים. פילוח.

customLabel4

string

תווית מותאמת אישית 4 לקיבוץ מותאם אישית של מוצרים. פילוח.

clicks

string (int64 format)

מספר הקליקים. מדד.

impressions

string (int64 format)

מספר הפעמים שהמוצרים של המוכר מוצגים. מדד.

clickThroughRate

number

שיעור הקליקים – מספר הקליקים שהמוצרים של המוכר מקבלים (קליקים) חלקי מספר הפעמים שהמוצרים מוצגים (חשיפות). מדד.

conversions

number

מספר ההמרות שמשויכות למוצר, שדווחו בתאריך ההמרה. בהתאם למודל השיוך, המערכת עשויה לחלק את ההמרה בין כמה קליקים, כאשר לכל קליק מוקצה קרדיט משלו. המדד הזה הוא סכום של כל הזיכויים האלה. מדד.

זמין רק למקור התנועה FREE.

conversionRate

number

מספר ההמרות חלקי מספר הקליקים, שדווחו בתאריך החשיפה. מדד.

זמין רק למקור התנועה FREE.

MarketingMethodEnum

הערכים של שיטות השיווק.

טיפוסים בני מנייה (enum)
MARKETING_METHOD_ENUM_UNSPECIFIED לא צוין.
ORGANIC שיווק אורגני.
ADS שיווק מבוסס-מודעות.

NonProductPerformanceView

השדות הזמינים לשאילתה בטבלה nonProductPerformanceView.

נתוני הביצועים של התמונות ושל הקישורים לחנות הווירטואלית שמובילים לדפים שהם לא דפי מוצרים. זה כולל מדדי ביצועים (לדוגמה, clicks) ומאפיינים שלפיהם מפולחים מדדי ביצועים (למשל, date).

אי אפשר לבחור שדות פילוח בשאילתות בלי לבחור לפחות שדה אחד של מדד.

הערכים מוגדרים רק לשדות שנדרשים באופן מפורש בשאילתת החיפוש של הבקשה.

ייצוג JSON
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number
}
שדות
date

object (Date)

התאריך באזור הזמן של המוכר שעליו המדדים חלים. פילוח.

נדרש תנאי ב-date בסעיף WHERE.

week

object (Date)

היום הראשון בשבוע (שני) של תאריך המדדים באזור הזמן של המוכר. פילוח.

clicks

string (int64 format)

מספר הקליקים על תמונות ועל קישורים לחנות וירטואלית שהובילו לדפים שהם לא דפי מוצרים. מדד.

impressions

string (int64 format)

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

clickThroughRate

number

שיעור הקליקים – מספר הקליקים (clicks) חלקי מספר החשיפות (impressions) על תמונות ועל קישורים לחנות וירטואלית שהובילו לדפים שהם לא מוצרים. מדד.

ProductView

השדות הזמינים לשאילתה בטבלה productView.

מוצרים במלאי הנוכחי. המוצרים בטבלה הזו זהים לאלה שב-Product sub-API, אבל לא כל מאפייני המוצרים מ-products משני ה-API זמינים לשאילתה בטבלה הזו. בניגוד לתת-API למוצרים, הטבלה הזו מאפשרת לסנן את רשימת המוצרים שהוחזרה לפי מאפייני מוצר. כדי לאחזר מוצר בודד עד id או כדי להציג את כל המוצרים, צריך להשתמש ב-products משנית API.

הערכים מוגדרים רק לשדות שנדרשים באופן מפורש בשאילתת החיפוש של הבקשה.

ייצוג JSON
{
  "price": {
    object (Price)
  },
  "gtin": [
    string
  ],
  "creationTime": string,
  "expirationDate": {
    object (Date)
  },
  "itemIssues": [
    {
      object (ItemIssue)
    }
  ],
  "clickPotential": enum (ClickPotential),
  "id": string,
  "channel": enum (ChannelEnum),
  "languageCode": string,
  "feedLabel": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "condition": string,
  "availability": string,
  "shippingLabel": string,
  "itemGroupId": string,
  "thumbnailLink": string,
  "aggregatedReportingContextStatus": enum (AggregatedReportingContextStatus),
  "clickPotentialRank": string
}
שדות
price

object (Price)

מחיר המוצר. חסר אם המידע על מחיר המוצר לא זמין.

gtin[]

string

רשימת מספרי פריט מסחרי גלובלי (GTIN) של המוצר.

creationTime

string (Timestamp format)

השעה שבה המוכר יצר את המוצר, בשניות בחותמת הזמן.

expirationDate

object (Date)

תאריך התפוגה של המוצר, מצוין בזמן ההוספה.

itemIssues[]

object (ItemIssue)

רשימת בעיות בפריטים של המוצר.

אי אפשר להשתמש בשדה הזה למיון התוצאות.

אפשר להשתמש רק במאפיינים שנבחרו של השדה הזה (למשל, itemIssues.severity.aggregated_severity) לסינון התוצאות.

clickPotential

enum (ClickPotential)

פוטנציאל ביצועים משוער בהשוואה למוצרים של המוכר בעלי הביצועים הטובים ביותר.

id

string

מזהה REST של המוצר, בפורמט channel~languageCode~feedLabel~offerId. השיטות של Merchant API שפועלות על מוצרים מקבלות את הפרמטר הזה כפרמטר name.

חובה בסעיף SELECT.

channel

enum (ChannelEnum)

הערוץ של המוצר. יכול להיות ONLINE או LOCAL.

languageCode

string

קוד השפה של המוצר בפורמט BCP 47.

feedLabel

string

תווית הפיד של המוצר.

offerId

string

המזהה של המוצר שסופק על ידי המוכר.

title

string

שם המוצר.

brand

string

המותג של המוצר.

categoryL1

string

קטגוריית מוצר (רמה ראשונה) בטקסונומיית המוצרים של Google.

categoryL2

string

קטגוריית מוצר (רמה שנייה) בטקסונומיית המוצרים של Google.

categoryL3

string

קטגוריית מוצר (רמה שלישית) בטקסונומיית המוצרים של Google.

categoryL4

string

קטגוריית מוצר (רמה רביעית) בטקסונומיית המוצרים של Google.

categoryL5

string

קטגוריית מוצר (רמה חמישית) בטקסונומיית המוצרים של Google.

productTypeL1

string

סוג המוצר (רמה ראשונה) בטקסונומיית המוצרים של המוכר.

productTypeL2

string

סוג המוצר (רמה שנייה) בטקסונומיית המוצרים של המוכר.

productTypeL3

string

סוג המוצר (רמה שלישית) בטקסונומיית המוצרים של המוכר.

productTypeL4

string

סוג המוצר (רמה רביעית) בטקסונומיית המוצרים של המוכר.

productTypeL5

string

סוג המוצר (רמה חמישית) בטקסונומיית המוצרים של המוכר.

condition

string

מצב המוצר.

availability

string

זמינות המוצר.

shippingLabel

string

תווית משלוח מנורמלת שצוינה במקור הנתונים.

itemGroupId

string

מזהה קבוצת הפריטים סופק על ידי המוכר כדי לקבץ וריאציות יחד.

aggregatedReportingContextStatus

enum (AggregatedReportingContextStatus)

סטטוס מצטבר.

clickPotentialRank

string (int64 format)

דירוג המוצר לפי פוטנציאל הקליקים שלו. למוצר עם הערך clickPotentialRank 1 יש את פוטנציאל הקליקים הגבוה ביותר מבין המוצרים של המוכר שעומדים בתנאים של שאילתות החיפוש.

AggregatedReportingContextStatus

סטטוס המוצר מצטבר לכל הקשרי הדיווח.

הנה דוגמה לאופן שבו מחושב הסטטוס המצטבר:

כרטיסי מוצר חינמיים מודעות שופינג סטטוס
אושר אושר כשיר
אושר בהמתנה כשיר
אושר לא אושרה ELIGIBLE_LIMITED
בהמתנה בהמתנה בהמתנה
לא אושרה לא אושרה NOT_ELIGIBLE_OR_DISAPPROVED
טיפוסים בני מנייה (enum)
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED לא צוין.
NOT_ELIGIBLE_OR_DISAPPROVED המוצר לא עומד בדרישות או שהוא נפסל בכל ההקשרים של הדיווח.
PENDING סטטוס המוצר 'בהמתנה' בכל הקשרי הדיווח.
ELIGIBLE_LIMITED המוצר מתאים להקשרי דיווח מסוימים (אבל לא לכולם).
ELIGIBLE המוצר מתאים לכל הקשרי הדיווח.

ItemIssue

בעיה בפריט שמשויכת למוצר.

ייצוג JSON
{
  "type": {
    object (ItemIssueType)
  },
  "severity": {
    object (ItemIssueSeverity)
  },
  "resolution": enum (ItemIssueResolution)
}
שדות
type

object (ItemIssueType)

סוג הבעיה בפריט.

severity

object (ItemIssueSeverity)

חומרת הבעיה בפריט.

resolution

enum (ItemIssueResolution)

פתרון בעיה בפריט.

ItemIssueType

סוג הבעיה.

ייצוג JSON
{
  "code": string,
  "canonicalAttribute": string
}
שדות
code

string

קוד השגיאה של הבעיה, מקביל ל-code של בעיות במוצרים.

canonicalAttribute

string

שם מאפיין קנוני לבעיות ספציפיות למאפיין.

ItemIssueSeverity

איך הבעיה משפיעה על הצגת המוצר.

ייצוג JSON
{
  "severityPerReportingContext": [
    {
      object (IssueSeverityPerReportingContext)
    }
  ],
  "aggregatedSeverity": enum (AggregatedIssueSeverity)
}
שדות
severityPerReportingContext[]

object (IssueSeverityPerReportingContext)

חומרת הבעיה לפי ההקשר של הדיווח.

aggregatedSeverity

enum (AggregatedIssueSeverity)

חומרת הבעיה המצטברת בכל הקשרי הדיווח שהיא משפיעה.

אפשר להשתמש בשדה הזה כדי לסנן את התוצאות.

IssueSeverityPerReportingContext

חומרת הבעיה לפי ההקשר של הדיווח.

ייצוג JSON
{
  "disapprovedCountries": [
    string
  ],
  "demotedCountries": [
    string
  ],
  "reportingContext": enum (ReportingContextEnum)
}
שדות
disapprovedCountries[]

string

רשימת מדינות שנדחו בהקשר דיווח, מיוצגות בפורמט ISO 3166.

demotedCountries[]

string

רשימת מדינות שירדו בדרגה בהקשר הדיווח, מיוצגות בפורמט ISO 3166.

reportingContext

enum (ReportingContextEnum)

הקשר הדיווח שעליו הבעיה חלה.

AggregatedIssueSeverity

חומרת הבעיה נצברת בכל הקשרי הדיווח.

טיפוסים בני מנייה (enum)
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED לא צוין.
DISAPPROVED הבעיה גורמת לפסילת המוצר בהקשר דיווח אחד לפחות.
DEMOTED הבעיה מורידה את הדירוג של המוצר בכל הקשרי הדיווח שעליהם היא משפיעה.
PENDING פתרון הבעיה הוא PENDING_PROCESSING.

ItemIssueResolution

איך פותרים את הבעיה.

טיפוסים בני מנייה (enum)
ITEM_ISSUE_RESOLUTION_UNSPECIFIED לא צוין.
MERCHANT_ACTION המוכר צריך לפתור את הבעיה.
PENDING_PROCESSING הבעיה תיפתר באופן אוטומטי (לדוגמה, סריקת תמונה) או באמצעות בדיקה של Google. לא נדרשת פעולה למוכרים עכשיו. הפתרון עלול להוביל לבעיה אחרת (לדוגמה, אם הסריקה נכשלה).

ClickPotential

פוטנציאל הקליקים של מוצר הוא אומדן של פוטנציאל הביצועים בהשוואה למוצרים של המוכר בעלי הביצועים הטובים ביותר. פוטנציאל הקליקים של מוצר עוזר למוכרים לתעדף את המוצרים שצריך לתקן ועוזר להם להבין את הביצועים של מוצרים ביחס לפוטנציאל שלהם.

טיפוסים בני מנייה (enum)
CLICK_POTENTIAL_UNSPECIFIED השפעה לא צפויה של קליקים.
LOW פוטנציאל לקבלת מספר קליקים נמוך בהשוואה למוצרים של המוכר בעלי הביצועים הטובים ביותר.
MEDIUM פוטנציאל לקבלת מספר קליקים בינוני בהשוואה למוצרים של המוכר בעלי הביצועים הטובים ביותר.
HIGH פוטנציאל לקבלת מספר קליקים דומה לזה של המוצרים עם הביצועים הטובים ביותר של המוכר.

PriceCompetitivenessProductView

השדות הזמינים לשאילתה בטבלה priceCompetitivenessProductView.

הדוח השוואת מחירים ביחס לשוק.

הערכים מוגדרים רק לשדות שנדרשים באופן מפורש בשאילתת החיפוש של הבקשה.

ייצוג JSON
{
  "price": {
    object (Price)
  },
  "benchmarkPrice": {
    object (Price)
  },
  "reportCountryCode": string,
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string
}
שדות
price

object (Price)

המחיר הנוכחי של המוצר.

benchmarkPrice

object (Price)

התמחור העדכני ביותר שזמין לקטלוג המוצר במדינה של נקודת ההשוואה.

reportCountryCode

string

המדינה שבה נמצא המחיר המקובל בשוק. מיוצגת בפורמט ISO 3166.

חובה בסעיף SELECT.

id

string

מזהה REST של המוצר, בפורמט channel~languageCode~feedLabel~offerId. אפשר להשתמש במאפיין הזה כדי לצרף נתונים לטבלה productView.

חובה בסעיף SELECT.

offerId

string

המזהה של המוצר שסופק על ידי המוכר.

title

string

שם המוצר.

brand

string

המותג של המוצר.

categoryL1

string

קטגוריית מוצר (רמה ראשונה) בטקסונומיית המוצרים של Google.

categoryL2

string

קטגוריית מוצר (רמה שנייה) בטקסונומיית המוצרים של Google.

categoryL3

string

קטגוריית מוצר (רמה שלישית) בטקסונומיית המוצרים של Google.

categoryL4

string

קטגוריית מוצר (רמה רביעית) בטקסונומיית המוצרים של Google.

categoryL5

string

קטגוריית מוצר (רמה חמישית) בטקסונומיית המוצרים של Google.

productTypeL1

string

סוג המוצר (רמה ראשונה) בטקסונומיית המוצרים של המוכר.

productTypeL2

string

סוג המוצר (רמה שנייה) בטקסונומיית המוצרים של המוכר.

productTypeL3

string

סוג המוצר (רמה שלישית) בטקסונומיית המוצרים של המוכר.

productTypeL4

string

סוג המוצר (רמה רביעית) בטקסונומיית המוצרים של המוכר.

productTypeL5

string

סוג המוצר (רמה חמישית) בטקסונומיית המוצרים של המוכר.

PriceInsightsProductView

השדות הזמינים לשאילתה בטבלה priceInsightsProductView.

דוח מדדי מחירים.

הערכים מוגדרים רק לשדות שנדרשים באופן מפורש בשאילתת החיפוש של הבקשה.

ייצוג JSON
{
  "price": {
    object (Price)
  },
  "suggestedPrice": {
    object (Price)
  },
  "effectiveness": enum (Effectiveness),
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "predictedImpressionsChangeFraction": number,
  "predictedClicksChangeFraction": number,
  "predictedConversionsChangeFraction": number
}
שדות
price

object (Price)

המחיר הנוכחי של המוצר.

suggestedPrice

object (Price)

המחיר המוצע העדכני של המוצר.

effectiveness

enum (Effectiveness)

היעילות החזויה של יישום ההצעה למחיר, בחלוקה לקטגוריות.

id

string

מזהה REST של המוצר, בפורמט channel~languageCode~feedLabel~offerId. אפשר להשתמש במאפיין הזה כדי לצרף נתונים לטבלה productView.

חובה בסעיף SELECT.

offerId

string

המזהה של המוצר שסופק על ידי המוכר.

title

string

שם המוצר.

brand

string

המותג של המוצר.

categoryL1

string

קטגוריית מוצר (רמה ראשונה) בטקסונומיית המוצרים של Google.

categoryL2

string

קטגוריית מוצר (רמה שנייה) בטקסונומיית המוצרים של Google.

categoryL3

string

קטגוריית מוצר (רמה שלישית) בטקסונומיית המוצרים של Google.

categoryL4

string

קטגוריית מוצר (רמה רביעית) בטקסונומיית המוצרים של Google.

categoryL5

string

קטגוריית מוצר (רמה חמישית) בטקסונומיית המוצרים של Google.

productTypeL1

string

סוג המוצר (רמה ראשונה) בטקסונומיית המוצרים של המוכר.

productTypeL2

string

סוג המוצר (רמה שנייה) בטקסונומיית המוצרים של המוכר.

productTypeL3

string

סוג המוצר (רמה שלישית) בטקסונומיית המוצרים של המוכר.

productTypeL4

string

סוג המוצר (רמה רביעית) בטקסונומיית המוצרים של המוכר.

productTypeL5

string

סוג המוצר (רמה חמישית) בטקסונומיית המוצרים של המוכר.

predictedImpressionsChangeFraction

number

השינוי הצפוי בחשיפות על בסיס חלק קטן לאחר הצגת המחיר המומלץ בהשוואה למחיר הפעיל הנוכחי. לדוגמה, 0.05 הוא עלייה חזויה של 5% בחשיפות.

predictedClicksChangeFraction

number

השינוי הצפוי במספר הקליקים באחוזים אחרי הצגת המחיר המומלץ בהשוואה למחיר הפעיל הנוכחי. לדוגמה, 0.05 הוא עלייה חזויה של 5% בקליקים.

predictedConversionsChangeFraction

number

השינוי הצפוי בהמרות כשבר אחרי הצגת המחיר המומלץ בהשוואה למחיר הפעיל הנוכחי. לדוגמה, 0.05 מציין עלייה חזויה של 5% בהמרות).

יעילות

קטגוריית יעילות חזויה.

הדירוג 'יעילות' מציין באילו מוצרים צפויה העלייה הכי גדולה בביצועים אם המחיר ישתנה. הדירוג הזה משקף את השיפור הצפוי בביצועים אם מחיר המבצע ישתנה ואת ההפרש בין המחיר הנוכחי למחיר המוצע. הצעות למחירים עם יעילות של HIGH צפויות להוביל לעלייה הגדולה ביותר בביצועים.

טיפוסים בני מנייה (enum)
EFFECTIVENESS_UNSPECIFIED היעילות לא ידועה.
LOW היעילות נמוכה.
MEDIUM האפקטיביות בינונית.
HIGH האפקטיביות גבוהה.

BestSellersProductClusterView

השדות הזמינים לשאילתה בטבלה bestSellersProductClusterView.

הדוח המוצרים הכי נמכרים כולל אשכולות של מוצרים מובילים. אשכול מוצרים הוא קיבוץ של וריאציות ומוצרים שונים שמייצגים את אותו מוצר, למשל Google Pixel 7.

הערכים מוגדרים רק לשדות שנדרשים באופן מפורש בשאילתת החיפוש של הבקשה.

ייצוג JSON
{
  "reportDate": {
    object (Date)
  },
  "variantGtins": [
    string
  ],
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "inventoryStatus": enum (InventoryStatus),
  "brandInventoryStatus": enum (InventoryStatus),
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
שדות
reportDate

object (Date)

תאריך דוח. הערך בשדה הזה יכול להיות רק אחד מהערכים הבאים:

  • ביום הראשון בשבוע (יום שני) בדוחות השבועיים,
  • היום הראשון בחודש של דוחות חודשיים.

חובה בסעיף SELECT. אם תנאי WHERE ב-reportDate לא מצוין בשאילתה, מוחזר הדוח השבועי או החודשי האחרון הזמין.

variantGtins[]

string

מספרי GTIN של וריאציות לדוגמה של אשכול המוצרים.

reportGranularity

enum (ReportGranularityEnum)

רמת פירוט הדוח. ניתן לבצע את הדירוג לאורך פרק זמן של שבוע או חודש.

חובה בסעיף SELECT. חובה להגדיר תנאי במסגרת reportGranularity בסעיף WHERE.

reportCountryCode

string

המדינה שבה מחושב הדירוג. מיוצגת בפורמט ISO 3166.

חובה בסעיף SELECT. חובה להגדיר תנאי במסגרת reportCountryCode בסעיף WHERE.

reportCategoryId

string (int64 format)

המזהה של קטגוריית המוצר ב-Google לצורך חישוב הדירוג, מיוצג בטקסונומיית המוצרים של Google.

חובה בסעיף SELECT. אם לא צוין תנאי WHERE בשאילתה reportCategoryId, מוחזרים דירוגים לכל הקטגוריות ברמה העליונה.

title

string

השם של אשכול המוצרים.

brand

string

המותג של אשכול המוצרים.

categoryL1

string

קטגוריית המוצרים (רמה ראשונה) של אשכול המוצרים, מיוצגת בטקסונומיית המוצרים של Google.

categoryL2

string

קטגוריית המוצרים (רמה שנייה) של אשכול המוצרים, מיוצגת בטקסונומיית המוצרים של Google.

categoryL3

string

קטגוריית המוצרים (רמה שלישית) של אשכול המוצרים, מיוצגת בטקסונומיית המוצרים של Google.

categoryL4

string

קטגוריית המוצרים (רמה רביעית) של אשכול המוצרים, מיוצגת בטקסונומיית המוצרים של Google.

categoryL5

string

קטגוריית המוצרים (רמה חמישית) של אשכול המוצרים, מיוצגת בטקסונומיית המוצרים של Google.

inventoryStatus

enum (InventoryStatus)

מציין אם אשכול המוצרים הוא IN_STOCK במקור נתוני המוצרים לפחות באחת מהמדינות, OUT_OF_STOCK במקור נתוני המוצרים בכל המדינות, או NOT_IN_INVENTORY בכלל.

בשדה אין התייחסות למסנן המדינות בדוח 'המוצרים הכי נמכרים'.

brandInventoryStatus

enum (InventoryStatus)

גם אם יש לפחות מוצר אחד של המותג IN_STOCK במקור נתוני המוצרים לפחות באחת מהמדינות, הערך של כל המוצרים הוא OUT_OF_STOCK במקור נתוני המוצרים בכל המדינות, או NOT_IN_INVENTORY.

בשדה אין התייחסות למסנן המדינות בדוח 'המוצרים הכי נמכרים'.

rank

string (int64 format)

הפופולריות של אשכול המוצרים ב-Google Ads ובפלטפורמות אורגניות, בקטגוריה ובמדינה שנבחרו, על סמך המספר המשוער של היחידות שנמכרו.

previousRank

string (int64 format)

דירוג הפופולריות בשבוע האחרון או בחודש הקודם

relativeDemand

enum (RelativeDemandEnum)

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

previousRelativeDemand

enum (RelativeDemandEnum)

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

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

שינוי בביקוש המשוער. בין אם הוא עלה, שקע או נשאר שטוח.

ReportGranularityEnum

ערכי רמת הפירוט של הדוח.

טיפוסים בני מנייה (enum)
REPORT_GRANULARITY_ENUM_UNSPECIFIED לא צוין.
WEEKLY הדוח מחושב במשך שבוע,
MONTHLY הדוח מחושב לפי מסגרת זמן של חודש.

InventoryStatus

הסטטוס של אשכול המוצרים או המותג במלאי.

טיפוסים בני מנייה (enum)
INVENTORY_STATUS_UNSPECIFIED לא צוין.
IN_STOCK יש לך מוצר של אשכול המוצרים או המותג הזה במלאי.
OUT_OF_STOCK יש לך מוצר אשכול המוצרים או המותג הזה במלאי, אבל הוא חסר במלאי כרגע.
NOT_IN_INVENTORY אין לך מוצר לאשכול המוצרים או למותג הזה במלאי.

RelativeDemandEnum

ערכי ביקוש יחסיים.

טיפוסים בני מנייה (enum)
RELATIVE_DEMAND_ENUM_UNSPECIFIED לא צוין.
VERY_LOW הביקוש הוא 0-5% מהביקוש של אשכול המוצרים או המותג עם הדירוג הכי גבוה.
LOW הביקוש הוא 6-10% מהביקוש של אשכול המוצרים או המותג עם הדירוג הכי גבוה.
MEDIUM הביקוש הוא 11-20% מהביקוש של אשכול המוצרים או המותג עם הדירוג הכי גבוה.
HIGH הביקוש הוא 21-50% מהביקוש של אשכול המוצרים או המותג עם הדירוג הכי גבוה.
VERY_HIGH הביקוש הוא 51-100% מהביקוש של אשכול המוצרים או המותג עם הדירוג הכי גבוה.

RelativeDemandChangeTypeEnum

ערכים של סוג השינוי בביקוש היחסי.

טיפוסים בני מנייה (enum)
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED לא צוין.
SINKER הביקוש היחסי נמוך יותר מתקופת הזמן הקודמת.
FLAT הביקוש היחסי שווה לתקופה הקודמת.
RISER הביקוש היחסי גבוה יותר מתקופת הזמן הקודמת.

BestSellersBrandView

השדות הזמינים לשאילתה בטבלה bestSellersBrandView.

הדוח המוצרים הכי נמכרים כולל את המותגים המובילים.

הערכים מוגדרים רק לשדות שנדרשים באופן מפורש בשאילתת החיפוש של הבקשה.

ייצוג JSON
{
  "reportDate": {
    object (Date)
  },
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "brand": string,
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
שדות
reportDate

object (Date)

תאריך דוח. הערך בשדה הזה יכול להיות רק אחד מהערכים הבאים:

  • ביום הראשון בשבוע (יום שני) בדוחות השבועיים,
  • היום הראשון בחודש של דוחות חודשיים.

חובה בסעיף SELECT. אם תנאי WHERE ב-reportDate לא מצוין בשאילתה, מוחזר הדוח השבועי או החודשי האחרון הזמין.

reportGranularity

enum (ReportGranularityEnum)

רמת פירוט הדוח. ניתן לבצע את הדירוג לאורך פרק זמן של שבוע או חודש.

חובה בסעיף SELECT. חובה להגדיר תנאי במסגרת reportGranularity בסעיף WHERE.

reportCountryCode

string

המדינה שבה מחושב הדירוג. מיוצגת בפורמט ISO 3166.

חובה בסעיף SELECT. חובה להגדיר תנאי במסגרת reportCountryCode בסעיף WHERE.

reportCategoryId

string (int64 format)

המזהה של קטגוריית המוצר ב-Google לצורך חישוב הדירוג, מיוצג בטקסונומיית המוצרים של Google.

חובה בסעיף SELECT. אם לא צוין תנאי WHERE בשאילתה reportCategoryId, מוחזרים דירוגים לכל הקטגוריות ברמה העליונה.

brand

string

שם המותג

rank

string (int64 format)

הפופולריות של המותג ב-Google Ads ובפלטפורמות אורגניות, בקטגוריה ובמדינה שנבחרו, על סמך המספר המשוער של היחידות שנמכרו.

previousRank

string (int64 format)

דירוג הפופולריות בשבוע האחרון או בחודש הקודם

relativeDemand

enum (RelativeDemandEnum)

הביקוש המשוער ביחס למותג עם דירוג הפופולריות הגבוה ביותר באותה קטגוריה ובאותה מדינה.

previousRelativeDemand

enum (RelativeDemandEnum)

הביקוש המשוער ביחס למותג עם דירוג הפופולריות הגבוה ביותר באותה קטגוריה ובאותה מדינה בשבוע או בחודש הקודמים.

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

שינוי בביקוש המשוער. בין אם הוא עלה, שקע או נשאר שטוח.

CompetitiveVisibilityCompetitorView

השדות הזמינים לשאילתה בטבלה competitiveVisibilityCompetitorView.

הדוח חשיפה תחרותית מוצג לעסקים עם חשיפה דומה.

הערכים מוגדרים רק לשדות שנדרשים באופן מפורש בשאילתת החיפוש של הבקשה.

ייצוג JSON
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number,
  "relativeVisibility": number
}
שדות
date

object (Date)

התאריך של השורה הזו.

נדרש תנאי ב-date בסעיף WHERE.

domain

string

הדומיין של המתחרה או של הדומיין שלך, אם 'isYourDomain' נכון.

חובה בסעיף SELECT. לא ניתן לסנן לפי 'WHERE' סעיף

isYourDomain

boolean

הערך הוא True אם השורה הזו מכילה נתונים לגבי הדומיין.

לא ניתן לסנן לפי 'WHERE' סעיף

reportCountryCode

string

המדינה שבה הופיעו החשיפות.

חובה בסעיף SELECT. נדרש תנאי ב-reportCountryCode בסעיף WHERE.

reportCategoryId

string (int64 format)

המזהה של קטגוריית המוצר ב-Google שרוצים לחשב את הדוח, מיוצג בטקסונומיית המוצרים של Google.

חובה בסעיף SELECT. נדרש תנאי ב-reportCategoryId בסעיף WHERE.

trafficSource

enum (TrafficSourceEnum)

מקור התנועה של חשיפות.

חובה בסעיף SELECT.

rank

string (int64 format)

מיקום הדומיין בדירוג העסקים הדומים של המפתחות שנבחרו (date, reportCategoryId, reportCountryCode, trafficSource) על סמך החשיפות. 1 הוא הגבוה ביותר.

לא ניתן לסנן לפי 'WHERE' סעיף

adsOrganicRatio

number

יחס מודעות / חיפוש אורגני: התדירות שבה הדומיין מקבל חשיפות ממודעות שופינג בהשוואה לתנועה אורגנית. המספר יעוגל ויסווג בקטגוריה.

לא ניתן לסנן לפי 'WHERE' סעיף

pageOverlapRate

number

שיעור החפיפה בדף מראה את התדירות שבה המוצרים של קמעונאים מתחרים מוצגים יחד עם המוצרים שלכם באותו דף.

לא ניתן לסנן לפי 'WHERE' סעיף

higherPositionRate

number

שיעור מיקום גבוה יותר מציין את התדירות שבה מוצר של מתחרה הופיע בדף מיקום גבוה יותר מזה של המוצר שלכם.

לא ניתן לסנן לפי 'WHERE' סעיף

relativeVisibility

number

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

לא ניתן לסנן לפי 'WHERE' סעיף

TrafficSourceEnum

ערכים של מקורות תנועה.

טיפוסים בני מנייה (enum)
TRAFFIC_SOURCE_ENUM_UNSPECIFIED לא צוין.
ORGANIC תנועה אורגנית.
ADS תנועה ממודעות.
ALL תנועה אורגנית ותנועה ממודעות.

CompetitiveVisibilityTopMerchantView

השדות הזמינים לשאילתה בטבלה competitiveVisibilityTopMerchantView.

דוח חשיפה תחרותית עם העסק עם החשיפה הגבוהה ביותר.

הערכים מוגדרים רק לשדות שנדרשים באופן מפורש בשאילתת החיפוש של הבקשה.

ייצוג JSON
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number
}
שדות
date

object (Date)

התאריך של השורה הזו.

לא ניתן לבחור באפשרות SELECT. נדרש תנאי ב-date בסעיף WHERE.

domain

string

הדומיין של המתחרה או של הדומיין שלך, אם 'isYourDomain' נכון.

חובה בסעיף SELECT. לא ניתן לסנן לפי 'WHERE' סעיף

isYourDomain

boolean

הערך הוא True אם השורה הזו מכילה נתונים לגבי הדומיין.

לא ניתן לסנן לפי 'WHERE' סעיף

reportCountryCode

string

המדינה שבה הופיעו החשיפות.

חובה בסעיף SELECT. נדרש תנאי ב-reportCountryCode בסעיף WHERE.

reportCategoryId

string (int64 format)

המזהה של קטגוריית המוצר ב-Google שרוצים לחשב את הדוח, מיוצג בטקסונומיית המוצרים של Google.

חובה בסעיף SELECT. נדרש תנאי ב-reportCategoryId בסעיף WHERE.

trafficSource

enum (TrafficSourceEnum)

מקור התנועה של חשיפות.

חובה בסעיף SELECT.

rank

string (int64 format)

מיקום הדומיין בדירוג המוכרים המובילים של המפתחות שנבחרו (date, reportCategoryId, reportCountryCode, trafficSource) על סמך החשיפות. 1 הוא הגבוה ביותר.

לא ניתן לסנן לפי 'WHERE' סעיף

adsOrganicRatio

number

יחס מודעות / חיפוש אורגני: התדירות שבה הדומיין מקבל חשיפות ממודעות שופינג בהשוואה לתנועה אורגנית. המספר יעוגל ויסווג בקטגוריה.

לא ניתן לסנן לפי 'WHERE' סעיף

pageOverlapRate

number

שיעור החפיפה בדף מראה את התדירות שבה המוצרים של קמעונאים מתחרים מוצגים יחד עם המוצרים שלכם באותו דף.

לא ניתן לסנן לפי 'WHERE' סעיף

higherPositionRate

number

שיעור מיקום גבוה יותר מציין את התדירות שבה מוצר של מתחרה הופיע בדף מיקום גבוה יותר מזה של המוצר שלכם.

לא ניתן לסנן לפי 'WHERE' סעיף

CompetitiveVisibilityBenchmarkView

השדות הזמינים לשאילתה בטבלה competitiveVisibilityBenchmarkView.

דוח חשיפה תחרותית עם נקודת ההשוואה בקטגוריה.

הערכים מוגדרים רק לשדות שנדרשים באופן מפורש בשאילתת החיפוש של הבקשה.

ייצוג JSON
{
  "date": {
    object (Date)
  },
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "yourDomainVisibilityTrend": number,
  "categoryBenchmarkVisibilityTrend": number
}
שדות
date

object (Date)

התאריך של השורה הזו.

חובה בסעיף SELECT. נדרש תנאי ב-date בסעיף WHERE.

reportCountryCode

string

המדינה שבה הופיעו החשיפות.

חובה בסעיף SELECT. נדרש תנאי ב-reportCountryCode בסעיף WHERE.

reportCategoryId

string (int64 format)

המזהה של קטגוריית המוצר ב-Google שרוצים לחשב את הדוח, מיוצג בטקסונומיית המוצרים של Google.

חובה בסעיף SELECT. נדרש תנאי ב-reportCategoryId בסעיף WHERE.

trafficSource

enum (TrafficSourceEnum)

מקור התנועה של חשיפות.

חובה בסעיף SELECT.

yourDomainVisibilityTrend

number

שינוי בחשיפה על סמך חשיפות לדומיין שלך ביחס לתחילת טווח הזמן שנבחר (או היום הראשון עם חשיפות שאינן אפס).

לא ניתן לסנן לפי 'WHERE' סעיף

categoryBenchmarkVisibilityTrend

number

שינוי בחשיפה שמבוסס על חשיפות ביחס להתחלה של טווח הזמן שנבחר (או היום הראשון עם מספר חשיפות שאינו אפס) עבור קבוצה משולבת של מוכרים עם החשיפה הגבוהה ביותר המשוערת לשוק.

לא ניתן לסנן לפי 'WHERE' סעיף