Rozwiązywanie problemów związanych z podrzędnym interfejsem API promocji

Na tej stronie dowiesz się, jak rozwiązywać problemy związane z podrzędnym interfejsem API promocji.

Utwórz promocję

Gdy używasz żądania accounts.promotions.insert do wstawiania promocji, upewnij się, że w treści żądania znajdują się wszystkie wymagane pola. Wymagane są te pola:

  • 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

Nieprawidłowy okres obowiązywania promocji

Jeśli w żądaniu accounts.promotions.insert podasz nieprawidłowe daty obowiązywania promocji, zobaczysz ten komunikat o błędzie:

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

Aby rozwiązać ten problem, upewnij się, że wartość podana w polu promotionDisplayTimePeriod.startTime jest taka sama jak wartość podana w polu promotionEffectiveTimePeriod.startTime lub wcześniejsza. Upewnij się też, że wartość podana w polu promotionDisplayTimePeriod.endTime jest taka sama jak wartość podana w polu promotionEffectiveTimePeriod.endTime lub wcześniejsza.

Wartości pól startTime i endTime muszą być w formacie RFC3339 UTC, czyli yyyy-mm-ddThh:mm:ssZ. Na przykład 2024-08-15T18:20:20Z.

Nie określono minimalnej ilości do zakupu

Jeśli wartość attributes.couponValueType to BUY_M_GET_N_PERCENT_OFF lub BUY_M_GET_N_MONEY_OFF, w żądaniu accounts.promotions.insert musisz podać wartość pola attributes.minimumPurchaseQuantity.

Jeśli w żądaniu accounts.promotions.insert nie podasz wartości pola attributes.minimumPurchaseQuantity, zobaczysz ten komunikat o błędzie:

[minimumPurchaseQuantity] Missing benefit or restriction attributes for its type

Aby rozwiązać ten problem, upewnij się, że w żądaniu podajesz wartość pola minimumPurchaseQuantity.

Nie określono kwoty rabatu

Jeśli wartość pola attributes.couponValueType to MONEY_OFF, w żądaniu accounts.promotions.insert musisz podać wartość pola attributes.moneyOffAmount.

Jeśli w żądaniu accounts.promotions.insert nie podasz wartości pola attributes.moneyOffAmount, zobaczysz ten komunikat o błędzie:

[moneyOffAmount] Missing benefit or restriction attributes for its type

Aby rozwiązać ten problem, upewnij się, że w żądaniu podajesz wartość pola attributes.moneyOffAmount. Kwota musi być podana w mikrojednostkach.

Nie określono opisu prezentu

Jeśli wartość pola attributes.couponValueType to FREE_GIFT, w żądaniu accounts.promotions.insert musisz podać wartość pola attributes.freeGiftDescription.

Jeśli w żądaniu accounts.promotions.insert nie podasz wartości pola attributes.freeGiftDescription, zobaczysz ten komunikat o błędzie:

[freeGiftDescription] Missing benefit or restriction attributes for its type

Aby rozwiązać ten problem, upewnij się, że w żądaniu podajesz wartość pola attributes.freeGiftDescription.

Bezpłatna dostawa nie jest obsługiwana w przypadku promocji lokalnych

Jeśli wartość pola redemptionChannel to IN_STORE, a wartość pola attributes.couponValueType to FREE_SHIPPING_STANDARD, FREE_SHIPPING_OVERNIGHT lub FREE_SHIPPING_TWO_DAY, zobaczysz ten komunikat o błędzie:

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

Aby rozwiązać ten problem, upewnij się, że wartość pola redemptionChannel to ONLINE.

Nie określono kanału realizacji

Jeśli w żądaniu accounts.promotions.insert nie określisz wartości pola redemptionChannel, zobaczysz ten komunikat o błędzie:

[redemptionChannel] Required parameter: redemptionChannel

Aby rozwiązać ten problem, upewnij się, że w żądaniu podajesz wartość pola redemptionChannel.

Pole contentLanguage promocji i źródła danych nie są zgodne

Jeśli wartość pola contentLanguage nie jest taka sama jak wartość pola contentLanguage źródła danych o promocjach , którego używasz w żądaniu accounts.promotions.insert, zobaczysz ten komunikat o błędzie:

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

Aby rozwiązać ten problem, upewnij się, że wartość pola contentLanguage jest taka sama jak wartość pola contentLanguage źródła danych o promocjach, którego używasz.

Ten błąd zobaczysz też, jeśli wartość pola targetCountry nie jest taka sama jak wartość pola targetCountry źródła danych o promocjach, którego używasz.

Więcej informacji

Wstecz
Overview