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

כך אפשר לשלב את דוחות המוכרים ב-Content API הקיים שלכם הטמעת מודעות שופינג.

בקשות

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

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

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

Content API ממשק API של Merchant
כתובת URL https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/reports/search https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search
מזהים {merchantId} {parent}

שיטות

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

צפיות

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

MerchantPerformanceView נקראת עכשיו product_performance_view.

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

Content API ממשק API של Merchant
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 לבין ממשק API של Merchant:

Content API ממשק API של Merchant
   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 ממשק API של Merchant
{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}
{
  "productPerformanceView" : {
    "offerId": "abc",
    "clicks": "123"
  }
}

אפשר להשתמש בשם הטבלה כקידומת של שדה. לדוגמה, גם offer_id וגם בשאילתה של Merchant API אפשר להזין את הערכים product_performance_view.offer_id.

ביצועים

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

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

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

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

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

מוצר

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

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

תחרותיות במחיר

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

Content API ממשק API של Merchant תיאור
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 ממשק API של Merchant תיאור
bestSellers.countryCode: מחרוזת reportCountryCode: מחרוזת השם של השדה countryCode השתנה ל-reportCountryCode
bestSellers.categoryId: int reportCategoryId: int השם של השדה categoryId השתנה ל-reportCategoryId

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

ריכזנו כאן את השינויים שבוצעו בתצוגות המפורטות ב'חשיפה בהשוואה למתחרים' ב-Merchant Reports API:

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