استكشاف المشهد التنافسي
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يساعدك تقرير التنافسية حسب الظهور في قراءة
المشهد التنافسي على مستوى فئة المنتج واتخاذ إجراء ل
تحسين مستوى ظهور منتجاتك استنادًا إلى مرات الظهور المعروضة من إعلانات Shopping
والبيانات المجانية. للحصول على معلومات عن منتجات وعلامات تجارية معيّنة، اطّلِع على تقارير المنتجات الأكثر مبيعًا.
يجب أن يستوفي حسابك الحدّ الأدنى من متطلبات الأهلية، ويجب التأكّد من أنّ استخدامك لبيانات "مستوى الظهور التنافسي" أو استخدام أي جهة خارجية لها يتوافق مع أحكام وشروط Merchant Center.
اطّلِع على الجداول والحقول المتاحة لإعداد التقارير باستخدام Merchant API.
بيانات مستوى الظهور التنافسي
يتم تجميع بيانات مستوى الظهور التنافسي حسب البلد وفئة المنتجات من Google ومصدر الزيارات.
يجب تحديد قيم البلد والفئة في عبارة WHERE
لكل طلبات بحث عن الظهور التنافسي. يمكنك تغيير القيم في عبارة WHERE
لتخصيص التقرير حسب التواريخ ومصادر الزيارات والبُلدان والفئات.
قد يستغرق تنفيذ طلبات البحث التي تحتوي على قيم متعددة للبلدان والفئات وقتًا أطول،
أو قد تنتهي مهلة التنفيذ.
عرض الأنشطة التجارية التي حققت مستوى ظهور مشابهًا
يمكنك إجراء طلب بحث على competitive_visibility_competitor_view
لعرض الأنشطة التجارية التي تسجّل عددًا مماثلاً لمرات الظهور التي يسجّلها نشاطك التجاري.
في ما يلي مثال. لتقديم الطلب، عليك تمرير بيان لغة طلبات Merchant Center التالية إلى accounts.reports.search
الطريقة:
SELECT
report_country_code,
report_category_id,
traffic_source,
domain,
is_your_domain,
rank,
ads_organic_ratio,
page_overlap_rate,
higher_position_rate,
relative_visibility
FROM competitive_visibility_competitor_view
WHERE date BETWEEN '2023-06-02' AND '2023-06-27'
AND report_country_code = 'US'
AND report_category_id = 536
AND traffic_source = 'ADS'
ORDER BY rank
يمكنك تغيير القيم في العبارة WHERE
لتخصيص التقرير لأجل
تواريخ ومصادر زيارات وبلدان
فئات أخرى.
في ما يلي نموذج للردّ من طلب البحث السابق:
{
"results": [
{
"competitiveVisibilityCompetitorView": {
"reportCountryCode": "US",
"reportCategoryId": "536",
"trafficSource": "ADS",
"domain": "examplepetstore.com",
"isYourDomain": false,
"rank": "4",
"adsOrganicRatio": 8,
"pageOverlapRate": 0.19,
"higherPositionRate": 0.46,
"relativeVisibility": 0.5
}
},
{
"competitiveVisibilityCompetitorView": {
"reportCountryCode": "US",
"reportCategoryId": "536",
"trafficSource": "ADS",
"domain": "example.com",
"isYourDomain": true,
"rank": "5",
"adsOrganicRatio": 30,
"pageOverlapRate": 1,
"higherPositionRate": 0,
"relativeVisibility": 0
}
},
]
}
لمزيد من المعلومات عن الحقول المتاحة للطلب، يُرجى الاطّلاع على الحقول في جدول competitiveVisibilityCompetitorView
.
عرض الأنشطة التجارية التي تحقّق أعلى مستوى ظهور
يمكنك إجراء طلب بحث على competitive_visibility_top_merchant_view
لمعرفة الأنشطة التجارية التي تحقّق أكبر عدد من مرات الظهور على Google في فئة معيّنة، ومستوى أداء نشاطك التجاري مقارنةً بها.
في ما يلي مثال. لتقديم الطلب، عليك تمرير عبارة Merchant Center Query
Language التالية إلى accounts.reports.search
method:
SELECT
report_country_code,
report_category_id,
traffic_source,
domain,
is_your_domain,
rank,
ads_organic_ratio,
page_overlap_rate,
higher_position_rate
FROM competitive_visibility_top_merchant_view
WHERE date BETWEEN '2022-08-01' AND '2022-09-01'
AND report_country_code = 'US'
AND report_category_id = 100
AND traffic_source = 'ORGANIC'
ORDER BY rank
في ما يلي نموذج للردّ من طلب البحث السابق:
{
"results": [
{
"competitiveVisibilityTopMerchantView": {
"reportCountryCode": "US",
"reportCategoryId": "100",
"trafficSource": "ORGANIC",
"domain": "examplepetstore.com",
"isYourDomain": false,
"rank": "1",
"adsOrganicRatio": 0.2,
"pageOverlapRate": 0.3,
"higherPositionRate": 0.45
}
},
{
"competitiveVisibilityTopMerchantView": {
"reportCountryCode": "US",
"reportCategoryId": "100",
"trafficSource": "ORGANIC",
"domain": "example.com",
"isYourDomain": false,
"rank": "2",
"adsOrganicRatio": 5,
"pageOverlapRate": 0.67,
"higherPositionRate": 0.89
}
},
]
}
لمزيد من المعلومات عن الحقول المتاحة للطلب، يُرجى الاطّلاع على الحقول في جدول competitiveVisibilityTopMerchantView
.
مقارنة مستوى ظهور منتجاتك بمقياس أداء الفئة
يمكنك إجراء طلب بحث على competitive_visibility_benchmark_view
لمعرفة مؤشرات عدد
مرّات الظهور بمرور الوقت مقارنةً بمتوسّط مؤشرات البائعين الآخرين.
في ما يلي مثال. لتقديم الطلب، عليك تمرير بيان لغة طلبات Merchant Center التالية إلى accounts.reports.search
الطريقة:
SELECT
report_country_code,
report_category_id,
traffic_source,
date,
your_domain_visibility_trend,
category_benchmark_visibility_trend
FROM competitive_visibility_benchmark_view
WHERE date BETWEEN '2022-09-01' AND '2022-09-07'
AND report_country_code = 'US'
AND report_category_id = 100
AND traffic_source = 'ORGANIC'
ORDER BY date
في ما يلي نموذج للردّ من طلب البحث السابق:
{
"results": [
{
"competitiveVisibilityBenchmarkView": {
"date": {
"year": 2022,
"month": 9,
"day": 1
},
"reportCountryCode": "US",
"reportCategoryId": "100",
"trafficSource": "ORGANIC",
"yourDomainVisibilityTrend": 0,
"categoryBenchmarkVisibilityTrend": 0
}
},
{
"competitiveVisibilityBenchmarkView": {
"date": {
"year": 2022,
"month": 9,
"day": 2
},
"reportCountryCode": "US",
"reportCategoryId": "100",
"trafficSource": "ORGANIC",
"yourDomainVisibilityTrend": 0.3,
"categoryBenchmarkVisibilityTrend": -0.15
}
},
]
}
لمزيد من المعلومات عن الحقول المتاحة للطلب، يُرجى الاطّلاع على الحقول في جدول competitiveVisibilityBenchmarkView
.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-08 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-08 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Competitive Visibility report helps you understand your product category's competitive landscape on Google Shopping and organic listings, allowing you to improve your visibility based on impression data.\u003c/p\u003e\n"],["\u003cp\u003eYou can identify businesses with similar and highest visibility, compare your visibility to the category benchmark, and customize reports by date, traffic source, country, and category using the Merchant Center Query Language.\u003c/p\u003e\n"],["\u003cp\u003eTo access Competitive Visibility data, your account must meet eligibility requirements and comply with Merchant Center terms and conditions.\u003c/p\u003e\n"],["\u003cp\u003eData is grouped by country, Google product category, and traffic source, requiring specification of country and category values in queries.\u003c/p\u003e\n"],["\u003cp\u003eThree distinct views—\u003ccode\u003ecompetitive_visibility_competitor_view\u003c/code\u003e, \u003ccode\u003ecompetitive_visibility_top_merchant_view\u003c/code\u003e, and \u003ccode\u003ecompetitive_visibility_benchmark_view\u003c/code\u003e—offer insights into different aspects of competitive visibility, each with its own set of queryable fields.\u003c/p\u003e\n"]]],["The competitive visibility report analyzes product category performance, focusing on Shopping ads and organic listings. Users query data using `competitive_visibility_competitor_view`, `competitive_visibility_top_merchant_view`, or `competitive_visibility_benchmark_view`. These queries, specifying country, category, and traffic source, reveal businesses with similar visibility, top-performing businesses, and visibility trends relative to category benchmarks. Customizable reports adjust for dates, traffic, and categories, enabling insight into the competitive landscape.\n"],null,["# Explore your competitive landscape\n\nThe [competitive visibility\nreport](//support.google.com/merchants/answer/11366442) helps you understand\nyour competitive landscape on a product category level, and take action to\nimprove your visibility based on displayed impressions from your Shopping ads\nand organic listings. For information on specific products and brands, see the\n[best sellers\nreports](/merchant/api/guides/reports/understand-the-market#identify_best-sellers).\n\nYour account must meet minimum eligibility requirements, and you must ensure\nthat your use, or any third party's use, of Competitive visibility data complies\nwith the [Merchant Center terms and\nconditions](//support.google.com/merchants/answer/12628444).\n\nSee which reporting [tables and\nfields](/merchant/api/reference/rest/reports_v1/accounts.reports/search) are\navailable with the Merchant API.\n\nCompetitive visibility data\n---------------------------\n\nCompetitive visibility data is grouped by country, [Google product\ncategory](//support.google.com/merchants/answer/6324436) and traffic source.\n\nYou must specify country and category values in a `WHERE` clause for all\ncompetitive visibility queries. You can change the values in the `WHERE` clause\nto customize the report for dates, traffic sources, countries, and categories.\n\nQueries with multiple country and category values might take longer to execute,\nor time out.\n\nView businesses with similar visibility\n---------------------------------------\n\nYou can query `competitive_visibility_competitor_view` to view businesses with a\nsimilar number of impressions to your business.\n\nHere's a sample. To make the request, pass the following Merchant Center Query\nLanguage statement to the\n[`accounts.reports.search`](/merchant/api/reference/rest/reports_v1/accounts.reports/search)\nmethod: \n\n SELECT\n report_country_code,\n report_category_id,\n traffic_source,\n domain,\n is_your_domain,\n rank,\n ads_organic_ratio,\n page_overlap_rate,\n higher_position_rate,\n relative_visibility\n FROM competitive_visibility_competitor_view\n WHERE date BETWEEN '2023-06-02' AND '2023-06-27'\n AND report_country_code = 'US'\n AND report_category_id = 536\n AND traffic_source = 'ADS'\n ORDER BY rank\n\nYou can change the values in the `WHERE` clause to customize the report for\nother dates, traffic sources, countries, and\n[categories](//support.google.com/merchants/answer/6324436).\n\nHere's a sample response from the preceding query: \n\n {\n \"results\": [\n {\n \"competitiveVisibilityCompetitorView\": {\n \"reportCountryCode\": \"US\",\n \"reportCategoryId\": \"536\",\n \"trafficSource\": \"ADS\",\n \"domain\": \"examplepetstore.com\",\n \"isYourDomain\": false,\n \"rank\": \"4\",\n \"adsOrganicRatio\": 8,\n \"pageOverlapRate\": 0.19,\n \"higherPositionRate\": 0.46,\n \"relativeVisibility\": 0.5\n }\n },\n {\n \"competitiveVisibilityCompetitorView\": {\n \"reportCountryCode\": \"US\",\n \"reportCategoryId\": \"536\",\n \"trafficSource\": \"ADS\",\n \"domain\": \"example.com\",\n \"isYourDomain\": true,\n \"rank\": \"5\",\n \"adsOrganicRatio\": 30,\n \"pageOverlapRate\": 1,\n \"higherPositionRate\": 0,\n \"relativeVisibility\": 0\n }\n },\n ]\n }\n\nFor more information about the fields available for query, see the [Fields in `competitiveVisibilityCompetitorView` table](/merchant/api/reference/rest/reports_v1/accounts.reports#CompetitiveVisibilityCompetitorView.FIELDS).\n\nView businesses with highest visibility\n---------------------------------------\n\nYou can query `competitive_visibility_top_merchant_view` to see which businesses\nare getting the most impressions across Google in a specific category, and how\nyour business compares.\n\nHere's a sample. To make the request, pass the following [Merchant Center Query\nLanguage](/merchant/api/guides/reports/query-language) statement to the\n[`accounts.reports.search`](/merchant/api/reference/rest/reports_v1/accounts.reports/search)\nmethod: \n\n SELECT\n report_country_code,\n report_category_id,\n traffic_source,\n domain,\n is_your_domain,\n rank,\n ads_organic_ratio,\n page_overlap_rate,\n higher_position_rate\n FROM competitive_visibility_top_merchant_view\n WHERE date BETWEEN '2022-08-01' AND '2022-09-01'\n AND report_country_code = 'US'\n AND report_category_id = 100\n AND traffic_source = 'ORGANIC'\n ORDER BY rank\n\nHere's a sample response from the preceding query: \n\n {\n \"results\": [\n {\n \"competitiveVisibilityTopMerchantView\": {\n \"reportCountryCode\": \"US\",\n \"reportCategoryId\": \"100\",\n \"trafficSource\": \"ORGANIC\",\n \"domain\": \"examplepetstore.com\",\n \"isYourDomain\": false,\n \"rank\": \"1\",\n \"adsOrganicRatio\": 0.2,\n \"pageOverlapRate\": 0.3,\n \"higherPositionRate\": 0.45\n }\n },\n {\n \"competitiveVisibilityTopMerchantView\": {\n \"reportCountryCode\": \"US\",\n \"reportCategoryId\": \"100\",\n \"trafficSource\": \"ORGANIC\",\n \"domain\": \"example.com\",\n \"isYourDomain\": false,\n \"rank\": \"2\",\n \"adsOrganicRatio\": 5,\n \"pageOverlapRate\": 0.67,\n \"higherPositionRate\": 0.89\n }\n },\n ]\n }\n\nFor more information about the fields available for query, see the [Fields in `competitiveVisibilityTopMerchantView` table](/merchant/api/reference/rest/reports_v1/accounts.reports#CompetitiveVisibilityTopMerchantView.FIELDS).\n\nCompare your visibility to the category benchmark\n-------------------------------------------------\n\nYou can query `competitive_visibility_benchmark_view` to see how your number of\nimpressions trends over time compared to the average trend of other sellers.\n\nHere's a sample. To make the request, pass the following Merchant Center Query\nLanguage statement to the\n[`accounts.reports.search`](/merchant/api/reference/rest/reports_v1/accounts.reports/search)\nmethod: \n\n SELECT\n report_country_code,\n report_category_id,\n traffic_source,\n date,\n your_domain_visibility_trend,\n category_benchmark_visibility_trend\n FROM competitive_visibility_benchmark_view\n WHERE date BETWEEN '2022-09-01' AND '2022-09-07'\n AND report_country_code = 'US'\n AND report_category_id = 100\n AND traffic_source = 'ORGANIC'\n ORDER BY date\n\nHere's a sample response from the preceding query: \n\n {\n \"results\": [\n {\n \"competitiveVisibilityBenchmarkView\": {\n \"date\": {\n \"year\": 2022,\n \"month\": 9,\n \"day\": 1\n },\n \"reportCountryCode\": \"US\",\n \"reportCategoryId\": \"100\",\n \"trafficSource\": \"ORGANIC\",\n \"yourDomainVisibilityTrend\": 0,\n \"categoryBenchmarkVisibilityTrend\": 0\n }\n },\n {\n \"competitiveVisibilityBenchmarkView\": {\n \"date\": {\n \"year\": 2022,\n \"month\": 9,\n \"day\": 2\n },\n \"reportCountryCode\": \"US\",\n \"reportCategoryId\": \"100\",\n \"trafficSource\": \"ORGANIC\",\n \"yourDomainVisibilityTrend\": 0.3,\n \"categoryBenchmarkVisibilityTrend\": -0.15\n }\n },\n ]\n }\n\nFor more information about the fields available for query, see the [Fields in `competitiveVisibilityBenchmarkView` table](/merchant/api/reference/rest/reports_v1/accounts.reports#CompetitiveVisibilityBenchmarkView.FIELDS)."]]