כך אפשר לשלב את Merchant Reports API עם ההטמעה הקיימת של Content API for Shopping.
בקשות
צריך להשתמש בפורמט הבא של כתובת ה-URL של הבקשה ל-Merchant Reports API:
POST https://merchantapi.googleapis.com/reports/v1beta/{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/v1beta/{PARENT}/reports:search |
| מזהים | {MERCHANT_ID}
|
{PARENT}
|
Methods
אפשר לשלוח שאילתה ל-Merchant Reports API באמצעות הקריאה ל-method ReportService.Search.
צפיות
ב-Merchant API, שמות הטבלאות משתנים מ-CammelCase ל-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: {
|
שדות הסכום ב-micros ושדות המטבעות מוזגים לשדה אחד עם סוג Price
|
metrics.orders,
|
לא נתמך | המדדים של 'קונים ב-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: {
|
שדות הסכום ב-micros ושדות המטבעות מוזגים לשדה אחד עם סוג Price
|
productView.aggregated_destination_status: מחרוזת
|
aggregated_reporting_context_status: מחרוזת
|
השם של השדה aggregated_destination_status השתנה ל-aggregated_reporting_context_status, הערכים לא השתנו
|
productView.item_issues: [
|
item_issues: [
|
ההגדרה של ItemIssue השתנתה
|
| לא נתמך | feedLabel: מחרוזת
|
השדה feedLabel נוסף
|
מדדי מחירים
אלה השינויים שחלו בתצוגה של מדדי המחירים ב-Merchant Reports API:
| Content API | Merchant API | תיאור |
productView.id: מחרוזת
|
id: מחרוזת
|
פורמט השדה משתנה מ-channel:language:targetCountry:offerId ל-channel~language~feedLabel~offerId
|
productView.priceMicros: מספר שלם
productView.currencyCode: מחרוזת
|
price: {
|
שדות הסכום ב-micros ושדות המטבעות מוזגים לשדה אחד עם סוג Price
|
priceInsights.suggestedPriceMicros: מספר שלם
priceInsights.suggestedPriceCurrencyCode: מחרוזת
|
suggestedPrice: {
|
שדות הסכום ב-micros ושדות המטבעות מוזגים לשדה אחד עם סוג 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: {
|
שדות הסכום ב-micros ושדות המטבעות מוזגים לשדה אחד עם סוג Price
|
priceCompetitiveness.countryCode: מחרוזת
|
reportCountryCode: מחרוזת
|
השם של השדה countryCode השתנה ל-reportCountryCode
|
priceCompetitiveness.benchmarkPriceMicros: מספר שלם
priceCompetitiveness.benchmarkPriceCurrencyCode: מחרוזת
|
benchmarkPrice: {
|
שדות הסכום ב-micros ושדות המטבעות מוזגים לשדה אחד עם סוג 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
|