Khắc phục sự cố liên quan đến API phụ Chương trình khuyến mãi

Trang này mô tả cách khắc phục các vấn đề liên quan đến API phụ Chương trình khuyến mãi.

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

Khi sử dụng yêu cầu accounts.promotions.insert để chèn một 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. Bạn bắt buộc phải điền các trường sau:

  • 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 khuyến mãi có hiệu lực không hợp lệ

Nếu cung cấp ngày có hiệu lực không hợp lệ của chương trình khuyến mãi 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ị bạn cung cấp cho trường promotionDisplayTimePeriod.startTime giống hoặc trước giá trị bạn cung cấp cho trường promotionEffectiveTimePeriod.startTime. Ngoài ra, hãy đảm bảo rằng giá trị bạn cung cấp cho trường promotionDisplayTimePeriod.endTime giống hoặc trước giá trị bạn cung cấp cho trường promotionEffectiveTimePeriod.endTime.

Giá trị cho các trường startTime và endTime phải ở định dạng RFC3339 UTC, 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 một 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

Để giải quyết lỗi này, hãy đảm bảo rằng bạn cung cấp một giá trị cho trường minimumPurchaseQuantity trong yêu cầu của mình.

Bạn 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

Để giải quyết lỗi này, hãy đảm bảo rằng bạn cung cấp một giá trị cho trường attributes.moneyOffAmount trong yêu cầu của mình. Số tiền phải ở dạng phần triệu.

Không chỉ định 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

Để giải quyết lỗi này, hãy đảm bảo rằng bạn cung cấp một giá trị cho trường attributes.freeGiftDescription trong yêu cầu của mình.

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

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, thì bạn sẽ thấy thông báo lỗi sau:

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

Để giải quyết lỗi này, hãy đảm bảo rằng giá trị của trường redemptionChannel là ONLINE.

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

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

[redemptionChannel] Required parameter: redemptionChannel

Để giải quyết lỗi này, hãy đảm bảo rằng bạn cung cấp một giá trị cho trường redemptionChannel trong yêu cầu của mình.

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

Nếu giá trị của trường contentLanguage không giống với giá trị của trường contentLanguage trong nguồn dữ liệu khuyến mãi mà bạn đang sử dụng trong yêu cầu accounts.promotions.insert, thì 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

Để giải quyết 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 khuyến mãi mà bạn đang sử dụng.

Bạn cũng sẽ gặp 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 khuyến mãi mà bạn đang sử dụng.

Tìm hiểu thêm