Kết nối Apple App Store
Tạo khóa API App Store Connect với đúng vai trò, thêm vào, và chọn ứng dụng của bạn.
Apple không dùng cửa sổ đăng nhập bật lên cho báo cáo. Bạn tạo một khóa API trong App Store Connect, tải xuống một lần, rồi dán thông tin của nó vào Revenue Sensor. Trong bảng điều khiển, nguồn này được gọi là Apple IAP.
Trước khi bắt đầu
- Quyền Account Holder hoặc Admin trên App Store Connect, để bạn có thể tạo khóa.
- Vendor Number của bạn, lấy từ App Store Connect → Reports → Payments and Financial Reports. Nó hiển thị ở góc trên bên trái, dưới tên tài khoản của bạn.
Tạo khóa API
- 1
Mở trang khóa Integrations
App Store Connect → Users and Access → Integrations → App Store Connect API.
- 2
Tạo một khóa
Bấm dấu + bên cạnh Active và đặt cho khóa một cái tên bạn sẽ nhận ra, chẳng hạn “Revenue Sensor”.
- 3
Gán vai trò báo cáo
Trong Access, chọn Sales, Finance hoặc Admin. Mỗi vai trò này đều có thể đọc các báo cáo Sales and Trends mà Revenue Sensor nhập. Admin là vai trò duy nhất còn cho các con số chính xác của App Store Connect (xem bên dưới). Một khóa chỉ có quyền Developer hoặc App Manager không thể đọc doanh thu.
- 4
Tải tệp .p8
Apple chỉ cho bạn tải khóa riêng tư đúng một lần. Hãy lưu nó ở nơi an toàn trước khi rời trang. Nếu làm mất, hãy tạo một khóa mới và dùng Key ID mới cùng tệp .p8 của nó.
Lỗi phổ biến nhất
Nếu doanh thu trả về trống, hoặc tài khoản hiển thị “Your API key needs the Sales role”, nguyên nhân gần như luôn là vai trò của khóa: hãy gán vai trò Sales hoặc Finance cho nó trong App Store Connect, rồi kết nối lại. Đồng thời kiểm tra rằng Vendor Number thuộc cùng tài khoản App Store Connect với khóa.
Thêm thông tin đăng nhập
- Issuer ID: hiển thị ở đầu trang khóa API App Store Connect. Nó giống nhau cho mọi khóa.
- Key ID: hiển thị trong dòng của khóa bạn đã tạo.
- Khóa riêng tư: tệp .p8 bạn đã tải xuống. Tải lên hoặc kéo thả vào. Nó được lưu ở dạng mã hóa và không bao giờ hiển thị lại.
- Vendor Number: lấy từ Payments and Financial Reports.
Chọn ứng dụng
Revenue Sensor liệt kê các ứng dụng đã phát hành mà khóa có thể thấy. Chọn những ứng dụng bạn muốn theo dõi. Chỉ các ứng dụng đã chọn mới được đồng bộ.
Những gì được nhập
Doanh thu là số đơn vị nhân với Developer Proceeds từ báo cáo tóm tắt Sales hằng ngày của Apple. Proceeds là số tiền Apple trả cho bạn, sau hoa hồng và mọi khoản thuế Apple thu, nên Payout là cơ sở doanh thu duy nhất cho nguồn này. Một khoản hoàn tiền xuất hiện dưới dạng một dòng có số đơn vị âm, nên nó được trừ vào ngày Apple xử lý. Lượt tải xuống và hoàn tiền được nhập từ cùng báo cáo đó.
Độ trễ báo cáo
Apple công bố báo cáo doanh số của mỗi ngày sau khi ngày đó kết thúc, nên hôm nay chưa bao giờ hiển thị. Những ngày gần đây có thể thay đổi đôi chút khi Apple điều chỉnh lại; mỗi lần đồng bộ đều đọc lại 14 ngày gần nhất.