Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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 Integration

...

Please find which FreeWheel features are supported:

ADvendio Feature

Documentation

Additional Comment

Booking of Campaigns, Insertion Orders and Placements

4.8.1 How to submit Media Campaign and Campaign Items into external systems (AdServers, SSPs, Exchanges)

Manage Advertisers and Agencies

Targeting:

  • Geo Targeting

  • Inventory Targeting* (Ad Units, Ad Unit Group, Site Groups, Sites, Site

Sectiions
  • Sections)

  • Video Targeting

  • Industry Targeting

  • Device Targeting

  • Key Value & Audience Targeting

  • Frequency Capping

  • Day & Time Targeting

4.3.4.3 Geo and Postal Code Targeting

4.3.4.2 Browser, Device, and Connection Targeting

Info

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 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

  • Matched Quantity

  • Available Quantity

  • Final Available Quantity

4.4 Check Availability in ADvendio

?Delivery

Which data is used in the availability check for Freewheel and how to view Final Delivered Impressions (FFDI)

Info

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)

5.3 Revenue Schedule, Delivery Data, and Status Updates

Configuration instruction in
How to configure Delivery Data Imports from FreeWheel to ADvendio

-

Enhanced Delivery Reports

(Delivery data grouped by

How to configure Delivery Data Imports from FreeWheel to ADvendio

5.3.5.1 Filter Settings for Enhanced Delivery Data (EDD)

Only for delivery imports grouped by: Sites and Video Groups

in combination)

Update Status (import current status from Freewheel + pushing campaigns live from ADvendio)

4.8.5 How to update the status of my Insertions Orders / Campaigns in the AdServer/SSP and approve Orders in Google AdManager?

Import current status from Freewheel and pushing campaigns live from ADvendio

Limited Time Zone support

FreeWheel Limited Time Zone support

version 2.99 and up

Transfer Offer number and External ID

Transfer Offer number and External ID to Freewheel

Freewheel features currently supported by ADvendio:

Freewheel Feature

How to

use

Use it?

Additional

Comment

Comments

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

4.3.6 Frequency Capping

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

Booking of Campaigns, Insertion Orders and Placements

4.8.1 How to submit Media Campaign and Campaign Items into external systems (AdServers, SSPs, Exchanges)

Setting a Placement Status

7.3.4 How to Configure "Update Ad-Status in AdServer" for Campaign Items

Setting an Insertion Order Stage

4.8.5 How to update the status of my Insertions Orders / Campaigns in the AdServer/SSP and approve Orders in Google AdManager?

Setting an Insertion Order Brand

4.2.1.4 Advertised Brands (FreeWheel)

On the fly availability check for not existing bookings

Used by our Check Availability feature

Info

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

Via the ADvendio Inventory and Video Targeting feature

Note

There are some limitations in the targeting supported by ADvendio, see also additional comments below on this page

Audience Targeting, with full logical operator support

4.3.4.4 Key Value / Audience (AdServer) Targeting

Custom Targeting

4.3.4.4 Key Value / Audience (AdServer) Targeting

Exclusivity settings for Placements

4.2.12.1 Exclusivity of Brands and Industries (FreeWheel)

Selecting Industries for Placements

4.3.4.9 Industry Targeting

Ad Unit linking

3.1.1.1 Linking Ad Units for FreeWheel

Custom Event Targets for your Placements

How to use Custom Event Targets for Freewheel?

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

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:

...

...

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.