Setting Up a New SSP Connection with API

Connect a new SSP through API by creating API access, adding credentials, importing data, and mapping incoming placements in Relevant Yield.

Relevant Yield gathers data from API sources daily. Depending on your geographical location, there may be slight variations throughout the day, but our goal is to consistently provide fresh data for your work sessions.

This article is about API connections. You should always use the API if possible. However, if for some reason the SSP doesn't provide an API connection, you may consider the CSV import option described in this article: Set Up a New SSP Connection Through a Scheduled Daily CSV File.

1

Create an API User in Your SSP

Your Relevant Digital Technical Account Manager will supply you with a dev_[customer name]@relevant-digital.com email address. You'll need this address to establish a new API user within the SSP.

The API user may differ from a standard user, depending on the SSP.

The primary concern is ensuring that the user has access to the SSP's API features.

You may need to provide details regarding the frequency of API calls, which typically average around five calls per day. Fortunately, most SSPs/ad servers do not impose additional charges for API access, simplifying the process of obtaining it.

Integrating Magnite API

We have established a Preferred Data partnership with Magnite, allowing us to add Magnite API support for all our API Insight customers. This partnership ensures better and more stable data collection for you.

We remain 100% SSP and ad server independent. This partnership simply enables us to provide you with API access to Magnite.

If you are currently using CSV imports for Magnite, we can assist you in transitioning to API access as part of our partnership. This means you do not need to broker your own API agreement with Magnite; all arrangements can be managed through us.

How to Get Started

To initiate the integration of Magnite API access, please contact your Technical Account Manager or our support team. They will provide the necessary guidance and assistance throughout the setup process.

2

Add a New SSP Connection in Relevant Yield

To add a new SSP connection, go to Configuration > Integrations and click " + New SSP".

3

Fill in the Required Fields

In the settings pop-up, you'll need to specify the type (which SSP) and a name for the connection. Additionally, you can define how you wish to manage the imported data (assign a percentage to specific buying/selling ad inventory for that SSP).

If you have any questions regarding the settings, please don't hesitate to reach out to our support team.

It's important to note that the settings may vary depending on the SSP.

Understand how mapping works in your SSP before you populate data in Relevant Yield. The API works best when your placements have unique IDs, because this enables more granular reporting and better performance.

4

Add SSP API Credentials

You will enter the credentials (the newly created API user from your SSP) at the bottom of the settings pop-up.

The required credentials vary depending on the SSP. In some cases, only the API user email and password from the SSP UI are needed, while in others, the credentials may include a consumer secret and consumer key. If you're uncertain, please reach out to your Technical Account Manager for additional guidance and support.

5

Populate Data

After adding your credentials, the system will populate with data, which becomes visible when generating a new API report. Data may populate automatically, typically by the following day. Alternatively, you can manually initiate an import, ensuring to import one day at a time to prevent overloading the system.

6

Find the "Not Yet Mapped" API Structure

Once you can see data coming in, you can use the Admin -> Missing SSP Traffic section to view the names of the sites/placements that have been imported. From there, you can proceed to map the new SSP IDs to the corresponding websites.