Khắc phục sự cố liên quan đến Merchant Promotions API

Trang này mô tả cách khắc phục các vấn đề liên quan đến Merchant Promotions API.

Tạo chương trình quảng cáo

Khi sử dụng yêu cầu accounts.promotions.insert để chèn chương trình khuyến mãi, hãy đảm bảo rằng bạn đã thêm tất cả các trường bắt buộc vào nội dung yêu cầu. Các trường sau đây là bắt buộc:

  • 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

Khoảng thời gian có hiệu lực của chương trình khuyến mãi không hợp lệ

Nếu cung cấp ngày bắt đầu áp dụng chương trình khuyến mãi không hợp lệ trong yêu cầu accounts.promotions.insert, bạn sẽ thấy thông báo lỗi sau:

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

Để khắc phục lỗi này, hãy đảm bảo rằng giá trị được cung cấp cho trường promotionDisplayTimePeriod.startTime giống hoặc trước giá trị được cung cấp cho trường promotionEffectiveTimePeriod.startTime. Ngoài ra, hãy đảm bảo giá trị được cung cấp cho trường promotionDisplayTimePeriod.endTime giống hoặc trước giá trị được cung cấp cho trường promotionEffectiveTimePeriod.endTime.

Giá trị cho các trường startTime và endTime phải ở định dạng UTC RFC3339, tức là yyyy-mm-ddThh:mm:ssZ. Ví dụ: 2024-08-15T18:20:20Z

Bạn chưa chỉ định số lượng hàng tối thiểu phải mua

Nếu attributes.couponValueType là BUY_M_GET_N_PERCENT_OFF hoặc BUY_M_GET_N_MONEY_OFF, bạn phải cung cấp giá trị cho trường attributes.minimumPurchaseQuantity trong yêu cầu accounts.promotions.insert.

Nếu không cung cấp giá trị cho trường attributes.minimumPurchaseQuantity trong yêu cầu accounts.promotions.insert, bạn sẽ thấy thông báo lỗi sau:

[minimumPurchaseQuantity] Missing benefit or restriction attributes for its type

Để khắc phục lỗi này, hãy đảm bảo rằng bạn cung cấp giá trị cho trường minimumPurchaseQuantity trong yêu cầu.

Chưa chỉ định số tiền giảm giá

Nếu giá trị của trường attributes.couponValueType là MONEY_OFF, bạn phải cung cấp giá trị cho trường attributes.moneyOffAmount trong yêu cầu accounts.promotions.insert.

Nếu không cung cấp giá trị cho trường attributes.moneyOffAmount trong yêu cầu accounts.promotions.insert, bạn sẽ thấy thông báo lỗi sau:

[moneyOffAmount] Missing benefit or restriction attributes for its type

Để khắc phục lỗi này, hãy đảm bảo rằng bạn cung cấp giá trị cho trường attributes.moneyOffAmount trong yêu cầu. Số tiền phải được tính bằng micro.

Không nêu rõ nội dung mô tả quà tặng miễn phí

Nếu giá trị của trường attributes.couponValueType là FREE_GIFT, bạn phải cung cấp giá trị cho trường attributes.freeGiftDescription trong yêu cầu accounts.promotions.insert.

Nếu không cung cấp giá trị cho trường attributes.freeGiftDescription trong yêu cầu accounts.promotions.insert, bạn sẽ thấy thông báo lỗi sau:

[freeGiftDescription] Missing benefit or restriction attributes for its type

Để khắc phục lỗi này, hãy đảm bảo rằng bạn cung cấp giá trị cho trường attributes.freeGiftDescription trong yêu cầu.

Không hỗ trợ vận chuyển miễn phí cho chương trình khuyến mãi tại địa phương

Nếu giá trị của trường redemptionChannel là IN_STORE và giá trị của trường attributes.couponValueType là FREE_SHIPPING_STANDARD, FREE_SHIPPING_OVERNIGHT hoặc FREE_SHIPPING_TWO_DAY, bạn sẽ thấy thông báo lỗi sau:

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

Để khắc phục lỗi này, hãy đảm bảo giá trị của trường redemptionChannel là ONLINE.

Chưa chỉ định kênh sử dụng ưu đãi

Nếu giá trị của trường redemptionChannel không được chỉ định trong yêu cầu accounts.promotions.insert, bạn sẽ thấy thông báo lỗi sau:

[redemptionChannel] Required parameter: redemptionChannel

Để khắc phục lỗi này, hãy đảm bảo rằng bạn cung cấp giá trị cho trường redemptionChannel trong yêu cầu.

Trường contentLanguage của chương trình khuyến mãi và nguồn dữ liệu không khớp

Nếu giá trị của trường contentLanguage không giống với giá trị của trường contentLanguage của nguồn dữ liệu khuyến mãi mà bạn đang sử dụng trong yêu cầu accounts.promotions.insert, bạn sẽ thấy thông báo lỗi sau:

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

Để khắc phục lỗi này, hãy đảm bảo rằng giá trị của trường contentLanguage giống với giá trị của trường contentLanguage trong nguồn dữ liệu chương trình khuyến mãi mà bạn đang sử dụng.

Bạn cũng sẽ thấy lỗi này nếu giá trị của targetCountry không giống với giá trị của trường targetCountry trong nguồn dữ liệu chương trình khuyến mãi mà bạn đang sử dụng.

Tìm hiểu thêm