[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

ADvendio metrics

Adswizz metrics

Type

Definition

Delivered Impressions

Audio Impressions

  • Campaign Item (lifetime data)

  • Revenue Schedules (for monthly breakdown)

  • Revenue Schedules Daily (for daily breakdown)

  • Delivery Data

If the billing category is CPM, the invoice quantity will be based on delivered impressions from the revenue schedules.

Delivered Clicks

Clicks

  • Campaign Item (lifetime data)

  • Revenue Schedules (for monthly breakdown)

  • Revenue Schedules Daily (for daily breakdown)

  • Delivery Data

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

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

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:

AdDuration.png

 

Delivery Data Import

Delivery Data Import Type

Supported

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)