ADNUNTIUS
  • Adnuntius Documentation
  • Adnuntius Advertising
    • Overview
    • Getting Started
      • Ad Server for Agencies
      • Ad Server for Publishers
    • User Interface Guide
      • Dashboards
      • Advertising
        • Advertisers
        • Orders
        • Line Items
        • Line Item Templates
        • Creatives
        • Library Creatives
        • Targeting
        • Booking Calendar
        • Reach Analysis
        • Smoothing
      • Inventory
        • Sites
        • Adunits
        • External Ad Units
        • Site Rulesets
        • Blocklists
        • Site Groups
        • Earnings Accounts
        • Ad Tag Generator
      • Reports and Statistics
        • The Statistics Defined
        • The 4 Impression Types
        • Templates and Schedules
        • Report Translations
      • Queries
        • Advertising Queries
        • Publishing Queries
      • Users
        • Users
        • Teams
        • Roles
        • Notification Preferences
        • User Profile
      • Design
        • Layouts and Examples
        • Marketplace Products
        • Products
        • Coupons
      • Admin
        • API Keys
        • CDN Uploads
        • Custom Events
        • Reference Data
        • Email Translations
        • Context Services
        • External Demand Sources
        • Data Exports
        • Tiers
        • Network
    • API Documentation
      • API Requests
      • Targeting object
      • API Filters
      • Endpoints
        • /adunits
        • /adunittags
        • /advertisers
        • /article2
        • /creativesets
        • /assets
        • /authenticate
        • /contextserviceconnections
        • /coupons
        • /creatives
        • /customeventtypes
        • /deliveryestimates
        • /devices
        • /earningsaccounts
        • /librarycreatives
        • /lineitems
        • /location
        • /orders
        • /reachestimate
        • /roles
        • /segments
        • /segments/upload
        • /segments/users/upload
        • /sitegroups
        • /sites
        • /sspconnections
        • /stats
        • /teams
        • /tiers
        • /users
    • Requesting Ads
      • Javascript
        • Requesting an Ad
        • Layout Support
        • Utility Methods
        • Logging Options
        • Prebid
      • HTTP
      • Cookieless Advertising
      • VAST
      • Open RTB
      • Recording Conversions
      • Prebid Server
      • Prebid
      • Android SDK
      • IOS SDK
    • Creative Guide
      • HTML5 Creatives
    • Page
  • Adnuntius Marketplace
    • Overview
    • Getting Started
      • For Network Owners
      • For Media Buyers
        • Marketplace Advertising
          • Advertisers
          • Orders
          • Line Items
          • Line Item Templates
          • Placements (in progress)
          • Creatives
            • High Impact Formats
          • Library Creatives
          • Booking Calendar
          • Reach Analysis
          • Targeting
          • Smoothing
      • For Publishers
        • Marketplace Inventory
          • Sites
          • Adunits
          • Site Groups
          • Rulesets (in progress)
          • Blocklists
          • Ad Tag Generator
        • Design
          • Layouts
          • Marketplace Products
  • Adnuntius Self-Service
    • Overview
    • Getting Started
    • User Interface Guide
    • Marketing Tips (Work in Progress)
  • Adnuntius Data
    • Overview
    • Getting Started
    • User Interface Guide
      • Segmentation
        • Triggers
        • Segments
        • Folders
      • Fields
        • Fields
        • Mappings
      • Queries
      • Admin
        • Users, Teams and Roles
        • Data Exports
        • Network
    • API documentation
      • Javascript API
        • User Profile Updates
        • Page View
        • User Synchronisation
        • Get user segments
      • HTTP API
        • /page
        • /visitor
        • /sync
        • /segment
      • Profile Fields
    • Segment Sharing
  • Adnuntius Connect
    • Integration Guide (Work in Progress)
      • Prebid - Google ad manager
      • Privacy GTM integration
      • Consents API
      • TCF API
    • UI Guide (Work in Progress)
      • Containers and Dashboards
      • Privacy (updates in progress)
      • Variables, Triggers and Tags
      • Integrations (in progress)
      • Prebid Configuration
      • Publish
  • Adnuntius Email Advertising
    • Getting Started
  • Other Useful Information
    • Macros for click tracker
    • Setup Adnuntius via prebid in GAM
    • Identification and Privacy
      • User Identification
      • Permission to use Personal Data (TCF2)
      • Data Collection and Usage
      • Am I Being Tracked?
    • Header bidding implementation
    • Adnuntius Slider
    • Whitelabeling
    • Firewall Access
    • Ad Server Logs
    • Send segments Cxense
    • Setup deals in GAM
    • Render Key Values in ad
    • Parallax for Ad server Clients
  • Troubleshooting
    • FAQs
    • How do I contact support?
    • Adnuntius System Status
  • Adnuntius High Impact
    • Publisher onboarding
    • High Impact configuration
    • Guidelines for High impact creatives
Powered by GitBook
On this page
  • Checklist Overview
  • Agreements with Partners
  • Creating Publisher Users
  • Creating Buyer Users
  • Invoicing
  • Set Up Report Templates
  1. Adnuntius Marketplace
  2. Getting Started

For Network Owners

This page provides an onboarding guide for network owners intending to use the Adnuntius Marketplace to onboard buyers and sellers in a private marketplace.

Last updated 1 year ago

Checklist Overview

As a network owner there are certain processes that you will need to manage. The goal of this page is to get you ready to manage these processes so that you can effectively run your private marketplace. Not all these processes may apply to you, as this depends on the processes you already have in place, and whether you run a publishing company, an agency/advertising company, or an ad network. This guide covers the following.

Process step
Resources

1 Create agreements with buyers and sellers. Depending on your business model you should have agreements in place with the parties invited to your marketplace as ad buyers or publishers. We have templates to help you get started.

2 Create products. When you later in this process invite buyers, they will be able to buy campaigns, which starts with selecting a Marketplace Product. You must create at least one product, and here is how you do it.

3 Create publisher teams and users. If you are an agency or ad network, publishers that you onboard to your marketplace may expect access to manage their sites and ad units, and to read reports. Here is how you do it.

4 Train publishers. If you are an agency or ad network and have invited publishers as users, they may have questions on how it all works, and how to make their traffic available. Here is a list of tasks they can do, and an explanation on how to do them.

5 Create buyer teams and users. If you are a publisher or ad network, buyers that you onboard will need access to your marketplace to buy and manage campaigns and more. Here is how you do it.

6 Train buyers. If you are a publisher or ad network and have invited buyers as users, they may have questions on how it all works. Here is a list of tasks they can do, and an explanation on how to do them.

7 Invoice buyers and/or pay out to sellers. Depending on your business model you may have to invoice buyers, and/or paying to publishers their share of the revenue from buyers. Here is how you do it.

8 Set up report templates. Report templates determine the reports that users can create from sites, line items and more, and also schedule for email distribution. Here is how you create templates for your customers.

Agreements with Partners

If you are an agency you need access to publishing inventory; if you are a publisher you need buyers to buy your inventory; and if you're an ad network you're likely to need both. Here you will find agreement templates that can help you along. Please see the comments in the Word documents for guidance, and please note that you may want to add, change or remove certain parts of it.

Please note that you are responsible for the content of the contracts; these templates work only as tips.

Creating Publisher Users

Whenever you get a new publisher onboard your network, you can create users for them so that they can access and manage their own publishing inventory. Here is how you create roles, teams and users with the right permissions, and finally an earnings account that controls the publisher's revenue share.

Roles. This is a one-time setup job, so if you already have the roles below in place, you can skip this point whenever you set up new users. You will need two roles in order to create users with the right permissions; a network role and a team role.

Teams. Once your roles are set up, you can proceed to create teams. Teams determine the content that users shall have access to. Whenever you bring a new publisher onboard you should create a new team, so that invited users can access this inventory, but not the inventory of other publishers, or buyers.

  1. Choose type “Marketplace Publisher”.

  2. If you have created the publisher’s site(s) on behalf of the publisher, then you can choose those sites to ensure that the publisher will have access to these. If you want to let publishers create this content on their own, just click save without choosing any sites.

Users. Once you have created a team for the publisher, you can go to the last step, which is to create a user. Please note that once you have created one user for the publisher, that user can invite more users with the same permissions. So, you only need to create the first user before letting that user create more.

  1. Choose the advertising network role that you created earlier (“Marketplace Publisher Admin” if you followed the naming example above).

  2. Under the team you’ve created for the user, choose the role you created earlier (“Marketplace Publisher” if you followed the naming example above).

  3. Lastly, click save. When you’ve clicked save an invitation email will be automatically be sent to the user.

Remember to use the revenue share field on earnings accounts in order to automatically calculate what publishers should earn. Also, remember to take into account your cost to Adnuntius. Let’s say for example’s sake that Adnuntius charges you 10% of revenue, and you want 15% for yourself. This means that you should specify a revenue share to the earnings account of 75%.

Creating Buyer Users

Whenever you get a new buyer onboard your network, you can create users for them so that they can access and manage their own advertisers (for agencies) and campaigns. Here is how you create roles, teams and users with the right permissions.

Roles. This is a one-time setup job, so if you already have the roles below in place, you can skip this point whenever you set up new users. You will need two roles in order to create users with the right permissions; a network role and a team role.

Teams. Once your roles are set up, you can proceed to create teams. Teams determine the content that users shall have access to. Whenever you bring a new advertiser onboard you should create a new team, so that invited users can access this inventory, but not the inventory of other advertisers, or publishers.

  1. Choose type “Marketplace Advertiser”.

  2. Choose the sites from which this advertiser should be able to purchase advertisers. These are the sites that will become available to the advertiser for buying. Lastly click save.

Users. Once you have created a team for the advertiser, you can go to the last step, which is to create a user. Please note that once you have created one user for the advertiser, that user can invite more users with the same permissions. So, you only need to create the first user before letting that user create more.

  1. Choose the advertising network role that you created earlier (“Marketplace Advertiser Admin” if you followed the naming example above).

  2. Under the team you’ve created for the user, choose the role you created earlier (“Marketplace Advertiser” if you followed the naming example above).

  3. Lastly, click save. When you’ve clicked save an invitation email will be automatically be sent to the user.

Invoicing

As a network owner you will need to make sure that buyers are invoiced, and that publishers receive their share of revenue.

Remember: whenever you onboard an agency or advertiser, that entity will be set up as a Team. So when you group by Team, this means that you will see any agency that manage multiple advertisers. Then, you will be able to invoice the agency rather than each advertisers (if this is the agreement you have with that agency).

Informing Sellers. Again, let's say that we just entered the month of July, and you want to send out reports for June so that publishers can invoice you for the right amount. You can inform sellers in two ways:

  • Alternatively you can create automated reports being sent to publishers. Read more below on how to set up report templates, and to learn specifically how to set up monthly revenue reports for publishers.

Set Up Report Templates

Report templates define what kind of reports users should be able to create, and also define which kind of scheduled reports can be created. In the following we will describe a few examples that can be useful.

What to do
Example if applicable

Give the template a name and description, then choose type "earnings account".

Publisher Revenue Report

Add the component "text", and use this text box to inform publishers why they receive this report and what to do about it.

You receive this report because you are a publisher part of Adnuntius. This entitles you to revenue from ads shown on your website. Please send an invoice for the total earnings in this report to finance@adnuntius.com. Our address: Adnuntius Services AS, Dueveien 21, 1448 Drobak, Norway.

Add the "daily breakdown" widget to provide the numbers. Ensure that the widget shows the "Revenue Share" numbers. Then click save.

NA

Go to Earnings accounts and add a scheduled report to all publishers who should receive one (publishers can also do this themselves).

What to do
Example if applicable

Give the template a name and description, then choose type "site".

Site viewability report

Add the component "text", and use this text box to inform publishers why they receive this report and what to do about it.

This report shows if your ad units are viewable. An impression is viewable when 50% or more of an ad has been shown for 1 second or longer. Buyers want high viewability as ads that were never in the user’s screen will never have any effect. There is no right answer, but our experience suggest that buyers want viewability of 75% or higher. If you see ad units in this report with low viewability and want to improve performance, consider actions such as lazy loading.

Add the "ad unit breakdown" widget to provide the numbers. Ensure that the widget shows the "Viewabiltiy" numbers. Then click save.

NA

Go to the sites and add a scheduled report for all sites that should have one (publishers can also do this themselves).

What to do
Example if applicable

Give the template a name and description, then choose type "Advertiser".

Advertiser Spending Report

Add the component "text", and use this text box to inform advertisers why they receive this report.

This report shows how much you as an advertiser have spent with Adnuntius Marketplace in the period since the last time you received this report.

Add the "Advertiser Totals ", "Daily Breakdown" and "Line Item Breakdown" widgets (and other information you want to share). Then pick the numbers you want to share.

NA

Go to the advertisers and add a scheduled report for all advertisers that should have one (advertisers can also do this themselves).

What to do
Example if applicable

Give the template a name and description, then choose type "Line item".

Campaign Performance Report

Add the component "text", and use this text box to inform advertisers why they receive this report.

This report shows how your campaign performs.

Add the "Line Item Totals " and "Daily Breakdown" widgets (and other information you want to share). Then pick the numbers you want to share.

NA

Go to the line items and add a scheduled report for all line items that should have one (advertisers can also do this themselves).

Admin role. Go to and click “new”. Give the role a name of your choice (for instance “Marketplace Publisher Admin”, choose role type “internal”, role scope “network” and then finally the permission “Marketplace Publisher Admin”. Then click save. Click for more information.

Team role. Go to and click “new”. Give the role a name of your choice (for instance “Marketplace Publisher”, choose role type “internal”, role scope “team” and then finally the permission “Marketplace Publisher”. Then click save. Click for more information.

Go to and click “new”. Give the team a name of your choice, for example “Team [publisherName]”. Click for more information on teams.

Go to and click “new”. Provide the user’s email address, name and display name (display name is the name that will be displayed in the upper right corner of the user interface). Click for more information on users.

Earnings account. Finally create an earnings account for the new publisher. Earnings accounts make it easy to track the revenue that each publisher makes, and to calculate their revenue share if you are operating on such a model. Go to and click "new". Click for more information on how to create an earnings account.

Admin role. Go to and click “new”. Give the role a name of your choice (for instance “Marketplace Advertiser Admin”, choose role type “internal”, role scope “network” and then finally the permission “Marketplace Advertiser Admin”. Then click save. Click for more information.

Team role. Go to and click “new”. Give the role a name of your choice (for instance “Marketplace Advertiser”, choose role type “internal”, role scope “team” and then finally the permission “Marketplace Advertiser”. Then click save. Click for more information.

Go to and click “new”. Give the team a name of your choice, for example “Team [advertiserName]”. Click for more information.

Go to and click “new”. Provide the user’s email address, name and display name (display name is the name that will be displayed in the upper right corner of the user interface). Click for more information.

Invoicing Buyers. Let's say that we just entered the month of July, and you want to send out invoices for June. Go to and choose the period of last month. Under grouping, make sure that you group by "teams" so that you will see any agencies that operate advertising across multiple Advertisers, and should receive one invoice across those Advertisers.

Alternatively, you can also Adnuntius to your invoicing system in order to automate the process.

Go to and generate a report. This provides the information to manually inform publishers how much they have earned. The column "Cost" shows the gross revenue, while "Revenue Share" shows how much publishers have earned after costs are withdrawn. To understand how revenue shares are defined for publishers, please see .

Monthly revenue reports to publishers. This is a useful report as it can be used to automatically inform publishers what they should invoice you, thus reducing your manual work. In order to create this, go to and click to create "new", then follow these steps.

How to: . We also recommend you to run a test report from a test earnings account so that you can ensure that you have set everything up correctly.

Weekly viewability reports to publishers. This report is useful because it informs publishers about viewability on each and every ad unit. Buyers care about viewability, so giving publishers the numbers to improve the quality of their inventory will increase the quality of the overall network. In order to create this, go to and click to create "new", then follow these steps.

How to: . We also recommend you to run a test report from a test site so that you can ensure that you have set everything up correctly.

Monthly spending reports to buyers. This report is useful because it informs buyers about their spending. In order to create this, go to and click to create "new", then follow these steps.

How to: . We also recommend you to run a test report from a test advertiser so that you can ensure that you have set everything up correctly.

Line item reports to buyers. This report is useful because it informs buyers about the performance of their campaigns. In order to create this, go to and click to create "new", then follow these steps.

How to: We also recommend you to run a test report from a test advertiser so that you can ensure that you have set everything up correctly.

Admin > Roles
here
Admin > Roles
here
Admin > Teams
here
Admin > Users
here
Earnings Accounts
here
Admin > Roles
here
Admin > Roles
here
Admin > Teams
here
Admin > Users
here
https://admin.adnuntius.com/queries/advertiser
integrate
https://admin.adnuntius.com/queries/earnings-account
earnings accounts
https://admin.adnuntius.com/report-templates
https://admin.adnuntius.com/report-templates
https://admin.adnuntius.com/report-templates
https://admin.adnuntius.com/report-templates
Back to the checklist overview.
Back to the checklist overview.
Back to the checklist overview.
Back to the checklist overview.
Back to the checklist overview.
Documentation
Documentation
Documentation
see here
see here
see here
see here.
Templates
Documentation
Documentation
Documentation
Documentation
34KB
202012 Agreement Template - Network to Agency.docx
Network or Publisher to Agency
34KB
202012 Agreement Template - Network to Publisher.docx
Network or Agency to Publisher