Chế độ Kids Mode trong iOS SDK

Nếu ứng dụng iOS của bạn dành cho trẻ em, bạn phải tuân thủ các chính sách của Apple. Nếu đang sử dụng Adapty SDK, bạn chỉ cần thực hiện vài bước đơn giản để cấu hình SDK theo đúng các chính sách này và vượt qua quy trình kiểm duyệt của cửa hàng.

Yêu cầu cần thực hiện

Bạn cần cấu hình Adapty SDK để tắt việc thu thập:

Ngoài ra, chúng tôi khuyến nghị sử dụng customer user ID một cách cẩn thận. ID người dùng có định dạng <FirstName.LastName> chắc chắn sẽ bị xem là thu thập dữ liệu cá nhân, cũng như việc dùng email. Trong Kids Mode, cách tốt nhất là sử dụng các định danh ngẫu nhiên hoặc ẩn danh (ví dụ: hashed ID hoặc UUID do thiết bị tạo ra) để đảm bảo tuân thủ.

Bật Kids Mode

Cập nhật trong Adapty Dashboard

Trong Adapty Dashboard, bạn cần tắt tính năng thu thập địa chỉ IP. Để thực hiện, vào App settings và nhấn Disable IP address collection trong phần Collect users’ IP address.

Cập nhật trong code của ứng dụng

Để tuân thủ các chính sách, hãy tắt việc thu thập IDFA và địa chỉ IP của người dùng.

Nếu bạn dùng Swift Package Manager, bạn có thể bật Kids Mode bằng cách chọn module Adapty_KidsMode trong Xcode khi cài đặt SDK.

Trong Xcode, vào File -> Add Package Dependency…. Lưu ý rằng các bước thêm package dependency có thể khác nhau giữa các phiên bản Xcode, hãy tham khảo tài liệu Xcode nếu cần.

Nhập URL repository:

https://github.com/adaptyteam/AdaptySDK-iOS.git

Chọn phiên bản (khuyến nghị dùng phiên bản ổn định mới nhất) và nhấn Add Package.
Trong cửa sổ Choose Package Products, chọn các module bạn cần:
- Adapty_KidsMode (module cốt lõi)
- AdaptyUI_KidsMode (tùy chọn - chỉ cần nếu bạn dự định dùng Paywall Builder)
Bạn không cần thêm bất kỳ package nào khác.
Nhấn Add Package để hoàn tất cài đặt.
Trong code của bạn, viết import Adapty_KidsMode thay vì import Adapty, và import AdaptyUI_KidsMode thay vì import AdaptyUI:

Cập nhật Podfile của bạn:

Nếu bạn chưa có phần post_install, hãy thêm toàn bộ đoạn code bên dưới.
Nếu bạn đã có phần post_install, hãy hợp nhất các dòng được đánh dấu vào đó.

def adapty_enable_kids_mode(installer)
  installer.pods_project.targets.each do |target|
    next unless target.name == 'Adapty'
    target.build_configurations.each do |config|
      flags = config.build_settings['OTHER_SWIFT_FLAGS'] || '$(inherited)'
      flags = flags.join(' ') if flags.is_a?(Array)
      config.build_settings['OTHER_SWIFT_FLAGS'] = "#{flags} -DADAPTY_KIDS_MODE"
    end
    target.frameworks_build_phase.files.dup.each do |bf|
      target.frameworks_build_phase.remove_build_file(bf) if bf.display_name.to_s.include?('AdSupport')
    end
  end
  installer.pods_project.save
  Dir.glob(File.join(installer.sandbox.root, 'Target Support Files', '**', '*.xcconfig')).each do |xc|
    File.write(xc, File.read(xc).gsub(/\s*-framework\s+"?AdSupport"?/, ''))
  end
end

post_install do |installer|
  # ... keep your existing post_install body (Flutter adds one automatically) ...

  adapty_enable_kids_mode(installer)   # <-- enable Adapty Kids Mode
end

Chạy lệnh sau để áp dụng các thay đổi:
```
pod install
```