Explore o cenário competitivo

Gostaríamos de apresentar a versão Beta da API Merchant. É a nova versão API Content for Shopping e o futuro.

Para mais informações sobre como a API Merchant pode melhorar sua integração e como você pode ajudar a moldar a futuro, consulte Anunciar a API Merchant API Beta.

A visibilidade da concorrência relatório ajuda a entender seu cenário competitivo no nível da categoria dos produtos e tome medidas para Melhorar sua visibilidade com base nas impressões mostradas dos seus anúncios do Shopping e listagens orgânicas (também conhecidas como listagens sem custo financeiro). Para informações sobre produtos e marcas, veja os mais vendidos .

Sua conta deve atender aos requisitos mínimos de qualificação, e você deve garantir que seu uso (ou o uso de terceiros) dos dados de visibilidade competitiva está em conformidade os termos do Merchant Center e e condições.

Ver quais tabelas e campos de relatório estão disponíveis com a API Content for Shopping.

Dados de visibilidade competitiva

Os dados de visibilidade competitiva são agrupados por país, produto do Google categoria e origem do tráfego.

É necessário especificar os valores de país e categoria em uma cláusula WHERE para todos consultas de visibilidade competitiva. É possível alterar os valores na cláusula WHERE para personalizar o relatório de datas, origens de tráfego, países e categorias.

Consultas com vários valores de país e categoria podem levar mais tempo para serem executadas. ou tempo limite.

Conferir empresas com visibilidade semelhante

É possível consultar CompetitiveVisibilityCompetitorView para ver empresas com um número semelhante de impressões ao seu.

Aqui está um exemplo. Para fazer o pedido, transmita a seguinte consulta do Merchant Center Declaração de idioma para o Método 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 

É possível alterar os valores na cláusula WHERE para personalizar o relatório para outras datas, tipos de tráfego, países e categorias.

Executar

Clique em Executar para testar o exemplo no APIs Explorer. Depois de clicar Executar, atualize o marcador de posição para o ID do comerciante na URL de solicitação. É possível modificar a consulta. A consulta completa deve permanecer em uma linha para trabalhar com o APIs Explorer.

Veja um exemplo de resposta da consulta anterior:

{
  "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
      }
    },
  ]
}

Conferir as empresas com maior visibilidade

É possível consultar CompetitiveVisibilityTopMerchantView para saber quais empresas estão obtendo mais impressões no Google de uma categoria específica e como sua empresa se compara.

Aqui está um exemplo. Para fazer a solicitação, transmita a seguinte consulta do Merchant Center de linguagem para O método 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

Executar

Clique em Executar para testar o exemplo no APIs Explorer. Depois de clicar Executar, atualize o marcador de posição para o ID do comerciante na URL de solicitação. É possível modificar a consulta. A consulta completa deve permanecer em uma linha para trabalhar com o APIs Explorer.

Veja um exemplo de resposta da consulta anterior:

{
  "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
      }
    }
  ]
}

Compare sua visibilidade com o comparativo de mercado da categoria

É possível consultar CompetitiveVisibilityBenchmarkView para ver as tendências de número de impressões ao longo do tempo em comparação com a média de outros vendedores.

Aqui está um exemplo. Para fazer o pedido, transmita a seguinte consulta do Merchant Center Instrução de idioma para o 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

Executar

Clique em Executar para testar o exemplo no APIs Explorer. Depois de clicar Executar, atualize o marcador de posição para o ID do comerciante na URL de solicitação. É possível modificar a consulta. A consulta completa deve permanecer em uma linha para trabalhar com o APIs Explorer.

Veja um exemplo de resposta da consulta anterior:

{
  "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
      }
    },
  ]
}