Which ADvendio Objects represent what in FreeWheel or Entity mapping and Connection configuration
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 |
---|---|---|
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) Industries | - |
Selected Inventory Targeting | Site Groups, Sites, Site Sections | - |
Selected Video Targeting | Video Groups, Series, Videos |
|
Selected other Targeting | 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.