Chế độ Kids trong React Native SDK

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

Important

Trên iOS, Chế độ Trẻ em được bật thông qua trait KidsMode của Swift package, giúp loại bỏ toàn bộ code liên quan đến IDFA, AdSupport và AppTrackingTransparency. Tính năng này yêu cầu SDK v4 và Xcode 26 trở lên. Cách áp dụng trait phụ thuộc vào package manager mà dự án iOS của bạn sử dụng — xem Cập nhật trong dự án iOS của bạn.

Cần cấu hình những gì?

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

IDFA (Identifier for Advertisers) (iOS)
Android Advertising ID (AAID/GAID) (Android)
Địa chỉ IP

Ngoài ra, chúng tôi khuyến nghị sử dụng customer user ID một cách thận trọng. User ID có định dạng <FirstName.LastName> chắc chắn sẽ bị coi là thu thập dữ liệu cá nhân, tương tự như việc sử dụng email. Đối với Kids Mode, phương pháp 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 Chế Độ 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, hãy vào App settings và nhấn Disable IP address collection trong mục Collect users’ IP address.

Cập nhật trong code ứng dụng di động của bạn

Để tuân thủ các chính sách, hãy tắt tính năng thu thập IDFA (iOS), GAID/AAID (Android) và địa chỉ IP của người dùng khi bạn kích hoạt Adapty SDK:


adapty.activate('YOUR_PUBLIC_SDK_KEY', {
  // Disable IP address collection
  ipAddressCollectionDisabled: true,

  // Disable IDFA collection on iOS
  ios: {
    idfaCollectionDisabled: true,
  },

  // Disable Google Advertising ID collection on Android
  android: {
    adIdCollectionDisabled: true,
  },
});

Cập nhật trong dự án iOS của bạn

Đối với danh mục Kids trên App Store (hoặc tuân thủ COPPA), iOS SDK gốc phải được build với trait Swift package KidsMode, giúp loại bỏ toàn bộ code liên quan đến IDFA, AdSupport và AppTrackingTransparency. Bước này yêu cầu Xcode 26 trở lên.

Swift Package Manager không thể chuyển tiếp các trait của package qua bất kỳ cách tích hợp nào, vì vậy Adapty React Native SDK cung cấp một công cụ tự động áp dụng trait đó cho bạn. Chọn cách phù hợp với cách dự án iOS của bạn được thiết lập, như mô tả trong Cài đặt Adapty SDK.

SDK đi kèm với một Podfile helper. Trong ios/Podfile, hãy require helper và gọi nó sau react_native_post_install:

require Pod::Executable.execute_command('node', ['-p',
  'require.resolve(
    "react-native-adapty/ios/adapty_kids_mode.rb",
    {paths: [process.argv[1]]},
  )', __dir__]).strip

# ...

post_install do |installer|
  react_native_post_install(
    installer,
    config[:reactNativePath],
    :mac_catalyst_enabled => false
  )

  adapty_enable_kids_mode(installer)
end

Sau đó chạy pod install:

cd ios && pod install

Giữ lệnh gọi helper trong post_install mãi mãi — React Native tái tạo các tham chiếu Swift package mỗi lần chạy pod install, và helper sẽ áp dụng lại trait mỗi lần.

SDK đi kèm với lệnh adapty-spm-kids-mode. Chạy nó như một postinstall hook trong package.json của ứng dụng:

{
  "scripts": {
    "postinstall": "adapty-spm-kids-mode enable"
  }
}

Sau đó cài đặt lại các dependency để chạy hook lần đầu tiên:

npm install

# or using yarn
yarn install

Hook này thuộc về package.json một cách vĩnh viễn. Swift Package Manager autolinking của React Native không có khái niệm về package traits và tái tạo aggregator package sau mỗi lần đồng bộ, vì vậy lệnh này sẽ kích hoạt trait trong manifest của SDK bên trong node_modules — thứ mà mỗi lần cài đặt sẽ thay thế.

Sau khi bật hoặc tắt Kids Mode, hãy dọn sạch thư mục build trước lần build iOS tiếp theo (Product → Clean Build Folder trong Xcode).

Note

adapty-spm-kids-mode enable sẽ in ra cảnh báo mà không làm thất bại quá trình cài đặt, khi không thể xác nhận tích hợp Swift Package Manager hoặc phát hiện ứng dụng CocoaPods — nơi React Native không đọc Package.swift, nên tùy chọn này không có hiệu lực. Nếu dự án iOS của bạn nằm ngoài thư mục bạn cài đặt từ đó, hãy truyền --app-root=path/to/app.

Để tắt Kids Mode, hãy đổi hook thành adapty-spm-kids-mode disable.

Để xác nhận Kids Mode đang hoạt động, hãy kiểm tra dòng log adapty.activate(...) và đảm bảo nó báo kids_mode_enabled: true.

Cập nhật trong Android manifest của bạn

Note

Nếu ứng dụng của bạn chỉ nhắm đến đối tượng trẻ em và biên dịch với Android 13 (API 33) trở lên, Google Play yêu cầu bạn không được yêu cầu quyền AD_ID. Một SDK khác trong ứng dụng của bạn (analytics, attribution, hoặc quảng cáo) có thể thêm quyền này thông qua manifest merging. Việc đặt adIdCollectionDisabled ngăn Adapty thu thập ID, nhưng không xóa được quyền mà một SDK khác đã khai báo.

Để xóa quyền này, thêm đoạn sau vào bên trong phần tử <manifest> của android/app/src/main/AndroidManifest.xml. Phần tử <manifest> phải khai báo xmlns:tools="http://schemas.android.com/tools".

<uses-permission
    android:name="com.google.android.gms.permission.AD_ID"
    tools:node="remove" />