竞争洞察 报告可帮助您了解 您在商品类别层面面临的竞争局面，并根据购物广告 和自然搜索商品详情（也称为非付费商品详情）的展示次数，采取相应行动来提高您的曝光度。如需了解特定 商品和品牌的信息，请参阅畅销商品 报告。
您的账号必须符合最低资格要求，并且您必须确保 您或任何第三方在使用竞争洞察数据时，遵守 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 子句中的值，以针对
其他日期、流量类型、国家/地区和
类别自定义报告。
点击运行 ，即可在 API Explorer 中试用该示例。点击 运行后，请将请求网址中的商家 ID 占位符更新为您自己的商家 ID。您可以修改查询。完整查询必须保留在一行中，才能与 API Explorer 搭配使用。
以下是上述查询的示例响应：
{
"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
点击运行 ，即可在 API Explorer 中试用该示例。点击 运行后，请将请求网址中的商家 ID 占位符更新为您自己的商家 ID。您可以修改查询。完整查询必须保留在一行中，才能与 API Explorer 搭配使用。
以下是上述查询的示例响应：
{
"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
点击运行 ，即可在 API Explorer 中试用该示例。点击 运行后，请将请求网址中的商家 ID 占位符更新为您自己的商家 ID。您可以修改查询。完整查询必须保留在一行中，才能与 API Explorer 搭配使用。
以下是上述查询的示例响应：
{
"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
}
},
]
}