A rotator changes the ad shown in a website placement based on a set of ads. Rotators can include different types of ads, including videos. Depending on the type of rotator, instead of just changing the shown ad, the rotator can change a ad's positioning within the placement.
With the Rotators API, you can create and delete rotators, retrieve a rotator by its unique ID, set rotator's title, set or remove a backup banner, activate or deactivate a rotator, and manage members by adjusting their sequence and settings, as well as setting or deleting their banners.
When you create rotators, you can use them in your campaigns to display personalized content by automatically rotating ads based on user preferences, behaviors, or geolocation, which reduces the need for manual updates.
Note
When setting up targeting for rotators, follow targeting guidelines to make sure you reach the right audience.
With Rotators API, you can create several types of rotators:
-
Random Rotators: Shows ads in random order.
-
Sequential Rotators: Shows ads in an assigned order based on your defined KPIs.
-
AB Rotators: Shows individual random ads from two (2) groups of ads based on impressions. If evenly distributed among the campaign impressions, you can run A/B tests to compare the performance.
-
Optimized Rotators: Shows ads based on your defined KPIs (such as CTR or Conversion) to optimize which ads get shown. After gathering data, the best ad in the rotation generates the most impressions.
To start working with the Rotators API, you need:
-
Adform DSP or Ad Server user account that has these permissions assigned:
-
Manage Assets & Banners
-
-
The following scopes assigned to your OAuth client by Adform Support (technical@adform.com):
-
https://api.adform.com/scope/eapi: Grants full access to all endpoints of the Rotators API.
-
-
The following IDs to use in your requests:
Note
Additional IDs might be used, but the listed ones are required to pass a request.
Note
If you don't have an OAuth client yet, follow the procedure in Get Authentication Credentials for Adform APIs to register one.