--- metadata: - name: generator content: Diplodoc Platform v5.57.3 alternate: - https://yandex.com/dev/games/doc/en/sdk/construct-3/in-game-purchases.md - https://yandex.com/dev/games/doc/hi/sdk/construct-3/in-game-purchases.md - https://yandex.com/dev/games/doc/ko/sdk/construct-3/in-game-purchases.md - https://yandex.com/dev/games/doc/ru/sdk/construct-3/in-game-purchases.md - https://yandex.com/dev/games/doc/tr/sdk/construct-3/in-game-purchases.md - https://yandex.com/dev/games/doc/vi/sdk/construct-3/in-game-purchases.md - https://yandex.com/dev/games/doc/zh/sdk/construct-3/in-game-purchases.md - href: ko/sdk/construct-3/in-game-purchases.md type: text/markdown title: Markdown version - href: ../../llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/games/doc/ko/llms.txt # 게임 내 구매 사용자가 게임 내에서 구매할 수 있는 기능을 제공함으로써 수익을 올릴 수 있습니다. 예를 들어, 레벨 완료 시간을 연장하거나 게임 캐릭터를 위한 액세서리를 제공할 수 있습니다. 이를 위해: - [게임 내 구매를 연결](https://yandex.com/dev/games/doc/ko/console/purchases.md#connect) 하여 야닉스 게임 개발자 콘솔을 설정합니다. - SDK에서 구매 기능을 설정합니다. ## 포털 화폐 얀(Yan)은 야닉스 게임 플랫폼의 포털 화폐로, 게임 내 구매를 결제하는 데 사용됩니다. 얀은 각 게임의 통합된 잔액으로 저장되며, 신용카드를 통해 충전할 수 있습니다. 얀의 루블 환율은 변동적입니다. {% note info "참고" %} 국제 결제 시 얀의 환율은 플레이어의 국가에 따라 달라집니다. {% endnote %} 잔액 충전은 다음과 같은 방법으로 가능합니다: - 카탈로그 상단; - 플레이어 프로필; - 게임 내 구매 중. 사용자는 또한 프로모션 참여 또는 고정 패키지 구매를 통해 얀을 보너스로 받을 수 있습니다. 게임 내 구매는 야닉스에 로그인한 사용자와 로그인하지 않은 사용자 모두 가능합니다. 사용자는 구매 시점에 게임 중 직접 로그인할 수 있습니다. 포털 화폐의 도입으로 인해 개발자에 대한 라이선스 보상의 지급 조건과 절차는 변경되지 않습니다. ## 연결 조건 구매를 추가하고 게임 초안을 게시한 후 구매 연결 요청 이메일을 [games-partners@yandex-team.com](mailto:games-partners@yandex-team.com)로 보내세요. 이메일에는 게임의 이름과 식별자(ID)를 반드시 포함해야 합니다. 구매가 허용되었다는 확인 이메일을 수신한 후, 구매 설정 및 테스트가 가능합니다. ## 구매 프로세스 게임 내 구매 프로세스를 활성화하려면 **Initialize purchase** 메서드를 사용하여 다음의 매개변수를 사용하세요: #| || ID | `string` | 카탈로그에서 제품의 고유 식별자. || || Payload | `string` | 구매와 함께 전송되는 선택적 데이터. || |# 플레이어가 성공적으로 구매를 완료하면 트리거 **Specific product purchase success** 및 **On any purchase success**가 활성화됩니다. 그러나 플레이어가 구매를 완료하지 않고 창을 닫으면 트리거 **Specific product purchase error** 및 **On any purchase error**가 활성화됩니다. 위에 언급한 트리거는 성공적이거나 실패한 구매를 처리하기 위한 표현식에 대한 액세스를 제공합니다: ![](../../_images/construct-3/in-game-purchases/purchase-example.png) ## 구매 처리 구매에는 두 가지 유형이 있습니다: - 한 번만 구매하는 영구적인 구매; - 여러 번 구매할 수 있는 소비성 구매. 두 가지 유형의 구매를 처리하려면, 내장 루프 **For each purchase** 를 사용하는 것이 좋습니다. 이 루프는 표현식에 대한 액세스를 제공합니다: ![](../../_images/construct-3/in-game-purchases/for-each-purchase-expressions.png) ### 영구적인 구매 (광고 비활성화) 영구적인 구매 처리 로직: - 성공적으로 구매한 후 광고를 비활성화합니다. - 각 게임 시작 시 구매가 활성화되어 있는지 확인하고, 활성화되어 있다면 광고를 비활성화합니다. ![](../../_images/construct-3/in-game-purchases/non-consumable-purchase-example.png) ### 소비성 구매 (게임 내 화폐) 소비성 구매 처리 로직: - 성공적으로 구매한 후 **Consume purchase** 메서드로 구매를 처리하고 게임 내 화폐를 제공합니다. - 각 게임 시작 시 여전히 구매가 있는지 확인하고, 있다면 **Consume purchase** 메서드로 구매를 처리하고 게임 내 화폐를 제공합니다. ![](../../_images/construct-3/in-game-purchases/consumable-purchase-example.png) ## 상품 카탈로그 사용 가능한 구매 목록, 가격, 이름 및 설명을 얻으려면 **For each product in catalog** 루프를 사용하세요. 이 루프는 표현식에 대한 액세스를 제공합니다: ![](../../_images/construct-3/in-game-purchases/for-each-product-expressions.png) ![](../../_images/construct-3/in-game-purchases/for-each-in-catalog-example.png) --- 저장소