Memecahkan masalah terkait sub-API Promosi

Halaman ini menjelaskan cara memecahkan masalah terkait sub-API Promosi.

Buat promosi

Saat menggunakan permintaan accounts.promotions.insert untuk menyisipkan promosi, pastikan Anda telah menyertakan semua kolom yang diperlukan dalam isi permintaan. Kolom berikut wajib diisi:

  • promotion.promotionId
  • promotion.contentLanguage
  • promotion.redemptionChannel
  • promotion.targetCountry
  • promotion.attributes.longTitle
  • promotion.attributes.promotionEffectiveTimePeriod.startTime
  • promotion.attributes.promotionEffectiveTimePeriod.endTime
  • promotion.attributes.promotionDestinations
  • promotion.attributes.couponValueType
  • promotion.attributes.offerType
  • promotion.attributes.productApplicability
  • promotion.attributes.promotionUrl

Periode waktu berlaku promosi tidak valid

Jika Anda memberikan tanggal mulai promosi yang tidak valid dalam permintaan accounts.promotions.insert, Anda akan melihat pesan error berikut:

Invalid value at 'promotion.attributes.promotion_effective_time_period.start_time'

Untuk mengatasi error ini, pastikan nilai yang diberikan untuk kolom promotionDisplayTimePeriod.startTime sama dengan atau sebelum nilai yang diberikan untuk kolom promotionEffectiveTimePeriod.startTime. Pastikan juga nilai yang diberikan untuk kolom promotionDisplayTimePeriod.endTime sama atau sebelum nilai yang diberikan untuk kolom promotionEffectiveTimePeriod.endTime.

Nilai untuk kolom startTime dan endTime harus dalam format UTC RFC3339, yaitu yyyy-mm-ddThh:mm:ssZ. Misalnya, 2024-08-15T18:20:20Z.

Jumlah pembelian minimum tidak ditentukan

Jika attributes.couponValueType adalah BUY_M_GET_N_PERCENT_OFF atau BUY_M_GET_N_MONEY_OFF, Anda harus memberikan nilai untuk kolom attributes.minimumPurchaseQuantity dalam permintaan accounts.promotions.insert.

Jika tidak memberikan nilai untuk kolom attributes.minimumPurchaseQuantity dalam permintaan accounts.promotions.insert, Anda akan melihat pesan error berikut:

[minimumPurchaseQuantity] Missing benefit or restriction attributes for its type

Untuk mengatasi error ini, pastikan Anda memberikan nilai untuk kolom minimumPurchaseQuantity dalam permintaan.

Jumlah potongan harga tidak ditentukan

Jika nilai kolom attributes.couponValueType adalah MONEY_OFF, Anda harus memberikan nilai untuk kolom attributes.moneyOffAmount dalam permintaan accounts.promotions.insert.

Jika tidak memberikan nilai untuk kolom attributes.moneyOffAmount dalam permintaan accounts.promotions.insert, Anda akan melihat pesan error berikut:

[moneyOffAmount] Missing benefit or restriction attributes for its type

Untuk mengatasi error ini, pastikan Anda memberikan nilai untuk kolom attributes.moneyOffAmount dalam permintaan. Jumlah harus dalam mikro.

Deskripsi hadiah gratis tidak ditentukan

Jika nilai kolom attributes.couponValueType adalah FREE_GIFT, Anda harus memberikan nilai untuk kolom attributes.freeGiftDescription dalam permintaan accounts.promotions.insert.

Jika tidak memberikan nilai untuk kolom attributes.freeGiftDescription dalam permintaan accounts.promotions.insert, Anda akan melihat pesan error berikut:

[freeGiftDescription] Missing benefit or restriction attributes for its type

Untuk mengatasi error ini, pastikan Anda memberikan nilai untuk kolom attributes.freeGiftDescription dalam permintaan.

Pengiriman gratis tidak didukung untuk promosi lokal

Jika nilai kolom redemptionChannel adalah IN_STORE dan nilai kolom attributes.couponValueType adalah FREE_SHIPPING_STANDARD, FREE_SHIPPING_OVERNIGHT, atau FREE_SHIPPING_TWO_DAY, Anda akan melihat pesan error berikut:

[shippingServiceNames] Free shipping types are not supported for local promotions

Untuk mengatasi error ini, pastikan nilai kolom redemptionChannel adalah ONLINE.

Saluran penukaran tidak ditentukan

Jika nilai kolom redemptionChannel tidak ditentukan dalam permintaan accounts.promotions.insert, Anda akan melihat pesan error berikut:

[redemptionChannel] Required parameter: redemptionChannel

Untuk mengatasi error ini, pastikan Anda memberikan nilai untuk kolom redemptionChannel dalam permintaan.

Kolom contentLanguage promosi dan sumber data tidak cocok

Jika nilai kolom contentLanguage tidak sama dengan nilai kolom contentLanguage dari sumber data promosi yang Anda gunakan dalam permintaan accounts.promotions.insert, Anda akan melihat pesan error berikut:

[promotion] Could not find the proper data target for the provided feedLabel and contentLanguage

Untuk mengatasi error ini, pastikan nilai kolom contentLanguage sama dengan nilai kolom contentLanguage dari sumber data promosi yang Anda gunakan.

Anda juga akan melihat error ini jika nilai targetCountry tidak sama dengan nilai kolom targetCountry dari sumber data promosi yang Anda gunakan.

Pelajari lebih lanjut