# Custom Adapter Integration
This document will guide you through an easy-to-follow process of adding Adster.Tech as your third-party ad network mediation partner for Android, iOS and Unity.
AndroidiOSUnity - AndroidUnity - iOS
# Android
This document will guide you through an easy-to-follow process of adding Adster.Tech as your third-party ad network mediation partner for your mobile banner, interstitial, and rewarded ads.
{% hint style="info" %}
**App Prerequisite**
* minSdkVersion of 21 or higher
* compileSdkVersion of 33 or higher
{% endhint %}
## Configuration Steps
#### **Adding Dependency**
{% tabs %}
{% tab title="Android" %}
* Open the `build.gradle` (Module: app) file.
* Find the dependencies block and add from below for respective mediation platform.
* Add the below proguard rule in the final release build \
-keep class com.adster.\*\* { \*; }
{% endtab %}
{% endtabs %}
Google Ad Manager
```
dependencies {
implementation 'com.adstertech:customadapter-lite:2.8.0'
}
```
ADMOB
```gradle
dependencies {
implementation 'com.adstertech:customadapter-lite:2.8.0'
}
```
AppLovin
```gradle
dependencies {
implementation 'com.adstertech:customadapter-applovin:2.7.0'
}
```
Ironsource
```gradle
dependencies {
implementation 'com.adstertech:customadapter-ironsource:2.2.3'
}
```
# Google Ad manager
The process involves integrating Adster.tech within your Google Ad Manager account and adding Adster.tech Bidder inside your mobile application.
**PREREQUISITES**
* An Ad Unit must already be in place which will be used for targeting.
**GOOGLE AD MANAGER CONFIGURATION**
Please go through the below steps to integrate **ADSTER.TECH** as a demand partner with your **GAM** account. To begin with the integration, login to your **GAM** account and follow the below steps.
1. Under the **Admin** header : Click on the **Companies** section
2. Click on the **New Company** button : Select **Ad Network**
3. In the Name field : Type In **ADSTER.TECH**
4. In the **Ad Network** field : Select **Other Company**
5. Toggle **Mediation** to **ON**
6. Click on **Save**
# Banner
This is guide to set up ADSTER.TECH with Google Ad Manager using Yield Groups and Yield Partners for Banner Ads.
**CREATING YIELD GROUP AND YIELD PARTNER**
{% hint style="info" %}
For adding **ADSTER.TECH** under existing yield groups, skip the steps for creating a new yield group, navigate to your existing yield group and follow the steps for **Adding Yield Partner** as\
described in the next section
{% endhint %}
1. Under the “**Delivery**” tab : Click on “**Yield Groups**” section
2. Click on “**New Yield Group**” to create a new yield group
3. In the Name field : Type in “**ADSTER.TECH Banner**”
4. Ad Format : **Banner**
5. Inventory Type : **Mobile**
6. Under Targeting : Select the Ad Units which "**ADSTER.TECH**" will target
7. Scroll to the bottom
**ADDING YIELD PARTNER**
1. Click on “**Add Yield Partner**”
2. Select “**ADSTER.TECH**” from the list
3. Integration Type: **Custom Event**
4. Platform: **Android**
5. Status: **Active**
6. Default CPM: 10 (in USD, this is a test setup pricing to ensure Ads from Adster adapter always comes)
7. Select/Check “**Override Dynamic CPM**”
8. Label: "**Adster\_Banner\_300x250\_10"**
9. Class Name: `com.adster.ads.mediation.adapter.AdSterMediationAdapter`
10. Parameter : Pass the **tag name** provided by the Account Manager
```json
Example:
{
"placement_id": "adster_banner_300x250",
"yield_group_bid_price_range": "10.0-10.0"
}
```
11. Click on “**Save**” and save the configuration.
12. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x GAM** integration for **Banner Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a Yield Group :\
{% endhint %}
# Interstitial
This is guide to set up ADSTER.TECH with Google Ad Manager using Yield Groups and Yield Partners for Interstitial Ads.
**CREATING YIELD GROUP AND YIELD PARTNER**
{% hint style="info" %}
For adding **ADSTER.TECH** under existing yield groups, skip the steps for creating a new yield group, navigate to your existing yield group and follow the steps for **Adding Yield Partner** as\
described in the next section
{% endhint %}
1. Under the “**Delivery**” tab : Click on “**Yield Groups**” section
2. Click on “**New Yield Group**” to create a new yield group
3. In the Name field : Type in “**ADSTER.TECH Interstitial**”
4. Ad Format : **Interstitial**
5. Inventory Type : **Mobile**
6. Under Targeting : Select the Ad Units which "**ADSTER.TECH**" will target
7. Scroll to the bottom
**ADDING YIELD PARTNER**
1. Click on “**Add Yield Partner**”
2. Select “**ADSTER.TECH**” from the list
3. Integration Type: **Custom Event**
4. Platform: **Android**
5. Status: **Active**
6. Default CPM: 10 (in USD, this is a test setup pricing to ensure Ads from Adster adapter always comes)
7. Select/Check “**Override Dynamic CPM**”
8. Label: "**Adster\_Interstitial\_10"**
9. Class Name : `com.adster.ads.mediation.adapter.AdSterMediationAdapter`
10. Parameter : Pass the **tag name** provided by the Account Manager
```json
Example:
{
"placement_id": "adster_interstitial_test",
"yield_group_bid_price_range": "10.0-10.0"
}
```
11. Click on “**Save**” and save the configuration.
12. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x GAM** integration for **Interstitial Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a Yield Group :\
{% endhint %}
# Rewarded
This is guide to set up ADSTER.TECH with Google Ad Manager using Yield Groups and Yield Partners for Rewarded Ads.
**CREATING YIELD GROUP AND YIELD PARTNER**
{% hint style="info" %}
For adding **ADSTER.TECH** under existing yield groups, skip the steps for creating a new yield group, navigate to your existing yield group and follow the steps for **Adding Yield Partner** as\
described in the next section
{% endhint %}
1. Under the “**Delivery**” tab : Click on “**Yield Groups**” section
2. Click on “**New Yield Group**” to create a new yield group
3. In the Name field : Type in “**ADSTER.TECH Rewarded**”
4. Ad Format : **Rewarded**
5. Inventory Type : **Mobile**
6. Under Targeting : Select the Ad Units which "**ADSTER.TECH**" will target
7. Scroll to the bottom
**ADDING YIELD PARTNER**
1. Click on “**Add Yield Partner**”
2. Select “**ADSTER.TECH**” from the list
3. Integration Type: **Custom Event**
4. Platform: **Android**
5. Status: **Active**
6. Default CPM: 10 (in USD, this is a test setup pricing to ensure Ads from Adster adapter always comes)
7. Select/Check “**Override Dynamic CPM**”
8. Label: "**Adster\_Rewarded\_10"**
9. Class Name : `com.adster.ads.mediation.adapter.AdSterMediationAdapter`
10. Parameter: Pass the **tag name** provided by the Account Manager
```json
Example:
{
"placement_id": "adster_rewarded_test",
"yield_group_bid_price_range": "10.0-10.0"
}
```
11. Click on “**Save**” and save the configuration.
12. The actual number of entries, manual eCPM, etc. will be shared after the test setup is complete.
The above setup completes our **Adster.Tech x GAM** integration for **Rewarded Ads**. You should see an Ad like this if the test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a Yield Group :\
{% endhint %}
# Native
This is guide to set up ADSTER.TECH with Google Ad Manager using Yield Groups and Yield Partners for Native Ads.
**CREATING YIELD GROUP AND YIELD PARTNER**
{% hint style="info" %}
For adding **ADSTER.TECH** under existing yield groups, skip the steps for creating a new yield group, navigate to your existing yield group and follow the steps for **Adding Yield Partner** as\
described in the next section
{% endhint %}
1. Under the “**Delivery**” tab : Click on “**Yield Groups**” section
2. Click on “**New Yield Group**” to create a new yield group
3. In the Name field : Type in “**ADSTER.TECH Native**”
4. Ad Format : **Native**
5. Inventory Type : **Mobile**
6. Under Targeting : Select the Ad Units which "**ADSTER.TECH**" will target
7. Scroll to the bottom
**ADDING YIELD PARTNER**
1. Click on “**Add Yield Partner**”
2. Select “**ADSTER.TECH**” from the list
3. Integration Type: **Custom Event**
4. Platform: **Android**
5. Status: **Active**
6. Default CPM: 10 (in USD, this is a test setup pricing to ensure Ads from Adster adapter always comes)
7. Select/Check “**Override Dynamic CPM**”
8. Label: "**Adster\_Native\_10"**
9. Class Name : `com.adster.ads.mediation.adapter.AdSterMediationAdapter`
10. Parameter : Pass the **tag name** provided by the Account Manager
```json
Example:
{
"placement_id": "adster_native_test",
"yield_group_bid_price_range": "10.0-10.0"
}
```
11. Click on “**Save**” and save the configuration.
12. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x GAM** integration for **Native Ads**. You should see an Ad like this if the test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a Yield Group :\
{% endhint %}
# AdMob
The process involves integrating Adster.tech within your AdMob account and adding Adster.tech Bidder inside your mobile application.
**PREREQUISITES**
* An Ad Unit must already be in place which will be used for targeting.
# Banner
This is guide to set up ADSTER.TECH with ADMOB for Banner Ads.
**CREATING CUSTOM EVENTS FOR WATERFALL**
1. Under the **Mediation** tab : Click on **Create Mediation group** section
2. Select **Android** and type of Ad format and Continue
3. In the Name field : Type in Adster\_Banner\_300x250\_10
4. Click on **Add ad units**
5. Select the app and the Ad units that you want to use custom targeting on.
**AD SOURCES (WATERFALL SECTION)**
1. Click on **Add Custom Event**
2. Name the label: Adster\_Banner\_300x250\_10
3. Manual eCPM: Give 10 (in USD) as the value in the **ECPM -** this is a test setup pricing to ensure Ads from Adster adapter always come
4. Now Click on **Add Mapping**
5. You will see the adunit that you have selected before and Custom event with **Add Mapping**
6. **Mapping Name** : Adster\_Banner\_300x250\_10
7. Class name should be `com.adster.ads.mediation.adapter.AdSterMediationAdapter` Ensure the class name is an exact match like in bold.
8. For the **Parameter** Pass the parameter provided by the Account Manager Eg:-
```json
Example:
{
"placement_id": "adster_banner_300x250",
"yield_group_bid_price_range": "10.0-10.0"
}
```
9. Click on “**Save**” and save the configuration.
10. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x ADMOB** integration for **Banner Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a custom event :\
[https://support.google.com/admob/answer/13407144]()
{% endhint %}
# Interstitial
This is guide to set up ADSTER.TECH with ADMOB for Interstitial Ads.
**CREATING CUSTOM EVENTS FOR WATERFALL**
1. Under the **Mediation** tab : Click on **Create Mediation group** section
2. Select **Android** and type of Ad format and Continue
3. In the Name field : Type in **ADSTER.TECH Interstitial**
4. Click on **Add ad units**
5. Select the app and the Ad units that you want to use custom targeting on.
**AD SOURCES (WATERFALL SECTION)**
1. Click on **Add Custom Event**
2. Name the label: Adster\_Inter\_10
3. Manual eCPM: Give 10 (in USD) as the value in the **ECPM -** this is a test setup pricing to ensure Ads from Adster adapter always come
4. Now Click on **Add Mapping**
5. You will see the adunit that you have selected before and Custom event with **Add Mapping**
6. **Mapping Name** : Adster\_Inter\_10
7. Class name should be `com.adster.ads.mediation.adapter.AdSterMediationAdapter` Ensure the class name is an exact match like in bold.
8. For the **Parameter** Pass the parameter provided by the Account Manager Eg:-
```json
Example:
{
"placement_id": "adster_interstitial_test",
"yield_group_bid_price_range": "10.0-10.0"
}
```
9. Click on “**Save**” and save the configuration.
10. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x ADMOB** integration for **Interstitial Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a custom event :\
[https://support.google.com/admob/answer/13407144]()
{% endhint %}
# Rewarded
This is guide to set up ADSTER.TECH with ADMOB for Rewarded Ads.
**CREATING CUSTOM EVENTS FOR WATERFALL**
1. Under the **Mediation** tab : Click on **Create Mediation group** section
2. Select **Android** and type of Ad format and Continue
3. In the Name field : Type in **ADSTER.TECH Rewarded**
4. Click on **Add ad units**
5. Select the app and the Ad units that you want to use custom targeting on.
**AD SOURCES (WATERFALL SECTION)**
1. Click on **Add Custom Event**
2. Name the label: Adster\_Rewarded\_10
3. Manual eCPM: Give 10 (in USD) as the value in the **ECPM -** this is a test setup pricing to ensure Ads from Adster adapter always come
4. Now, Click on **Add Mapping**
5. You will see the adunit that you have selected before and Custom event with **Add Mapping**
6. **Mapping Name**: Adster\_Rewarded\_10
7. Class name should be `com.adster.ads.mediation.adapter.AdSterMediationAdapter` Ensure the class name is an exact match like in bold.
8. For the **Parameter** Pass the parameter provided by the Account Manager Eg:-
```json
Example:
{
"placement_id": "adster_rewarded_test",
"yield_group_bid_price_range": "10.0-10.0"
}
```
9. Click on “**Save**” and save the configuration.
10. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x ADMOB** integration for **Rewarded Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a custom event :\
[https://support.google.com/admob/answer/13407144]()
{% endhint %}
# Native
This is guide to set up ADSTER.TECH with ADMOB for Native Ads.
**CREATING CUSTOM EVENTS FOR WATERFALL**
1. Under the **Mediation** tab : Click on **Create Mediation group** section
2. Select **Android** and type of Ad format and Continue
3. In the Name field : Type in **ADSTER.TECH** Native
4. Click on **Add ad units**
5. Select the app and the Ad units that you want to use custom targeting on.
**AD SOURCES (WATERFALL SECTION)**
1. Click on **Add Custom Event**
2. Name the label: Adster\_Native\_10
3. Manual eCPM: Give 10 (in USD) as the value in the **ECPM -** this is a test setup pricing to ensure Ads from Adster adapter always come
4. Now Click on **Add Mapping**
5. You will see the adunit that you have selected before and Custom event with **Add Mapping**
6. **Mapping Name** : Adster\_Native\_10
7. Class name should be `com.adster.ads.mediation.adapter.AdSterMediationAdapter` Ensure the class name is an exact match like in bold.
8. For the **Parameter** Pass the parameter provided by the Account Manager Eg:-
```json
Example:
{
"placement_id": "adster_native_test",
"yield_group_bid_price_range": "10.0-10.0"
}
```
9. Click on “**Save**” and save the configuration.
10.
```
```
The above setup completes our **Adster.Tech x ADMOB** integration for **Native Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a custom event :\
[https://support.google.com/admob/answer/13407144]()
{% endhint %}
# Applovin
The process involves integrating Adster.tech within your Applovin account and adding Adster.tech Bidder inside your mobile application.
**PREREQUISITES**
* An Ad Unit must already be in place which will be used for targeting.
**APPLOVIN CONFIGURATION**
Please go through the below steps to integrate **ADSTER.TECH** as a demand partner with your **APPLOVIN** account. To begin with the integration, login to your **APPLOVIN** account and follow the below steps.
1. In the MAX Dashboard, select [MAX > Mediation > Manage > Networks](https://dash.applovin.com/o/mediation/networks/).
2. Click on **Click here to add a Custom Network** at the bottom of the page. The Create Custom Network page appears.
1. Add the information about your custom network:\
**Network Type** : Choose **SDK**.
**iOS Adapter Class Name** : leave it blank.\
**Android Adapter Class Name : ****`com.adster.ads.mediation.applovin.AdSterMediationAdapter`**
3. Click on **Save**.
# Banner
This is guide to set up ADSTER.TECH with applovin using custom networks for banner ads.
**ADDING YIELD PARTNER**
1. Open [MAX > Mediation > Manage > Ad Units](https://dash.applovin.com/o/mediation/ad_units/) in the MAX dashboard.
2. Select the Ad Unit of type **Banner** to which you want to add **ADSTER.TECH** as a custom adapter.
3. Select **ADSTER.TECH** from the custom network menu to **enable** and enter the information for each placement. Below are the test setup details
```json
Example:
App ID = Leave it blank (its optional)
Placement ID = "adster_banner_320x50_10"
eCPM: 10 (in USD)
Custom Parameters = {"placement_id":"adster_banner_300x250","yield_group_bid_price_range":"10.0-10.0"}
```
4. Contact your account manager to see what values you need to set for the **final list of production setup (Placement ID**, **Custom Parameters** and **CPM Price)**.
5. Click on “Save” and save the configuration.
The above setup completes our **Adster.Tech x Applovin** integration for **Banner Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Please note that updates to Ad Units may take approximately 30 to 60 minutes to reflect across the system.
{% endhint %}
# MREC
This is guide to set up ADSTER.TECH with applovin using custom networks for mrec ads.
**ADDING YIELD PARTNER**
1. Open [MAX > Mediation > Manage > Ad Units](https://dash.applovin.com/o/mediation/ad_units/) in the MAX dashboard.
2. Select the Ad Unit of type **MREC** to which you want to add **ADSTER.TECH** as a custom adapter.
3. Select **ADSTER.TECH** from custom network menu to **Enable** and enter the information for each placement.
```json
App ID = Leave it blank (its optional)
Placement ID = "adster_banner_300x250_10"
eCPM: 10 (in USD)
Custom Parameters = {"placement_id":"adster_banner_300x250","yield_group_bid_price_range":"10.0-10.0"}
```
4. Contact your account manager to see what values you need to set for the **final list of production setup (Placement ID**, **Custom Parameters** and **CPM Price)**.
5. Click on “Save” and save the configuration.
The above setup completes our **Adster.Tech x Applovin** integration for **Mrec Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Please note that updates to Ad Units may take approximately 30 to 60 minutes to reflect across the system.
{% endhint %}
# Interstitial
This is guide to set up ADSTER.TECH with applovin using custom networks for interstitial ads.
**ADDING YIELD PARTNER**
1. Open [MAX > Mediation > Manage > Ad Units](https://dash.applovin.com/o/mediation/ad_units/) in the MAX dashboard.
2. Select the Ad Unit of type **Interstitial** to which you want to add **ADSTER.TECH** as a custom adapter.
3. Select **ADSTER.TECH** from custom network menu to **Enable** and enter the information for each placement.
```json
Example:
App ID = Leave it blank (its optional)
Placement ID = "adster_inter_10"
eCPM: 10 (in USD)
Custom Parameters = {"placement_id":"adster_interstitial_test","yield_group_bid_price_range":"10.0-10.0"}
```
4. Contact your account manager to see what values you need to set for the **final list of production setup (Placement ID**, **Custom Parameters** and **CPM Price)**.
5. Click on “Save” and save the configuration.
The above setup completes our **Adster.Tech x Applovin** integration for **Interstitial Ads**. You should see an Ad like this if the test setup is complete and working fine.
{% hint style="info" %}
Please note that updates to Ad Units may take approximately 30 to 60 minutes to reflect across the system.
{% endhint %}
# Rewarded
This is guide to set up ADSTER.TECH with applovin using custom networks for rewarded ads.
**ADDING YIELD PARTNER**
1. Open [MAX > Mediation > Manage > Ad Units](https://dash.applovin.com/o/mediation/ad_units/) in the MAX dashboard.
2. Select the Ad Unit of type **Rewarded** to which you want to add **ADSTER.TECH** as a custom adapter.
3. Select **ADSTER.TECH** from custom network menu to **Enable** and enter the information for each placement.
```json
Example:
App ID = Leave it blank (its optional)
Placement ID = "adster_rewarded_10"
eCPM: 10 (in USD)
Custom Parameters = {"placement_id":"adster_rewarded_test","yield_group_bid_price_range":"10.0-10.0"}
```
4. Contact your account manager to see what values you need to set for the **final list of production setup (Placement ID**, **Custom Parameters** and **CPM Price)**.
5. Click on “**Save**” and save the configuration.
The above setup completes our **Adster.Tech x Applovin** integration for **Rewarded Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Please note that updates to Ad Units may take approximately 30 to 60 minutes to reflect across the system.
{% endhint %}
# Ironsource - Levelplay
The process involves integrating Adster.tech within your ironsource-levelplay account and adding Adster.tech Bidder inside your mobile application.
**PREREQUISITES**
* An Ad Unit must already be in place which will be used for targeting.
**From Levelplay UI (Operational / Configuration Process)**
**Create a Adster waterfall Network**
Please go through the below steps to integrate **ADSTER.TECH** as a demand partner with your **IRONSOUCE-LEVELPLAY** account. To begin with the integration, login to your **IRONSOUCE-LEVELPLAY** account and follow the below steps.
1. On the Ironsource platform, select Monetize → Setup → SDK Networks.
2. Select Available Networks → Manage Networks. In the dropdown list of available networks, select Custom Adapter**.**
3. To enable the **Adster Adapter**, input **Network Key ****15c09ed85**, then click on the Enter key, and save. The name of the network should appear as **Adster**.
4. In the next section, enter the Source id provided by Adster, and select **Rate based revenue.** 
5. Click save, your Adster network is now ready.
## Setup Instances for Banner
1. In the Left Side Navigation Menu click Instances under Setup.
2. Click Adster Network listed under Custom.
3. Click on Ad Instance and select Banner Ad type.
4. In the instance name fill **"banner\_300x250"** and select any or all of the mediation groups.
5. Under the Rate column add **$1** as the rate.
## Setup Instances for Interstitial
1. In the Left Side Navigation Menu click Instances under Setup.
2. Click Adster Network listed under Custom.
3. Click on Ad Instance and select Interstitial Ad type.
4. In the instance name fill **"interstitial"** and select any or all of the mediation groups.
5. Under the Rate column add **$1** as the rate.
## Setup Instances for Rewarded
1. In the Left Side Navigation Menu click Instances under Setup.
2. Click Adster Network listed under Custom.
3. Click on Ad Instance and select Rewarded Ad type.
4. In the instance name fill **"rewarded"** and select any or all of the mediation groups.
5. Under the Rate column add **$1** as the rate.
{% hint style="info" %} Adster supports multiple placements in the waterfall
{% endhint %}
{% hint style="info" %} It is highly recommended to enter the Rate (that has been provided by Adster for each placement id), as this determines the correct order in the waterfalls. Repeat the above setup for each ad-format type. To start with, only add one instance for each format only, and use the discussed eCPM rate for waterfall.
{% endhint %}
**Testing instructions**
Before deploying the Adster SDK and adapter to your live application, you can perform testing with the test mode. This will guarantee a high fill rate (99.99%) during the integration testing process, ensuring that the implementation is functioning correctly. It is crucial to disable the test mode before going live, as failing to do so will result in financial loss.
\
**Revenue Reports**
You will be provided with a dashboard, please contact your account manager who will share the credentials with you.
# iOS
This document will guide you through an easy-to-follow process of adding Adster.Tech as your third-party ad network mediation partner for your mobile banner, interstitial, and rewarded ads.
**Installation via SPM**
1. In Xcode, install the AdSter custom adapter SDK Swift Package by navigating to **File > Add Package Dependencies.**
2. In the prompt that appears, search for the below GitHub repository:
3. Select the version of the AdSter SDK Swift Package you want to use. For new projects, we recommend using the **Up to Next Major Version**.
**Installation via CocoaPods**
To integrate AdSter custom adapter SDK into your Xcode project using CocoaPods, follow these steps:
1. Open your project's Podfile and add:
Copy
```
pod 'Adster', '~> 1.4.0'
```
2. Run the following command in the terminal:
Copy
```
pod install
```
3. After installation, close Xcode and open the .xcworkspace file instead of .xcodeproj.
# Google Ad manager
The process involves integrating Adster.tech within your Google Ad Manager account and adding Adster.tech Bidder inside your mobile application.
**PREREQUISITES**
* An Ad Unit must already be in place which will be used for targeting.
**GOOGLE AD MANAGER CONFIGURATION**
Please go through the below steps to integrate **ADSTER.TECH** as a demand partner with your **GAM** account. To begin with the integration, login to your **GAM** account and follow the below steps.
1. Under the **Admin** header : Click on the **Companies** section
2. Click on the **New Company** button : Select **Ad Network**
3. In the Name field : Type In **ADSTER.TECH**
4. In the **Ad Network** field : Select **Other Company**
5. Toggle **Mediation** to **ON**
6. Click on **Save**
# Banner
This is guide to set up ADSTER.TECH with Google Ad Manager using Yield Groups and Yield Partners for Banner Ads.
**CREATING YIELD GROUP AND YIELD PARTNER**
{% hint style="info" %}
For adding **ADSTER.TECH** under existing yield groups, skip the steps for creating a new yield group, navigate to your existing yield group and follow the steps for **Adding Yield Partner** as\
described in the next section
{% endhint %}
1. Under the “**Delivery**” tab : Click on “**Yield Groups**” section
2. Click on “**New Yield Group**” to create a new yield group
3. In the Name field : Type in “**ADSTER.TECH Banner**”
4. Ad Format : **Banner**
5. Inventory Type : **Mobile**
6. Under Targeting : Select the Ad Units which "**ADSTER.TECH**" will target
7. Scroll to the bottom
**ADDING YIELD PARTNER**
1. Click on “**Add Yield Partner**”
2. Select “**ADSTER.TECH**” from the list
3. Integration Type: **Custom Event**
4. Platform: **iOS**
5. Status: **Active**
6. Default CPM: 10 (in USD, this is a test setup pricing to ensure Ads from Adster adapter always comes)
7. Select/Check “**Override Dynamic CPM**”
8. Label: "**Adster\_Banner\_300x250\_10"**
9. Class Name: `AdsFramework.AdSterMediationCustomEvent`
10. Parameter : Pass the **tag name** provided by the Account Manager
```json
Example:
{
"placement_id": "adster_banner_300x250",
"yield_group_bid_price_range": "10.0-10.0"
}
```
11. Click on “**Save**” and save the configuration.
12. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x GAM** integration for **Banner Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a Yield Group :\
{% endhint %}
# Interstitial
This is guide to set up ADSTER.TECH with Google Ad Manager using Yield Groups and Yield Partners for Interstitial Ads.
**CREATING YIELD GROUP AND YIELD PARTNER**
{% hint style="info" %}
For adding **ADSTER.TECH** under existing yield groups, skip the steps for creating a new yield group, navigate to your existing yield group and follow the steps for **Adding Yield Partner** as\
described in the next section
{% endhint %}
1. Under the “**Delivery**” tab : Click on “**Yield Groups**” section
2. Click on “**New Yield Group**” to create a new yield group
3. In the Name field : Type in “**ADSTER.TECH Interstitial**”
4. Ad Format : **Interstitial**
5. Inventory Type : **Mobile**
6. Under Targeting : Select the Ad Units which "**ADSTER.TECH**" will target
7. Scroll to the bottom
**ADDING YIELD PARTNER**
1. Click on “**Add Yield Partner**”
2. Select “**ADSTER.TECH**” from the list
3. Integration Type: **Custom Event**
4. Platform: **iOS**
5. Status: **Active**
6. Default CPM: 10 (in USD, this is a test setup pricing to ensure Ads from Adster adapter always comes)
7. Select/Check “**Override Dynamic CPM**”
8. Label: "**Adster\_Interstitial\_10"**
9. Class Name : `AdsFramework.AdSterMediationCustomEvent`
10. Parameter : Pass the **tag name** provided by the Account Manager
```json
Example:
{
"placement_id": "adster_interstitial_test",
"yield_group_bid_price_range": "10.0-10.0"
}
```
11. Click on “**Save**” and save the configuration.
12. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x GAM** integration for **Interstitial Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a Yield Group :\
{% endhint %}
# Rewarded
This is guide to set up ADSTER.TECH with Google Ad Manager using Yield Groups and Yield Partners for Rewarded Ads.
**CREATING YIELD GROUP AND YIELD PARTNER**
{% hint style="info" %}
For adding **ADSTER.TECH** under existing yield groups, skip the steps for creating a new yield group, navigate to your existing yield group and follow the steps for **Adding Yield Partner** as\
described in the next section
{% endhint %}
1. Under the “**Delivery**” tab : Click on “**Yield Groups**” section
2. Click on “**New Yield Group**” to create a new yield group
3. In the Name field : Type in “**ADSTER.TECH Rewarded**”
4. Ad Format : **Rewarded**
5. Inventory Type : **Mobile**
6. Under Targeting : Select the Ad Units which "**ADSTER.TECH**" will target
7. Scroll to the bottom
**ADDING YIELD PARTNER**
1. Click on “**Add Yield Partner**”
2. Select “**ADSTER.TECH**” from the list
3. Integration Type: **Custom Event**
4. Platform: **Android**
5. Status: **Active**
6. Default CPM: 10 (in USD, this is a test setup pricing to ensure Ads from Adster adapter always comes)
7. Select/Check “**Override Dynamic CPM**”
8. Label: "**Adster\_Rewarded\_10"**
9. Class Name : **`com.adster.ads.mediation.adapter.AdSterMediationAdapter`**
10. Parameter: Pass the **tag name** provided by the Account Manager
```json
Example:
{
"placement_id": "adster_rewarded_test",
"yield_group_bid_price_range": "10.0-10.0"
}
```
11. Click on “**Save**” and save the configuration.
12. The actual number of entries, manual eCPM, etc. will be shared after the test setup is complete.
The above setup completes our **Adster.Tech x GAM** integration for **Rewarded Ads**. You should see an Ad like this if the test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a Yield Group :\
{% endhint %}
# Native
This is guide to set up ADSTER.TECH with Google Ad Manager using Yield Groups and Yield Partners for Native Ads.
**CREATING YIELD GROUP AND YIELD PARTNER**
{% hint style="info" %}
For adding **ADSTER.TECH** under existing yield groups, skip the steps for creating a new yield group, navigate to your existing yield group and follow the steps for **Adding Yield Partner** as\
described in the next section
{% endhint %}
1. Under the “**Delivery**” tab : Click on “**Yield Groups**” section
2. Click on “**New Yield Group**” to create a new yield group
3. In the Name field : Type in “**ADSTER.TECH Native**”
4. Ad Format : **Native**
5. Inventory Type : **Mobile**
6. Under Targeting : Select the Ad Units which "**ADSTER.TECH**" will target
7. Scroll to the bottom
**ADDING YIELD PARTNER**
1. Click on “**Add Yield Partner**”
2. Select “**ADSTER.TECH**” from the list
3. Integration Type: **Custom Event**
4. Platform: **Android**
5. Status: **Active**
6. Default CPM: 10 (in USD, this is a test setup pricing to ensure Ads from Adster adapter always comes)
7. Select/Check “**Override Dynamic CPM**”
8. Label: "**Adster\_Native\_10"**
9. Class Name : **`com.adster.ads.mediation.adapter.AdSterMediationAdapter`**
10. Parameter : Pass the **tag name** provided by the Account Manager
```json
Example:
{
"placement_id": "adster_native_test",
"yield_group_bid_price_range": "0.08-0.12"
}
```
11. Click on “**Save**” and save the configuration.
12. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x GAM** integration for **Native Ads**. You should see an Ad like this if the test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a Yield Group :\
{% endhint %}
# AdMob
The process involves integrating Adster.tech within your AdMob account and adding Adster.tech Bidder inside your mobile application.
**PREREQUISITES**
* An Ad Unit must already be in place which will be used for targeting.
# Banner
This is guide to set up ADSTER.TECH with ADMOB for Banner Ads.
**CREATING CUSTOM EVENTS FOR WATERFALL**
1. Under the **Mediation** tab : Click on **Create Mediation group** section
2. Select **Android** and type of Ad format and Continue
3. In the Name field : Type in Adster\_Banner\_300x250\_10
4. Click on **Add ad units**
5. Select the app and the Ad units that you want to use custom targeting on.
**AD SOURCES (WATERFALL SECTION)**
1. Click on **Add Custom Event**
2. Name the label: Adster\_Banner\_300x250\_10
3. Manual eCPM: Give 10 (in USD) as the value in the **ECPM -** this is a test setup pricing to ensure Ads from Adster adapter always come
4. Now Click on **Add Mapping**
5. You will see the adunit that you have selected before and Custom event with **Add Mapping**
6. **Mapping Name** : Adster\_Banner\_300x250\_10
7. Class name should be `AdsFramework.AdSterMediationCustomEvent` \
Ensure the class name is an exact match like in bold.
8. For the **Parameter** Pass the parameter provided by the Account Manager Eg:-
```json
Example:
{
"placement_id": "adster_banner_300x250",
"yield_group_bid_price_range": "10.0-10.0"
}
```
9. Click on “**Save**” and save the configuration.
10. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x ADMOB** integration for **Banner Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a custom event :\
[https://support.google.com/admob/answer/13407144]()
{% endhint %}
# Interstitial
This is guide to set up ADSTER.TECH with ADMOB for Interstitial Ads.
**CREATING CUSTOM EVENTS FOR WATERFALL**
1. Under the **Mediation** tab : Click on **Create Mediation group** section
2. Select **Android** and type of Ad format and Continue
3. In the Name field : Type in **ADSTER.TECH Interstitial**
4. Click on **Add ad units**
5. Select the app and the Ad units that you want to use custom targeting on.
**AD SOURCES (WATERFALL SECTION)**
1. Click on **Add Custom Event**
2. Name the label: Adster\_Inter\_10
3. Manual eCPM: Give 10 (in USD) as the value in the **ECPM -** this is a test setup pricing to ensure Ads from Adster adapter always come
4. Now Click on **Add Mapping**
5. You will see the adunit that you have selected before and Custom event with **Add Mapping**
6. **Mapping Name** : Adster\_Inter\_10
7. Class name should be `AdsFramework.AdSterMediationCustomEvent` \
Ensure the class name is an exact match like in bold.
8. For the **Parameter** Pass the parameter provided by the Account Manager Eg:-
```json
Example:
{
"placement_id": "adster_interstitial_test",
"yield_group_bid_price_range": "10.0-10.0"
}
```
9. Click on “**Save**” and save the configuration.
10. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x ADMOB** integration for **Interstitial Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a custom event :\
[https://support.google.com/admob/answer/13407144]()
{% endhint %}
# Rewarded
This is guide to set up ADSTER.TECH with ADMOB for Rewarded Ads.
**CREATING CUSTOM EVENTS FOR WATERFALL**
1. Under the **Mediation** tab : Click on **Create Mediation group** section
2. Select **Android** and type of Ad format and Continue
3. In the Name field : Type in **ADSTER.TECH Rewarded**
4. Click on **Add ad units**
5. Select the app and the Ad units that you want to use custom targeting on.
**AD SOURCES (WATERFALL SECTION)**
1. Click on **Add Custom Event**
2. Name the label: Adster\_Rewarded\_10
3. Manual eCPM: Give 10 (in USD) as the value in the **ECPM -** this is a test setup pricing to ensure Ads from Adster adapter always come
4. Now, Click on **Add Mapping**
5. You will see the adunit that you have selected before and Custom event with **Add Mapping**
6. **Mapping Name**: Adster\_Rewarded\_10
7. Class name should be `AdsFramework.AdSterMediationCustomEvent` \
Ensure the class name is an exact match like in bold.
8. For the **Parameter** Pass the parameter provided by the Account Manager Eg:-
```json
Example:
{
"placement_id": "adster_rewarded_test",
"yield_group_bid_price_range": "10.0-10.0"
}
```
9. Click on “**Save**” and save the configuration.
10. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x ADMOB** integration for **Rewarded Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a custom event :\
[https://support.google.com/admob/answer/13407144]()
{% endhint %}
# Native
This is guide to set up ADSTER.TECH with ADMOB for Native Ads.
**CREATING CUSTOM EVENTS FOR WATERFALL**
1. Under the **Mediation** tab : Click on **Create Mediation group** section
2. Select **Android** and type of Ad format and Continue
3. In the Name field : Type in **ADSTER.TECH** Native
4. Click on **Add ad units**
5. Select the app and the Ad units that you want to use custom targeting on.
**AD SOURCES (WATERFALL SECTION)**
1. Click on **Add Custom Event**
2. Name the label: Adster\_Native\_10
3. Manual eCPM: Give 10 (in USD) as the value in the **ECPM -** this is a test setup pricing to ensure Ads from Adster adapter always come
4. Now Click on **Add Mapping**
5. You will see the adunit that you have selected before and Custom event with **Add Mapping**
6. **Mapping Name** : Adster\_Native\_10
7. Class name should be `AdsFramework.AdSterMediationCustomEvent` \
Ensure the class name is an exact match like in bold.
8. For the **Parameter** Pass the parameter provided by the Account Manager Eg:-
```json
Example:
{
"placement_id": "adster_native_test",
"yield_group_bid_price_range": "10.0-10.0"
}
```
9. Click on “**Save**” and save the configuration.
10.
```
```
The above setup completes our **Adster.Tech x ADMOB** integration for **Native Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a custom event :\
[https://support.google.com/admob/answer/13407144]()
{% endhint %}
# Applovin
The process involves integrating Adster.tech within your Applovin account and adding Adster.tech Bidder inside your mobile application.
**PREREQUISITES**
* An Ad Unit must already be in place which will be used for targeting.
**APPLOVIN CONFIGURATION**
Please go through the below steps to integrate **ADSTER.TECH** as a demand partner with your **APPLOVIN** account. To begin with the integration, login to your **APPLOVIN** account and follow the below steps.
1. In the MAX Dashboard, select [MAX > Mediation > Manage > Networks](https://dash.applovin.com/o/mediation/networks/).
2. Click on **Click here to add a Custom Network** at the bottom of the page. The Create Custom Network page appears.
1. Add the information about your custom network:\
**Network Type** : Choose **SDK**.
**iOS Adapter Class Name** : **`AdsFramework.AppLovinMediationCustomEvent`**\
**Android Adapter Class Name :** leave it blank.
3. Click on **Save**.
# Banner
This is guide to set up ADSTER.TECH with applovin using custom networks for banner ads.
**ADDING YIELD PARTNER**
1. Open [MAX > Mediation > Manage > Ad Units](https://dash.applovin.com/o/mediation/ad_units/) in the MAX dashboard.
2. Select the Ad Unit of type **Banner** to which you want to add **ADSTER.TECH** as a custom adapter.
3. Select **ADSTER.TECH** from the custom network menu to **enable** and enter the information for each placement. Below are the test setup details
```json
Example:
App ID = Leave it blank (its optional)
Placement ID = "adster_banner_320x50_10"
eCPM: 10 (in USD)
Custom Parameters = {"placement_id":"banner_320x50","yield_group_bid_price_range":"10.0-10.0"}
```
4. Contact your account manager to see what values you need to set for the **final list of production setup (Placement ID**, **Custom Parameters** and **CPM Price)**.
5. Click on “Save” and save the configuration.
The above setup completes our **Adster.Tech x Applovin** integration for **Banner Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Please note that updates to Ad Units may take approximately 30 to 60 minutes to reflect across the system.
{% endhint %}
# MREC
This is guide to set up ADSTER.TECH with applovin using custom networks for mrec ads.
**ADDING YIELD PARTNER**
1. Open [MAX > Mediation > Manage > Ad Units](https://dash.applovin.com/o/mediation/ad_units/) in the MAX dashboard.
2. Select the Ad Unit of type **MREC** to which you want to add **ADSTER.TECH** as a custom adapter.
3. Select **ADSTER.TECH** from custom network menu to **Enable** and enter the information for each placement.
```json
App ID = Leave it blank (its optional)
Placement ID = "adster_banner_300x250_10"
eCPM: 10 (in USD)
Custom Parameters = {"placement_id":"banner_300x250","yield_group_bid_price_range":"10.0-10.0"}
```
4. Contact your account manager to see what values you need to set for the **final list of production setup (Placement ID**, **Custom Parameters** and **CPM Price)**.
5. Click on “Save” and save the configuration.
The above setup completes our **Adster.Tech x Applovin** integration for **Mrec Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Please note that updates to Ad Units may take approximately 30 to 60 minutes to reflect across the system.
{% endhint %}
# Interstitial
This is guide to set up ADSTER.TECH with applovin using custom networks for interstitial ads.
**ADDING YIELD PARTNER**
1. Open [MAX > Mediation > Manage > Ad Units](https://dash.applovin.com/o/mediation/ad_units/) in the MAX dashboard.
2. Select the Ad Unit of type **Interstitial** to which you want to add **ADSTER.TECH** as a custom adapter.
3. Select **ADSTER.TECH** from custom network menu to **Enable** and enter the information for each placement.
```json
Example:
App ID = Leave it blank (its optional)
Placement ID = "adster_inter_10"
eCPM: 10 (in USD)
Custom Parameters = {"placement_id":"interstitial","yield_group_bid_price_range":"10.0-10.0"}
```
4. Contact your account manager to see what values you need to set for the **final list of production setup (Placement ID**, **Custom Parameters** and **CPM Price)**.
5. Click on “Save” and save the configuration.
The above setup completes our **Adster.Tech x Applovin** integration for **Interstitial Ads**. You should see an Ad like this if the test setup is complete and working fine.
{% hint style="info" %}
Please note that updates to Ad Units may take approximately 30 to 60 minutes to reflect across the system.
{% endhint %}
# Rewarded
This is guide to set up ADSTER.TECH with applovin using custom networks for rewarded ads.
**ADDING YIELD PARTNER**
1. Open [MAX > Mediation > Manage > Ad Units](https://dash.applovin.com/o/mediation/ad_units/) in the MAX dashboard.
2. Select the Ad Unit of type **Rewarded** to which you want to add **ADSTER.TECH** as a custom adapter.
3. Select **ADSTER.TECH** from custom network menu to **Enable** and enter the information for each placement.
```json
Example:
App ID = Leave it blank (its optional)
Placement ID = "adster_rewarded_10"
eCPM: 10 (in USD)
Custom Parameters = {"placement_id":"rewarded","yield_group_bid_price_range":"10.0-10.0"}
```
4. Contact your account manager to see what values you need to set for the **final list of production setup (Placement ID**, **Custom Parameters** and **CPM Price)**.
5. Click on “**Save**” and save the configuration.
The above setup completes our **Adster.Tech x Applovin** integration for **Rewarded Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Please note that updates to Ad Units may take approximately 30 to 60 minutes to reflect across the system.
{% endhint %}
# Unity -Android
This document will guide you through an easy-to-follow process of adding Adster.Tech as your third-party ad network mediation partner for your mobile banner, interstitial, and rewarded ads.
{% hint style="info" %}
**App Prerequisite**
* minSdkVersion of 21 or higher
* compileSdkVersion of 33 or higher
{% endhint %}
## Configuration Steps
#### **Adding Dependency**
{% tabs %}
{% tab title="Unity - Android" %}
* Go to Project Settings > Player > Android > Publishing Settings > Build
* Select **Custom Main Gradle Template.**
* Open the **mainTemplate.gradle** file.
* Find the dependencies block and add from below for respective mediation platform.
{% endtab %}
{% endtabs %}
Google Ad Manager
```
dependencies {
implementation 'com.adstertech:customadapter-lite:2.2.3'
}
```
ADMOB
```gradle
dependencies {
implementation 'com.adstertech:customadapter-lite:2.2.3'
}
```
AppLovin
```gradle
dependencies {
implementation 'com.adstertech:customadapter-applovin:2.2.7'
}
```
Ironsource
```gradle
dependencies {
implementation 'com.adstertech:customadapter-ironsource:2.2.3'
}
```
# Google Ad manager
The process involves integrating Adster.tech within your Google Ad Manager account and adding Adster.tech Bidder inside your mobile application.
**PREREQUISITES**
* An Ad Unit must already be in place which will be used for targeting.
**GOOGLE AD MANAGER CONFIGURATION**
Please go through the below steps to integrate **ADSTER.TECH** as a demand partner with your **GAM** account. To begin with the integration, login to your **GAM** account and follow the below steps.
1. Under the **Admin** header : Click on the **Companies** section
2. Click on the **New Company** button : Select **Ad Network**
3. In the Name field : Type In **ADSTER.TECH**
4. In the **Ad Network** field : Select **Other Company**
5. Toggle **Mediation** to **ON**
6. Click on **Save**
# Banner
This is guide to set up ADSTER.TECH with Google Ad Manager using Yield Groups and Yield Partners for Banner Ads.
**CREATING YIELD GROUP AND YIELD PARTNER**
{% hint style="info" %}
For adding **ADSTER.TECH** under existing yield groups, skip the steps for creating a new yield group, navigate to your existing yield group and follow the steps for **Adding Yield Partner** as\
described in the next section
{% endhint %}
1. Under the “**Delivery**” tab : Click on “**Yield Groups**” section
2. Click on “**New Yield Group**” to create a new yield group
3. In the Name field : Type in “**ADSTER.TECH Banner**”
4. Ad Format : **Banner**
5. Inventory Type : **Mobile**
6. Under Targeting : Select the Ad Units which "**ADSTER.TECH**" will target
7. Scroll to the bottom
**ADDING YIELD PARTNER**
1. Click on “**Add Yield Partner**”
2. Select “**ADSTER.TECH**” from the list
3. Integration Type: **Custom Event**
4. Platform: **Android**
5. Status: **Active**
6. Default CPM: 10 (in USD, this is a test setup pricing to ensure Ads from Adster adapter always comes)
7. Select/Check “**Override Dynamic CPM**”
8. Label: "**Adster\_Banner\_300x250\_10"**
9. Class Name: **`com.adster.ads.mediation.adapter.AdSterMediationAdapter`**
10. Parameter : Pass the **tag name** provided by the Account Manager
```json
Example:
{
"placement_id": "adster_banner_300x250",
"yield_group_bid_price_range": "10.0-10.0"
}
```
11. Click on “**Save**” and save the configuration.
12. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x GAM** integration for **Banner Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a Yield Group :\
{% endhint %}
# Interstitial
This is guide to set up ADSTER.TECH with Google Ad Manager using Yield Groups and Yield Partners for Interstitial Ads.
**CREATING YIELD GROUP AND YIELD PARTNER**
{% hint style="info" %}
For adding **ADSTER.TECH** under existing yield groups, skip the steps for creating a new yield group, navigate to your existing yield group and follow the steps for **Adding Yield Partner** as\
described in the next section
{% endhint %}
1. Under the “**Delivery**” tab : Click on “**Yield Groups**” section
2. Click on “**New Yield Group**” to create a new yield group
3. In the Name field : Type in “**ADSTER.TECH Interstitial**”
4. Ad Format : **Interstitial**
5. Inventory Type : **Mobile**
6. Under Targeting : Select the Ad Units which "**ADSTER.TECH**" will target
7. Scroll to the bottom
**ADDING YIELD PARTNER**
1. Click on “**Add Yield Partner**”
2. Select “**ADSTER.TECH**” from the list
3. Integration Type: **Custom Event**
4. Platform: **Android**
5. Status: **Active**
6. Default CPM: 10 (in USD, this is a test setup pricing to ensure Ads from Adster adapter always comes)
7. Select/Check “**Override Dynamic CPM**”
8. Label: "**Adster\_Interstitial\_10"**
9. Class Name : **`com.adster.ads.mediation.adapter.AdSterMediationAdapter`**
10. Parameter : Pass the **tag name** provided by the Account Manager
```json
Example:
{
"placement_id": "adster_interstitial_test",
"yield_group_bid_price_range": "10.0-10.0"
}
```
11. Click on “**Save**” and save the configuration.
12. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x GAM** integration for **Interstitial Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a Yield Group :\
{% endhint %}
# Rewarded
This is guide to set up ADSTER.TECH with Google Ad Manager using Yield Groups and Yield Partners for Rewarded Ads.
**CREATING YIELD GROUP AND YIELD PARTNER**
{% hint style="info" %}
For adding **ADSTER.TECH** under existing yield groups, skip the steps for creating a new yield group, navigate to your existing yield group and follow the steps for **Adding Yield Partner** as\
described in the next section
{% endhint %}
1. Under the “**Delivery**” tab : Click on “**Yield Groups**” section
2. Click on “**New Yield Group**” to create a new yield group
3. In the Name field : Type in “**ADSTER.TECH Rewarded**”
4. Ad Format : **Rewarded**
5. Inventory Type : **Mobile**
6. Under Targeting : Select the Ad Units which "**ADSTER.TECH**" will target
7. Scroll to the bottom
**ADDING YIELD PARTNER**
1. Click on “**Add Yield Partner**”
2. Select “**ADSTER.TECH**” from the list
3. Integration Type: **Custom Event**
4. Platform: **Android**
5. Status: **Active**
6. Default CPM: 10 (in USD, this is a test setup pricing to ensure Ads from Adster adapter always comes)
7. Select/Check “**Override Dynamic CPM**”
8. Label: "**Adster\_Rewarded\_10"**
9. Class Name : **`com.adster.ads.mediation.adapter.AdSterMediationAdapter`**
10. Parameter: Pass the **tag name** provided by the Account Manager
```json
Example:
{
"placement_id": "adster_rewarded_test",
"yield_group_bid_price_range": "10.0-10.0"
}
```
11. Click on “**Save**” and save the configuration.
12. The actual number of entries, manual eCPM, etc. will be shared after the test setup is complete.
The above setup completes our **Adster.Tech x GAM** integration for **Rewarded Ads**. You should see an Ad like this if the test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a Yield Group :\
{% endhint %}
# Native
This is guide to set up ADSTER.TECH with Google Ad Manager using Yield Groups and Yield Partners for Native Ads.
**CREATING YIELD GROUP AND YIELD PARTNER**
{% hint style="info" %}
For adding **ADSTER.TECH** under existing yield groups, skip the steps for creating a new yield group, navigate to your existing yield group and follow the steps for **Adding Yield Partner** as\
described in the next section
{% endhint %}
1. Under the “**Delivery**” tab : Click on “**Yield Groups**” section
2. Click on “**New Yield Group**” to create a new yield group
3. In the Name field : Type in “**ADSTER.TECH Native**”
4. Ad Format : **Native**
5. Inventory Type : **Mobile**
6. Under Targeting : Select the Ad Units which "**ADSTER.TECH**" will target
7. Scroll to the bottom
**ADDING YIELD PARTNER**
1. Click on “**Add Yield Partner**”
2. Select “**ADSTER.TECH**” from the list
3. Integration Type: **Custom Event**
4. Platform: **Android**
5. Status: **Active**
6. Default CPM: 10 (in USD, this is a test setup pricing to ensure Ads from Adster adapter always comes)
7. Select/Check “**Override Dynamic CPM**”
8. Label: "**Adster\_Native\_10"**
9. Class Name : **`com.adster.ads.mediation.adapter.AdSterMediationAdapter`**
10. Parameter : Pass the **tag name** provided by the Account Manager
```json
Example:
{
"placement_id": "adster_native_test",
"yield_group_bid_price_range": "0.08-0.12"
}
```
11. Click on “**Save**” and save the configuration.
12. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x GAM** integration for **Native Ads**. You should see an Ad like this if the test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a Yield Group :\
{% endhint %}
# AdMob
The process involves integrating Adster.tech within your AdMob account and adding Adster.tech Bidder inside your mobile application.
**PREREQUISITES**
* An Ad Unit must already be in place which will be used for targeting.
# Banner
This is guide to set up ADSTER.TECH with ADMOB for Banner Ads.
**CREATING CUSTOM EVENTS FOR WATERFALL**
1. Under the **Mediation** tab : Click on **Create Mediation group** section
2. Select **Android** and type of Ad format and Continue
3. In the Name field : Type in Adster\_Banner\_300x250\_10
4. Click on **Add ad units**
5. Select the app and the Ad units that you want to use custom targeting on.
**AD SOURCES (WATERFALL SECTION)**
1. Click on **Add Custom Event**
2. Name the label: Adster\_Banner\_300x250\_10
3. Manual eCPM: Give 10 (in USD) as the value in the **ECPM -** this is a test setup pricing to ensure Ads from Adster adapter always come
4. Now Click on **Add Mapping**
5. You will see the adunit that you have selected before and Custom event with **Add Mapping**
6. **Mapping Name** : Adster\_Banner\_300x250\_10
7. Class name should be `com.adster.ads.mediation.adapter.AdSterMediationAdapter` Ensure the class name is an exact match like in bold.
8. For the **Parameter** Pass the parameter provided by the Account Manager Eg:-
```json
Example:
{
"placement_id": "adster_banner_300x250",
"yield_group_bid_price_range": "10.0-10.0"
}
```
9. Click on “**Save**” and save the configuration.
10. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x ADMOB** integration for **Banner Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a custom event :\
[https://support.google.com/admob/answer/13407144]()
{% endhint %}
# Interstitial
This is guide to set up ADSTER.TECH with ADMOB for Interstitial Ads.
**CREATING CUSTOM EVENTS FOR WATERFALL**
1. Under the **Mediation** tab : Click on **Create Mediation group** section
2. Select **Android** and type of Ad format and Continue
3. In the Name field : Type in **ADSTER.TECH Interstitial**
4. Click on **Add ad units**
5. Select the app and the Ad units that you want to use custom targeting on.
**AD SOURCES (WATERFALL SECTION)**
1. Click on **Add Custom Event**
2. Name the label: Adster\_Inter\_10
3. Manual eCPM: Give 10 (in USD) as the value in the **ECPM -** this is a test setup pricing to ensure Ads from Adster adapter always come
4. Now Click on **Add Mapping**
5. You will see the adunit that you have selected before and Custom event with **Add Mapping**
6. **Mapping Name** : Adster\_Inter\_10
7. Class name should be `com.adster.ads.mediation.adapter.AdSterMediationAdapter` Ensure the class name is an exact match like in bold.
8. For the **Parameter** Pass the parameter provided by the Account Manager Eg:-
```json
Example:
{
"placement_id": "adster_interstitial_test",
"yield_group_bid_price_range": "10.0-10.0"
}
```
9. Click on “**Save**” and save the configuration.
10. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x ADMOB** integration for **Interstitial Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a custom event :\
[https://support.google.com/admob/answer/13407144]()
{% endhint %}
# Rewarded
This is guide to set up ADSTER.TECH with ADMOB for Rewarded Ads.
**CREATING CUSTOM EVENTS FOR WATERFALL**
1. Under the **Mediation** tab : Click on **Create Mediation group** section
2. Select **Android** and type of Ad format and Continue
3. In the Name field : Type in **ADSTER.TECH Rewarded**
4. Click on **Add ad units**
5. Select the app and the Ad units that you want to use custom targeting on.
**AD SOURCES (WATERFALL SECTION)**
1. Click on **Add Custom Event**
2. Name the label: Adster\_Rewarded\_10
3. Manual eCPM: Give 10 (in USD) as the value in the **ECPM -** this is a test setup pricing to ensure Ads from Adster adapter always come
4. Now, Click on **Add Mapping**
5. You will see the adunit that you have selected before and Custom event with **Add Mapping**
6. **Mapping Name**: Adster\_Rewarded\_10
7. Class name should be `com.adster.ads.mediation.adapter.AdSterMediationAdapter` Ensure the class name is an exact match like in bold.
8. For the **Parameter** Pass the parameter provided by the Account Manager Eg:-
```json
Example:
{
"placement_id": "adster_rewarded_test",
"yield_group_bid_price_range": "10.0-10.0"
}
```
9. Click on “**Save**” and save the configuration.
10. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x ADMOB** integration for **Rewarded Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a custom event :\
[https://support.google.com/admob/answer/13407144]()
{% endhint %}
# Native
This is guide to set up ADSTER.TECH with ADMOB for Native Ads.
**CREATING CUSTOM EVENTS FOR WATERFALL**
1. Under the **Mediation** tab : Click on **Create Mediation group** section
2. Select **Android** and type of Ad format and Continue
3. In the Name field : Type in **ADSTER.TECH** Native
4. Click on **Add ad units**
5. Select the app and the Ad units that you want to use custom targeting on.
**AD SOURCES (WATERFALL SECTION)**
1. Click on **Add Custom Event**
2. Name the label: Adster\_Native\_10
3. Manual eCPM: Give 10 (in USD) as the value in the **ECPM -** this is a test setup pricing to ensure Ads from Adster adapter always come
4. Now Click on **Add Mapping**
5. You will see the adunit that you have selected before and Custom event with **Add Mapping**
6. **Mapping Name** : Adster\_Native\_10
7. Class name should be `com.adster.ads.mediation.adapter.AdSterMediationAdapter` Ensure the class name is an exact match like in bold.
8. For the **Parameter** Pass the parameter provided by the Account Manager Eg:-
```json
Example:
{
"placement_id": "adster_native_test",
"yield_group_bid_price_range": "10.0-10.0"
}
```
9. Click on “**Save**” and save the configuration.
10.
```
```
The above setup completes our **Adster.Tech x ADMOB** integration for **Native Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a custom event :\
[https://support.google.com/admob/answer/13407144]()
{% endhint %}
# Applovin
The process involves integrating Adster.tech within your Applovin account and adding Adster.tech Bidder inside your mobile application.
**PREREQUISITES**
* An Ad Unit must already be in place which will be used for targeting.
**APPLOVIN CONFIGURATION**
Please go through the below steps to integrate **ADSTER.TECH** as a demand partner with your **APPLOVIN** account. To begin with the integration, login to your **APPLOVIN** account and follow the below steps.
1. In the MAX Dashboard, select [MAX > Mediation > Manage > Networks](https://dash.applovin.com/o/mediation/networks/).
2. Click on **Click here to add a Custom Network** at the bottom of the page. The Create Custom Network page appears.
1. Add the information about your custom network:\
**Network Type** : Choose **SDK**.
**iOS Adapter Class Name** : leave it blank.\
**Android Adapter Class Name : ****`com.adster.ads.mediation.applovin.AdSterMediationAdapter`**
3. Click on **Save**.
# Banner
This is guide to set up ADSTER.TECH with applovin using custom networks for banner ads.
**ADDING YIELD PARTNER**
1. Open [MAX > Mediation > Manage > Ad Units](https://dash.applovin.com/o/mediation/ad_units/) in the MAX dashboard.
2. Select the Ad Unit of type **Banner** to which you want to add **ADSTER.TECH** as a custom adapter.
3. Select **ADSTER.TECH** from the custom network menu to **enable** and enter the information for each placement. Below are the test setup details
```json
Example:
App ID = Leave it blank (its optional)
Placement ID = "adster_banner_320x50_10"
eCPM: 10 (in USD)
Custom Parameters = {"placement_id":"adster_banner_320x50","yield_group_bid_price_range":"10.0-10.0"}
```
4. Contact your account manager to see what values you need to set for the **final list of production setup (Placement ID**, **Custom Parameters** and **CPM Price)**.
5. Click on “Save” and save the configuration.
The above setup completes our **Adster.Tech x Applovin** integration for **Banner Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Please note that updates to Ad Units may take approximately 30 to 60 minutes to reflect across the system.
{% endhint %}
# MREC
This is guide to set up ADSTER.TECH with applovin using custom networks for mrec ads.
**ADDING YIELD PARTNER**
1. Open [MAX > Mediation > Manage > Ad Units](https://dash.applovin.com/o/mediation/ad_units/) in the MAX dashboard.
2. Select the Ad Unit of type **MREC** to which you want to add **ADSTER.TECH** as a custom adapter.
3. Select **ADSTER.TECH** from custom network menu to **Enable** and enter the information for each placement.
```json
App ID = Leave it blank (its optional)
Placement ID = "adster_banner_300x250_10"
eCPM: 10 (in USD)
Custom Parameters = {"placement_id":"adster_banner_300x250","yield_group_bid_price_range":"10.0-10.0"}
```
4. Contact your account manager to see what values you need to set for the **final list of production setup (Placement ID**, **Custom Parameters** and **CPM Price)**.
5. Click on “Save” and save the configuration.
The above setup completes our **Adster.Tech x Applovin** integration for **Mrec Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Please note that updates to Ad Units may take approximately 30 to 60 minutes to reflect across the system.
{% endhint %}
# Interstitial
This is guide to set up ADSTER.TECH with applovin using custom networks for interstitial ads.
**ADDING YIELD PARTNER**
1. Open [MAX > Mediation > Manage > Ad Units](https://dash.applovin.com/o/mediation/ad_units/) in the MAX dashboard.
2. Select the Ad Unit of type **Interstitial** to which you want to add **ADSTER.TECH** as a custom adapter.
3. Select **ADSTER.TECH** from custom network menu to **Enable** and enter the information for each placement.
```json
Example:
App ID = Leave it blank (its optional)
Placement ID = "adster_inter_10"
eCPM: 10 (in USD)
Custom Parameters = {"placement_id":"adster_interstitial_test","yield_group_bid_price_range":"10.0-10.0"}
```
4. Contact your account manager to see what values you need to set for the **final list of production setup (Placement ID**, **Custom Parameters** and **CPM Price)**.
5. Click on “Save” and save the configuration.
The above setup completes our **Adster.Tech x Applovin** integration for **Interstitial Ads**. You should see an Ad like this if the test setup is complete and working fine.
{% hint style="info" %}
Please note that updates to Ad Units may take approximately 30 to 60 minutes to reflect across the system.
{% endhint %}
# Rewarded
This is guide to set up ADSTER.TECH with applovin using custom networks for rewarded ads.
**ADDING YIELD PARTNER**
1. Open [MAX > Mediation > Manage > Ad Units](https://dash.applovin.com/o/mediation/ad_units/) in the MAX dashboard.
2. Select the Ad Unit of type **Rewarded** to which you want to add **ADSTER.TECH** as a custom adapter.
3. Select **ADSTER.TECH** from custom network menu to **Enable** and enter the information for each placement.
```json
Example:
App ID = Leave it blank (its optional)
Placement ID = "adster_rewarded_10"
eCPM: 10 (in USD)
Custom Parameters = {"placement_id":"adster_rewarded_test","yield_group_bid_price_range":"10.0-10.0"}
```
4. Contact your account manager to see what values you need to set for the **final list of production setup (Placement ID**, **Custom Parameters** and **CPM Price)**.
5. Click on “**Save**” and save the configuration.
The above setup completes our **Adster.Tech x Applovin** integration for **Rewarded Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Please note that updates to Ad Units may take approximately 30 to 60 minutes to reflect across the system.
{% endhint %}
# Ironsource - Levelplay
The process involves integrating Adster.tech within your ironsource-levelplay account and adding Adster.tech Bidder inside your mobile application.
**PREREQUISITES**
* An Ad Unit must already be in place which will be used for targeting.
**From Levelplay UI (Operational / Configuration Process)**
**Create a Adster waterfall Network**
Please go through the below steps to integrate **ADSTER.TECH** as a demand partner with your **IRONSOUCE-LEVELPLAY** account. To begin with the integration, login to your **IRONSOUCE-LEVELPLAY** account and follow the below steps.
1. On the Ironsource platform, select Monetize → Setup → SDK Networks.
2. Select Available Networks → Manage Networks. In the dropdown list of available networks, select Custom Adapter**.**
3. To enable the **Adster Adapter**, input **Network Key ****15c09ed85**, then click on the Enter key, and save. The name of the network should appear as **Adster**.
4. In the next section, enter the Source id provided by Adster, and select **Rate based revenue.** 
5. Click save, your Adster network is now ready.
## Setup Instances for Banner
1. In the Left Side Navigation Menu click Instances under Setup.
2. Click Adster Network listed under Custom.
3. Click on Ad Instance and select Banner Ad type.
4. In the instance name fill **"adster\_banner\_300x250\_1.0"** and select any or all of the mediation groups.
5. Under the Rate column add **$1** as the rate.
## Setup Instances for Interstitial
1. In the Left Side Navigation Menu click Instances under Setup.
2. Click Adster Network listed under Custom.
3. Click on Ad Instance and select Interstitial Ad type.
4. In the instance name fill **"adster\_interstitial\_test\_1.0"** and select any or all of the mediation groups.
5. Under the Rate column add **$1** as the rate.
## Setup Instances for Rewarded
1. In the Left Side Navigation Menu click Instances under Setup.
2. Click Adster Network listed under Custom.
3. Click on Ad Instance and select Rewarded Ad type.
4. In the instance name fill **"adster\_rewarded\_test\_1.0"** and select any or all of the mediation groups.
5. Under the Rate column add **$1** as the rate.
{% hint style="info" %} Adster supports multiple placements in the waterfall
{% endhint %}
{% hint style="info" %} It is highly recommended to enter the Rate (that has been provided by Adster for each placement id), as this determines the correct order in the waterfalls. Repeat the above setup for each ad-format type. To start with, only add one instance for each format only, and use the discussed eCPM rate for waterfall.
{% endhint %}
**Testing instructions**
Before deploying the Adster SDK and adapter to your live application, you can perform testing with the test mode. This will guarantee a high fill rate (99.99%) during the integration testing process, ensuring that the implementation is functioning correctly. It is crucial to disable the test mode before going live, as failing to do so will result in financial loss.
\
**Revenue Reports**
You will be provided with a dashboard, please contact your account manager who will share the credentials with you.
# Unity - iOS
This document will guide you through an easy-to-follow process of adding Adster.Tech as your third-party ad network mediation partner for your mobile banner, interstitial, and rewarded ads.
{% hint style="info" %}
**App Prerequisite**
* Target minimum iOS version of 13.0 or higher
{% endhint %}
#### SDK Integration
**Installation via SPM**
1. In Xcode, install the AdSter custom adapter SDK Swift Package by navigating to **File > Add Package Dependencies.**
2. In the prompt that appears, search for the below GitHub repository:
3. Select the version of the AdSter SDK Swift Package you want to use. For new projects, we recommend using the **Up to Next Major Version**.
**Installation via CocoaPods**
To integrate AdSter custom adapter SDK into your Xcode project using CocoaPods, follow these steps:
1. Open your project's Podfile and add:
Copy
```
pod 'Adster', '~> 1.3.4'
```
2. Run the following command in the terminal:
Copy
```
pod install
```
3. After installation, close Xcode and open the .xcworkspace file instead of .xcodeproj.
# Google Ad manager
The process involves integrating Adster.tech within your Google Ad Manager account and adding Adster.tech Bidder inside your mobile application.
**PREREQUISITES**
* An Ad Unit must already be in place which will be used for targeting.
**GOOGLE AD MANAGER CONFIGURATION**
Please go through the below steps to integrate **ADSTER.TECH** as a demand partner with your **GAM** account. To begin with the integration, login to your **GAM** account and follow the below steps.
1. Under the **Admin** header : Click on the **Companies** section
2. Click on the **New Company** button : Select **Ad Network**
3. In the Name field : Type In **ADSTER.TECH**
4. In the **Ad Network** field : Select **Other Company**
5. Toggle **Mediation** to **ON**
6. Click on **Save**
# Banner
This is guide to set up ADSTER.TECH with Google Ad Manager using Yield Groups and Yield Partners for Banner Ads.
**CREATING YIELD GROUP AND YIELD PARTNER**
{% hint style="info" %}
For adding **ADSTER.TECH** under existing yield groups, skip the steps for creating a new yield group, navigate to your existing yield group and follow the steps for **Adding Yield Partner** as\
described in the next section
{% endhint %}
1. Under the “**Delivery**” tab : Click on “**Yield Groups**” section
2. Click on “**New Yield Group**” to create a new yield group
3. In the Name field : Type in “**ADSTER.TECH Banner**”
4. Ad Format : **Banner**
5. Inventory Type : **Mobile**
6. Under Targeting : Select the Ad Units which "**ADSTER.TECH**" will target
7. Scroll to the bottom
**ADDING YIELD PARTNER**
1. Click on “**Add Yield Partner**”
2. Select “**ADSTER.TECH**” from the list
3. Integration Type: **Custom Event**
4. Platform: **iOS**
5. Status: **Active**
6. Default CPM: 10 (in USD, this is a test setup pricing to ensure Ads from Adster adapter always comes)
7. Select/Check “**Override Dynamic CPM**”
8. Label: "**Adster\_Banner\_300x250\_10"**
9. Class Name: `AdsFramework.AdSterMediationCustomEvent`
10. Parameter : Pass the **tag name** provided by the Account Manager
```json
Example:
{
"placement_id": "adster_banner_300x250",
"yield_group_bid_price_range": "10.0-10.0"
}
```
11. Click on “**Save**” and save the configuration.
12. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x GAM** integration for **Banner Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a Yield Group :\
{% endhint %}
# Interstitial
This is guide to set up ADSTER.TECH with Google Ad Manager using Yield Groups and Yield Partners for Interstitial Ads.
**CREATING YIELD GROUP AND YIELD PARTNER**
{% hint style="info" %}
For adding **ADSTER.TECH** under existing yield groups, skip the steps for creating a new yield group, navigate to your existing yield group and follow the steps for **Adding Yield Partner** as\
described in the next section
{% endhint %}
1. Under the “**Delivery**” tab : Click on “**Yield Groups**” section
2. Click on “**New Yield Group**” to create a new yield group
3. In the Name field : Type in “**ADSTER.TECH Interstitial**”
4. Ad Format : **Interstitial**
5. Inventory Type : **Mobile**
6. Under Targeting : Select the Ad Units which "**ADSTER.TECH**" will target
7. Scroll to the bottom
**ADDING YIELD PARTNER**
1. Click on “**Add Yield Partner**”
2. Select “**ADSTER.TECH**” from the list
3. Integration Type: **Custom Event**
4. Platform: **iOS**
5. Status: **Active**
6. Default CPM: 10 (in USD, this is a test setup pricing to ensure Ads from Adster adapter always comes)
7. Select/Check “**Override Dynamic CPM**”
8. Label: "**Adster\_Interstitial\_10"**
9. Class Name : `AdsFramework.AdSterMediationCustomEvent`
10. Parameter : Pass the **tag name** provided by the Account Manager
```json
Example:
{
"placement_id": "adster_interstitial_test",
"yield_group_bid_price_range": "10.0-10.0"
}
```
11. Click on “**Save**” and save the configuration.
12. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x GAM** integration for **Interstitial Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a Yield Group :\
{% endhint %}
# Rewarded
This is guide to set up ADSTER.TECH with Google Ad Manager using Yield Groups and Yield Partners for Rewarded Ads.
**CREATING YIELD GROUP AND YIELD PARTNER**
{% hint style="info" %}
For adding **ADSTER.TECH** under existing yield groups, skip the steps for creating a new yield group, navigate to your existing yield group and follow the steps for **Adding Yield Partner** as\
described in the next section
{% endhint %}
1. Under the “**Delivery**” tab : Click on “**Yield Groups**” section
2. Click on “**New Yield Group**” to create a new yield group
3. In the Name field : Type in “**ADSTER.TECH Rewarded**”
4. Ad Format : **Rewarded**
5. Inventory Type : **Mobile**
6. Under Targeting : Select the Ad Units which "**ADSTER.TECH**" will target
7. Scroll to the bottom
**ADDING YIELD PARTNER**
1. Click on “**Add Yield Partner**”
2. Select “**ADSTER.TECH**” from the list
3. Integration Type: **Custom Event**
4. Platform: **Android**
5. Status: **Active**
6. Default CPM: 10 (in USD, this is a test setup pricing to ensure Ads from Adster adapter always comes)
7. Select/Check “**Override Dynamic CPM**”
8. Label: "**Adster\_Rewarded\_10"**
9. Class Name : **`com.adster.ads.mediation.adapter.AdSterMediationAdapter`**
10. Parameter: Pass the **tag name** provided by the Account Manager
```json
Example:
{
"placement_id": "adster_rewarded_test",
"yield_group_bid_price_range": "10.0-10.0"
}
```
11. Click on “**Save**” and save the configuration.
12. The actual number of entries, manual eCPM, etc. will be shared after the test setup is complete.
The above setup completes our **Adster.Tech x GAM** integration for **Rewarded Ads**. You should see an Ad like this if the test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a Yield Group :\
{% endhint %}
# Native
This is guide to set up ADSTER.TECH with Google Ad Manager using Yield Groups and Yield Partners for Native Ads.
**CREATING YIELD GROUP AND YIELD PARTNER**
{% hint style="info" %}
For adding **ADSTER.TECH** under existing yield groups, skip the steps for creating a new yield group, navigate to your existing yield group and follow the steps for **Adding Yield Partner** as\
described in the next section
{% endhint %}
1. Under the “**Delivery**” tab : Click on “**Yield Groups**” section
2. Click on “**New Yield Group**” to create a new yield group
3. In the Name field : Type in “**ADSTER.TECH Native**”
4. Ad Format : **Native**
5. Inventory Type : **Mobile**
6. Under Targeting : Select the Ad Units which "**ADSTER.TECH**" will target
7. Scroll to the bottom
**ADDING YIELD PARTNER**
1. Click on “**Add Yield Partner**”
2. Select “**ADSTER.TECH**” from the list
3. Integration Type: **Custom Event**
4. Platform: **Android**
5. Status: **Active**
6. Default CPM: 10 (in USD, this is a test setup pricing to ensure Ads from Adster adapter always comes)
7. Select/Check “**Override Dynamic CPM**”
8. Label: "**Adster\_Native\_10"**
9. Class Name : **`com.adster.ads.mediation.adapter.AdSterMediationAdapter`**
10. Parameter : Pass the **tag name** provided by the Account Manager
```json
Example:
{
"placement_id": "adster_native_test",
"yield_group_bid_price_range": "0.08-0.12"
}
```
11. Click on “**Save**” and save the configuration.
12. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x GAM** integration for **Native Ads**. You should see an Ad like this if the test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a Yield Group :\
{% endhint %}
# AdMob
The process involves integrating Adster.tech within your AdMob account and adding Adster.tech Bidder inside your mobile application.
**PREREQUISITES**
* An Ad Unit must already be in place which will be used for targeting.
# Banner
This is guide to set up ADSTER.TECH with ADMOB for Banner Ads.
**CREATING CUSTOM EVENTS FOR WATERFALL**
1. Under the **Mediation** tab : Click on **Create Mediation group** section
2. Select **Android** and type of Ad format and Continue
3. In the Name field : Type in Adster\_Banner\_300x250\_10
4. Click on **Add ad units**
5. Select the app and the Ad units that you want to use custom targeting on.
**AD SOURCES (WATERFALL SECTION)**
1. Click on **Add Custom Event**
2. Name the label: Adster\_Banner\_300x250\_10
3. Manual eCPM: Give 10 (in USD) as the value in the **ECPM -** this is a test setup pricing to ensure Ads from Adster adapter always come
4. Now Click on **Add Mapping**
5. You will see the adunit that you have selected before and Custom event with **Add Mapping**
6. **Mapping Name** : Adster\_Banner\_300x250\_10
7. Class name should be `AdsFramework.AdSterMediationCustomEvent` \
Ensure the class name is an exact match like in bold.
8. For the **Parameter** Pass the parameter provided by the Account Manager Eg:-
```json
Example:
{
"placement_id": "adster_banner_300x250",
"yield_group_bid_price_range": "10.0-10.0"
}
```
9. Click on “**Save**” and save the configuration.
10. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x ADMOB** integration for **Banner Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a custom event :\
[https://support.google.com/admob/answer/13407144]()
{% endhint %}
# Interstitial
This is guide to set up ADSTER.TECH with ADMOB for Interstitial Ads.
**CREATING CUSTOM EVENTS FOR WATERFALL**
1. Under the **Mediation** tab : Click on **Create Mediation group** section
2. Select **Android** and type of Ad format and Continue
3. In the Name field : Type in **ADSTER.TECH Interstitial**
4. Click on **Add ad units**
5. Select the app and the Ad units that you want to use custom targeting on.
**AD SOURCES (WATERFALL SECTION)**
1. Click on **Add Custom Event**
2. Name the label: Adster\_Inter\_10
3. Manual eCPM: Give 10 (in USD) as the value in the **ECPM -** this is a test setup pricing to ensure Ads from Adster adapter always come
4. Now Click on **Add Mapping**
5. You will see the adunit that you have selected before and Custom event with **Add Mapping**
6. **Mapping Name** : Adster\_Inter\_10
7. Class name should be `AdsFramework.AdSterMediationCustomEvent` \
Ensure the class name is an exact match like in bold.
8. For the **Parameter** Pass the parameter provided by the Account Manager Eg:-
```json
Example:
{
"placement_id": "adster_interstitial_test",
"yield_group_bid_price_range": "10.0-10.0"
}
```
9. Click on “**Save**” and save the configuration.
10. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x ADMOB** integration for **Interstitial Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a custom event :\
[https://support.google.com/admob/answer/13407144]()
{% endhint %}
# Rewarded
This is guide to set up ADSTER.TECH with ADMOB for Rewarded Ads.
**CREATING CUSTOM EVENTS FOR WATERFALL**
1. Under the **Mediation** tab : Click on **Create Mediation group** section
2. Select **Android** and type of Ad format and Continue
3. In the Name field : Type in **ADSTER.TECH Rewarded**
4. Click on **Add ad units**
5. Select the app and the Ad units that you want to use custom targeting on.
**AD SOURCES (WATERFALL SECTION)**
1. Click on **Add Custom Event**
2. Name the label: Adster\_Rewarded\_10
3. Manual eCPM: Give 10 (in USD) as the value in the **ECPM -** this is a test setup pricing to ensure Ads from Adster adapter always come
4. Now, Click on **Add Mapping**
5. You will see the adunit that you have selected before and Custom event with **Add Mapping**
6. **Mapping Name**: Adster\_Rewarded\_10
7. Class name should be `AdsFramework.AdSterMediationCustomEvent` \
Ensure the class name is an exact match like in bold.
8. For the **Parameter** Pass the parameter provided by the Account Manager Eg:-
```json
Example:
{
"placement_id": "adster_rewarded_test",
"yield_group_bid_price_range": "10.0-10.0"
}
```
9. Click on “**Save**” and save the configuration.
10. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.
The above setup completes our **Adster.Tech x ADMOB** integration for **Rewarded Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a custom event :\
[https://support.google.com/admob/answer/13407144]()
{% endhint %}
# Native
This is guide to set up ADSTER.TECH with ADMOB for Native Ads.
**CREATING CUSTOM EVENTS FOR WATERFALL**
1. Under the **Mediation** tab : Click on **Create Mediation group** section
2. Select **Android** and type of Ad format and Continue
3. In the Name field : Type in **ADSTER.TECH** Native
4. Click on **Add ad units**
5. Select the app and the Ad units that you want to use custom targeting on.
**AD SOURCES (WATERFALL SECTION)**
1. Click on **Add Custom Event**
2. Name the label: Adster\_Native\_10
3. Manual eCPM: Give 10 (in USD) as the value in the **ECPM -** this is a test setup pricing to ensure Ads from Adster adapter always come
4. Now Click on **Add Mapping**
5. You will see the adunit that you have selected before and Custom event with **Add Mapping**
6. **Mapping Name** : Adster\_Native\_10
7. Class name should be `AdsFramework.AdSterMediationCustomEvent` \
Ensure the class name is an exact match like in bold.
8. For the **Parameter** Pass the parameter provided by the Account Manager Eg:-
```json
Example:
{
"placement_id": "adster_native_test",
"yield_group_bid_price_range": "10.0-10.0"
}
```
9. Click on “**Save**” and save the configuration.
10.
```
```
The above setup completes our **Adster.Tech x ADMOB** integration for **Native Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Official Google Documentation for creating a custom event :\
[https://support.google.com/admob/answer/13407144]()
{% endhint %}
# Applovin
The process involves integrating Adster.tech within your Applovin account and adding Adster.tech Bidder inside your mobile application.
**PREREQUISITES**
* An Ad Unit must already be in place which will be used for targeting.
**APPLOVIN CONFIGURATION**
Please go through the below steps to integrate **ADSTER.TECH** as a demand partner with your **APPLOVIN** account. To begin with the integration, login to your **APPLOVIN** account and follow the below steps.
1. In the MAX Dashboard, select [MAX > Mediation > Manage > Networks](https://dash.applovin.com/o/mediation/networks/).
2. Click on **Click here to add a Custom Network** at the bottom of the page. The Create Custom Network page appears.
1. Add the information about your custom network:\
**Network Type** : Choose **SDK**.
**iOS Adapter Class Name** : **`AdsFramework.AppLovinMediationCustomEvent`**\
**Android Adapter Class Name :** leave it blank.
3. Click on **Save**.
# Banner
This is guide to set up ADSTER.TECH with applovin using custom networks for banner ads.
**ADDING YIELD PARTNER**
1. Open [MAX > Mediation > Manage > Ad Units](https://dash.applovin.com/o/mediation/ad_units/) in the MAX dashboard.
2. Select the Ad Unit of type **Banner** to which you want to add **ADSTER.TECH** as a custom adapter.
3. Select **ADSTER.TECH** from the custom network menu to **enable** and enter the information for each placement. Below are the test setup details
```json
Example:
App ID = Leave it blank (its optional)
Placement ID = "adster_banner_320x50_10"
eCPM: 10 (in USD)
Custom Parameters = {"placement_id":"banner_320x50","yield_group_bid_price_range":"10.0-10.0"}
```
4. Contact your account manager to see what values you need to set for the **final list of production setup (Placement ID**, **Custom Parameters** and **CPM Price)**.
5. Click on “Save” and save the configuration.
The above setup completes our **Adster.Tech x Applovin** integration for **Banner Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Please note that updates to Ad Units may take approximately 30 to 60 minutes to reflect across the system.
{% endhint %}
# MREC
This is guide to set up ADSTER.TECH with applovin using custom networks for mrec ads.
**ADDING YIELD PARTNER**
1. Open [MAX > Mediation > Manage > Ad Units](https://dash.applovin.com/o/mediation/ad_units/) in the MAX dashboard.
2. Select the Ad Unit of type **MREC** to which you want to add **ADSTER.TECH** as a custom adapter.
3. Select **ADSTER.TECH** from custom network menu to **Enable** and enter the information for each placement.
```json
App ID = Leave it blank (its optional)
Placement ID = "adster_banner_300x250_10"
eCPM: 10 (in USD)
Custom Parameters = {"placement_id":"banner_300x250","yield_group_bid_price_range":"10.0-10.0"}
```
4. Contact your account manager to see what values you need to set for the **final list of production setup (Placement ID**, **Custom Parameters** and **CPM Price)**.
5. Click on “Save” and save the configuration.
The above setup completes our **Adster.Tech x Applovin** integration for **Mrec Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Please note that updates to Ad Units may take approximately 30 to 60 minutes to reflect across the system.
{% endhint %}
# Interstitial
This is guide to set up ADSTER.TECH with applovin using custom networks for interstitial ads.
**ADDING YIELD PARTNER**
1. Open [MAX > Mediation > Manage > Ad Units](https://dash.applovin.com/o/mediation/ad_units/) in the MAX dashboard.
2. Select the Ad Unit of type **Interstitial** to which you want to add **ADSTER.TECH** as a custom adapter.
3. Select **ADSTER.TECH** from custom network menu to **Enable** and enter the information for each placement.
```json
Example:
App ID = Leave it blank (its optional)
Placement ID = "adster_inter_10"
eCPM: 10 (in USD)
Custom Parameters = {"placement_id":"interstitial","yield_group_bid_price_range":"10.0-10.0"}
```
4. Contact your account manager to see what values you need to set for the **final list of production setup (Placement ID**, **Custom Parameters** and **CPM Price)**.
5. Click on “Save” and save the configuration.
The above setup completes our **Adster.Tech x Applovin** integration for **Interstitial Ads**. You should see an Ad like this if the test setup is complete and working fine.
{% hint style="info" %}
Please note that updates to Ad Units may take approximately 30 to 60 minutes to reflect across the system.
{% endhint %}
# Rewarded
This is guide to set up ADSTER.TECH with applovin using custom networks for rewarded ads.
**ADDING YIELD PARTNER**
1. Open [MAX > Mediation > Manage > Ad Units](https://dash.applovin.com/o/mediation/ad_units/) in the MAX dashboard.
2. Select the Ad Unit of type **Rewarded** to which you want to add **ADSTER.TECH** as a custom adapter.
3. Select **ADSTER.TECH** from custom network menu to **Enable** and enter the information for each placement.
```json
Example:
App ID = Leave it blank (its optional)
Placement ID = "adster_rewarded_10"
eCPM: 10 (in USD)
Custom Parameters = {"placement_id":"rewarded","yield_group_bid_price_range":"10.0-10.0"}
```
4. Contact your account manager to see what values you need to set for the **final list of production setup (Placement ID**, **Custom Parameters** and **CPM Price)**.
5. Click on “**Save**” and save the configuration.
The above setup completes our **Adster.Tech x Applovin** integration for **Rewarded Ads**. You should see an Ad like this if test setup is complete and working fine.
{% hint style="info" %}
Please note that updates to Ad Units may take approximately 30 to 60 minutes to reflect across the system.
{% endhint %}
# For Gradle Version 7+
If you’re using Gradle version 7+, update your repository section on your `settings.gradle` file, instead of `build.gradle`. Please note: The repository section should be included as part of the `dependencyResolutionManagement` section:
