Loading [MathJax]/extensions/tex2jax.js

2022年9月11日日曜日

Android アプリ AdMob GDPR 同意メッセージ

やりたいこと
GDPRに対応したメッセージをアプリの起動時に表示させることができたので、
その方法をメモしておきます。



背景
ここはよみとばして大丈夫です。

詳しいことは忘れてしまったのですが、admobかgoogleからGDPRに対応してねというメールかなにか来たか、
PlayConsoleかAdmobの管理画面でそういう通知がきてたかだったと思います。

過去の通知とかを漁ったのですがどれがそれなのかよくわかりませんでした。

ざっくり言うと、Admobを使っていて、EUを販売対象としている場合は、メッセージをだして同意を求める必要があるというものになります。

Admob > プライバシーとメッセージ > GDPR > 設定ボタン　を押すと表示される画面にそういう内容が書いてあります。


(引用元 : Google Admobの管理画面)
ということで、やっとそのメッセージが表示できるようになったので、
やりかたをメモしておきます。

環境
Win11 21h2
Android Studio 2021.2.1 Patch 2
admobの広告は設定済み
参考にしたサイト
Admobのサイト
https://developers.google.com/admob/ump/android/quick-start

こちらを主に参考にしました。

デバイスIDの調べ方
https://www.howtodroid.com/how-to-find-hashed-device-id-for-admob.html
 
ざっくりいうと
ざっくりいうと、Admobのページでメッセージを出す設定に変更して、
その後にプログラムを修正する。という流れになります。

Step.1
最初にAdmobのサイトで設定をしておきます。
Admobのページにログインし、プライバシーメッセージに遷移します。
GDPRをクリック(たしか設定ボタンだったかも。)


GDPRを使ってみるの画面に遷移するので、続行をクリックする。

3ステップでGDPRメッセージを作成の画面に遷移するので、
GCPRメッセージを作成ボタンをクリックする。


次の画面でプライバシーポリシーのURLを設定する必要があります。
プライバシーポリシーは前回つくったので、そちらをURLをいれました。
(まったく自身がないプライバシーポリシーですが。)

次に言語と、表示するメッセージを選択する画面に遷移するので、
設定します。

確定するとメッセージのプレビュー画面に遷移するので、公開ボタンをクリックしてStep1は完了です。







Step.2
ここからはコードの方の話になります。
参考サイトのWebページに従って実装していきます。

まずは、*.appの方のBuild Gradleに以下の最終行を追加します。

view plainprint?
  1. dependencies {  
  2.   
  3.     implementation 'androidx.appcompat:appcompat:1.4.1'  
  4.     implementation 'com.google.android.material:material:1.5.0'  
  5.     implementation 'androidx.constraintlayout:constraintlayout:2.1.3'  
  6.     implementation 'androidx.navigation:navigation-fragment:2.4.1'  
  7.     implementation 'androidx.navigation:navigation-ui:2.4.1'  
  8.     implementation 'androidx.preference:preference:1.1.1'  
  9.     testImplementation 'junit:junit:4.13.2'  
  10.     androidTestImplementation 'androidx.test.ext:junit:1.1.3'  
  11.     androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'  
  12.   
  13.     // for admob  
  14.     implementation 'com.google.android.gms:play-services-ads:21.0.0'  
  15.   
  16.     // for EU  
  17.     implementation 'com.google.android.ump:user-messaging-platform:2.0.0'  
  18. }  
Step.3
AndroidManifest.xmlに広告IDを記載します。
 (テスト用でなくて本物の方じゃないとだめか？)



Step.4
MainActivityにメンバ変数を二つ追加。下の2行です。
view plainprint?
  1. public class MainActivity extends AppCompatActivity {  
  2.   
  3.     private AppBarConfiguration appBarConfiguration;  
  4.     private ActivityMainBinding binding;  
  5.   
  6.     // for EU ①  
  7.     private ConsentInformation consentInformation;  
  8.     private ConsentForm consentForm;  
Step.5
MainActivityのonCreate()メソッドに、14行目以降を追加します。
for EU for DEBUG 以下を全部追加します。

view plainprint?
  1.     @Override  
  2.     protected void onCreate(Bundle savedInstanceState) {  
  3.         super.onCreate(savedInstanceState);  
  4.   
  5.         binding = ActivityMainBinding.inflate(getLayoutInflater());  
  6.         setContentView(binding.getRoot());  
  7.   
  8.         setSupportActionBar(Objects.requireNonNull(binding.toolbar));  
  9.   
  10.         NavController navController = Navigation.findNavController(this, R.id.nav_host_fragment_content_main);  
  11.         appBarConfiguration = new AppBarConfiguration.Builder(navController.getGraph()).build();  
  12.         NavigationUI.setupActionBarWithNavController(this, navController, appBarConfiguration);  
  13.   
  14.         // for EU for DEBUG  
  15. //        ConsentDebugSettings debugSettings = new ConsentDebugSettings.Builder(this)  
  16. //                .setDebugGeography(ConsentDebugSettings  
  17. //                        .DebugGeography  
  18. //                        .DEBUG_GEOGRAPHY_EEA)  
  19. //                .addTestDeviceHashedId("XXXXXXXXXXXXXXXXXXXXXXXXXXXXX")  
  20. //                .build();  
  21.   
  22.   
  23.         // for EU　②  
  24.         // Set tag for underage of consent. Here false means users are not underage.  
  25.         ConsentRequestParameters params = new ConsentRequestParameters  
  26.                 .Builder()  
  27.                 // for EU for DEBUG  
  28.                 //.setConsentDebugSettings(debugSettings)   // for DEBUG  
  29.                 .setTagForUnderAgeOfConsent(false)  
  30.                 .build();  
  31.   
  32.         consentInformation = UserMessagingPlatform.getConsentInformation(this);  
  33.   
  34.         // for EU for DEBUG  
  35.         //consentInformation.reset();  
  36.   
  37.         consentInformation.requestConsentInfoUpdate(  
  38.                 this,  
  39.                 params,  
  40.                 new ConsentInformation.OnConsentInfoUpdateSuccessListener() {  
  41.                     @Override  
  42.                     public void onConsentInfoUpdateSuccess() {  
  43.                         // The consent information state was updated.  
  44.                         // You are now ready to check if a form is available.  
  45.                         if (consentInformation.isConsentFormAvailable()) {  
  46.                             loadForm();  
  47.                         }  
  48.                     }  
  49.                 },  
  50.                 new ConsentInformation.OnConsentInfoUpdateFailureListener() {  
  51.                     @Override  
  52.                     public void onConsentInfoUpdateFailure(FormError formError) {  
  53.                         // Handle the error.  
  54.                         Log.d("error", "error_ConsentInfoUpdateFailure");  
  55.                     }  
  56.                 });  
  57.   
  58.     }  
Step.6
MainActivity に　loadForm()を追加する。
view plainprint?
  1. public void loadForm() {  
  2.     UserMessagingPlatform.loadConsentForm(  
  3.             this, new UserMessagingPlatform.OnConsentFormLoadSuccessListener() {  
  4.                 @Override  
  5.                 public void onConsentFormLoadSuccess(ConsentForm consentForm) {  
  6.                     MainActivity.this.consentForm = consentForm;  
  7.                     if (consentInformation.getConsentStatus() == ConsentInformation.ConsentStatus.REQUIRED) {  
  8.                         consentForm.show(  
  9.                                 MainActivity.this,  
  10.                                 new ConsentForm.OnConsentFormDismissedListener() {  
  11.                                     @Override  
  12.                                     public void onConsentFormDismissed(@Nullable FormError formError) {  
  13.                                         // Handle dismissal by reloading form.  
  14.                                         loadForm();  
  15.                                     }  
  16.                                 });  
  17.                     }  
  18.                 }  
  19.             },  
  20.             new UserMessagingPlatform.OnConsentFormLoadFailureListener() {  
  21.                 @Override  
  22.                 public void onConsentFormLoadFailure(FormError formError) {  
  23.                     // Handle the error.  
  24.                     Log.d("error", "error_ConsentFormLoadFailure");  
  25.                 }  
  26.             });  
  27. }  
Step.7 テストの準備
これだと、日本では、メッセージが表示されないので、強制的に地域をEUに変更するテストコードを追加します。

テストコードを追加するまえに、テストするデバイスのデバイスハッシュIDというのが必要になるので、まずはそれを調べます。

デバッグ対象のデバイス( emulatorとか )でアプリを実行します。

Logcat Windowで、「addtestdevice」で検索すると、ハッシュIDが表示されるので、どこかにメモっておきます。




Step.8 テスト
それでは、先ほどの強制的に地域をEUに変更するコードを追加するのですが、
実はStep5ですでに追加はしてあって、コメントアウトしているので、それを生かします。

3か所あります。

1個目が、Step5のコードの14行目の「for EU for DEBUG」とコメントがあるこの部分です。
view plainprint?
  1. // for EU for DEBUG  
  2. ConsentDebugSettings debugSettings = new ConsentDebugSettings.Builder(this)  
  3.         .setDebugGeography(ConsentDebugSettings  
  4.                 .DebugGeography  
  5.                 .DEBUG_GEOGRAPHY_EEA)  
  6.         .addTestDeviceHashedId("XXXXXXXXXXXXXXXXXXXXXXXXXXXXX")  
  7.         .build();  
XXXにはStep7で調べたハッシュIDを入れます。

2個目がStep5のコードの27行目のコメント部分を生かします。
view plainprint?
  1. // for EU for DEBUG  
  2.       //.setConsentDebugSettings(debugSettings)   // for DEBUG  
3個目がStep5のコードの34行目のコメント部分を生かします。
これはユーザーが同意のメッセージを選択したことをリセットする処理になります。
// for EU for DEBUG
とコメントがあるこちらです。
view plainprint?
  1. // for EU for DEBUG  
  2. //consentInformation.reset();  
おわり
これで実行すると、同意のメッセージが表示されます。
たぶんされるはず。

まとめ
Andorid アプリで　GDPRの同意メッセージを表示する方法について記載いたしました。
最初にAdmobの設定で同意メッセージを表示するという設定を行い、
次に、コードを変更して同意メッセージを表示するコードを記載しました。

また、テストのために地域を変更する方法と、同意した内容をリセットする方法を記載しました。

これで一応メッセージが表示できるようになったのですが、これが正解なのかどうかがいまいち自身はないです。

苦労した点
①Step1をするということがわからず、コードだけ直して、いくらやってもメッセージがでてこないので、
そこに気づくのにとても時間をかけてしまいました。
<
時刻: 0 件のコメント:
登録: 投稿 (Atom)