استكشاف المشهد التنافسي

إليك Merchant API (الإصدار التجريبي)، البديل الرسمي لواجهة برمجة التطبيقات Content API for Shopping.

الاطّلاع على أحدث الميزات الجديدة وإصلاحات الأخطاء وتعديلات الإصدار من Merchant API (الإصدار التجريبي)

تعرَّف على كيفية إدارة نشاطك التجاري ومنتجاتك على Google وكيفية الحصول على إذن بالوصول الآلي إلى البيانات والإحصاءات والإمكانات الفريدة على نطاق واسع. ابدأ الآن

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

يجب أن يستوفي حسابك الحدّ الأدنى من متطلبات الأهلية، ويجب التأكّد من أنّ استخدامك لبيانات "مستوى الظهور التنافسي" أو استخدام أي جهة خارجية لها يتوافق مع أحكام وشروط Merchant Center.

اطّلِع على الجداول والحقول المتوفّرة لإعداد التقارير باستخدام Content API for Shopping.

بيانات مستوى الظهور التنافسي

يتم تجميع بيانات مستوى الظهور التنافسي حسب البلد وفئة المنتجات من Google ومصدر الزيارات.

يجب تحديد قيم البلد والفئة في عبارة WHERE لكل طلبات بحث عن مستوى الظهور التنافسي. يمكنك تغيير القيم في عبارة WHERE لتخصيص التقرير حسب التواريخ ومصادر الزيارات والبُلدان والفئات.

قد يستغرق تنفيذ طلبات البحث التي تحتوي على قيم متعددة للبلد والفئة وقتًا أطول، أو قد تنتهي مهلة التنفيذ.

عرض الأنشطة التجارية التي حققت مستوى ظهور مشابهًا

يمكنك إجراء طلب بحث CompetitiveVisibilityCompetitorView لعرض الأنشطة التجارية التي تسجّل عدد مرّات ظهور مشابهًا لنشاطك التجاري.

في ما يلي مثال. لتقديم الطلب، عليك تمرير بيان لغة طلبات Merchant Center التالية إلى أسلوب reports.search:

SELECT competitive_visibility.domain,
       competitive_visibility.category_id,
       competitive_visibility.country_code,
       competitive_visibility.traffic_source,
       competitive_visibility.is_your_domain,
       competitive_visibility.rank,
       competitive_visibility.ads_organic_ratio,
       competitive_visibility.page_overlap_rate,
       competitive_visibility.higher_position_rate,
       competitive_visibility.relative_visibility
FROM CompetitiveVisibilityCompetitorView
WHERE competitive_visibility.date BETWEEN '2023-06-02' AND '2023-06-27'
  AND competitive_visibility.category_id = 536
  AND competitive_visibility.country_code = 'US'
  AND competitive_visibility.traffic_source = 'ADS'
ORDER BY competitive_visibility.rank 

يمكنك تغيير القيم في عبارة WHERE لتخصيص التقرير لأجل التواريخ الأخرى وأنواع الزيارات والبلدان و الفئات.

التشغيل

انقر على تشغيل لتجربة العيّنة في مستكشف واجهة برمجة التطبيقات. بعد النقر على تشغيل، عدِّل العنصر النائب "معرّف التاجر" إلى معرّف التاجر الخاص بك في عنوان URL للطلب. يمكنك تعديل الطلب. يجب أن يظلّ الطلب الكامل على سطر واحد لكي تتمكّن من العمل مع مستكشف واجهة برمجة التطبيقات.

في ما يلي نموذج للردّ من طلب البحث السابق:

{
  "results": [
    {
      "competitiveVisibility": {
        "domain": "examplepetstore.com",
        "isYourDomain": false,
        "countryCode": "US",
        "categoryId": "536",
        "trafficSource": "ADS",
        "rank": "4",
        "adsOrganicRatio": 8,
        "pageOverlapRate": 0.19,
        "higherPositionRate": 0.46,
        "relativeVisibility": 0.5
      }
    },
    {
      "competitiveVisibility": {
        "domain": "example.com",
        "isYourDomain": true,
        "countryCode": "US",
        "categoryId": "536",
        "trafficSource": "ADS",
        "rank": "5",
        "adsOrganicRatio": 30,
        "pageOverlapRate": 1,
        "higherPositionRate": 0,
        "relativeVisibility": 0
      }
    },
  ]
}

عرض الأنشطة التجارية التي تحقّق أعلى مستوى ظهور

يمكنك إجراء طلب بحث على CompetitiveVisibilityTopMerchantView لمعرفة الأنشطة التجارية التي تحقّق أكبر عدد من مرات الظهور على Google في فئة معيّنة، ومستوى أداء نشاطك التجاري مقارنةً بها.

في ما يلي مثال. لتقديم الطلب، عليك تمرير بيان Merchant Center Query Language التالي إلى reports.search:

SELECT
  competitive_visibility.domain,
  competitive_visibility.category_id,
  competitive_visibility.country_code,
  competitive_visibility.traffic_source,
  competitive_visibility.is_your_domain,
  competitive_visibility.rank,
  competitive_visibility.ads_organic_ratio,
  competitive_visibility.page_overlap_rate,
  competitive_visibility.higher_position_rate
FROM CompetitiveVisibilityTopMerchantView
WHERE competitive_visibility.date BETWEEN '2022-08-01' AND '2022-09-01'
  AND competitive_visibility.category_id = 100
  AND competitive_visibility.country_code = 'US'
  AND competitive_visibility.traffic_source = 'ORGANIC'
ORDER BY competitive_visibility.rank

التشغيل

انقر على تشغيل لتجربة العيّنة في مستكشف واجهة برمجة التطبيقات. بعد النقر على تشغيل، عدِّل العنصر النائب "معرّف التاجر" إلى معرّف التاجر الخاص بك في عنوان URL للطلب. يمكنك تعديل الطلب. يجب أن يظلّ الطلب الكامل على سطر واحد لكي تتمكّن من العمل مع مستكشف واجهة برمجة التطبيقات.

في ما يلي نموذج للردّ من طلب البحث السابق:

{
  "results": [
    {
      "competitiveVisibility": {
        "domain": "examplepetstore.com",
        "isYourDomain": false,
        "countryCode": "US",
        "categoryId": "100",
        "trafficSource": "ORGANIC",
        "rank": "1",
        "adsOrganicRatio": 0.2,
        "pageOverlapRate": 0.3,
        "higherPositionRate": 0.45
      }
    },
    {
      "competitiveVisibility": {
        "domain": "example.com",
        "isYourDomain": false,
        "countryCode": "US",
        "categoryId": "100",
        "trafficSource": "ORGANIC",
        "rank": "2",
        "adsOrganicRatio": 5,
        "pageOverlapRate": 0.67,
        "higherPositionRate": 0.89
      }
    }
  ]
}

مقارنة مستوى ظهور منتجاتك بمقياس أداء الفئة

يمكنك إجراء طلب بحث CompetitiveVisibilityBenchmarkView لمعرفة مؤشرات عدد مرات الظهور بمرور الوقت مقارنةً بمتوسّط مؤشرات البائعين الآخرين.

في ما يلي مثال. لتقديم الطلب، عليك تمرير بيان لغة طلبات Merchant Center التالية إلى reports.search الطريقة:

SELECT
  competitive_visibility.category_id,
  competitive_visibility.country_code,
  competitive_visibility.traffic_source,
  competitive_visibility.date,
  competitive_visibility.your_domain_visibility_trend,
  competitive_visibility.category_benchmark_visibility_trend
FROM CompetitiveVisibilityBenchmarkView
WHERE competitive_visibility.date BETWEEN '2022-09-01' AND '2022-09-07'
  AND competitive_visibility.category_id = 100
  AND competitive_visibility.country_code = 'US'
  AND competitive_visibility.traffic_source = 'ORGANIC'
ORDER BY competitive_visibility.date

التشغيل

انقر على تشغيل لتجربة العيّنة في مستكشف واجهة برمجة التطبيقات. بعد النقر على تشغيل، عدِّل العنصر النائب "معرّف التاجر" إلى معرّف التاجر الخاص بك في عنوان URL للطلب. يمكنك تعديل الطلب. يجب أن يظلّ الطلب الكامل على سطر واحد لكي تتمكّن من العمل مع مستكشف واجهة برمجة التطبيقات.

في ما يلي نموذج للردّ من طلب البحث السابق:

{
  "results": [
    {
      "competitiveVisibility": {
        "date": {
          "year": 2022,
          "month": 9,
          "day": 1
        },
        "countryCode": "US",
        "categoryId": "100",
        "trafficSource": "ORGANIC",
        "yourDomainVisibilityTrend": 0,
        "categoryBenchmarkVisibilityTrend": 0
      }
    },
    {
      "competitiveVisibility": {
        "date": {
          "year": 2022,
          "month": 9,
          "day": 2
        },
        "countryCode": "US",
        "categoryId": "100",
        "trafficSource": "ORGANIC",
        "yourDomainVisibilityTrend": 0.3,
        "categoryBenchmarkVisibilityTrend": -0.15
      }
    },
  ]
}