نظرة عامة

Reporting API

تتيح Reporting API للتاجر التفاعل مع بيانات الأداء آليًا من خلال لغة طلب البحث في Merchant Center. وهذا يشبه القدرة على إنشاء تقارير مخصّصة مباشرةً في Merchant Center توفّر Reporting API المزايا التالية:

• للسماح للتجار الكبار باستيراد بيانات الأداء لبيانات المنتج إلى أنظمة الإبلاغ الداخلية أو الخارجية لديهم.
• تسمح للمستخدمين وشركاء خارجيين ومجمّعي السلع الذين يديرون التاجر إعداد تقارير الوصول إلى حسابات المركز

يمكن لمستخدمي واجهة برمجة التطبيقات تحديد بيانات الأداء التي يريدون استردادها في البحث في الردّ على المكالمة، مثل:

• المقاييس التي سيتم عرضها (على سبيل المثال: النقرات ومرات الظهور)
• السمات التي يتم تقسيم البيانات من خلالها (مثل: OfferId وDate)
• الشروط التي يجب استيفاؤها (مثل: عدد النقرات > 100)

يمكن للغة طلب البحث في Reporting API إرسال طلب البحث إلى Content API for Shopping مقاييس الأداء (النقرات ومرات الظهور)، ومن الممكن أن يتم تقسيمها حسب السمات (سمات الأحداث التي تم الإبلاغ عنها، مثل البرنامج والتاريخ والمنتج مثل العلامة التجارية والفئة وغير ذلك)، باستخدام طريقة Search على خدمة Reports.

نتيجة الاستعلام إلى خدمة Reports هي قائمة من ReportRow الحالات، حيث يمثل كل ReportRow قيم المقاييس المطلوبة للشرائح التي حدّدتها في طلب بحثك. إذا لم يتم تحديد أي شرائح، فسيتم تحديد شريحة مع مقاييس مجمّعة على مستوى كل الشرائح. بخلاف ذلك، إن وجدت سيتم طلب الشرائح جنبًا إلى جنب مع المقاييس، فسيعرض الرد صفًا واحدًا كل صف شريحة فريدة. من الممكن تحديد عدة أجزاء مقاييس متعددة في استعلام واحد.

طلب بحث عن المقاييس

يمكنك إجراء طلب بحث عن المقاييس (النقرات ومرّات الظهور ونسبة النقر إلى الظهور وغيرها) التي تريدها. عاد. يجب إضافة فلتر على النطاق الزمني لطلب البحث في التقارير. خدمة ما. يعرض نموذج الاستعلام أدناه صفًا واحدًا: المبلغ الإجمالي من النقرات ضمن الشرط الإضافي ضمن النطاق الزمني.

SELECT metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-21';

نموذج إجابة

يوضّح نموذج الردّ على رمز JSON أدناه كيف حصل هذا التاجر على 4,440 نقرة. معًا في جميع منتجاتها عبر جميع وجهاتها بين 1 كانون الأول (ديسمبر) 2020 و21 كانون الأول (ديسمبر) 2020.

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

طلب بحث للشرائح

وإلى جانب المقاييس، يمكنك أيضًا طلب الشرائح، والتي يمكن أن تكون إحدى سمات منتج (offer_id، أو brand، أو category، إلخ.) أو سمة من سمات تمّ الإبلاغ عنها حدث (date، program). الحدث الذي يتم الإبلاغ عنه هو مرة ظهور أو نقرة لأحد المواقع المنتج.

تعمل الشرائح مثل GROUP BY في SQL. تقسم الشرائح بين الشرائح المحددة. يتم تجميعها حسب كل شريحة في عبارة SELECT. نموذج الاستعلام أدناه يعرض النقرات في اليوم، مرتَّبة حسب عدد النقرات تنازليًا حسب الشرط المُضاف في نطاق زمني معيّن. فقط الصفوف التي يكون فيها مقياس واحد مطلوب على الأقل قيمة غير صفرية وإرجاعه.

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY metrics.clicks DESC;

نموذج إجابة

يوضّح نموذج الردّ على رمز JSON أدناه كيف حصل هذا التاجر على 1,546 نقرة. لكل منتجاتها في جميع وجهاتها في 1 كانون الأول (ديسمبر) 2020 و829 نقرة على جميع منتجاتهم في جميع وجهاتهم على 2 كانون الأول (ديسمبر) 2020 لن يتم إرجاع أي عنصر في 3 كانون الأول (ديسمبر) 2020 بدءًا من لم يحصل التاجر على أي نقرات في ذلك اليوم

{
  "results": [
    {
      "segments": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 1
        }
      },
      "metrics": {
        "clicks": "1546"
      }
    },
    {
      "segments": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 2
        }
      },
      "metrics": {
        "clicks": "829"
      }
    }
]}