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 | (Delivery data grouped by Sites and Video Groups in combination) | |
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 | ||
Custom Event Targets | version 2.119 and up | |
Reporting for Delivered Impressions | 7.3.7.6 Breaking Change: Freewheel Reporting for delivered Impressions | |
Freewheel Forecast Mode |
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