Segmentation

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

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

در اینجا یک پرس و جو نمونه است که کلیک‌ها را برای همه محصولات در حساب شما در یک دوره 30 روزه برمی‌گرداند که بر اساس marketingMethod و offerId تقسیم‌بندی شده است:

SELECT marketingMethod, offerId, clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-11-01' AND '2020-11-30'

پاسخ این پرس و جو شامل یک ردیف برای هر ترکیبی از offerId و marketingMethod با تعداد کلیک برای آن ترکیب است:

{
  "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

معیارهای ارز و قیمت

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

SELECT conversionValue
FROM ProductPerformanceView
WHERE date = '2020-11-01'

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

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

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

SELECT conversions, conversionValue
FROM ProductPerformanceView
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"
        }
      }
    }
  ]
}

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

،

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

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

در اینجا یک پرس و جو نمونه است که کلیک‌ها را برای همه محصولات در حساب شما در یک دوره 30 روزه برمی‌گرداند که بر اساس marketingMethod و offerId تقسیم‌بندی شده است:

SELECT marketingMethod, offerId, clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-11-01' AND '2020-11-30'

پاسخ این پرس و جو شامل یک ردیف برای هر ترکیبی از offerId و marketingMethod با تعداد کلیک برای آن ترکیب است:

{
  "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

معیارهای ارز و قیمت

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

SELECT conversionValue
FROM ProductPerformanceView
WHERE date = '2020-11-01'

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

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

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

SELECT conversions, conversionValue
FROM ProductPerformanceView
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"
        }
      }
    }
  ]
}

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