Available with Version: | ????? |
|---|---|
Role | System Administrator; Order Manager - Fulfilment; |
ADvendio Edition | Connect |
External Systems | FreeWheel |
Challenge
You are using AdButler FreeWheel as an AdServer and are looking to connect ADvendio to FreeWheelit. Which features of ADvendio are part of the FreeWheel integration and which features of FreeWheel are supported?
...
Solution
ADvendio Features part of the FreeWheel Integration
Please find FreeWheel features supported
ADvendio Feature | Documentation | Additional Comment | ||
|---|---|---|---|---|
Booking of Campaigns, Insertion Orders and Placements | ||||
Manage Advertisers and Agencies | ||||
Targeting:
|
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 | |||
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 |
FreeWheel 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?
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
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 |
Current Limitations for the ADvendio - FreeWheel Integration
1- Inventory
...
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:
...
...
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.
...
2- 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