프로모션 캠페인 설정
스토어를 게임에 통합한 후 쿠폰, 프로모션 코드, 보너스 또는 할인 프로모션을 설정하여 신규 사용자를 유치하고 판매를 늘릴 수 있습니다.
개인 설정한 프로모션을 실행할 수도 있습니다. 즉, 특정 사용자를 대상으로 캠페인을 설정할 수 있습니다. 프로모션에서 사용자가 사용할 수 있는 아이템 수를 설정할 수 있습니다. 이것은 할인을 사용하는 프로모션 캠페인과 보너스를 사용하는 프로모션 캠페인에서만 가능합니다.
로그인 제품을 이미 통합한 경우 사용자 맞춤형 프로모션을 설정하기 전에 다음을 수행해야 합니다.
- 프로젝트에서 사용자 특성을 설정합니다.
- 로그인 섹션에서 사용자 특성 스키마를 설정합니다.
특성은 키-값 쌍으로 저장되는 사용자 기능입니다. 특성을 통해 다음을 수행할 수 있습니다.
- 사용자 세그먼트 구분
- 웹샵 솔루션에서 각 사용자 그룹용 개인 스토어 준비
전송된 데이터의 무결성을 보장하기 위해 관리자 페이지에서 JSON 스키마 형식의 특성 검증 규칙을 설정하고 로그인 API 메소드 혹은 웹훅을 사용하여 사용자 특성을 관리할 수 있습니다. 또한, 관리자 페이지에서 특성 값을 편집할 수도 있습니다.자세한 정보는 사용자 특성 설정 방법을 참조하세요.
쿠폰에는 구매 또는 장바구니 없이 무료 아이템을 부여하는 코드가 있습니다. 쿠폰을 사용하려면 게임, 웹사이트 또는 모바일 애플리케이션에서 코드를 입력해야 합니다. 그러면 연결된 보상이 사용자의 인벤토리로 전달됩니다. 보상 포함 내역:
쿠폰에 대한 자세한 내용은 쿠폰 보기를 참조하세요.프로모션 코드는 장바구니에 할인을 적용하거나 체크아웃하는 동안 장바구니에 무료 아이템을 추가합니다. 프로모션 코드를 활성화하고 장바구니의 아이템 비용을 지불하면 사용자는 다음 보상 중 하나를 받을 수 있습니다.
- 사용자의 장바구니에 할인 적용
- 보너스 아이템:
- 인게임 재화 패키지
- 가상 아이템. 번들 또는 사용기간 제한 아이템 포함
사용자는 프로모션 아이템을 구매할 때 보너스를 받을 수도 있습니다. 보너스 포함 가능 항목:
- 인게임 재화 패키지
- 가상 아이템. 번들 또는 사용기간 제한 아이템 포함
할인 프로모션을 사용하여 하나 이상의 제품에 대한 할인을 설정할 수 있습니다. 하나의 제품에 무제한 수량의 프로모션을 적용할 수 있습니다. 할인은 누적되지 않으며 개별 품목의 비용에 적용됩니다. 할인은 다음 아이템 중 하나 또는 여러 개에 적용될 수 있습니다.
- 인게임 재화 패키지
- 가상 아이템. 사용기간 제한 아이템 포함
프로모션 캠페인(쿠폰 사용)
쿠폰을 사용하는 프로모션 캠페인을 시작하려면:
쿠폰을 사용하는 프로모션 캠페인 설정
- 관리자 페이지에서 프로젝트를 엽니다.
- 스토어를 사이드 메뉴에서 클릭하고 프로모션 및 보상으로 이동합니다.
- 프로모션 생성을 클릭합니다.
- 다음 매개변수를 지정합니다.
- 프로모션 제목을 입력합니다.
- 프로모션 유형으로 쿠폰을 선택합니다.
- 사용자가 쿠폰을 사용할 경우 받게 되는 보상을 선택합니다. 사용할 수 있는 옵션:
- 인게임 재화 패키지
- 가상 아이템(하나 또는 여러 개, 번들 및 사용기간 제한 아이템 포함).
- 추가:
- 외부 ID의 프로모션 식별자.
- 사용자가 쿠폰을 사용할 경우 받게 되는 보너스 아이템.
- 아이템 유형 및 수량.
- 다음을 클릭합니다.
- 총 교환 횟수 및 사용자당 교환 횟수를 지정합니다.
- 캠페인 시작 날짜와 종료 날짜를 설정합니다.
- 다음을 클릭합니다.
- 설정을 확인하고 저장 및 종료를 클릭합니다.
- 사이드 메뉴에서 스토어를 클릭한 후 프로모션 및 보상으로 이동합니다.
- 프로모션을 선택하고 ••• 메뉴 버튼을 클릭하여 메뉴를 연 후 프로모션 편집을 클릭합니다.
- 코드 탭으로 이동합니다.
- 쿠폰 생성 방법을 지정합니다.
- 쿠폰 코드를 생성하거나 수동으로 입력합니다.
- 프로모션을 활성화합니다.
코드로 쿠폰 사용
쿠폰을 사용하려면 쿠폰 코드 사용 메서드를 호출합니다. 쿠폰 보상 받기 메서드 응답의 is_selectable
매개 변수 값에 따라 2가지 가능한 플로우가 있습니다.
is_selectable=true
의 경우, 쿠폰 코드 사용메서드 호출 시 다음 형식의selected_unit_items
개체를 전달해야 합니다.
- http
selected_unit_items:{
unit_1_sku: "selected_unit_item_sku",
unit_2_sku: "selected_unit_item_sku"
}
응답 예시:
- http
{
{
"items": [
{
"sku": "xsollus_gold_edition_steam",
"name": "Xsollus: Gold Edition (steam)",
"type": "game_key",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
"attributes": [],
"is_free": true,
"groups": [],
"price": null,
"virtual_prices": [],
"drm_name": "Steam",
"drm_sku": "steam",
"has_keys": false,
"is_pre_order": true,
"release_date": null,
"quantity": 1
},
{
"sku": "xsollus_bonus_pack_edition_origin",
"name": "Xsollus: Bonus Pack (origin)",
"type": "game_key",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
"attributes": [],
"is_free": true,
"groups": [],
"price": null,
"virtual_prices": [],
"drm_name": "Origin",
"drm_sku": "origin",
"has_keys": false,
"is_pre_order": true,
"release_date": null,
"quantity": 3
}
]
}
is_selectable=false
의 경우, 요청에서 추가 매개 변수를 전달하지 않아야 합니다.
쿠폰 보상 얻기
쿠폰 사용 후에 사용자가 받는 아이템 목록을 가져오려면 쿠폰 보상 받기 메서드를 호출합니다. 응답의 is_selectable
매개 변수 값에 따라 2가지 가능한 플로우가 있습니다.
is_selectable=true
값의 경우,type=unit
요소의 모든item
에 대해unit_items
개체에서 선택하는 요소에 대한 양식을 표시해야 합니다. 이 양식에서 사용자는 각unit
유형에 대해 하나의 요소만 선택합니다.
- http
{
"bonus": [{
"item": {
"sku": "xsollus_gold_edition",
"name": "Xsollus: Gold Edition",
"type": "unit",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
"unit_items": [{
"sku": "xsollus_gold_edition_steam",
"name": "Xsollus: Gold Edition (steam)",
"type": "game_key",
"drm_name": "Steam",
"drm_sku": "steam"
}, {
"sku": "xsollus_gold_edition_playstation",
"name": "Xsollus: Gold Edition (playstation)",
"type": "game_key",
"drm_name": "Playstation",
"drm_sku": "playstation"
}, {
"sku": "xsollus_gold_edition_xbox",
"name": "Xsollus: Gold Edition (xbox)",
"type": "game_key",
"drm_name": "XBox",
"drm_sku": "xbox"
}, {
"sku": "xsollus_gold_edition_rockstar",
"name": "Xsollus: Gold Edition (rockstar)",
"type": "game_key",
"drm_name": "Rockstar Games Launcher",
"drm_sku": "rockstar"
}]
},
"quantity": 1
}, {
"item": {
"sku": "xsollus_bonus_pack_edition",
"name": "Xsollus: Bonus Pack",
"type": "unit",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
"unit_items": [{
"sku": "xsollus_bonus_pack_edition_steam",
"name": "Xsollus: Bonus Pack (steam)",
"type": "game_key",
"drm_name": "Steam",
"drm_sku": "steam"
}, {
"sku": "xsollus_bonus_pack_edition_playstation",
"name": "Xsollus: Bonus Pack (playstation)",
"type": "game_key",
"drm_name": "Playstation",
"drm_sku": "playstation"
}, {
"sku": "xsollus_bonus_pack_edition_xbox",
"name": "Xsollus: Bonus Pack (xbox)",
"type": "game_key",
"drm_name": "XBox",
"drm_sku": "xbox"
}]
},
"quantity": 3
}],
"is_selectable": true
is_selectable=false
의 경우, 요청에서 추가 매개 변수를 전달하지 않아야 합니다.
프로모션 캠페인(프로모션 코드 사용)
프로모션 코드를 사용하는 프로모션 캠페인을 시작하려면:
프로모션 코드를 사용하는 프로모션 캠페인 설정
- 관리자 페이지에서 프로젝트를 엽니다.
- 스토어를 사이드 메뉴에서 클릭하고 프로모션 및 보상으로 이동합니다.
- 프로모션 생성을 클릭합니다.
- 다음 매개 변수를 지정합니다.
- 프로모션 제목을 입력합니다.
- 프로모션 유형으로 프로모션 코드를 선택합니다.
- 사용자가 프로모션 코드를 사용할 때 받게 되는 혜택(보상 없음, 장바구니의 모든 항목 할인, 특정 항목 할인, 보너스 항목 또는 조합)을 선택합니다.
- 할인 금액을 설정합니다.
- 다음을 클릭합니다.
- 총 교환 횟수 및 사용자당 교환 횟수를 지정합니다.
- 다음을 클릭합니다.
- 캠페인 시작 날짜와 종료 날짜를 설정합니다.
- 다음을 클릭합니다.
- 설정을 확인하고 저장 및 종료를 클릭합니다.
- 사이드 메뉴에서 스토어를 클릭한 후 프로모션 및 보상으로 이동합니다.
- 프로모션을 선택하고 ••• 메뉴 버튼을 클릭하여 메뉴를 연 후 프로모션 편집을 클릭합니다.
- 코드 탭으로 이동합니다.
- 프로모션 코드 생성 방법을 지정합니다.
- 프로모션 코드를 생성하거나 수동으로 입력합니다.
- 프로모션을 활성화합니다.
프로모션 코드 사용
프로모션 코드를 사용하려면 프로모션 코드 사용 메서드를 호출합니다. is_selectable
매개 변수의 값에 따라 프로모션 코드 보상 받기 메서드 응답에는 2가지 가능한 플로우가 있습니다.
is_selectable=true
의 경우, 프로모션 코드 사용 메서드 호출 시 다음 형식으로selected_unit_items
개체를 전달해야 합니다.
- http
selected_unit_items:{
unit_1_sku: "selected_unit_item_sku",
unit_2_sku: "selected_unit_item_sku"
}
응답 예시:
- http
{
{
"items": [
{
"sku": "xsollus_gold_edition_steam",
"name": "Xsollus: Gold Edition (steam)",
"type": "game_key",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
"attributes": [],
"is_free": true,
"groups": [],
"price": null,
"virtual_prices": [],
"drm_name": "Steam",
"drm_sku": "steam",
"has_keys": false,
"is_pre_order": true,
"release_date": null,
"quantity": 1
},
{
"sku": "xsollus_bonus_pack_edition_origin",
"name": "Xsollus: Bonus Pack (origin)",
"type": "game_key",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
"attributes": [],
"is_free": true,
"groups": [],
"price": null,
"virtual_prices": [],
"drm_name": "Origin",
"drm_sku": "origin",
"has_keys": false,
"is_pre_order": true,
"release_date": null,
"quantity": 3
}
]
}
is_selectable=false
의 경우, 요청에서 추가 매개 변수를 전달하지 않아야 합니다.
프로모션 코드 보상 얻기
프로모션 코드 사용 후에 사용자가 받는 아이템 목록을 가져오려면 프로모션 코드 보상 받기 메서드를 호출합니다. 응답의 is_selectable
매개 변수의 값에 따라 2가지 가능한 플로우가 있습니다.
is_selectable=true
값의 경우,type=unit
요소의 모든item
에 대해unit_items
개체에서 선택하는 요소에 대한 양식을 표시해야 합니다. 이 양식에서 사용자는 각unit
유형에 대해 하나의 요소만 선택합니다.
- http
{
"bonus": [{
"item": {
"sku": "xsollus_gold_edition",
"name": "Xsollus: Gold Edition",
"type": "unit",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
"unit_items": [{
"sku": "xsollus_gold_edition_steam",
"name": "Xsollus: Gold Edition (steam)",
"type": "game_key",
"drm_name": "Steam",
"drm_sku": "steam"
}, {
"sku": "xsollus_gold_edition_playstation",
"name": "Xsollus: Gold Edition (playstation)",
"type": "game_key",
"drm_name": "Playstation",
"drm_sku": "playstation"
}, {
"sku": "xsollus_gold_edition_xbox",
"name": "Xsollus: Gold Edition (xbox)",
"type": "game_key",
"drm_name": "XBox",
"drm_sku": "xbox"
}, {
"sku": "xsollus_gold_edition_nintendo_eshop",
"name": "Xsollus: Gold Edition (nintendo_eshop)",
"type": "game_key",
"drm_name": "Nintendo Switch eShop",
"drm_sku": "nintendo_eshop"
}]
},
"quantity": 1
}, {
"item": {
"sku": "xsollus_bonus_pack_edition",
"name": "Xsollus: Bonus Pack",
"type": "unit",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
"unit_items": [{
"sku": "xsollus_bonus_pack_edition_steam",
"name": "Xsollus: Bonus Pack (steam)",
"type": "game_key",
"drm_name": "Steam",
"drm_sku": "steam"
}, {
"sku": "xsollus_bonus_pack_edition_origin",
"name": "Xsollus: Bonus Pack (origin)",
"type": "game_key",
"drm_name": "Origin",
"drm_sku": "origin"
}, {
"sku": "xsollus_bonus_pack_edition_drmfree",
"name": "Xsollus: Bonus Pack (drmfree)",
"type": "game_key",
"drm_name": "DRM Free",
"drm_sku": "drmfree"
}, {
"sku": "xsollus_bonus_pack_edition_gog",
"name": "Xsollus: Bonus Pack (gog)",
"type": "game_key",
"drm_name": "GOG",
"drm_sku": "gog"
}, {
"sku": "xsollus_bonus_pack_edition_rockstar",
"name": "Xsollus: Bonus Pack (rockstar)",
"type": "game_key",
"drm_name": "Rockstar Games Launcher",
"drm_sku": "rockstar"
}]
},
"quantity": 3
}],
"discount": {
"percent": null
},
"is_selectable": true
is_selectable=false
의 경우, 요청에서 추가 매개 변수를 전달하지 않아야 합니다.
프로모션 캠페인(보너스 사용)
보너스 프로모션 캠페인을 시작하는 방:
- 관리자 페이지에서 프로젝트를 엽니다.
- 사이드 메뉴에서 스토어를 클릭하고 프로모션 및 보상으로 이동합니다.
- 프로모션 생성을 클릭합니다.
- 다음 매개 변수를 지정합니다.
- 프로모션 제목을 입력합니다.
- 프로모션 유형으로 보너스를 선택합니다.
- 프로모션 항목을 선택합니다.
- 프로모션 항목 구매 시 사용자에게 부여되는 아이템을 선택합니다.
- 다음을 클릭합니다.
- 프로모션을 첫 구매 사용자에게만 적용하려면 첫 구매자에게만 프로모션 트리거 토글을 온으로 설정합니다. 한 사용자가 프로모션을 사용할 수 있는 횟수 제한 및 특정 사용자만 프로모션 적용 토글이 자동으로 활성화되고 프로모션 트리거를 위한 조건 세트가 생성됩니다. 필요한 경우 조건을 추가할 수 있습니다.
- 다음을 클릭합니다.
- 캠페인 시작 날짜와 종료 날짜를 설정합니다.
- 다음을 클릭합니다.
- 설정을 확인하고 저장 및 종료를 클릭합니다.
- 사이드 메뉴에서 스토어를 클릭한 후 프로모션 및 보상으로 이동합니다.
- 프로모션을 선택하고 ••• 메뉴 버튼을 클릭하여 메뉴를 연 후 프로모션 편집을 클릭합니다.
- 프로모션을 활성화합니다.
프로모션 캠페인(할인 사용)
관리자 페이지을 통한 할인 프로모션 캠페인 설정
할인 프로모션 캠페인을 시작하는 방법:- 관리자 페이지에서 프로젝트를 엽니다.
- 사이드 바에서 스토어를 클릭합니다.
- 프로모션 및 보상 > 프로모션 생성을 클릭합니다.
- 다음 매개 변수를 지정합니다.
- 프로모션 제목을 입력합니다.
- 프로모션 유형으로 할인을 선택합니다.
- 하나 또는 여러 항목에 적용되는 할인을 설정합니다.
- 할인 금액을 설정합니다.
- 다음을 클릭합니다.
- 프로모션을 첫 구매 사용자에게만 적용하려면 첫 구매자에게만 프로모션 트리거 토글을 온으로 설정합니다. 한 사용자가 프로모션을 사용할 수 있는 횟수 제한 및 특정 사용자만 프로모션 적용 토글이 자동으로 활성화되고 프로모션 트리거를 위한 조건 세트가 생성됩니다. 필요한 경우 조건을 추가할 수 있습니다.
- 다음을 클릭합니다.
- 캠페인 시작 날짜와 종료 날짜를 설정합니다.
- 다음을 클릭합니다.
- 설정을 확인하고 저장 및 종료를 클릭합니다.
- 사이드 메뉴에서 스토어를 클릭한 후 프로모션 및 보상으로 이동합니다.
- 프로모션을 선택하고 ••• 메뉴 버튼을 클릭하여 메뉴를 연 후 프로모션 편집을 클릭합니다.
- 프로모션을 활성화합니다.
API 메소드를 이용한 설정
프로모션 메서드 그룹의 할인 하위 섹션의 메서드를 사용하면 할인 프로모션을 적용할 수 있습니다.
API 메서드를 통해 프로모션 만들기:
- 아이템에서 할인 프로모션 생성 메서드를 필수 매개 변수와 함께 호출합니다.
- 아이템 프로모션 업데이트 메서드를
“is_enabled”:true
매개 변수와 함께 호출하여 프로모션을 활성화합니다.
API를 이용해 프로모션을 편집하려면 새 프로모션 매개 변수와 아이템 프로모션 업데이트 메서드를 호출합니다.
API 메서드를 이용해 할인 프로모션을 만들거나 편집할 때 가능한 작업:
- 프로젝트의 모든 아이템의 할인을 구성합니다.
“items”:null
매개 변수를 아이템에 대한 할인 프로모션 생성 또는 아이템 프로모션 업데이트 메서드에 전달합니다.
- json
"items": null
- 실물 상품을 위한 할인을 구성합니다. 실물 상품 SKU를 포함하는 배열을 아이템에 대한 할인 프로모션 생성 또는 아이템 프로모션 업데이트 메서드에 전달합니다.
- json
"items": [{
“sku”: “strw2030”
}, {
“sku”: “strw4060”
}, {
“sku”: “cupred200”
}
]
- 분수 백분율 값으로 할인을 구성합니다.
discount.percent
매개 변수를 분수 할인과 함께 아이템에 대한 할인 프로모션 생성 또는 아이템 프로모션 업데이트 메서드에 전달합니다.
- json
"discount": {
“percent”: ”49.9”
}
- 다른 유형의 아이템에 대한 할인을 구성합니다. 필수 아이템 SKU 포함하는 배열을 아이템에 대한 할인 프로모션 생성 또는 아이템 프로모션 업데이트 메서드로 전달합니다.
- json
"items": [{
“sku”: “storm_shield”
}, {
“sku”: “heaven_crystals_pack_x500”
},{
“sku”: “strw2030”
}
]
- 게임의 명확한 DRM을 위한 할인을 구성합니다. 필수 DRM의 SKU를 아이템에 대한 할인 프로모션 생성 또는 아이템 프로모션 업데이트 메서드에 전달합니다.
- json
"items": [{
“sku”: “brilliant_game_sku_steam”
}
]
- 지정된 기간이 없는 할인 프로모션을 구성합니다.
“date_end”:null
매개 변수를 아이템에 대한 할인 프로모션 생성 또는 아이템 프로모션 업데이트 메서드에 전달합니다.
- json
“date_end”: null
- 첫 구매자를 위한 프로모션을 설정합니다. 이렇게 하려면 아이템 API의 아이템 할인 프로모션 생성 또는 아이템 프로모션 업데이트 API에서
attribute_conditions
배열의 개체인 다음을 전달합니다.
- json
"attribute_conditions": [
{
"attribute": "has_purchase",
"operator": "eq",
"value": "0",
"type": "number"
}
],
"limits": {
"per_user": 1
}
오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.