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


Add a custom event

You can allocate traffic to custom events just as you would to ad networks, and the custom events will fill ad requests from your users. However, custom events don't call an ad network's SDK for an ad. Instead, they call custom code in your app. You name the event and define the classes and parameters in your app code, then map them to the custom event and ad units in a mediation group.

Complete the following steps to create a new custom event:

  1. Sign in to your AdMob account at
  2. Click Mediation in the sidebar.
  3. Click the name of the mediation group. 
  4. Click Add custom event in the Waterfall ad sources table.
  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 chain where it will compete with other ad sources to fill ad requests.
  7. Click Continue.
  8. 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).

  9. Click Done.
  10. Click Save. The mediation group will be saved.
  11. If you haven't already implemented the custom event in your app's code, do so now using the same name, classes, and parameters you used to create it in AdMob.


Don't forget to use the Google Developers guide to implement your custom events in your app. If you don't complete this step, your custom events won't be able to fill incoming ad requests.

Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue

Clear search
Close search
Google apps
Main menu
Search Help Center