Get personalized optimization tips, understand your account health and set up completion on the improved "My AdMob page".


Set up a custom event

Custom events let you set up waterfall mediation for an ad source that isn't a supported ad source. First, you'll need to implement a custom event adapter for the ad source you want to integrate. Use the instructions for Android or iOS

Then, add the custom event in your mediation group using the following steps: 

Note: You can only set up a custom event once. To use multiple custom events, you can add additional mappings to the custom event. 
  1. Sign in to your AdMob account at
  2. Click Mediation in the sidebar.
  3. Click the Waterfall sources tab. 
  4. Click Set up ad source
  5. Click Add custom event
  6. Click Add mapping. To include multiple custom events, you’ll need to set up additional mappings.
  7. Add the mapping details, including a mapping name. Enter a class name (required) and a parameter (optional) for each ad unit. Typically, the optional parameter contains an identifier that will be used by the custom event to load ads.
    Note: If your class is implemented in Swift, you need to prefix the class name with the name of its app/framework module (for example, appName.className).
  8. Click Save.
  9. Use the Google Developers guide for Android or iOS to implement your custom events in your app. Make sure to use the same name, classes, and parameters you used to create it in AdMob. If you don't complete this step, your custom events won't be able to fill incoming ad requests.

Add you custom event to a mediation group

After you’ve finished setting up your custom event, you’re ready to add it to a mediation group. Learn how to create a new mediation group or follow the instructions below to add your ad source to an existing mediation group:

  1. Sign in to your AdMob account at
  2. Click Mediation in the sidebar.
  3. In the Mediation group tab, click the name of the mediation group to which you're adding the ad source. 
  4. In the Waterfall ad sources table, click Add custom event
  5. Enter a descriptive label for the event. 
  6. Enter a manual eCPM to use for this custom event. The eCPM will be used to dynamically position the event in the mediation waterfall where it will compete with other ad sources to fill ad requests.
  7. Click Continue.
  8. Select an existing mapping to use for this custom event or click Add mapping to set up a new mapping. To use multiple custom events, you’ll have to create an additional mapping for each custom event.
  9. Click Done.
  10. Click Save. The mediation group will be saved.
Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue

‘My AdMob Help Page’ - your personalized Help Page to help you thrive on AdMob.

Introducing our newly revamped My AdMob Page,  a personalized Help page that houses relevant information for your account.

You can better maintain your account health, ensure necessary setup is completed and have the right optimization tips targeted to your apps. Stay tuned for more!

Learn more

Clear search
Close search
Google apps
Main menu
Search Help Center