Probleme im Zusammenhang mit der Promotions-Unter-API beheben

Auf dieser Seite wird beschrieben, wie Sie Probleme im Zusammenhang mit der Unter-API „Angebote“ beheben.

Werbeaktion erstellen

Wenn Sie die accounts.promotions.insert-Anfrage zum Einfügen eines Angebots verwenden, müssen Sie alle erforderlichen Felder im Text der Anfrage angeben. Die folgenden Felder sind erforderlich:

  • 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 Aktionsstartdaten angeben, wird die folgende Fehlermeldung angezeigt:

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

Um diesen Fehler zu beheben, muss der Wert für das Feld promotionDisplayTimePeriod.startTime mit dem Wert für das Feld promotionEffectiveTimePeriod.startTime identisch sein oder vor diesem Wert stehen. Der Wert für das Feld promotionDisplayTimePeriod.endTime muss mit dem Wert für das Feld promotionEffectiveTimePeriod.endTime identisch sein oder davor liegen.

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

Mindestbestellmenge nicht angegeben

Wenn attributes.couponValueType den Wert BUY_M_GET_N_PERCENT_OFF oder BUY_M_GET_N_MONEY_OFF hat, 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, geben Sie in Ihrer Anfrage einen Wert für das Feld minimumPurchaseQuantity an.

Rabattbetrag nicht angegeben

Wenn der Wert des Felds attributes.couponValueType MONEY_OFF ist, musst du in deiner accounts.promotions.insert-Anfrage einen Wert für das Feld attributes.moneyOffAmount angeben.

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

[moneyOffAmount] Missing benefit or restriction attributes for its type

Um diesen Fehler zu beheben, geben Sie in Ihrer Anfrage einen Wert für das Feld attributes.moneyOffAmount an. Der Betrag muss in Mikro angegeben werden.

Beschreibung des Geschenks nicht angegeben

Wenn der Wert des Felds attributes.couponValueType FREE_GIFT ist, musst du in deiner 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, geben Sie in Ihrer Anfrage einen Wert für das Feld attributes.freeGiftDescription an.

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 zur Behebung dieses Fehlers darauf, dass der Wert des Felds redemptionChannel ONLINE ist.

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, geben Sie in Ihrer Anfrage einen Wert für das Feld redemptionChannel an.

Das Feld contentLanguage des Angebots stimmt nicht mit dem der Datenquelle ü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

Um diesen Fehler zu beheben, achten Sie darauf, dass der Wert des Felds contentLanguage mit dem Wert des Felds contentLanguage der verwendeten Angebotsdatenquelle übereinstimmt.

Dieser Fehler tritt auch auf, wenn der Wert von targetCountry nicht mit dem Wert des Felds targetCountry der verwendeten Angebotsdatenquelle übereinstimmt.

Weitere Informationen