Thông tin trong tài liệu này có thể giúp bạn khắc phục những vấn đề có thể gặp phải khi triển khai tính năng Liên kết gói thuê bao.
CTA liên kết gói thuê bao bị kẹt trên màn hình tải
Ví dụ về lỗi:
Hình 1. Lời kêu gọi hành động liên kết với gói thuê bao không tải được.
Để giải quyết vấn đề này, hãy kiểm tra những điều sau:
- Đảm bảo rằng bạn thêm nguồn gốc của các trang, bao gồm cả các miền con thử nghiệm, dưới dạng URL bổ sung trong phần cài đặt ấn phẩm của Publisher Center.
- Đảm bảo trạng thái của URL là "Đã xác minh" thay vì "Xác minh".
- Đối với các hoạt động triển khai Quyền truy cập mở rộng hoặc Reader Revenue Manager Enterprise, hãy nhớ thêm nguồn gốc của các trang (bao gồm cả miền con thử nghiệm) vào các nguồn gốc JavaScript được cho phép của Ứng dụng OAuth 2.0 mà bạn đã định cấu hình cho hoạt động triển khai đó. Bạn cần thực hiện việc này trong Google Cloud Console.
Không liên kết được tài khoản
Ví dụ về lỗi:
Hình 2. Vấn đề không liên kết được tài khoản.
Để giải quyết vấn đề này, hãy kiểm tra những điều sau:
- Đảm bảo bạn chấp nhận Điều khoản dịch vụ về cấu hình Liên kết gói thuê bao trong Trung tâm xuất bản. Để làm việc này, hãy chuyển đến phần cài đặt Liên kết gói thuê bao rồi nhấp vào ký điều khoản dịch vụ về việc liên kết gói thuê bao.
- Nếu Tài khoản Google đã được liên kết, bạn sẽ nhận được thông báo lỗi khi thử liên kết gói thuê bao lại. Bạn phải huỷ liên kết gói thuê bao thông qua trang gói thuê bao trong Tài khoản Google trước khi lặp lại kiểm thử tích hợp phía ứng dụng.
Lỗi về quyền khi gọi Subscription Linking API
Ví dụ về lỗi:
| Mã | 403
|
| Thông điệp | 'readerrevenuesubscriptionlinking.readerEntitlements.update'
đã bị từ chối đối với tài nguyên |
Để giải quyết vấn đề này, hãy kiểm tra những điều sau:
- Đảm bảo rằng bạn sử dụng cùng một dự án như đã chỉ định trong chế độ thiết lập Liên kết gói thuê bao. Khi bạn thiết lập tính năng Liên kết gói thuê bao trong Trung tâm xuất bản, hãy sử dụng Số dự án. Bạn có thể tìm thấy Số dự án trên trang tổng quan dự án.
- Đảm bảo bạn đã bật Subscription Linking API trong dự án của mình.
- Trong phần Quản lý danh tính và quyền truy cập (IAM) của dự án, hãy đảm bảo rằng tài khoản dịch vụ được cấp vai trò là Quản trị viên liên kết với gói thuê bao. Xin lưu ý rằng quá trình thay đổi vai trò trên toàn hệ thống có thể mất một khoảng thời gian. Nếu bạn nhận được lỗi 403 khi thực hiện lệnh gọi API, ngay cả sau khi xác nhận rằng tài khoản dịch vụ của bạn có vai trò IAM chính xác, hãy đợi một lát rồi thử lại yêu cầu.
Nếu bạn không chắc nên sử dụng tài khoản dịch vụ nào hoặc liệu các tài khoản đó có vai trò IAM cần thiết hay không, hãy sử dụng Policy Analyzer (Trình phân tích chính sách) trong dự án mà bạn thiết lập cho tính năng Liên kết thuê bao. Tạo và chạy một truy vấn tuỳ chỉnh bằng các tham số truy vấn sau:
Tham số 1 Vai trò Vai trò Quản trị viên liên kết gói thuê bao Đảm bảo rằng bạn sử dụng đúng khoá tài khoản dịch vụ khi gọi Subscription Linking API. Kiểm tra các thuộc tính sau trong khoá tài khoản dịch vụ (tệp JSON):
- type: Phải là service_account.
- project_id: Đây phải là Mã dự án của Số dự án được chỉ định trong chế độ thiết lập Liên kết thuê bao.
- client_email: Đây phải là tài khoản dịch vụ trong IAM dự án được chỉ định vai trò Quản trị viên liên kết gói thuê bao.
Nếu bạn lấy mã truy cập thông qua điểm cuối mã thông báo Google OAuth 2.0 (https://oauth2.googleapis.com/token), hãy đảm bảo rằng mã thông báo đó vẫn còn hiệu lực và chưa hết hạn khi bạn gọi API Liên kết thuê bao. Nếu mã thông báo hết hạn, bạn phải lấy một mã thông báo mới.
Nếu bạn sử dụng REST API, hãy đảm bảo rằng bạn sử dụng Mã nhận dạng ấn phẩm mà bạn đã cung cấp trong chế độ thiết lập Liên kết gói thuê bao. Ví dụ: nếu Mã nhận dạng nhà xuất bản của bạn là
example.com, thì URL yêu cầu phải chứa mã này.- ✅ Chỉ sử dụng Mã nhận dạng ấn phẩm đã định cấu hình:
publications/example.com/readers/10078823/entitlements - ❌ Không sử dụng Publication ID nào khác ngoài Publication ID được chỉ định trong cấu hình Liên kết gói thuê bao:
publications/example-staging.com/readers/10078823/entitlements - ❌ Đừng thêm sản phẩm của nhà xuất bản vào yêu cầu:
publications/example.com:premium/readers/10078823/entitlements
- ✅ Chỉ sử dụng Mã nhận dạng ấn phẩm đã định cấu hình:
Lỗi đối số không hợp lệ khi cập nhật quyền
Ví dụ về lỗi:
| Thông điệp | Lỗi: Yêu cầu chứa một đối số không hợp lệ |
Để giải quyết vấn đề này, hãy kiểm tra những điều sau:
- Đảm bảo rằng bạn cung cấp đối tượng
entitlementsở đúng định dạng. Hãy xem ví dụ này. - Đảm bảo rằng
product_idcó định dạngpublication_id:product.- ✅ Ví dụ hợp lệ:
"product_id":"example.com:basic" - ❌ Ví dụ không hợp lệ:
"product_id":"example.com"
- ✅ Ví dụ hợp lệ:
Không thấy các bài viết được làm nổi bật trong kết quả tìm kiếm
Để giải quyết vấn đề này, hãy kiểm tra những điều sau:
- Hãy nhớ thêm dữ liệu có cấu trúc vào tất cả bài viết của bạn. Sử dụng công cụ Kiểm tra kết quả nhiều định dạng để xác thực dữ liệu có cấu trúc.
- Đảm bảo rằng bạn đặt một
productIDhợp lệ trong dữ liệu có cấu trúc tương ứng với một nhóm mã nhận dạng sản phẩm mà bạn dùng để cập nhật quyền của người đọc. - Sử dụng báo cáo kết quả nhiều định dạng cho "nội dung có tính phí" trong Search Console để xem mọi vấn đề liên quan đến dữ liệu có cấu trúc.
Không thể thay đổi ngôn ngữ của thông điệp kêu gọi hành động trong tính năng Liên kết với gói thuê bao
Ngôn ngữ của lời kêu gọi hành động trong tính năng Liên kết với gói thuê bao được xác định theo chế độ cài đặt của người dùng. Bạn không thể ghi đè lựa chọn này trên toàn cầu.
Ngôn ngữ được xác định như sau:
Nếu người dùng đăng nhập bằng Tài khoản Google, thì ngôn ngữ chính được đặt trong phần cài đặt Tài khoản Google (https://myaccount.google.com/language) sẽ được dùng.
Nếu người dùng chưa đăng nhập, thì ngôn ngữ sẽ dựa trên chế độ cài đặt ngôn ngữ chính của trình duyệt hoặc hệ điều hành.
Lời kêu gọi hành động của tính năng Liên kết với gói thuê bao không hỗ trợ một số ngôn ngữ. Nếu ngôn ngữ chính của người dùng không được hỗ trợ, thì lời kêu gọi hành động có thể mặc định là tiếng Anh.