Adapty sử dụng API key App Store Connect để làm việc với các sản phẩm của bạn trong App Store Connect:

• Tạo sản phẩm và nhóm gói đăng ký.
• Tìm sản phẩm hiện có theo ID khi bạn thêm sản phẩm trong Adapty.
• Hiển thị trạng thái App Store của từng sản phẩm trong Adapty.
• Import giá mỗi ngày và export các thay đổi giá bạn thực hiện trong Adapty.
• Đề xuất sản phẩm cho Switch Plan trong Retention Messaging.

Adapty chỉ thay đổi App Store Connect khi bạn thực hiện thao tác trong Adapty, chẳng hạn khi tạo sản phẩm hoặc thay đổi giá. Để hiển thị trạng thái và import giá, Adapty chỉ đọc dữ liệu từ App Store Connect.

Tạo key trên tab Team Keys trong App Store Connect, sau đó kết nối nó trong App settings của Adapty. Nếu key ngừng hoạt động hoặc cần thay đổi, hãy thay thế nó.

App Store Connect API key khác với In-App Purchase key, mặc dù App Store Connect gán nhãn ID của cả hai key đều là Issuer ID và Key ID.

Để nhập tất cả thông tin xác thực trong App settings > iOS SDK cùng một lúc, hãy làm theo hướng dẫn Cấu hình tích hợp App Store.

Tạo team key trong App Store Connect

1. Trong App Store Connect, truy cập Users and Access > Integrations > App Store Connect API, và mở tab Team Keys. Adapty cần một team key: các individual key không có Issuer ID.

   Một team key phục vụ cho tất cả app trong App Store Connect team của bạn. Nếu trên tab này đã có key đang hoạt động với quyền truy cập Admin và bạn có file của nó, hãy dùng lại và bỏ qua bước 2-4.

   Nếu team của bạn chưa có quyền truy cập App Store Connect API, Account Holder cần yêu cầu. Apple sẽ xem xét từng yêu cầu.

2. Để tạo key, bạn cần có vai trò Account Holder hoặc Admin trong App Store Connect. Nếu không có vai trò nào trong số này, hãy nhờ người có vai trò đó tạo key với quyền truy cập Admin và gửi cho bạn file cùng với Issuer ID và Key ID.

   Nếu tab đã liệt kê các key đang hoạt động, nhấp +. Nếu không, nhấp Generate API Key.

   

3. Nhập tên cho key và đặt Access thành Admin. Access xác định những gì Adapty có thể thực hiện với key, bất kể vai trò của bạn là gì. Bạn không thể thay đổi Access sau khi đã tạo key. Nhấp Generate.

   

4. Bạn chỉ có thể tải xuống mỗi key một lần. Bên cạnh key mới, nhấp Download. Giữ file này an toàn: bạn sẽ tải nó lên từng Adapty app sử dụng key đó.

   

Kết nối khóa trong Adapty

1. Để tìm Issuer ID và Key ID của team key, trong App Store Connect, hãy vào Users and Access > Integrations > App Store Connect API và mở tab Team Keys. Nếu người khác đã tạo key và gửi cho bạn Issuer ID, Key ID và file, hãy bỏ qua bước này.

   

2. Trong Adapty, vào App settings > iOS SDK. Trong phần App Store Connect API key, nhấp vào Connect API Key.

   

3. Điền vào các trường:

   • Issuer ID: Sao chép từ tab Team Keys trong App Store Connect.
   • Key ID: Sao chép từ danh sách Active trên tab Team Keys, bên cạnh key bạn đã tải xuống.
   • Private key (.p8 file): Tải lên file bạn đã tải xuống cho team key.
   

4. Bạn có thể thay thế key đã kết nối sau này, nhưng không thể xóa nó. Hãy đảm bảo key thuộc về team App Store Connect sở hữu ứng dụng này, rồi nhấp vào Connect. Từ đó trở đi, bạn sẽ chọn từng App Store Product ID từ các sản phẩm của mình trong App Store Connect thay vì nhập thủ công.

   Adapty không xác minh key với Apple khi bạn kết nối. Một key sai sẽ thất bại mà không có thông báo gì về key đó: các sản phẩm sẽ không hiển thị trạng thái App Store và dropdown App Store Product ID sẽ trống. Để sửa key sai, hãy thay thế nó.

Thay thế key

Nếu key ngừng hoạt động hoặc cần thay đổi cài đặt Access, hãy kết nối key mới trong Adapty trước khi thu hồi key cũ.

Nếu không có key hoạt động, Adapty sẽ không thể:

• Tạo sản phẩm.
• Tìm các sản phẩm hiện có theo ID.
• Đồng bộ trạng thái và giá của sản phẩm.

Một key đã ngừng hoạt động vẫn hiển thị là đã kết nối trong Adapty. Dấu hiệu nhận biết là sản phẩm không có trạng thái App Store và danh sách App Store Product ID bị trống.

Adapty không hiển thị Key ID của khóa đã kết nối. Nếu bạn không biết Adapty đang sử dụng khóa nào, hãy thay thế bằng khóa mới.

Khi ứng dụng của bạn chuyển sang tài khoản nhà phát triển Apple khác, hãy kết nối team key từ chủ sở hữu mới.

Để thay thế khóa:

1. Tạo một team key mới.
2. Trong Adapty, vào App settings > iOS SDK. Trong mục App Store Connect API key, nhấp Edit. Nhập các giá trị của key mới, rồi nhấp Save changes.
3. Một team key dùng được cho tất cả các app trong App Store Connect team của bạn. Nếu các app khác trong team của bạn cũng dùng Adapty, hãy kết nối key mới cho chúng. Thay thế key cũ trên bất kỳ server nào đang dùng nó.
4. Key bị thu hồi sẽ ngừng hoạt động trong mọi app đang dùng nó và không thể khôi phục. Nếu bạn biết key mới thay thế key nào, hãy vào App Store Connect và thu hồi key cũ đó.