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. |
Do you want to know which Adswizz entities are used for imports into ADvendio, especially for those fields relevant to the billing process?
The current mapping for Delivery Data Import from Adswizz to ADvendio is as follows:
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. |
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 |
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:
|
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.
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 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. |
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)
