Tạo một sản phẩm trong ứng dụng

Khi sử dụng hệ thống thanh toán của Google Play, bạn có thể cung cấp cho người dùng các sản phẩm tính phí một lần trong ứng dụng. Sản phẩm trong ứng dụng có thể là những vật phẩm như hàng hoá ảo (ví dụ: cấp độ hoặc thần dược trong trò chơi) hoặc những dịch vụ cao cấp trong ứng dụng của bạn trên Google Play.

Bạn cũng có thể tạo một gói đăng ký có tính phí định kỳ đối với người dùng.

Lưu ý quan trọng: Chính sách chương trình dành cho nhà phát triển và phí dịch vụ trên Google Play áp dụng cho tất cả sản phẩm trong ứng dụng, bao gồm cả các gói thuê bao và sản phẩm tính phí một lần.

Phạm vi cung cấp

Nếu bạn ở một địa điểm cho phép người bán đăng ký, thì bạn có thể sử dụng hệ thống thanh toán của Google Play.

Nếu bạn đang ở một nơi được hỗ trợ và muốn bắt đầu sử dụng các tính năng của hệ thống thanh toán của Google Play cho ứng dụng của mình, hãy thiết lập một hồ sơ thanh toán và tìm hiểu cách thiết lập hệ thống thanh toán của Google Play trên trang web dành cho nhà phát triển Android.

Để người dùng mua được, sản phẩm trong ứng dụng phải đang hoạt động, và ứng dụng của sản phẩm đó phải nhắm đến quốc gia hoặc khu vực của người dùng. Người dùng sẽ mua được sản phẩm trong ứng dụng miễn là sản phẩm đó còn hoạt động, ngay cả khi ứng dụng đó bị huỷ xuất bản. Nếu không muốn người dùng mua được một sản phẩm trong ứng dụng, bạn sẽ phải huỷ kích hoạt sản phẩm đó.

Nếu bạn đang sử dụng tài khoản kiểm thử, hãy truy cập trang web dành cho nhà phát triển Android để tìm hiểu thêm về việc kiểm thử quá trình tích hợp Thư viện Google Play Billing.

Sau khi bạn tạo một sản phẩm trong ứng dụng, người dùng chạy phiên bản mới nhất của Cửa hàng Google Play sẽ thấy được sản phẩm đó.

Các quyền bắt buộc

Để cung cấp một sản phẩm trong ứng dụng, bạn cần khai báo quyền com.android.vending.BILLING trong tệp kê khai APK của ứng dụng. Nếu muốn phân phối ứng dụng trên toàn thế giới, bạn vẫn có thể xuất bản ứng dụng sử dụng quyền com.android.vending.BILLING ở mọi quốc gia.

Tạo các sản phẩm trong ứng dụng

Tạo một sản phẩm trong ứng dụng

Trước khi tạo sản phẩm, hãy nhớ lên kế hoạch thật cẩn thận cho mã sản phẩm. Mã sản phẩm phải dành riêng cho ứng dụng của bạn, bạn cũng không thể thay đổi hay sử dụng lại những mã này sau khi tạo.

• Mã sản phẩm phải bắt đầu bằng một số hoặc chữ cái viết thường và có thể chứa số (0 đến 9), chữ cái viết thường (a đến z), dấu gạch dưới (_) và dấu chấm (.).
• Bạn không thể thay đổi hoặc sử dụng lại mã sản phẩm sau khi tạo sản phẩm.
• Lưu ý: Hiện bạn không sử dụng được mã sản phẩm android.test cũng như mọi mã sản phẩm bắt đầu bằng android.test.

Để tạo một sản phẩm trong ứng dụng, hãy làm theo các bước sau:

1. Mở Play Console.
2. Chuyển đến trang Sản phẩm trong ứng dụng (Kiếm tiền > Sản phẩm > Sản phẩm trong ứng dụng).
3. Nhấp vào Tạo sản phẩm.
4. Nhập thông tin chi tiết của sản phẩm.
   • Mã sản phẩm: Mã nhận dạng duy nhất cho sản phẩm trong ứng dụng của bạn.
   • Tiêu đề: Tên ngắn của mặt hàng (tối đa 55 ký tự, nhưng bạn chỉ nên sử dụng tiêu đề dài tối đa 25 ký tự để luôn xuất hiện chính xác trong mọi trường hợp), chẳng hạn như "Thuốc ngủ".
   • Nội dung mô tả: Đoạn mô tả dài về mặt hàng (tối đa 200 ký tự), chẳng hạn như "Khiến các sinh vật ngủ ngay lập tức".
   • Biểu tượng: Một hình ảnh chính xác và dành riêng cho sản phẩm của bạn. Đừng chèn văn bản, nội dung quảng cáo hoặc thương hiệu. Biểu tượng sản phẩm sẽ xuất hiện tại trang thông tin của bạn trên Cửa hàng Play và trong quy trình mua.
     • PNG 32 bit
     • 512 x 512 pixel
     • Tối đa 1 MB
   • Giá: Nhập giá bằng nội tệ của bạn hoặc chọn một mẫu định giá.
   • Mua nhiều: Cho phép thanh toán sản phẩm này với số lượng nhiều. Người dùng có thể mua với số lượng nhiều trong ngưỡng dành cho quốc gia/khu vực của họ. Xin lưu ý những thông tin sau:
     • Để thiết lập quy trình thanh toán mua nhiều món hàng trong Play Console, ứng dụng của bạn cần có Thư viện Google Play Billing 4.0. Truy cập trang web dành cho Nhà phát triển Android để tìm hiểu cách tích hợp Thư viện Google Play Billing vào ứng dụng.
     • Một số quốc gia/khu vực chưa cho phép mua nhiều.
     • Ở hầu hết quốc gia/khu vực cho phép mua nhiều đơn vị của một sản phẩm, ngưỡng giá cho mỗi SKU thường vào khoảng 100 USD. Để cho phép thanh toán nhiều đơn vị của một sản phẩm, bạn cần điều chỉnh giá (trước thuế) xuống dưới ngưỡng ở từng quốc gia/khu vực.
   • Dành riêng cho Play Points: Chỉ cung cấp sản phẩm của bạn cho chương trình Google Play Points.
5. Lưu các thay đổi của bạn rồi nhấp vào Kích hoạt để cung cấp sản phẩm trong ứng dụng cho người dùng.

Ngôn ngữ và bản dịch

Các sản phẩm trong ứng dụng sẽ dùng ngôn ngữ mặc định giống như trong ứng dụng. Để thêm bản dịch bằng các ngôn ngữ cụ thể, hãy chọn một sản phẩm trong ứng dụng, sau đó nhấp vào Quản lý bản dịch rồi áp dụng ngôn ngữ bạn muốn. Để tìm hiểu thêm về cách cung cấp trải nghiệm gần gũi và thân thiện cho người dùng, hãy tham khảo bài viết Dịch và bản địa hoá ứng dụng.

Tạo một loạt sản phẩm trong ứng dụng

Để tạo nhiều sản phẩm trong ứng dụng cùng lúc, bạn có thể tải một tệp CSV lên, trong đó có thông tin chi tiết về từng sản phẩm.

Tệp CSV sử dụng dấu phẩy (,) và dấu chấm phẩy (;) để phân tách giá trị dữ liệu. Dấu phẩy phân tách giá trị dữ liệu chính và dấu chấm phẩy phân tách giá trị phụ.

Khi bạn tạo tệp CSV chứa các sản phẩm trong ứng dụng, hãy chỉ định cú pháp CSV ở hàng đầu tiên, tiếp theo là chi tiết sản phẩm trên các hàng tiếp theo.

Lưu ý quan trọng: Mỗi sản phẩm đều phải xuất hiện trọn vẹn trên một dòng duy nhất trong tệp CSV.

Tải tệp CSV chứa các sản phẩm trong ứng dụng lên

Để tải tệp CSV lên, hãy làm theo các bước sau:

1. Mở Play Console.
2. Chuyển đến trang Sản phẩm trong ứng dụng (Kiếm tiền > Sản phẩm > Sản phẩm trong ứng dụng).
3. Nhấp vào Nhập.
   • Việc nhập nhiều sản phẩm bằng cách tải tệp CSV lên sẽ chỉ ghi đè các sản phẩm hiện có khi giá trị của Mã sản phẩm trong tệp CSV khớp với Mã sản phẩm của một sản phẩm hiện có trên danh sách sản phẩm trong ứng dụng. Việc ghi đè một sản phẩm sẽ không xoá các sản phẩm trong ứng dụng không có trong tệp CSV.
4. Thả tệp CSV của bạn để tải lên hoặc nhấp vào Tải lên.

Xuất tệp CSV chứa các sản phẩm hiện tại trong ứng dụng

Để xuất tệp CSV, hãy làm theo các bước sau:

1. Mở Play Console.
2. Chuyển đến trang Sản phẩm trong ứng dụng (Kiếm tiền > Sản phẩm > Sản phẩm trong ứng dụng).
3. Nhấp vào Xuất.

Xem ví dụ về tệp CSV

Dưới đây là ví dụ về cú pháp CSV cần sử dụng và 3 ví dụ về sản phẩm trong ứng dụng:

• Ví dụ đầu tiên xác định tiêu đề và nội dung mô tả bằng 2 loại ngôn ngữ (en_US và es_ES). Mẫu đặt giá giúp xác định giá của mặt hàng.
• Ví dụ thứ hai không sử dụng mẫu đặt giá. Thay vào đó, ví dụ này chỉ định một mức giá cho quốc gia mặc định (Hoa Kỳ). Play Console sử dụng tỷ giá hối đoái hiện hành và mô hình định giá phù hợp với địa phương để tự động đặt mức giá ở tất cả quốc gia khác nơi ứng dụng được phân phối.
• Ví dụ thứ ba cũng không sử dụng mẫu đặt giá. Giá của mặt hàng được chỉ định theo cách thủ công cho từng quốc gia nơi ứng dụng được phân phối.

Ví dụ về cú pháp CSV

Product ID,Published State,Purchase Type,Auto Translate,Locale; Title; Description,Auto Fill Prices,Price,Pricing Template ID

Ví dụ về sản phẩm trong ứng dụng

Ví dụ 1

basic_sleeping_potion,published,managed_by_android,false,en_US; Basic Sleeping Potion; Puts small creatures to sleep.; es_ES; Poción básica de dormir; Causa las criaturas pequeñas ir a dormir.,false,,4637138456024710495

Ví dụ 2

standard_sleeping_potion, published,managed_by_android,false,en_US; Standard Sleeping Potion; Puts all creatures to sleep for 2 minutes.,true, 1990000,

Ví dụ 3

invisibility_potion,published, managed_by_android,false,en_US; Thuốc tàng hình; Tàng hình trước tất cả kẻ thù trong 5 phút.,false, US; 1990000; BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000,

Giá trị dữ liệu cho tệp CSV

Mỗi hàng trong tệp CSV có các sản phẩm trong ứng dụng có thể bao gồm các giá trị sau, nhưng mỗi hàng phải có ít nhất một trong các giá trị này là không xác định:

Product ID	Việc đặt giá trị này trong tệp CSV cũng có tác động như nhập mã sản phẩm khi tạo một sản phẩm mới trong ứng dụng. Nếu bạn chỉ định một Product ID (Mã sản phẩm) được gán cho sản phẩm trong ứng dụng và mã đó đã có trong danh sách sản phẩm, thì dữ liệu cho sản phẩm hiện có trong ứng dụng sẽ bị ghi đè bằng những giá trị mà bạn chỉ định trong tệp CSV.
Publish State	Giá trị này phải được đặt thành published hoặc unpublished. Việc này cũng giống như đặt một sản phẩm trong ứng dụng là Đang hoạt động hoặc Không hoạt động.
Purchase Type	Giá trị này phải được đặt thành managed_by_android.
Dịch tự động	Giá trị này phải được thiết lập thành false (sai) vì tính năng tự động dịch thông tin của sản phẩm trong ứng dụng chưa được hỗ trợ. Nếu bạn muốn cung cấp bản dịch cho tên và nội dung mô tả của một sản phẩm trong ứng dụng, hãy chỉ rõ các bản dịch này trong giá trị Locale (Ngôn ngữ).
Locale, Title, và Description	Nếu chỉ cung cấp một ngôn ngữ cho một mặt hàng, thì bạn phải chỉ định ngôn ngữ mặc định cho ứng dụng cũng như tên và nội dung mô tả cho mặt hàng đó. app_default_locale; item_default_title; item_default_description; Khi đặt giá trị Locale, bạn có thể sử dụng bất kỳ mã ngôn ngữ nào xuất hiện khi thêm bản dịch cho trang thông tin trên Cửa hàng Play. Lưu ý: Khi chỉ định các giá trị Title và Description, hãy dùng dấu gạch chéo ngược để thoát ký tự dấu chấm phẩy (\;) và dấu gạch chéo ngược (\\). Nếu muốn thêm các bản dịch cho tiêu đề và nội dung mô tả của sản phẩm, thì bạn phải liệt kê ngôn ngữ, tiêu đề và nội dung mô tả mặc định, tiếp theo là ngôn ngữ, tiêu đề và nội dung mô tả cho mỗi bản dịch. Trong ví dụ sau, sản phẩm trong ứng dụng dùng en_US (Tiếng Anh Mỹ) làm ngôn ngữ mặc định và es_ES (Tiếng Tây Ban Nha – Tây Ban Nha) làm ngôn ngữ cho bản dịch: en_US; Invisibility Cloak; Makes you invisible.; es_ES; Capote Invisible; Se vuelven invisible. Lưu ý: Mỗi ứng dụng có một ngôn ngữ mặc định, nhưng mỗi sản phẩm trong ứng dụng đều có một danh sách bản dịch riêng. Mặc dù ngôn ngữ đầu tiên trong giá trị Locale của từng sản phẩm phải giống nhau trong toàn bộ tệp CSV, những ngôn ngữ còn lại có thể khác nhau giữa các sản phẩm.
Auto-Fill Prices, Country, và Price	Bạn có thể đặt Auto-fill prices (Tự động điền giá) thành true (đúng) hoặc false (sai). Nếu một sản phẩm trong ứng dụng dùng mẫu đặt giá, thì bạn nên đặt Auto Fill Prices (Tự động điền giá) thành false (sai) và không nên đặt giá trị cho Price (Giá). Lưu ý: Khi bạn chỉ định giá của một sản phẩm trong tệp CSV, hãy cung cấp giá theo đơn vị một phần triệu, trong đó 1.000.000 đơn vị một phần triệu tương đương với 1 đơn vị tiền tệ thực. Sử dụng giá tự động điền Các phần sau đây mô tả tác động của giá trị trong Auto-fill prices (Tự động điền giá) đối với cú pháp và ý nghĩa của các giá trị Country (Quốc gia) và Price (Giá). Nếu đặt Auto-fill prices (Tự động điền giá) thành true (đúng), thì bạn chỉ cần chỉ định giá mặc định của mặt hàng chứ đừng cung cấp giá trị cho Country (Quốc gia). Ví dụ, trong các trường hợp dưới đây: Ngôn ngữ mặc định của ứng dụng là en_US. Giá mặc định (không bao gồm thuế) của một sản phẩm trong ứng dụng là 1,99 USD. Bạn muốn tự động điền giá cho các quốc gia khác. Bạn nên thiết lập giá trị của Auto-fill prices (Tự động điền giá) và Price (Giá) ở cuối hàng trong tệp CSV, chẳng hạn như: true,1990000, Đặt giá riêng biệt cho mỗi quốc gia Nếu đặt Auto Fill Prices (Tự động điền giá) thành false (sai), thì bạn có thể chỉ định một chuỗi giá trị country (quốc gia) và price (giá) cho mọi quốc gia nơi bạn phân phối ứng dụng, bao gồm cả quốc gia tương ứng với ngôn ngữ mặc định của ứng dụng. Mọi giá trị cho country (quốc gia) đều là mã quốc gia ISO viết thường gồm hai chữ cái đại diện cho quốc gia nơi bạn phân phối ứng dụng. Lưu ý: Bạn phải cung cấp mã quốc gia và giá cho từng quốc gia mà ứng dụng nhắm đến. Để xem và chỉnh sửa danh sách quốc gia nơi ứng dụng của bạn nhắm đến, hãy dùng thẻ Quốc gia/khu vực trên trang Phát hành công khai. Mỗi giá trị price (giá) thể hiện chi phí của sản phẩm bằng đơn vị một phần triệu của đơn vị tiền tệ dùng tại quốc gia đó. Ví dụ: nếu bạn cung cấp ứng dụng ở các mức giá sau (đã bao gồm mọi loại thuế) tại các quốc gia khác: 6,99 Real ở Brazil 129 Rúp ở Nga 130 Rupee ở Ấn Độ 27.000 Rupiah ở Indonesia 37 USD ở Mexico Bạn có thể đặt giá trị của Auto-Fill Prices (Tự động điền giá), Country (Quốc gia) và Price (Giá) ở cuối hàng trong tệp CSV, chẳng hạn như: false, BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000;
Pricing Template ID	Nếu một mặt hàng được liên kết với một mẫu đặt giá thì bạn nên đặt Auto-Fill prices (Tự động điền giá) thành false (sai) và không nên đặt giá trị cho cột price (giá). Nếu mặt hàng này không liên kết với mẫu đặt giá nào thì bạn không nên đặt giá trị cho Pricing Template ID (Mã mẫu đặt giá). Thay vào đó, bạn nên đặt giá trị cho Auto Fill Prices (Tự động điền giá), Country (Quốc gia) và Price (Giá) dựa trên giá bạn muốn đặt cho sản phẩm trong ứng dụng. Nếu nhập một tệp CSV, bạn có thể cập nhật mối liên kết giữa sản phẩm trong ứng dụng và mẫu đặt giá. Để liên kết sản phẩm với một mẫu đặt giá cụ thể, hãy đặt giá trị Pricing Template ID (Mã mẫu đặt giá) thành mã của mẫu đặt giá đó. Bạn có thể huỷ liên kết một sản phẩm trong ứng dụng khỏi tất cả mẫu đặt giá bằng cách không đặt giá trị cho Pricing template ID (Mã mẫu đặt giá) của sản phẩm đó. Bạn có thể liên kết tối đa 1.000 mức giá của ứng dụng hoặc mức giá của sản phẩm trong ứng dụng với một mẫu đặt giá cụ thể. Do đó, đừng chỉ định cùng một giá trị Pricing Template ID (Mã mẫu đặt giá) cho hơn 1000 hàng trong tệp CSV.
EEA Withdrawal Right Type (Loại quyền rút lui tại Khu vực kinh tế Châu Âu)	Nếu phân phối cho người dùng ở Khu vực kinh tế Châu Âu (EEA), bạn nên thiết lập giá trị tại đây thành DIGITAL_CONTENT (Nội dung kỹ thuật số) hoặc SERVICE (Dịch vụ).
Reduced VAT Rates (Mức giảm thuế GTGT)	Nếu có bán tin tức, tạp chí, báo, sách, video, nhạc, âm thanh hoặc sách nói dưới dạng kỹ thuật số ở nhiều quốc gia/khu vực, có thể bạn đủ điều kiện được giảm thuế suất GTGT. Đối với mức giảm, các giá trị trong trường này sẽ tuân theo định dạng sau: CountryCode;VATRate; Bạn phải ngăn cách các cặp quốc gia/thuế suất bằng dấu chấm phẩy trước khi thêm cặp quốc gia/thuế suất mới. Ví dụ: CA;BOOKS_1 để thiết lập mức giảm bậc 1 cho Sách tại Canada. FR; NEWS_1; GR; NEWS_2 để thiết lập mức giảm bậc 1 cho Tin tức tại Pháp và mức giảm bậc 2 cho Tin tức tại Hy Lạp. Có thể thiết lập các bậc thành BOOKS_1, NEWS_1, NEWS_2, MUSIC_OR_AUDIO_1, LIVE_OR_BROADCAST_1 (chữ hoa hoặc chữ thường)
Thuế truyền thông và giải trí	Nếu bạn muốn thu thuế truyền thông và giải trí theo quy định hiện hành của tiểu bang, bạn phải chỉ định rằng ứng dụng hoặc sản phẩm của mình là sản phẩm truyền trực tuyến rồi đặt trường này là ELIGIBLE (Đủ điều kiện) hoặc nếu không thì hãy để trống trường này. Hiện tại, quốc gia duy nhất được chấp nhận đối với loại thuế này là Hoa Kỳ. Giá trị của trường này luôn được thiết lập là: CountryCode;Eligibility;Rate Ví dụ: US;ELIGIBLE;VIDEO_RENTAL Nếu đủ điều kiện, bạn có thể thiết lập trường theo các danh mục sau: VIDEO_RENTAL đối với video phát trực tuyến – thuê bao/thuê/trả tiền cho mỗi lần xem VIDEO_SALES đối với video phát trực tuyến – bán hàng VIDEO_MULTI_CHANNEL đối với video phát trực tuyến – đa kênh AUDIO_RENTAL đối với âm thanh phát trực tuyến – thuê bao hoặc thuê AUDIO_SALES đối với âm thanh phát trực tuyến – bán hàng AUDIO_MULTI_CHANNEL đối với âm thanh phát trực tuyến – đa kênh