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
  • Usage
  • Pixel Request
  • Javascript request
  1. Adnuntius Advertising
  2. Requesting Ads

Recording Conversions

When you create Adnuntius Line Items that use conversion tracking, costs are recorded whenever a user performs a configured action. Adnuntius must be notified of the user action using a Conversion Tag, which can be either a pixel or javascript.

Usage

You must specify an Adnuntius Custom Event that will be used to track conversions. In the examples below you should replace <event-id> with the specific identifier for your chosen custom event.

Conversions can be automatically attributed to a line-item under the following circumstances:

  • The creative includes a click URL to the advertiser's domain

  • The conversion is recorded from the advertiser's domain

In this scenario, Adnuntius will attribute the conversion to the most recently delivered impression that directed the user to the advertiser's domain. The user does not need to have actually clicked on the advertisement, although third-party cookies are required to track conversions without a click.

Alternatively, the request can explicitly include the line-item that should receive the conversion.

Pixel Request

Note: Pixels require third-party cookies to function correctly, which may be blocked by the user's privacy settings.

The most simple pixel tag is shown below. This pixel will automatically record the conversion to the most recent impression coming from a conversion tracking line-item for the advertiser.

<img src="https://delivery.adnuntius.com/pixelc.gif?eventType=<event-id>">

For example, if the pixel was included on a page hosted at https://exampleadvertiser.com, then the conversion would be recorded against a line-item that included a click URL to https://exampleadvertiser.com.

You can also hardcode the advertiser domain into the pixel, as shown in the example below:

<img src="https://delivery.adnuntius.com/pixelc.gif?eventType=<event-id>&adSource=exampleadvertiser.com">

If you want to record the conversion against a specific line-item, then you can hardcode this into the pixel tag like so:

<img src="https://delivery.adnuntius.com/pixelc.gif?eventType=<event-id>&network=<network-id>&adSource=<line-item-id>">

Javascript request

For javascript conversions, the Adnuntius script (see below) should be included on the landing page for the conversion tracking advertisement. Typically you would include this in the <head> section of the page, but you can place it anywhere within the HTML.

<script src="https://cdn.adnuntius.com/adn.js"></script>

Note: If the Adnuntius script is not included on the landing page, the conversion tracking will only work for users that have third-party cookies enabled.

The most simple javascript conversion is shown below. This will automatically record the conversion to the most recent impression coming from a conversion tracking line-item for the advertiser.

window.adn = window.adn || {}; adn.calls = adn.calls || [];
adn.calls.push(function() {
   adn.regConversion({eventType: '<event-id>'});
});

For example, if the javascript was included on a page hosted at https://exampleadvertiser.com, then the conversion would be recorded against a line-item that included a click URL to https://exampleadvertiser.com.

You can also hardcode the advertiser domain into the conversion, as shown in the example below:

window.adn = window.adn || {}; adn.calls = adn.calls || [];
adn.calls.push(function() {
   adn.regConversion({eventType: '<event-id>', adSource: 'example.com'});
});

If you want to record the conversion against a specific line-item, then you can hardcode this like so:

window.adn = window.adn || {}; adn.calls = adn.calls || [];
adn.calls.push(function() {
   adn.regConversion({eventType: '<event-id>', network: '<network-id>', adSource: '<line-item-id>'});
});

Last updated 2 years ago