Giữ chân người đăng ký bằng ưu đãi giữ chân

Ưu đãi giữ chân người dùng giúp bạn giảm tỷ lệ người dùng chủ động rời bỏ ứng dụng bằng cách cho người đăng ký thấy một khoản chiết khấu ngay khi họ tìm cách huỷ gói thuê bao trên Google Play.

Khi một người đăng ký đủ điều kiện bắt đầu huỷ, Google Play sẽ cho họ thấy một ưu đãi giữ chân mà bạn đã định cấu hình, chẳng hạn như "Duy trì gói thuê bao và được giảm giá 50% cho 2 tháng tiếp theo". Nếu người đăng ký chấp nhận ưu đãi, thì gói thuê bao của họ sẽ không bị huỷ. Giá chiết khấu sẽ bắt đầu áp dụng vào ngày tính phí tiếp theo của họ.

Trang này giải thích cách hoạt động của ưu đãi giữ chân người dùng, cách định cấu hình ưu đãi, cách xử lý các sự kiện phát sinh trong phần phụ trợ và cách thử nghiệm ưu đãi.

Trước khi bắt đầu

Trước khi thiết lập ưu đãi giữ chân người dùng, hãy đảm bảo rằng bạn đã làm những việc sau:

Vì Google Play hiển thị ưu đãi giữ chân bên ngoài ứng dụng, nên bạn không cần phải thay đổi ứng dụng hoặc cập nhật chế độ tích hợp Thư viện Google Play Billing để sử dụng các ưu đãi đó. Tất cả công việc tích hợp đều diễn ra trong Google Play Console và phần phụ trợ của bạn.

Cách hoạt động của ưu đãi giữ chân người dùng

Ưu đãi giữ chân người dùng chỉ xuất hiện trong phần quản lý gói thuê bao trên Google Play: ứng dụng Cửa hàng Google Play và Google Play trên web. Ưu đãi này không xuất hiện trong ứng dụng của bạn. Google Play Billing Library không trả về ưu đãi giữ chân người dùng trong kết quả queryProductDetailsAsync(), nên các ưu đãi này không có trong ProductDetails.getSubscriptionOfferDetails() và bạn không thể bán các ưu đãi này thông qua launchBillingFlow(). Nếu ứng dụng của bạn sử dụng đường liên kết sâu để đưa người đăng ký đến trung tâm quản lý gói thuê bao của Google Play hoặc đến một gói thuê bao cụ thể để họ có thể quản lý hoặc huỷ gói thuê bao đó, thì những người đăng ký đó có thể thấy ưu đãi giữ chân khi họ bắt đầu huỷ gói thuê bao tại đó.

Các bước sau đây mô tả những gì xảy ra khi người đăng ký cố gắng huỷ:

  1. Người đăng ký mở gói thuê bao của họ trong Google Play và bắt đầu huỷ gói thuê bao đó.
  2. Google Play sẽ kiểm tra xem người đăng ký có đủ điều kiện nhận một trong các ưu đãi giữ chân của bạn hay không, dựa trên quy tắc về điều kiện mà bạn đặt cho ưu đãi hoặc dựa trên việc bạn có nhắm mục tiêu ưu đãi đến người đăng ký đó hay không.

  3. Nếu người đăng ký đủ điều kiện, Google Play có thể hiển thị ưu đãi giữ chân người dùng thay vì huỷ. Việc đáp ứng các tiêu chí của bạn không đảm bảo rằng ưu đãi sẽ xuất hiện, vì Google Play cũng thực hiện các bước kiểm tra bổ sung ở cấp nền tảng, chẳng hạn như các yêu cầu tuân thủ theo khu vực. Nếu Google Play hiển thị ưu đãi, thì người đăng ký có thể làm một trong những việc sau:

    • Chấp nhận ưu đãi: Người đăng ký chấp nhận chỉ bằng một lần nhấn. Gói thuê bao vẫn hoạt động và tự động gia hạn. Người đăng ký không bị tính phí ngay lập tức; giá chiết khấu sẽ áp dụng kể từ kỳ thanh toán tiếp theo.
    • Tiếp tục huỷ: Người đăng ký từ chối ưu đãi và hoàn tất quy trình huỷ tiêu chuẩn. Bạn nhận được thông báo SUBSCRIPTION_CANCELED thông thường. Để biết thông tin chi tiết, hãy xem phần Huỷ.

Nếu người đăng ký rời khỏi quy trình huỷ mà không chấp nhận ưu đãi hoặc huỷ, thì gói thuê bao của họ sẽ không thay đổi. Điều này áp dụng cho cả ứng dụng Cửa hàng Google Play và Google Play trên web. Việc xem ưu đãi giữ chân người dùng mà không chấp nhận sẽ không được tính vào giới hạn nhận ưu đãi hoặc bắt đầu thời gian chờ giữa các ưu đãi. Google Play sẽ kiểm tra giới hạn nhận ưu đãi khi hiển thị ưu đãi và kiểm tra lại khi người đăng ký chấp nhận ưu đãi. Ưu đãi được chấp nhận sẽ được tính vào giới hạn nhận ưu đãi khi gói thuê bao gia hạn ở mức giá chiết khấu. Thời gian chờ giữa các ưu đãi bắt đầu khi kỳ chiết khấu của ưu đãi giữ chân khách hàng trước đó cho cùng một gói cơ bản kết thúc. Người đăng ký có thể thấy lại ưu đãi này vào lần tiếp theo họ tìm cách huỷ, miễn là họ vẫn đủ điều kiện.

Chuyển đổi gói theo lịch

Khi người đăng ký chấp nhận ưu đãi giữ chân, Google Play sẽ mô hình hoá ưu đãi đó dưới dạng chuyển đổi gói theo lịch trong giao dịch mua hiện có của người đăng ký. Thao tác này khác với thay thế bị trì hoãn, yêu cầu quy trình mua mới và tạo mã thông báo giao dịch mua mới. Với ưu đãi giữ chân, người đăng ký vẫn giữ nguyên purchaseToken và chỉ có điều khoản thanh toán trong tương lai thay đổi.

Khi người đăng ký chấp nhận ưu đãi, Google Play sẽ làm như sau:

  • Gửi RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) đến phần phụ trợ của bạn.
  • Thêm đối tượng planTransitionDetails vào trường autoRenewingPlan của mục hàng bị ảnh hưởng trong tài nguyên SubscriptionPurchaseV2.

Để biết thông tin chi tiết về cách xử lý các sự kiện này, hãy xem phần Xử lý các sự kiện ưu đãi giữ chân người dùng trong phần phụ trợ của bạn.

Điều kiện sử dụng

Gói thuê bao có thể nhận được ưu đãi giữ chân bất cứ lúc nào trước lần gia hạn tiếp theo, miễn là tất cả những điều sau đây đều đúng:

  • Gói thuê bao đang hoạt động và tự động gia hạn. Gói thuê bao trong thời gian ân hạn, đang tạm ngưng tài khoản hoặc tạm dừng không thể nhận ưu đãi giữ chân người dùng.
  • Gói thuê bao này là một gói thuê bao đơn lẻ. Ưu đãi giữ chân không được hỗ trợ cho gói thuê bao có gói bổ sung.
  • Gói thuê bao không sử dụng gói cơ bản trả góp. Gói cơ bản trả góp không đủ điều kiện nhận ưu đãi giữ chân người dùng.
  • Khoản thanh toán tiếp theo sẽ theo giá định kỳ thông thường của gói cơ bản. Nếu người đăng ký đang trong giai đoạn dùng thử miễn phí hoặc giai đoạn giá ưu đãi, thì ưu đãi chỉ áp dụng trong kỳ thanh toán cuối cùng của giai đoạn đó, khi lần gia hạn sắp tới là theo giá thông thường.
  • Người đăng ký không nằm trong kỳ thanh toán được chiết khấu của một ưu đãi giữ chân người dùng đã được chấp nhận trước đó. Người đăng ký đang trong giai đoạn chiết khấu của một ưu đãi giữ chân người dùng không thể nhận một ưu đãi giữ chân người dùng khác cho đến khi gói thuê bao gia hạn theo giá gói cơ bản thông thường.
  • Gói thuê bao không có gói chuyển đổi nào đang chờ xử lý. Một gói thuê bao có thể có tối đa một lượt chuyển đổi gói theo lịch đang chờ xử lý, tức là một đối tượng planTransitionDetails ở trạng thái IN_PROGRESS. Ví dụ: một người đăng ký đã chấp nhận ưu đãi giữ chân nhưng ưu đãi đó chưa có hiệu lực thì không thể nhận một ưu đãi khác.
  • Gói thuê bao không có thay đổi về giá chưa được xác nhận.
  • Giá chiết khấu của ưu đãi giữ chân người dùng thấp hơn hoặc bằng giá gia hạn gói cơ bản tiếp theo của người đăng ký.
  • Người đăng ký đáp ứng các quy tắc đủ điều kiện mà bạn đã định cấu hình cho ưu đãi. Đối với ưu đãi giữ chân người dùng, bạn đã kích hoạt tính năng nhắm mục tiêu cho gói thuê bao bằng phương thức activateOfferTargeting.

Định cấu hình ưu đãi giữ chân người dùng

Bạn có thể tạo ưu đãi giữ chân người dùng trong Google Play Console hoặc bằng cách sử dụng Google Play Developer API. Mỗi ưu đãi giữ chân khách hàng đều sử dụng một trong các chế độ nhắm mục tiêu sau:

Một gói cơ bản có thể có nhiều ưu đãi giữ chân khách hàng đang hoạt động ở cùng một quốc gia hoặc khu vực. Khi người đăng ký đủ điều kiện nhận nhiều ưu đãi, Google Play sẽ hiển thị tối đa một ưu đãi giữ chân người dùng trong quy trình huỷ. Google Play chọn ưu đãi theo thứ tự sau:

  1. Chế độ nhắm mục tiêu: Ưu đãi nhắm đến từng người dùng (retentionPerUserRule) luôn được ưu tiên hơn ưu đãi dựa trên quy tắc (retentionRule), ngay cả khi ưu đãi dựa trên quy tắc có tỷ lệ chiết khấu cao hơn.
  2. Phần trăm chiết khấu: Trong số các ưu đãi đủ điều kiện sử dụng cùng một chế độ nhắm mục tiêu, Google Play sẽ hiển thị ưu đãi có phần trăm chiết khấu cao nhất.
  3. Giá chiết khấu: Nếu các ưu đãi có cùng tỷ lệ chiết khấu, Google Play sẽ hiển thị ưu đãi có giá chiết khấu thấp nhất.
  4. Mã ưu đãi: Nếu các ưu đãi vẫn có cùng mức độ ưu tiên, thì Google Play sẽ hiển thị ưu đãi có offerId đứng cuối theo thứ tự bảng chữ cái.

Tạo ưu đãi giữ chân người dùng trong Play Console

Để tạo ưu đãi giữ chân người dùng trong Google Play Console, hãy làm như sau:

  1. Chuyển đến phần Kiếm tiền qua Play > Sản phẩm > Gói thuê bao.
  2. Chọn một gói thuê bao, sau đó chọn gói cơ bản mà bạn muốn thêm ưu đãi.
  3. Thêm ưu đãi cho Người đăng ký hiện tại đang tìm cách huỷ gói.
  4. Chọn Ưu đãi giữ chân người dùng ở cấp nhóm thuần tập hoặc Ưu đãi giữ chân người dùng ở cấp người dùng.

Tạo ưu đãi giữ chân khách hàng bằng API Nhà phát triển Google Play

Bạn cũng có thể tạo và cập nhật ưu đãi giữ chân người dùng theo phương thức lập trình. Để tạo một ưu đãi, hãy gọi phương thức monetization.subscriptions.basePlans.offers.create. Để cập nhật ưu đãi hiện có, hãy gọi phương thức monetization.subscriptions.basePlans.offers.patch hoặc monetization.subscriptions.basePlans.offers.batchUpdate. Cả ba phương thức đều hỗ trợ các trường retentionRule, retentionPerUserRule, startTime và endTime. Trong đối tượng SubscriptionOffer, hãy đặt các trường sau:

  • offerId: Mã ưu đãi giữ chân người dùng duy nhất của bạn.
  • targeting: Đặt retentionRule thành một đối tượng RetentionTargetingRule xác định người đủ điều kiện nhận ưu đãi. Để biết các trường có sẵn, hãy xem bài viết Thiết lập quy tắc về điều kiện lưu giữ. Để chọn người đăng ký đủ điều kiện từ phần phụ trợ, hãy đặt retentionPerUserRule. Để biết thông tin chi tiết, hãy xem bài viết Nhắm mục tiêu ưu đãi giữ chân người đăng ký đến những người đăng ký cụ thể.
  • phases[]: Ưu đãi giữ chân khách hàng chỉ hỗ trợ một giai đoạn tính giá. Trong giai đoạn đó, hãy đặt các trường sau:
    • recurrenceCount: Số kỳ thanh toán mà ưu đãi giảm giá kéo dài, từ 1 đến 52. Nếu recurrenceCount lớn hơn 1, thì giai đoạn duration phải bằng kỳ thanh toán của gói cơ bản.
    • regionalConfigs[]: Đặt relativeDiscount thành mức chiết khấu dưới dạng một phân số lớn hơn 0 và nhỏ hơn 1. Ví dụ: sử dụng 0.5 để giảm giá 50%. Ưu đãi giữ chân người dùng chỉ hỗ trợ relativeDiscount. Các giai đoạn giá cố định (price), số tiền chiết khấu (absoluteDiscount) và miễn phí (free) không được hỗ trợ.
  • startTime: Không bắt buộc. Thời điểm ưu đãi giữ chân người dùng bắt đầu có hiệu lực đối với những người đăng ký đủ điều kiện, dưới dạng dấu thời gian RFC 3339. Việc đặt trường này không kích hoạt ưu đãi. Nếu bạn không đặt trường này, ưu đãi sẽ được cung cấp dựa trên trạng thái của ưu đãi.
  • endTime: Không bắt buộc. Thời điểm ưu đãi giữ chân khách hàng không còn hiệu lực, dưới dạng dấu thời gian RFC 3339, bất kể trạng thái của ưu đãi. Nếu bạn không đặt trường này, ưu đãi sẽ không có ngày kết thúc. Nếu bạn đặt trường này, thì trường này phải là một thời điểm trong tương lai và muộn hơn startTime.

Phương thức monetization.subscriptions.basePlans.offers.create luôn tạo ưu đãi ở trạng thái DRAFT, ngay cả khi bạn đặt startTime. Để kích hoạt ưu đãi, hãy gọi phương thức monetization.subscriptions.basePlans.offers.activate.

Đặt quy tắc về điều kiện giữ chân khách hàng

Đối tượng RetentionTargetingRule chứa các trường sau:

  • scope: Bắt buộc. Các gói thuê bao mà quy tắc xem xét. Đối với ưu đãi giữ chân người dùng, giá trị được hỗ trợ duy nhất là thisSubscription, tức là gói thuê bao mà ưu đãi được xác định. Đặt trường này thành {"thisSubscription": {}}.
  • minDuration: Bắt buộc. Thời gian tối thiểu mà người dùng phải là người đăng ký trả phí để đủ điều kiện, theo thời lượng ISO 8601 tính bằng ngày, từ P0D đến P1826D. Ví dụ: sử dụng P90D cho 90 ngày. Để không yêu cầu thời gian tối thiểu của gói thuê bao có tính phí, hãy đặt trường này thành P0D.
  • allowMultipleClaims: Không bắt buộc. Người đăng ký có thể nhận ưu đãi nhiều lần hay không. Nếu false, người đăng ký đã từng nhận ưu đãi này sẽ không bao giờ đủ điều kiện nhận lại ưu đãi này. Nếu true, người đăng ký có thể đủ điều kiện trở lại sau khi hết thời gian trong minOfferCooldownDuration kể từ khi kết thúc kỳ chiết khấu của ưu đãi giữ chân trước đó. Giá trị mặc định là false.
  • minOfferCooldownDuration: Bắt buộc nếu allowMultipleClaims là true. Khoảng thời gian tối thiểu phải trôi qua sau khi kỳ chiết khấu của ưu đãi giữ chân người đăng ký trước đó kết thúc thì người đăng ký mới đủ điều kiện nhận ưu đãi lần nữa, theo định dạng thời lượng ISO 8601 tính bằng ngày, từ P1D đến P1826D. Ví dụ: sử dụng P180D trong 180 ngày. Đừng đặt trường này nếu allowMultipleClaims là false hoặc không được đặt.

Ví dụ sau đây cho thấy các trường startTime, endTime và targeting của đối tượng SubscriptionOffer cho một ưu đãi giữ chân người dùng dành cho những người đăng ký đã thanh toán trong ít nhất 90 ngày và họ có thể nhận lại ưu đãi này sau 180 ngày kể từ khi ưu đãi giữ chân người dùng trước đó kết thúc:

{
  "offerId": "retention-50off-2m",
  "startTime": "2026-12-01T00:00:00Z",
  "endTime": "2027-03-01T00:00:00Z",
  "targeting": {
    "retentionRule": {
      "scope": {
        "thisSubscription": {}
      },
      "minDuration": "P90D",
      "allowMultipleClaims": true,
      "minOfferCooldownDuration": "P180D"
    }
  }
}

Nhắm ưu đãi giữ chân đến những người đăng ký cụ thể

Thay vì để Google Play quyết định điều kiện bằng RetentionTargetingRule, bạn có thể chỉ cung cấp ưu đãi giữ chân cho những người đăng ký mà phần phụ trợ của bạn chọn. Ví dụ: bạn có thể nhắm ưu đãi đến những người đăng ký mà mô hình dự đoán tỷ lệ rời bỏ của bạn gắn cờ là có rủi ro hoặc những người đăng ký bắt đầu quy trình huỷ trong ứng dụng của bạn.

Người đăng ký sẽ thấy ưu đãi giữ chân người dùng trong cùng một quy trình huỷ trên Google Play như mọi ưu đãi giữ chân khác và bạn xử lý việc chấp nhận theo cùng một cách. Để biết thông tin chi tiết, hãy xem phần Xử lý sự kiện ưu đãi giữ chân người dùng trong phần phụ trợ.

Để nhắm đến những người đăng ký cụ thể bằng ưu đãi giữ chân, hãy làm như sau:

  1. Tạo ưu đãi giữ chân người dùng cho mỗi người dùng. Khi bạn gọi phương thức monetization.subscriptions.basePlans.offers.create, monetization.subscriptions.basePlans.offers.patch hoặc monetization.subscriptions.basePlans.offers.batchUpdate, hãy đặt targeting thành đối tượng retentionPerUserRule thay vì đối tượng retentionRule. Đối tượng RetentionPerUserTargetingRule không có trường nào. Một mặt hàng có thể sử dụng retentionRule hoặc retentionPerUserRule, nhưng không được sử dụng cả hai.

    {
      "offerId": "retention-peruser-30off",
      "targeting": {
        "retentionPerUserRule": {}
      }
    }
    

    Kích hoạt ưu đãi trước khi nhắm đến người đăng ký. Nếu bạn gọi phương thức activateOfferTargeting cho một ưu đãi chưa từng được kích hoạt, thì lệnh gọi sẽ không thành công và trả về mã trạng thái HTTP 400 Bad Request và trạng thái lỗi INVALID_ARGUMENT. Để biết thông tin chi tiết, hãy xem bài viết Xử lý lỗi nhắm mục tiêu. Ngay cả khi ưu đãi đang hoạt động, Google Play chỉ hiển thị ưu đãi đó cho những người đăng ký mà bạn nhắm đến trong bước tiếp theo.

  2. Nhắm ưu đãi đến một gói thuê bao. Gọi phương thức purchases.subscriptionsv2.activateOfferTargeting bằng tên gói của ứng dụng, purchaseToken của gói thuê bao và offerId của ưu đãi giữ chân người dùng:

    POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{purchaseToken}:activateOfferTargeting
    
    {
      "offerId": "retention-peruser-30off"
    }
    

    Lệnh gọi thành công sẽ trả về mã trạng thái HTTP 204 No Content mà không có nội dung phản hồi. Cửa hàng Google Play lưu trữ tiêu chí nhắm mục tiêu cùng với gói thuê bao, vì vậy, bạn không cần gọi API tại thời điểm người đăng ký huỷ. Lần tiếp theo người đăng ký bắt đầu huỷ trên Google Play, Google Play có thể hiển thị ưu đãi, miễn là gói thuê bao đáp ứng các yêu cầu. Tính năng nhắm mục tiêu theo người dùng chỉ thay thế các quy tắc về điều kiện mà retentionRule xác định. Tất cả các yêu cầu khác về điều kiện và các quy trình kiểm tra ở cấp nền tảng mà Google Play thực hiện (chẳng hạn như các yêu cầu tuân thủ theo khu vực) vẫn được áp dụng.

    Bạn có thể nhắm đến nhiều ưu đãi giữ chân người dùng cho cùng một gói thuê bao. Để làm việc này, hãy gọi phương thức activateOfferTargeting một lần cho mỗi ưu đãi. Google Play vẫn hiển thị tối đa một ưu đãi giữ chân người dùng trong quy trình huỷ. Để biết thông tin chi tiết về cách Google Play chọn ưu đãi, hãy xem phần Định cấu hình ưu đãi giữ chân người dùng.

    Phương thức activateOfferTargeting là phương thức luỹ đẳng. Nếu bạn gọi phương thức này cho một ưu đãi đã được nhắm đến gói thuê bao, thì lệnh gọi sẽ thành công và Google Play sẽ cập nhật activateTime của ưu đãi thành thời điểm của yêu cầu mới nhất.

  3. Xoá tiêu chí nhắm mục tiêu khi cần. Nếu bạn không muốn một người đăng ký nhận ưu đãi nữa, chẳng hạn như vì rủi ro rời bỏ của họ đã thay đổi, hãy gọi phương thức purchases.subscriptionsv2.deactivateOfferTargeting bằng cùng tên gói, purchaseToken và offerId. Lệnh gọi thành công sẽ trả về mã trạng thái HTTP 204 No Content mà không có nội dung phản hồi.

    Phương thức deactivateOfferTargeting cũng có tính chất luỹ đẳng. Nếu ưu đãi không được nhắm đến gói thuê bao, chẳng hạn như do bạn chưa từng kích hoạt tính năng nhắm mục tiêu, thì lệnh gọi sẽ thành công và không có hiệu lực.

Mục tiêu áp dụng cho một purchaseToken và không hết hạn khi gói thuê bao đang hoạt động và tự động gia hạn. Ưu đãi này vẫn giữ nguyên sau khi người đăng ký xem, chấp nhận hoặc từ chối ưu đãi. Google Play chỉ xoá gói thuê bao khi bạn gọi phương thức deactivateOfferTargeting hoặc 60 ngày sau khi gói thuê bao hết hạn. Nếu việc thay đổi gói hoặc đăng ký lại tạo ra một purchaseToken mới, thì tiêu chí nhắm mục tiêu sẽ không được chuyển sang.

Để kiểm tra xem ưu đãi giữ chân người dùng nào được nhắm đến một gói thuê bao, hãy gọi phương thức purchases.subscriptionsv2.get. Trường developerTargetedOffers của mỗi mục hàng liệt kê các sản phẩm được nhắm mục tiêu. Mỗi mục nhập chứa offerId và activateTime khi bạn kích hoạt tiêu chí nhắm mục tiêu:

{
  "lineItems": [
    {
      "productId": "premium_monthly_sub",
      "developerTargetedOffers": [
        {
          "offerId": "retention-peruser-30off",
          "activateTime": "2026-12-03T15:04:05Z"
        }
      ]
    }
  ]
}

Xử lý lỗi nhắm mục tiêu

Khi lệnh gọi đến phương thức activateOfferTargeting hoặc deactivateOfferTargeting không thành công, phản hồi sẽ chứa mã trạng thái HTTP và trạng thái lỗi mô tả nguyên nhân. Bảng sau đây liệt kê các mã trạng thái HTTP và trạng thái lỗi mà các phương thức này có thể trả về:

Mã trạng thái HTTP Trạng thái lỗi Phương thức Nguyên nhân
404 Not Found NOT_FOUND Cả hai purchaseToken không tồn tại.
400 Bad Request INVALID_ARGUMENT activateOfferTargeting offerId không tồn tại trong gói cơ bản hiện tại của gói thuê bao hoặc ưu đãi vẫn ở trạng thái nháp và chưa từng được kích hoạt.
400 Bad Request FAILED_PRECONDITION activateOfferTargeting targeting của ưu đãi không được đặt thành retentionPerUserRule.
400 Bad Request FAILED_PRECONDITION activateOfferTargeting Gói thuê bao này đã hết hạn.

Phương thức activateOfferTargeting không kiểm tra xem một gói thuê bao chưa hết hạn có đủ điều kiện nhận ưu đãi hay không. Ví dụ: nếu gói thuê bao bị huỷ nhưng chưa hết hạn, thì lệnh gọi sẽ thành công và Google Play sẽ lưu trữ tiêu chí nhắm mục tiêu. Google Play sẽ đánh giá điều kiện của gói thuê bao khi người đăng ký bắt đầu quy trình huỷ.

Xử lý các sự kiện ưu đãi giữ chân người dùng trong phần phụ trợ

Khi người đăng ký chấp nhận ưu đãi giữ chân và sau đó khi việc gia hạn có chiết khấu diễn ra, Google Play sẽ gửi RTDN đến phần phụ trợ của bạn. Sau khi nhận được từng thông báo, hãy gọi phương thức purchases.subscriptionsv2.get bằng purchaseToken trong thông báo để nhận trạng thái mới nhất của gói thuê bao.

Việc chấp nhận ưu đãi giữ chân khách hàng không tạo ra giao dịch mua mới. purchaseToken vẫn giữ nguyên, vì vậy, bạn không cần xác nhận lại giao dịch mua và Google Play không tạo linkedPurchaseToken. Giữ nguyên quyền hiện có của người đăng ký. Xử lý đơn đặt hàng gia hạn có chiết khấu theo cách tương tự như mọi lần gia hạn gói thuê bao khác.

Loại thông báo Thời điểm gửi Việc nên làm
SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) Khi người đăng ký chấp nhận ưu đãi giữ chân trong quy trình huỷ. Gọi phương thức purchases.subscriptionsv2.get và kiểm tra planTransitionDetails. transitionState là IN_PROGRESS. Gói thuê bao vẫn hoạt động và tự động gia hạn, vì vậy, hãy tiếp tục cấp quyền truy cập.
SUBSCRIPTION_RENEWED (2) Khi kỳ thanh toán hiện tại kết thúc và gói thuê bao gia hạn theo giá ưu đãi giữ chân người dùng. Gọi phương thức purchases.subscriptionsv2.get, xác nhận rằng offerDetails.offerId là mã ưu đãi giữ chân và planTransitionDetails không còn tồn tại, đồng thời gia hạn quyền truy cập của người đăng ký vào expiryTime mới.

Đối tượng planTransitionDetails chứa các trường sau:

  • productId: Mã sản phẩm của gói mà gói thuê bao chuyển sang. Đối với ưu đãi giữ chân, đây là cùng một sản phẩm.
  • basePlanId: Mã gói cơ bản của gói mà gói thuê bao chuyển sang.
  • offerId: Mã nhận dạng của ưu đãi giữ chân người đăng ký mà người đăng ký đã chấp nhận. Sử dụng trường này để xác định ưu đãi giữ chân người dùng nào đã được sử dụng.
  • transitionInfo.transitionState: Trạng thái của hiệu ứng chuyển đổi. Đối với ưu đãi giữ chân, trạng thái là IN_PROGRESS trong khi quá trình chuyển đổi đang chờ xử lý.
  • transitionInfo.expectedTransitionTime: Thời điểm điều khoản của ưu đãi giữ chân người dùng dự kiến có hiệu lực.

Google Play chỉ thêm planTransitionDetails khi quá trình chuyển đổi đang chờ xử lý. Khi gói thuê bao gia hạn theo giá ưu đãi giữ chân người dùng, quá trình chuyển đổi sẽ hoàn tất và Google Play sẽ xoá planTransitionDetails khỏi phản hồi purchases.subscriptionsv2.get. Kể từ đó, mục hàng sẽ cho thấy chiết khấu giữ chân đang hoạt động:

  • offerDetails.offerId là mã nhận dạng của ưu đãi giữ chân người dùng được chấp nhận.
  • offerPhase là {"introductoryPrice": {}} trong các kỳ thanh toán được chiết khấu. Sau khi kết thúc kỳ thanh toán chiết khấu và gói thuê bao gia hạn theo giá gói cơ bản thông thường, offerPhase sẽ thay đổi thành {"basePrice": {}}.

Phản hồi sau khi người đăng ký chấp nhận ưu đãi

Sau khi người đăng ký chấp nhận ưu đãi giữ chân, kỳ thanh toán hiện tại sẽ tiếp tục mà không có gì thay đổi. Đối tượng planTransitionDetails cho thấy quá trình chuyển đổi theo lịch với transitionState là IN_PROGRESS:

{
  "lineItems": [
    {
      "productId": "premium_monthly_sub",
      "expiryTime": "2026-12-15T10:00:00Z",
      "offerDetails": {
        "basePlanId": "monthly-base"
      },
      "autoRenewingPlan": {
        "autoRenewEnabled": true,
        "planTransitionDetails": {
          "productId": "premium_monthly_sub",
          "basePlanId": "monthly-base",
          "offerId": "retention-50off-2m",
          "transitionInfo": {
            "transitionState": "IN_PROGRESS",
            "expectedTransitionTime": "2026-12-15T10:00:00Z"
          }
        }
      }
    }
  ]
}

Phản hồi sau khi gia hạn có chiết khấu

Sau khi ngày gia hạn trôi qua và người đăng ký bị tính phí theo giá chiết khấu, offerDetails.offerId sẽ hiển thị ưu đãi giữ chân, offerPhase sẽ hiển thị introductoryPrice và phản hồi sẽ không còn bao gồm planTransitionDetails:

{
  "lineItems": [
    {
      "productId": "premium_monthly_sub",
      "expiryTime": "2027-01-15T10:00:00Z",
      "offerDetails": {
        "basePlanId": "monthly-base",
        "offerId": "retention-50off-2m"
      },
      "offerPhase": {
        "introductoryPrice": {}
      },
      "autoRenewingPlan": {
        "autoRenewEnabled": true,
        "recurringPrice": {
          "currencyCode": "USD",
          "units": "9",
          "nanos": 990000000
        }
      }
    }
  ]
}

Tương tác trong vòng đời

Hãy lưu ý những hành vi sau khi bạn xử lý ưu đãi giữ chân người dùng:

  • Kết thúc thời gian chiết khấu: Sau khi kết thúc kỳ thanh toán được chiết khấu, gói thuê bao sẽ tự động gia hạn theo giá gói cơ bản thông thường. Bạn nhận được thông báo SUBSCRIPTION_RENEWED, giống như mọi lần gia hạn khác, và offerPhase của mục hàng thay đổi thành {"basePrice": {}}. Người đăng ký không cần làm gì cả.
  • Khôi phục thanh toán sau khi chiết khấu: Nếu giao dịch gia hạn theo giá gói cơ bản thông thường sau khi kết thúc chiết khấu bị từ chối và gói thuê bao chuyển sang thời gian ân hạn hoặc tạm ngưng tài khoản, thì quy trình khôi phục thanh toán sẽ tính phí theo giá gói cơ bản thông thường. Google Play không áp dụng chiết khấu của ưu đãi giữ chân đã hoàn tất. Nếu khoản thanh toán cho lần gia hạn đầu tiên được chiết khấu bị từ chối, thì quá trình chuyển đổi đang chờ xử lý sẽ được giữ nguyên và giá của ưu đãi giữ chân người dùng sẽ áp dụng khi khoản thanh toán được khôi phục.
  • Thanh toán chậm: Nếu bạn gọi phương thức purchases.subscriptionsv2.defer trong khi quá trình chuyển đổi ưu đãi giữ chân khách hàng đang ở trạng thái IN_PROGRESS, thì quá trình chuyển đổi đang chờ xử lý sẽ được giữ nguyên và áp dụng khi gia hạn chậm. Để biết ngày gia hạn mới, hãy kiểm tra expiryTime của mục hàng.
  • Thay đổi gói trước khi chuyển đổi: Ưu đãi giữ chân chỉ áp dụng cho purchaseToken của gói thuê bao mà người đăng ký đã chấp nhận. Nếu người đăng ký chuyển sang một gói cơ bản hoặc gói thuê bao khác trước expectedTransitionTime, thì Google Play sẽ tạo mã thông báo mua hàng mới, huỷ quá trình chuyển đổi theo lịch và xoá planTransitionDetails. Ưu đãi giữ chân khách hàng đang chờ xử lý sẽ không áp dụng cho gói mới.
  • Huỷ và khôi phục: Nếu người đăng ký huỷ gói thuê bao sau khi chấp nhận ưu đãi giữ chân, thì quá trình chuyển đổi theo lịch vẫn ở trạng thái chờ xử lý và transitionState vẫn là IN_PROGRESS. Nếu người đăng ký khôi phục gói thuê bao trước khi gói đó hết hạn, thì ưu đãi giảm giá để giữ chân người dùng vẫn áp dụng khi gia hạn.
  • Hết hạn và đăng ký lại: Nếu gói thuê bao hết hạn mà không được khôi phục, thì Google Play sẽ huỷ quá trình chuyển đổi đang chờ xử lý. Nếu người dùng đăng ký lại hoặc đăng ký sau đó, Google Play sẽ tạo một giao dịch mua gói thuê bao mới và ưu đãi giữ chân người dùng đã chấp nhận trước đó sẽ không áp dụng.
  • Thay đổi ưu đãi: Nếu bạn thay đổi mức chiết khấu hoặc kỳ thanh toán của một ưu đãi giữ chân người dùng, thì thay đổi đó chỉ áp dụng cho những lần sử dụng ưu đãi trong tương lai. Những người đăng ký đã chấp nhận ưu đãi sẽ giữ nguyên các điều khoản ban đầu.
  • Huỷ kích hoạt ưu đãi: Nếu bạn huỷ kích hoạt một ưu đãi giữ chân hoặc ưu đãi đó hết hạn, thì những người đăng ký đã chấp nhận ưu đãi vẫn được hưởng các điều khoản mà họ đã đồng ý. Những người đăng ký có quá trình chuyển đổi IN_PROGRESS vẫn nhận được khoản chiết khấu vào lần gia hạn tiếp theo và những người đăng ký đã ở trong kỳ thanh toán chiết khấu sẽ giữ nguyên khoản chiết khấu trong toàn bộ thời gian đã thoả thuận.
  • Thay đổi về giá: Các thay đổi về giá của gói cơ bản vẫn được áp dụng. Google Play chỉ di chuyển người đăng ký sang mức giá mới khi người đăng ký đó đang trả mức giá thông thường và không có quá trình chuyển đổi ưu đãi giữ chân người dùng nào đang chờ xử lý. Để biết thêm thông tin, hãy xem bài viết Thay đổi giá gói thuê bao.
  • Hoàn tiền: Bạn có thể hoàn tiền cho người đăng ký bằng các API hoàn tiền và thu hồi tiêu chuẩn, chẳng hạn như phương thức purchases.subscriptionsv2.revoke. Thao tác này sẽ hoàn lại khoản thanh toán gần đây nhất và chấm dứt quyền truy cập của người đăng ký.

Thử nghiệm ưu đãi giữ chân người dùng

Google Play chỉ hiển thị các ưu đãi giữ chân người dùng đang hoạt động trong quy trình huỷ và đánh giá các quy tắc về điều kiện theo thời gian thực trên lịch. Để thử nghiệm ưu đãi giữ chân khách hàng bằng tài khoản người kiểm thử được cấp phép, hãy sử dụng một trong các phương thức sau:

Trước khi sử dụng một trong hai phương thức, hãy chuyển đến phần Cài đặt > Kiểm thử giấy phép trong Google Play Console rồi thêm Tài khoản Google thử nghiệm làm người kiểm thử giấy phép.

Thử nghiệm ưu đãi giữ chân người dùng theo từng người dùng

Google Play chỉ hiển thị ưu đãi giữ chân người dùng cho những gói thuê bao mà bạn nhắm đến, nhờ đó, bạn có thể thử nghiệm ưu đãi này trên một gói cơ bản chính thức mà không cần hiển thị cho người đăng ký thực tế. Để thử nghiệm ưu đãi giữ chân người dùng, hãy làm như sau:

  1. Tạo một ưu đãi giữ chân người dùng theo từng người dùng trong gói cơ bản, sau đó kích hoạt ưu đãi đó. Trong Google Play Console, hãy chọn Ưu đãi giữ chân người dùng ở cấp người dùng. Với Google Play Developer API, hãy đặt targeting thành một đối tượng retentionPerUserRule. Để biết thông tin chi tiết, hãy xem bài viết Nhắm mục tiêu ưu đãi giữ chân người đăng ký cụ thể.
  2. Nếu bạn vừa kích hoạt ưu đãi, hãy đợi từ 10 đến 15 phút để thay đổi có hiệu lực, sau đó xoá bộ nhớ đệm của ứng dụng Cửa hàng Google Play.
  3. Trên thiết bị thử nghiệm, hãy đăng nhập bằng tài khoản người kiểm thử được cấp phép, sau đó mua gói cơ bản trong ứng dụng của bạn.
  4. Từ phần phụ trợ, hãy gọi phương thức purchases.subscriptionsv2.activateOfferTargeting bằng tên gói của ứng dụng, purchaseToken của người kiểm thử được cấp phép và offerId của ưu đãi giữ chân người dùng.
  5. Trong ứng dụng Cửa hàng Google Play, hãy chuyển đến phần Thanh toán và gói thuê bao > Gói thuê bao, chọn gói thuê bao rồi nhấn vào Huỷ gói thuê bao. Ưu đãi giữ chân người dùng sẽ xuất hiện trong quy trình huỷ.
  6. Chấp nhận ưu đãi, sau đó xác nhận rằng phần phụ trợ của bạn nhận được RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED và xử lý việc gia hạn có chiết khấu.

Thử nghiệm ưu đãi giữ chân người dùng dựa trên quy tắc

Sau khi bạn kích hoạt ưu đãi giữ chân khách hàng dựa trên quy tắc, Google Play có thể hiển thị ưu đãi đó cho bất kỳ người đăng ký đủ điều kiện nào trong gói cơ bản. Để tránh hiển thị ưu đãi cho người dùng chính thức, hãy thử nghiệm ưu đãi đó trong một ứng dụng thử nghiệm không chính thức hoặc trên một gói cơ bản thử nghiệm chuyên biệt mà người dùng chính thức không thể truy cập. Để thử nghiệm ưu đãi giữ chân khách hàng dựa trên quy tắc, hãy làm như sau:

  1. Trong ứng dụng thử nghiệm hoặc trên gói cơ bản thử nghiệm, hãy tạo một ưu đãi giữ chân dựa trên quy tắc và đặt minDuration thành P0D (0 ngày). Trong Google Play Console, hãy chọn Ưu đãi giữ chân người dùng theo nhóm thuần tập. Với API Nhà phát triển Google Play, hãy đặt targeting thành một đối tượng retentionRule. Để biết thông tin chi tiết, hãy xem phần Thiết lập quy tắc đủ điều kiện giữ lại.
  2. Kích hoạt ưu đãi, đợi 10 đến 15 phút để thay đổi có hiệu lực, sau đó xoá bộ nhớ đệm của ứng dụng Cửa hàng Google Play.
  3. Trên thiết bị thử nghiệm, hãy đăng nhập bằng tài khoản người kiểm thử giấy phép, sau đó mua gói cơ bản thử nghiệm.
  4. Trong ứng dụng Cửa hàng Google Play, hãy chuyển đến phần Thanh toán và gói thuê bao > Gói thuê bao, chọn gói thuê bao rồi nhấn vào Huỷ gói thuê bao. Vì ưu đãi không yêu cầu thời hạn tối thiểu của gói thuê bao có tính phí, nên bạn có thể bắt đầu quy trình huỷ ngay sau khi mua. Ưu đãi giữ chân người dùng sẽ xuất hiện trong quy trình huỷ.
  5. Chấp nhận ưu đãi, sau đó xác nhận rằng phần phụ trợ của bạn nhận được RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED và xử lý việc gia hạn có chiết khấu.

Sau khi xác minh quá trình tích hợp, hãy tạo và kích hoạt ưu đãi giữ chân dựa trên quy tắc cho gói cơ bản chính thức.

Khắc phục sự cố khi thử nghiệm ưu đãi giữ chân người dùng

Nếu ưu đãi giữ chân không xuất hiện, hãy kiểm tra những điều sau:

  • Ưu đãi giữ chân người dùng đang hoạt động và thời gian hiện tại nằm trong khoảng từ startTime đến endTime (nếu bạn đặt các giá trị này).
  • Đối với ưu đãi giữ chân người dùng, trường developerTargetedOffers trong phản hồi purchases.subscriptionsv2.get cho purchaseToken của người kiểm thử giấy phép sẽ bao gồm ưu đãi.
  • Gói thuê bao là một gói thuê bao riêng lẻ, không phải gói thuê bao có gói bổ sung.
  • Gói thuê bao không trong thời gian ân hạn, tạm ngưng tài khoản hoặc tạm dừng.
  • Gói thuê bao không có thay đổi nào về gói hoặc giá đang chờ xử lý.
  • Lần gia hạn tiếp theo sẽ áp dụng giá gói cơ bản thông thường. Đối với ưu đãi dùng thử miễn phí và ưu đãi giới thiệu, ưu đãi giữ chân người dùng chỉ áp dụng trong kỳ thanh toán cuối cùng của giai đoạn dùng thử hoặc giai đoạn giới thiệu.
  • Bạn đã đợi từ 10 đến 15 phút sau khi kích hoạt hoặc thay đổi ưu đãi, đồng thời đã xoá bộ nhớ đệm của ứng dụng Cửa hàng Play.