Documentation

Integration guide, SDK, and API reference to get you started.

Getting Started

Welcome to the Adsoivo Publisher API documentation. Our platform enables you to monetize your web traffic by mediating between top-tier ad networks via a single, lightweight SDK.

By integrating Adsoivo, you automatically benefit from our Smart Mediation Engine, which selects the highest-bidding ad for every user visit, ensuring maximum revenue (eCPM) and 100% fill rates.

Prerequisites

Before you begin the integration, please ensure you have the following:

An active Adsoivo Publisher Account
A verified website or mobile app added to your dashboard
Access to your website's HTML source code to insert the script tag

Authentication & API Keys

Adsoivo uses a unique app_uid to identify your property and track earnings. This ID is public and safe to use in client-side code.

Where to find your App ID:
Navigate to Publisher Dashboard → Sites → Settings. Copy the string starting with PUB- (e.g., PUB-882190).

1

Import SDK

To start serving ads, add the Adsoivo JavaScript library to your website. Place the following code snippet inside the <head> tag or just before the closing </body> tag.

This script loads asynchronously and will not affect your website's loading speed.

<!-- Load Adsoivo SDK -->
<script src="https://adsovio.com/cdn/ads.js?app_uid=YOUR_APP_ID"></script>

2

Initialize & Show Ad

Once the SDK is loaded, you can trigger ads using the window.showAdsovio() method. This is typically called on a button click, page load, or after a specific user action.

// Trigger the ad unit
window.showAdsovio({
  then: () => {
    // Callback: Ad loaded successfully and user closed it.
    // You can grant a reward or redirect the user here.
    console.log("Ad completed");
  },
  onError: (error) => {
    // Callback: Ad failed to load (e.g. Network Error).
    // Fallback logic goes here.
    console.error(error);
  }
});

Parameters Reference

Property	Type	Description
`then`	Function	Executed when the ad is successfully displayed and closed by the user. Ideal for "Rewarded" ad flows.
`onError`	Function	Executed if the ad fails to load due to ad-blockers, network issues, or inventory shortage.

Need Integration Help?

Our dedicated manager is available 24/7 to assist with your setup.

Chat with Manager