The primary SDK is the SDK that makes the first call and which is fully integrated and configured in the app. Usually, the primary SDK is the primary ad server of the publisher, which controls the campaign priority.
Adapter Overview
VIS.X® SDK allows the mediation of banners and interstitials for selected partners, as listed below. All adapters are open source and available via our [git repository]https://github.com/yoc-ag/visx-sdk-open-mediation) for both platforms.
This will allow you to review the code and adjust it to your use case if needed.
Integration Guide for Adapter
Building the mediation requires some pre-planning and joint work between you and YOC to implement the setup in all involved systems. The following are the most important steps for a successful implementation.
1. Tell us your plans
Reach out to your YOC Account Manager, to briefly discuss your integration scenario. We want to understand which partners you are using, the order within the waterfall and what your overall monetization strategy is. If needed you Account Manager can give you additional consultancy on how to set up a good strategy from scratch.
2. Plan your waterfall
For each VIS.X® Ad Unit, we can set up your own mediation rule for you. This will include the type of creative (banner, interstitial), the partner used and if more than one partner should be used, the order in which they should be called as a fallback. Make sure you have set up the ad units from the used partner(s) already and that you have a mapping between the VIS.X® Ad Unit and the backfill network(s). Once done, share the information with your YOC Account Manager and we will set up the waterfall on our platform.
If required, we can provide you with a spreadsheet template for collecting all information.
3. Integrate mediation adapter(s) of choice
Go to your git repository for Android or iOS select the partner of choice. Grab the files needed and import them to your project.
In Android Studio adapter files must be included in the package com.yoc.visx.sdk.adapter.*
In Xcode, simply add the *.swift files (banner and interstitial have their own files) to your Xcode Project.
4. Follow the partners guide for mediation setup
Each partner has an individual guide on how to set up the SDK as secondary. In most cases, adding the dependency of the SDK into your project would be enough, but please check with your partner for the necessary steps.
5. Test your setup and go live
Once you have added all SDK to your project, configured the VIS.X® SDK and YOC has made the mediation set up for you on our end, you can test the waterfall. Just add a test line item to each of the partners’ ad units and make a couple of ad calls in the app. Is every partner called correctly? Do the creatives look good? If yes, you are finished with the setup.