Migrar o relatório de competitividade de preço

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

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

  • Paridade com a versão mais antiga 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 esquemas de tabelas de comparativos de mercado e de competitividade de preço

A tabela a seguir ajuda a identificar campos na Products_PriceBenchmarks que têm substituições equivalentes na 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 categoria de produto, além do preço do produto no inventário de um comerciante. Com esses dados, é possível comparar e analisar de forma eficaz os preços de comparativo com os seus.

Os seguintes campos extras 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 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 nas consultas de exemplo usadas para recuperar dados de competitividade de preço.

Exemplo 1: recuperar 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 diferentes comparativos de mercado 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: recuperar produtos e comparativos de mercado associados

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

Fazer junção das tabelas Products e PriceBenchmarks (antigas)

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