Reminder: By Aug 31, 2025, all new apps and updates to existing apps must use Billing Library version 7 or newer. If you need more time to update your app, you can request an extension until Nov 1, 2025. Learn about
Play Billing Library version deprecation.
API mặt hàng bên ngoài
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Ở một số quốc gia, nhà phát triển đủ điều kiện có thể đưa người dùng ra bên ngoài ứng dụng, bao gồm cả việc quảng bá ưu đãi cho các tính năng và dịch vụ kỹ thuật số trong ứng dụng. Hướng dẫn này đề cập đến các API để bật mặt hàng bên ngoài. Bạn nên xem yêu cầu của chương trình và đăng ký tham gia chương trình ưu đãi bên ngoài trước khi sử dụng các API này.
Bảng chú giải thuật ngữ
Sau đây là hướng dẫn về quy ước sử dụng thuật ngữ:
- API mặt hàng bên ngoài: API dùng để hướng người dùng ra bên ngoài ứng dụng, bao gồm cả việc hiển thị màn hình thông tin bắt buộc và báo cáo các giao dịch có thể áp dụng.
- Giao dịch bên ngoài: Giao dịch đủ điều kiện diễn ra bên ngoài ứng dụng theo các yêu cầu của chương trình.
- Mã thông báo giao dịch bên ngoài: Mã thông báo được cung cấp cho nhà phát triển thông qua Thư viện Play Billing để họ sử dụng khi người dùng hoàn tất một giao dịch bên ngoài. Mã thông báo này được dùng để thông báo cho Google Play về giao dịch mua thành công.
- Mã giao dịch bên ngoài: Giá trị nhận dạng duy nhất do nhà phát triển tạo ra để xác định một giao dịch bên ngoài.
Hỗ trợ ưu đãi bên ngoài
Phần này mô tả cách hỗ trợ các ưu đãi bên ngoài.
Trước khi sử dụng các API này, hãy đảm bảo:
Định cấu hình trong Play Console
Để định cấu hình ưu đãi bên ngoài trong Play Console, hãy làm theo các bước nêu trong phần yêu cầu của chương trình.
Màn hình thông tin giúp người dùng hiểu rằng họ sắp truy cập vào một trang web bên ngoài. Màn hình thông tin sẽ hiển thị với người dùng mỗi lần họ được chuyển hướng ra ngoài ứng dụng qua các API ưu đãi bên ngoài.
Màn hình thông tin
|
Ví dụ này chỉ nhằm mục đích minh hoạ.
Các bước tiếp theo
Để bắt đầu tích hợp các API ưu đãi bên ngoài, hãy làm theo hướng dẫn chuyên sâu về cả việc tích hợp trong ứng dụng lẫn tích hợp phần phụ trợ.
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-07-27 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-27 UTC."],[],[],null,["# External offers APIs\n\nIn certain countries, eligible developers are able to lead users outside the\napp, including to promote offers for in-app digital features and services. This\nguide addresses the APIs to enable external offers. You should review the\n[program requirements](https://support.google.com/googleplay/android-developer/answer/14372887) and enroll in the external offers program before\nusing these APIs.\n\nGlossary of terms\n-----------------\n\nTerm conventions followed by this guide:\n\n- **External offers APIs**: APIs used to direct the user outside of the app, including surfacing required information screen and reporting applicable transactions.\n- **External transaction** : A qualifying transaction that occurs outside of the app as defined by the [program requirements](https://support.google.com/googleplay/android-developer/answer/14372887).\n- **External transaction token**: A token provided to the developer through the Play Billing Library for the developer to use when the user completes an external transaction. This token is used to notify Google Play of a successful purchase.\n- **External transaction ID**: A unique identifier generated by the developer to identify an external transaction.\n\nSupport external offers\n-----------------------\n\nThis section describes how to support external offers.\nBefore using these APIs, ensure the following:\n\n- Review the eligibility requirements for the relevant program and complete the onboarding steps outlined in the [program requirements](https://support.google.com/googleplay/android-developer/answer/14372887).\n- Integrate [Play Billing Library 6.2.1](/google/play/billing/release-notes) or higher.\n\n### Configure in Play Console\n\nTo configure external offers in Play Console, follow the steps outlined in\nthe [program requirements](https://support.google.com/googleplay/android-developer/answer/14372887).\n\n### Information screen for users\n\nThe information screen helps users understand that they are about to visit an\nexternal website. The information screen will be shown to users each time before\nthey are directed outside of the app using the external offers APIs. \n\n|--------------------|\n| Information screen |\n\nExample for illustrative purposes only.\n\n### Next steps\n\nTo begin integrating the external offers APIs, follow the in-depth guides\nfor both [in-app integration](/google/play/billing/external/integration) and [backend integration](/google/play/billing/outside-gpb-backend)."]]