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ụ về 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. 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 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'

Để giải quyết 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 rằng 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ị của 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.

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

Để giải quyết 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 hạ 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 giá trị cho trường attributes.moneyOffAmount trong yêu cầu. Số tiền phải được tính bằng phần triệu.

Chưa 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 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

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

Chưa chỉ định kênh áp dụng

Nếu bạn chưa 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 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 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, 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ẽ 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 khuyến mãi mà bạn đang sử dụng.

Tìm hiểu thêm