Dokumen ini membantu Anda bermigrasi dari laporan tolok ukur harga, yang akan dihentikan pada 1 September 2025,
ke laporan persaingan harga yang baru.
Laporan persaingan harga yang baru menawarkan hal berikut:
Paritas dengan versi laporan yang lebih lama dan konsistensi yang lebih baik dengan produk Google serupa lainnya—misalnya, kolom PriceCompetitivenessProductView untuk Content API for Shopping.
Selain itu, tabel PriceCompetitiveness_ berisi data tambahan tentang inventaris seperti judul, merek, tipe produk, dan kategori, serta harga produk dalam inventaris penjual. Dengan data ini, Anda dapat membandingkan dan menganalisis harga tolok ukur dengan harga Anda secara efektif.
Daya saing harga dan tolok ukur harga tidak mendukung pengisian ulang. API ini selalu menampilkan data saat ini yang tersedia saat Anda meminta transfer.
Contoh kueri
Bagian ini menandai perubahan dalam contoh kueri yang digunakan untuk mengambil
data daya saing harga.
Contoh 1: Mengambil tolok ukur harga produk per negara
Kueri berikut menampilkan daftar tolok ukur harga produk per negara.
Perhatikan bahwa produk dapat memiliki tolok ukur yang berbeda di berbagai negara.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-17 UTC."],[[["\u003cp\u003eThis document guides users through migrating from the deprecated price benchmarks report to the new price competitiveness report, which will be fully replaced by September 1, 2025.\u003c/p\u003e\n"],["\u003cp\u003eThe new price competitiveness report provides the same data as the older version, with improved consistency and additional insights on the merchant's pricing data.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ePriceCompetitiveness_\u003c/code\u003e table now contains more detailed data including the product's title, brand, types, category, offer id, and price, allowing for more effective comparison of benchmark prices with merchant's own data.\u003c/p\u003e\n"],["\u003cp\u003eThe key change in the report are the fields names and the table structure, making it necessary to adjust queries accordingly, as demonstrated in the provided examples for retrieving product price benchmarks and associated benchmarks.\u003c/p\u003e\n"],["\u003cp\u003eThe price competitiveness report, available as an "as is" Pre-GA product, doesn't support backfills, meaning it only provides the most current available data at the time of the transfer request.\u003c/p\u003e\n"]]],[],null,["# Migrate the price competitiveness report\n========================================\n\n|\n| **Preview**\n|\n|\n| This product is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA products are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n| **Note:** To get support or provide feedback for Google Merchant Center transfers with BigQuery Data Transfer Service, contact [gmc-transfer-preview@google.com](mailto:gmc-transfer-preview@google.com).\n\nThis document helps you migrate from the [price benchmarks](/bigquery/docs/merchant-center-price-benchmarks-schema) report, which will be deprecated on September 1, 2025,\nto the new [price competitiveness](/bigquery/docs/merchant-center-price-competitiveness-schema) report.\n\nThe new price competitiveness report offers the following:\n\n- Parity with the older version of the report and improved consistency with other similar Google products---for example, the [`PriceCompetitivenessProductView` field](https://developers.google.com/shopping-content/guides/reports/fields#pricecompetitivenessproductview) for the Content API for Shopping.\n- [Additional insights](#compare_price_benchmarks_and_price_competitiveness_table_schemas) about a merchant's pricing data.\n\nCompare price benchmarks and price competitiveness table schemas\n----------------------------------------------------------------\n\nThe following table helps you identify fields in the\n[`Products_PriceBenchmarks` table](/bigquery/docs/merchant-center-price-benchmarks-schema#schema)\nthat have equivalent replacements in the\n[`PriceCompetitiveness_` table](/bigquery/docs/merchant-center-price-competitiveness-schema#schema):\n\nMoreover, the `PriceCompetitiveness_` table contains additional data about\ninventory such as title, brand, product types and category, and the product\nprice in a merchant's inventory. This data lets you effectively compare and\nanalyze the benchmark prices with your own.\n\nThe following additional fields are available in the new\n[`PriceCompetitiveness_` table](/bigquery/docs/merchant-center-price-competitiveness-schema#schema):\n\nPrice competitiveness and price benchmarks don't support backfills. They always\nreturn the current data available when you request a transfer.\n\nExample queries\n---------------\n\nThis section highlights changes in example queries that are used to retrieve\nprice competitiveness data.\n\n### Example 1: Retrieve product price benchmarks per country\n\nThe following queries return a list of product price benchmarks per country.\nNote that a product can have different benchmarks in different countries.\n\n#### Use the `Products_PriceBenchmarks` table (old)\n\n SELECT\n DATE(price_benchmark_timestamp) AS date,\n product_id,\n merchant_id,\n aggregator_id,\n country_of_sale,\n price_benchmark_value,\n price_benchmark_currency\n FROM\n `\u003cvar translate=\"no\"\u003eDATASET\u003c/var\u003e.Products_PriceBenchmarks_\u003cvar translate=\"no\"\u003eMERCHANT_ID\u003c/var\u003e`\n WHERE\n _PARTITIONDATE \u003e= '\u003cvar translate=\"no\"\u003eDATE\u003c/var\u003e';\n\n#### Use the `PriceCompetitiveness` table (new)\n\n SELECT\n _PARTITIONDATE AS date,\n id,\n merchant_id,\n aggregator_id,\n report_country_code,\n benchmark_price.amount_micros,\n benchmark_price.currency_code\n FROM\n `\u003cvar translate=\"no\"\u003eDATASET\u003c/var\u003e.PriceCompetitiveness_\u003cvar translate=\"no\"\u003eMERCHANT_ID\u003c/var\u003e`\n WHERE\n _PARTITIONDATE \u003e= '\u003cvar translate=\"no\"\u003eDATE\u003c/var\u003e';\n\n### Example 2: Retrieve products and associated benchmarks\n\nThe following queries retrieve products and their associated benchmarks.\n\n#### Join the `Products` and `PriceBenchmarks` tables (old)\n\n WITH products AS (\n SELECT\n _PARTITIONDATE AS date,\n *\n FROM\n `\u003cvar translate=\"no\"\u003eDATASET\u003c/var\u003e.Products_\u003cvar translate=\"no\"\u003eMERCHANT_ID\u003c/var\u003e`\n WHERE\n _PARTITIONDATE \u003e= '\u003cvar translate=\"no\"\u003eDATE\u003c/var\u003e'\n ), benchmarks AS (\n SELECT\n _PARTITIONDATE AS date,\n *\n FROM\n `\u003cvar translate=\"no\"\u003eDATASET\u003c/var\u003e.Products_PriceBenchmarks_\u003cvar translate=\"no\"\u003eMERCHANT_ID\u003c/var\u003e`\n WHERE\n _PARTITIONDATE \u003e= '\u003cvar translate=\"no\"\u003eDATE\u003c/var\u003e'\n )\n SELECT\n products.date,\n products.product_id,\n products.merchant_id,\n products.aggregator_id,\n products.price,\n benchmarks.price_benchmark_value,\n benchmarks.price_benchmark_currency,\n benchmarks.country_of_sale\n FROM\n products\n INNER JOIN\n benchmarks\n ON products.product_id = benchmarks.product_id\n AND products.merchant_id = benchmarks.merchant_id\n AND products.date = benchmarks.date;\n\n#### Use the `PriceCompetitiveness` table (new)\n\n SELECT\n _PARTITIONDATE AS date,\n id AS product_id,\n merchant_id,\n aggregator_id,\n price.amount_micros,\n price.currency_code,\n benchmark_price.amount_micros,\n benchmark_price.currency_code,\n report_country_code AS country_of_sale\n FROM\n `\u003cvar translate=\"no\"\u003eDATASET\u003c/var\u003e.PriceCompetitiveness_\u003cvar translate=\"no\"\u003eMERCHANT_ID\u003c/var\u003e`\n WHERE\n _PARTITIONDATE \u003e= '\u003cvar translate=\"no\"\u003eDATE\u003c/var\u003e';\n\nIn these queries, replace the following:\n\n- \u003cvar translate=\"no\"\u003eDATASET\u003c/var\u003e: the name of your dataset\n- \u003cvar translate=\"no\"\u003eMERCHANT_ID\u003c/var\u003e: the merchant account ID\n- \u003cvar translate=\"no\"\u003eDATE\u003c/var\u003e: the date in the `YYYY-MM-DD` format\n\nWhat's next\n-----------\n\n- For more information about the new price competitiveness report, see [Google Google Merchant Center Price Competitiveness table](/bigquery/docs/merchant-center-price-competitiveness-schema)."]]