تقسیم بندی

بخش‌بندی موجود در گزارش‌های سفارشی Merchant Center، می‌تواند در گزارش API با افزودن فیلد مناسب به یک جستجو پیاده‌سازی شود. به عنوان مثال، پرس و جو برای segments.program منجر به یک گزارش با یک ردیف برای هر برنامه (تبلیغات خرید، لیست محصولات رایگان و غیره) می شود که شامل معیارهای (نمایش ها، کلیک ها و غیره) برای آن برنامه همانطور که در بند SELECT مشخص شده است، می شود. .

همانند گزارش‌های سفارشی در Merchant Center، می‌توانید با Reporting API چندین بخش را در یک جستار مشخص کنید.

جستجوی نمونه زیر، کلیک‌ها را برای همه محصولات در حساب شما در یک دوره 30 روزه، تقسیم‌بندی شده بر اساس program و offer_id بازیابی می‌کند:

SELECT
  segments.program,
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'

اجرا کنید

روی Run کلیک کنید تا نمونه را در API Explorer امتحان کنید. بعد از اینکه روی Run کلیک کردید، مکان‌دار شناسه فروشنده را به شناسه فروشنده خود در URL درخواست به‌روزرسانی کنید. می توانید پرس و جو را اصلاح کنید. جستجوی کامل باید در یک خط باقی بماند تا با کاوشگر API کار کند.

نتایج ارسال این درخواست به reports.search ردیفی است که کلیک‌ها را برای هر ترکیبی از offer_id و program مشخص می‌کند، مانند این رشته JSON نمونه:

{
  "results": [
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12345"
      },
      "metrics": {
        "clicks": "38"
      }
    },
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "125"
      }
    },
    {
      "segments": {
        "program": "FREE_PRODUCT_LISTING",
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "23"
      }
    },
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "8"
      }
    },
    {
      "segments": {
        "program": "FREE_PRODUCT_LISTING",
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "3"
      }
    }
  ]
}

دسته بندی و نوع محصول

زبان پرس و جو Merchant Center از تقسیم بندی معیارها بر اساس دو گروه از ویژگی ها پشتیبانی می کند که می توانید برای سازماندهی موجودی خود تعریف کنید:

سطوح دسته ( segments.category_l1 ، segments.category_l2 ، و غیره)

دسته بندی ها از طبقه بندی محصولات گوگل . اگر هیچ کدام ارائه نشده باشد، ممکن است Google به طور خودکار دسته را به محصول شما اختصاص دهد یا دسته بندی ارائه شده را بیشتر اصلاح کند.

سطوح نوع محصول ( segments.product_type_l1 ، segments.product_type_l2 و غیره)

انواع محصولی که بر اساس دسته بندی خود اختصاص می دهید . برخلاف سطوح دسته، مجموعه ای از مقادیر پشتیبانی شده از پیش تعریف شده وجود ندارد.

هر دو ویژگی دسته و نوع محصول در یک سلسله مراتب با سطوح چندگانه سازماندهی شده اند. مشخصات محصول هر سطح را با کاراکتر > جدا می کند، اما شما هر سطح از سلسله مراتب را به طور جداگانه در گزارش ها انتخاب می کنید.

به عنوان مثال، محصولی را با سطوح نوع محصول زیر در نظر بگیرید:

Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators

گزارش ها هر سطح را در زمینه خود به شرح زیر برمی گرداند:

بخش	ارزش
segments.product_type_l1	Home & Garden
segments.product_type_l2	Kitchen & Dining
segments.product_type_l3	Kitchen Appliances
segments.product_type_l4	Refrigerators

معیارهای ارز و قیمت

قسمت segments.currency_code یک ReportRow ارزی را نشان می‌دهد که معیارهای قیمت مانند metrics.conversion_value_micros در آن برگردانده می‌شوند. از آنجایی که این برای تفسیر صحیح این معیارها مهم است، هر زمان که یکی از معیارهای قیمت زیر را انتخاب کنید، ReportRow بازگشتی به طور خودکار شامل segments.currency_code می شود.

• metrics.conversion_value_micros

• metrics.aov_micros
• metrics.ordered_item_sales_micros
• metrics.returns_micros
• metrics.shipped_item_sales_micros

معیارهای گوگل را بخرید

زبان جستجوی Merchant Center از دو دسته معیار برای سفارش‌های خرید در Google پشتیبانی می‌کند: معیارهای سطح مورد و معیارهای سطح سفارش.

معیارهای سطح آیتم

معیارهایی که بر اساس اقلام داخل سفارش ها محاسبه می شوند و با ابعاد محصول اقلام در هر سفارش مرتبط هستند.

• metrics.item_days_to_ship
• metrics.item_fill_rate
• metrics.ordered_items
• metrics.ordered_item_sales_micros
• metrics.rejected_items
• metrics.returned_items
• metrics.return_rate
• metrics.returns_micros
• metrics.shipped_items
• metrics.shipped_item_sales_micros
• metrics.unshipped_items

معیارهای سطح سفارش

معیارهای محاسبه شده بر اساس هر سفارش.

• metrics.aos
• metrics.aov_micros
• metrics.days_to_ship
• metrics.orders
• metrics.shipped_orders
• metrics.unshipped_orders

معیارهای سطح سفارش با ابعاد محصول اقلام در هر سفارش مرتبط نیست .

می توانید معیارهای سطح مورد را در ترکیب با هر بخش موجود انتخاب کنید. با این حال، انتخاب معیارهای سطح سفارش در ترکیب با هر یک از بخش‌های بعد محصول زیر ناموفق خواهد بود:

• segments.brand
• segments.category_l1 , segments.category_l2 , segments.category_l3 , segments.category_l4 , segments.category_l5
• segments.custom_label1 ، segments.custom_label2 ، segments.custom_label3 ، segments.custom_label4 ، segments.custom_label5
• segments.offer_id
• segments.product_type_l1 , segments.product_type_l2 , segments.product_type_l3 , segments.product_type_l4 , segments.product_type_l5
• segments.title

بیشتر بدانید

برای فهرست کامل بخش‌ها، مستندات را بررسی کنید.