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.
How to Set Up a New SSP Connection in Relevant Yield:
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.
Note: 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.
1.2 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.
Please note that 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.
Please Note:
It's important to understand how the mapping is performed in your SSP before populating data in Relevant Yield. Utilising the API is most effective when your placements have unique IDs, as this allows for more granular reporting capabilities and ensures optimal 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.
