同意設定を管理する（アプリ）

このページは、Firebase SDK 向け Google アナリティクスをアプリで使用し、同意モードを統合したいデベロッパーを対象としています。同意モードについては、同意モードの概要をご覧ください。

Google アナリティクスには、ユーザーの同意ステータスに基づいて SDK の動作を調整する「同意モード」が用意されています。利用可能なパラメータについては、同意タイプをご覧ください。

始める前に

ユーザーの同意を管理するには、次を実装する必要があります。

Firebase SDK 向け Google アナリティクス
ユーザーの同意を得るための同意設定バナー

ヒント: 同意設定を自分で実装したくない場合は、同意管理プラットフォーム（CMP）の使用を検討してください。

同意モードの設定

同意モードを設定するには、次を行う必要があります。

デフォルトの同意を確立する。
同意設定に対するユーザーインタラクションに基づき、同意ステータスを更新する。

同意モードの値はデフォルトでは設定されていません。デフォルトの同意ステータスをアプリに設定する方法は次のとおりです。

アプリの info.plist ファイルを開きます。
同意モードの Key-Value ペアを追加します。キーは同意タイプ、値は同意ステータスを示します。値は、同意が得られたことを意味する true か、同意が拒否されたことを意味する false のどちらでも指定できます。次のように設定してください。
- GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE
- GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE
- GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA
- GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS
変更内容を保存後、同意の値を更新するメカニズムを実装します。

たとえば、デフォルトですべてのパラメータに同意ステータスを付与する方法は次のとおりです。

<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>

アプリの起動後に同意ステータスの値を更新するには、setConsent メソッドを呼び出します。

setConsent メソッドで設定された値は、デフォルト設定をオーバーライドし、アプリの実行後も維持されます。この値は、ユーザーがアプリを閉じて再度開いても、setConsent が再び呼び出されるまでそのままとなります。setConsent では、指定したパラメータのみが更新されます。

ユーザーが以前アナリティクスまたは広告のストレージで同意した内容を取り消した場合は、Google アナリティクスで、ad personalization に関する同意ステータスを含むすべてのユーザープロパティが削除されます。ユーザーが広告のパーソナライズについて選択した同意内容を維持するには、setConsent の（Swift | Obj-C）、を使用して広告のパーソナライズの以前の値を復元します。

setConsent メソッドを使って異なる同意ステータスの値を granted に更新する例を次に示します。

Swift

Analytics.setConsent([
  .analyticsStorage: .granted,
  .adStorage: .granted,
  .adUserData: .granted,
  .adPersonalization: .granted,
])

Objective-C

[FIRAnalytics setConsent:@{
FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
FIRConsentTypeAdStorage : FIRConsentStatusGranted,
FIRConsentTypeAdUserData : FIRConsentStatusGranted,
FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];

Google は、プライバシーに配慮したデジタル広告エコシステムへの継続的な取り組みの一環として、EU ユーザーの同意ポリシーの適用を強化しています。

同意モードをお使いの場合は、広告およびアナリティクスへのデータ保存に加え、2 つの新しいパラメータを送信する必要があります。

アプリの info.plist に次が含まれるように更新します。

<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>

広告ユーザーのデータおよび広告のパーソナライズのパラメータが含まれるように、同意の呼び出しを更新します。

Swift

Analytics.setConsent([
  .analyticsStorage: .granted,
  .adStorage: .granted,
  .adUserData: .granted,
  .adPersonalization: .granted,
])

Objective-C

[FIRAnalytics setConsent:@{
  FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdUserData : FIRConsentStatusGranted,
  FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];

同意設定の検証

同意設定が意図どおり機能しているかどうかは、アプリの Xcode デバッグコンソールで検証できます。

手順は次のとおりです。

使用デバイスで詳細ログを有効化します。
Xcode デバッグコンソールで、次を探します。
- ad_storage
- analytics_storage
- ad_user_data
- ad_personalization
たとえば、広告のストレージが有効になっている場合、次のようなメッセージが表示されます。
```
ad_storage is granted.
```

同意設定を管理する（アプリ）

始める前に

同意モードの設定

ステップ 1: デフォルトの同意状況を設定する

ステップ 2: 同意状況を更新する

Swift

Objective-C

同意モード v2 にアップグレードする

Swift

Objective-C

同意設定の検証