Pelaporan produk untuk iklan Shopping

Seperti jenis iklan lainnya, Anda dapat menggunakan GoogleAdsService.SearchStream untuk mengambil data status dan performa produk untuk produk Shopping.

Kampanye yang mendukung produk dari feed Google Merchant Center memiliki laporan khusus berikut:

• Shopping Performance View
• Tampilan Grup Produk
• Tampilan Grup Produk Grup Aset
• Produk Shopping
• Cart Data Sales View (tersedia di v24 dan yang lebih baru)
• Tampilan Aset Perluasan URL Final (tersedia untuk kampanye Shopping di v26 dan yang lebih baru)

Selain itu, mulai v26, di kampanye Shopping, final_url_expansion_asset_view melaporkan aset penyesuaian teks yang ditayangkan saat AI Maksimal (campaign.ai_max_setting.enable_ai_max = true) dan perluasan URL Final (FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN) diaktifkan. Lihat bagian Tampilan aset perluasan URL final untuk mengetahui persyaratan kueri dan contohnya.

Catatan: shopping_performance_view dan shopping_product menampilkan metrik di tingkat produk. shopping_performance_view memberikan status historis produk yang telah menayangkan iklan, sedangkan shopping_product memberikan status produk saat ini, baik produk tersebut telah menayangkan iklan maupun belum. Gunakan shopping_product terutama untuk menilai status produk saat ini dan masalah apa pun yang menghentikannya untuk digunakan oleh kampanye.

Tampilan Performa Shopping

Shopping Performance View menyediakan statistik pelaporan historis gabungan untuk produk berdasarkan atribut seperti product_item_id.

Fitur ini mendukung semua jenis kampanye yang menggunakan feed produk dari Google Merchant Center, termasuk kampanye Shopping, Performa Maksimal, Peningkat Permintaan, Video, Aplikasi, dan Display.

Catatan: Mulai 15 Juni 2026, Shopping Performance View akan menyertakan data dari semua jaringan Performa Maksimal. Anda mungkin melihat peningkatan satu kali dalam metrik pelaporan untuk kampanye Performa Maksimal karena data dari jaringan yang sebelumnya dikecualikan (seperti YouTube) digabungkan.

Shopping Performance View mencatat status produk pada saat metrik yang relevan dicatat. Hal ini mencakup segmen seperti product_title, yang mungkin telah berubah sejak metrik dicatat.

shopping_performance_view juga mendukung segmen dan metrik berikut:

• segments.ad_sub_network_type (juga didukung di product_group_view dan asset_group_product_group_view).
• Metrik yang disegmentasi menurut tanggal konversi: metrics.conversions_by_conversion_date, metrics.all_conversions_by_conversion_date, metrics.conversions_value_by_conversion_date, metrics.all_conversions_value_by_conversion_date, metrics.value_per_conversions_by_conversion_date, dan metrics.value_per_all_conversions_by_conversion_date.
• Metrik pangsa tayangan iklan kompetitif: metrics.search_budget_lost_impression_share, metrics.search_rank_lost_impression_share, metrics.search_budget_lost_absolute_top_impression_share, dan metrics.search_rank_lost_absolute_top_impression_share.
• Tersedia di v24 dan yang lebih baru: Segmen segments.conversion_attribution_event_type dan metrics.all_* metrik data keranjang (yang melaporkan data keranjang di semua konversi, termasuk konversi yang tidak dapat di-bid).

Berikut adalah contoh kueri yang mengambil tayangan iklan, klik, biaya, konversi, dan semua konversi untuk produk menurut product_item_id dengan klik dalam 30 hari terakhir (diurutkan dalam urutan menurun berdasarkan semua konversi, lalu konversi, lalu klik, lalu biaya, lalu tayangan iklan):

SELECT
  segments.product_item_id,
  metrics.clicks,
  metrics.cost_micros,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM shopping_performance_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.clicks > 0
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.cost_micros DESC,
  metrics.impressions DESC

Logika atribusi untuk pelaporan produk

Laporan tingkat produk menggunakan framework atribusi tertentu untuk mengatribusikan kredit performa ke masing-masing produk saat beberapa produk muncul dalam satu iklan.

Metrik keuangan

Metrik keuangan, seperti metrics.cost_micros dan metrics.conversions, dihitung untuk memastikan jumlahnya di semua produk tidak melebihi laporan tingkat kampanye.

Interaksi langsung

Jika niat pengguna jelas dan terkait dengan satu produk (seperti klik langsung pada produk), 100% biaya dan kredit konversi terkait akan diatribusikan ke produk tersebut.

Interaksi tidak langsung

Jika niat pengguna diarahkan ke iklan secara keseluruhan (misalnya, jika pengguna mengklik judul, tombol Pesan Ajakan, atau video), biaya dan kredit konversi terkait akan didistribusikan secara seragam ke semua produk yang ditayangkan dalam iklan tertentu tersebut.

Metrik interaksi

Metrik interaksi, seperti metrics.impressions dan metrics.clicks, mengukur interaksi khusus produk.

Untuk tayangan iklan, jumlahnya bertambah untuk setiap produk yang disertakan dalam iklan saat peristiwa terjadi, terlepas dari apakah produk tersebut terlihat di area pandang pengguna atau tidak. Oleh karena itu, jumlah tayangan iklan di semua produk dalam laporan mungkin jauh lebih tinggi daripada total tingkat kampanye yang sesuai.

Sebaliknya, metrics.clicks hanya mengukur klik yang terjadi pada produk tertentu tersebut. Di UI Google Ads, kolom metrics.clicks secara eksplisit diberi label sebagai Klik Produk.

Product Group View

Product Group View memberikan statistik pelaporan gabungan untuk Shopping listing groups (disebut sebagai product groups di UI). Lihat panduan pelaporan Performa Maksimal untuk contoh Tampilan Grup Produk Grup Aset.

Berikut adalah contoh kueri yang mengambil tayangan iklan, klik, konversi, dan semua konversi untuk grup listingan Shopping menurut kampanye dengan tayangan iklan dalam 30 hari terakhir (diurutkan dalam urutan menurun berdasarkan semua konversi, lalu konversi, lalu klik, lalu tayangan iklan):

SELECT
  campaign.name,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.all_conversions
FROM product_group_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.impressions > 0
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC

Laporan Produk Shopping

Laporan Shopping Product memberikan atribut dan statistik pelaporan untuk produk yang ada di akun Google Merchant Center yang ditautkan ke akun Google Ads. Laporan ini dapat digunakan untuk memeriksa statistik di tingkat pelanggan, kampanye, dan grup iklan. Layanan ini mendukung kampanye Shopping, Performa Maksimal, Peningkat Permintaan, Video, dan (di v24 dan yang lebih baru) Aplikasi. Anda juga dapat membuat kueri shopping_product.product_image_uri untuk mengambil URI gambar produk yang disediakan oleh penjual.

Berikut adalah contoh kueri yang mengambil tayangan iklan, klik, konversi, dan semua konversi selama 30 hari terakhir (diurutkan dalam urutan menurun berdasarkan semua konversi, lalu konversi, lalu klik, lalu tayangan iklan) untuk semua produk Shopping dari semua akun Google Merchant Center yang ditautkan:

SELECT
  shopping_product.resource_name,
  shopping_product.item_id,
  shopping_product.feed_label,
  shopping_product.merchant_center_id,
  metrics.clicks,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM shopping_product
WHERE segments.date DURING LAST_30_DAYS
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC

Lihat Panduan pelaporan untuk mengetahui detail selengkapnya tentang kueri.

Pertimbangan performa

Laporan Produk Shopping dapat menampilkan data dalam jumlah yang signifikan jika akun ditautkan ke banyak produk. Rekomendasi berikut dapat membantu meningkatkan performa kueri GAQL Anda:

• Kueri di tingkat kampanye dan grup iklan biasanya lebih cepat daripada kueri di tingkat akun, karena kemungkinan berisi lebih sedikit produk dan memerlukan akses ke lebih sedikit data.
• Makin banyak kolom dan metrik dalam klausa SELECT, makin lambat waktu responsnya. Pilih hanya kolom dan metrik yang Anda perlukan dalam kueri.
• Produk dengan satu atau beberapa masalah akan menampilkan lebih banyak data. Anda dapat memfilter menurut shopping_product.status dalam klausa WHERE untuk memahami produk mana yang kemungkinan akan menampilkan masalah yang menyebabkan status yang relevan.

Kasus penggunaan umum untuk laporan Produk Shopping

Laporan Produk Shopping memberikan akses fleksibel ke informasi produk untuk kampanye yang menggunakan feed produk. Layanan ini dapat memberi Anda insight tentang status produk dari akun Google Merchant Center, serta informasi khusus iklan seperti metrik performa dan masalah yang mencegah produk menayangkan iklan.

Bagian ini membahas beberapa kasus penggunaan umum yang serupa dengan yang mungkin ada dalam tampilan Produk di UI Google Ads.

Kolom issues untuk shopping_product mirip dengan ProductStatus di Merchant API, dengan tambahan masalah yang spesifik untuk Google Ads. Untuk memeriksa apakah masalah perlu diselesaikan di Google Merchant Center atau Google Ads, periksa terlebih dahulu kolom shopping_product.issues.documentation pada respons, yang menyertakan artikel Pusat Bantuan untuk membantu.

Status produk (Tingkat akun)

Menentukan laporan tanpa filter untuk kampanye atau grup iklan akan menampilkan semua produk di tingkat akun.

Skrip ini mendukung metrik, status, dan masalah dari semua kampanye di akun dengan jenis:

• Belanja
• Performa Maks

Kueri ini memungkinkan Anda melihat status produk, misalnya NOT_ELIGIBLE, dan daftar masalah khusus untuk produk yang menyebabkan status tertentu:

SELECT
  shopping_product.resource_name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product

Status produk (Tingkat kampanye)

Menentukan laporan dengan resource kampanye sebagai bagian dari klausa WHERE akan menampilkan semua produk yang disertakan dalam kampanye yang dipilih.

Fitur ini didukung oleh jenis kampanye berikut yang dapat menggunakan feed produk:

• Belanja
• Performa Maks
• Peningkat Permintaan
• Video
• Aplikasi (tersedia di v24 dan yang lebih baru)

Catatan: Untuk kampanye Aplikasi, Video, dan Peningkat Permintaan (di v24 dan yang lebih baru), hanya metrik impressions, clicks, dan ctr yang didukung. Selain itu, shopping_product.status dan shopping_product.issues tidak didukung untuk kampanye Aplikasi.

Kueri ini memungkinkan Anda melihat status setiap produk yang disertakan dalam kampanye tertentu, termasuk masalah yang menyebabkan status tersebut. Misalnya, kampanye yang dijeda memengaruhi status produk:

SELECT
  shopping_product.resource_name,
  shopping_product.campaign,
  campaign.name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product
WHERE
  shopping_product.campaign = 'customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>'

Status produk (Tingkat grup iklan)

Menentukan laporan dengan resource grup iklan dan resource kampanye sebagai bagian dari klausa WHERE akan menampilkan semua produk yang disertakan dalam kampanye yang dipilih. Metrik, status, dan masalah produk mencerminkan apakah produk tersebut disertakan atau dikecualikan dari grup iklan yang dipilih.

Fitur ini didukung oleh jenis kampanye berikut:

• Belanja
• Peningkat Permintaan
• Video
• Aplikasi (tersedia di v24 dan yang lebih baru; hanya mendukung metrik impressions, clicks, dan ctr, serta tidak mendukung status atau issues)

Kueri ini memungkinkan Anda melihat status produk sehubungan dengan grup iklan tersebut. Dengan fitur ini, Anda dapat mengonfirmasi bahwa filter grup produk (di tingkat grup iklan) diterapkan dengan benar dan memeriksa status setiap produk:

SELECT
  shopping_product.resource_name,
  shopping_product.campaign,
  campaign.name,
  shopping_product.ad_group,
  ad_group.name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product
WHERE
  shopping_product.campaign = 'customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>'
  AND shopping_product.ad_group =
    'customers/<CUSTOMER_ID>/adGroups/<AD_GROUP_ID>'

Catatan: Kampanye dan grup iklan harus ditentukan dalam klausa WHERE. Jika salah satu atau keduanya tidak ada, kueri akan menghasilkan salah satu error berikut: MISSING_CAMPAIGN_FILTER atau MISSING_AD_GROUP_FILTER.

Metrik produk, difilter menurut tanggal (Tingkat akun)

Menentukan laporan dengan tanggal atau rentang tanggal dalam klausa WHERE akan menampilkan metrik untuk semua produk di tingkat akun selama jangka waktu yang ditentukan, terlepas dari apakah metrik tersebut bukan nol.

Anda tidak dapat memilih segments.date; jika dilakukan, akan muncul error UNSUPPORTED_DATE_SEGMENTATION.

Kueri ini memungkinkan Anda melihat performa setiap produk untuk hari tertentu atau rentang tanggal lain yang kompatibel, yang digabungkan di semua kampanye:

SELECT
  shopping_product.resource_name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  metrics.clicks,
  metrics.impressions,
  metrics.cost_micros
FROM shopping_product
WHERE
  segments.date DURING LAST_30_DAYS

Performa produk dengan data keranjang

Pengiklan retail dapat mengakses metrik penjualan dan laba yang relevan seperti Pendapatan, Laba Kotor, Margin Laba Kotor, dan Unit terjual. Metrik ini tersedia untuk semua pengiklan yang menerapkan Konversi dengan data keranjang di seluruh kampanye Shopping dan kompatibel dengan laporan berikut:

• ad_group
• ad_group_ad
• campaign
• cart_data_sales_view (tersedia di v24 dan yang lebih baru)
• customer (Digabungkan untuk semua kampanye)
• product_group_view
• shopping_performance_view
• shopping_product (untuk metrik data keranjang metrics.all_* di v24 dan yang lebih baru)

Metrik data keranjang berikut dapat digunakan dalam laporan, seperti shopping_performance_view, untuk kampanye Shopping:

metrics.average_cart_size
metrics.average_order_value_micros
metrics.cost_of_goods_sold_micros
metrics.cross_sell_cost_of_goods_sold_micros
metrics.cross_sell_gross_profit_micros
metrics.cross_sell_revenue_micros
metrics.cross_sell_units_sold
metrics.gross_profit_margin
metrics.gross_profit_micros
metrics.lead_cost_of_goods_sold_micros
metrics.lead_gross_profit_micros
metrics.lead_revenue_micros
metrics.lead_units_sold
metrics.orders
metrics.revenue_micros
metrics.units_sold

Di v24 dan yang lebih baru, metrik data keranjang berikut juga tersedia untuk dilaporkan di semua konversi (termasuk konversi yang tidak dapat di-bid):

metrics.all_average_cart_size
metrics.all_average_order_value_micros
metrics.all_cost_of_goods_sold_micros
metrics.all_cross_sell_cost_of_goods_sold_micros
metrics.all_cross_sell_gross_profit_micros
metrics.all_cross_sell_revenue_micros
metrics.all_cross_sell_units_sold
metrics.all_gross_profit_margin
metrics.all_gross_profit_micros
metrics.all_lead_cost_of_goods_sold_micros
metrics.all_lead_gross_profit_micros
metrics.all_lead_revenue_micros
metrics.all_lead_units_sold
metrics.all_orders
metrics.all_revenue_micros
metrics.all_units_sold

Catatan: Metrik data keranjang tidak tersedia hingga konversi dicatat untuk produk terkait. Kueri terhadap shopping_performance_view dapat memerlukan waktu lebih lama untuk dieksekusi pada akun dengan jumlah produk yang besar, meskipun filter diterapkan.

Contoh berikut menunjukkan cara metrik data keranjang dapat digunakan untuk menganalisis performa tingkat produk untuk kampanye Shopping dalam 30 hari terakhir:

SELECT
  segments.product_item_id,
  segments.product_title,
  metrics.average_cart_size,
  metrics.average_order_value_micros,
  metrics.conversions,
  metrics.conversions_value,
  metrics.gross_profit_micros,
  metrics.gross_profit_margin,
  metrics.revenue_micros,
  metrics.units_sold,
  campaign.advertising_channel_type
FROM shopping_performance_view
WHERE campaign.advertising_channel_type = 'SHOPPING'
  AND segments.date DURING LAST_30_DAYS
  AND metrics.conversions > 0
ORDER BY
  metrics.gross_profit_margin DESC,
  metrics.revenue_micros DESC,
  metrics.conversions_value DESC

Performa kampanye dengan data keranjang

Metrik data keranjang dapat digunakan di tingkat kampanye dan dapat digabungkan dengan metrik performa lainnya seperti tayangan iklan, klik, dan biaya:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.cost_micros,
  metrics.average_order_value_micros,
  metrics.gross_profit_micros,
  metrics.gross_profit_margin
FROM campaign
WHERE campaign.advertising_channel_type = 'SHOPPING'
  AND segments.date DURING LAST_30_DAYS
ORDER BY
  metrics.gross_profit_margin DESC,
  metrics.average_order_value_micros DESC,
  metrics.cost_micros DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC

Tampilan aset perluasan URL Final

Mulai v26, Anda dapat menggunakan final_url_expansion_asset_view untuk mengukur performa tingkat aset untuk aset penyesuaian teks yang ditayangkan di kampanye Shopping saat AI Maksimal (campaign.ai_max_setting.enable_ai_max = true) dan perluasan URL Final (FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN) diaktifkan.

Saat membuat kueri final_url_expansion_asset_view, ikuti aturan pemfilteran dan pemilihan kolom berikut:

• Kueri di final_url_expansion_asset_view harus memfilter setidaknya salah satu dari campaign.advertising_channel_type, campaign (campaign.id, campaign.resource_name, atau final_url_expansion_asset_view.campaign), atau ad_group (ad_group.id, ad_group.resource_name, atau final_url_expansion_asset_view.ad_group); jika semuanya dihilangkan, akan menampilkan FinalUrlExpansionAssetViewError.MISSING_REQUIRED_FILTER.
• Saat mengkueri final_url_expansion_asset_view untuk kampanye Shopping di tingkat akun atau kampanye, Anda harus memfilter menurut campaign.advertising_channel_type = 'SHOPPING' (atau memfilter menurut satu grup iklan menggunakan =). Pemfilteran menurut kampanye (campaign.id, campaign.resource_name, atau final_url_expansion_asset_view.campaign) juga memerlukan campaign.advertising_channel_type = 'SHOPPING'; jika dihilangkan, FinalUrlExpansionAssetViewError.REQUIRES_ADVERTISING_CHANNEL_TYPE_FILTER akan ditampilkan, sedangkan pemfilteran menurut satu ad_group akan memenuhi persyaratan filter dengan sendirinya.
• Filter pada campaign.advertising_channel_type, campaign, atau ad_group harus menggunakan operator = pada satu nilai; menggunakan IN atau beberapa kondisi untuk jenis resource yang sama akan menampilkan FinalUrlExpansionAssetViewError.REQUIRES_FILTER_BY_SINGLE_RESOURCE.
• Untuk kampanye Shopping, Anda dapat memilih dan memfilter menurut kolom ad_group, tetapi Anda tidak dapat memilih kolom asset_group. Memilih kolom asset_group di kampanye Shopping (atau saat memfilter menurut ad_group) akan menampilkan FinalUrlExpansionAssetViewError.CANNOT_SELECT_ASSET_GROUP (atau CANNOT_SELECT_BOTH_AD_GROUP_AND_ASSET_GROUP jika kolom ad_group juga dipilih). Pemfilteran menurut asset_group saat memilih kolom ad_group akan menampilkan CANNOT_SELECT_AD_GROUP, dan pemfilteran menurut ad_group dan asset_group akan menampilkan CANNOT_FILTER_BY_BOTH_AD_GROUP_AND_ASSET_GROUP.

Kueri berikut mengambil metrik performa tingkat aset untuk kampanye Shopping selama 30 hari terakhir:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  ad_group.id,
  final_url_expansion_asset_view.asset,
  final_url_expansion_asset_view.field_type,
  final_url_expansion_asset_view.final_url,
  final_url_expansion_asset_view.status,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions
FROM final_url_expansion_asset_view
WHERE
  campaign.advertising_channel_type = 'SHOPPING'
  AND segments.date DURING LAST_30_DAYS