Which ADvendio Objects represent what in FreeWheel or Entity mapping and Connection configuration

External Systems

FreeWheel

External Systems

FreeWheel

Role

Order Manager - Fulfilment; Product Management

Challenge

To gain a better understanding of how the integration of FreeWheel to ADvendio works, you are looking for an overview of which objects in ADvendio, represent which entities in FreeWheel.


Solution

 

Here is an overview of the relationship between ADvendio and FreeWheel objects

ADvendio Object

FreeWheel

Purpose / Additional description

ADvendio Object

FreeWheel

Purpose / Additional description

Connection

Publisher

-

Account

Advertiser or Agency

-

Media Campaign

Campaign & Insertion Order

-

Campaign Item

Placement

-

Ad Type

Placement

Certain settings are configurable on the Ad Type

Connection ID

Targeting Options (Inventory, Video, Geo & Device)
Brands

Industries

-

Selected Inventory Targeting
(on Campaign Item)

Site Groups, Sites, Site Sections

-

Selected Video Targeting
(on Campaign Item)

Video Groups, Series, Videos

 

Selected other Targeting
(on Campaign Item)

Geo, Industries, Devices, Brands, Exclusions,

 

Selected Key Value Targeting

Custom Targeting

 

Selected Audience Segment Targeting

Audience Items

 

 

Advertiser & Agency

In order to map Accounts from ADvendio to Freewheel, the ID of the Advertiser or Agency will be saved in the Account related list "AdServer Advertiser IDs".

To manage these IDs in ADvendio you can do the following:

Manually enter the ID from Freewheel 

If no AdServer Advertiser ID exists, the AdServer Gateway will automatically create these.
When submitting a Media Campaign to Freewheel, it will compare the Account names to Advertisers and Agencies in Freewheel. If there are matches, the IDs are automatically copied to the Account in ADvendio.

If no Advertiser or Agency with that name exists in Freewheel, ADvendio will create a new one and automatically connect it to the Account

Advertiser-Agency Relation

A Campaign in Freewheel can only use an advertiser and an agency if they are linked by a relationship. ADvendio will automatically create this relationship and set the status to active if it doesn't exist.

Important: If the relation between Advertiser and Agency already exists in Freewheel, but is set to status inactive, the following error will appear during submit to AdServer: 

Error 422: Unprocessable Entity: Validation failed: Campaign's advertiser do not have the active agency.


Setup

There is no further setup required.