Transfer Google Merchant Center

BigQuery Data Transfer Service untuk Google Merchant Center memungkinkan Anda menjadwalkan dan mengelola tugas pemuatan berulang secara otomatis untuk data pelaporan Google Merchant Center.

Laporan yang didukung

BigQuery Data Transfer Service untuk Google Merchant Center mendukung data berikut:

Produk dan masalah produk

Laporan masalah produk dan produk mencakup data produk yang diberikan ke Merchant Center melalui feed atau menggunakan Content API for Shopping. Laporan ini juga mencakup masalah tingkat item yang terdeteksi oleh Google untuk produk Anda. Anda dapat melihat data masalah produk dan produk di Google Merchant Center atau dengan membuat kueri Content API for Shopping. Untuk mengetahui informasi tentang cara data ini dimuat ke BigQuery, lihat skema tabel produk Google Merchant Center.

Inventaris regional

Laporan inventaris regional mencakup data produk tambahan tentang ketersediaan regional dan penggantian harga produk Anda.Untuk mengetahui informasi tentang cara data ini dimuat ke BigQuery, lihat skema tabel inventaris regional Google Merchant Center.

Inventaris lokal

Laporan inventaris lokal mencakup data produk tambahan tentang inventaris lokal produk Anda. Laporan ini berisi data tentang harga lokal, ketersediaan, jumlah, pengambilan, dan lokasi produk di toko. Untuk mendapatkan informasi tentang cara data ini dimuat ke BigQuery, lihat skema tabel inventaris lokal Google Merchant Center.

Performa

Laporan performa menyediakan segmentasi terperinci terhadap data performa di seluruh Iklan dan Listingan Gratis. Untuk mendapatkan informasi tentang cara data ini dimuat ke BigQuery, lihat skema tabel performa Google Merchant Center.

Terlaris

Laporan Terlaris menyediakan data yang sama dengan yang ada di UI Google Merchant Center dan memungkinkan Anda mengisi ulang data di seluruh negara atau kategori hingga 2 tahun. Hal ini mencakup data tentang produk dan merek paling populer di iklan Shopping dan listingan tidak berbayar, serta apakah Anda memilikinya di inventaris atau tidak. Laporan ini didasarkan pada laporan terlaris yang tersedia melalui Google Merchant Center. Untuk mendapatkan informasi tentang cara data ini dimuat ke BigQuery, lihat skema tabel penjual terbaik Google Merchant Center.

Daya Saing Harga

Sebelumnya dikenal sebagai laporan tolok ukur harga, laporan persaingan harga mencakup atribut tingkat produk dan data tolok ukur harga serta didasarkan pada definisi yang sama seperti laporan persaingan harga yang tersedia melalui Google Merchant Center. Untuk mengetahui informasi tentang cara data ini dimuat ke BigQuery, lihat skema tabel persaingan harga Google Merchant Center.

Info Harga

Gunakan laporan analisis harga untuk melihat harga promo yang disarankan untuk produk Anda, dan prediksi performa yang dapat diharapkan jika Anda memperbarui harga produk. Menggunakan laporan analisis harga dapat membantu Anda menetapkan harga produk secara lebih efektif. Untuk mengetahui informasi selengkapnya tentang cara menggunakan data dalam laporan ini, lihat Meningkatkan harga produk dengan laporan analisis harga untuk mengetahui informasi lebih lanjut tentang cara menggunakan data dalam laporan ini. Untuk mendapatkan informasi tentang cara data ini dimuat ke BigQuery, lihat skema tabel Analisis Harga Google Merchant Center.

Tolok ukur harga

Untuk mendapatkan informasi tentang cara data ini dimuat ke BigQuery, lihat skema tabel tolok ukur harga Google Merchant Center.

Merek teratas, Produk teratas, dan Inventaris Produk

Tabel Produk teratas, Merek teratas, dan Inventaris produk menyertakan data tentang produk dan merek paling populer di iklan Shopping dan listingan tidak berbayar, serta apakah Anda memilikinya di inventaris atau tidak. Laporan ini didasarkan pada laporan terlaris yang tersedia melalui Google Merchant Center.

Laporan merek teratas, Produk teratas, dan Inventaris Produk terdiri dari tabel berikut:

  • BestSellers_TopProducts_ adalah daftar peringkat produk teratas per negara dan kategori produk Google. Tabel ini menampilkan data dari semua penjual di seluruh iklan Shopping dan listingan tidak berbayar.
  • BestSellers_TopProducts_Inventory_ adalah tabel pemetaan antara produk teratas dan inventaris Anda.
  • BestSellers_TopBrands_ adalah daftar peringkat merek-merek teratas, yang dihitung per negara dan kategori produk Google. Laporan ini mewakili data dari semua penjual di seluruh iklan Shopping dan listingan tidak berbayar.

Untuk mengetahui informasi tentang cara data terlaris dimuat ke BigQuery, lihat skema tabel produk teratas, inventaris produk, dan merek teratas Google Merchant Center.

BigQuery Data Transfer Service untuk Google Merchant Center mendukung opsi pelaporan berikut:

Opsi pelaporan Dukungan
Jadwal

Dapat dikonfigurasi ke harian, mingguan, bulanan, atau kustom. Secara default, opsi ini disetel ke harian saat transfer dibuat. Interval minimum antar-transfer adalah 6 jam.

Batasan

Beberapa laporan mungkin memiliki batasannya sendiri, seperti periode dukungan yang berbeda untuk pengisian ulang historis. Bagian berikut menjelaskan batasan untuk setiap laporan.

Dukungan Pengisian Ulang Historis

Tidak semua laporan mendukung pengisian ulang historis dengan cara yang sama. Berikut adalah daftar laporan dan tingkat dukungan untuk pengisian ulang historis.

  • Produk dan masalah produk - 14 hari
  • Persediaan Lokal - 14 hari
  • Persediaan Regional - 14 hari
  • Performa - 2 tahun
  • Terlaris - 2 tahun
  • Daya saing harga - Tidak ada dukungan pengisian ulang
  • Analisis harga - Tidak ada dukungan pengisian ulang

Produk dan masalah produk

  • Data produk dan masalah produk di BigQuery tidak mewakili tampilan real-time akun Penjual Anda. Untuk melihat linimasa data Anda, lihat kolom product_data_timestamp dalam skema.

Tolok ukur harga

  • Data tolok ukur harga tidak mewakili tampilan real time tolok ukur harga. Untuk melihat linimasa data Anda, lihat kolom price_benchmark_timestamp dalam skema Tolok Ukur Harga.
  • Tidak semua produk memiliki tolok ukur harga.

Terlaris

  • Tidak semua negara memiliki data peringkat. Negara yang disertakan dalam laporan (menggunakan ISO 3166-1 alpha-2): AT, AU, BE, BR, CA, CH, CZ, DE, DK, ES, FI, FR, GB, HU, IE, IN, IT, JP, MX, NL, NO, NZ, PL, PT, RO, RU, SE, SK, TR, UA, dan US.
  • Data terlaris tidak mewakili tampilan peringkat merek secara real-time. Untuk melihat linimasa data Anda, lihat kolom rank_timestamp dalam skema BestSellers_TopProducts_ dan BestSellers_TopBrands_.
  • Mungkin ada baris dalam tabel Products_ dengan google_brand_id yang tidak dipetakan ke merek apa pun di tabel BestSellers_TopBrands_.
  • ID merek di kolom google_brand_id dapat berubah seiring waktu untuk mencerminkan sifat bisnis dan brand yang berubah-ubah. Oleh karena itu, pelacakan rangkaian merek dalam jangka waktu yang lama tidak dijamin.
  • Meskipun merek diberi peringkat di banyak kategori berbeda, semua produk dalam tabel Products_ termasuk dalam kategori leaf. Untuk menggabungkan merek dan produk pada kategori non-leaf, gunakan kolom google_product_category_ids, seperti ditunjukkan dalam Contoh kueri terlaris.

Dukungan Akun multiklien (MCA)

Pelanggan lama dengan beberapa ID Penjual disarankan untuk mengonfigurasi Akun Multiklien (MCA) induk. Dengan mengonfigurasi MCA, Anda dapat membuat satu transfer untuk semua ID Penjual.

Menggunakan MCA Google Merchant Center memberikan beberapa manfaat dibandingkan menggunakan ID Penjual perorangan:

  • Anda tidak perlu lagi mengelola beberapa transfer guna mentransfer data pelaporan untuk beberapa ID Penjual.
  • Kueri yang melibatkan beberapa ID Penjual jauh lebih mudah ditulis karena semua data ID Penjual disimpan dalam tabel yang sama.
  • Menggunakan MCA akan mengurangi potensi masalah kuota tugas pemuatan BigQuery karena semua data ID Penjual Anda dimuat di tugas yang sama.

Salah satu kemungkinan kerugian menggunakan MCA adalah biaya kueri Anda berikutnya kemungkinan akan lebih tinggi. Karena semua data Anda disimpan dalam tabel yang sama, kueri yang mengambil data untuk setiap ID Penjual masih harus memindai seluruh tabel.

Jika Anda menggunakan MCA, ID MCA tercantum di bawah aggregator_id dan setiap sub-akun tercantum di bagian merchant_id. Untuk akun yang tidak menggunakan MCA, aggregator_id ditetapkan ke null.

Tidak semua laporan mendukung MCA. MCA didukung oleh laporan berikut:

  • Produk dan masalah produk
  • Inventaris Lokal
  • Inventaris Regional

Sebelum memulai

Sebelum melakukan transfer Google Merchant Center:

Izin yang diperlukan

Pastikan orang yang melakukan transfer memiliki izin yang diperlukan berikut:

  • BigQuery:

    • Izin bigquery.transfers.update untuk membuat transfer
    • Izin bigquery.datasets.get dan bigquery.datasets.update pada set data target

    Peran IAM bigquery.admin yang telah ditetapkan mencakup izin bigquery.transfers.update, bigquery.datasets.update, dan bigquery.datasets.get. Untuk informasi lebih lanjut tentang peran IAM dalam BigQuery Data Transfer Service, lihat Kontrol akses.

  • Google Merchant Center:

Menyiapkan transfer Google Merchant Center

Menyiapkan transfer data untuk pelaporan Google Merchant Center memerlukan hal berikut:

Guna melakukan transfer data untuk pelaporan Google Merchant Center:

Konsol

  1. Buka halaman BigQuery di konsol Google Cloud.

    Buka halaman BigQuery

  2. Klik Data transfers.

  3. Klik Create Transfer.

  4. Di halaman Create Transfer:

    • Di bagian Source type, pilih Google Merchant Center untuk Source.

    • Di bagian Transfer config name, untuk Display name, masukkan nama untuk transfer, misalnya My Transfer. Nama transfer dapat berupa nilai apa pun yang memungkinkan Anda mengidentifikasi transfer jika perlu mengubahnya nanti.

      Nama transfer

    • Di bagian Schedule options:

      • Pilih Repeat frequency. Jika memilih Jam, Hari, Minggu, atau Bulan, Anda juga harus menentukan frekuensinya. Anda juga dapat memilih Custom untuk menentukan frekuensi pengulangan kustom. Jika Anda memilih On-demand, transfer ini akan berjalan saat Anda memicu transfer secara manual.

      • Jika perlu, pilih Start now atau Start at set time, lalu masukkan tanggal mulai dan waktu proses.

      • Untuk Start date and run time, masukkan tanggal dan waktu untuk memulai transfer. Nilai ini harus setidaknya 24 jam lebih lambat dari waktu UTC saat ini. Jika Anda memilih Start now, opsi ini akan dinonaktifkan.

        Jadwal transfer

        Jika Anda membiarkan opsi jadwal disetel ke Start now, proses transfer pertama akan segera dimulai dan akan gagal dengan pesan error berikut: No data to transfer found for the Merchant account. If you have just created this transfer, you may need to wait for up to a day before the data of your Merchant account are prepared and available for the transfer. Proses terjadwal berikutnya akan berhasil dijalankan. Jika data akun Penjual Anda disiapkan pada tanggal yang sama dalam waktu UTC, Anda dapat menyiapkan pengisian ulang untuk proses hari ini.

    • Di bagian Destination settings, untuk Destination dataset, pilih set data yang Anda buat untuk menyimpan data.

      Mentransfer set data

    • Di bagian Data source details, untuk Merchant ID, masukkan ID Penjual atau ID MCA Anda.

      Pilih laporan yang ingin Anda transfer. Lihat Laporan yang Didukung untuk detail selengkapnya.

      Transfer data Google Merchant Center.

    • Di menu Service Account, pilih service account dari akun layanan yang terkait dengan project Google Cloud Anda. Anda dapat mengaitkan akun layanan dengan transfer Anda, bukan menggunakan kredensial pengguna. Untuk mengetahui informasi selengkapnya tentang cara menggunakan akun layanan dengan transfer data, lihat Menggunakan akun layanan.

    • (Opsional) Di bagian Notification options:

      • Klik tombol untuk mengaktifkan notifikasi email. Saat Anda mengaktifkan opsi ini, administrator transfer akan menerima notifikasi email saat proses transfer gagal.
      • Untuk Select a Pub/Sub topic, pilih nama topik atau klik Create a topic. Opsi ini mengonfigurasi notifikasi operasi Pub/Sub untuk transfer Anda.
  5. Klik Simpan.

bq

Masukkan perintah bq mk dan berikan flag pembuatan transfer — --transfer_config. Flag berikut juga diperlukan:

  • --data_source
  • --target_dataset
  • --display_name
  • --params

Anda juga dapat memberikan flag --project_id untuk menentukan project tertentu. Jika --project_id tidak ditentukan, project default akan digunakan.

bq mk \
--transfer_config \
--project_id=project_id \
--target_dataset=dataset \
--display_name=name \
--params='parameters' \
--data_source=data_source
--service_account_name=service_account_name

Dengan keterangan:

  • project_id adalah project ID Anda.
  • dataset adalah set data target untuk konfigurasi transfer.
  • name adalah nama tampilan untuk konfigurasi transfer. Nama transfer dapat berupa nilai apa pun yang memungkinkan Anda mengidentifikasi transfer jika perlu mengubahnya nanti.
  • parameters berisi parameter untuk konfigurasi transfer yang dibuat dalam format JSON. Contoh: --params='{"param":"param_value"}'.
    • Untuk transfer Google Merchant Center, Anda harus memberikan parameter merchant_id.
    • Parameter export_products menentukan apakah akan mentransfer data produk dan masalah produk atau tidak. Parameter ini disertakan secara default, meskipun Anda tidak menentukan parameter export_products. Google merekomendasikan agar Anda menyertakan parameter ini secara eksplisit dan menetapkannya ke "benar".
    • Parameter export_regional_inventories menentukan apakah akan mentransfer data inventaris regional atau tidak.
    • Parameter export_local_inventories menentukan apakah akan mentransfer data inventaris lokal atau tidak.
    • Parameter export_price_benchmarks menentukan apakah akan mentransfer data tolok ukur harga atau tidak.
    • Parameter export_best_sellers menentukan apakah akan mentransfer data terlaris atau tidak.
  • data_source adalah sumber data — merchant_center.
  • service_account_name adalah nama akun layanan yang digunakan untuk mengautentikasi transfer Anda. Akun layanan harus dimiliki oleh project_id yang sama dengan yang digunakan untuk membuat transfer dan harus memiliki semua izin yang diperlukan.

Misalnya, perintah berikut akan membuat transfer Google Merchant Center bernama My Transfer menggunakan ID Penjual 1234 dan set data target mydataset. Transfer dibuat di project default Anda.

bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--params='{"merchant_id":"1234","export_products":"true","export_regional_inventories":"true","export_local_inventories":"true","export_price_benchmarks":"true","export_best_sellers":"true"}' \
--data_source=merchant_center

Saat pertama kali menjalankan perintah ini, Anda akan menerima pesan seperti berikut:

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

Ikuti petunjuk dalam pesan, lalu tempel kode autentikasi pada command line.

Jika Anda baru saja membuat transfer ini, Anda mungkin perlu menunggu hingga satu hari sebelum data akun Penjual disiapkan dan tersedia untuk transfer.` Proses terjadwal berikutnya akan berhasil berjalan. Jika data akun Penjual disiapkan pada tanggal yang sama dalam waktu UTC, Anda dapat menyiapkan pengisian ulang untuk proses hari ini.

API

Gunakan metode projects.locations.transferConfigs.create dan berikan instance resource TransferConfig.

Memecahkan masalah penyiapan transfer Google Merchant Center

Jika Anda mengalami masalah saat menyiapkan transfer, lihat Masalah transfer Google Merchant Center di Memecahkan masalah penyiapan transfer BigQuery Data Transfer Service.

Membuat kueri data Anda

Saat data Anda ditransfer ke BigQuery, data tersebut akan ditulis ke tabel berpartisi berdasarkan waktu penyerapan. Untuk informasi selengkapnya, lihat Pengantar tabel berpartisi.

Saat membuat kueri tabel Google Merchant Center, Anda harus menggunakan kolom tiruan _PARTITIONTIME atau _PARTITIONDATE dalam kueri Anda. Untuk mengetahui informasi selengkapnya, lihat Membuat kueri tabel berpartisi.

Tabel Products_ berisi kolom bertingkat dan berulang. Untuk informasi tentang cara menangani data bertingkat dan berulang, lihat Perbedaan dalam penanganan kolom berulang dalam dokumentasi GoogleSQL.

Contoh kueri Google Merchant Center

Anda dapat menggunakan contoh kueri Google Merchant Center berikut untuk menganalisis data yang ditransfer. Anda juga dapat menggunakan kueri dalam alat visualisasi seperti Looker Studio.

Di setiap kueri berikut, ganti dataset dengan nama set data Anda. Ganti merchant_id dengan ID Penjual Anda. Jika Anda menggunakan MCA, ganti merchant_id dengan ID MCA Anda.

Contoh kueri produk dan masalah produk

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

Contoh kueri tolok ukur harga

Membandingkan harga produk dengan tolok ukur

Kueri SQL berikut menggabungkan data Products dan Price Benchmarks untuk menampilkan daftar produk dan tolok ukur terkait.

WITH products AS
(
  SELECT
    _PARTITIONDATE AS date,
    *
  FROM
    dataset.Products_merchant_id
  WHERE
   _PARTITIONDATE >= 'YYYY-MM-DD'
),
benchmarks AS
(
  SELECT
    _PARTITIONDATE AS date,
    *
  FROM
    dataset.Products_PriceBenchmarks_merchant_id
  WHERE
    _PARTITIONDATE >= 'YYYY-MM-DD'
)
SELECT
  products.date,
  products.product_id,
  products.merchant_id,
  products.aggregator_id,
  products.price,
  products.sale_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

Contoh kueri terlaris

Produk teratas untuk kategori dan negara tertentu

Kueri SQL berikut menampilkan produk teratas untuk kategori "Smartphone" di AS.

SELECT
  rank,
  previous_rank,
  relative_demand.bucket,
  (SELECT name FROM top_products.product_title WHERE locale = 'en-US') AS product_title,
  brand,
  price_range
FROM
  dataset.BestSellers_TopProducts_merchant_id AS top_products
WHERE
  _PARTITIONDATE = 'YYYY-MM-DD' AND
  ranking_category = 267 /*Smartphones*/ AND
  ranking_country = 'US'
ORDER BY
  rank

Produk teratas dalam inventaris Anda

Kueri SQL berikut menggabungkan data BestSellers_TopProducts_Inventory_ dan BestSellers_TopProducts_ untuk menampilkan daftar produk teratas yang Anda miliki di inventaris Anda.

WITH latest_top_products AS
(
  SELECT
    *
  FROM
    dataset.BestSellers_TopProducts_merchant_id
  WHERE
    _PARTITIONDATE = 'YYYY-MM-DD'
),
latest_top_products_inventory AS
(
  SELECT
    *
  FROM
    dataset.BestSellers_TopProducts_Inventory_merchant_id
  WHERE
    _PARTITIONDATE = 'YYYY-MM-DD'
)
SELECT
  top_products.rank,
  inventory.product_id,
  (SELECT ANY_VALUE(name) FROM top_products.product_title) AS product_title,
  top_products.brand,
  top_products.gtins
FROM
  latest_top_products AS top_products
INNER JOIN
  latest_top_products_inventory AS inventory
USING (rank_id)

Merek teratas untuk kategori dan negara tertentu

Kueri SQL berikut menampilkan merek terpopuler untuk kategori "Smartphone" di AS.

SELECT
  rank,
  previous_rank,
  brand
FROM
  dataset.BestSellers_TopBrands_merchant_id
WHERE
  _PARTITIONDATE = 'YYYY-MM-DD' AND
  ranking_category = 267 /*Smartphones*/ AND
  ranking_country = 'US'
ORDER BY
  rank

Produk dari merek-merek teratas dalam inventaris Anda

Kueri SQL berikut menampilkan daftar produk dalam inventaris Anda dari merek-merek teratas, yang dicantumkan berdasarkan kategori dan negara.

  WITH latest_top_brands AS
  (
    SELECT
      *
    FROM
      dataset.BestSellers_TopBrands_merchant_id
    WHERE
      _PARTITIONDATE = 'YYYY-MM-DD'
  ),
  latest_products AS
  (
    SELECT
      product.*,
      product_category_id
    FROM
      dataset.Products_merchant_id AS product,
      UNNEST(product.google_product_category_ids) AS product_category_id,
      UNNEST(destinations) AS destination,
      UNNEST(destination.approved_countries) AS approved_country
    WHERE
      _PARTITIONDATE = 'YYYY-MM-DD'
  )
  SELECT
    top_brands.brand,
    (SELECT name FROM top_brands.ranking_category_path
    WHERE locale = 'en-US') AS ranking_category,
    top_brands.ranking_country,
    top_brands.rank,
    products.product_id,
    products.title
  FROM
    latest_top_brands AS top_brands
  INNER JOIN
    latest_products AS products
  ON top_brands.google_brand_id = products.google_brand_id AND
     top_brands.ranking_category = product_category_id AND
     top_brands.ranking_country = products.approved_country