...
Available with Version:
External Systems | FreeWheel |
Role | System Administrator; Order Manager - Fulfilment; |
ADvendio Edition
Connect
External Systems
FreeWheel
Challenge
You are using AdButler FreeWheel as an AdServer ad server and are looking want to connect it to ADvendio to FreeWheel. Which What features of ADvendio are part of supported in the FreeWheel integration and which features of FreeWheel are supported?
...
Solution
ADvendio Features part of the FreeWheel IntegrationPlease find which FreeWheel features are supported:
...
Geo Targets (Available with version 2.154)
...
Platform Targets (Available with version 2.154)
...
Placements / Fixed Delivery
...
Configured via Ad Type
...
Placements / Auctions
...
Configured via Ad Type
...
Placements / Frequency Capping / Activity Limits
...
...
AdButler currently only supports capping per Day
...
Placements / Priority
...
Configured via Ad Type
...
Ad Items
...
Currently fixed settings created by ADvendio
...
We will create dummy AdItems which later have to be adjusted in AdButler to upload the right creatives and formats
Current Limitations for the ADvendio - AdButler Integration
| Info |
|---|
Please note that due varying capabilities of integrated systems or bigger differences in the structure, some ADvendio features might have some limitations. |
Inventory Targeting of multiple Zones
Zones in AdButler represent the placement of your ad on a website. Typically these Zones represent a single ad space and creative size.
As with the structure of AdButler, the booking relevant information (like start and end date, the desired number of impressions, and the priority) is defined on a Zone Assignment, where you select a single Zone. If you want to target multiple Zones, you will have to use a Channel. These channels need to be set up in AdButler and can then be imported to ADvendio.
...
| Note |
|---|
ADvendio Campaign Items do not support the selection of multiple Zones (as seen in the screenshot above) or the selection of multiple Channels. If you select those we can not guarantee that the right booking will arrive in AdButler. Please use a Channel instead if you want to target rotations. |
Check Availability
Currently, the API of AdButler only supports availability checks based on Zones. If your ADvendio Campaign Item should include Channels or VAST Zones instead, the Check Availability feature might return an error message similar to this:
...
This is a limitation by the API of AdButler, please contact your AdButler Account Manager if you are interested in these capabilities.
Geo / Device Targeting
| Info |
|---|
Documentation on the Geo and Platform Target Capabilities of AdButler will follow soon! |
Currently Planned enhancements for the AdButler Integration:
Usage of Geo Targets and Platform Targets for Campaign Items (ETA: April 2022)
Check Availability (Scheduled for Q2 2022)
Creative Upload (currently in our backlog, if you are interested please contact your technical account manager or our customer success team)
...
ADvendio Feature | Documentation | Additional Comment |
|---|
Booking of |
Campaigns, Insertion Orders and Placements |
Check Availability
| Note |
|---|
Check Availability is currently only supported when using single Zones in AdButler, find more information in the limitations section below |
See contending bookings during the Availability Check
Contending Ads Reporting shows list of Campaigns booked in AdButler, which are on the same inventory (Zone ID) with the same time frames of the bookings.
Manage Advertisers and Agencies | ||||
Targeting:
|
On how to do Manual import of Geo data and Manually import Platform Targeting, Import Key Values / Audience Segments, Import Industries, Import Brands or Enhanced Video Import, please check FreeWheel Description and Import Types *Mandatory option for the advertising format and must be selected, at least one ad unit and site related | |||
Availability Check
|
| |||
Delivery Data Reports (Monthly, Daily) |
Configuration instruction in | - |
Enhanced Delivery Reports | How to configure Delivery Data Imports from FreeWheel to ADvendio |
Sitebased Delivery Data will be grouped by Zones / VAST Zones from AdButler
Transfer to ADvendio
AdButler features supported
...
AdButler Feature
...
How to use it?
...
Additional Comment
...
Standard Campaigns
...
Configured via Ad Type
...
VAST Campaigns
...
Configured via Ad Type
...
Placements / Target Zones
...
4.3.4.5 How to configure which inventory to targeting in External Systems?
...
Due to AdButler settings, only a single Zone can be assigned to each ADvendio Campaign Item, please use Channels if you want to configure rotation
...
Placements / Target Channels
...
4.3.4.5 How to configure which inventory to targeting in External Systems?
Only for delivery imports grouped by: Sites and Video Groups | ||
Update Status (import current status from Freewheel + pushing campaigns live from ADvendio) | Import current status from Freewheel and pushing campaigns live from ADvendio | |
Limited Time Zone support | version 2.99 and up | |
Transfer Offer number and External ID |
Freewheel features currently supported by ADvendio:
Freewheel Feature | How to Use it? | Additional Comments | ||
|---|---|---|---|---|
Booking of Campaigns, Insertion Orders and Placements | ||||
Setting a Placement Status | 7.3.4 How to Configure "Update Ad-Status in AdServer" for Campaign Items | |||
Setting an Insertion Order Stage | ||||
Setting an Insertion Order Brand | ||||
On the fly availability check for not existing bookings | Used by our Check Availability feature |
| ||
Combined Use of Inventory and Video Targeting | Via the ADvendio Inventory and Video Targeting feature |
| ||
Audience Targeting, with full logical operator support | ||||
Custom Targeting | ||||
Exclusivity settings for Placements | ||||
Selecting Industries for Placements | ||||
Ad Unit linking | ||||
Custom Event Targets for your Placements | version 2.119 and up | |||
Freewheel Forecast Modes (e.g. AI supported forecasting) | How to configure the Forecast Mode used for Check Availability by Freewheel |
Current Limitations for the ADvendio - FreeWheel Integration
Flexible Insertion Order and Campaign settings
Currently, Campaigns and Insertion Orders are created and fixed from ADvendio. Each Media Campaign will typically represent one Campaign AND Insertion Order. It is not possible to use the same Freewheel Campaign across multiple ADvendio Media Campaigns.
Also, most additional settings are fixed on the Campaigns and Insertion Orders, it is not possible for example to set a specific Insertion Order Budget from ADvendio.
Limited Time Zone Support (Version 2.99 and up)
| Info |
|---|
If your time zone is not mapped in this list ADvendio will show the following warning: "Was not able to map timezone: + TimeZoneId" when you try to "Check Availability" or "Submit to Adserver". Please choose a different time zone. |
When submitting a media campaign and campaign items to FreeWheel the interface currently only supports the following time zones:
Standard Time Zones Worldwide | GMT | GMT Diff | FreeWheel ID |
|---|---|---|---|
(GMT+00:00) Africa/Casablanca | GMT+00:00 | 0 | (GMT+00:00) Africa - Casablanca |
(GMT+00:00) Etc/GMT | GMT+00:00 | 0 | (GMT+00:00) Etc - GMT |
(GMT+00:00) Etc/GMT0 | GMT+00:00 | 0 | (GMT+00:00) Etc - GMT |
(GMT+00:00) Etc/GMT+0 | GMT+00:00 | 0 | (GMT+00:00) Etc - GMT |
(GMT+00:00) Etc/GMT-0 | GMT+00:00 | 0 | (GMT+00:00) Etc - GMT |
(GMT+00:00) Etc/Greenwich | GMT+00:00 | 0 | (GMT+00:00) Etc - GMT |
(GMT+00:00) Etc/UCT | GMT+00:00 | 0 | (GMT+00:00) Etc - GMT |
(GMT+00:00) Etc/Universal | GMT+00:00 | 0 | (GMT+00:00) Etc - GMT |
(GMT+00:00) Etc/UTC | GMT+00:00 | 0 | (GMT+00:00) Etc - GMT |
(GMT+00:00) Etc/Zulu | GMT+00:00 | 0 | (GMT+00:00) Etc - GMT |
(GMT+00:00) Europe/London | GMT+00:00 | 0 | (GMT+00:00) Europe - London |
(GMT+00:00) GB | GMT+00:00 | 0 | (GMT+00:00) Europe - London |
(GMT+00:00) GB-Eire | GMT+00:00 | 0 | (GMT+00:00) Europe - London |
(GMT+00:00) GMT | GMT+00:00 | 0 | (GMT+00:00) Europe - London |
(GMT+00:00) GMT0 | GMT+00:00 | 0 | (GMT+00:00) Europe - London |
(GMT+00:00) Greenwich | GMT+00:00 | 0 | (GMT+00:00) Europe - London |
(GMT+01:00) Africa/Algiers | GMT+01:00 | 1 | (GMT+01:00) Africa - Algiers |
(GMT+01:00) Africa/Windhoek | GMT+01:00 | 1 | (GMT+01:00) Africa - Windhoek |
(GMT+01:00) Europe/Amsterdam | GMT+01:00 | 1 | (GMT+01:00) Europe - Amsterdam |
(GMT+01:00) Europe/Belgrade | GMT+01:00 | 1 | (GMT+01:00) Europe - Belgrade |
(GMT+01:00) Europe/Berlin | GMT+01:00 | 1 | (GMT+01:00) Europe - Brussels |
(GMT+01:00) Europe/Sarajevo | GMT+01:00 | 1 | (GMT+01:00) Europe - Sarajevo |
(GMT+02:00) Africa/Cairo | GMT+02:00 | 2 | (GMT+02:00) Africa - Cairo |
(GMT+02:00) Africa/Harare | GMT+02:00 | 2 | (GMT+02:00) Africa - Harare |
(GMT+02:00) Asia/Amman | GMT+02:00 | 2 | (GMT+02:00) Asia - Amman |
(GMT+02:00) Asia/Beirut | GMT+02:00 | 2 | (GMT+02:00) Asia - Beirut |
(GMT+02:00) Asia/Jerusalem | GMT+02:00 | 2 | (GMT+02:00) Asia - Jerusalem |
(GMT+02:00) Europe/Athens | GMT+02:00 | 2 | (GMT+02:00) Europe - Athens |
(GMT+02:00) Europe/Helsinki | GMT+02:00 | 2 | (GMT+02:00) Europe - Helsinki |
(GMT+02:00) Europe/Kaliningrad | GMT+02:00 | 2 | (GMT+02:00) Europe - Minsk |
(GMT+02:00) Europe/Kiev | GMT+02:00 | 2 | (GMT+02:00) Europe - Minsk |
(GMT+02:00) Europe/Mariehamn | GMT+02:00 | 2 | (GMT+02:00) Europe - Minsk |
(GMT+02:00) Europe/Nicosia | GMT+02:00 | 2 | (GMT+02:00) Europe - Minsk |
(GMT+02:00) Europe/Riga | GMT+02:00 | 2 | (GMT+02:00) Europe - Minsk |
(GMT+02:00) Europe/Sofia | GMT+02:00 | 2 | (GMT+02:00) Europe - Minsk |
(GMT+02:00) Europe/Tallinn | GMT+02:00 | 2 | (GMT+02:00) Europe - Minsk |
(GMT+02:00) Europe/Tiraspol | GMT+02:00 | 2 | (GMT+02:00) Europe - Minsk |
(GMT+02:00) Europe/Uzhgorod | GMT+02:00 | 2 | (GMT+02:00) Europe - Minsk |
(GMT+02:00) Europe/Vilnius | GMT+02:00 | 2 | (GMT+02:00) Europe - Minsk |
(GMT+02:00) Europe/Zaporozhye | GMT+02:00 | 2 | (GMT+02:00) Europe - Minsk |
(GMT+02:00) Israel | GMT+02:00 | 2 | (GMT+02:00) Asia - Jerusalem |
(GMT+03:00) Africa/Nairobi | GMT+03:00 | 3 | (GMT+03:00) Africa - Nairobi |
(GMT+03:00) Asia/Baghdad | GMT+03:00 | 3 | (GMT+03:00) Asia - Baghdad |
(GMT+03:00) Asia/Kuwait | GMT+03:00 | 3 | (GMT+03:00) Asia - Kuwait |
(GMT+03:00) Europe/Minsk | GMT+03:00 | 3 | (GMT+02:00) Europe - Minsk |
(GMT+03:00) Europe/Moscow | GMT+03:00 | 3 | (GMT+03:00) Europe - Moscow |
(GMT+04:00) Asia/Baku | GMT+04:00 | 4 | (GMT+04:00) Asia - Baku |
(GMT+04:00) Asia/Muscat | GMT+04:00 | 4 | (GMT+04:00) Asia - Muscat |
(GMT+04:00) Asia/Tbilisi | GMT+04:00 | 4 | (GMT+04:00) Asia - Tbilisi |
(GMT+04:00) Asia/Yerevan | GMT+04:00 | 4 | (GMT+04:00) Asia - Yerevan |
(GMT+05:00) Asia/Karachi | GMT+05:00 | 5 | (GMT+05:00) Asia - Karachi |
(GMT+05:00) Asia/Yekaterinburg | GMT+05:00 | 5 | (GMT+05:00) Asia - Yekaterinburg |
(GMT+05:30) Asia/Kolkata | GMT+05:30 | 5 | (GMT+05:30) Asia - Kolkata |
(GMT+06:00) Asia/Almaty | GMT+06:00 | 6 | (GMT+06:00) Asia - Almaty |
(GMT+06:00) Asia/Dhaka | GMT+06:00 | 6 | (GMT+06:00) Asia - Dhaka |
(GMT+07:00) Asia/Bangkok | GMT+07:00 | 7 | (GMT+07:00) Asia - Bangkok |
(GMT+07:00) Asia/Krasnoyarsk | GMT+07:00 | 7 | (GMT+07:00) Asia - Krasnoyarsk |
(GMT+08:00) Asia/Irkutsk | GMT+08:00 | 8 | (GMT+08:00) Asia - Irkutsk |
(GMT+08:00) Asia/Kuala_Lumpur | GMT+08:00 | 8 | (GMT+08:00) Asia - Kuala Lumpur |
(GMT+08:00) Asia/Shanghai | GMT+08:00 | 8 | (GMT+08:00) Asia - Shanghai |
(GMT+08:00) Asia/Taipei | GMT+08:00 | 8 | (GMT+08:00) Asia - Taipei |
(GMT+08:00) Australia/Perth | GMT+08:00 | 8 | (GMT+08:00) Australia - Perth |
(GMT+09:00) Asia/Seoul | GMT+09:00 | 9 | (GMT+09:00) Asia - Seoul |
(GMT+09:00) Asia/Tokyo | GMT+09:00 | 9 | (GMT+09:00) Asia - Tokyo |
(GMT+09:00) Asia/Yakutsk | GMT+09:00 | 9 | (GMT+09:00) Asia - Yakutsk |
(GMT+10:00) Asia/Vladivostok | GMT+10:00 | 10 | (GMT+10:00) Asia - Vladivostok |
(GMT+10:00) Australia/Brisbane | GMT+10:00 | 10 | (GMT+10:00) Australia - Brisbane |
(GMT+10:00) Australia/Hobart | GMT+10:00 | 10 | (GMT+10:00) Australia - Hobart |
(GMT+10:00) Australia/Melbourne | GMT+10:00 | 10 | (GMT+10:00) Australia - Melbourne |
(GMT+10:00) Pacific/Port_Moresby | GMT+10:00 | 10 | (GMT+10:00) Pacific - Port Moresby |
(GMT+11:00) Asia/Magadan | GMT+11:00 | 11 | (GMT+11:00) Asia - Magadan |
(GMT+12:00) Pacific/Auckland | GMT+12:00 | 12 | (GMT+12:00) Pacific - Auckland |
(GMT+12:00) Pacific/Fiji | GMT+12:00 | 12 | (GMT+12:00) Pacific - Fiji |
(GMT+13:00) Pacific/Tongatapu | GMT+13:00 | 13 | (GMT+13:00) Pacific - Tongatapu |
(GMT-01:00) Atlantic/Azores | GMT-01:00 | -1 | (GMT-01:00) Atlantic - Azores |
(GMT-01:00) Atlantic/Cape_Verde | GMT-01:00 | -1 | (GMT-01:00) Atlantic - Cape Verde |
(GMT-02:00) America/Noronha | GMT-02:00 | -2 | (GMT-02:00) Atlantic - South Georgia |
(GMT-02:00) Atlantic/South_Georgia | GMT-02:00 | -2 | (GMT-02:00) Atlantic - South Georgia |
(GMT-02:00) Brazil/DeNoronha | GMT-02:00 | -2 | (GMT-02:00) Atlantic - South Georgia |
(GMT-02:00) Etc/GMT+2 | GMT-02:00 | -2 | (GMT-02:00) Atlantic - South Georgia |
(GMT-03:00) America/Argentina/Buenos_Aires | GMT-03:00 | -3 | (GMT-03:00) America - Buenos Aires, Argentina |
(GMT-03:00) America/Godthab | GMT-03:00 | -3 | (GMT-03:00) America - Godthab |
(GMT-03:00) America/Montevideo | GMT-03:00 | -3 | (GMT-03:00) America - Montevideo |
(GMT-04:00) America/Halifax | GMT-04:00 | -4 | (GMT-04:00) America - Halifax |
(GMT-04:00) America/Manaus | GMT-04:00 | -4 | (GMT-04:00) America - Manaus |
(GMT-04:00) America/Santiago | GMT-04:00 | -4 | (GMT-04:00) America - Santiago |
(GMT-05:00) America/Bogota | GMT-05:00 | -5 | (GMT-05:00) America - Bogota |
(GMT-05:00) America/Indiana/Indianapolis | GMT-05:00 | -5 | (GMT-05:00) America - Indianapolis, Indiana |
(GMT-05:00) America/New_York | GMT-05:00 | -5 | (GMT-05:00) America - New York |
(GMT-06:00) America/Chicago | GMT-06:00 | -6 | (GMT-06:00) America - Chicago |
(GMT-06:00) America/Mexico_City | GMT-06:00 | -6 | (GMT-06:00) America - Mexico City |
(GMT-06:00) America/Regina | GMT-06:00 | -6 | (GMT-06:00) America - Regina |
(GMT-07:00) America/Chihuahua | GMT-07:00 | -7 | (GMT-07:00) America - Chihuahua |
(GMT-07:00) America/Denver | GMT-07:00 | -7 | (GMT-07:00) America - Denver |
(GMT-07:00) America/Phoenix | GMT-07:00 | -7 | (GMT-07:00) America - Phoenix |
(GMT-08:00) America/Los_Angeles | GMT-08:00 | -8 | (GMT-08:00) America - Los Angeles |
(GMT-08:00) America/Tijuana | GMT-08:00 | -8 | (GMT-08:00) America - Tijuana |
(GMT-09:00) America/Anchorage | GMT-09:00 | -9 | (GMT-09:00) America - Juneau |
(GMT-09:00) America/Juneau | GMT-09:00 | -9 | (GMT-09:00) America - Juneau |
(GMT-09:00) America/Metlakatla | GMT-09:00 | -9 | (GMT-09:00) America - Juneau |
(GMT-09:00) America/Nome | GMT-09:00 | -9 | (GMT-09:00) America - Juneau |
(GMT-09:00) America/Sitka | GMT-09:00 | -9 | (GMT-09:00) America - Juneau |
(GMT-09:00) America/Yakutat | GMT-09:00 | -9 | (GMT-09:00) America - Juneau |
(GMT-09:00) AST | GMT-09:00 | -9 | (GMT-09:00) America - Juneau |
(GMT-09:00) Etc/GMT+9 | GMT-09:00 | -9 | (GMT-09:00) America - Juneau |
(GMT-09:00) Pacific/Gambier | GMT-09:00 | -9 | (GMT-09:00) America - Juneau |
(GMT-09:00) Pacific/Marquesas | GMT-09:00 | -9 | (GMT-09:00) America - Juneau |
(GMT-09:00) SystemV/YST9 | GMT-09:00 | -9 | (GMT-09:00) America - Juneau |
(GMT-09:00) SystemV/YST9YDT | GMT-09:00 | -9 | (GMT-09:00) America - Juneau |
(GMT-09:00) US/Alaska | GMT-09:00 | -9 | (GMT-09:00) America - Juneau |
(GMT-10:00) America/Adak | GMT-10:00 | -10 | (GMT-10:00) Pacific - Honolulu |
(GMT-10:00) America/Atka | GMT-10:00 | -10 | (GMT-10:00) Pacific - Honolulu |
(GMT-10:00) Etc/GMT+10 | GMT-10:00 | -10 | (GMT-10:00) Pacific - Honolulu |
(GMT-10:00) HST | GMT-10:00 | -10 | (GMT-10:00) Pacific - Honolulu |
(GMT-10:00) Pacific/Honolulu | GMT-10:00 | -10 | (GMT-10:00) Pacific - Honolulu |
(GMT-10:00) Pacific/Johnston | GMT-10:00 | -10 | (GMT-10:00) Pacific - Honolulu |
(GMT-10:00) Pacific/Rarotonga | GMT-10:00 | -10 | (GMT-10:00) Pacific - Honolulu |
(GMT-10:00) Pacific/Tahiti | GMT-10:00 | -10 | (GMT-10:00) Pacific - Honolulu |
(GMT-10:00) SystemV/HST10 | GMT-10:00 | -10 | (GMT-10:00) Pacific - Honolulu |
(GMT-10:00) US/Aleutian | GMT-10:00 | -10 | (GMT-10:00) Pacific - Honolulu |
(GMT-10:00) US/Hawaii | GMT-10:00 | -10 | (GMT-10:00) Pacific - Honolulu |
(GMT-11:00) Etc/GMT+11 | GMT-11:00 | -11 | (GMT-11:00) Pacific - Midway |
(GMT-11:00) Pacific/Midway | GMT-11:00 | -11 | (GMT-11:00) Pacific - Midway |
(GMT-11:00) Pacific/Niue | GMT-11:00 | -11 | (GMT-11:00) Pacific - Midway |
(GMT-11:00) Pacific/Pago_Pago | GMT-11:00 | -11 | (GMT-11:00) Pacific - Midway |
(GMT-11:00) Pacific/Samoa | GMT-11:00 | -11 | (GMT-11:00) Pacific - Midway |
(GMT-11:00) US/Samoa | GMT-11:00 | -11 | (GMT-11:00) Pacific - Midway |
(GMT-12:00) Etc/GMT+12 | GMT-12:00 | -12 | (GMT-12:00) Etc - GMT+12 |
Relations for Inventory & Video Targeting on Placements
2.119 and up - Videos and Sites in ‘AND relation’
Freewheel allows you to freely configure in which logical relation Site Inventory and Videos are, that you want to target. This means you can set up Bookings to show either for specific Sites OR on Videos, or you could define more precise conditions, like only when this Video is playing on this Site.
...
Setup
No specific setup is required.