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 * ) یک خطا برمی گرداند.

پاسخ نمونه زیر نشان می‌دهد که بازرگان در بین 1 دسامبر 2023 تا 21 دسامبر 2023، 4440 کلیک در کل محصولات، در همه روش‌های بازاریابی داشته است.

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4,440"
      }
    }
  ]
}

بخش ها

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

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

فیلدهای Segments مشابه 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

پاسخ نمونه زیر نشان می‌دهد که تاجر 1546 کلیک روی همه محصولات، در همه روش‌های بازاریابی، در 1 دسامبر 2023، و 829 کلیک روی همه محصولات، در همه روش‌های بازاریابی، در 2 دسامبر 2023 داشته است. تاجر هیچ کلیکی روی آن نداشت. 3 دسامبر 2023، بنابراین چیزی برای آن تاریخ برگردانده نمی شود.

{
  "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 چندین بخش را در یک جستار مشخص کنید.

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

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

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

سطوح دسته
دسته بندی ها از طبقه بندی محصولات گوگل . اگر هیچ کدام ارائه نشده باشد، ممکن است 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"
        }
      }
    }
  ]
}

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