Rabattaktion für Artikel erstellen

Digital Distribution Hub API

In-Game Store API

Überblick

API-Definition herunterladen

BENUTZERATTRIBUTE

Administrator

Personalisierter Katalog

BUNDLES

Administrator

Katalog

WARENKORB UND ZAHLUNG

Warenkorb (clientseitig)

Warenkorb (serverseitig)

Zahlung (clientseitig)

Zahlung (serverseitig)

Bestellung

Kostenlose Artikel

ALLGEMEINES

Webhooks

Vorbestellungen

Händler

Katalog

Gängige Regionen

SPIELSCHLÜSSEL

Katalog

Berechtigung

Administrator

WERBEAKTIONEN

Allgemeines

Gutscheine

Promocodes

Katalogsonderangebote

Rabatte

get

Liste der Artikelaktionen abrufen

post

Rabattaktion für Artikel erstellen

delete

Artikel Werbeaktion löschen

get

Artikelaktion abrufen

put

Artikelaktion aktualisieren

Prämien

VIRTUELLE GEGENSTÄNDE UND WÄHRUNG

Administrator

Katalog

Virtuelle Zahlung

LIMITS

Verwaltung

BELOHNUNGSKETTEN UND WERTPUNKTE

Administrator

Client

Clans-Client

UPSELL

Administrator

Client

CONNECTOR

Administrator

Pay Station API

Subscriptions API

Webhooks

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:

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

excluded_promotions

Array of integers

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

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).

Array of objects or null

Array von Objekten 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.

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": [{"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

{"promotion_id": 2384756
}