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