این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

تقسیم بندی

بخش‌بندی موجود در گزارش‌های سفارشی 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.order_item_sales_micros در آن برگردانده می‌شود. از آنجایی که این برای تفسیر صحیح این معیارها مهم است، هر زمان که یکی از معیارهای قیمت زیر را انتخاب کنید، ReportRow برگشتی به طور خودکار شامل segments.currency_code می شود.

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

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

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

قبلی

مشاهده گرایش های خرید

بعدی

صفحه بندی