Ingin meluncurkan aplikasi Anda di Capacitor toko aplikasi tanpa gangguan? Mulai dengan membuat Dokumen Privasi. Apple sekarang memerlukan pengembang untuk mencantumkan dokumen ini untuk memastikan aplikasi memenuhi standar privasi ketat. Berikut ini yang perlu Anda ketahui: Apa itu Dokumen Privasi?
-
File yang terstruktur yang menjelaskan praktik pengumpulan data aplikasi Anda, __CAPGO_KEEP_0__ penggunaan, dan domain pelacakan.
A structured file outlining your app’s data collection practices, API usage, and tracking domains. -
Mengikuti aturan toko aplikasi untuk menghindari penolakan atau penghapusan.
- Membangun kepercayaan dengan menjadi transparan tentang pengelolaan data pengguna.
- Komponen utama untuk dicantumkan:
-
Key components to include:
- API yang mengakses data pengguna (misalnya lokasi, foto).
- Label privasi untuk jenis data yang dikumpulkan.
- Domain pelacakan yang digunakan untuk analisis atau iklan.
-
Cara membuatnya:
- Pakai JSON untuk mendefinisikan detail pengumpulan data.
- Letakkan
PrivacyInfo.xcprivacyfile di direktori yang benar dari proyek Anda. - Validasikan dengan alat seperti Xcode untuk menghindari kesalahan.
-
Alat untuk memudahkan proses:
Pakai platform seperti Capgo untuk validasi manifesto privasi otomatis, pembaruan waktu nyata, dan pelacakan kesalahan. Ketika manifesto Anda menyatakan SDK pelacakan atau analitik, @capgo/capacitor-app-tracking-transparency menangani prompt ATT iOS dan @capgo/capacitor-firebase-analytics mendokumentasikan pengumpulan data Firebase untuk tinjauan App Store.
Jadilah kompatibel, lindungi privasi pengguna, dan hindari keterlambatan toko aplikasi dengan mengikuti panduan ini.
Dasar-Dasar Manifest Privasi
Pengertian Manifest Privasi
A privacy manifest is a structured file that outlines your app’s data practices. It details elements like APIs accessing user data, tracking domains, data types collected, and third-party SDK integrations. This document not only helps establish trust but also ensures compliance with App Store guidelines. Let’s break down the key components your manifest should include.
Elemen Utama Manifest Privasi
Berikut adalah elemen utama yang harus Anda masukkan dalam manifesto privasi Anda untuk menyesuaikan dengan persyaratan Apple:
-
Alasan Wajib API
Bagian ini menampilkan daftar API yang sensitif privasi aplikasi Anda dan menjelaskan mengapa mereka diperlukan.Berikut adalah tabel yang menjelaskan persyaratan umum API:
API Kategori Penggunaan Umum Dokumentasi Wajib Lokasi Layanan Penggunaan navigasi Deskripsi string dan penggunaan Fotografi Perpustakaan Foto Profil Level akses dan niat Kontak Sinkronisasi buku alamat Pernyataan minimasi data -
Label Privasi
Label-label ini menyediakan transparansi dengan menyebutkan:- Jenis data yang dikumpulkan
- Alasan pengumpulan data
- Apakah data terkait dengan identitas pengguna
- Bagaimana data digunakan untuk pelacakan
-
Domain Pelacakan
Bagian ini menampilkan semua domain yang terlibat dalam pelacakan, seperti yang digunakan untuk analisis, iklan, atau pengolahan data pihak ketiga.
“Kompatibel dengan App Store” - Capgo [1]
Menurut Capgo, 95% pengguna mematuhi pembaruan dalam waktu 24 jam. Dengan lebih dari 23,5 juta pembaruan yang disampaikan [1]Mengikuti dokumentasi privasi yang terkini sangat penting untuk mempertahankan kepercayaan pengguna.
Membangun Deklarasi Privasi untuk Capacitor
Persyaratan Pengaturan
Sebelum Anda memulai membangun deklarasi, pastikan Anda telah:
- Xcode 15 atau lebih baru terinstal
- Proyek Capacitor 8.0+ yang telah diatur
- Akses ke file aplikasi Anda
Info.plistPemahaman dasar tentang struktur JSON - __CAPGO_KEEP_0__
- Pedoman Dokumentasi yang menjelaskan praktik pengumpulan data aplikasi Anda
Langkah-Langkah Pembuatan
Mulai dengan membuat sebuah PrivacyInfo.xcprivacy file di direktori project iOS Anda. File ini harus mengikuti pedoman format yang spesifik:
Pengaturan Informasi Dasar
{
"NSPrivacyTracking": false,
"NSPrivacyTrackingDomains": [],
"NSPrivacyCollectedDataTypes": []
}Pengaturan Detail Pengumpulan Data
{
"NSPrivacyAccessedAPITypes": [
{
"NSPrivacyAccessedAPIType": "NSLocationWhenInUseUsageDescription",
"NSPrivacyAccessedAPITypeReasons": ["1.1"]
},
{
"NSPrivacyAccessedAPIType": "NSCameraUsageDescription",
"NSPrivacyAccessedAPITypeReasons": ["2.1"]
}
]
}Pengaturan Domain Pelacakan
{
"NSPrivacyTrackingDomains": [
"analytics.yourdomain.com",
"metrics.yourdomain.com"
]
}Menghindari Kesalahan Umum
Untuk mencegah masalah, perhatikan tips berikut:
- Termasuk Semua Bidang yang Diperlukan: Bahkan jika beberapa bidang kosong, mereka harus ada.
- Penggunaan Tipe API yang Valid: Periksa API identifier dengan dokumen resmi Apple.
- Periksa Format JSON: Jalankan file Anda melalui linter JSON untuk menangkap kesalahan sintaks.
- Berikan Alasan yang Lengkap: Pastikan setiap API akses termasuk alasan code yang sesuai.
- Jaga Informasi Tetap Aktual: Perbarui manifesto ketika fitur baru ditambahkan.
Selain itu, pastikan file manifesto tetap di bawah 512KB untuk menghindari kesalahan saat build. Validasi file secara teratur selama proses build Xcode untuk menangkap kesalahan awal. Setelah manifesto Anda siap, integrasikan ke dalam proyek Capacitor Anda dengan mengikuti pedoman penempatan file.
Mengintegrasikan Manifest Privasi ke Capacitor
Pedoman Penempatan File
Untuk mencakup manifesto privasi dalam proyek Capacitor Anda, tempatkan file di struktur direktori berikut: PrivacyInfo.xcprivacy __CAPGO_KEEP_0__
your-app/
├── ios/
│ ├── App/
│ │ ├── PrivacyInfo.xcprivacy
│ │ └── Info.plist
│ └── App.xcworkspaceUntuk Capacitor plugin, gunakan struktur ini:
your-plugin/
├── ios/
│ ├── Plugin/
│ │ └── PrivacyInfo.xcprivacy
│ └── Plugin.xcodeprojPengaturan Pembangunan
Setelah file tersebut berada di tempat, update pengaturan pembangunan Xcode Anda untuk memastikan integrasi yang tepat:
- Buka proyek Anda di Xcode.
- Di bawah TARGETS, pilih target aplikasi atau plugin Anda.
- Klik ke tab Pengaturan Pembangunan .
- Setel Wilayah Pengembangan Manifest Privasi ke
en. - Set Inklusif Manifest Privasi ke
YES.
Jika proyek Anda menggunakan CocoaPods, masukkan kode berikut ke dalam Podfile untuk mengaktifkan manifest privasi:
post_install do |installer|
installer.pods_project.targets.each do |target|
target.build_configurations.each do |config|
config.build_settings['INCLUDE_PRIVACY_MANIFEST'] = 'YES'
end
end
endMembuat perubahan-perubahan ini, lanjutkan dengan verifikasi implementasi untuk memastikan semuanya sudah terkonfigurasi dengan benar.
Verifikasi Implementasi
Untuk memastikan manifest privasi berfungsi dengan benar, ikuti langkah-langkah berikut:
-
Verifikasi Pembangunan
- Konfirmasikan tidak ada peringatan privasi selama proses pembangunan.
- Pastikan manifest terkompilasi tanpa masalah.
- Verifikasi bahwa manifest privasi termasuk dalam produk pembangunan.
-
Validasi Waktu Eksekusi
- Pada mode debug, tes untuk memastikan prompt privasi yang tepat dan perilaku akses API.
-
Validasi App Store Connect
- Unggah build Anda dan tinjau Laporan Privasi di App Store Connect.
- Periksa bahwa deklarasi API lengkap dan format domain pelacakan benar.
Jika Anda mengalami kesalahan “Validasi Manifest Privasi gagal”, periksa kembali manifest Anda untuk memastikan bahwa itu memenuhi persyaratan App Store terbaru. Berikan perhatian khusus pada jenis API dan konfigurasi domain pelacakan.
Perubahan Manifest Privasi Apple
Pengujian dan Perbaikan
Membuat Manifest Privasi yang memenuhi pedoman Apple sangat penting. Untuk tetap berada di jalur yang benar, integrasikan pengawasan kesalahan yang dapat diandalkan ke dalam proses pengembangan Anda. Hal ini membantu menghubungkan upaya pengembangan dengan persyaratan kompatibilitas.
Sebuah alat seperti Capgo bisa membantu. Ia memantau akses API dan mengidentifikasi masalah manifest sebelum mereka mempengaruhi pengguna. Setelah masalah potensial ditandai, Anda dapat memindahkan fokus ke validasi yang lebih menyeluruh.
Setelah membuat perubahan, tes manifest Anda di lingkungan pengembangan. Gunakan wawasan dari pengawasan kesalahan untuk mengarahkan ulasan Anda. Pendekatan ini membantu memastikan aplikasi Anda tetap sejalan dengan standar privasi Apple.
Capgo Alat Privasi
Capgo memudahkan mengelola manifest privasi dan pembaruan aplikasi, sehingga standar privasi Anda tetap utuh tanpa mengganggu peluncuran.
Fitur Capgo
Dengan lebih dari 23,5 juta pembaruan yang terlindungi dan sebuah 82% sukses global, Capgo memastikan bahwa 95% pengguna aktif menerima pembaruan dalam waktu 24 jam [1]. Berikut ini apa yang ditawarkan:
- Enkripsi ujung ke ujung context: Situs web pemasaran Capgo. Peran: Label UI singkat atau item navigasi. Kunci pesan `end_to_end_encryption` (End To End Encryption).
- untuk menjaga pembaruan aman Sistem saluran
- untuk distribusi pembaruan yang terkendali Pemantauan kesalahan
- untuk mengidentifikasi dan menangani masalah dengan cepat To dapatkan versi sebelumnya secara instan
Alat-alat ini membuat menambahkan Capgo ke dalam alur kerja Anda menjadi hal yang halus dan efisien.
Menggunakan Capgo
Untuk memulai, Instal plugin Capgo Dengan perintah ini:
npx @capgo/cli initCapgo secara otomatis mengintegrasikan dengan pipeline CI/CD, mengotomatiskan validasi manifesto privasi melalui platform seperti Capgo Actions GitHub Actions, , atauJenkins . Apapun pilihan Anda, __CAPGO_KEEP_0__ mendukung 750 aplikasi produksi sambil memastikan setiap update memenuhi standar privasi.Capgo
“Kami menerapkan pengembangan agile dan @Capgo sangat kritis dalam menyampaikan kontinu kepada pengguna kami!” – Rodrigo Mantica
“Capgo adalah cara pintar untuk membuat push code yang panas 🙂” – NASA’s OSIRIS-REx
Capgo juga mencakup analitis bawaan untuk memantau tingkat kesuksesan pembaruan dan keterlibatan pengguna secara real-time. Hal ini memastikan pembaruan privasi mencapai basis pengguna seluruhnya sambil tetap memenuhi pedoman Apple.
Kesimpulan
Poin Utama
Ketika berbicara mengenai mengelola manifest privasi, menjaga kinerja yang kompatibel dan menjaga keamanan yang kuat sangat penting. Berikut ini yang paling penting:
- Enkripsi Akhir ke Akhir: Menjaga pembaruan tetap aman dari awal hingga akhir.
- Pengawasan Real-Time: Mengikuti distribusi pembaruan dengan efektif.
- Kemampuan Rollback Instan: Berfungsi sebagai jaring pengaman untuk perbaikan cepat.
- Validasi Otomatis: Pastikan pembaruan Anda memenuhi standar komplian.
Membangun sistem pembaruan yang dapat diandalkan membantu Anda tetap berada di depan kebutuhan privasi yang terus berkembang dari Apple dan Google. Pendekatan ini telah terbukti meningkatkan tingkat persetujuan toko aplikasi dan memperkuat kepercayaan pengguna [1].
Cara Mulai
Mulai melaksanakan prinsip-prinsip ini dengan mengikuti langkah-langkah berikut:
- Konfigurasi Lingkungan: Jal
npx @capgo/cli inituntuk memulai. - Aktifkan Fitur Privasi: Gunakan enkripsi akhir-ke-akhir untuk pembaruan yang aman.
- Deploy Alat Pemantauan: Ikuti pembaruan dengan analitis.
- Persiapan untuk mengembalikan ke versi sebelumnya: Pastikan Anda dapat kembali ke versi sebelumnya dengan cepat jika diperlukan.
“Capgo adalah alat yang wajib dimiliki oleh para pengembang yang ingin meningkatkan produktivitas. Menghindari penundaan ulasan untuk memperbaiki bug adalah perubahan game.” - Bessie Cooper
Pembaruan reguler dan alat yang tepat adalah kunci untuk tetap kompatibel dan meningkatkan waktu.
Teruskan dari Privacy Manifest untuk Capacitor Apps: Guide
Jika Anda menggunakan Privacy Manifest untuk Capacitor Apps: Guide untuk merencanakan keamanan dan kompatibilitas, hubungkannya dengan Enkripsi untuk detail implementasi di Enkripsi, Kompatibilitas untuk detail implementasi di Kompatibilitas, Pengawasan Keamanan Capgo untuk alur kerja produk di Pengawasan Keamanan Capgo Pengawasan Capgo untuk alur kerja produk di Pengawasan Capgo, dan Pusat Kepercayaan Capgo untuk alur kerja produk di Pusat Kepercayaan Capgo.
