- Referensi: Promosi
- RedemptionChannel
- Atribut
- ProductApplicability
- OfferType
- CouponValueType
- DestinationEnum
- StoreApplicability
- PromotionStatus
- DestinationStatus
- Status
- ItemLevelIssue
- Keparahan
- Metode
Referensi: Promosi
Mewakili promosi. Lihat artikel berikut untuk detail selengkapnya.
Atribut input promosi yang diperlukan agar lulus pemeriksaan validasi data terutama didefinisikan di bawah:
Setelah menyisipkan dan memperbarui input promosi, mungkin perlu waktu beberapa menit sebelum promosi akhir dapat diambil.
Representasi JSON |
---|
{ "name": string, "promotionId": string, "contentLanguage": string, "targetCountry": string, "redemptionChannel": [ enum ( |
Kolom | |
---|---|
name |
ID. Nama promosi. Format: |
promotionId |
Wajib diisi. Pengguna memberikan ID promosi untuk mengidentifikasi promosi secara unik. Ikuti persyaratan minimum untuk mencegah penolakan promosi. |
contentLanguage |
Wajib diisi. Kode bahasa dua huruf ISO 639-1 untuk promosi. Promosi hanya untuk bahasa tertentu. |
targetCountry |
Wajib diisi. Negara target yang digunakan sebagai bagian dari ID unik. Direpresentasikan sebagai kode wilayah CLDR. Promosi hanya tersedia di negara tertentu, Listingan Gratis dan iklan Shopping iklan Inventaris Lokal |
redemptionChannel[] |
Wajib diisi. Saluran penukaran untuk promosi. Minimal satu channel diperlukan. |
dataSource |
Hanya output. Sumber data utama promosi. |
attributes |
Opsional. Daftar atribut promosi. |
customAttributes[] |
Opsional. Daftar atribut khusus (disediakan penjual). Atribut ini juga dapat digunakan untuk mengirimkan atribut spesifikasi data apa pun dalam bentuk generiknya (misalnya, |
promotionStatus |
Hanya output. Status promosi, masalah validasi data, yaitu, informasi tentang promosi yang dihitung secara asinkron. |
versionNumber |
Opsional. Merepresentasikan versi (keaktualan) promosi yang ada, yang dapat digunakan untuk mempertahankan urutan yang benar saat beberapa update dilakukan secara bersamaan. Jika ditetapkan, penyisipan akan dicegah saat nomor versi lebih rendah dari nomor versi promosi yang sudah ada saat ini. Penyisipan ulang (misalnya, pembaruan promosi setelah 30 hari) dapat dilakukan dengan Jika operasi dicegah, pengecualian yang dibatalkan akan ditampilkan. |
RedemptionChannel
Saluran promosi.
Enum | |
---|---|
REDEMPTION_CHANNEL_UNSPECIFIED |
Menunjukkan bahwa saluran tidak ditentukan. |
IN_STORE |
Menunjukkan bahwa channel ada di toko. Ini sama dengan saluran local yang digunakan untuk products . |
ONLINE |
Menunjukkan bahwa channel sedang online. |
Atribut
Atribut.
Representasi JSON |
---|
{ "productApplicability": enum ( |
Kolom | |
---|---|
productApplicability |
Wajib diisi. Pemberlakuan promosi ke semua produk atau produk tertentu saja. |
offerType |
Wajib diisi. Jenis promosi. Gunakan atribut ini untuk menunjukkan apakah pelanggan memerlukan kode kupon atau tidak untuk menukarkan promosi Anda. |
genericRedemptionCode |
Opsional. Kode penukaran umum untuk promosi. Untuk digunakan dengan kolom |
longTitle |
Wajib diisi. Judul panjang untuk promosi. |
couponValueType |
Wajib diisi. Atribut coupon value type untuk menandakan jenis promosi yang Anda jalankan. Bergantung pada jenis nilai kupon yang dipilih, beberapa atribut diperlukan. |
promotionDestinations[] |
Wajib diisi. Daftar tujuan tempat promosi berlaku. Jika Anda tidak menentukan tujuan dengan menyertakan nilai yang didukung di sumber data, promosi Anda secara default akan ditampilkan di iklan Shopping dan listingan gratis. Anda mungkin sebelumnya telah mengirimkan nilai berikut sebagai tujuan untuk produk Anda: Shopping Actions, Platform Google, platform Google lokal. Untuk mewakili nilai ini, gunakan |
itemIdInclusion[] |
Opsional. Filter produk menurut ID item untuk promosi. Atribut filter produk hanya berlaku jika atribut kelayakan produk untuk promosi |
brandInclusion[] |
Opsional. Filter produk menurut merek untuk promosi. Atribut filter produk hanya berlaku jika atribut kelayakan produk untuk promosi |
itemGroupIdInclusion[] |
Opsional. Filter produk menurut ID kelompok item untuk promosi. Atribut filter produk hanya berlaku jika atribut kelayakan produk untuk promosi keberlakuan produk [productApplicability] ditetapkan ke specific_products. |
productTypeInclusion[] |
Opsional. Filter produk menurut tipe produk untuk promosi. Atribut filter produk hanya berlaku jika atribut kelayakan produk untuk promosi |
itemIdExclusion[] |
Opsional. Filter produk menurut pengecualian ID item untuk promosi. Atribut filter produk hanya berlaku jika atribut kelayakan produk untuk promosi |
brandExclusion[] |
Opsional. Filter produk menurut pengecualian merek untuk promosi. Atribut filter produk hanya berlaku jika atribut kelayakan produk untuk promosi |
itemGroupIdExclusion[] |
Opsional. Filter produk menurut ID kelompok item. Atribut filter produk hanya berlaku jika atribut kelayakan produk untuk promosi |
productTypeExclusion[] |
Opsional. Filter produk menurut pengecualian tipe produk untuk promosi. Atribut filter produk hanya berlaku jika atribut kelayakan produk untuk promosi |
minimumPurchaseAmount |
Opsional. Jumlah pembelian minimum untuk promosi. |
minimumPurchaseQuantity |
Opsional. Jumlah pembelian minimum untuk promosi. |
limitQuantity |
Opsional. Jumlah pembelian maksimum untuk promosi. |
limitValue |
Opsional. Harga produk maksimum untuk promosi. |
percentOff |
Opsional. Diskon persentase yang ditawarkan dalam promosi. |
moneyOffAmount |
Opsional. Jumlah potongan harga yang ditawarkan dalam promosi. |
getThisQuantityDiscounted |
Opsional. Jumlah item yang didiskon dalam promosi. Atribut ditetapkan jika |
freeGiftValue |
Opsional. Nilai hadiah gratis untuk promosi. |
freeGiftDescription |
Opsional. Deskripsi hadiah gratis untuk promosi. |
freeGiftItemId |
Opsional. ID item hadiah gratis untuk promosi. |
promotionEffectiveTimePeriod |
Wajib diisi. Representasi |
promotionDisplayTimePeriod |
Opsional. Representasi |
storeApplicability |
Opsional. Apakah promosi berlaku untuk semua toko, atau hanya toko tertentu. Promosi iklan Inventaris Lokal akan menampilkan error jika tidak ada penerapan toko yang disertakan. Error |
storeCodesInclusion[] |
Opsional. Kode toko yang akan disertakan untuk promosi. Atribut filter toko hanya berlaku jika atribut Kode toko (ID toko dari Profil Bisnis Anda) untuk toko fisik tempat produk dijual. Lihat Spesifikasi data inventaris produk lokal untuk mengetahui informasi selengkapnya. |
storeCodesExclusion[] |
Opsional. Kode toko yang akan dikecualikan untuk promosi. Atribut filter toko hanya berlaku jika atribut |
promotionUrl |
Opsional. URL ke halaman di situs penjual tempat promosi ditampilkan. Promosi iklan Inventaris Lokal akan menampilkan error jika tidak ada |
ProductApplicability
Produk atau daftar produk yang memiliki promosi.
Enum | |
---|---|
PRODUCT_APPLICABILITY_UNSPECIFIED |
Produk tempat promosi berlaku tidak diketahui. |
ALL_PRODUCTS |
Berlaku untuk semua produk. |
SPECIFIC_PRODUCTS |
Berlaku hanya untuk satu produk atau daftar produk. |
OfferType
Jenis penawaran promosi.
Enum | |
---|---|
OFFER_TYPE_UNSPECIFIED |
Jenis penawaran tidak diketahui. |
NO_CODE |
Jenis penawaran tanpa kode. |
GENERIC_CODE |
Jenis penawaran dengan kode. Kode penukaran umum untuk promosi wajib diisi jika offerType = GENERIC_CODE . |
CouponValueType
Jenis nilai kupon promosi.
Enum | |
---|---|
COUPON_VALUE_TYPE_UNSPECIFIED |
Menunjukkan bahwa jenis nilai kupon tidak ditentukan. |
MONEY_OFF |
Jenis nilai kupon potongan harga. |
PERCENT_OFF |
Jenis nilai kupon diskon persen. |
BUY_M_GET_N_MONEY_OFF |
Beli jumlah M, dapatkan jenis nilai kupon diskon N. minimumPurchaseQuantity dan getThisQuantityDiscounted harus ada. moneyOffAmount juga harus ada. |
BUY_M_GET_N_PERCENT_OFF |
Beli jumlah M, dapatkan jenis nilai kupon diskon N persen. minimumPurchaseQuantity dan getThisQuantityDiscounted harus ada. percent_off_percentage juga harus ada. |
BUY_M_GET_MONEY_OFF |
Beli jumlah M, dapatkan potongan harga. minimumPurchaseQuantity dan moneyOffAmount harus ada. |
BUY_M_GET_PERCENT_OFF |
Beli jumlah M, dapatkan potongan harga. minimumPurchaseQuantity dan percent_off_percentage harus ada. |
FREE_GIFT |
Hadiah gratis dengan deskripsi saja. |
FREE_GIFT_WITH_VALUE |
Hadiah gratis dengan nilai uang. |
FREE_GIFT_WITH_ITEM_ID |
Hadiah gratis dengan ID item. |
FREE_SHIPPING_STANDARD |
Jenis nilai kupon pengiriman gratis standar. |
FREE_SHIPPING_OVERNIGHT |
Jenis nilai kupon pengiriman gratis semalam. |
FREE_SHIPPING_TWO_DAY |
Jenis nilai kupon pengiriman gratis selama dua hari. |
DestinationEnum
Nilai tujuan.
Enum | |
---|---|
DESTINATION_ENUM_UNSPECIFIED |
Tidak ditentukan. |
SHOPPING_ADS |
Iklan Shopping. |
DISPLAY_ADS |
Iklan Display. |
LOCAL_INVENTORY_ADS |
Iklan inventaris lokal. |
FREE_LISTINGS |
Listingan gratis. |
FREE_LOCAL_LISTINGS |
Listingan produk lokal gratis. |
YOUTUBE_SHOPPING |
YouTube Shopping. |
StoreApplicability
Kode toko atau daftar kode toko tempat promosi berlaku. Hanya untuk promosi Iklan inventaris lokal.
Enum | |
---|---|
STORE_APPLICABILITY_UNSPECIFIED |
Kode toko tempat promosi berlaku tidak diketahui. |
ALL_STORES |
Promosi berlaku untuk semua toko. |
SPECIFIC_STORES |
Promosi hanya berlaku untuk toko yang ditentukan. |
PromotionStatus
Status promosi.
Representasi JSON |
---|
{ "destinationStatuses": [ { object ( |
Kolom | |
---|---|
destinationStatuses[] |
Hanya output. Tujuan yang dimaksud untuk promosi. |
itemLevelIssues[] |
Hanya output. Daftar masalah yang terkait dengan promosi. |
creationDate |
Hanya output. Tanggal promosi dibuat dalam format ISO 8601: Tanggal, waktu, dan offset, misalnya |
lastUpdateDate |
Hanya output. Tanggal saat status promosi terakhir diperbarui dalam format ISO 8601: Tanggal, waktu, dan offset, misalnya |
DestinationStatus
Status untuk tujuan yang ditentukan.
Representasi JSON |
---|
{ "reportingContext": enum ( |
Kolom | |
---|---|
reportingContext |
Hanya output. Nama tujuan promosi. |
status |
Hanya output. Status untuk tujuan yang ditentukan. |
Negara Bagian
Status promosi saat ini.
Enum | |
---|---|
STATE_UNSPECIFIED |
Status promosi tidak diketahui. |
IN_REVIEW |
Promosi sedang dalam peninjauan. |
REJECTED |
Promosi tidak disetujui. |
LIVE |
Promosi telah disetujui dan aktif. |
STOPPED |
Promosi dihentikan oleh penjual. |
EXPIRED |
Promosi tidak aktif lagi. |
PENDING |
Promosi tidak dihentikan, dan semua ulasan disetujui, tetapi tanggal aktifnya akan datang di masa mendatang. |
ItemLevelIssue
Masalah yang terkait dengan promosi.
Representasi JSON |
---|
{ "code": string, "severity": enum ( |
Kolom | |
---|---|
code |
Hanya output. Kode error masalah. |
severity |
Hanya output. Pengaruh masalah ini terhadap penayangan promosi. |
resolution |
Hanya output. Apakah masalah dapat diselesaikan oleh penjual. |
attribute |
Hanya output. Nama atribut, jika masalah disebabkan oleh satu atribut. |
reportingContext |
Hanya output. Tujuan tempat masalah terjadi. |
description |
Hanya output. Deskripsi masalah singkat dalam bahasa Inggris. |
detail |
Hanya output. Deskripsi masalah mendetail dalam bahasa Inggris. |
documentation |
Hanya output. URL halaman web untuk membantu menyelesaikan masalah ini. |
applicableCountries[] |
Hanya output. Daftar kode negara (ISO 3166-1 alpha-2) tempat masalah berlaku untuk penawaran. |
Keparahan
Tingkat keparahan masalah.
Enum | |
---|---|
SEVERITY_UNSPECIFIED |
Tidak ditentukan. |
NOT_IMPACTED |
Masalah ini merupakan peringatan dan tidak berdampak langsung terhadap promosi. |
DEMOTED |
Promosi tersebut didemosikan dan kemungkinan besar memiliki performa terbatas di hasil penelusuran |
DISAPPROVED |
Masalah tidak menyetujui promosi. |
Metode |
|
---|---|
|
Mengambil promosi dari akun Merchant Center Anda. |
|
Menyisipkan promosi untuk akun Merchant Center Anda. |
|
Mencantumkan promosi di akun Merchant Center. |