Cài đặt giải pháp purchase verification cho ứng dụng

Để sử dụng giải pháp purchase verification (xác minh giao dịch), trước hết bạn cần cài đặt Adjust SDK, sau đó gửi cho Adjust các thông tin cần thiết để ủy quyền giao dịch với các store liên quan.

Trước khi bắt đầu

Yêu cầu

• Quyền truy cập Admin, Editor hoặc Custom Editor
• Để tạo và quản lý thông tin app store:
  • Google Cloud: quyền Service Account Key Admin trên project hoặc tài khoản dịch vụ.
  • App Store Connect: quyền Admin.

Thông tin quan trọng

• Purchase verification chỉ xử lý giao dịch in-app được thực hiện qua Google Play Store hoặc Apple App Store. Giải pháp này không xử lý giao dịch hàng hóa (physical item).
• Khả dụng với ứng dụng iOS, Android và Unity.

1. Cài đặt Adjust SDK

Để tích hợp Adjust Purchase Verification vào ứng dụng, trước hết bạn cần cài đặt hoặc cập nhật phiên bản SDK có hỗ trợ tính năng này, sau đó hoàn tất các bước cần thiết để gửi đi sự kiện doanh thu giao dịch (purchase revenue event).

• Android v4.34.0 trở lên
• iOS v4.34.0 trở lên
• Unity v4.34.0 trở lên

2. Tìm thông tin app store

Để xác minh giao dịch giữa người dùng với store, bạn cần cung cấp cho Adjust một số thông tin sau.

Android:

iOS:

Dưới đây là hướng dẫn dành riêng cho từng nền tảng; thực hiện theo hướng dẫn để tìm thông tin cần thiết.

Với ứng dụng Android

Để tạo key cho dự án hoặc tài khoản dịch vụ, tài khoản người dùng của bạn phải được cấp quyền Service Account Key Admin .

Kích hoạt Google Play Android Developer API

1. Tại Google Play Console, chọn APIs & Services .
2. Chọn + Enable APIs and Services .
3. Tại khung Mobile, chọn Google Play Android Developer API .
4. Chọn Kích hoạt.
5. Cài đặt các thông tin API cần thiết.
   1. Tại khung Enabled APIs & Services , chọn Google Play Android Developer API .
   2. Chọn Create Credentials .
   3. Tại khung Select an API, chọn Google Play Android Developer API .
   4. Tại khung What data will you be accessing?, chọn Application data .
   5. Chọn Next.

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

1. Tại Google Cloud, chọn Create service account

2. Chọn Google Cloud project của bạn.

3. Nhập tên tài khoản dịch vụ.

   • ID của tài khoản được tạo tự động.

4. Tùy chọn: Mô tả tài khoản dịch vụ.

5. Chọn Create and Continue .

6. Cấp quyền truy cập tài khoản dịch vụ cho project.

   1. Cấp quyền Pub/Sub Admin cho tài khoản dịch vụ.
   2. Chọn + Add another role .
   3. Cấp quyền Monitoring Viewer cho tài khoản dịch vụ.
   4. Chọn Continue .
   5. Tùy chọn: Cấp quyền truy cập người dùng (users access) cho tài khoản dịch vụ này
   6. Chọn HOÀN TẤT .

Tạo API mới

1. Tại Google Cloud, chọn IAM & Admin .
2. Chọn Service Accounts để xem tài khoản dịch vụ của project.
3. Tại mục chứa tài khoản dịch vụ bạn vừa tao, chọn Actions (biểu tượng ba dấu chấm).
4. Chọn Manage keys .
5. Chọn Add Key > Create new key .
6. Tại mục Key type, chọn JSON .
7. Private key được tạo tự động.

Với ứng dụng iOS

Bạn cần quyền truy cập Admin trên App Store Connect để tạo và quản lý API key.

Tìm Issuer ID

1. Tại App Store Connect, chọn biểu tượng Users and Access .
2. Chọn tab Integrations.
3. Mở menu Key type nằm bên trái, chọn In-App Purchase .
4. Chọn Copy nằm ở đầu trang, cạnh Issuer ID.

Tạo API key mới

Chúng tôi đề xuất tạo API key dành riêng cho quá trình xác minh giao dịch in-app trên Adjust.

Chọn + Generate API Key

Nhập tên cho key mới, sau đó chọn Generate.

Key mới sẽ xuất hiện trong danh sách active key. Chọn Download.

Xác nhận tải xuống API key mới.

1/4

(1/4)

(2/4)

(3/4)

(4/4)

1. Chọn Generate API Key hoặc + để tạo key mới.

   • Nếu bạn chưa gửi yêu cầu quyền truy cập API trong tài khoản App Store Connect, thì bạn cần hoàn tất yêu cầu.

2. Tại trường Name , nhập tên key.

3. Chọn Generate .

4. API key mới sẽ có trong danh sách active key, cùng Key ID tương ứng.

5. Tại hàng API key, di chuột đến giá trị nằm trong cột Key ID. Chọn Copy Key ID .

6. Chọn Download In-App Purchase Key .

7. Chọn tiếp Download .

8. Sao chép API key có trong file tải.

3. iOS: Kết nối Adjust với App Store Connect

Để thêm thông tin App Store Connect vào Adjust dashboard, thực hiện các bước sau:

1. Mở Adjust, chọn DataWorks > Kết nối .
2. Chọn + Kết nối mới.
3. Chọn App Store Connect (In-App Purchase) có trong danh sách.
4. Tại mục Dịch vụ, chọn Purchase Verification .
5. Nhập Issuer ID.
6. Nhập Key ID.
7. Mở file .p8 trong trình chỉnh sửa văn bản, sau đó sao chép toàn bộ private key. Dán thông tin vào trường private key.

4. Thêm giải pháp purchase verification vào ứng dụng

Cuối cùng, thêm tính năng purchase verification vào ứng dụng

1. Mở Adjust, chọn AppView , rồi chọn ứng dụng của bạn.

2. Mở tab Bảo vệ.

3. Tại mục Purchase Verification , chọn Chỉnh sửa ().

4. Bật ON cho tính năng purchase verification.

5. Cung cấp các thông tin sau:

   • Ứng dụng iOS: Chọn tài khoản App Store Connect mà bạn muốn sử dụng.
   • Ứng dụng Android: Tải lên file chứa JSON key mà bạn tải về trước đó.

6. Chọn Lưu.

Vậy là xong - bạn đã hoàn tất phần cài đặt!

Chia sẻ dữ liệu doanh thu đã xác minh cho đối tác

Giải pháp Purchase verification của Adjust chỉ chia sẻ dữ liệu doanh thu đã xác minh cho đối tác. Nghĩa là, bạn có thể an tâm vào chất lượng của dữ liệu được gửi cho đối tác để dùng vào việc cải thiện chiến dịch.

Nếu bạn đã cài đặt tính năng chia sẻ doanh thu in-app trên Adjust dashboard, thì không cần thực hiện thêm thao tác nào. Adjust chỉ tự động chia sẻ dữ liệu doanh thu có trạng thái verified passed.

Để cài đặt đối tác mới, và kích hoạt tính năng chia sẻ doanh thu in-app đã xác minh, thực hiện theo hướng dẫn cài đặt mạng quảng cáo trên Campaign Lab. Khi đến bước chọn dữ liệu chia sẻ, chọn doanh thu in-app .