Bài viết liên tục được cập nhật, và những phần được cập nhật rất có thể chưa được dịch sang ngôn ngữ của bạn. Để xem thông tin mới nhất, vui lòng chọn ngôn ngữ Tiếng Anh.

Cài đặt Subscriptions cho ứng dụng Android

Để Adjust có thể giao tiếp với Google, bạn cần cung cấp các thông tin liên quan đến tài khoản dịch vụ. Bài viết này hướng dẫn cách liên kết Google Cloud project với Play Console, và cấp quyền cho project thông qua tài khoản dịch vụ (service account).

  1. Cài đặt thông báo nhà phát triển theo thời gian thực (real-time developer notification) cho Android trong tài khoản Google Play. Khi bạn cài đặt thông báo máy chủ, Google Play Store sẽ cập nhật cho Adjust các trạng thái mới nhất của gói đăng ký. Việc này cho phép Adjust kích hoạt sự kiện đăng ký kịp lúc.
  2. Tạo JSON public key cho tài khoản dịch vụ Google. Bạn cần JSON key để kết nối tài khoản dịch vụ Google với Adjust.
  3. Cấp quyền truy cập tài chính (financial access) cho tài khoản dịch vụ.
  4. Kết nối tài khoản dịch vụ Google với Adjust.

Trước khi bắt đầu

Trước khi bắt đầu, vui lòng tham khảo các thông tin sau.

Giải pháp tăng trưởng:

Subscriptions được cung cấp dưới dạng Giải pháp tăng trưởng của Adjust. Để thêm giải pháp vào gói dịch vụ, vui lòng liên hệ với đại diện Adjust hoặc bộ phận bán hàng theo địa chỉ sales@adjust.com.

Yêu cầu

  • Quyền Account owner trong Google Play Console
  • Quyền truy cập để tạo topic, gói đăng ký và gán vai trò tại Google Cloud Console
  • Quyền truy cập Admin, Editor hoặc Custom Editor vào tài khoản Adjust để kết nối tài khoản dịch vụ Google với Adjust

Cài đặt thông báo nhà phát triển theo thời gian thực (real-time developer notification)

Tạo gói đăng ký đẩy (push subscription)

  1. Mở Topics trên Google Cloud console.

  2. Chọn project.

  3. Chọn Create topic .

  4. Cung cấp Topic ID rồi chọn Create.

  5. Ở thanh điều hướng bên trái, tại mục Pub/Sub, chọn Subscriptions .

  6. Chọn Create subscription .

  7. Cung cấp Subscription ID .

  8. Mở danh sách Select a Cloud Pub/Sub topic , chọn topic bạn đã tạo ở Bước 4.

  9. Tại mục Delivery type , chọn Push .

  10. Tại trường Endpoint URL , nhập https://subscription.adjust.com/v3/playstore.

  11. Tại mục Retry policy , chọn Retry after exponential backoff delay và nhập các thông tin sau:

    • Minimum backoff time - 10
    • Maximum backoff time - 600

  12. Chọn Tạo .

Thêm principal vào gói đăng ký

  1. Chọn gói đăng ký đã tạo, rồi chọn Add principal .
  2. Tại trường New principals , nhập google-play-developer-notifications@system.gserviceaccount.com.
  3. Mở danh sách Assign roles , chọn Pub/Sub Publisher .
  4. Chọn Lưu.

Sao chép giá trị của tên topic

  1. Mở Topics trên Google Cloud console.
  2. Chọn topic mà bạn đã thêm trong quá trình tạo gói đăng ký đẩy, sau đó sao chép tên của topic.
    • Bạn có thể chọn (biểu tượng mũi tên xuống) để xem toàn bộ tên topic. Sau đó, chọn (biểu tượng sao chép) để sao chép giá trị của tên topic.

Bạn cần giá trị này ở bước tiếp theo.

Kích hoạt thông báo nhà phát triển theo thời gian thực

  1. Mở Google Play console.
  2. Chọn ứng dụng.
  3. Tại mục Monetize , chọn Monetization setup .
  4. Cuộn xuống phần Google Play Billing .
  5. Tại mục Manage notifications , chọn Enable real-time notifications.
  6. Tại trường Topic name , dán tên topic mà bạn đã sao chép ở bước trước.
  7. Chọn LƯU THAY ĐỔI .

Lặp lại các bước từ 2 đến 7 cho mỗi ứng dụng mà bạn muốn cài đặt giải pháp.

Tạo JSON public key

Kích hoạt Google Play Android Developer API

  1. Mở Google Play Console.
  2. Chọn project có sẵn hoặc tạo project mới.
  3. Mở APIs & Services > Enabled APIs and services.
  4. Chọn + Enable APIs and Services .
  5. Tìm kiếm rồi chọn Google Play Android Developer API , sau đó chọn Enable.
  6. Chọn Create Credentials .
  7. Tại mục Which API are you using? , chọn Google Play Android Developer API.
  8. Tại mục What data will you be accessing? , chọn Application data , rồi chọn Next.
Quan trọng:

Có thể mất tới 36 giờ để thông tin tài khoản có hiệu lực trên Google Play Developer API.

Tạo tài khoản dịch vụ

Bạn đã thêm product vào Play Console trước khi tạo tài khoản dịch vụ?

Lưu ý

Để tạo tài khoản dịch vụ, thực hiện các bước sau.

  1. Mở Google Cloud Console.

  2. Chọn project mà bạn đã chọn ở bước trước đó.

  3. Mở IAM & Admin > Service Accounts .

  4. Chọn Create Service Account .

  5. Tại mục Service account details , cung cấp tên cho tài khoản dịch vụ.

    • Giá trị của trường Service account ID sẽ được tự động điền. Đây là email của tài khoản dịch vụ.

  6. Chọn Create and Continue .

  7. Tại mục Grant this service account access to project (optional) , chọn các vai trò sau, rồi chọn Continue .

    • Service Account Key Admin – Cho phép tạo và quản lý key của tài khoản dịch vụ.
    • Pub/Sub Admin – Cho phép kích hoạt thông báo máy chủ.
    • Monitoring Viewer – Cho phép giám sát hàng chờ thông báo.

  8. Chọn Done để quay lại trang tài khoản dịch vụ.

Tại mục Google Cloud Console, chọn Create Service Account.

1/2

Tạo public key

Để tạo public key, thực hiện các bước sau.

  1. Mở Google Cloud Console.
  2. Chọn project mà bạn đã chọn ở bước trước đó.
  3. Mở IAM & Admin > Service Accounts .
  4. Chọn tài khoản dịch vụ mà bạn vừa tạo, tại mục Actions , chọn Manage keys .
  5. Chọn Add Key > Create new key .
  6. Chọn Key type là JSON , rồi chọn Create .

Đối với tài khoản dịch vụ, chọn Manage keys.

1/3

Cấp quyền truy cập tài chính

Vui lòng thực hiện các bước sau để cấp quyền truy cập tài chính (financial access) cho tài khoản dịch vụ.

Google Cloud Console

  1. Mở Google Cloud Console, chọn project mà bạn đã chọn ở bước trước.
  2. Mở IAM & Admin > Service Accounts .
  3. Chọn tài khoản dịch vụ mà bạn vừa tạo, sao chép giá trị của Email .
    • Bạn sẽ cần email này ở bước tiếp theo.

Google Play Console

  1. Mở Google Play Console.

  2. Chọn Users and permissions > Invite new users .

  3. Nhập địa chỉ email của tài khoản dịch vụ mà bạn đã lấy ở bước trước.

  4. Tại mục App permissions , thêm ứng dụng.

  5. Tại mục Account permissions , chọn các quyền truy cập sau:

    • View app information (read-only)
    • View financial data
    • Manage orders and subscriptions

  6. Chọn Invite user , rồi chọn Send invite .

Tại mục Google Play Console, tìm mục API access, sau đó chọn Grant access.

1/3

Nếu các tùy chọn trên không khả dụng, thì có lẽ bạn không có đủ quyền với tài khoản. Vui lòng liên hệ với Account Owner hoặc Admin.

Kết nối tài khoản dịch vụ Google với Adjust

Để thêm thông tin tài khoản dịch vụ Google vào Adjust, thực hiện các bước sau.

  1. Tại mục DataWorks , chọn Kết nối.
  2. Chọn + Kết nối mới.
  3. Tại mục Partner , chọn Google Service Account .
  4. Tại mục Dịch vụ , chọn Subscription .
  5. Tại trường Credentials file , tải file JSON mà bạn đã tải về ở bước Tạo public key.
  6. Chọn Kết nối.

➡️ Bước tiếp theo: Kích hoạt giải pháp Subscriptions cho ứng dụng trên Adjust.