Trước khi người dùng đăng ký có thể nhìn thấy thông điệp giữ chân của bạn, Apple cần một cách để liên hệ với Adapty khi ai đó hủy đăng ký. Bài viết này hướng dẫn cách yêu cầu quyền truy cập từ Apple và thiết lập kết nối đó — trước tiên ở chế độ sandbox, sau đó trong môi trường production.

Trước khi bắt đầu

• Thêm App Store Connect API key vào Adapty. Adapty sử dụng key này để đăng ký URL realtime và giao tiếp với Apple.
• Yêu cầu quyền truy cập từ Apple và chờ Apple phê duyệt. Nếu không được phê duyệt, Apple sẽ từ chối kết nối.
• Tạo ít nhất một sản phẩm để thông báo của bạn có thể áp dụng.

Yêu cầu quyền truy cập từ Apple

Apple cấp quyền truy cập vào Retention Messaging API theo từng ứng dụng và yêu cầu bạn cung cấp URL endpoint để Apple gửi request đến. Adapty đã vận hành endpoint đó cho bạn, nên bạn không cần tự xây dựng hay host bất cứ thứ gì. Bạn chỉ cần gửi URL mà Adapty cung cấp.

1. Trong Adapty Dashboard, vào App settings > iOS SDK. Sao chép URL từ phần Apple Retention Messaging API. URL này dùng được cho cả môi trường sandbox lẫn production.
2. Mở biểu mẫu yêu cầu của Apple và gửi kèm URL vừa sao chép.
3. Chờ Apple quyết định. Apple sẽ xem xét, quá trình này có thể mất đến một tháng. Adapty sẽ thông báo cho bạn khi ứng dụng được phê duyệt.

Cho đến khi Apple phê duyệt ứng dụng của bạn, trang Retention Messaging sẽ hiển thị các bước và URL tương tự.

Thiết lập Sandbox

Apple yêu cầu bạn kiểm tra kết nối trong môi trường sandbox trước, để xác minh độ tin cậy trước khi gửi thông báo trên môi trường production.

Cấu hình Sandbox URL

Nhấn Configure Sandbox URL để bắt đầu thiết lập.

Adapty kết nối tài khoản App Store Connect của bạn với endpoint realtime của chính nó. Nếu App Store Connect đã có một URL khác được đặt sẵn, nút sẽ hiển thị Replace URL thay thế.

Khi kết nối thành công, Adapty xác nhận bằng thông báo “Sandbox URL has been configured.”

Vượt qua bài kiểm tra hiệu suất

Trước khi bạn có thể gửi tin nhắn production, Apple thực hiện một bài kiểm tra để xác nhận rằng Adapty phản hồi nhanh với các yêu cầu của Apple. Adapty chạy bài kiểm tra này dựa trên một gói đăng ký sandbox hoặc TestFlight đang hoạt động, mà bạn tự mua.

1. Mua sản phẩm có thời hạn dài nhất — gói hàng năm, nếu bạn có bán — bằng tài khoản sandbox hoặc qua TestFlight. Dùng sản phẩm App Store Connect thông thường của bạn: bạn không cần tạo sản phẩm riêng chỉ dành cho sandbox.
2. Nhấn Start Test ngay sau khi mua. Quá trình kiểm tra có thể mất tới một giờ, và gói đăng ký phải còn hoạt động cho đến khi kết thúc.
3. Nếu kiểm tra thất bại, hãy thực hiện một lần mua mới và nhấn Try Again. Nếu vẫn tiếp tục thất bại, hãy liên hệ support@adapty.io.

Chuyển sang môi trường production

Sau khi URL sandbox được cấu hình và bài kiểm tra hiệu suất vượt qua, Adapty cho phép bạn tắt toggle Sandbox mode để chuyển sang chế độ production.

Nhấn Configure Production URL. Adapty sẽ đăng ký endpoint của mình với Apple cho môi trường production và xác nhận bằng thông báo “Production URL has been configured.” Nếu một URL production khác đã được thiết lập trong App Store Connect, hãy nhấn Replace URL thay thế.

Các bước tiếp theo

• Tạo thông điệp giữ chân khách hàng mà người đăng ký sẽ thấy khi họ hủy gói.