Ads by AdMob

AdMob is a component. All Thunkers can add AdMob to their projects and live test the ads in their apps. Only PRO Thunkers can download and publish apps that contain ads. To get started, join our MCM network.

1. AdMob Overview

AdMob is the most popular ad network for monetizing mobile apps today.

Apps with large audiences can use AdMob to not only generate revenue for the creator, but in some cases, create better user experiences. For example, users may prefer to watch a Rewarded Video Ad to unlock extra content than pay money to unlock extra content.

We highly recommend that you only add ads to your app after it has been completed and you have a good idea of how users will move through your app. Once your app is complete, you can go back in find natural points to add the different types of ads for your users.

2. Setup Your AdMob Account

You need an AdMob account to show ads in your project.

Once you have an AdMob account, you will need to paste the following into the AdMob section of your Project Settings:

• iOS app ID (if publishing to App Store)

• Android app ID (if publishing to Play Store)

• Tracking Usage Description (if publishing to App Store)

  • Default value: "This identifier will be used to deliver personalized ads to you."

A personalized ad is one that is tailored to the users' interests based on data collected from their web history.

A non-personalized ad is one that is 'randomly' selected to be displayed to the user and doesn't draw on any information the advertising service may have about the user.

Once you have published your app, you will also need individual Ad Unit IDs for each AdMob component in your project. To add an Ad Unit ID:

1. Click on the Apps tab in your AdMob Sidebar

2. Click View All Apps

3. Click the name of the app associated with the ad unit.

4. Click on the Add Ad Unit button

5. Select the type of ad you wish to add (Note: Thunkable only currently supports Banner, Interstitial, or Rewarded Ads).

6. Add a name for your Ad Unit (e.g. "Banner Ad")

7. Click the Create Ad Unit button.
8. In the Implementation instructions window, click the ad unit ID in the second step.

   

3. Join Thunkable's MCM Network

To download and publish Thunkable apps that contain ads, you must first be a member of Thunkable's MCM (Multiple Customer Management) network.

An invitation to this network will be sent to you the first time you submit your app for review. If you do not change AdMob accounts, this only needs to be done once, when you submit your first app for review.

By joining this network, you consent to sharing 10% of your AdMob revenue for all apps you have currently on AdMob with Thunkable to support maintenance costs.

4. Submit Your App For Review

Thunkable has partnered with AdMob to ensure that apps created on our cross-platform use ads to monetize apps in a way that both provides high quality traffic to advertisers and a high quality user experience for end users of apps.

All apps with AdMob must be first approved by Thunkable before they can be downloaded or published. AdMob has its own policies that an app must comply with, including but not limited to:

• Inappropriate content that advertisers do not want to be associated with e.g. copyrighted, adult

• Invalid activity that lowers the quality of traffic to advertisers e.g. ad placements that encourage clicks

Thunkable will review apps for compliance with AdMob policies but will specifically reject apps that are:

• Incomplete apps - apps that are still in their early stages and won't show how ads will be used in the app

• Earning apps - apps that encourage users to click ads in exchange for some form of payment

• Auto-impression apps - apps that repeatedly load banner ads in the background of apps

• Apps that show an Interstitial ad or Video ad on startup - these ads must be implemented properly in your app

Thunkable reserves the right to change an app's approval status subject to any violation of our guidelines.

If your app is rejected, the Thunkable AdMob team will send an email to the address used in your submission and you will be provided with an explanation and a recommendation for changes to make to get your app approved upon re-submission.

You are welcome to submit the same app for approval multiple times.

5. Types of Ads

Banner ad

The Banner ad is a rectangular image or text ads that occupy a spot within an app's layout.

AdMob banner ads are the simplest ad format to implement and are recommended for beginners. No blocks are needed to show your Banner ad to your end users.

The first banner ad will load when ready and will reload a new ad every minute.

There is a maximum of 1 Banner ad allowed per screen. You can show multiple banners in a single multi-screen app. You can learn more about best practices for implementing and using banners here.

Properties

AdMob Banner

Name	Description	Data Type
Ad Unit ID (Android)	Ad Unit ID for showing your ad on Android devices	Text
Ad Unit ID (iOS)	Ad Unit ID for showing your ad on iOS devices	Text
Test Mode	Toggle whether real ads or sample ads should display in your app. Set this to true while testing your own app.	True/False

Layout

Name	Description	Data Type
Y	Location of top left corner of Banner ad on Y-axis, where the top side is Y=0	Number
Visible	Set whether the Banner ad component is visible	True/False

Interstitial Ad

Interstitial ads are full-screen ads that cover the interface of their host app.

These should displayed at natural transition points in the flow of an app, eg. between activities, between levels in a game. The user can click on or close the ad.

There is a limit of one interstitial ad component per app, but you can show the ad multiple times.

To show an interstitial app, you need to first add the component and then add the Show Ad block after the appropriate event in your app.

Adding an Interstitial ad to your app

To add an Interstitial ad to your app:

1. Go to your Blocks tab

2. Click on the icon next to the Ads drawer of blocks

3. Select AdMob Interstitial

Properties

You will see a dialog where you can set the following properties:

Name	Description	Data Type
Ad Unit ID (Android)	Ad Unit ID for showing your ad on Android devices	Text
Ad Unit ID (iOS)	Ad Unit ID for showing your ad on iOS devices	Text
Test Mode	Toggle whether real ads or sample ads should display in your app. Set this to true while testing your own app.	True/False

We recommend making use of Test Mode. It allows you to download your app, and see how it behaves when you click on the ads. It is forbidden to click on actual ads being served in your own app, so this is a great way to see how your app users will experience ads. Before publishing your app, make sure Test Mode is set to false so that you show real ads to your users.

Blocks

Events

Use the when Ad Open and when Ad Close blocks to trigger events to happen when the interstitial ad opens or closes.

Functions

Use the Show Ad block to show an interstitial ad in your app. If there is an error, the error block will catch and return it.

Properties

Set and get properties of your Interstitial ad.

Ad Unit ID (Android):

Ad Unit ID (iOS):

Test Mode:

6. Rewarded Video Ad

Rewarded Video Ads are full-screen video ads that users have the option of watching in full in exchange for in-app rewards.

Rewarded video ads are recommended after a user has completed a heavy task in your app and would be willing to watch a long video to continue.

There is a limit of one rewarded video ad component per app, but you can show the ad multiple times.

To show a rewarded video app, you need to first add the component and then add the Show Ad block after the appropriate event in your app.

You'll then want to add a Reward User event to reward your user in the app. You can learn more about best practices for implementing and using Rewarded Video ads here.

Adding a Rewarded Video ad to your app

To add an Rewarded Video ad to your app:

1. Go to your Blocks tab

2. Click on the icon next to the Ads drawer of blocks

3. Select AdMob Rewarded Video

Properties

You will see a dialogue where you can set the following properties:

Name	Description	Data Type
Ad Unit ID (Android)	Ad Unit ID for showing your ad on Android devices	Text
Ad Unit ID (iOS)	Ad Unit ID for showing your ad on iOS devices	Text
Test Mode	Toggle whether real ads or sample ads should display in your app. Set this to true while testing your own app.	True/False

Blocks

Events

Use the when Ad Close block to trigger events to happen when the Rewarded Video ad closes.

Functions

Use the Show Ad block to show the ad video, and the Reward User block to reward the user after displaying the video.

Properties

Set and get properties of your Rewarded Video ad.

Ad Unit ID (Android):

Ad Unit ID (iOS):

Test Mode:

7. Live Test

For your convenience, we have provided a test Ad Unit ID for you to see how a particular ad format may appear in your app. You must change this to your own Publisher and Ad Unit ID before publishing.

During live test, all AdMob ads will be set to test mode = true, which means clicks and impressions will not be counted.

This is true even if you add your own Ad Unit ID and set test mode = false.

8. Download and Publish

Set test mode = false

To protect the integrity of your account, we have by default set test mode = true.

When you are ready activate your ads when you publish, you'll simply need to set test mode = false.

Downloading your app with test mode = false to generate more impressions/clicks for your ads is considered invalid traffic and may lead to your AdMob account being suspended or disabled.

Build Your App!

Once approved, apps can be downloaded and published without further review.

• Publish to App Store (iOS)

• Publish to Play Store (Android) with AAB

9. iOS and AdMob Permissions

With iOS 14.5 and above, your app users will be asked if they consent to an advertising identifier being used to show them personalized ads. This is what the dialog looks like:

You can set a personalized Tracking Usage Description in your Project Settings.‌ All characters in your Tracking Usage Description must be alphanumeric or an underscore [a-z A-Z 0-9 _] If this permission is declined, your app will still show ads. These will be more generic ads and won't be targeted at the user. If the user has turned off the Allow Apps to Request to Track property in their device settings, this permission will be declined by default and they will not see this dialog.

AdMob Account Suspension

Google owns and operates AdMob and has policies and restrictions for AdMob accounts. You can read about these policies and restrictions here.

Policy violations include, but are not limited to:

• showing an interstitial ad as soon as your app opens

• tricking app users into clicking on ads

• creating false ad impressions by downloading your app with ads enabled and clicking on your own ads

As well as other actions that can frustrate the user experience and/or create false AdMob impressions.

If your app/ad placement violates these policies, Google may:

• disable your app or account

• suspend your AdMob account

• delete your AdMob account

If Google suspends or disables your AdMob account, it is against policy to create a new AdMob account to circumvent the suspension.

If you believe your AdMob account has been unjustly targeted, you can ask Google to investigate using this link.

Troubleshooting

If you are not seeing ads appear in your app, it may be due to the following reasons:

• Your AdMob account has been disabled due to a policy violation. Please sign in to your AdMob account

• Your AdMob component property test mode = true. To activate, you'll need to flip the switch to test mode = false

• Your Ad Unit ID has not yet been activated. This may take up to a few hours

• You have entered the App ID or the Publisher ID instead of the Ad Unit ID which begins with ca-app-pub-xxx

• Please check the mobile device internet connectivity or disable ad blockers on the mobile device

• Check your app's Readiness Status. Only apps with a Ready status will be served ads.

• Your setup is correct. The issue is that AdMob does not always have an ad to return for every request. This may happen particularly if you have just registered your AdMob publisher ID, as it takes some time and multiple requests before the new ID starts returning ads

• Check the community forum for other potential errors

Adding error handling to your AdMob blocks can better help troubleshoot issues

If you use Google AdMob in your app and have end users in the UK and EEA (EU countries + Iceland, Liechtenstein, and Norway), there are important new requirements around consent management for AdMob.

Beginning January 16th, 2024, Google will require all publishers serving ads to EEA and UK end users to use a Google-Certified Consent Management Platform (CMP). Thunkable has made the necessary changes to our AdMob implementation so that every app using AdMob will be compliant with this consent management, but you must publish an update for your app on Google Play and App Store for these changes to take effect.

Beginning January 16, 2024, if you do not adopt a Google-Certified CMP, no ads will be eligible to serve on EEA and UK traffic. Learn more about this update and how it impacts you in this community post: Google AdMob Update.

Have feedback on this doc? Please take a moment to share your feedback here: Thunkable Docs Feedback. Your valuable insights will help us improve and better serve you in the future.