تقسیم بندی

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

همانند گزارش‌های سفارشی در مرکز فروشندگان، می‌توانید چندین بخش را در یک پرس‌وجو با استفاده از 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'

اجرا کنید

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

نتایج ارسال این کوئری به 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"
      }
    }
  ]
}

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

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

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

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

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

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

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

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

Home & Garden > Kitchen & Dining > Kitchen Appliances > 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

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

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

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

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

• 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

اطلاعات بیشتر

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