Artikelaktion aktualisieren

Hinweis

Neue Daten ersetzen alte Daten. Auch wenn Sie nur einen Teil einer Werbeaktion aktualisieren möchten, sollten Sie alle erforderlichen Daten in der Anfrage übermitteln.

Werbeaktionen gewähren einen Rabatt (in %) auf Artikel. Der Rabatt wird auf alle Preise der angegebenen Artikel angewendet.

SecuritybasicAuth

Request

path Parameters

project_id required	integer Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt. Example: 44056
promotion_id required	integer Werbeaktions-ID. Eindeutige Werbeaktionskennung innerhalb des Projekts. Example: 111425

Request Body schema: application/json

Objekt mit Werbeaktionsdaten.

required

Array of objects

Array

sku

required

string

Default: "elven_sword"

Artikel-SKU.

required

object

percent

required

string

Prozentualer Rabatt. Der Preis des Artikels wird um einen Wert verringert, der anhand dieses Prozentsatzes berechnet und dann auf zwei Dezimalstellen gerundet wird.

required

object

Name der Werbeaktion. Sollte Schlüssel-Wert-Paare enthalten, wobei der Schlüssel ein Gebietsschema im Format "^[a–z]{2}-[A–Z]{2}$" und der Wert ein String ist.

property name*

additional property

string

Array of type = string (object) or type = number (object) or type = date (object) [ 1 .. 100 ] items

Bedingungen für die Validierung von Nutzerattributen. Steuert die Verfügbarkeit der Werbeaktion basierend darauf, ob die Nutzerattribute alle angegebenen Bedingungen erfüllen.

Array ([ 1 .. 100 ] items)

One of:

attribute

required

string [ 1 .. 255 ] characters ^[-_.\d\w]+$

Benutzerattributcode.

operator

required

string

Art der durchgeführten Operation nach Bedingung. Für den Attributtyp string.

Enum:	Description
eq	Gleich
ne	Ungleich

value

required

string <= 255 characters

Bedingungswert, mit dem der Benutzerattributwert verglichen wird. Der Typ hängt vom Attributtyp ab.

type

required

string

Benutzerattributtyp.

Value: "string"

can_be_missing

boolean

Gibt an, dass die Bedingung erfüllt ist, auch wenn das Attribut in den Benutzerattributen fehlt. Übermitteln Sie true, um den Artikel den Nutzern anzuzeigen, die dieses Attribut nicht haben. Nutzer, die das Attribut haben, dessen Wert jedoch nicht mit dem in der Bedingung angegebenen Wert übereinstimmt, sehen den Artikel nicht. false – Nutzer, die das Attribut haben, dessen Wert jedoch nicht mit dem in der Bedingung angegebenen Wert übereinstimmt oder bei denen das Attribut fehlt, sehen den Artikel nicht.

excluded_promotions

Array of integers

Liste der IDs der Werbeaktionen, die bei der Anwendung dieser Werbeaktion ausgeschlossen werden sollen.
Example: [12, 789]

is_enabled

boolean

Ob die Werbeaktion aktiviert ist oder nicht.

object

Werbebeschränkungen.

per_user

integer or null

Werbebeschränkungen für einen separaten Nutzer.

object or null

Aktualisierungszeitraum begrenzen.

object

Aktualisierungszeitraum für das Nutzerlimit.

day_of_month	integer or null [ 1 .. 31 ] Tag im Monat, an dem die Limits aktualisiert werden. Hat der Monat weniger Tage als der ausgewählte Tag, erfolgt die Aktualisierung am letzten Tag des Monats. `null` ist bei Limitaktualisierungszeiträumen vom Typ `monthly` unzulässig.
day_of_week	integer or null [ 1 .. 7 ] Wochentag, an dem die Limits aktualisiert werden. 1 seht für Montag, und 7 steht für Sonntag. `null` ist bei Limitaktualisierungszeiträumen vom Typ `weekly` unzulässig.
displayable_reset_next_date	string <date-time> Datum und Uhrzeit, zu der die Limits zurückgesetzt werden sollen (ISO 8601).
displayable_reset_start_date	string <date-time> Datum und Uhrzeit der ersten Limitaktualisierung (ISO 8601).
interval_type	string Typ des wiederkehrenden Aktualisierungszeitraums. Enum: "daily" "weekly" "monthly"
reset_next_date	integer Datum und Uhrzeit der Limitaktualisierung (Unix-Zeitstempel).
time	string <full-time> Zeitpunkt der Limitaktualisierung in der gewünschten Zeitzone (auf Stunden gerundet).

Array of objects or null

Objekt-Array mit Bedingungen für die Preisspanne, innerhalb der die Werbeaktion angewandt wird.
Die Aktion wird nur auf Artikel angewandt, deren Preis alle in dem Array aufgelisteten Bedingungen erfüllt. Wenn Sie dieses Array übermitteln, müssen Sie den Wert des Objekts items auf null setzen.

Array

operator

required

string

Vergleichsoperator zum Festlegen der Preisspanne für die Anwendung der Werbeaktion.

Enum:	Description
eq	Gleich
ge	Größer oder gleich
gt	Größer als
le	Kleiner oder gleich
lt	Kleiner als
ne	Ungleich

value

required

string^\d+(\.\d{1,4})?$

Wert zur Bestimmung der Preisspanne für die Anwendung der Werbeaktion.

Array of objects

Gültigkeitszeitraum der Werbeaktion. Wenn mehrere Zeiträume angegeben sind, sind sowohl date_from als auch date_until erforderlich.

Array

date_from required	string <date-time> Startdatum für die angegebene Werbeaktion.
date_until	string or null <date-time> Enddatum für die angegebene Werbeaktion. Wenn `null` festgelegt ist, läuft die Werbeaktion unbefristet. Kann nur `null` sein, wenn ein einzelner Gültigkeitszeitraum angegeben ist.

Responses

204

Die Werbeaktion wurde erfolgreich aktualisiert.

401

Basisauthentifizierung nicht bestanden oder falsch. Prüfen Sie die Anmeldedaten und vergewissern Sie sich, dass Sie die Basisauthentifizierung verwenden.

404

Werbeaktion nicht gefunden. Prüfen Sie, ob die promotion_id korrekt ist.

422

Ungültige Anfrage.

Request samples

application/json

{"attribute_conditions": [{"attribute": "race",
"operator": "eq",
"type": "string",
"value": "ork"
},
{"attribute": "level",
"can_be_missing": true,
"operator": "eq",
"type": "number",
"value": "10"
}
],
"discount": {"percent": "24.00"
},
"is_enabled": true,
"items": [ ],
"name": {"en-US": "Ork set discount",
"ru-RU": "Скидка на набор для орка"
},
"promotion_periods": [{"date_from": "2020-04-15T18:16:00+05:00",
"date_until": "2020-04-25T18:16:00+05:00"
}
]
}

Response samples

application/json

{"errorCode": 1020,
"errorMessage": "[0401-1020]: Error in Authentication method occurred",
"statusCode": 401
}