Migrar o relatório de competitividade de preço

Este documento ajuda você a migrar do relatório Benchmarks de preço, que será descontinuado em 1º de setembro de 2025, para o novo relatório Competitividade de preço.

O novo relatório de competitividade de preço oferece o seguinte:

  • Paridade com a versão anterior do relatório e consistência aprimorada com outros produtos semelhantes do Google, por exemplo, o campo PriceCompetitivenessProductView da API Content for Shopping.
  • Outros insights sobre os dados de preços de um comerciante.

Comparar benchmarks de preço e esquemas de tabela de competitividade de preço

A tabela a seguir ajuda a identificar campos na tabela Products_PriceBenchmarks que têm substituições equivalentes na tabela PriceCompetitiveness_:

Benchmarks de preço (antigo) Competitividade de preço (novo)
product_id id
merchant_id merchant_id
aggregator_id aggregator_id
country_of_sale report_country_code
price_benchmark_value benchmark_price.amount_micros
price_benchmark_currency benchmark_price.currency_code
price_benchmark_timestamp _PARTITIONDATE ou _PARTITIONTIME

Além disso, a tabela PriceCompetitiveness_ contém outros dados sobre o inventário, como título, marca, tipos e categorias de produtos, além do preço do produto no inventário de um comerciante. Com esses dados, você pode comparar e analisar de forma eficaz os preços de comparativo com os seus.

Os seguintes campos adicionais estão disponíveis na nova tabela PriceCompetitiveness_:

Campo Descrição
title Título do produto.
brand Marca do produto.
offer_id ID do produto fornecido pelo comerciante.
price Preço do produto.
price.amount_micros Preço do item em micros (1 é representado como 1000000).
price.currency_code Moeda do preço do item.
product_type_l1 Atributo de tipo do produto.
product_type_l2 Atributo de tipo do produto.
product_type_l3 Atributo de tipo do produto.
product_type_l4 Atributo de tipo do produto.
product_type_l5 Atributo de tipo do produto.
category_l1 Categoria Google do produto.
category_l2 Categoria Google do produto.
category_l3 Categoria Google do produto.
category_l4 Categoria Google do produto.
category_l5 Categoria Google do produto.

A competitividade de preço e os comparativos de preço não são compatíveis com preenchimentos. Eles sempre retornam os dados atuais disponíveis quando você solicita uma transferência.

Exemplo de consultas

Esta seção destaca as mudanças em exemplos de consultas usadas para extrair dados de competitividade de preços.

Exemplo 1: extrair comparativos de preços de produtos por país

As consultas a seguir retornam uma lista de comparativos de mercado de preços de produtos por país. Um produto pode ter comparativos diferentes em países diferentes.

Usar a tabela Products_PriceBenchmarks (antiga)

SELECT
  DATE(price_benchmark_timestamp) AS date,
  product_id,
  merchant_id,
  aggregator_id,
  country_of_sale,
  price_benchmark_value,
  price_benchmark_currency
FROM
  `DATASET.Products_PriceBenchmarks_MERCHANT_ID`
WHERE
  _PARTITIONDATE >= 'DATE';

Usar a tabela PriceCompetitiveness (nova)

SELECT
  _PARTITIONDATE AS date,
  id,
  merchant_id,
  aggregator_id,
  report_country_code,
  benchmark_price.amount_micros,
  benchmark_price.currency_code
FROM
  `DATASET.PriceCompetitiveness_MERCHANT_ID`
WHERE
  _PARTITIONDATE >= 'DATE';

Exemplo 2: extrair produtos e comparativos de mercado associados

As consultas a seguir recuperam os produtos e os comparativos de mercado associados.

Mesclar as tabelas Products e PriceBenchmarks (antiga)

WITH products AS (
  SELECT
    _PARTITIONDATE AS date,
    *
  FROM
    `DATASET.Products_MERCHANT_ID`
  WHERE
    _PARTITIONDATE >= 'DATE'
), benchmarks AS (
  SELECT
    _PARTITIONDATE AS date,
    *
  FROM
    `DATASET.Products_PriceBenchmarks_MERCHANT_ID`
  WHERE
    _PARTITIONDATE >= 'DATE'
)
SELECT
  products.date,
  products.product_id,
  products.merchant_id,
  products.aggregator_id,
  products.price,
  benchmarks.price_benchmark_value,
  benchmarks.price_benchmark_currency,
  benchmarks.country_of_sale
FROM
  products
INNER JOIN
  benchmarks
ON products.product_id = benchmarks.product_id
  AND products.merchant_id = benchmarks.merchant_id
  AND products.date = benchmarks.date;

Usar a tabela PriceCompetitiveness (nova)

SELECT
  _PARTITIONDATE AS date,
  id AS product_id,
  merchant_id,
  aggregator_id,
  price.amount_micros,
  price.currency_code,
  benchmark_price.amount_micros,
  benchmark_price.currency_code,
  report_country_code AS country_of_sale
FROM
  `DATASET.PriceCompetitiveness_MERCHANT_ID`
WHERE
  _PARTITIONDATE >= 'DATE';

Nessas consultas, substitua o seguinte:

  • DATASET: o nome do conjunto de dados
  • MERCHANT_ID: o ID da conta do comerciante
  • DATE: a data no formato YYYY-MM-DD

A seguir