Probleme im Zusammenhang mit der Promotions-Unter-API beheben

Auf dieser Seite wird beschrieben, wie Sie Probleme mit der Promotions-Unter-API beheben.

Werbeaktion erstellen

Wenn Sie mit der Anfrage accounts.promotions.insert ein Angebot einfügen, müssen Sie alle erforderlichen Felder im Anfragetext angeben. Die folgenden Felder sind Pflichtfelder:

  • 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

Ungültiger Gültigkeitszeitraum des Angebots

Wenn Sie in Ihrer accounts.promotions.insert-Anfrage ungültige Gültigkeitsdaten für das Angebot angeben, wird die folgende Fehlermeldung angezeigt:

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

Achten Sie zur Behebung dieses Fehlers darauf, dass der für das Feld promotionDisplayTimePeriod.startTime angegebene Wert mit dem für das Feld promotionEffectiveTimePeriod.startTime angegebenen Wert identisch ist oder vor diesem liegt. Achten Sie außerdem darauf, dass der für das Feld promotionDisplayTimePeriod.endTime angegebene Wert mit dem für das Feld promotionEffectiveTimePeriod.endTime angegebenen Wert identisch ist oder vor diesem liegt.

Die Werte für die Felder startTime und endTime müssen im RFC3339-UTC-Format angegeben werden, also yyyy-mm-ddThh:mm:ssZ. Zum Beispiel: 2024-08-15T18:20:20Z.

Mindestbestellmenge nicht angegeben

Wenn Ihr attributes.couponValueType BUY_M_GET_N_PERCENT_OFF oder BUY_M_GET_N_MONEY_OFF ist, müssen Sie in Ihrer accounts.promotions.insert-Anfrage einen Wert für das Feld attributes.minimumPurchaseQuantity angeben.

Wenn Sie in Ihrer accounts.promotions.insert-Anfrage keinen Wert für das Feld attributes.minimumPurchaseQuantity angeben, wird die folgende Fehlermeldung angezeigt:

[minimumPurchaseQuantity] Missing benefit or restriction attributes for its type

Um diesen Fehler zu beheben, müssen Sie in Ihrer Anfrage einen Wert für das Feld minimumPurchaseQuantity angeben.

Rabattbetrag nicht angegeben

Wenn der Wert des Felds attributes.couponValueType MONEY_OFF ist, müssen Sie in Ihrer accounts.promotions.insert-Anfrage einen Wert für das Feld attributes.moneyOffAmount angeben.

Wenn Sie in Ihrer accounts.promotions.insert-Anfrage keinen Wert für das Feld attributes.moneyOffAmount angeben, wird die folgende Fehlermeldung angezeigt:

[moneyOffAmount] Missing benefit or restriction attributes for its type

Um diesen Fehler zu beheben, müssen Sie in Ihrer Anfrage einen Wert für das Feld attributes.moneyOffAmount angeben. Der Betrag muss in Mikroeinheiten angegeben werden.

Beschreibung des Geschenks nicht angegeben

Wenn der Wert des Felds attributes.couponValueType FREE_GIFT ist, müssen Sie in Ihrer accounts.promotions.insert-Anfrage einen Wert für das Feld attributes.freeGiftDescription angeben.

Wenn Sie in Ihrer accounts.promotions.insert-Anfrage keinen Wert für das Feld attributes.freeGiftDescription angeben, wird die folgende Fehlermeldung angezeigt:

[freeGiftDescription] Missing benefit or restriction attributes for its type

Um diesen Fehler zu beheben, müssen Sie in Ihrer Anfrage einen Wert für das Feld attributes.freeGiftDescription angeben.

Kostenloser Versand wird für lokale Angebote nicht unterstützt

Wenn der Wert des Felds redemptionChannel IN_STORE und der Wert des Felds attributes.couponValueType FREE_SHIPPING_STANDARD, FREE_SHIPPING_OVERNIGHT oder FREE_SHIPPING_TWO_DAY ist, wird die folgende Fehlermeldung angezeigt:

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

Achten Sie darauf, dass der Wert des Felds redemptionChannel ONLINE ist, um diesen Fehler zu beheben.

Art der Einlösung nicht angegeben

Wenn der Wert des Felds redemptionChannel in Ihrer accounts.promotions.insert-Anfrage nicht angegeben ist, wird die folgende Fehlermeldung angezeigt:

[redemptionChannel] Required parameter: redemptionChannel

Um diesen Fehler zu beheben, müssen Sie in Ihrer Anfrage einen Wert für das Feld redemptionChannel angeben.

Das Feld contentLanguage des Angebots und der Datenquelle stimmen nicht überein.

Wenn der Wert des Felds contentLanguage nicht mit dem Wert des Felds contentLanguage der Angebotsdatenquelle übereinstimmt, die Sie in Ihrer accounts.promotions.insert-Anfrage verwenden, wird die folgende Fehlermeldung angezeigt:

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

Achten Sie darauf, dass der Wert des Felds contentLanguage mit dem Wert des Felds contentLanguage der von Ihnen verwendeten Promotionsdatenquelle übereinstimmt, um diesen Fehler zu beheben.

Dieser Fehler wird auch angezeigt, wenn der Wert von targetCountry nicht mit dem Wert des Felds targetCountry der von Ihnen verwendeten Promotionsdatenquelle übereinstimmt.

Weitere Informationen