Skema tabel produk Google Merchant Center

Saat data pelaporan Google Merchant Center Anda ditransfer ke BigQuery, format data masalah produk dan produk terutama berkaitan dengan format kolom yang relevan dari resource products dan productstatuses Content API.

Data ditulis ke tabel bernama Products_MERCHANT_ID jika Anda menggunakan ID penjual perorangan, atau Products_AGGREGATOR_ID jika Anda menggunakan akun MCA.

Skema

Tabel Products_ memiliki skema berikut:

Kolom Jenis data BigQuery Deskripsi Contoh data
product_data_timestamp TIMESTAMP Stempel waktu data produk. 2023-09-14 11:49:50 UTC
product_id STRING ID REST Content API produk dalam bentuk: channel:content_language:feed_label:offer_id. Kunci ini adalah kunci utama. online:en:AU:666840730
merchant_id INTEGER ID akun penjual. 1234
aggregator_id INTEGER ID akun agregator untuk akun multiklien. 12345
offer_id STRING ID produk yang diberikan penjual. tddy123uk
title STRING Judul item. TN2351 USB hitam
description STRING Deskripsi item. USB hitam TN2351 telah mendefinisikan ulang cara XJS dapat memengaruhi pengalaman LLCD.
link STRING URL halaman landing produk yang disediakan penjual. https://www.example.com/tn2351-black-usb/6538811?skuId=1234
mobile_link STRING URL versi halaman landing yang dioptimalkan untuk seluler yang disediakan penjual. https://www.example.com/tn2351-black-usb/6538811?skuId=1234
image_link STRING URL gambar produk utama yang disediakan penjual. https://www.example.com/tn2351-black-usb/6538811?skuId=1234
additional_image_links STRING, REPEATED URL tambahan gambar item yang disediakan penjual.
content_language STRING Kode bahasa ISO 639-1 dua huruf untuk item. en
target_country STRING Tidak digunakan lagi (selalu ditetapkan ke NULL) sebagai bagian dari perubahan yang ditujukan agar produk dapat menargetkan beberapa negara. Sebagai gantinya, gunakan kolom berikut untuk membaca status setiap negara target: destinations.approved_countries, destinations.pending_countries, destinations.disapproved_countries. Masalah kini dapat berlaku untuk negara target tertentu dan tidak untuk negara lainnya, seperti yang ditunjukkan di kolom issues.applicable_countries. null
feed_label STRING Label feed yang disediakan penjual untuk item, atau - jika tidak disediakan. AS
channel STRING Saluran item, baik online atau local. lokal, online
expiration_date TIMESTAMP Tanggal dan waktu yang diberikan penjual saat item akan habis masa berlakunya, seperti yang ditentukan saat penyisipan. Setel ke null jika tidak diberikan. 2023-10-14 00:00:00 UTC
google_expiration_date TIMESTAMP Tanggal dan waktu habis masa berlaku item di Google Shopping. Jangan pernah ditetapkan ke null. 2023-10-14 00:00:00 UTC
adult BOOLEAN Tetapkan ke true jika item ditargetkan untuk orang dewasa. benar, salah
age_group STRING Kelompok usia target item yang disediakan penjual. NULL jika tidak disediakan. bayi baru lahir, bayi, balita, anak-anak, dewasa
availability STRING Status ketersediaan item yang disediakan penjual. in stock, out of stock
availability_date TIMESTAMP Tanggal dan waktu yang diberikan penjual saat produk praorder tersedia untuk pengiriman. NULL jika tidak disediakan. 2023-10-14 00:00:00 UTC
brand STRING Merek item yang disediakan penjual. NULL jika tidak disediakan. Nama Merek
google_brand_id STRING ID brand Google untuk item. 12759524623914508053
color STRING Warna item yang disediakan penjual. NULL jika tidak disediakan. Silver, Gray, Multi
condition STRING Kondisi atau keadaan item yang disediakan penjual. baru, bekas, refurbished
custom_labels RECORD Label khusus yang disediakan penjual untuk pengelompokan item kustom di Iklan Shopping. NULL jika tidak disediakan.
custom_labels.label_0 STRING Label kustom 0. label kustom saya
custom_labels.label_1 STRING Label kustom 1. label kustom saya
custom_labels.label_2 STRING Label kustom 2. label kustom saya
custom_labels.label_3 STRING Label kustom 3. label kustom saya
custom_labels.label_4 STRING Label kustom 4. label kustom saya
gender STRING Gender target item yang disediakan penjual. NULL jika tidak disediakan. uniseks, laki-laki, perempuan
gtin STRING Nomor Barang Perdagangan Global (GTIN) item yang diberikan penjual. NULL jika tidak disediakan. 3234567890126
item_group_id STRING ID bersama yang disediakan penjual untuk semua varian dari produk yang sama. NULL jika tidak disediakan. AB12345
material STRING Bahan yang digunakan untuk membuat item, yang disediakan penjual. NULL jika tidak disediakan. Kulit
mpn STRING Nomor Suku Cadang Produsen (MPN) item yang disediakan penjual. Tetapkan ke NULL jika tidak diberikan. GO12345OOGLE
pattern STRING Pola yang disediakan penjual. NULL jika tidak disediakan. Bergaris
price RECORD price item yang disediakan penjual.
price.value NUMERIC Harga item. 19,99
price.currency STRING Mata uang harga. USD
sale_price RECORD Harga promo item yang disediakan penjual.
sale_price.value NUMERIC Harga promo item. NULL jika tidak disediakan. 19,99
sale_price.currency STRING Mata uang harga promo. NULL jika tidak disediakan. USD
sale_price_effective_start_date TIMESTAMP Tanggal dan waktu mulai saat item dijual. 2023-10-14 00:00:00 UTC
sale_price_effective_end_date TIMESTAMP Tanggal dan waktu berakhir saat item dijual. 2023-10-14 00:00:00 UTC
google_product_category INTEGER ID kategori produk Google item. NULL jika tidak disediakan. 2271
google_product_category_ids INTEGER, REPEATED Jalur lengkap kategori produk Google ke item, yang disimpan sebagai kumpulan ID. NULL jika tidak disediakan.
google_product_category_path STRING Versi jalur lengkap yang dapat dibaca manusia. Kosong jika tidak diberikan. Pakaian & Aksesori > Pakaian > Gaun
product_type STRING Kategori item yang disediakan penjual. Beranda > Perempuan > Gaun > Gaun Maxi
additional_product_types STRING, REPEATED Kategori tambahan item.
promotion_ids STRING, REPEATED Daftar ID promosi yang terkait dengan produk.
destinations RECORD, REPEATED Tujuan yang dimaksudkan untuk produk.
destinations.name STRING Nama tujuan; hanya Shopping yang didukung. Hal ini sesuai dengan metode pemasaran "Iklan Shopping" dan "Iklan Inventaris Lokal" di Merchant Center. Belanja
destinations.status STRING Tidak digunakan lagi (selalu ditetapkan ke NULL) sebagai bagian dari perubahan yang ditujukan agar produk dapat menargetkan beberapa negara. Sebagai gantinya, gunakan kolom berikut untuk membaca status setiap negara target: destinations.approved_countries, destinations.pending_countries, destinations.disapproved_countries. Masalah kini dapat berlaku untuk negara target tertentu dan tidak untuk negara lainnya, seperti yang ditunjukkan di kolom issues.applicable_countries. NULL
destinations.approved_countries STRING, REPEATED Daftar kode wilayah CLDR tempat penawaran disetujui. US, CH
destinations.pending_countries STRING, REPEATED Daftar kode wilayah CLDR tempat penawaran menunggu keputusan. US, CH
destinations.disapproved_countries STRING, REPEATED Daftar kode wilayah CLDR tempat penawaran tidak disetujui. US, CH
issues RECORD, REPEATED Daftar masalah tingkat item yang terkait dengan produk.
issues.code STRING Kode error masalah. image_too_generic
issues.servability STRING Pengaruh masalah ini terhadap penayangan penawaran. disapproved, unaffected
issues.resolution STRING Apakah masalah dapat diselesaikan oleh penjual atau tidak. merchant_action, pending_processing
issues.attribute_name STRING Nama atribut, jika masalahnya disebabkan oleh satu atribut. NULL jika tidak. link gambar
issues.destination STRING Tujuan tempat masalah diterapkan. Selalu ditetapkan ke Shopping. Belanja
issues.short_description STRING Deskripsi singkat masalah dalam bahasa Inggris. Gambar generik
issues.detailed_description STRING Deskripsi masalah mendetail dalam bahasa Inggris. Gunakan gambar yang menampilkan produk
issues.documentation STRING URL halaman web untuk membantu menyelesaikan masalah ini. https://support.google.com/merchants/answer/6098288
issues.applicable_countries STRING, REPEATED Daftar kode wilayah CLDR tempat masalah berlaku. CH

Contoh kueri

Statistik produk dan masalah produk

Contoh kueri SQL berikut memberikan jumlah produk, produk yang memiliki masalah, dan masalah menurut hari.

SELECT
  _PARTITIONDATE AS date,
  COUNT(*) AS num_products,
  COUNTIF(ARRAY_LENGTH(issues) > 0) AS num_products_with_issues,
  SUM(ARRAY_LENGTH(issues)) AS num_issues
FROM
  dataset.Products_merchant_id
WHERE
  _PARTITIONDATE >= 'YYYY-MM-DD'
GROUP BY
  date
ORDER BY
  date DESC

Produk tidak disetujui untuk Iklan Shopping

Contoh kueri SQL berikut memberikan jumlah produk yang tidak disetujui untuk ditampilkan di Iklan Shopping, dipisahkan berdasarkan negara. Penolakan dapat terjadi karena tujuan dikecualikan atau karena ada masalah dengan produk.

SELECT
  _PARTITIONDATE AS date,
  disapproved_country,
  COUNT(*) AS num_products
FROM
  dataset.Products_merchant_id,
  UNNEST(destinations) AS destination,
  UNNEST(disapproved_countries) AS disapproved_country
WHERE
  _PARTITIONDATE >= 'YYYY-MM-DD'
GROUP BY
  date, disapproved_country
ORDER BY
  date DESC

Produk dengan masalah tidak disetujui

Contoh kueri SQL berikut mengambil jumlah produk dengan masalah tidak disetujui, dipisahkan berdasarkan negara.

SELECT
  _PARTITIONDATE AS date,
  applicable_country,
  COUNT(DISTINCT CONCAT(CAST(merchant_id AS STRING), ':', product_id))
      AS num_distinct_products
FROM
  dataset.Products_merchant_id,
  UNNEST(issues) AS issue,
  UNNEST(issue.applicable_countries) as applicable_country
WHERE
  _PARTITIONDATE >= 'YYYY-MM-DD' AND
  issue.servability = 'disapproved'
GROUP BY
  date, applicable_country
ORDER BY
  date DESC