쿠폰 및 프로모션(레거시 Economy)

아티클
07/28/2023

Important

Economy v1 API는 유지 관리 모드에 있으며 새로운 기능은 제공되지 않으며 버그 수정만 제공됩니다. v1 API는 당분간 유지될 것입니다. PlayFab Economy의 다음 버전에 대해 자세히 알아보려면 Economy v2 개요를 참조하세요!

쿠폰은 고객이 게임에서 인벤토리 아이템을 교환하는 데 사용할 수 있도록 생성할 수 있는 문자열 토큰입니다. 번들 또는 CloudScript와 결합되면 이러한 쿠폰을 사용해 게임에서 거의 모든 기능을 트리거할 수 있을 것입니다.

요구 사항

카탈로그, 번들 및 컨테이너에 대한 지식.
게임 관리자에 대한 지식.
플레이어 인벤터리에 대한 지식.

쿠폰 생성 및 사용 지침

이하의 예 모두는 쿠폰 생성의 첫 번째 기본 단계를 보여줍니다. 이것은 게임 관리자에서 수행됩니다.

게임 관리자에서:

타이틀로 이동합니다.
왼쪽 메뉴에서 경제를 선택합니다.
카탈로그 탭으로 이동합니다.

항목, 번들 및 컨테이너의 세 탭 섹션 중 하나에 쿠폰 링크가 있습니다.

링크는 섹션의 모든 항목에 대한 쿠폰을 생성할 수 있는 창을 엽니다. 특정 아이템을 위한 쿠폰을 만들기 원하는 경우:

아이템 탭에서 쿠폰을 선택합니다.
번들 아래에서 쿠폰을 묶고 컨테이너 아래에서 쿠폰을 담습니다.

팝업 창은 아래에 표시된 것과 비슷합니다. (항목 목록은 타이틀과 일치해야 합니다. 표시되는 항목은 Drop Tables 자습서에 설명되어 있습니다.)

게임 관리자 - 쿠폰 생성

쿠폰 생성을 완료하는 방법:

생성할 쿠폰 수량을 선택합니다.
이어서 쿠폰이 생성해야 하는 아이템을 선택합니다.
그런 다음 쿠폰 목록이 있는 CSV 텍스트 파일을 다운로드할 수 있습니다.

예의 링크 중 하나를 선택하면 쉼표로 구분된 다음 10개 쿠폰이 생성됩니다.

65g-d4q5-zph,ahs-aofk-5ip,rqp-pk6c-yuu,58d-64h9-a6q,zxk-jtmi-5a1,oeu-6e4z-365,mfy-euhb-qj3,ru9-r1ux-wzy,shj-54cm-5oh,719-7hxc-pzz

최종적으로, 고객은 코드를 입력할 수 있는 GUI를 귀하가 제공하면 쿠폰을 사용할 수 있는 데, 그것을 쿠폰을 무른다고 합니다.

// Unity/C#
void UseCoupon(string couponCode)
{
    var primaryCatalogName = "TestCatalog-001"; // In your game, this should just be a constant matching your primary catalog
    var request = new RedeemCouponRequest
    {
        CatalogVersion = primaryCatalogName,
        CouponCode = couponCode // This comes from player input, in this case, one of the coupon codes generated above
    };
    PlayFabClientAPI.RedeemCoupon(request, LogSuccess, LogFailure);
}

사례: 인벤터리 아이템 쿠폰

쿠폰을 사용하는 가장 간단한 방법은 인벤터리 아이템을 선물하는 것입니다. 카탈로그를 만든 후, 이미 설명한 앞의 지침에 따라 일반 아이템을 위한 쿠폰을 생성할 수 있습니다. 이 경우를 위한 다른 특별한 단계는 없습니다.

예시 사례: 가상 통화 쿠폰 또는 여러 항목 쿠폰

쿠폰은 가상 통화를 직접 부여할 수 없으며 단일 항목만 부여할 수 있습니다.

그러나 번들을 사용하면 인벤터리 아이템을 아이템 그룹 또는 가상 통화 그룹으로 원활하게 변환할 수 있습니다. VC 예에서는 VC 콘텐츠로 새로운 번들 아이템을 만들어야 합니다.

번들이 15초 후에 만료되도록 설정하십시오. 이렇게 하면 플레이어는 번들을 열자마자 즉시 VC를 볼 수 있으며 중간 항목은 볼 수 없습니다.

게임 관리자 - 경제 - 카탈로그 번들 편집

다아이템도 같은 방식으로 기능합니다:

여러 아이템 또는 심지어 드롭 표 번들 만들기.
15초 후에 만료되도록 설정하십시오.
쿠폰은 번들을 생성할 수 있습니다.
그러면 번들이 다아이템으로 변환됩니다.
중간 번들 아이템이 사라집니다.

사용 시나리오

컨벤션에서 물리적 보상:
- 쿠폰 코드 목록을 인쇄하여 컨벤션에서 기념품으로 나눠줄 수 있습니다.
포럼, 푸시 알림 및 이메일 같은 게임외 통신.
- 재획득 캠페인 또는 기타 커뮤니티 행사의 일환으로 플레이어들에게 직접 쿠폰 코드를 보내십시오.
토너먼트:
- 재설정 가능 순위표를 사용할 때 상위 랭킹 플레이어들에게 쿠폰을 보내십시오.

참고 항목

또한 이 경우에는 직접 인벤터리 아이템을 나누어 줄 수 있으므로 게임에 더욱 적합한 것을 고르십시오.

모범 사례

PlayFab 인벤터리를 사용할 때는 인벤터리 사이즈를 비교적 작게 유지해야 합니다 - 플레이어당 총 100 아이템 미만. 너무 많은 항목을 부여하는 번들은 제한되거나 비율이 제한될 수 있습니다.

다음을 통해 공유