Xác minh ứng dụng iOS

Bạn cần xác minh ứng dụng iOS để nhận dữ liệu SKAdNetwork hoặc cài đặt biểu đồ liên kết giá trị chuyển đổi trên Conversion Hub. Dưới đây là hướng dẫn gửi yêu cầu và quản lý quá trình xác minh ứng dụng iOS.

Trước khi bắt đầu

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

Yêu cầu

• Quyền truy cập Admin, Editor và Custom Editor

Tại sao cần xác minh app ID?

Sau khi Adjust hoàn tất xác minh App ID, bạn có thể bắt đầu sử dụng giải pháp SKAdNetwork của Adjust.

SKAN postback là một dạng thông báo Apple gửi cho mạng quảng cáo, được mạng quảng cáo điền thêm một số thông tin rồi gửi cho Adjust. Giá trị định danh duy nhất có trong postback mà Adjust có thể dùng để liên kết dữ liệu postback với ứng dụng có trong hệ thống của Adjust, là Apple App ID.

Vì Apple App ID được cung cấp công khai, nên để bảo vệ dữ liệu an toàn, bạn cần xác minh ứng dụng. Như vậy, Adjust mới có căn cứ xác nhận bạn đúng là chủ sở hữu ứng dụng, đảm bảo không một ai có thể lợi dụng app ID để thêm ứng dụng của bạn vào tài khoản rồi nhận dữ liệu SKAN postback.

1. Sử dụng Apple ID để đăng nhập App Store Connect

Sử dụng Apple ID để đăng nhập App Store Connect.

2. Thu thập tham số xác thực (auth parameter)

Để có thể tạo JSON Web Token (JWT) và gửi yêu cầu đến App Store Connect API, Adjust cần các tham số sau.

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 App Store Connect API.
4. Tại đầu trang, cạnh Issuer ID, chọn Copy.

Tạo API key mới

App Store Connect API cấp quyền truy cập vào dữ liệu ứng dụng có trong App Store Connect. Chúng tôi đề xuất tạo API key dành riêng cho quá trình xác minh ứng dụng. Chia sẻ App Store Connect API key cho Adjust không cung cấp bất kỳ dịch vụ nào cho Adjust, và đây là thao tác bắt buộc trong quá trình xác minh ứng dụng iOS.

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. Tại trường Access , chọn quyền truy cập Developer.

4. Chọn Generate .

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

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

7. Chọn Download ().

8. Chọn tiếp Download .

9. Sao chép toàn bộ App Store Connect API key có trong file tải.

Chọn + Generate API Key.

Đặt tên cho key mới và cấp quyền truy cập cho key. Quyền truy cập "Developer" là yêu cầu tối thiểu. 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)

3. Kết nối App Store Connect trên trang Kết nối

1. Tại trang tổng quan của trang Kết nối , chọn + Kết nối mới .

2. Mở danh sách đối tác và tìm tên App Store Connect.

3. Chọn dịch vụ iOS App Verification .

4. Nhập Key ID.

   • Bạn sao chép key này ở bước 6 quá trình tạo API key mới.

5. Nhập Issuer ID.

   • Bạn sao chép key này ở bước 4 quá trình tạo API key mới.

6. Nhập Private key.

   • Bạn sao chép key này ở bước 9 quá trình tạo API key mới.

7. Chọn Kết nối.

Sau khi bạn kết nối tài khoản, Adjust sẽ tạo JSON web token (JWT) và thử gửi yêu cầu lấy thông tin đến App Store Connect API.

Nếu tham số xác thực hợp lệ, thì kết nối sẽ được thiết lập. Nếu giá trị bạn nhập bị lỗi, thì thông báo lỗi sẽ hiện lên.

4. Gửi yêu cầu xác minh trên trang AppView

Chọn AppView > Tất cả ứng dụng. Chọn ứng dụng của bạn.

Mở tab Nền tảng và nhập App ID. Chọn Gửi yêu cầu xác minh.

1/2

(1/2)

(2/2)

Để yêu cầu Adjust xác minh app ID, truy cập Adjust dashboard và thực hiện các bước sau.

1. Chọn AppView > Tất cả ứng dung .
2. Chọn ứng dụng của bạn.
3. Chọn tab Nền tảng.
4. Tại trường Apple App Store, nhập App ID .
5. Chọn Gửi yêu cầu xác minh .
6. Để kiểm tra tiến độ xác minh app ID, bạn có thể theo dõi huy hiệu gán trên App Store icon.

• Nếu bạn đã gửi yêu cầu xác minh App ID, nhưng App ID chưa được xác minh, thì App Store icon sẽ có huy hiệu màu đỏ cùng ghi chú Yêu cầu xác minh iOS App ID đã gửi.
• Nếu App ID đã được xác minh, thì App Store icon sẽ có huy hiệu màu xanh lá cùng ghi chú iOS App ID đã xác minh.

Nếu có lỗi xảy ra trong quá trình xác minh app ID, bạn sẽ nhận được thông báo Xác minh không thành công.

Nếu bạn chưa nhập tham số xác thực vào trang Kết nối, chọn Truy cập Kết nối và thực hiện theo hướng dẫn nêu tại mục "Kết nối App Store Connect trên trang Kết nối".

Nếu bạn đã nhập tham số xác thực vào trang Kết nối , kiểm tra lại lần nữa, đảm bảo app ID bạn nhập vào Adjust dashboard khớp với app ID có trên App Store Connect.

Sau khi nhập tham số xác thực vào trang Kết nối, đồng thời đã kiểm tra để đảm bảo nhập đúng app ID, chọn Gửi yêu cầu xác minh lại lần nữa. Nếu thông báo lỗi vẫn hiện lên, thì có thể bạn gặp lỗi khác (ví dụ, tham số xác thực hợp lệ, nhưng tài khoản App Store Connect bị sai). Vui lòng liên hệ với đại diện Adjust hoặc bộ phận hỗ trợ theo địa chỉ support@adjust.com để được hỗ trợ.

5. Xóa kết nối và thu hồi key

Adjust chỉ yêu cầu bạn kết nối với App Store Connect API để xác minh ứng dụng iOS. Sau khi quá trình xác minh hoàn tất, bạn có thể xóa kết nối để bảo mật thông tin. Để xóa kết nối, truy cập Adjust dashboard và thực hiện các bước sau:

1. Tại mục DataWorks , chọn Kết nối.
2. Mở danh sách đối tác, chọn App Store Connect .
3. Tại cột Hành động, chọn Xóa .
4. Chọn Xóa .

Sau khi xác minh xong, bạn có thể thu hồi API key theo các bước sau:

1. Đăng nhập tài khoản App Store Connect bằng Apple ID có quyền admin và có quyền truy cập ứng dụng.
2. Chọn biểu tượng Users and Access .
3. Mở tab Keys .
4. Chọn Edit nằm bên phải mục Active keys.
5. Tích vào hộp kiểm nằm bên trái key mà bạn muốn thu hồi.
6. Chọn Revoke Key .
7. Chọn Revoke .