| Note |
|---|
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. |
| Table of Contents |
|---|
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, Delivered the invoice quantity will be based on delivered impressions from the revenue schedules will be used as invoice quantity. |
Delivered Clicks | Clicks |
| If the billing category = is CPC, Delivered the invoice quantity will be based on the delivered clicks from the revenue schedules will be used as invoice quantity. |
Delivered Unique Users | Unique Users | Campaign Item | only lifetime datedata, no monthly or daily breakdown |
Listen / View Through Rate | Listen Through Rate | Campaign Item | only lifetime datedata, 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* |
|
|
| Info |
|---|
*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 set according to determined based on the Advertiser set in the Media campaign in ADvendio. If the Advertiser is already mapped to an existing Advertiser in AdsWizz this , that Advertiser will be set in the Campaign. When However, if the Advertiser set in ADvendio does not exist in AdsWizz, the system will create a new one. The Advertiser. The system will automatically set the fields below will be set when creating the new Advertiser. :
ADvendio field | AdsWizz field |
|---|---|
Account Name | Advertiser name |
Website | Advertiser Domain |
| Note |
|---|
Note domain format for Website / Advertiser domain format:
|
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:
...
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.
...
| Info |
|---|
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 |
|
...
No specific setup is needed. However, if you wish to learn how to schedule delivery imports into ADvendio, you can refer to wiki Wiki article 5.3.2 How to schedule and manage Delivery Reports / Programmatic Data Imports from AdServers, SSPs, DSPs (New interface)