Admob

Important:

1、As of V7.42.0, AdMob’s SDK requires publishers to add their AdMob App ID to the app’s plist. >>Details description

2、TopOn SDK v6.2.80 and above support the Admob Partner Bidding, please update the corresponding version of the SDK.

 

Step1. Create AdMob Account

(1) Login Admob official website to apply for an account

(2) Make sure whether the accont status is normal

Note : there is no need to set the payment method before your Admob's account revenue reaches the initial payment amount

 

Step2. Create Admob Apps and Ad Units

1. Add App

(1) Admob can be used to monetize for apps that are not on the AppStore or Google play. However, apps that have been removed by Google play cannot be used to monetize until the appeal is successful.

(2) create Ad Units Create the corresponding Ad Unit type based on the application Ad scenario.

 

2. Add Ad Unit

(1) Add Ad Unit (eCPM Floor)

① If you are creating an Admob Normal ad unit ID with eCPM Floor, do not check Partner Bidding

② You can set the required eCPM floor for each Admob AD unit

 

(2) Add Ad Unit (Partner bidding)

If you want to create an Admob Partner bidding ad unit ID, you need to check the partner bidding

Note: Do not use admob's official ID for integration testing, especially do not use test devices to click on admob's official ID ads, otherwise it may be mistakenly judged as fake volume and blocked (it is recommended to refer to TopOn's testing guidelines or use admob's official test ID for testing)

 

Step3. Configure Admob's Report API

(1) Configure the Admob Report API in TopOn

Admob will provide configuration information for pulling revenue data through the Report API, as follows:

Configuration Information	Description
Publisher ID	Each Admob account corresponds to a publisher ID.
Access Token	You can directly click to obtain it when filling in the report API in TopOn.

① Login TopOn (Network→admob→Edit→Reporting API 'ON')

② Click 'Login with Google Admob' and get the Publisher ID、 Access Token

③ If obtaining Access Token fails, please follow these steps:

<1> Getting access token requires that your admob account has generated data, if not, you need to select 'OFF' in TopOn's Reporting API option. And then you must come back to reconfigure it if your Admob account generate data.(Selecting "Not activated" only temporarily prevents the admob data from being pulled back to the TopOn, and will not affect the normal display of ads)

<2> If you're sure your admob account has generated data, go to your admob account and see if you've licensed Google play Android developer.(My account → security → Third-party apps with account access)

<3> If you have already authorized Google play Android developer, and the click still does not respond, please cancel the access to 'Google play Android developer' and reauthorize it.Then click 'get access token' again to retrieve the access token.

 

(2) Auto create ad sources

Admob supports the function of auto create ad source. When editing the network, you need to select "Yes" to Auto Create Ad Sources. You need to re-authorize your Google account. After logging in to your Google account, you can use the auto create function only after allowing permissions according to the authorization process.

 

Step4.Configure Admob on TopOn

1. Get Admob App ID & Ad Unit ID

The following two Admob parameters need to be configured in the TopOn to display Admob ads and Admob data through TopOn:

Parameter name	Description
APP ID	Admob unique APP ID for each APP
Ad Unit ID	Admob unique Unit ID for each Ad unit

• APP ID

Apps→App settings→App ID

• Unit ID

Apps→Ad units→Unit ID

 

2. Configure Admob parameters in TopOn

Add AD Source

Login TopOn→Network→Ad Source Setting（admob）→Add AD Source

(1) Fill in the APP ID and Unit ID of the Admob corresponding to TopOn's APP

(2) Add Admob Partner Bidding ad source in TopOn. 

Media Aspect Ratio	Description
Unkown	Default option. Admob will return: Portrait, landscape, and square aspect ratios
Any	Admob will return: Portrait, landscape, and square aspect ratios
Portrait	Admob returns only Portrait aspect ratios
Landscape	Admob returns only Landscape aspect ratios
Square	Admob only returns Square aspect ratios (close to 1:1 asset dimensions)

(5) The correspondence between AdMob ad units and TopOn ad types is as follows:

 

3. Open Estimated Price (Optional)

The new version of Admob SDK (Android 21.1.0 & iOS 9.10.0 and above) supports returning impression-level ad revenue, learn more. TopOn SDK v6.2.20 and above support the Admob SDK based on the historical impression-level ad revenue to dynamically adjust the sorting price of Admob ad sources.

(1) Enable the impression-level ad revenue in Admob

① Sign in to your AdMob account at https://apps.admob.com

② Click Settings in the sidebar.

③ Click the Account information tab.

④ Click the Impression-level ad revenue toggle to turn on this setting.

(2) Update TopOn SDK

Supported by TopOn SDK v6.2.20 and above

(3) Enable Admob estimated price in TopOn

① Enable Estimated price when adding Admob ad source

② The Admob ad source that opens the estimated price will be placed below the Bidding ad source (above the regular ad source)

If your account does not have the function of Admob's estimated price, please apply to TopOn to activate it

 

Step5. Add Admob adapter to your code

Refer to the TopOn SDK integration documentation

 

Step6. Admob Test Guide

Note: Do not use Admob's official ID test multiple times during integration testing, especially don't use test equipment to click on Admob's official ID advertisement, otherwise it may be misjudged as a fake ad request (recommended to refer to TopOn's test guidelines or use Admob's official test ID test)

1. Test Preparation

① VPN to the United States（Because the US area has more ad filling, it is easy to test. Use the US VPN to test first.)

② Google Play Store Installed on test phone.

③ Log in with a Valid Google Play Account.

 

 2. Testing with test ads

There are 3 methods below that can be used for testing. You can choose any one of them.

(1) Method One: Use TopOn Debug Mode (Recommended)

Refer to the documentation and set up the code:

• Android
• iOS

(2) Method Two: Use TopOn Debug UI (Recommended)

• Android
• iOS

(3) Method three: Add Test Devices in AdMob Backend.

• Add test devices in the AdMob backend and use official IDs for testing. Click the linkto jump >Google AdMob

 

If ads do not display, troubleshoot based on the error codes in the logs.

• iOS Error Code Explanation
• Android Error Code Explanation

After using any of the above 3 methods, if the test IDs or test mode works normally, the integration is considered normal.

 

3. After the integration is correct, use the official id test ( be careful not to request multiple times for live meta ad with your test device, it is recommended to use the test id test as much as possible )

Note: Generally speaking, as long as there are no problems with the integration (using step 2 above to test the ads), and the configuration ID is correct, it is normal for a single device to be unfilled for a short period of time. Do not request multiple times repeatedly! Repeatedly making a large number of requests with official IDs for testing can easily be judged as fake traffic by AdMob and result in a ban.

If the official ID cannot be displayed, troubleshooting steps:

(1) Check the advertising source configuration in the TopOn dashboard. First make sure that the Admob's application ID and placements ids are configured correctly in TopOn dashboard. Then check if the ad type matches correctly . For example: whether the splash in Admob matches the splash in TopOn, etc. Reference link for matching TopOn and Admob ad types.

(2) Admob dashboard checking

a. Complete AdMob Payment Setup.

b. Confirm app-ads.txt is Set: Path: Application - All Applications - app-ads.txt

c. (For accounts created a long time ago) Confirm PIN Code is Verified(Affects whether official IDs can get AdMob fill)

(3) Confirm whether you have used VPN to America to test.

(4) ①If it is an Android app, confirm that it has been launched on Google Play. Note whether you receive an application alert message in your email inbox.

②If it is an iOS app, confirm that it has beenlaunched on the Apple App Store for a while (AdMob may not detect it right after launch).

(5) Add Test Devices in AdMob Backend.

• Add test devices in the AdMob backend and use official IDs for testing. Click the linkto jump >Google AdMob

(6) Confirm Whether Ad Price is Too High for Ad Fill. --> Create an ad slot with price of 0.01. Or set an ad slot with no floor price in the Google backend.

(7)Ad Slot ID Creation Time Too Long:  Create a new AdMob ID, use a US VPN for testing (clear mobile cache, adjust time to 2 hours later). Try changing devices for testing.

Ad Slot ID Creation Time Too Short: Wait for 2 hours and then test.

(8) If the app has integrated TopOn SDK and has been launched, you can use TopOn's Advanced - Log Analysis to view the error codes for request fail and solve the corresponding problems.

• iOS Error Code Explanation
• Android Error Code Explanation

TopOn backend path: Advanced- Log Analysis, filter for the corresponding App, Placement, Network.

(9) If none of the above can locate the problem, please contact AdMob.

 

FAQ

(1) How to set up admob's app-ads.txt for your app?

If you don't set admob's app-ads.txt for your app, it may affect admob's filling or even no filling.

① Get the app-ads.txt of admob

path: log in to admob - application - all applications - app-ads.txt - how to set app-ads.txt for the application - click to copy

② Add the app-ads.txt you just copied to the root directory of your developer website (for example: sampledomain.com/app-ads.txt). Please make sure that the domain name you enter is exactly the same as the domain name listed in Google Play or App Store.