Performance reports

رابط برنامه‌نویسی کاربردی فروشنده (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": "4,440"
      }
    }
  ]
}

بخش‌ها

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

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

فیلدهای Segments مشابه GROUP BY در SQL عمل می‌کنند. فیلدهای Segments معیارهای انتخاب شده را تقسیم می‌کنند و بر اساس هر بخش در عبارت 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"
      }
    }
  ]
}

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

در اینجا یک پرس و جوی نمونه وجود دارد که کلیک‌های مربوط به همه محصولات موجود در حساب شما را در یک دوره 30 روزه، که بر اساس 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"
      }
    }
  ]
}

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

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

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

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

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

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 مراجعه کنید.