Migre o relatório de competitividade de preços

Este documento ajuda a migrar do relatório de referências de preços, que vai ser descontinuado a 1 de setembro de 2025, para o novo relatório de competitividade de preços.

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

Compare esquemas de tabelas de competitividade de preços e referências de preços

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

Referências de preços (antigas) Competitividade de preços (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 dados adicionais sobre o inventário, como o título, a marca, os tipos de produtos e a categoria, bem como o preço do produto no inventário de um comerciante. Estes dados permitem-lhe comparar e analisar eficazmente os preços de referência 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 artigo, em micros (1 é representado como 1000000).
price.currency_code Moeda do preço do artigo.
product_type_l1 Atributo tipo de produto do produto.
product_type_l2 Atributo tipo de produto do produto.
product_type_l3 Atributo tipo de produto do produto.
product_type_l4 Atributo tipo de produto do produto.
product_type_l5 Atributo tipo de produto do produto.
category_l1 Categoria de produtos Google do produto.
category_l2 Categoria de produtos Google do produto.
category_l3 Categoria de produtos Google do produto.
category_l4 Categoria de produtos Google do produto.
category_l5 Categoria de produtos Google do produto.

A competitividade de preços e as referências de preços não suportam preenchimentos. Devolvem sempre os dados atuais disponíveis quando pede uma transferência.

Consultas de exemplo

Esta secção realça as alterações nas consultas de exemplo usadas para obter dados de competitividade de preços.

Exemplo 1: obtenha referências de preços de produtos por país

As seguintes consultas devolvem uma lista de referências de preços de produtos por país. Tenha em atenção que um produto pode ter referências diferentes em diferentes países.

Use 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';

Use 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: obtenha produtos e referências associadas

As seguintes consultas obtêm produtos e as respetivas referências associadas.

Junte as 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;

Use 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';

Nestas consultas, substitua o seguinte:

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

O que se segue?