掌握競爭局勢

我們想推出 Beta 版 Merchant API。這是新版本的 Content API for Shopping 與未來發展

如需瞭解 Merchant API 如何改善整合結果，以及如何協助強化整合項目， 未來詳情請參閱 Merchant API Beta 版。

競爭曝光率 報表 也就是產品類別層級的競爭情況，並採取行動 根據購物廣告的展示曝光次數提高曝光率 和自然產品資訊 (又稱為免費產品資訊)如需深入瞭解 產品和品牌，請查看暢銷商品 報表。

你的帳戶必須符合基本資格規定，而且必須 您或任何第三方的「競爭曝光率」資料使用方式 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 子句中的值來自訂報表 其他日期、流量類型、國家/地區 類別。

執行

請按一下「Run」(執行)，試用 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 查詢 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

執行

請按一下「Run」(執行)，試用 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

執行

請按一下「Run」(執行)，試用 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
      }
    },
  ]
}