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 (objects) or Array of type = date (objects) or Array of type = number (objects)

One of:

[ 1 .. 100 ] items

Array ([ 1 .. 100 ] items)

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.

date_end

string or null <date-time>

Default: "2020-04-15T18:16:00+05:00"

Datum, an dem Ihre Werbeaktion endet. Möglich ist null.

date_start

string or null <date-time>

Default: "2020-04-15T18:16:00+05:00"

Datum, an dem Ihre Werbeaktion beginnt.

object

Werbebeschränkungen.

per_user

integer or null

Werbebeschränkungen für einen separaten Benutzer.

object or null

Aktualisierungszeitraum begrenzen.

interval_type = daily (object) or interval_type = weekly (object) or interval_type = monthly (object)

One of:

Tägliche Aktualisierung der Benutzerlimits.

interval_type required	string Wiederkehrender Aktualisierungszeitraum. Value: "daily"
time required	string((0[0-9]\|1[0-9]\|2[0-3]):00:00)(\+\|-)(0[0-9]\|1... Zeitpunkt der Limitaktualisierung in der gewünschten Zeitzone (auf Stunden gerundet).

object or null

Voraussetzung für die Anwendung der Werbeaktion auf Artikel innerhalb der angegebenen Preisspanne. Im Objekt price_range_condition müssen Sie für mindestens einen der folgenden Parameter einen Wert angeben: lower_limit oder upper_limit.
Wenn Sie Artikel im Objekt items angegeben haben, gilt die Werbeaktion nur für die Artikel in diesem Objekt und innerhalb der angegebenen Preisspanne.
Damit die Aktionsbedingung für alle Artikel gilt, müssen Sie den Wert null im Objekt items übermitteln.

lower_limit required	string or null Untergrenze der Preisspanne, ab der die Werbeaktion ausgelöst wird. Ist ein Wert für `lower_limit` festgelegt, werden die Werbeaktionen nur bei Artikeln ausgelöst, deren Preis größer oder gleich diesem Wert ist. Der Preis muss in der Standardwährung angegeben sein. Zum Beispiel: `"10.0000"`
upper_limit required	string or null Obergrenze der Preisspanne, bis zu der die Werbeaktion ausgelöst wird. Ist ein Wert für `upper_limit` festgelegt, werden die Werbeaktionen nur bei Artikeln ausgelöst, deren Preis kleiner oder gleich diesem Wert ist. Der Preis muss in der Standardwährung angegeben sein. Zum Beispiel: `"20.0000"`

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": "ge",
"type": "number",
"value": "10"
}
],
"date_end": "2020-04-25T18:16:00+05:00",
"date_start": "2020-04-15T18:16:00+05:00",
"discount": {"percent": "24.00"
},
"items": null,
"name": {"en-US": "Ork set discount",
"ru-RU": "Скидка на набор для орка"
}
}

Response samples

application/json

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