Guida per il manifesto di privacy delle app Capacitor

Manifesto di Privacy per le Applicazioni __CAPGO_KEEP_0__ Volete lanciare il vostro Capacitor app sul App Store senza ritardi? Inizia creando un manifesto sulla privacy. Apple richiede ora agli sviluppatori di includere questo documento per garantire che le app soddisfino gli standard di privacy rigorosi. Ecco cosa devi sapere:

Cosa è un manifesto sulla privacy?
Un file strutturato che descrive le pratiche di raccolta dei dati dell'app, l'uso di API e i domini di tracciamento.
Perché è importante:
- Rispetta le regole dell'App Store per evitare rifiuti o rimozioni.
- Costruisce la fiducia essendo trasparente sul trattamento dei dati degli utenti.
Componenti chiave da includere:
- API che accedono ai dati degli utenti (ad esempio, posizione, foto).
- Etichette sulla privacy per i tipi di dati raccolti.
- Domini di tracciamento utilizzati per l'analisi o gli annunci pubblicitari.
Come crearne uno:
- Usare JSON per definire i dettagli della raccolta dei dati.
- Colloca il PrivacyInfo.xcprivacy file nella directory corretta del tuo progetto.
- Validalo con strumenti come Xcode per evitare errori.
Gli strumenti per semplificare il processo:
Usa piattaforme come Capgo per la validazione del manifesto di privacy automatizzata, aggiornamenti in tempo reale e tracciamento degli errori. Quando il tuo manifesto dichiara SDK di tracciamento o di analisi, @capgo/capacitor-app-tracking-transparency gestisce le richieste di ATT di iOS e @capgo/capacitor-firebase-analytics documenta la raccolta dei dati Firebase per la revisione dell'App Store.

Resta conforme, proteggi la privacy degli utenti e evita i ritardi negli store di app seguendo questa guida.

Basi della dichiarazione di privacy

Definizione della dichiarazione di privacy

Una dichiarazione di privacy è un file strutturato che descrive le pratiche di dati del tuo app. Dettaglia elementi come API che accedono ai dati degli utenti, domini di tracciamento, tipi di dati raccolti e integrazioni di terze parti SDK. Questo documento non solo aiuta a stabilire la fiducia, ma anche a garantire la conformità con le linee guida dell'App Store. Vediamo come smontare i componenti chiave che il tuo manifesto dovrebbe includere.

Elementi principali della dichiarazione di privacy

Ecco gli elementi principali da includere nella tua dichiarazione di privacy per allinearti con le richieste di Apple:

API di ragione obbligatoria
Questa sezione elenca le API sensibili alla privacy che il tuo app utilizza e spiega perché sono necessarie.

Ecco di seguito una tabella che riassume le richieste comuni API:

API Categoria	Utilizzo comune	Documentazione richiesta
Servizi di localizzazione	Navigazione dell'utente	Descrizione della stringa e dell'uso
Libreria delle foto	Foto del profilo	Livello di accesso e intento
Contatti	Sincronizzazione dell'agenda degli appuntamenti	Dichiarazione di minimizzazione dei dati

Etichette sulla privacy
E queste etichette forniscono trasparenza specificando:
- Tipi di dati raccolti
- Motivi della raccolta dei dati
- Se i dati sono collegati all'identità dell'utente
- Come i dati sono utilizzati per il tracciamento
Dominio di tracciamento
Questa sezione elenca tutti i domini coinvolti nel tracciamento, come quelli utilizzati per l'analisi, la pubblicità o il trattamento dei dati di terze parti.

“Compatibile con l'App Store” - Capgo [1]

Secondo Capgo, il 95% degli utenti si conforma alle aggiornamenti entro 24 ore. Con oltre 23,5 milioni di aggiornamenti consegnati [1], mantenere aggiornata la documentazione sulla privacy è essenziale per mantenere la fiducia degli utenti.

Costruire Manifesti di Privacy per Capacitor

Documentazione del sito web del framework Capacitor

Requisiti di configurazione

Prima di iniziare a costruire il manifesto, assicurati di avere:

Xcode 15 o una versione successiva installato
Un progetto Capacitor 8.0+ configurato
Accesso al file del tuo app Info.plist Una comprensione di base della struttura JSON
Documentazione che descrive le pratiche di raccolta dati del tuo app
Istruzioni di creazione

__CAPGO_KEEP_0__

Avvia creando un PrivacyInfo.xcprivacy file nel tuo directory del progetto iOS. Questo file deve seguire specifiche linee guida di formattazione:

Configura le Informazioni di Base

{
    "NSPrivacyTracking": false,
    "NSPrivacyTrackingDomains": [],
    "NSPrivacyCollectedDataTypes": []
}

Definisci i Dettagli della Raccolta dei Dati

{
    "NSPrivacyAccessedAPITypes": [
        {
            "NSPrivacyAccessedAPIType": "NSLocationWhenInUseUsageDescription",
            "NSPrivacyAccessedAPITypeReasons": ["1.1"]
        },
        {
            "NSPrivacyAccessedAPIType": "NSCameraUsageDescription",
            "NSPrivacyAccessedAPITypeReasons": ["2.1"]
        }
    ]
}

Aggiungi i Domini di Tracciamento

{
    "NSPrivacyTrackingDomains": [
        "analytics.yourdomain.com",
        "metrics.yourdomain.com"
    ]
}

Evitare gli Errori Comuni

Per evitare problemi, tenere a mente queste indicazioni:

Includi tutti i Campi Richiesti: Anche se alcuni campi sono vuoti, devono essere presenti.
Utilizza Tipi di API Validi: Verifica gli identificatori di API con la documentazione ufficiale di Apple.
Controlla la Formattazione JSON: Esegui il tuo file con un linter JSON per individuare gli errori di sintassi.
Fornire Motivi Completi: Assicurati che ogni accesso a API includa un motivo corrispondente code.
Tenere le Informazioni Aggiornate: Aggiorna il manifesto ogni volta che vengono aggiunte nuove funzionalità.

Assicurati inoltre che il file manifesto rimanga sotto i 512KB per evitare errori di compilazione. Valuta regolarmente il file durante il processo di compilazione di Xcode per individuare gli errori in anticipo. Una volta pronto il manifesto, integralo nel tuo progetto Capacitor seguendo le linee guida per la posizione dei file.

Aggiungere Manifesti di Privacy a Capacitor

Guida per la Posizione dei File

: Per includere un manifesto di privacy nel tuo progetto Capacitor, collocare il file nella seguente struttura di directory: PrivacyInfo.xcprivacy : Per i plugin __CAPGO_KEEP_0__, utilizza questa struttura:

your-app/
├── ios/
│   ├── App/
│   │   ├── PrivacyInfo.xcprivacy
│   │   └── Info.plist
│   └── App.xcworkspace

For Capacitor plugins, use this structure:

your-plugin/
├── ios/
│   ├── Plugin/
│   │   └── PrivacyInfo.xcprivacy
│   └── Plugin.xcodeproj

: Impostazioni di Configurazione di Compilazione

Una volta che il file è in posizione, aggiorna le impostazioni di compilazione di Xcode per assicurarsi che si integri correttamente:

Apri il tuo progetto in Xcode.
Sotto TARGETS, seleziona il tuo target di app o plugin.
Vai alla sezione Impostazioni di compilazione Imposta
Regione di sviluppo del manifesto di privacy a Imposta en.
Regione di sviluppo del manifesto di privacy Includi il manifesto sulla privacy per YES.

context: Pagina/Area: Pagina prodotti di aggiornamenti in tempo reale. Ruolo: Etichetta breve o elemento di navigazione. Chiave del messaggio `live_update_dynamic_label_to` (Etichetta dinamica di aggiornamento in tempo reale To). Se il tuo progetto utilizzaCocoaPods Podfile , includi il seguente snippet nel tuo

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
end

per abilitare il manifesto sulla privacy:

Dopo aver effettuato questi cambiamenti, procedi con i controlli di implementazione per verificare che tutto sia configurato correttamente.

Controllo di Implementazione

Per assicurarti che il manifesto sulla privacy funzioni come previsto, segui questi passaggi:
- Verifica della Costruzione
- Assicurati che non ci siano avvisi relativi alla privacy durante la costruzione. Assicurati che il manifesto si compili senza problemi.
- Verifica che il manifesto sulla privacy sia incluso nei prodotti di costruzione.
Validazione in esecuzione
- In modalità debug, testa il comportamento di accesso e le API sollecitazioni di privacy corrette.
Validazione App Store Connect
- Carica il tuo build e verifica il Rapporto sulla Privacy in App Store Connect.
- Assicurati che le dichiarazioni API siano complete e che i formati dei domini di tracciamento siano corretti.

Se incontri un errore di "validazione del manifesto sulla privacy fallita", controlla nuovamente il manifesto per assicurarti che soddisfi le ultime richieste di App Store. Presta particolare attenzione ai tipi API e alle configurazioni dei domini di tracciamento.

Modifiche del manifesto sulla privacy di Apple

Test e correzioni

Creare un manifesto sulla privacy che soddisfi le linee guida di Apple è fondamentale. Per rimanere su rotta, integra un tool di tracciamento degli errori affidabile nel tuo processo di sviluppo. Ciò aiuta a collegare gli sforzi di sviluppo alle richieste di conformità.

Un tool come Capgo Può aiutare. Monitora l'accesso a API e identifica le problematiche del manifesto prima che possano influire sugli utenti. Una volta che sono stati segnalati potenziali problemi, puoi concentrarti sulla validazione approfondita.

Dopo aver effettuato aggiornamenti, testa il manifesto in un ambiente di sviluppo. Utilizza le informazioni tratte dal tracking degli errori per guidare la tua revisione. Questo approccio aiuta a garantire che l'app rimanga allineata con gli standard di privacy di Apple.

Capgo Strumenti per la privacy

Capgo Dashboard di aggiornamento in tempo reale

Capgo semplifica la gestione dei manifesti di privacy e degli aggiornamenti dell'app, garantendo che i tuoi standard di privacy rimangano integri senza ritardare i rilasci.

Capgo Funzionalità

Con più di 23,5 milioni di aggiornamenti sicuri e un 82% di successo globale, Capgo ensures that 95% degli utenti attivi ricevono aggiornamenti entro 24 ore [1]. Ecco cosa offre:

crittografia end-to-end per mantenere gli aggiornamenti sicuri
il sistema dei canali per la distribuzione degli aggiornamenti controllata
la tracciatura degli errori per identificare e risolvere velocemente le problematiche
il rollback a un click per tornare immediatamente a una versione precedente

Questi strumenti rendono l'aggiunta di Capgo alla tua workflow facile e efficiente.

Usando Capgo

Per iniziare, installa il plugin Capgo con il seguente comando:

npx @capgo/cli init

Capgo integra in modo trasparente con i flussi di lavoro CI/CD, automatizzando la validazione del manifesto di privacy attraverso piattaforme come GitHub Actions, GitLab CI, o Jenkins. Scegliendo tra opzioni cloud o self-hosted, Capgo supporta 750 applicazioni in produzione mentre garantisce che ogni aggiornamento sia conforme ai requisiti di privacy.

“Pratichiamo lo sviluppo agile e @Capgo è essenziale per consegnare continuamente ai nostri utenti!” – Rodrigo Mantica

“Capgo è un modo intelligente per effettuare push di code caldi 🙂” – NASA’s OSIRIS-REx

Capgo include anche analisi integrate per monitorare i tassi di successo degli aggiornamenti e l'engagement degli utenti in tempo reale. Ciò garantisce che gli aggiornamenti sulla privacy raggiungano l'intera base utente mentre rimanendo conformi alle linee guida di Apple.

Conclusioni

Presempio chiave

Quando si tratta di gestire i manifesti di privacy, è fondamentale rimanere conformi e mantenere misure di sicurezza solide. Ecco cosa conta di più:

Chiarificazione end-to-endConserva gli aggiornamenti sicuri da inizio a fine.
Monitoraggio in tempo realeRileva la distribuzione degli aggiornamenti in modo efficace.
Capacità di rollback istantaneaFunge da rete di sicurezza per interventi rapidi.
Validazione automaticaAssicura che gli aggiornamenti soddisfino i requisiti di conformità.

Costruire un sistema di aggiornamento affidabile vi aiuta a mantenere il passo con le richieste di privacy in continua evoluzione di Apple e Google. Questa approccio è stato dimostrato per migliorare le percentuali di approvazione delle app store e rafforzare la fiducia degli utenti [1].

Come iniziare

Potete iniziare a implementare questi principi seguendo questi passaggi:

Configura il tuo ambiente: Esegui npx @capgo/cli init per iniziare.
Abilita le funzionalità di privacy: Utilizza la crittografia end-to-end per aggiornamenti sicuri.
Deploy strumenti di monitoraggio: Traccia gli aggiornamenti con l'analisi.
Prepara i rollback: Assicurati di poter ripristinare velocemente versioni precedenti se necessario.

“Capgo è uno strumento imprescindibile per gli sviluppatori che desiderano aumentare la produttività. Evitare i ritardi nella revisione dei bug è un vero cambiamento di gioco.” - Bessie Cooper

Aggiornamenti regolari e strumenti adeguati sono la chiave per mantenere la conformità e migliorare nel tempo.

Continua da Privacy Manifest per Capacitor App: Guida

Se stai utilizzando Privacy Manifest per Capacitor App: Guida per pianificare la sicurezza e la conformità, connettilo con Crittografia per il dettaglio di implementazione in Crittografia Conformità per il dettaglio di implementazione in Conformità Capgo Scanner di Sicurezza per il flusso di lavoro del prodotto in Capgo Scanner di Sicurezza Capgo Sicurezza per il flusso di lavoro del prodotto in Capgo Sicurezza, e Capgo Centro di fiducia per il flusso di lavoro del prodotto in Capgo Centro di fiducia.

Privacy Manifest for Capacitor Apps: Guide