Xsolla-logo

Rabattaktion für Artikel erstellenServer-sideAdmin

post/v2/project/{project_id}/admin/promotion/item

Erstellt eine Rabattaktion für einen Artikel.

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
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:

Bedingungen, die mit Benutzerattributwerten verglichen werden. Alle Bedingungen müssen erfüllt sein, damit die Aktion greift.

[ 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
201

Werbeaktion wurde erfolgreich erstellt.

401

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

422

Ungültige Anfrage.

Request samples
application/json
{
  • "attribute_conditions": [
    ],
  • "date_end": "2020-04-25T18:16:00+05:00",
  • "date_start": "2020-04-15T18:16:00+05:00",
  • "discount": {
    },
  • "items": null,
  • "name": {
    }
}
Response samples
application/json
{
  • "promotion_id": 2384756
}
System statusAll services operational

Privacy Settings

Privacy PolicyEnd User License Agreement© 2006–2024 Xsolla Inc.