[Mapping] Which ADvendio Objects represent what in Adswizz mapping and Connection configurations
Customers who are using Adswizz Integration of ADvendio are required to install version 2.161. With the release of 2.161, the Adswizz API Domain has been updated to the newest version, v7.
All earlier ADvendio versions have an older Adswizz API version which will be deprecated by the end of 2022. This means that Adswizz features will not work with the old API. If you encounter any issues while installing 2.161, please contact ADvendio for assistance.
Challenge
Do you want to know which Adswizz entities are used for imports into ADvendio, especially for those fields relevant to the billing process?
Solution
The current mapping for Delivery Data Import from Adswizz to ADvendio is as follows:
General Mapping
ADvendio metrics | Adswizz metrics | Type | Definition |
---|---|---|---|
Delivered Impressions | Audio Impressions |
| If the billing category is CPM, the invoice quantity will be based on delivered impressions from the revenue schedules. |
Delivered Clicks | Clicks |
| If the billing category is CPC, the invoice quantity will be based on the delivered clicks from the revenue schedules. |
Delivered Unique Users | Unique Users | Campaign Item | only lifetime data, no monthly or daily breakdown |
Listen / View Through Rate | Listen Through Rate | Campaign Item | only lifetime data, no monthly or daily breakdown |
Current AdServer Status | Status | Campaign Item |
|
Sitebased Delivery Data | Zone (Zone ID) | Delivery Data | Used as breakdown for the sitebased delivery data import. |
Pushed Details
Feature | Availability Check | Booking |
---|---|---|
Start / EndDate | ||
Billing Category | – | |
Booked Quantity / Guaranteed AI | – | |
ProductType (Display,Video,...) | only Audio | only Audio |
Frequency Capping | ||
Priority | ||
Ad Duration | ||
Device Targeting* | ||
Geography Targeting* | ||
Audience Segment Targeting* | ||
Zone Targeting* | (Only Audio) | (Only Audio) |
*Currently the Targeting Options only allow the inclusion of Targeting Criteria, excluding is not possible: 4.3.4.10 How to exclude Targeting Criteria
Advertiser Mapping
The Advertiser for a Media campaign in ADvendio will be determined based on the Advertiser set in the campaign. If the Advertiser is already mapped to an existing Advertiser in AdsWizz, that Advertiser will be set in the Campaign. However, if the Advertiser set in ADvendio does not exist in AdsWizz, the system will create a new Advertiser. The system will automatically set the fields below when creating the new Advertiser:
ADvendio field | AdsWizz field |
---|---|
Account Name | Advertiser name |
Website | Advertiser Domain |
Note domain format for Website / Advertiser:
Please ensure the Website (Advertiser domain in AdsWizz) follows the following format: “www.advendio.com”
It would not work with “https://advendio.com”.
Create Orders from ADvendio with Submit to AdServer
Our Submit to AdServer feature has been enhanced in version 2.162 to allow customers to push orders into Adswizz based on their media campaigns:
Details:
When you create a Media Campaign in ADvendio, it will automatically be converted into an Order in Adswizz.
Similarly, every Media Campaign Item you create in ADvendio will be converted into a Campaign in Adswizz.
Please note that only two types of budget, Impressions and Price, are allowed for a Media Campaign.
Ad Duration for "Dummy" Ads
ADvendio always creates "dummy" ads for each campaign item in Adswizz. You can however influence the ad duration you want to use. This does have an impact on your forecasting results.
To set the duration of an ad in seconds please use the field Ad Duration which is available at the Campaign Item and Ad Spec:
Delivery Data Import
Delivery Data Import Type | Supported |
---|---|
Total / Lifetime Delivery Import | |
Monthly Delivery Import | |
Daily Delivery Import | |
'Sitebased' Delivery Import for Total / Lifetime | |
'Sitebased' Delivery Import for Total / Lifetime | |
'Sitebased' Delivery Import for Total / Lifetime | |
Enhanced Delivery Data for Monthly Imports | |
Enhanced Delivery Data for Daily Imports |
The Campaign Item status will be synchronized every time the delivery data is running and imported from the Ad Server to ADvendio.
Setup
No specific setup is needed. However, if you wish to learn how to schedule delivery imports into ADvendio, you can refer to Wiki article 5.3.2 How to schedule and manage Delivery Reports / Programmatic Data Imports from AdServers, SSPs, DSPs (New interface)