Capacitor アプリ用プライバシーマニフェスト: ガイド

Capacitorアプリを Capacitor App Store 遅れなくプライバシーマニフェストを作成してください。 プライバシーマニフェストとは

アプリのデータ収集の仕組み、__CAPGO_KEEP_0__の使用、トラッキングドメインを記載した構造化されたファイルです。
A structured file outlining your app’s data collection practices, API usage, and tracking domains.
App Storeの規則に準拠し、再提出や削除を回避することができます。
- ユーザーのデータ管理について透明性を保ち、信頼を築くことができます。
- 含めるべき主な要素
Key components to include:
- APIがユーザーデータにアクセスする場合（例：位置、写真）。
- 収集されたデータの種類に対するプライバシーラベル。
- 分析や広告のために使用されるトラッキングドメイン。
作成方法:
- JSONを使用してデータ収集の詳細を定義する。
- ファイルをプロジェクトの正しいディレクトリに置く。 PrivacyInfo.xcprivacy エラーを避けるためにツールのようなXcodeを使用して検証する。
- 作業を簡素化するツール: プラットフォームのような __CAPGO_KEEP_0__
__CAPGO_KEEP_1__
__CAPGO_KEEP_2__ Capgo 自動化されたプライバシーマニフェストの検証、リアルタイムの更新、およびエラーのトラッキングのために。manifestがトラッキングまたは分析のSDKを宣言する場合、 @capgo/capacitor-app-tracking-transparency iOS ATTのポップアップを処理する @capgo/capacitor-firebase-analytics App Storeのレビュー用にFirebaseのデータ収集を記録する

アプリの遅延を避け、ユーザーのプライバシーを保護し、App Storeの規制に準拠するために、このガイドを参照してください。

プライバシーマニフェストの基本

プライバシーマニフェストの定義

プライバシーマニフェストとは、ユーザーのデータの取り扱いに関するアプリのデータの実践を記述した構造化されたファイルです。APIがユーザーデータにアクセスすること、トラッキングドメイン、収集されたデータの種類、第三者SDKの統合などを詳細に記述します。この文書は、信頼性を確立するだけでなく、App Storeの規制に準拠することも役立ちます。ここでは、manifestに含めるべき主な要素を解説します。

プライバシーマニフェストの主な要素

ここでは、Appleの要件に準拠するためにmanifestに含めるべき主な要素を紹介します。

必要な理由API
このセクションでは、プライバシーに影響を与えるAPIをリストし、その必要性を説明します。

以下は、一般的なAPI要件の表です。

API カテゴリー	一般的な使用方法	必要なドキュメント
位置情報サービス	ユーザーがナビゲートする	目的の文字列と使用方法の説明
写真ライブラリ	プロフィール写真	アクセス許可と意図
連絡先	アドレス帳の同期	データ最小化声明

プライバシーラベル
これらのラベルは、以下の情報を明確に示します。
- 収集されるデータの種類
- データ収集の理由
- ユーザーIDと関連付けられているデータ
- データがトラッキングに使用されている方法
トラッキングドメイン
このセクションには、分析、広告、または第三者データ処理に使用されるドメインがすべてリストされています。

「App Storeに準拠する」 - Capgo [1]

Capgo [1]95%のユーザーが24時間以内にアップデートに従う

アップデートを24時間以内に従う95%のユーザー Capacitor

Capacitor Framework Documentation Website

__CAPGO_KEEP_0__

95%のユーザーが24時間以内にアップデートに従う

__CAPGO_KEEP_0__
A Capacitor 8.0+ project set up
Capacitor Info.plist Capacitor
Capacitor Framework Documentation Website
アプリのデータ収集実践に関するドキュメント

作成手順

まず、iOS プロジェクトディレクトリ内に PrivacyInfo.xcprivacy ファイルを作成します。このファイルは、特定のフォーマットガイドラインに従う必要があります:

基本情報の設定

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

データ収集の詳細の定義

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

トラッキングドメインの追加

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

よくあるミスの回避

問題を防ぐには、次のポイントを考慮してください:

すべての必要なフィールドを含めるフィールドが空でも、必ず存在する必要があります。
有効なAPIタイプを使用する: Appleの公式ドキュメントで API を確認してください。
JSONのフォーマットを確認してください。: JSONの構造をチェックするためにJSONリントを実行してください。
: __CAPGO_KEEP_0__ にアクセスするたびに、対応する __CAPGO_KEEP_1__ の理由を確認してください。: Make sure every API access includes a corresponding reason code.
: manifestファイルは512KB未満でなければなりません。Xcodeのビルドプロセス中にファイルを定期的に検証して、ミスを早期に発見してください。manifestが準備できたら、__CAPGO_KEEP_0__ プロジェクトに統合するために、ファイルの配置ガイドラインに従ってください。Capacitorアプリにプライバシーマニフェストを追加する

Also, ensure the manifest file stays under 512KB to avoid build errors. Regularly validate the file during Xcode’s build process to catch mistakes early. Once your manifest is ready, integrate it into your Capacitor project by following the file placement guidelines.

Adding Privacy Manifests to Capacitor

Capacitorプロジェクトにプライバシーマニフェストを含めるには、以下のディレクトリ構造にファイルを配置してください:

To include a privacy manifest in your Capacitor project, place the PrivacyInfo.xcprivacy Capacitorプロジェクトにプライバシーマニフェストを含めるには、以下のディレクトリ構造にファイルを配置してください:

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

For Capacitor plugins, use this structure:

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

ビルド設定の設定

ファイルが置かれたら、Xcodeのビルド設定を更新して適切に統合するようにしてください:

Xcodeでプロジェクトを開いてください。
以下の項目の下に TARGETSを選択してください。
以下の項目の下に ビルド設定 を選択してください。
以下の項目を設定してください。 プライバシーマニフェスト開発地域 に en.
設定 プライバシーマニフェストを含める に YES.

あなたのプロジェクトが CocoaPodsを使用している場合 Podfile 以下のスニペットを追加して

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

プライバシーマニフェストを有効にする

これらの変更を実施した後、実装チェックを実行して、すべてが正しく設定されていることを確認する

実装チェック

プライバシーマニフェストが正しく機能していることを確認するには、以下の手順に従う
- 確認ビルド中にプライバシー関連の警告が表示されないことを確認する。
- マニフェストが正常にコンパイルされることを確認する。
- ビルド製品にプライバシーマニフェストが含まれていることを確認する。
実行時検証
- デバッグモードで、適切なプライバシーポップアップと API アクセス動作が正しく機能していることを確認する。
App Store Connect 検証
- ビルドをアップロードし、App Store Connect でプライバシーレポートを確認する。
- API 宣言が完全で、トラッキングドメインの形式が正しいことを確認する。

「プライバシーマニフェスト検証に失敗しました」というエラーが発生した場合、マニフェストが最新の App Store 要件を満たしていることを確認する。特に API の種類とトラッキングドメインの構成に注意する。

Apple プライバシーマニフェストの変更

テストと修正

Appleのガイドラインに沿ったプライバシーマニフェストを作成することは重要です。開発プロセスに信頼できるエラートラッキングを組み込むことで、開発努力と合致性要件を関連付けることができます。

A tool like Capgo can help. It monitors API access and identifies manifest issues before they affect users. Once potential problems are flagged, you can shift your focus to thorough validation.

Capacitor

Capgo アップデートを実施した後、開発環境でマニフェストをテストしてください。エラートラッキングから得た洞察を、レビューに導くことで、開発プロセスを効率化できます。このアプローチにより、Appleのプライバシースタンダードに沿ったアプリを保証できます。

Capgo Live Update Dashboard Interface

Capgo simplifies managing privacy manifests and app updates, ensuring your privacy standards stay intact without delaying deployments.

Capgo Features

Live Update Dashboard Interface Capacitorは、プライバシーマニフェストとアプリのアップデートの管理を簡素化し、プライバシースタンダードを維持しながら、デプロイメントの遅延を防ぎます。と 82%のグローバル成功率, Capgoは 95%のアクティブユーザーが24時間以内にアップデートを受け取ることを保証します [1]. 以下の機能が含まれます:

エンドツーエンド暗号化 アップデートをセキュアに保つ
チャンネルシステム アップデートの制御された配布
エラー追跡 問題を迅速に特定して対処する
1クリックロールバック バージョンを直ちに前のバージョンに戻すことができます。

これらのツールは、Capgo をワークフローに追加するプロセスをスMOOTH にし、効率的にします。

Capgo を使用する

始めるには Capgo プラグインをインストールするこのコマンドを実行します:

npx @capgo/cli init

Capgo はCI/CD Pipelinesと完全に統合され、Capgo Actions、GitLab CI、Jenkinsなどのプラットフォームを通じてプライバシーマニフェストの検証を自動化します。 GitHub Actions, Jenkins、どちらのオプションを選択するかは関係なく、__CAPGO_KEEP_0__ は750のプロダクションアプリケーションをサポートし、プライバシー基準に準拠した更新を保証します。 __CAPGO_KEEP_0__Capgo

「「Agile開発」で、@Capgoはユーザーに継続的に提供するmission-criticalです！」 – Rodrigo Mantica

「Capgoは、ホットcodeプッシュをスマートに作る方法です 🙂」 – NASAのOSIRIS-REx

Capgoには、実時間でアップデートの成功率とユーザーのエンゲージメントを監視するための組み込み分析機能が含まれています。この機能により、Appleのガイドラインに準拠しながら、プライバシー更新がユーザーの全体のユーザー基盤に到達することが保証されます。

まとめ

重要なポイント

プライバシーマニフェストの管理において、コンプライアンスと強固なセキュリティ対策を維持することは至急のことです。ここでは、最も重要な点をまとめます:

エンドツーヘンド暗号化: 最初から最後まで、更新を安全に保証します。
リアルタイムモニタリング: 更新の配布を効果的に追跡します。
インスタントロールバック: 急いで修正するための安全なネットワークを提供します。
自動検証: アップデートが規制基準を満たしていることを確認します。

信頼性のあるアップデートシステムを構築することは、Apple と Google のプライバシー要件の進化に追随するのに役立ちます。このアプローチは、アプリストアの承認率の向上とユーザーの信頼性の強化に効果があります。 [1].

始める方法

これらの原則を実装するには、以下の手順に従ってください。

環境の設定: npx @capgo/cli init を実行して始めましょう。
プライバシー機能の有効化: 安全なアップデートのためにエンドツーエンド暗号化を使用します。
監視ツールのデプロイ: アップデートのトラッキングにアナリティクスを使用します。
バックアップ計画: 必要に応じて以前のバージョンに迅速に戻ることができるようにしてください。

“Capgoは、開発者が生産性を向上させるために必要なツールです。バグ修正のためのレビュー遅延を避けることは、ゲームチェンジャーです。” - Bessie Cooper

定期的な更新と適切なツールは、適合性を維持し、時間の経過とともに改善するための鍵です。

Privacy Manifest for Capacitor Apps: Guideから続きます。

Capacitorアプリを使用している場合 Privacy Manifest for Capacitor Apps: Guide セキュリティと適合性を計画するために使用している場合 __CAPGO_KEEP_0__ 暗号化暗号化の実装詳細適合性管理 Capgo セキュリティスキャナー Capgo セキュリティスキャナーの製品ワークフロー向け Capgo セキュリティ Capgo セキュリティの製品ワークフロー向け Capgo トラストセンター Capgo トラストセンターの製品ワークフロー向け

Privacy Manifest for Capacitor Apps: Guide