העברת הדוחות מ-Content API for Shopping

אתם יכולים להשתמש ב-Merchant Reports API כדי לקבל מידע על המוצרים שלכם, על הביצועים שלהם ועל הסביבה התחרותית שלהם ב-Google באמצעות תצוגת הנתונים שהוא מציע.

אתם יכולים להשתמש ב-Merchant Reports API כדי:

כך אפשר לשלב את Merchant Reports API עם ההטמעה הקיימת של Content API for Shopping.

בקשות

הפורמט של כתובת ה-URL לבקשה ב-Merchant Reports API הוא:

POST https://merchantapi.googleapis.com/reports/v1/{PARENT}/reports:search

הנה השוואה לדוגמה בין Content API for Shopping לבין Merchant Reports API עבור בקשות search:

Content API Merchant API
כתובת URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/reports/search https://merchantapi.googleapis.com/reports/v1/{PARENT}/reports:search
מזהים {MERCHANT_ID} {PARENT}

Methods

כדי לשלוח שאילתה אל Merchant Reports API, צריך להפעיל את method‏ ReportService.Search.

צפיות

ב-Merchant API, שמות הטבלאות השתנו מ-CamelCase ל-snake_case.

השם של MerchantPerformanceView הוא עכשיו product_performance_view.

הנה מיפוי בין שמות הטבלאות ב-Content API for Shopping לבין Merchant API:

Content API Merchant API
MerchantPerformanceView product_performance_view
ProductView product_view
PriceCompetitivenesProductView price_competitiveness_product_view
PriceInsightsProductView price_insights_product_view
BestSellersBrandView best_sellers_brand_view
BestSellersProductClusterView best_sellers_product_cluster_view
CompetitiveVisibilityCompetitorView competitive_visibility_competitor_view
CompetitiveVisibilityTopMerchantView competitive_visibility_top_merchant_view
CompetitiveVisibilityBenchmarkView competitive_visibility_benchmark_view

ב-Merchant API, כבר לא צריך לציין קידומת של שדה, למשל segments.offer_id. במקום זאת, צריך להשתמש רק בשם השדה, offer_id.

הנה דוגמה להשוואה בין שאילתות ב-Content API for Shopping וב-Merchant API:

Content API Merchant API 
   SELECT
     segments.offer_id,
     metrics.clicks
   FROM MerchantPerformanceView
   WHERE segments.date DURING LAST_7_DAYS
   
   SELECT
     offer_id,
     clicks
   FROM product_performance_view
   WHERE date DURING LAST_7_DAYS

דוגמה לתשובה:

Content API Merchant API 
{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}
 
{
  "productPerformanceView" : {
    "offerId": "abc",
    "clicks": "123"
  }
}

אפשר להשתמש בשם הטבלה כתוספת לשם של השדה. לדוגמה, אפשר להשתמש ב-offer_id וב-product_performance_view.offer_id בשאילתת Merchant API.

ביצועים

אלה השינויים שבוצעו בתצוגת הביצועים ב-Merchant Reports API:

Content API Merchant API תיאור
‫segments.program: מחרוזת ‫marketing_method: מחרוזת הפלח program הוחלף בשדה marketing_method חדש. פרטים נוספים מופיעים במאמר בנושא ערכים חדשים של marketing method.
‫metrics.ctr: double ‫clickThroughRate: double השם של המדד ctr השתנה ל-clickThroughRate
metrics.conversionValueMicros: מספר שלם
segments.currencyCode: מחרוזת 		conversionValue: {
object (Price)
} 		השדות 'סכום במיקרו' ו'מטבע' מוזגים לשדה אחד עם סוג Price
metrics.orders,
metrics.orderedItems,
… 		לא נתמך מדדים של 'קונים ב-Google' לא נתמכים ב-Merchant Reports API

ערכים חדשים של שיטות שיווק

זוהי המיפוי בין הערכים של segments.program לבין הערכים של marketing_method:

Content API Merchant API
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING לא נתמך

מוצר

אלה השינויים שבוצעו בתצוגת המוצרים ב-Merchant Reports API:

Content API Merchant API תיאור
‫productView.id: מחרוזת ‫id: מחרוזת הפורמט של השדה משתנה מ-channel:language:targetCountry:offerId ל-
channel~language~feedLabel~offerId
productView.priceMicros: מספר שלם
productView.currencyCode: מחרוזת 		price: {
object (Price)
} 		השדות 'סכום במיקרו' ו'מטבע' מוזגים לשדה אחד עם סוג Price
‫productView.aggregated_destination_status: מחרוזת ‫aggregated_reporting_context_status: מחרוזת השדה aggregated_destination_status משנה את השם ל-aggregated_reporting_context_status, הערכים לא משתנים
productView.item_issues: [
{
object (ItemIssue)
}
] 		item_issues: [
{
object (ItemIssue)
}
] 		ההגדרה של ItemIssue השתנתה
לא נתמך ‫feedLabel: מחרוזת השדה feedLabel מוצג

מדדי מחירים

אלה השינויים שבוצעו בתצוגת מדדי המחירים ב-Merchant Reports API:

Content API Merchant API תיאור
‫productView.id: מחרוזת ‫id: מחרוזת הפורמט של השדה משתנה מ-channel:language:targetCountry:offerId ל-channel~language~feedLabel~offerId
‫productView.priceMicros: integer ‫
productView.currencyCode: string 		price: {
object (Price)
} 		השדות 'סכום במיקרו' ו'מטבע' מוזגים לשדה אחד עם סוג Price
‫priceInsights.suggestedPriceMicros: מספר שלם ‫
‫priceInsights.suggestedPriceCurrencyCode: מחרוזת 		suggestedPrice: {
object (Price)
} 		השדות 'סכום במיקרו' ו'מטבע' מוזגים לשדה אחד עם סוג Price
‫priceInsights.predictedGrossProfitChangeFraction: double ‫
‫priceInsights.predictedMonthlyGrossProfitChangeMicros: integer ‫
‫priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: string 		לא נתמך אין תמיכה בשדות שקשורים לשינוי ברווח ברוטו ב-Merchant Reports API

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

אלה השינויים שבוצעו בתצוגה של השוואת המחירים ביחס לשוק ב-Merchant Reports API:

Content API Merchant API תיאור
‫productView.id: מחרוזת ‫id: מחרוזת הפורמט של השדה משתנה מ-channel:language:targetCountry:offerId ל-channel~language~feedLabel~offerId
‫productView.priceMicros: מספר שלם ‫
‫productView.currencyCode: מחרוזת 		price: {
object (Price)
} 		השדות 'סכום במיקרו' ו'מטבע' מוזגים לשדה אחד עם סוג Price
‫priceCompetitiveness.countryCode: מחרוזת ‫reportCountryCode: מחרוזת השם של השדה countryCode השתנה ל-reportCountryCode
‫priceCompetitiveness.benchmarkPriceMicros: מספר שלם ‫
‫priceCompetitiveness.benchmarkPriceCurrencyCode: מחרוזת 		benchmarkPrice: {
object (Price)
} 		השדות 'סכום במיקרו' ו'מטבע' מוזגים לשדה אחד עם סוג Price

המוצרים הכי נמכרים

אלה השינויים שחלו בתצוגות של המוצרים הכי נמכרים ב-Merchant Reports API:

Content API Merchant API תיאור
‫bestSellers.countryCode: מחרוזת ‫reportCountryCode: מחרוזת השם של השדה countryCode השתנה ל-reportCountryCode
‫bestSellers.categoryId: int ‫reportCategoryId: int השם של השדה categoryId השתנה ל-reportCategoryId

חשיפה תחרותית

אלה השינויים שחלו בתצוגות של נתוני החשיפה בהשוואה למתחרים ב-Merchant Reports API:

Content API Merchant API תיאור
‫competitiveVisibility.countryCode: מחרוזת ‫reportCountryCode: מחרוזת השם של השדה countryCode השתנה ל-reportCountryCode
‫competitiveVisibility.categoryId: מספר שלם ‫reportCategoryId: מספר שלם השם של השדה categoryId השתנה ל-reportCategoryId

הקודם
Migrate conversion sources management
הבא
Migrate local feeds partnership management