Available with Version: | 2.100 |
|---|---|
Role | System Administrator; Order Manager - Fulfilment; |
ADvendio Edition | Connect |
External Systems | FreeWheel |
Challenge
You are using FreeWheel as an AdServer and are looking to connect ADvendio to it. Which features of ADvendio are part of the FreeWheel integration and which features are supported?
Solution
Please find which FreeWheel features are supported:
ADvendio Feature | Documentation | Additional Comment |
|---|---|---|
Booking of Campaigns, Insertion Orders and Placements | ||
Manage Advertisers and Agencies | ||
Targeting:
| Unfortunately FreeWheel does not offer the export of geo targeting data in their API 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 7.3.7 FreeWheel Features Version 2.119 : for Inventory and Video check 7.3.7.4 Inventory and Video for Freewheel (Content Targeting) - BREAKING CHANGE WITH 2.119 | |
Availability Check
| 7.3.7.7 - How to check Availability for Final Delivered Impressions (FFDI) from Freewheel From Version 2.95 on we will support parallel processing for "Check Availability". Please ensure that your API user have the possibility to use up to 20 Requests per second as described here: https://hub.freewheel.tv/display/techdocs/API+Rate+Limitations+FAQs
| |
Delivery Data Reports (Monthly, Daily) | Configuration instruction in 7.3.7.2 How to configure Delivery Data Imports from FreeWheel to ADvendio | |
Enhanced Delivery Reports | 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 | ||
Reporting for Delivered Impressions | 7.3.7.6 Breaking Change: Freewheel Reporting for delivered Impressions |
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 | ||
Setting an Insertion Order Stage | ||
On the fly availability check for not existing bookings | Used by our Check Availability feature | Freewheel requires an existing Placement in order to use the Forecasting features. Our current logic will create those Placements, run the process and once we have results, will delete the placements, if the booking has not yet been done from ADvendio |
Combined Use of Inventory and Video Targeting | ||
Ad Unit linking | ||
Custom Event Targets for your Placements | version 2.119 and up | |
Freewheel Forecast Modes (e.g. AI supported forecasting) |
Current Limitations for the ADvendio - FreeWheel Integration
Limited Time Zone Support (Version 2.99 and up)
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 |
2- Inventory and Video for Freewheel (Content Targeting) - BREAKING CHANGE WITH 2.119
The logic for combining Videos and Inventory for your Items. Logic to set these during submission to AdServer. Inventory and Video for FreeWheel before the 2.119 version and after the 2.119 version:
Before 2.119 - ‘Or connection’
In the past, we submitted all videos and sites that are set at a Campaign Item in the same set. This means for Freewheel, that all of them are in an OR relation.
So if you for example selected Site A and Video Group B, the placement will either run on Site A, regardless of the video shown or on each video in Group B, regardless of the site the video streams on.
2.119 and up - Videos and Sites in ‘AND relation’
As ADvendio currently offers no further connection logic for the video and site targeting, we decided to update our logic to put videos and sites into separate groups.
This way you can configure your Items to run on a specific Site when specific Videos are shown.
3- Breaking Change: Freewheel Reporting for delivered Impressions
There is a critical change in regard to the metrics used for Impressions in reporting.
What in the past was "Net Delivered Impressions" is now "Net Counted Ads". In order to react to this change, you will need to install a patch from ADvendio and change the ADvendio-related reports within Freewheel. To make sure your Delivery Reports are still containing the correct number please follow these steps.
Solution:
1.) Make sure to install at least ADvendio Spring (2.125.x) or ADvendio Spring (2.126.1) or the following release version 2.127. So that the ADvendio Gateway can ask Freewheel for the correct metrics
2.) Make sure to enhance your reports within Freewheel and add the new metric “Net Counted Ads”
The old metric “Net Delivered Impressions” can be removed. Please make sure that all reports are saved and scheduled to be pushed to the Freewheel FTP so that ADvendio can access them. Attention: It might take some time until a newly updated report is pushed to the Freewheel FTP. In most cases the following day, you should be able to receive the correct values in ADvendio
Setup
No specific setup required