---
title: AdMob
description: >-
  AdMob cocos guide for Custom Adapter GMA SDK.
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

import DocTagAdmobGam from '/snippets/doc-tag-admob-gam.mdx'

<Callout type="info">
**App Prerequisites**

* minSdkVersion of 26 or higher
* compileSdkVersion of 36 or higher
</Callout>

Ensure your `android/build.gradle` (project-level) includes the required repositories:

```
allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://jitpack.io' } 
    }
}
```

## Installation

#### Install Extension

1. Open your Cocos project
2. Go to the top menu: **Extension → Extension Manager**
3. Click on: **"Install from File"**

![](/images/cocos-extension-guide.png)

4. Select and upload the TapMind extension ZIP file\
   [Download TapMind Extension](https://github.com/tapmind-tech/TapMind-CA-Admob-Cocos/archive/refs/heads/main.zip)

##### Enable Extension (if it is disabled)

5. After installation, go to the **Installed** tab
6. Locate the **TapMind extension**
7. **Enable** it

<Callout type="info">
**Extension → Extension Manager → Install from File → Select TapMind Extension ZIP → Install → Installed Tab → Enable Extension**
</Callout>

---

## Configuration

<Callout type="info">
**Platform-specific values**
The steps below apply to **both Android and iOS**. When copying adapter class names or platform-specific parameters, use the **Android** or **iOS** tab for your build target.
</Callout>

**CREATING CUSTOM EVENTS FOR WATERFALL**

1. Under the **Mediation** tab : Click on **Create Mediation group** section
2. Select **Android** or **iOS** (depending on your target platform) and type of Ad format and Continue
3. In the Name field : Type in as provided in the **G-sheet**
4. Click on **Add ad units**
5. Select the app and the Ad units that you want to use custom targeting on.

<Callout type="info">
**Add Custom Event → Create Mediation Group → Select Android or iOS → Add Name → Add Ad units → Select app and Ad units**
</Callout>

**AD SOURCES (WATERFALL SECTION)**

1. Click on Water fall source
2. Click on Setup ad Source and then at the Bottom left Click on custom event
3. Select the App for the setup (Android or iOS, depending on your target platform)
4. Select ad unit and add the parameters as follows

For the Below details Please reach out TapMind Account Manger

<Tabs>
<Tab title="Android">

```
Mapping name : As Per the G-sheet Provided 
ecpm : As Per the G-sheet Provided
Class : com.tapmind.tech.TapMindMediationAdapterAdmob
Parameter : { "placementName": "As Per the G-sheet Provided"}
```

</Tab>
<Tab title="iOS">

```
Mapping name : As Per the G-sheet Provided 
ecpm : As Per the G-sheet Provided
Class : TapMindMediationAdapterAdmob
Parameter : { "placementName": "As Per the G-sheet Provided"}
```

</Tab>
</Tabs>

<Callout type="info">
**Ad Sources → Add Custom Event → Enter Label → Set eCPM → Add Mapping → Enter Mapping Name → Enter Class Name → Add Parameter**
</Callout>

<DocTagAdmobGam />

The above setup completes our **TapMind x ADMOB** integration. You should see an Ad if test setup is complete and working fine.

<Callout type="info">
Official Google Documentation for creating a custom event : [https://support.google.com/admob/answer/13407144](https://support.google.com/admob/answer/13407144)
</Callout>