API Reference

Helium Bidding

The integration between Chartboost Helium Mediation and Verve HyBid SDK supports both bidding and waterfall mediation, providing developers with a powerful solution to manage and optimize ad inventory. This ensures high fill rates and maximizes revenue. The following ad formats are supported through Verve's integration with Chartboost Helium:

  • Banner Ads: Display ads in a banner format at various positions within your app.
  • MRECT Ads: Medium rectangle ads that offer a larger canvas for advertisers.
  • Interstitial Ads: Full-screen ads that appear at natural transition points in your app.
  • Rewarded Video Ads: Video ads that provide in-app rewards to users for watching them.

Integration

Step 1: Create a Verve Publisher Account
To access Verve ad inventory through Chartboost Helium Mediation, you need an approved Verve account. If you do not already have an account, contact Verve for instructions on how to register and obtain approval.

Step 2: Activate Your Account
After successfully registering, Verve will send you an activation email. Upon activating your account, you will receive essential integration information, including:

  • Account Token (mandatory)
  • App Token (mandatory)
  • App-ads.txt List
  • SKAdNetwork ID (for iOS apps)

Note: Do not create anything on the APPS page. Your account manager will assist you with the app creation process.

Step 3: Enable Verve in Your Chartboost Helium Account

  1. Log in to your Chartboost Helium Account:
  • Access the Chartboost Dashboard.
    Create an app (if you don’t already have one):
  1. Navigate to the "Apps" section in the Chartboost Dashboard.
    • Click on "Add App" and enter the required details.
    • Set up the Verve Bidding Network
  2. Go to the "Helium" tab in the Chartboost Dashboard:
    • Click on "Network Setup" and select "Verve" from the list of available networks.
    • Enter the Account Token and App Token you received from Verve.
  3. Configure Placements:
  • After Verve is added as one of the mediation networks, enable Verve Bidding on all your ad placements.
    Finalize Integration:
  1. Review and save your settings.
    • Ensure the Verve SDK is included in your app's build according to Chartboost’s integration guidelines.

Step 4: Additional Configuration (Optional)

  1. App-ads.txt Implementation:
  • To ensure proper ad serving and compliance with IAB standards, include the provided app-ads.txt list on your domain.
  1. SKAdNetwork ID Setup (for iOS apps):
  • Include the SKAdNetwork ID provided by Verve in your app’s Info.plist file to ensure accurate attribution and tracking.

Step 5: Test and Go Live

  1. Test Integration:
  • Before launching, test the integration to confirm that Verve ads are served correctly in your app.
    Use test devices and review logs to ensure that bidding and waterfall mediation function as expected.
  1. Go Live:
  • After successful testing, your integration with Verve Bidding via Chartboost Helium Mediation is complete.
    Monitor ad performance through the Chartboost and Verve dashboards to optimize and adjust your ad strategies as needed.