アナリティクス データの収集と使用方法を構成する



このページでは、アナリティクス データの収集と使用を制御できる Google Analytics の機能について説明します。

Analytics によるデータ収集を無効にする

エンドユーザーの同意を得る、法的責任を満たす、などの理由で Analytics によるデータ収集を一時的または完全に無効にしなければならない場合があります。Google Analytics には、Analytics の収集を一時的または完全に無効にするための複数のオプションが用意されています。これらを組み合わせることで、さまざまなユースケースに対応できます。

収集を一時的に無効にする

データを収集する前にエンドユーザーの同意を得るためなど、Analytics によるデータ収集を一時的に無効にする必要がある場合は、アプリの Info.plist ファイルで、FIREBASE_ANALYTICS_COLLECTION_ENABLED の値を NO（ブール値）に設定します。たとえば、ソース XML で次のように設定します。

<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key><false/>

エンドユーザーが同意した後などに収集を再度有効にするには、Analytics の setAnalyticsCollectionEnabled インスタンス メソッドを呼び出します。次に例を示します。

Swift

注: この Firebase プロダクトは、macOS ターゲットでは使用できません。 
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

注: この Firebase プロダクトは、macOS ターゲットでは使用できません。 
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

なんらかの理由で収集を再び一時停止する必要がある場合は、次の対象を呼び出します。再び有効にするまで収集は一時停止されます。

Swift

注: この Firebase プロダクトは、macOS ターゲットでは使用できません。 
Analytics.setAnalyticsCollectionEnabled(false)

Objective-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);

setAnalyticsCollectionEnabled メソッドによって設定された値は、アプリの実行後も維持され、アプリの Info.plist ファイル内の FIREBASE_ANALYTICS_COLLECTION_ENABLED の値をオーバーライドします。setAnalyticsCollectionEnabled の値を設定すると、ユーザーがアプリを閉じて再度開いた場合でも、setAnalyticsCollectionEnabled が再び呼び出されるまでアナリティクスの収集の状態は変わりません。

収集を完全に無効にする

ご利用のアプリのバージョンでアナリティクスによるデータの収集を完全に無効にするには、アプリの Info.plist ファイルで FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED を YES（ブール値）に設定します。FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED を YES（ブール値）に設定すると、アプリの Info.plist 内の FIREBASE_ANALYTICS_COLLECTION_ENABLED の値や setAnalyticsCollectionEnabled で設定された値よりも、この設定が優先されます。

収集を再び有効にするには、Info.plist から FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED を削除します。FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED を NO（ブール値）に設定しても効果はなく、Info.plist ファイルで FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED が設定されていない場合と同じ動作になります。

IDFA の収集を無効にする

アプリの Podfile に pod 'Firebase/Analytics' を追加して CocoaPods から Firebase をインストールした場合、Apple アプリで IDFA（デバイスの広告識別子）の収集を無効にするには、AdSupport フレームワークがアプリに含まれていないことを確認してください。

IDFA 収集機能なしで Firebase をインストールするには、pod 'Firebase/Analytics' の代わりに次のサブスペックを使用します。

pod 'Firebase/AnalyticsWithoutAdIdSupport'

IDFA について詳しくは、Apple のドキュメントをご覧ください。

IDFV の収集を無効にする

Apple アプリで IDFV（ベンダの識別子）の収集を無効にするには、アプリの Info.plist ファイルで GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED の値を NO（ブール値）に設定します。

パーソナライズド広告のデータ収集を管理する

Google Analytics プロジェクトを広告アカウントにリンクしている、広告との連携を有効にしている、またはデータ共有を選択している場合は、パーソナライズド広告でアナリティクス データを使用できる可能性があります。たとえば、このようなデータをパーソナライズド広告に使用できないことを指定しない限り、first_open などの収集されたイベントを使用して、リマーケティング用のユーザーリストを作成し、デプロイできます。

ユーザーのアナリティクス データをパーソナライズド広告に使用するかどうかをプログラムで制御するには、次のいずれかのオプションを使用します。

ユーザー プロパティを使用してパーソナライズド広告機能を無効にする

パーソナライズド広告を有効または無効にするには、Google の同意モード API の使用をおすすめします。

ただし、アプリでまだ同意モードを使用していない場合は、次のオプションを使用してパーソナライズを管理できます。

パーソナライズド広告の動作をデフォルトで無効にするには、アプリの Info.plist ファイルで GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS の値を NO（ブール値）に設定します。

ユーザー プロパティを使用してパーソナライズド広告機能を再度有効にする

AnalyticsUserPropertyAllowAdPersonalizationSignals パラメータを使用して広告のパーソナライズを管理している場合は、次のように setUserProperty メソッドで広告のパーソナライズを再度有効にできます。

Swift

注: この Firebase プロダクトは、macOS ターゲットでは使用できません。 
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

Objective-C

注: この Firebase プロダクトは、macOS ターゲットでは使用できません。 
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

Unity

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, true);

アナリティクスの収集を一時的に（たとえば、エンドユーザーが同意するまで）無効にした後で、ユーザーのアナリティクス収集を再度有効にするときに、パーソナライズド広告機能を制御できるようにするには、この設定を指定する呼び出しを、アナリティクスの収集を再度有効にする呼び出しよりも前に配置します。次に例を示します。

Swift

注: この Firebase プロダクトは、macOS ターゲットでは使用できません。 
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

注: この Firebase プロダクトは、macOS ターゲットでは使用できません。 
[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Unity

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, ...);
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

設定を確認する

上記のいずれかの方法でユーザーに対して広告のパーソナライズ シグナルを無効にした場合は、それ以降にこのユーザーのデバイスからログに記録されるイベント バンドルに non_personalized_ads というユーザー プロパティが格納され、このバンドル内のイベントをパーソナライズド広告に使用できないことを示す値 1 が設定されます。パーソナライズド広告を無効にしても、レポートやアトリビューションなど、測定のためにデータを使用する場合には影響しません。

構成の変更を表示する

Google Analytics の設定を変更すると、SDK はその変更をダウンロードします。このプロセスは迅速かつシームレスに行われるため、変更を迅速にテストできます。Analytics で変更を行った場合は、アプリへのデプロイに数分かかることがあります。アプリが公開されている場合は、完全なデプロイ プロセスが完了するまでに最大で 1 時間かかることがあります。