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



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

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

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

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

データを収集する前にエンドユーザーの同意を得るためなど、Analytics によるデータ収集を一時的に無効にする必要がある場合は、アプリの AndroidManifest.xml の application タグで、firebase_analytics_collection_enabled の値を false に設定します。次に例を示します。

<meta-data android:name="firebase_analytics_collection_enabled" android:value="false" />

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

KotlinJavaUnity
setAnalyticsCollectionEnabled(true);

setAnalyticsCollectionEnabled(true);

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

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

KotlinJavaUnity
setAnalyticsCollectionEnabled(false);

setAnalyticsCollectionEnabled(false);

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);

収集を完全に無効にする

ご利用のアプリのバージョンで Analytics によるデータ収集を完全に無効にする必要がある場合は、アプリの AndroidManifest.xml の application タグ内で firebase_analytics_collection_deactivated を true に設定します。次に例を示します。

<meta-data android:name="firebase_analytics_collection_deactivated" android:value="true" />

広告 ID の収集を無効にする

Android アプリで広告 ID の収集を無効にするには、アプリの AndroidManifest.xml の application タグ内で google_analytics_adid_collection_enabled の値を false に設定します。次に例を示します。

<meta-data android:name="google_analytics_adid_collection_enabled" android:value="false" />

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

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

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

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

Google の同意モード API

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

パーソナライズド広告の動作をデフォルトで無効にするには、application タグ内でアプリの AndroidManifest.xml の次のフィールドを指定します。

<meta-data android:name="google_analytics_default_allow_ad_personalization_signals" android:value="false" />

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

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

KotlinJavaUnity
setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, "true" );

setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, "true" );

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

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

KotlinJavaUnity
setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, … );
setAnalyticsCollectionEnabled(true);

setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, … );
setAnalyticsCollectionEnabled(true);

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

設定を確認する

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

構成の変更を表示する

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