Toy Tap Fever (Admob + GDPR + Android Studio)

Introduction

Toy Tap Fever is a popular game template developed by Google that showcases a simple yet engaging game mechanism. The game is a great example of how to implement AdMob, a popular mobile ad platform, and comply with General Data Protection Regulation (GDPR) in your Android app. In this tutorial, we will guide you through the process of setting up the Toy Tap Fever game template in Android Studio, integrating AdMob, and ensuring GDPR compliance.

Step 1: Setting up the Toy Tap Fever Game Template in Android Studio

1. First, you need to download the Toy Tap Fever game template from the Google repository. You can do this by navigating to the GitHub repository https://github.com/googlesamples/toy-tap-fever and clicking on the "Code" button to download the ZIP file.
2. Extract the downloaded ZIP file to a folder on your computer.
3. Open Android Studio and create a new project. Select "Empty Activity" and click "Next."
4. In the "Project name" field, enter a name for your project, such as "ToyTapFever."
5. In the "Package name" field, enter a package name for your project, such as "com.example.toyttapfever."
6. Click "Finish" to create the project.

Step 2: Configuring AdMob in Android Studio

1. Open the build.gradle file in the app directory and add the following lines to the dependencies section:

   dependencies {
   implementation 'com.google.android.gms:play-services-ads:20.0.0'
   implementation 'com.google.android.gms:play-services-ads-lite:20.0.0'
   }

2. Open the AndroidManifest.xml file and add the following lines to the <application> tag:

   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
   <meta-data android:name="com.google.android.gms.version" android:value="12100000" />

3. Open the activity_main.xml file and add the following lines to the <LinearLayout> tag:

   <com.google.android.gms.ads.AdView
   android:id="@+id/adView"
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"
   android:layout_centerHorizontal="true"
   android:layout_alignParentBottom="true"
   ads:adSize="BANNER"
   ads:adUnitId="YOUR_AD_UNIT_ID" />

   Replace YOUR_AD_UNIT_ID with your actual AdMob ad unit ID.

4. Open the MainActivity.java file and add the following code to the onCreate() method:

   
   import com.google.android.gms.ads.AdRequest;
   import com.google.android.gms.ads.AdView;

public class MainActivity extends AppCompatActivity { private AdView adView;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    adView = findViewById(R.id.adView);
    AdRequest adRequest = new AdRequest.Builder().build();
    adView.loadAd(adRequest);
}

}

5. Build and run the project to see the AdMob banner ad displayed in the app.

**Step 3: Implementing GDPR Compliance in Android Studio**

1. Open the `build.gradle` file and add the following lines to the dependencies section:
```groovy
dependencies {
    implementation 'com.google.android.gms:play-services-games:20.0.0'
}

1. Open the AndroidManifest.xml file and add the following lines to the <application> tag:

   <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
   <meta-data android:name="com.google.android.gms.games.APP_ID" android:value="YOUR_APP_ID" />

   Replace YOUR_APP_ID with your actual Google Developers Console app ID.

2. Open the MainActivity.java file and add the following code to the onCreate() method:

   
   import com.google.android.gms.games.Games;
   import com.google.android.gms.games.GamesActivityResultCodes;

public class MainActivity extends AppCompatActivity { private Games games;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    games = Games.getGamesClient(this);
    games.setShowInAppWarning(false);
}

}

4. Open the `strings.xml` file and add the following strings:
```xml
<resources>
    <string name="app_name">Toy Tap Fever</string>
    <string name="gdpr_purpose_statement">We use this information to provide the services and features of this app.</string>
    <string name="gdpr_request_access">Please request access to your location and game data.</string>
    <string name="gdpr_request_permission">Please grant permission to access your location and game data.</string>
    <string name="gdpr_dismiss">Disagree and continue without permissions</string>
    <string name="gdpr_allow">Allow</string>
    <string name="gdpr_deny">Deny</string>
</resources>

1. Open the gdpr_dialog.xml file and add the following code:

   <?xml version="1.0" encoding="utf-8"?>
   <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
   android:layout_width="match_parent"
   android:layout_height="wrap_content"
   android:orientation="vertical"
   android:padding="16dp">
   
   <TextView
       android:id="@+id/purpose_statement"
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       android:text="@string/gdpr_purpose_statement" />
   
   <TextView
       android:id="@+id/request_access"
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       android:text="@string/gdpr_request_access" />
   
   <Button
       android:id="@+id/allow"
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       android:text="@string/gdpr_allow" />
   
   <Button
       android:id="@+id/deny"
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       android:text="@string/gdpr_deny" />
   </LinearLayout>

2. Open the MainActivity.java file and add the following code to the onCreate() method:

   
   import android.os.Bundle;
   import android.view.View;
   import android.widget.Button;

public class MainActivity extends AppCompatActivity { private Dialog gdprDialog;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    //... (rest of the code remains the same)

    Button allowButton = findViewById(R.id.allow);
    Button denyButton = findViewById(R.id.deny);

    allowButton.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            games.requestLocationPermission();
        }
    });

    denyButton.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            Toast.makeText(MainActivity.this, "You have denied the permission.", Toast.LENGTH_SHORT).show();
        }
    });
}

}

7. Run the app and test the GDPR dialog. When you open the app, the GDPR dialog should appear. You can select "Allow" to grant permission to access your location and game data, or "Deny" to continue without permission.

That's it! You have successfully set up the Toy Tap Fever game template in Android Studio, integrated AdMob, and implemented GDPR compliance.