Skema tabel produk Google Merchant Center

Ringkasan

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 Data contoh
product_data_timestamp TIMESTAMP Stempel waktu data produk. 2023-09-14 11.49.50 UTC
product_id STRING REST ID Content API produk dalam bentuk: channel:content_language:feed_label:offer_id. 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. USB hitam TN2351
description STRING Deskripsi item. USB hitam TN2351 telah mengubah 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 diberikan penjual untuk item, atau - jika tidak diberikan. US
channel STRING Saluran item, baik online atau local. lokal, online
expiration_date TIMESTAMP Tanggal dan waktu yang diberikan penjual saat item harus habis masa berlakunya, seperti yang ditentukan saat penyisipan. Ditetapkan 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. Tidak pernah disetel 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 diberikan. bayi baru lahir, bayi, balita, anak-anak, dewasa
availability STRING Status ketersediaan item yang disediakan penjual. tersedia, habis
availability_date TIMESTAMP Tanggal dan waktu yang diberikan penjual saat produk praorder tersedia untuk pengiriman. NULL jika tidak diberikan. 2023-10-14 00:00:00 UTC
brand STRING Merek item yang disediakan penjual. NULL jika tidak diberikan. Nama Merek
google_brand_id STRING ID brand Google untuk item. 12759524623914508053
color STRING Warna item yang disediakan penjual. NULL jika tidak diberikan. Silver, Abu-abu, Multi
condition STRING Kondisi atau status item yang disediakan penjual. baru, bekas, refurbished
custom_labels RECORD Label khusus yang disediakan penjual untuk pengelompokan item khusus di Iklan Shopping. NULL jika tidak diberikan.
custom_labels.label_0 STRING Label kustom 0. label khusus saya
custom_labels.label_1 STRING Label kustom 1. label khusus saya
custom_labels.label_2 STRING Label kustom 2. label khusus saya
custom_labels.label_3 STRING Label kustom 3. label khusus saya
custom_labels.label_4 STRING Label kustom 4. label khusus saya
gender STRING Target gender item yang disediakan penjual. NULL jika tidak diberikan. uniseks, pria, wanita
gtin STRING Nomor Barang Perdagangan Global (GTIN) item yang disediakan penjual. NULL jika tidak diberikan. 3234567890126
item_group_id STRING ID bersama yang disediakan penjual untuk semua varian dari produk yang sama. NULL jika tidak diberikan. AB12345
material STRING Bahan yang disediakan penjual untuk membuat item. NULL jika tidak diberikan. Kulit
mpn STRING Nomor Suku Cadang Produsen (MPN) item yang diberikan penjual. Ditetapkan ke NULL jika tidak disediakan. GO12345OOGLE
pattern STRING Pola yang disediakan penjual. NULL jika tidak diberikan. Bergaris
price RECORD Harga 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 diberikan. 19.99
sale_price.currency STRING Mata uang harga promo. NULL jika tidak diberikan. 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 diberikan. 2271
google_product_category_ids INTEGER, REPEATED Jalur lengkap kategori produk Google ke item, yang disimpan sebagai kumpulan ID. NULL jika tidak diberikan.
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 > Wanita > 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. Amerika Serikat, Swiss
destinations.pending_countries STRING, REPEATED Daftar kode wilayah CLDR tempat penawaran menunggu keputusan. Amerika Serikat, Swiss
destinations.disapproved_countries STRING, REPEATED Daftar kode wilayah CLDR tempat penawaran tidak disetujui. Amerika Serikat, Swiss
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. tidak disetujui, tidak terpengaruh
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

Bagian ini menyajikan 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