캠페인 생성

Xsolla Developers

또는

관리자 페이지로

캠페인 생성Server-sideAdmin

post/merchants/{merchant_id}/coupon_promotions

새로운 쿠폰 캠페인을 생성합니다.

주의

이 API 호출에는 project_id 경로 매개 변수가 포함되어 있지 않으므로 회사의 모든 프로젝트에서 유효한 API 키를 사용하여 인증을 설정해야 합니다.

SecuritybasicAuth

Request

path Parameters

merchant_id

required

integer

판매자 ID입니다.

Request Body schema: application/json

campaign_code

required

string

캠페인 이름입니다.

project_id

required

integer

프로젝트 ID입니다.

required

object

현지화된 캠페인 이름을 포함하는 개체입니다.

ar	string 아랍어.
bg	string 불가리아어.
cn	string 중국어(간체).
cs	string 체코어.
de	string 독일어.
en	string 영어.
es	string 스페인어.
fr	string 프랑스어.
he	string 히브리어.
it	string 이탈리아어.
ja	string 일본어.
ko	string 한국어.
pl	string 폴란드어.
pt	string 포르투갈어.
ro	string 루마니아어.
ru	string 러시아어.
th	string 태국어.
tr	string 터키어.
tw	string 중국어(번체).
vi	string 베트남어.

campaign_redeems_count_for_user

integer

캠페인 내 사용자당 최대 쿠폰 사용 횟수입니다. null이 전달되면 사용 횟수가 무제한으로 설정됩니다.

expiration_date

string <datetime>

ISO 8601 에 따라 YYYY-MM-DD’T’HH:MM:SS 형식으로 되어 있는 캠페인 만료일입니다.

redeems_count

integer

최대 쿠폰 사용 횟수입니다. null이 전달되면 사용 횟수가 무제한으로 설정됩니다.

redeems_count_for_user

integer

사용자당 최대 쿠폰 사용 횟수입니다. null이 전달되면 사용 횟수가 무제한으로 설정됩니다.

object

보상에 정기 결제 매개 변수를 포함하는 개체입니다.

plan_id required	integer 정기 결제 요금제 ID입니다.
product_id required	integer 정기 결제 제품 ID입니다.
trial_period required	integer 체험 기간의 날짜 수입니다.

virtual_currency_amount

number <float>

보상에 포함된 인게임 재화 금액입니다.

object

보상에 포함된 가상 아이템 매개 변수의 배열입니다.

sku required	string 가상 아이템 SKU입니다.
quantity required	integer 가상 아이템 수량입니다.

Responses

201

생성됨.

Request samples

application/json

{"campaign_code": "sample_campaign",
"campaign_names": {"en": "Campaign Name",
"ru": "Название кампании"
},
"campaign_redeems_count_for_user": 1,
"expiration_date": "2019-12-31",
"project_id": 12345,
"redeems_count": 10,
"redeems_count_for_user": 1,
"subscription_coupon": {"plan_id": 123,
"product_id": 456,
"trial_period": 30
},
"virtual_currency_amount": 200
}

Response samples

application/json

{"id": 9134
}