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 billing category = CPM, Delivered impressions from the revenue schedules will be used as invoice quantity |
Delivered Clicks | Clicks |
| If billing category = CPC, Delivered clicks from the revenue schedules will be used as invoice quantity |
Delivered Unique Users | Unique Users | Campaign Item | only lifetime date, no monthly or daily breakdown |
Listen / View Through Rate | Listen Through Rate | Campaign Item | only lifetime date, 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* |
|
|
*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 will be set according to the Advertiser set in the Media campaign in ADvendio.
If the Advertiser is mapped to an existing Advertiser in AdsWizz this Advertiser will be set in the Campaign.
When the Advertiser set in ADvendio does not exist in AdsWizz the system will create a new one. The fields below will be set when creating the new Advertiser.
ADvendio field | AdsWizz field |
|---|---|
Account Name | Advertiser name |
Website | Advertiser Domain |
Website / Advertiser domain format
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:
When creating a new Campaign and submitting an Item to Adswizz, the duration will only be submitted once. If you update an existing Campaign from ADvendio, the original duration value will remain in the dummy ad.
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.
Please note that we can only import data that is a maximum of three years old 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)