--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/dev/games/doc/en/console/purchases.md - https://yandex.com/dev/games/doc/hi/console/purchases.md - https://yandex.com/dev/games/doc/ko/console/purchases.md - https://yandex.com/dev/games/doc/ru/console/purchases.md - https://yandex.com/dev/games/doc/tr/console/purchases.md - https://yandex.com/dev/games/doc/vi/console/purchases.md - https://yandex.com/dev/games/doc/zh/console/purchases.md - href: vi/console/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/vi/llms.txt # Mua sắm trong ứng dụ Kết nối mua sắm trong ứng dụng và kiếm tiền từ dịch vụ trả phí (thời gian chơi thêm, vật phẩm cho nhân vật trong trò chơi v.v.). **Các lợi ích**: - **Sự hỗ trợ từ platform**: - Các chiến lược quảng cáo nhằm vào việc thu hút người dùng trả phí cả trong và ngoài nước Nga. - Hệ thống gợi ý thường hiển thị các trò chơi có mua sắm trong ứng dụng. - Trò chơi có mua sắm và chỉ số tốt có thể xuất hiện trong nhiều khung và bộ sưu tập trên trang chủ. - **Sức đặt chốc tài chính**: trò chơi có mua sắm trong ứng dụng ít bị ảnh hưởng bởi sự thay đổi theo mùa và sự động đảo của thu nhập quảng cáo. - **Người chơi quay lại**: người dùng đã mua hàng sẽ quay lại trò chơi nhiều hơn sau khi họ đã chi tiền cho nội dung của nó. - **Quá trình chơi mượt mà**: mua sắm được tích hợp một cách tự nhiên vào gameplay, bổ sung và cải thiện nó. {% note alert "Hạn chế" %} Trước khi thêm mua sắm, hãy cấu hình [kiểm tra thanh toán chưa xử lý](https://yandex.com/dev/games/doc/vi/sdk/sdk-purchases.md#check-purchases). Kiểm tra này [bắt buộc](../concepts/requirements#1-13-1) để qua bước kiểm duyệt, vì vậy nó quan trọng để cấu hình ngay cả cho các giao dịch thử nghiệm. Nếu bạn thêm mua sắm vào trò chơi và kiểm tra chúng trước khi cấu hình sử dụng, sau khi kiểm tra có thể còn lại các thanh toán chưa xử lý, điều này sẽ khiến việc qua bước kiểm duyệt trở nên không thể. {% endnote %} ## Tiền portal {#currency} Tiền portal của platform [Yandex Games](https://yandex.com/games/) được sử dụng để thanh toán cho mua sắm trong trò chơi. Nó được lưu trên một sẵn dành riêng cho tất cả các trò chơi trong tài khoản người chơi, có thể nạp tiền bằng thẻ ngân hàng. Tỷ giá tiền portal so với ruble là động. {% note info "Ghi chú" %} Cho thanh toán quốc tế, [tỷ lệ](#portal-currency-rate) tiền portal so với tiền quốc gia sẽ phụ thuộc vào quốc gia của người chơi. {% endnote %} Có thể nạp tiền: - trong phần đầu trang của danh mục; - trong hồ sơ người chơi; - trong quá trình mua sắm trong trò chơi. Người dùng cũng có thể nhận tiền portal làm thưởng cho sự tham gia vào các chiến dịch hoặc mua các bộ gói định trước. Các người dùng đã đăng nhập vào Yandex và những người chưa đăng nhập đều có thể mua sắm trong trò chơi. Người dùng có thể đăng nhập trong quá trình chơi, bao gồm cả lúc mua sắm. Thứ tự và điều kiện thanh toán phần trăm quyền sẽ không thay đổi vì việc giới thiệu tiền portal. ## Kết nối mua sắm {#connect} ### Bước 1. Gửi yêu cầu kết nối 1. [Kích hoạt monetization](https://yandex.com/dev/games/doc/vi/console/adv-monetization.md#enable-monetization). Để làm điều này, gửi đơn xin tham gia vào Yandex Advertising Network và chờ xét duyệt. Kiểm tra xem trong [giao diện đối tác Yandex Advertising Network](https://partner2.yandex.com/) bạn có chỉ định thông tin cho thanh toán quảng cáo và mua sắm hay chưa. Nếu chưa, nhấn nút **Add bank details**, điền vào các ô và gửi dữ liệu. Sau khi kiểm tra dữ liệu, trạng thái hợp đồng trong giao diện Yandex Advertising Network trong phần **Extras → Documents** sẽ thay đổi thành **Offer accepted**. {% note alert "Hạn chế" %} Các giao dịch trong trò chơi chỉ có thể được kết nối sau khi chấp thuận đơn hàng. {% endnote %} 1. Kết nối các giao dịch. Để làm điều này, gửi email yêu cầu kết nối tới [games-partners@yandex-team.com](mailto:games-partners@yandex-team.com). Chỉ rõ: - Tên trò chơi; - Mã số (ID) của trò chơi. Chờ email từ [games-partners@yandex-team.com](mailto:games-partners@yandex-team.com) xác nhận rằng các giao dịch đã được phép. ### Bước 2. Cập nhật tệp ngọc ngành của trò chơi {#update-files} 1. [Thêm mã SDK](https://yandex.com/dev/games/doc/vi/sdk/sdk-purchases.md#sdk-purchases) vào tệp ngọc ngành của trò chơi. 1. Hãy truy cập vào [Bảng điều khiển](https://games.yandex.com/console) bằng tài khoản nhà phát triển của bạn. 1. Ở góc trên bên trái của bảng điều khiển, nhấn [Games](https://games.yandex.com/console/applications). 1. Tìm trò chơi đã tải lên trước đó trong danh sách và nhấn vào tên của nó. 1. Chuyển sang ngăn **Draft**. 1. Sửa đổi các ô và tải lên tệp zip mới. Mô tả chi tiết các ô xem tại phần [Thêm trò chơi](https://yandex.com/dev/games/doc/vi/console/add-new-game.md#add-new-game). ### Bước 3. Thêm giao dịch {#add-purchases} {% note alert "Hạn chế" %} Số lượng giao dịch tối đa — 500. {% endnote %} {% list tabs %} * Tải lên riêng lẻ 1. Chuyển sang ngăn **In-app purchases** → **Inaps**. 1. Nhấn **Add in-app**. 1. Điền vào các ô: #| || **Trường** | **Mô tả** | **Bắt buộc** || || **ID** | Mã số giao dịch, sẽ được truyền trong phương thức `payments.purchase()`. |::{align="center"} ![](../_images/yes-button.svg) || || **Item Name** | Tên giao dịch tiếng Việt và tiếng Anh. Sẽ hiển thị trong cửa sổ hộp thoại khi thanh toán giao dịch. |::{align="center"} ![](../_images/yes-button.svg) || || **Item Description** | Mô tả giao dịch tiếng Việt và tiếng Anh. Sẽ hiển thị trong cửa sổ hộp thoại khi thanh toán giao dịch. Giới hạn — 200 ký tự. || || **Price** | [Giá của giao dịch](#portal-currency-rate) cho người dùng trong tiền tệ của cổng. Số nguyên. |::{align="center"} ![](../_images/yes-button.svg) || || **Item Icon** | Kích thước — 256 × 256 pixel. Định dạng — PNG. Sẽ hiển thị trong cửa sổ hộp thoại khi thanh toán giao dịch. || |# 1. Nhấn **Add**. Bảng với giao dịch sẽ được cập nhật. * Tải lên theo nhóm 1. Chuyển sang ngăn **In-app purchases** → **Inaps**. 1. Xem mẫu tại liên kết **Download an example** và chuẩn bị tệp tải lên trong định dạng [CSV](*csv). Kiểm tra xem các trường bắt buộc đã được điền chưa: #| || **Trường** | **Mô tả** | **Bắt buộc** || || `id` | Mã số giao dịch sẽ được truyền vào phương thức `payments.purchase()`. |::{align="center"} ![](../_images/yes-button.svg) || || `price` | Giá của giao dịch cho người dùng bằng tiền tệ cửa cổng. Số nguyên. |::{align="center"} ![](../_images/yes-button.svg) || || `title_en` | Tiêu đề giao dịch bằng tiếng Anh. |::{align="center"} ![](../_images/yes-button.svg) || || `description_en` | Mô tả giao dịch bằng tiếng Anh. Giới hạn 200 ký tự. | || || `title_ru` | Tiêu đề giao dịch bằng tiếng Nga. |::{align="center"} ![](../_images/yes-button.svg) || || `description_ru` | Mô tả giao dịch bằng tiếng Nga. Giới hạn 200 ký tự. | || |# 1. Bấm nút **Upload a CSV file**. 1. Chọn giao dịch để tải lên trên các ngăn: - **Ready for import** — giao dịch với mã số mới. Nếu chúng được tải, hệ thống sẽ tạo ra các giao dịch mới. - **Matches** — giao dịch có mã số đã tồn tại trong hệ thống. Nếu chúng được tải, các giao dịch hiện tại sẽ được cập nhật. Trên ngăn **Errors** bạn có thể xem các giao dịch gặp vấn đề. Để tải chúng, quay lại bước 2 và sửa các trường trong tệp CSV. {% note alert "Hạn chế" %} Lần tải một lúc tối đa 100 giao dịch. Nếu số lượng in-app trong tệp vượt quá giới hạn cho phép, sẽ chỉ tải 100 phần tử đầu tiên. {% endnote %} 1. Bấm **Import \ in-apps**. Bảng giao dịch sẽ được cập nhật. {% note info "Ghi chú" %} Nếu bạn muốn sử dụng biểu tượng riêng của mình, tải nó riêng lẻ trên bảng điều khiển, bằng cách [sửa đổi](#edit) giao dịch. {% endnote %} {% endlist %} ### Bước 4. Đăng công thị sản phẩm mới {#publish-new-version} {% note tip "Lời khuyên" %} - Trước khi đi qua quy trình kiểm duyệt, bạn có thể tự [thử nghiệm trò chơi](https://yandex.com/dev/games/doc/vi/console/test-game.md#test-game). - Nếu bạn không muốn gửi trò chơi để kiểm duyệt ngay lập tức, hãy lưu bản nháp trò chơi (trạng thái sẽ thay đổi thành **Created**), để quay lại chỉnh sửa các trường sau này. {% endnote %} 1. Chuyển sang ngăn **Draft**. 1. Nếu bạn muốn chọn thời điểm đăng công thị trò chơi, chọn tuỳ chọn **Postpone publication**. Ngược lại, trò chơi sẽ được đăng công thị ngay sau khi kiểm duyệt. 1. Bấm **Submit for moderation**. {% note info "Ghi chú" %} Nếu trò chơi đã được kiểm tra hơn 100 ngày trước, bạn sẽ thấy một cảnh báo rằng yêu cầu có thể đã thay đổi. Từ chối gửi để kiểm duyệt, hãy làm quen với các yêu cầu và kiểm tra xem trò chơi có đáp ứng chúng không. Sau đó, gửi lại trò chơi để kiểm duyệt. {% endnote %} Trò chơi sẽ được tải lên máy lên máy chủ Yandex và trạng thái sẽ thay đổi thành **Waiting for moderation**. Ứng dụng sẽ được kiểm tra để đảm bảo phù hợp với [yêu cầu](https://yandex.com/dev/games/doc/vi/concepts/requirements.md). Việc kiểm duyệt thường mất từ ba đến năm ngày làm việc. Kết quả kiểm tra sẽ hiển thị trên bảng điều khiển: {% list tabs %} - Với tuỳ chọn Postpone publication - Nếu trò chơi được chấp thuận, trạng thái bản nháp sẽ thay đổi thành **Verified**, trên ngăn **Draft** sẽ xuất hiện nút **Publish**, và trên ngăn **In-app purchases** → **Inaps** — trạng thái **Purchases are enabled**. Tại ngăn **Draft**, bấm **Publish**. Sau vài phút, trạng thái sẽ thay đổi thành **Published**, và người dùng có thể tìm trò chơi của bạn trong danh mục [Yandex Games](https://yandex.com/games/). - Mà không có tuỳ chọn - Nếu trò chơi được chấp thuận, trạng thái bản nháp sẽ thay đổi thành **Published**, và trạng thái trên ngăn **In-app purchases** → **Inaps** — thành **Purchases are enabled**. Trò chơi của bạn sẽ có sẵn trong danh mục [Yandex Games](https://yandex.com/games/). {% endlist %} - Nếu trò chơi không được duyệt, bản nháp sẽ chuyển vào trạng thái **Rejected**, và chúng tôi sẽ gửi email giải thích tại sao trò chơi không được chấp nhận. Hãy đưa vào các sửa đổi cần thiết và trở lại bước 1. Sau khi kết nối các giao dịch, bạn có thể [sửa đổi](#edit) các tham số của chúng. ## Kiểm thử giao dịch {#test} {% note info "Ghi chú" %} Kiểm thử giao dịch có thể được thực hiện trong bản nháp của trò chơi, trước khi gửi đề xuất duyệt và trước khi đăng cập. {% endnote %} Để kiểm thử giao dịch, hãy thêm tài khoản vào danh sách cho việc mua sắm thử: 1. Hãy truy cập vào [Bảng điều khiển](https://games.yandex.com/console) bằng tài khoản nhà phát triển của bạn. 1. Ở góc trên bên trái của bảng điều khiển, nhấn [Games](https://games.yandex.com/console/applications). 1. Tìm trò chơi cần thiết trong danh sách và nhấn vào tên của nó. 1. Chuyển đến ngăn **In-app purchases**. 1. Chọn **Settings**. 1. Trong khối **List of logins for test purchases**: 1. Nhập tài khoản [Yandex ID](https://id.yandex.com/) mà bạn dự định sử dụng cho việc kiểm thử mua sắm. 1. Nhấn nút **Add**. Tài khoản sẽ xuất hiện trong danh sách. Bạn sẽ có thể kiểm thử mua sắm dưới tài khoản này sau một vài phút. Phí sẽ không được trả cho chúng. ## Sửa đổi giao dịch {#edit} Sau khi kết nối giao dịch và đăng cập trò chơi, bạn có thể thay đổi các tham số của chúng. Hãy theo dõi để chắc chắn rằng chúng phù hợp với mã hiện hành của trò chơi và nếu cần, [cập nhật](../console/update-game#update-game) nó. Điều này sẽ yêu cầu việc duyệt lại. Trước khi đó, phiên bản cũ của trò chơi sẽ được giữ lại trong danh mục. Để sửa đổi hoặc xóa giao dịch: 1. Hãy truy cập vào [Bảng điều khiển](https://games.yandex.com/console) bằng tài khoản nhà phát triển của bạn. 1. Ở góc trên bên trái của bảng điều khiển, nhấn [Games](https://games.yandex.com/console/applications). 1. Tìm trò chơi trước đó trong danh sách và nhấn vào tên của nó. 1. Chuyển đến ngăn **In-app purchases** → **Inaps**. 1. Tìm giao dịch trong danh sách và nhấn vào tên của nó: {% list tabs %} - Sửa đổi giao dịch 1. Thay đổi vào các trường cần thiết. 1. Nhấn **Edit**. - Xóa giao dịch Nhấn nút **Remove**. {% note alert "Hạn chế" %} Hãy nhớ rằng bạn cần xóa không chỉ giao dịch mà còn cả mã liên quan trong trò chơi. Ngược lại, người chơi sẽ thấy giao dịch nhưng sẽ không thể sử dụng nó. {% endnote %} {% endlist %} 1. Nếu bạn đã thay đổi mã của trò chơi, [tải lên tập tin mới](https://yandex.com/dev/games/doc/vi/console/update-game.md). 1. [Đăng cập phiên bản mới của trò chơi](#publish-new-version). ## Tỷ giá tiền tệ cổng {#portal-currency-rate} Bạn có thể biết giá trị của một số lượng tiền portal định kỳ trong tiền thật cho các nước khác nhau: 1. Hãy truy cập vào [Bảng điều khiển](https://games.yandex.com/console) bằng tài khoản nhà phát triển của bạn. 1. Ở góc trên bên trái của bảng điều khiển, nhấn [Games](https://games.yandex.com/console/applications). 1. Tìm trong danh sách trò chơi đã tải về trước đó và nhấn vào tên của nó. 1. Chuyển sang ngăn nội dung **In-app purchases**. 1. Chọn **Prices in countries and regions**. 1. Trong ô **The cost of 1 in-app \ yan**, nhập số lượng tiền portal cần thiết. Kết quả sẽ hiển thị dưới dạng cột trong bảng: - **Your share** — hoặc của bạn cho giao dịch đã hoàn thành. - **The price for the player** — giá mua cho người chơi trong tiền của quốc gia họ. ## Thống kê và thanh toán cho mua sắm trong trò chơi {#money} ### Thanh toán {#payments} Cho việc cung cấp bằng sạch để sử dụng trò chơi, Yandex sẽ trả một hoặc bản quyền sau khi trừ thuế (nếu áp dụng theo luật pháp RF). Hoặc sẽ tích lũy cho đến khi đạt đến ngưỡng thanh toán. Khi ngưỡng được đạt, Yandex sẽ gửi cho bạn một báo cáo tổng kết về hoặc trên email. Hoặc sẽ được trả trong tháng tiếp theo. {% note info "Ghi chú" %} Thu nhập được tính toán theo tất cả các trò chơi của bạn, trong đó có mua sắm trong trò chơi được bật. {% endnote %} Xem chi tiết hơn trong phần [8. Fees and Payment](https://yandex.com/legal/licensegames/en/#fees-and-payment) Thỏa thuận Bằng sạch. ### Thống kê {#statistics} Xem báo cáo chi tiết về mua sắm trong trò chơi tại [Bảng Điều Khiển Yandex Games](https://games.yandex.com/console) trên ngăn nội dung [Purchase metrics](https://yandex.com/dev/games/doc/vi/console/purchase-metrics.md). [*csv]: Giá trị được phân tách bởi dấu phẩy.