گزارش‌های عملکرد

‫Merchant API گزارش‌های عملکرد ارائه می‌دهد، برای مثال product_performance_view. این صفحه ساختار گزارش‌های عملکرد را توضیح می‌دهد.

سنجه‌ها

می‌توانید سنجه‌هایی (برای مثال، clicks و impressions) را که می‌خواهید برگردانده شود جستجو کنید. برای پرسمان کردن سرویس «گزارش‌ها» برای داده‌های عملکرد، باید فیلتری روی محدوده تاریخ اضافه کنید.

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

SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'

باید داده‌هایی را که می‌خواهید برگردانده شود مشخص کنید. نویسه‌های عام (مثلاً SELECT *) خطا برمی‌گردانند.

نمونه پاسخ زیر نشان می‌دهد که فروشنده درمجموع ۴٬۴۴۰ کلیک در همه محصولات و در همه روش‌های بازاریابی بین ۱ دسامبر ۲۰۲۳ و ۲۱ دسامبر ۲۰۲۳ داشته است.

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4440"
      }
    }
  ]
}

بخش‌ها

می‌توانید از فیلدهای بخش‌ها برای بخش‌بندی در گزارش‌های عملکرد استفاده کنید. برای مثال، پرسمان برای marketing_method گزارشی را با یک ردیف برای هر روش بازاریابی و سنجه‌هایی که برای آن روش بازاریابی در عبارت SELECT مشخص می‌کنید برمی‌گرداند.

فیلدهای بخش‌ها می‌توانند مشخصه‌های محصول (برای مثال، offer_id، brand، و category) یا مشخصه‌های رویداد (برای مثال، date و marketing_method) باشند.

فیلدهای بخش‌ها مشابه GROUP BY در SQL عمل می‌کنند. فیلدهای بخش‌ها سنجه‌های انتخاب‌شده را تقسیم می‌کنند و براساس هر بخش در عبارت SELECT گروه‌بندی می‌کنند.

در اینجا نمونه پُرسمانی را می‌بینید که کلیک‌ها را در روز، به‌ترتیب نزولی براساس clicks، در شرایط اضافه‌شده محدوده تاریخ برمی‌گرداند. فقط ردیف‌هایی که حداقل یک سنجه درخواستی غیرصفر دارند برگردانده می‌شوند.

SELECT
  date,
  clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-03'
ORDER BY clicks DESC

پاسخ نمونه زیر نشان می‌دهد که فروشنده در ۱ دسامبر ۲۰۲۳، ۱٬۵۴۶ کلیک در همه محصولات و در همه روش‌های بازاریابی داشته است و در ۲ دسامبر ۲۰۲۳، ۸۲۹ کلیک در همه محصولات و در همه روش‌های بازاریابی داشته است. فروشنده در ۳ دسامبر ۲۰۲۳ هیچ کلیکی نداشته است، بنابراین چیزی برای آن تاریخ برگردانده نمی‌شود.

{
  "results": [
    {
      "productPerformanceView": {
        "date": {
          "year": 2023,
          "month": 12,
          "day": 1
        },
        "clicks": "1546"
      }
    },
    {
      "productPerformanceView": {
        "date": {
          "year": 2023,
          "month": 12,
          "day": 2
        },
        "clicks": "829"
      }
    }
  ]
}

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

در اینجا نمونه پرسمانی آورده شده است که کلیک‌های همه محصولات حسابتان را در یک دوره ۳۰ روزه، بخش‌بندی‌شده براساس marketing_method و offer_id، برمی‌گرداند:

SELECT marketing_method, offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'

پاسخ این پُرسمان شامل یک ردیف برای هر ترکیب از offer_id و marketing_method، با تعداد کلیک‌ها برای آن ترکیب است:

{
  "results": [
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12345",
        "clicks": "38"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12346",
        "clicks": "125"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12346",
        "clicks": "23"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12347",
        "clicks": "8"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12347",
        "clicks": "3"
      }
    }
  ]
}

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

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

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

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

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

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

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

بخش مقدار
product_type_l1 Home & Garden
product_type_l2 Kitchen & Dining
product_type_l3 Kitchen Appliances
product_type_l4 Refrigerators

سنجه‌های واحد پول و قیمت

سنجه‌های قیمت، مانند conversion_value، بااستفاده از نوع Price نمایش داده می‌شوند. اگر سنجه در چند واحد پول دردسترس باشد، مقدار هر واحد پول در ردیف جداگانه‌ای برگردانده می‌شود. برای مثال، پُرسمان زیر:

SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'

نتایج زیر را برمی‌گرداند:

{
  "results": [
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

اگر در پُرسمانی هم سنجه‌های قیمت و هم سنجه‌های غیرقیمت را درخواست کنید، سنجه‌های قیمت در ردیف‌های نتیجه جداگانه‌ای از سنجه‌های غیرقیمت برگردانده می‌شوند، یک ردیف نتیجه برای هر کد ارز. برای مثال، پُرسمان زیر:

SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'

پاسخ زیر را برمی‌گرداند:

{
  "results": [
    {
      "productPerformanceView": {
        "conversions": "27",
        "conversionValue": {
          "amountMicros": "0",
          "currencyCode": ""
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

همه فیلدهایی که انتخاب می‌کنید در پاسخ برگردانده می‌شوند، حتی اگر مقدار آن‌ها هنوز مقدار پیش‌فرض یا صفر باشد.

برای اطلاعات بیشتر درباره فیلدهای دردسترس برای پُرسمان، به فیلدها در جدول productPerformanceView مراجعه کنید.

قبلی
Evaluate your products
بعدی
Understand the market