🤖Add Unique Link to your Android App

Here's how to bring the fun of our products to your Android app.

The integration process for your Unique Links for all Zop products is the same. To do so, you can either use Chrome Custom Tabs or you can directly open the Unique Link in the device's external browser.

Use Chrome Custom Tabs (CCT), and not Webviews

We strongly discourage using Android Webviews for opening your Unique Link. It is not recommended from a performance and monetisation point of view.

There are a few reasons we strongly recommend using CCT over the Android WebView:

• Better gaming experience / animations: HTML5 games require heavy-duty graphics rendering. CCT directly uses Chrome to run web content - allowing it to leverage the latest updates from Chrome all the time. In comparison, Android WebView (especially in older Android versions) has different release cycles and may often be running older versions of the Javascript rendering engine. This can cause the games running in Android WebView to lag - whereas the gaming experience is very smooth in a CCT implementation. This applies not just to games, but animations we use in several parts of Quizzop (such as spin wheel), and similarly in other Zop products as well.

• Better advertising revenues: Gamezop uses a mix of ad networks to show ads when users play games. This is the advertising revenue shared with you. Ad networks use cookies / browsing history other signals from the browser to show more relevant ads to users. Since CCT uses Chrome under the hood, when you open a Zop product in a CCT, it allows the ad networks we work with to access a much richer set of signals which can be used to show more relevant ads to users. This leads to better advertising revenue, meaning a higher share of revenue for you.

There are a whole host of other reasons to use CCT over WebView which you can read here.

Implementing Chrome Custom Tabs

Chrome Custom Tabs is a way to incorporate web content within your Android app. It allows you, as an app developer, to leverage the powerful rendering of Google Chrome for the web content running within your app.

Follow the steps given below closely to get a perfectly working CCT implementation in your app:

Note that we have explained the integration process using Gamezop Unique Links, but the process is the same for Quizzop / Newszop, and all other Zop products.

STEP 1: Update the build.gradle file

There are 2 build.gradle files in your app project. One in the root directory and the second build.gradle file is in the android/app/ folder of your project. You have to make an update in the android/app/build.gradle file. Within that file, within the dependencies block, include the following line:

implementation 'androidx.browser:browser:1.5.0'
implementation 'com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava'

1.5.0 is the latest CCT stable release at the time of writing. When you implement this, be sure to check for the latest stable release version here.

STEP 2: Initialise CCT in your onCreate method

You may have a particular Android Activity where you place the Gamezop icon / banner. When a user taps on that icon / banner, you want to open your Gamezop Unique Link within a CCT. Within the onCreate method of this Activity, you will have to define a click listener for that particular Gamezop icon / banner, which will trigger the CCT.

Kotlin

Here's a sample code block for how you an initialise CCT in your onCreate method:

override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val cctButton = findViewById<Button>(R.id.openGamezopButton)
        cctButton.setOnClickListener {
            val url = "https://1234.play.gamezop.com"; //BE SURE TO REPLACE THIS WITH YOUR GAMEZOP UNIQUE LINK
            val customTabsIntent: CustomTabsIntent  = CustomTabsIntent.Builder().build();
            customTabsIntent.launchUrl(this, Uri.parse(url));
        }
    }

Java

Here's a sample code block for how you an initialise CCT in your onCreate method:

override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        final cctButton = findViewById(R.id.openGamezopButton)
        cctButton.setOnClickListener {
            final url = "https://1234.play.gamezop.com"; //BE SURE TO REPLACE THIS WITH YOUR GAMEZOP UNIQUE LINK
            final CustomTabsIntent customTabsIntent  = CustomTabsIntent.Builder().build();
            customTabsIntent.launchUrl(this, Uri.parse(url));
        }
    }

STEP 3: Make the relevant XML changes

Within the res/layout/ folder, find the .xml file corresponding to the Activity within which you want to place the Gamezop icon / banner. You will have to write the XML for the Button / Image widget depending on how you want to place the Gamezop icon / banner within your UI. Ensure that the android:id attribute of that widget is set as android:id="@+id/openGamezopButton" That's all you need to do to be able to open Gamezop within your Android app in a CCT. Once again, please ensure that you use your Gamezop Unique Link instead of the sample in the code above. Here's a sample codebase with a working implementation that you can use as a reference.

Chrome Custom Tabs FAQs

Here are some FAQs around Chrome Custom Tabs:

What if the user does not have Chrome installed?

In this case, the URL that is supposed to open in the CCT will open in the user's device default browser.

Can the UI be customised in CCT?

Yes, to a certain degree. You can read more about it here.

Does Gamezop support TWA (Trusted Web Activity) integration?

Yes, we do. Contact your Gamezop Account Manager to place your package details in our assetlinks.json file.