Skip to main content

Campaigns

With a sync of the type Campaign, you import coupon campaigns.

1. Fields for matching campaign data

The following fields are available for matching campaign data. During the import, plentymarkets checks if the imported data record already exists based on the matching field.

  • Campaign ID

2. Fields for mapping campaign data

Table 1 explains the fields that are available for matching campaign data. During the import, plentymarkets checks if the imported data record already exists based on the matching field.

Table 1. Mapping fields for importing campaign data
Mapping field Permissible import value Explanation

Campaign ID

Numeric (internal ID)

ID of the campaign

External ID

Numeric

External ID of the campaign

Name

Name of the campaign

Description

Description of the campaign

End date

Date

End date of the campaign

Start date

Date

Start date of the campaign

Minimum order value

Numeric

Minimum order value that must be reached in order that the coupon can be redeemed.

Code validity in weeks

Numeric

Number of weeks for which the coupon codes are valid.

Code length

Numeric

Number of characters of the coupon codes.
Note: Coupon codes can have a length of 6, 16, 24 or 32 characters.

Use

Possible values:
Single orders and subscriptions
Single orders only
Subscriptions only

Concept: Code

Possible values: One code and Several codes.
One code = One coupon code is generated per campaign and can be redeemed multiple times.
Several codes = Individual coupon codes are generated that can only be redeemed once.

Concept: Redemptions

Possible values:
Several redemptions per customer = A customer can redeem the entire coupon amount multiple times.
One redemption per customer = A customer can either redeem the entire coupon amount once or partial amounts.
Redemption until value is depleted = The entire coupon amount can only be redeemed once. The coupon can not be redeemed by multiple customers.
One single redemption = Only one redemption is possible.

Coupon type

Possible values: Voucher and Coupon
Coupons are redeemed in the online store. Vouchers are not redeemed in the online store, but through third parties.

Code assignment

The code assignment is only available when the coupon type Voucher is selected.
Possible values: Generate new code(s) and Use existing code(s).

Coupon variety

The coupon variety is only available when the coupon type Coupon is selected.
Possible values: Promotional coupon and Gift card.

Discount type

Discount type of the coupon.
Possible values when the coupon variety Promotional coupon is selected: Fixed amount, Percentage, Piece, Shipping.
Possible values when the coupon variety Gift card is selected: Fixed amount.

Discount value

Numeric

Discount value of the coupon

Incl. shipping costs

Numeric

Shipping costs can be included in the discount value.

Items coming from price comparison portals

Numeric (internal ID)

Allow whether coupons can also be redeemed for items coming from price comparison portals, i.e. items that are also offered on other marketplaces.
Note: Price comparison portals are all referrers > 1. This means that besides price comparison portals, also marketplaces and platforms are included. The referrers Manuel entry (referrer ID 0) and Online store (referrer ID 1) are not affected.

Categories

Categories for which the coupon can be redeemed.

Items

Item for which the coupon can be redeemed.
Note: Up to 20 items can be added.

Clients (stores)

Numeric (internal ID)

Client (store) for which the coupon can be redeemed.

Customer classes

Numeric (internal ID)

Customer classes for which the coupon can be redeemed.

To top