Configure free budget

Published February 19th, 2026 by Karolina Dziewierz

Overview Free Budget lets you allocate a specific budget amount to advertisers without impacting the rate card. It represents delivered but non-invoiced spend, offering greater flexibility in campaign management.  This optional setting can be enabled at the line item level and is available exclusively for Monetization campaigns (Guaranteed or Sponso

Manage users

Published April 17th, 2025 by Karolina Dziewierz

Overview You can manage users with the following actions: Edit: lets you edit the settings of a user.   Delete: deletes a user permanently.  Reset password: changes a user password.  Access To manage users, select Users from the bottom-left corner of the navigation menu. You will see a list of users with their names, email addresses, and roles.  Onl

Prepare content source: encoding specification

Published August 5th, 2025 by Karolina Dziewierz

Overview This document outlines the encoding specifications that should be used for SSAI live and VoD content, unless otherwise specified. Encoding specification We recommend the following bitrate ladder for live and VoD content. This will ensure a smooth streaming experience and optimal quality on all devices and connection types. SD-profile { "Ver

Update campaigns, line items, and creatives

Published June 11th, 2026 by Karolina Dziewierz

Overview This article describes the available endpoints for updating campaigns, line items, and creatives. It also outlines which campaign attributes can and cannot be modified after creation, the rules for updating products, and the impact of changes that trigger campaign revalidation. Main endpoints Method Endpoint Description Link PATCH  https://

Use billing report

Published March 16th, 2026 by Karolina Dziewierz

Overview The billing report provides the information you need to bill your clients.  You can download the billing report on the first day of the month following the billing period. For example, to download billing data for January 2026, you must wait until February 1, 2026. Billing methodology This section explains how Equativ calculates billing fig

Get brand data

Published June 10th, 2026 by Karolina Dziewierz

Overview A brand is a collection of products marketed and sold under a unified name. Brands define the products an account can promote on retailer sites. Each account can access one or more brands. Main endpoints Use the following endpoints to list or search brands. Method Endpoint Description Reference GET https://api.kaminoretail.dev/v2/websites/{

Comply with GDPR privacy framework

Published June 8th, 2026 by Karolina Dziewierz

Overview User privacy and data security are built on trust. Equativ helps you respect user privacy and deliver effective advertising campaigns. Our platform complies with major privacy regulations, such as the GDPR and the ePrivacy Directive. The platform helps you collect, process, and share data with transparency and user consent. When you integra

Supply inventory with prebid.js header bidding (legacy adapter)

Published June 2nd, 2025 by Karolina Dziewierz

Overview This document outlines the features and client-side setup of Equativ as a bidder in prebid,js, using Equativ's legacy prebid.js adapter. Using the legacy adapter is not recommended for new implementations. Use the new prebid.js adapter instead. For more information about the setup in Equativ's Monetization platform, see Set up and manage cl

Changelog of on-site ad integration documentation

Published March 27th, 2026 by Karolina Dziewierz

Overview This article lists recent updates and changes to the Kamino developer documentation. Changelog April 4, 2026 - Multilingual Product Catalogue details Impacted documentation: Integrate JavaScript tag   Comply with Digital Services Act (DSA) requirements   Updates: Updated device types from web_Desktop to desktop. Moved the Legal file to the

Manage campaign information sharing and data export

Published July 10th, 2026 by Karolina Dziewierz

Overview This article explains how to share, extract, and export campaign and line item information in Kamino. It covers the Share info feature, which allows users to quickly copy formatted campaign details and links, as well as options for extracting configuration data and exporting line item settings to CSV for further analysis or reuse. Informati

Encoding specification

Published August 7th, 2025 by Karolina Dziewierz

Overview This document defines the encoding specifications for SSAI Live and VoD content, including video, audio, and rendition settings. It ensures compatibility, smooth playback, and optimal quality across devices and network conditions. General requirements The following encoding specifications apply to SSAI live and VoD content, unless otherwise

Product catalog attributes

Published April 10th, 2026 by Karolina Dziewierz

Overview This table outlines the required and optional attributes for the product catalog, along with their definitions, formats, and examples. Required fields must be provided for proper ingestion, while optional fields are recommended to enhance campaign performance and improve the shopper experience. Product catalog attributes Attribute Definitio

POST Ad request API: parameter reference

Published May 21st, 2025 by Karolina Dziewierz

Overview This article describes all parameters and objects of Equativ's HTTP POST Ad API. For general information about Equativ's Ad API, including samples, read POST Ad request API: usage . First-level parameters These parameters are almost identical for both Generic POST and Onecall POST requests. The only difference is that the output parameter i

Cookieless and mobile ID-less traffic targeting

Published June 11th, 2025 by Karolina Dziewierz

Overview With cookieless and mobile ID-less traffic targeting, you can target inventory without cookie-based user IDs or mobile IDs, enhancing targeting accuracy and campaign effectiveness in privacy-first environments. Dedicated report dimensions for cookieless and mobile ID-less traffic are "Cookieless targeting" and "Browser". For more informatio

Use cases for MCP tools

Published April 24th, 2026 by Karolina Dziewierz

Overview This page catalogs concrete use cases enabled by the Maestro MCP (Model Context Protocol) toolset. The use cases are organized across five key areas of the co-pilot workflow, with two levels of implementation: Core use cases: cover straightforward, single-step interactions. These represent what you can accomplish directly with MCP tools. Ad

Create line item: third-party measurement codes

Published April 30th, 2025 by Karolina Dziewierz

Overview To track key events such as impressions, viewability, and other metrics in third-party systems, you can add third-party measurement JavaScript code or URLs. The following table outlines the supported third-party measurement types for each creative format and creation method. Creative JavaScript URL Display creatives, created using "Upload f

Create user account

Published March 20th, 2026 by Karolina Dziewierz

Overview This guide explains how to request a user account for Kamino, details the mandatory prerequisites, and outlines the platform permissions available for each user role. Request account creation To request an account for Kamino, email rm-support@equativ.com.  Provide the following information in your request: Email address: the address to link

About product catalog sharing

Published April 2nd, 2026 by Karolina Dziewierz

A Product Catalog is a structured collection of your product information. It typically includes details such as product IDs, names, descriptions, prices, images, and attributes. The catalog serves as a centralized data repository, organized to display products accurately within on-site ads. Sharing your product feed allows you to: Display up-to-date

Understand product hierarchy and variations

Published July 8th, 2026 by Karolina Dziewierz

Overview In some cases, products can be split into multiple versions. These versions are described by attributes that may differ from one product to another. For example, a t-shirt model can have different colors and sizes.  The product itself is a specific version of a product model. This is the item that consumers purchase. Standard IDs, such as G

Monitor all campaigns and line items

Published February 5th, 2026 by Karolina Dziewierz

Overview The dashboard helps you monitor and manage advertising campaigns. Use it to track key performance indicators (KPIs) and edit campaign settings. The dashboard provides the following benefits:  Fast-loading views: access relevant KPIs quickly.  Flexible monitoring: view all campaigns across the account or focus on your favorites.  Typology ca

Create and manage creatives

Published June 9th, 2026 by Karolina Dziewierz

Overview This article explains how to create and manage ad creative items. Main endpoints Method Endpoint Description Reference GET https://api.kaminoretail.dev/v2/line-items/{line_item_id}/creatives Get all creatives for a given line item. Get creatives for a line item POST https://api.kaminoretail.dev/v2/line-items/{line_item_id}/creatives Create

Approve campaigns

Published June 11th, 2026 by Karolina Dziewierz

Overview This article describes the approval process for third-party partner campaigns. When a third-party partner creates a campaign, the retailer must approve it before it can deliver ads. Information accessible to the retailer Retailers can view the following campaign details: Brand Budget Buyer Campaign name List of promoted products List of tar

Configure custom pricing rules

Published March 12th, 2026 by Karolina Dziewierz

Overview Custom pricing rules (CPRs) let you apply specific pricing adjustments to selected guaranteed campaigns. Use CPRs to increase or decrease a campaign price by applying a positive or negative percentage adjustment. You can create multiple rules per website but only one rule can be applied to a campaign at a time. To create and manage CPRs, yo

Update sponsored product campaigns

Published June 18th, 2026 by Karolina Dziewierz

Overview This article explains how to update an existing sponsored product campaign using the API version 3 endpoints. Main endpoints Method Endpoint Description Documentation DELETE https://stoplight.io/mocks/kamino-retail/kamino-api/1169659571/ksp-campaigns/{campaign-id} Soft-delete a sponsored product campaign. Delete a KSP campaign PUT https://a

Alternative ID provider targeting

Published April 14th, 2025 by Karolina Dziewierz

Overview Alternative ID providers have emerged in response to the ongoing deprecation of third-party cookies. These providers offer alternative methods to identify users, using so-called alternative IDs, sometimes also referred to as extended IDs. Maestro supports alternative IDs in two ways:  Targeting segments of users identified by an alternative

Implement ads.txt specification

Published May 28th, 2025 by Karolina Dziewierz

Overview Ads.txt (Authorized Digital Sellers) and its app-ads.txt extension for apps are IAB specifications aiming at eliminating counterfeit and unauthorized inventory.  The main goal is to fight against domain or app spoofing: buyers can verify if the seller is legitimate and authorized to sell inventory originating from the publisher website/app.

Preview an ad

Published May 6th, 2026 by Karolina Dziewierz

Overview The Preview ad feature allows traffic managers to verify how a creative appears on a retailer’s website and easily capture screenshots using only the selected creatives for a given targeted context.  The feature supports both JavaScript (JS) tag and Server-to-Server (S2S) integration modes, providing flexibility across different delivery se

Semantic and performance targeting

Published April 11th, 2025 by Karolina Dziewierz

Overview Semantic and performance targeting lets you target the following types of segments: Semantic segments: Inventory that shares specific semantic contextual characteristics. Examples include the following:   Language segments: Segments containing pages in a given language. Standard segments: Industry-standard segments corresponding mainly to t

Maestro API authentication

Published May 28th, 2026 by Karolina Dziewierz

Overview This article describes authentication for the Maestro APIs. To access these APIs, you must authenticate using the OAuth 2.0 Client Credentials flow. You will need a client ID and client secret to request a short-lived bearer token. Global API limits The global rate limit is 60 requests per API user per minute. Supported APIs The following A

Use dynamic budget

Published May 27th, 2026 by Karolina Dziewierz

Overview Dynamic budget lets the Kamino delivery engine automatically distribute a campaign budget across line items based on their historical AdSpend. Budget allocation is recalculated daily according to the delivery behavior of each line item.  This article explains how dynamic budget affects delivery, budget allocation, pacing, reporting, and mon

Prepare content source: packaging specification

Published August 5th, 2025 by Karolina Dziewierz

Overview This document outlines the packaging specifications that should be used for SSAI live and VoD content, unless otherwise specified. MPEG-DASH requirements The following are the requirements for MPEG-DASH packaging for SSAI live and VoD content: The container format must be ISOBMFF fMP4 .m4s (MIME-type: video/iso.segment) with multiple video

Bellwether Publishers targeting

Published June 24th, 2025 by Karolina Dziewierz

Overview Equativ lets users target Bellwether Publishers to prioritize trusted and high-performing inventory in their campaigns and deals. This feature is provided in partnership with Jounce Media, which identifies these publishers based on transparency, quality, and performance.  Bellwether Publishers are defined by the following characteristics: H

Use fill rate report

Published July 24th, 2026 by Karolina Dziewierz

Overview The Fill rate report shows how well your inventory fills pageviews. This article explains how to access, configure, and generate a fill rate report. Access To access a fill rate report, sign in to the Kamino platform and select Reporting > Fill Rate from the left menu. Generate fill rate report To generate a fill rate report, follow thes

Monthly Product Update EMP: May 2026

Published June 3rd, 2026 by Karolina Dziewierz

Dynamic video ad pod requests: targeting of last ad break position now supported An in-stream video ad request can call a video ad pod with a maximum ad break duration (in seconds) by using the mabd= parameter without the pod size (ps=) parameter. These requests can return a dynamic number of video ads for an ad break. With these requests, you can n

Get started with user administration

Published April 17th, 2025 by Karolina Dziewierz

Overview User management is based on three core elements: companies, users, and user roles. These elements define the structure and permissions within the platform, ensuring each user has access to the resources and functions they need based on their role and company association. This article provides information about each of these elements and how

Monthly Product Update EMP: June 2026

Published July 1st, 2026 by Karolina Dziewierz

New deal list page Your browser does not support HTML5 video. The deal list has been revamped to help you monitor your deals more efficiently. This update introduces faster page loads, a fresh user interface, and various usability enhancements such as column reordering/pinning. The new deal list is rolled out to customer networks progressively. If y

Monitor sponsored product campaigns and line items

Published January 30th, 2026 by Karolina Dziewierz

Overview The sponsored product campaign dashboard lets you monitor campaign performance with hourly media metrics and daily sales metrics. Key benefits include: KPI monitoring: access top-level key performance indicators to evaluate campaign health.  Granular insights: view detailed performance metrics for individual products.  Bid management: modif

Open RTB API integration: bid response specification

Published May 20th, 2025 by Karolina Dziewierz

Overview Equativ provides an OpenRTB API for suppliers which is able to receive OpenRTB bid requests. Equativ then runs an auction for each request so Equativ’s demand partners can bid on the opportunity. This guide contains the bid response specification. BidResponse object OpenRTB field Data type Description cur STRING The bid currency using ISO-4

Set up dynamic pricing rules

Published May 27th, 2026 by Karolina Dziewierz

Overview Dynamic pricing rules let you activate smart, dynamic pricing directly in your ratecard. You can increase or decrease CPM or CPC floors based on specific dimensions to better manage pricing strategies while staying in control of your inventory monetization. The following dimensions are available: Period, Brands, and Category for CPM. Period

Manage campaign delivery and priorities

Published March 20th, 2026 by Karolina Dziewierz

Overview This guide explains how the Kamino delivery system works and provides practical information for users to monitor and optimize their campaigns. It covers the key concepts of priorities, capping, and pacing, showing how each setting affects campaign delivery. Priorities When you create a campaign on the Kamino platform, each line item is assi

Upload assets

Published June 9th, 2026 by Karolina Dziewierz

Overview This article explains how to upload assets to create creatives for display and video formats. All creatives that use a native format (sponsored products) don't need assets. Main endpoints Method Endpoint Description Reference POST https://api.kaminoretail.dev/v2/accounts/{account_id}/assets Upload an asset.   Upload asset   Attributes The f

Site-centric trackers

Published June 5th, 2026 by Karolina Dziewierz

Overview This article covers site-centric data tracking for key organic user interactions on your website and explains how to implement these events using the required endpoints and context parameters. Site-centric data Site-centric data captures key user interactions with your website and products. This data powers features such as audience targeti

Kamino glossary

Published March 12th, 2026 by Karolina Dziewierz

Overview This article covers essential definitions and formulas used to measure campaign performance, spend efficiency, and audience engagement. Key terms  Term Definition Ad spend The total budget delivered by all formats in a campaign. Campaign revenue The total revenue attributed to a campaign based on the attribution window. Campaign sold units

Get product data

Published June 10th, 2026 by Karolina Dziewierz

Overview This article explains how to fetch product data. Main endpoints Method Endpoint Description Reference GET https://api.kaminoretail.dev/v2/websites/{website_id}/products Get products by IDs. Get products by IDs GET https://api.kaminoretail.dev/v2/websites/{website_id}/products/search Search products. Search products GET https://api.kaminoret

Configure guaranteed multilingual campaigns

Published February 19th, 2026 by Karolina Dziewierz

Overview This guide explains how to configure campaigns for websites that support multiple languages. Before you begin the setup, provide the following information to the Equativ team: Total number of languages: the number of versions your website supports. Default language: the primary language for your account. The default language determines how

Campaign and line item statuses

Published June 15th, 2026 by Karolina Dziewierz

Overview This article describes the statuses for campaigns and line items. Main endpoints Method Endpoint Description Link PATCH https://api.kaminoretail.dev/v2/campaigns/{campaign_id} Update campaign status. Patch a campaign PATCH https://api.kaminoretail.dev/v2/line-items/{line_item_id} Update line item status. Patch a line item A campaign inherit

Use follow-up report

Published March 20th, 2026 by Karolina Dziewierz

Overview The Follow-up report is a reporting solution that provides delivery insights for all live campaigns. Use this report to get a high-level overview of delivery performance across your website. This report includes delivery information for website campaigns that have delivered at least one impression during the current month. The report update

Extract campaign and line item performance data

Published June 15th, 2026 by Karolina Dziewierz

Overview This article explains how to extract data for a specific campaign and all its line items. Main endpoints Method Endpoint Description Link POST https://api.kaminoretail.dev/v3/analytics/get-campaign-performances Get campaign performance data for a specific campaignId across the selected analysis period. Get campaign performances POST https:/

Understand the sponsored product algorithm

Published March 25th, 2026 by Karolina Dziewierz

Overview Equativ's Kamino systems use a bidding and scoring mechanism to determine which products appear on a retailer's website. This article explains how the second-price auction and product scoring work to optimize ad delivery. Second-price auction system Kamino systems use a second-price auction model for cost-per-click (CPC) advertising. In thi

Get inventory insights

Published April 18th, 2025 by Karolina Dziewierz

Overview Inventory Insights provides insights into the availabilities and median CPM in the past for the selected criteria. All charts are updated in real time, as you select your criteria in the Targeting and Supply sections. For more information, see Set targeting criteria .   Access To access Inventory Insights, select Media Planning from the nav

Manage keywords

Published June 11th, 2026 by Karolina Dziewierz

Keywords used on the Kamino platform are exact-match keywords. You can add as many keywords as you want. However, retailers can add keywords to a deny list, and you cannot target those keywords. Keyword configuration varies by campaign type: For a sponsored product campaign, keywords are associated with each product. For a Display campaign or a Vide

Configure sales attribution

Published May 27th, 2026 by Karolina Dziewierz

Overview A sales attribution window is the timeframe during which a sale can be credited to an ad exposure (an impression or a click). When a shopper sees or clicks an ad, the attribution window for that interaction begins. The system can link any purchase made within the selected window, for example, 1, 7, 14, or 30 days, back to that interaction.

Domain category targeting

Published April 14th, 2025 by Karolina Dziewierz

Overview With domain category targeting, you can target media properties that best match your audiences' affinities. Domain category targeting relies on Equativ’s in-house proprietary categorization of domains and apps into segments. The segments are organized in a three-level hierarchy, that is Universe > Type > Segment. For more information

Ad-centric trackers

Published June 8th, 2026 by Karolina Dziewierz

Overview This article outlines all ad-centric trackers that retailers must implement to track user interactions with Kamino-delivered creatives. The goal is to ensure that you track every eligible event using the correct URL provided in the Kamino API response, and that you append all necessary parameters based on the triggered event. To learn more

Creative enhancement showcases

Published May 15th, 2026 by Karolina Dziewierz

Overview This section showcases a collection of creative enhancements across various ad formats and sizes. Showcases Weather - Display 300 x 600 Weather - Outstream 300 x 600 Headline - Outstream 300 x 600 Sports Ticker - Display 300 x 600 Sports Ticker - Outstream 300 x 600 Countdown - Display 320 x 480     Countdown - Outstream 300 x 600 Shoppable

Reporting API: dimension reference

Published May 16th, 2025 by Karolina Dziewierz

Overview This document lists the dimensions supported by the reporting API of Equativ's Monetization platform.  Dimension reference In the following table, each row contains the Dimension name, Dimension use case, and the Dimension definition. For more information about use cases, see Reporting API: get started. Dimension name Dimension use case* Di

Create and manage API users

Published May 28th, 2026 by Karolina Dziewierz

Overview This article explains how users with the Administrator role in Maestro can create and delete API users. Before you start Before creating an API user, make sure you:  Have administrator permissions for your Maestro company.  Are prepared to securely store the client ID and client secret displayed during creation, as the secret might not be s

Create and manage sponsored product campaigns

Published June 15th, 2026 by Karolina Dziewierz

Overview This article describes how to create and retrieve sponsored product campaigns using API version 3. Main endpoints The following table lists the primary endpoints for sponsored product campaigns: Method Endpoint Description Link GET https://api.kaminoretail.dev/v3/ksp-campaigns Get all sponsored product campaigns. This endpoint only returns

Submit and manage support cases

Published June 16th, 2025 by Karolina Dziewierz

Overview   You can address incidents to Equativ’s Technical Support team at any time using the client portal. The incident will be stored as a support case with a case number used to reference the case. Access To access Equativ's client portal, log in to the Maestro platform, click your name in the top-right corner and select Support. Alternatively,

Product catalog feed format examples

Published April 10th, 2026 by Karolina Dziewierz

Overview This section provides examples of the product catalog feed format in both XML and CSV. It illustrates how product data should be structured and transmitted, including required and optional attributes, to ensure proper ingestion and consistency across integrations. Product catalog feed format examples XML <?xml version="1.0" encoding="UTF

Create and manage guaranteed campaigns

Published June 8th, 2026 by Karolina Dziewierz

Overview This article explains how to create and manage guaranteed campaigns, and how to retrieve all guaranteed campaigns that are associated with a specified account. Main endpoints Method Endpoint Description Reference GET https://api.kaminoretail.dev/v2/campaigns Retrieve all campaigns associated with the specified account. List campaigns GET ht

Packaging specification: DASH

Published August 7th, 2025 by Karolina Dziewierz

Overview This document describes the DASH packaging specifications used for SSAI live and VoD content, unless otherwise specified. DASH requirements The following are the requirements for DASH packaging in SSAI live and VoD content: The container format must be ISOBMFF fragmented MP4 (.m4s) with multiple video segments (MIME-type: video/iso.segment)

Open RTB API integration: bid request specification

Published May 16th, 2025 by Karolina Dziewierz

Overview Equativ provides an OpenRTB API for suppliers which is able to receive OpenRTB bid requests. Equativ then runs an auction for each request so Equativ’s demand partners can bid on the opportunity. This guide contains the bid request specification. BidRequest object OpenRTB field Data type Necessity Description acat STRING ARRAY OPTIONAL Not

Create campaigns from CSV or Excel files

Published June 29th, 2026 by Karolina Dziewierz

Overview Instead of filling in every field manually, you can upload an Excel or CSV file to pre-populate the campaign creation form automatically. This feature applies to campaign creation only. Before you start, prepare your file with the following fields listed in the table: Field Is required attribution window & tracker No (post-click: 30 day

Create reports with Instant Report Builder

Published May 16th, 2025 by Karolina Dziewierz

Overview With the Instant Report Builder tool, you can retrieve detailed statistics either as a one-time report or a scheduled report. It also provides an instant preview of the data for the first 24 hours of the selected report period. If the financial metrics, such as revenue numbers shown on the Instant Report Builder, differ from the numbers on

Share multilingual product catalog

Published May 28th, 2026 by Karolina Dziewierz

Overview This article explains how to structure and send a product catalog when your website supports multiple languages. This setup ensures that each product is correctly identified and displayed in the appropriate language across integrations. Catalog feeds by language To ensure data consistency, send a separate catalog feed for each language. Mos

Analyze report data with Instant Insights

Published May 8th, 2025 by Karolina Dziewierz

Overview  Instant Insights is a real-time reporting tool that delivers data output as you compose your query. Data is typically refreshed every 10 minutes. While minor initial inaccuracies might occur, the system continuously recalculates to ensure that any data older than 5 hours is fully accurate.  If the financial metrics, such as revenue numbers

Monthly Product Update EMP: September 2025

Published October 7th, 2025 by Karolina Dziewierz

Instant Insights: share link with external users  Your browser does not support HTML5 video. You can now share reports with people outside of your organization, even if they don't have an account on Equativ's Monetization platform. When sharing, you can select specific metrics, dimensions, and filters to display. Recipients of the shared link will o

Monthly Product Update EMP: April 2026

Published May 8th, 2026 by Karolina Dziewierz

Content metadata targeting: text mode Your browser does not support HTML5 video. Content metadata targeting in insertions now supports text mode. Simply copy/paste large numbers of values instead of going through the form-based combiner mode for each value. You can also switch between combiner mode and text mode at any time – your criteria are prese

Playlist size for HLS and DASH live streams

Published August 18th, 2025 by Karolina Dziewierz

Overview This document provides a detailed explanation of the Playlist size (also known as DVR window) feature, including its purpose, usage, and configuration. This feature can be used either as a complement to Timeshift and startover for live or as a standalone option. Playlist creation Serverside.ai creates a dedicated playlist for each session o

Manage deals with the API

Published May 5th, 2025 by Karolina Dziewierz

Overview With the Auction Package API, developers can automate the creation, editing, updating, and pausing of deals.  Technical documentation For complete field-level reference, see the technical documentation, powered by Scalar. This help page focuses on surface coverage, behavioral rules, and integration guidance. Authentication To authenticate w

Ad-marker specification: SSAI VoD - AdCuePoints

Published August 5th, 2025 by Karolina Dziewierz

Overview This document describes how to define ad cue points within an mRSS playlist for SSAI in live and VoD content. Ad CuePoint within a mRSS playlist The following example displays how ad cue points are structured within an mRSS playlist. <ad:cuepoints> <cuepoint id="adpod-1"> <splicetime>0</splicetime> <maxcount>1&

Monthly Product Update Maestro: June 2026

Published July 1st, 2026 by Karolina Dziewierz

Interact with Instant Report Builder preview Your browser does not support HTML5 video. You can now interact with the report data preview provided by the Instant Report Builder. You can filter dimension columns (operators Is, Is not, Starts with etc.) or Metric columns (operators Less than, Greater than etc.) as well as sort and redorder columns. In

Supply Path Optimization (SPO) targeting

Published June 11th, 2025 by Karolina Dziewierz

Overview Supply Path Optimization (SPO) is a set of methods that help programmatic media buyers decide which ad tech platforms to use when buying ad space. In Equativ, SPO targeting lets buyers focus on ad inventory that comes through the most transparent paths between publishers and advertisers, giving them better control over the supply chains inv

VAST tracking: Live - HLS

Published August 13th, 2025 by Karolina Dziewierz

Overview This guide explains client-side VAST tracking for live HLS streams using Serverside.ai. It covers two methods based on player capabilities, including how to fetch manifests, detect ads, retrieve VAST data, and send tracking beacons.  As with VAST tracking: Live - DASH , the HLS workflow follows five key steps to fully implement client-side

Create and modify rate card and grid section

Published June 1st, 2026 by Karolina Dziewierz

Overview This documentation explains how business managers can view and manage grid sections, formats, and rate cards for a specific website. Only users with the Business Manager role can create and modify grid sections and rate cards.   Access grid section To access grid section, follow these steps: Log into the Kamino platform. In the left menu, s

Metrics and bid statuses

Published May 5th, 2025 by Karolina Dziewierz

Overview  This article summarizes the metrics and bid statuses available when troubleshooting deals or line items using the Troubleshooting tool. Access  Select Troubleshooting from the navigation menu.  Metrics The metrics used in the Troubleshooting tool include: Bid Requests: the ad opportunities that were sent as bid requests to the selected sea

Manage format settings

Published June 15th, 2026 by Karolina Dziewierz

Overview Format settings define requirements for each format on your website. They let you adjust behavior to your needs and control how creatives are delivered. You can configure settings for each format. Available options include: Custom settings by format Maximum character limit for text fields by format Image dimensions by format Maximum file si

Monthly Product Update Maestro: February 2026

Published March 19th, 2026 by Karolina Dziewierz

Campaign performance goals Your browser does not support HTML5 video. You can now define up to five custom performance targets—including CTR, VCR, Viewability rate, CPC, and CPM—directly within your campaigns to evaluate progress against key KPIs at a glance. These goals are visually tracked across your dashboard, instantly highlighting whether your

Monthly Product Update Maestro: September 2025

Published October 7th, 2025 by Karolina Dziewierz

Live Stream and AVOD Targeting Your browser does not support HTML5 video. You can now choose whether your campaigns and deals include or exclude live video. Ads can run during live, real-time events such as sports or concerts, or only in recorded, on-demand videos with ad breaks before, during, or after content. Documentation: Report metrics | Repor

Build reports with Instant Report Builder

Published May 8th, 2025 by Karolina Dziewierz

Overview With Instant Report Builder, you can retrieve detailed statistics either as a one-time report or a scheduled report. It also provides an instant preview of the data for the first 24 hours of the selected report period. The data in Instant Report Builder is typically refreshed every 6 to 10 hours. If the financial metrics, such as revenue nu

Monthly Product Update Maestro: May 2026

Published June 3rd, 2026 by Karolina Dziewierz

Improved API user management We introduced API user management directly in the Maestro interface, allowing external Admin users to create and manage API users autonomously. All newly created API users are now provisioned on Auth0 Enterprise with dedicated company credentials. Documentation: Create and manage API users Bulk filter input in Instant In

About on-site ad integration

Published March 27th, 2026 by Karolina Dziewierz

Overview This guide serves as a starting point to the on-site ads documentation. It introduces the main services, concepts, and integration steps, and provides links to more detailed documentation for each topic. Integration guide scope In the following diagram, the blue components represent the services covered by the On-site ads integration guide.

Creative enhancement compatibility matrix

Published March 11th, 2026 by Karolina Dziewierz

The following table describes the creative enhancement types, inventory and device compatibility, and platform availability. Enhancement type Inventory type Device compatibility Description Countdown Display Desktop, Mobile, Tablet Adds a countdown clock to a banner or video ad to highlight an end date for launches, events, or limited-time offers. C

Manage reports with the API

Published May 5th, 2025 by Karolina Dziewierz

Overview With the Maestro Reporting API, developers can automate a range of reporting tasks, such as creating, updating, or deleting reports, setting up scheduled reports, and more. The Reporting API is asynchronous, meaning it delivers fully processed data rather than real-time or preliminary results. The data returned is final and won't be recalcu

GVA configuration

Published August 19th, 2025 by Karolina Dziewierz

Overview This document describes the configuration options for the Generic VAST Adapter (GVA), including how parameters, functions, and mappings interact with the ad server to enable proper ad delivery. Template and ad source parameters Section Description mappings The mapping of static values to parameters required by the ad server. functions The f

Manage campaigns with the API

Published May 5th, 2025 by Karolina Dziewierz

Overview  With the Activation API, developers can create, update and manage the resources of the Activation module: advertisers, campaigns, line items, creatives, and budgets.  The API adheres to the JSON API specification for consistency and ease of integration.  This page documents the Activation API (JSON:API specification, /v1/ namespace, hosted

Create direct insertion: additional options

Published June 5th, 2025 by Karolina Dziewierz

Insertion list options The insertion list shows the insertions of a given campaign in your network with various KPIs.  The following options are available: Filters (read "Time column" below to learn how to use these filters with the Time column) All - all insertions, regardless of their start/end date/time Upcoming - insertions with start date/time

Create line item: targeting

Published April 25th, 2025 by Karolina Dziewierz

Targeting lets you define specific criteria for your ads to reach the right audience, on the right platforms, and in the right contexts. This helps optimize ad performance. You can set up the following targeting criteria: Targeting: in the Targeting section, you can define criteria that control the audience, placement, and delivery of your ads. This

Keep track of deals

Published April 24th, 2025 by Karolina Dziewierz

Overview   You can monitor deals to track their performance and ensure optimal outcomes, simplifying the management and optimization of your campaigns. This can be achieved through the following methods: Monitor deals with the Deals list: view and filter deals based on various criteria, track KPIs like impressions, and quickly assess the status of y

Set targeting criteria

Published April 18th, 2025 by Karolina Dziewierz

Overview  You can set the criteria for your upcoming campaign in the Targeting and Supply sections. Additionally, you can configure a site list, which defines where ads are allowed to appear or where they must be blocked.  Access To access targeting, select Media Planning from the navigation menu. The targeting options will appear in the Targeting p

Supply targeting

Published April 7th, 2025 by Karolina Dziewierz

Overview With supply targeting, you can target specific publishers, domains, and apps. This helps to ensure the ads are displayed on platforms that align with your brand's target audience. When configuring supply criteria, start with the publishers. The domains and apps available for selection are filtered based on general targeting criteria and the

Packaging specification: HLS

Published August 7th, 2025 by Karolina Dziewierz

Overview This document describes the HLS packaging specification used for SSAI live and VoD content, unless otherwise specified. HLS requirements The following are the requirements for HLS packaging in SSAI live and VoD content:  A master manifest is required.  For HLS, the container format can be .ts (MIME-type: video/mp2t) or .mp4 (Content-Type: v

Reports: overview

Published August 22nd, 2025 by Karolina Dziewierz

Overview Every Serverside.ai setup includes a set of built-in reports, which are described in this document. To create additional reports, reach out to our Professional Services team for assistance. Key concepts: systems and reports Before using the Reports API, it is important to understand the concepts of systems and reports and how they relate to

Monthly Product Update Maestro: June 2025

Published July 16th, 2025 by Karolina Dziewierz

Custom Seller Name for DV360 and The Trade Desk You can now define a custom seller name for your deals synced from Maestro to Google DV360 and The Trade Desk. This new option gives you greater control over how your deals are presented in those DSPs, enhancing buyer perception, inventory positioning, and branding.  Documentation: Create deals   Suppl

Prepare content source: source stream requirements

Published August 5th, 2025 by Karolina Dziewierz

Overview The Serverside.ai service adheres to industry standards to ensure optimal streaming performance. This document outlines the required specifications for source streams and content creation. VoD and live manifest requirements The VoD or live manifest must meet the following requirements: The manifest (.m3u8 for HLS or .mpd for MPEG-DASH) must

Get started with targeting criteria

Published April 7th, 2025 by Karolina Dziewierz

Overview Targeting allows you to specify the requirements of your future campaign, aiming at publishers that provide ad opportunities aligning with those specifications. Access  To access targeting, select Media Planning from the navigation menu. The targeting criteria will appear in the Targeting section. The supply targeting criteria will appear i

Monthly Product Update Maestro: March 2026

Published April 17th, 2026 by Karolina Dziewierz

New capabilities of Maestro AI Agent Your browser does not support HTML5 video. The agent and the Media Planning interface now share a live, bidirectional context. You can open the chat directly from the Media Planning interface to request a review of your setup, with the agent automatically receiving deal configuration, targeting, and insights as c

Reporting API: metric reference

Published May 16th, 2025 by Karolina Dziewierz

Overview This document lists the metrics supported by the reporting API of Equativ's Monetization platform.  Metric reference In the following table, each row contains the Metric name, Metric use case, and the Metric definition. For more information about use cases, see Reporting API: get started. Metric name Metric use case* Metric definition Ad a,

Monthly Product Update EMP: April 2025

Published July 17th, 2025 by Karolina Dziewierz

New user experience in campaigns and insertions The following campaign/insertion features have been revamped, now appearing in a new look and feel:  Campaign copying, including Programmatic guaranteed campaigns  Group volume management  Link/exclusion management  Documentation: Create direct insertion: create direct campaign \ Link and exclude direc

Get started with Maestro AI Agent

Published March 26th, 2026 by Karolina Dziewierz

Overview The Maestro AI agent uses natural language to help you create, search, and troubleshoot deals. By bridging the gap between business goals and technical execution, the agent reduces manual work and accelerates complex configurations. Key capabilities Use the Maestro AI agent to transform complex workflows into simple conversational tasks. Yo

Inventory-specific targeting options

Published April 16th, 2025 by Karolina Dziewierz

Overview The following tables detail the availability of targeting options across different formats and environments. Use them to understand which combinations are supported based on your campaign setup.  Targeting options by format This table outlines availability across various ad formats, such as instream video, outstream video, and display. Targ

Low-emission inventory targeting

Published April 16th, 2025 by Karolina Dziewierz

Overview GreenPMP identifies and blocks high-emission sites in real time, allowing you to target only lower-emission inventory and reduce the carbon footprint of your campaign.  GreenPMP is powered by Sharethrough in partnership with Scope3. Its mechanism is based on Scope3 measuring the carbon emissions of the entire programmatic supply chain and a

Configure creative enhancements

Published March 11th, 2026 by Karolina Dziewierz

Overview In Maestro, you configure creative enhancements at the deal level. When you assign an enhancement to a deal, it can be applied to all eligible impressions served under that deal on Equativ supply. Ad format requirements For enhancements to apply, the deal's ad format configuration must include all format types required by the enhancement en

Monthly Product Update Maestro: February 2025

Published July 16th, 2025 by Karolina Dziewierz

Troubleshooting for line items  You can now use the Troubleshooting tool also for line items. Go to "Troubleshooting" on the side bar, select the campaign and finally the line item you want to troubleshoot. The provided metrics and bid statuses are identical to the ones used for the troubleshooting of deals.  Documentation: Troubleshoot line items  

Monthly Product Update Maestro: November 2025

Published December 10th, 2025 by Karolina Dziewierz

The new Ahead delivery mode The new Ahead delivery mode front-loads delivery, spending more at the beginning of the campaign and gradually tapering off to ensure full budget utilization while adapting to traffic fluctuations. It helps prevent underspending in situations with uncertain inventory or late-stage competition. Documentation: Create and ma

Optimize line items

Published July 28th, 2025 by Karolina Dziewierz

Overview  The Performance page provides performance data based on the supply and inventory criteria set in the line item targeting. It presents this data as graphs and tables, letting users monitor metrics in real time, compare performance across those criteria, and make optimizations without leaving the line item page. The following metrics are ava

Monthly Product Update EMP: January 2026

Published February 10th, 2026 by Karolina Dziewierz

New insertion history Your browser does not support HTML5 video. The insertion history has been redesigned. It logs each modification in the insertion with date/time, user, modifications made, and status changes.  Documentation: Create direct insertion additional options New advertiser/agency creation and editing Your browser does not support HTML5

Connected TV (CTV) targeting

Published April 15th, 2025 by Karolina Dziewierz

Overview Connected TV (CTV) targeting allows you to target specific inventory to reach only CTV campaigns. Access To access Connected TV (CTV) targeting, select Media Planning from the navigation menu. The CTV targeting options will appear at the top of the Targeting section. You can also access supply targeting directly from the line item page. For

Prefetch API

Published August 20th, 2025 by Karolina Dziewierz

Overview The Serverside.ai prefetch API provides a solution for efficiently delivering ad sources, ensuring they are conditioned and ready for use upon request. This document describes its endpoints, request headers, request bodies, and response codes for retrieving and prefetching ad media for channels. Get ad media for a given channel GET https://

Automatic deal syncing with DSPs

Published June 4th, 2025 by Karolina Dziewierz

Overview New deals created in Equativ’s Monetization Platform (EMP) are synchronized automatically with some of Equativ’s partner DSPs. Likewise, updates to parameters in running deals are also synchronized (with some exceptions, as explained below). Synchronization with DV360 The following Equativ deal types are synchronized automatically with DV36

Channels: VoD

Published August 21st, 2025 by Karolina Dziewierz

Overview VoD channels require additional parameters and an mRSS playlist to be created before they can be viewed. This document provides guidance on setting up VoD channels and creating or updating playlists. mRSS feed creation and update POST mRSS POST  https://mydomain.com/ad-aggregation-service/mrss/channel/:id Path parameters Field Type Descript

Metrics monitoring

Published August 20th, 2025 by Karolina Dziewierz

Serverside.ai provides a set of metrics and measurement points for streaming sessions and ad events, captured in real time. The data is available via REST API, visualized in a dashboard, or can be exported in XLS and CSV formats.

Retrieve report logs

Published June 3rd, 2025 by Karolina Dziewierz

Access to Equativ logs requires activation - reach out to your contact at Equativ to get access.   Overview Equativ's standard reports (generated by the UI or the API) are ready to use and cover most reporting needs. However, you may need to inject raw data from the Equativ platform into your systems for further business analysis or data optimizatio

Ad media: origin integration

Published August 19th, 2025 by Karolina Dziewierz

Overview The Serverside.ai encoding workflow provides the capability to transfer ad media to the customer’s origin via AWS S3 and Azure Blob Storage.  This document lists the configuration details required to connect Serverside.ai to customer origins through Azure Blob Storage, Amazon S3, or FTP. Azure Blob Storage  The following information is need

Frequently asked questions

Published August 25th, 2025 by Karolina Dziewierz

Overview This document provides questions and answers about Server-Side Ad Insertion (SSAI) and its implementation by Serverside.ai. It is intended to help readers understand the concept, benefits, and key considerations of using SSAI. Questions and answers What is Server-Side Ad Insertion (SSAI)?  Server-Side Ad Insertion (SSAI) is a process used t

Monthly Product Update EMP: November 2025

Published December 10th, 2025 by Karolina Dziewierz

Delivery rules: region, state, and city targeting now supported In delivery rules, the geography targeting has been extended to now support also region, state, and city targeting. You can target multiple items, but they must be of the same type. For example, you can target multiple cities, but you cannot target a city and a state. Documentation: Set

Feature list

Published August 5th, 2025 by Karolina Dziewierz

Serverside.ai supports the following features: Create, update, and delete an SSAI channel endpoint for live linear and VoD. Connect to your existing ad server or SSP. Configure a dynamic ad slate (live only). Insert pre-roll ad breaks for live linear. Insert mid-roll ad breaks for live linear (via SCTE-35). Insert pre-roll, mid-roll, and post-roll a

Check reporting insights for deals and campaigns

Published April 24th, 2026 by Karolina Dziewierz

Overview The Maestro AI agent can help you understand how your deals and campaigns are performing, using natural language questions instead of manual report building.  You can use it to: Check delivery status and pacing for deals, campaigns, and line items. Surface performance highlights. Get actionable suggestions. For best results, include: A time

Monthly Product Update EMP: October 2025

Published November 18th, 2025 by Karolina Dziewierz

New deal creation workflow Your browser does not support HTML5 video. A new workflow for Private and Preferred Deals is now available to a group of beta-testers. It offers an entirely new design, enhanced user experience and additional targeting criteria. The workflow lets you go back to the previous workflow at any time by clicking on the "Use lega

Monthly Product Update Maestro: March 2025

Published July 16th, 2025 by Karolina Dziewierz

Measure and reduce carbon emissions with GreenPMPs™  We now offer the ability to reduce carbon emissions and improve the efficiency of any PMP. Simply toggle “GreenPMP™” to reduce emissions by removing sites with unnecessarily high emissions.  Documentation: Carbon-neutral inventory targeting   New metrics added to the Campaigns list We've added two

VAST tracking: client-side tracking SDK

Published August 18th, 2025 by Karolina Dziewierz

In addition to server-side tracking and beaconing, Serverside.ai also provides a dedicated SDK. For more information, see Media Melon Player SDK with Nowtilus SSAI.

Create and manage advertisers

Published April 25th, 2025 by Karolina Dziewierz

Overview To start using the Activation module, you first need to create an advertiser, that is, a client or brand on whose behalf ads will be served. Once the advertiser is created, you can create campaigns and line items, and add creatives. Access From the navigation menu, select Advertisers to create a new advertiser, or Campaigns if you already h

VAST tracking: VoD - DASH and HLS

Published August 14th, 2025 by Karolina Dziewierz

Overview This document explains how to request and handle DASH and HLS VoD manifests with server-side ad insertion. It covers obtaining the manifest URL, detecting ad playback within the stream, and sending tracking beacons for ad events. DASH VoD 1. Manifest API request (manifest and VAST). To request a VoD manifest, follow steps 1–3 described in V

Monthly Product update EMP: February 2025

Published July 17th, 2025 by Karolina Dziewierz

Instant Report Builder: Page Id and Page Name added to Programmatic and Global views In Instant Report Builder, the dimensions Page Id and Page Name are now also available in the Programmatic and Global views. Documentation: Report dimension reference  

Monthly Product Update EMP: March 2026

Published April 17th, 2026 by Karolina Dziewierz

Discovery module for real-time inventory insights Your browser does not support HTML5 video. You can access real-time insights into inventory availability while trafficking your insertion. The Discovery module provides an estimate of available versus occupied inventory booked by guaranteed insertions. This module replaces the Forecast page, which wi

Create line item: macros

Published April 30th, 2025 by Karolina Dziewierz

Overview In the Activation module, you can use macros in third-party creative tags, that is, display and VAST video tags, and in third-party measurement tags. Once the given ad is delivered or clicked, these macros are replaced by the actual values of the given ad opportunity. For example, the {gdpr} macro is replaced by either 0 or 1, indicating if

Live: DASH and HLS

Published August 12th, 2025 by Karolina Dziewierz

Overview  This document explains how to retrieve live streaming manifests for DASH and HLS from Serverside.ai. Each request requires a dedicated API key, and the manifests enable video playback and support SSAI dynamic ad insertion. DASH live manifest Request GET https://mydomain.com/dash/view/:channelId Retrieves the DASH live manifest URL for a gi

Monthly Product Update Maestro: October 2025

Published November 18th, 2025 by Karolina Dziewierz

Encrypted Utiq and ID5 identifiers Profile identifiers of the alternative ID (extended ID) providers Utiq and ID5 can now be synced in their encrypted format. Equativ is able to decrypt the IDs internally, using the respective provider's API. Documentation: Sync segments and profiles ZIP code based profile identifiers Profile identifiers can now be

Submit cases

Published August 22nd, 2025 by Karolina Dziewierz

Overview You can report incidents to the support team through the client portal. Each incident is stored as a support case and assigned a unique case number for reference. This guide explains how to create a support case. Follow these steps to submit your issue or request and receive a case ID. Submit your ticket in English to ensure proper handling

Site list targeting

Published April 7th, 2025 by Karolina Dziewierz

Overview A site list consists of a selected collection of domains and apps that you can either include, indicating where ads will be displayed, or exclude, specifying where ads won't appear. This grants you greater control over the environments in which your ads are placed, optimizing campaign performance and ensuring brand safety. The Site lists da

Welcome to Serverside.ai

Published August 5th, 2025 by Karolina Dziewierz

If you want to monetize your valuable digital video content, you are in the right place. Serverside.ai is a server-side ad insertion cloud service for video platforms that can be used for linear, live event, and video on demand streaming across connected devices. It gives video platforms the flexibility to deliver monetized, ad-supported programming

Audience targeting

Published April 8th, 2025 by Karolina Dziewierz

Overview Audience segments enable you to target your deals to the predefined audiences. It groups users based on criteria such as age, gender, interest in products, shopping habits, and other. These segments are built by the third-party data providers and then integrated with Maestro using a unique user ID stored in an Equativ cookie (web), or a dev

Monthly Product Update EMP: June 2025

Published July 17th, 2025 by Karolina Dziewierz

Advertiser creative workflow The new advertiser creative workflow is now available. You can create, edit and manage the creatives of an advertiser across insertions, increasing operational efficiency in your everyday work.  Documentation: Add and manage advertiser creatives   New targeting criteria for video content metadata in insertions  In insert

Monthly Product Update Maestro: July 2025

Published August 7th, 2025 by Karolina Dziewierz

Carbon compensation Your browser does not support HTML5 video. You can now support high-quality carbon removal projects, such as reforestation or biochar, by adding a €0.05 (or local currency equivalent) contribution per deal. Simply enable the Carbon compensation toggle to help neutralize your ad’s emissions and drive lasting climate impact. Docume

Service quality

Published August 25th, 2025 by Karolina Dziewierz

Overview The Nowtilus team responsible for Serverside.ai is committed to ensuring exceptional system stability and security. To provide the highest quality, we apply industry-standard measures across all key areas, including Monitoring, Logging, Security, Privacy and data protection, and Customizability. Monitoring System monitoring With our SOC 2-

Monthly Product Update EMP: February 2026

Published March 19th, 2026 by Karolina Dziewierz

Creative template editing: new workflow Your browser does not support HTML5 video. Developers can now create and manage custom creative templates using a new, completely redesigned, intuitive workflow. Once a creative template is published, campaign managers can select it in insertions and use it to configure the creative behavior. Documentation: De

VoD: DASH and HLS

Published August 13th, 2025 by Karolina Dziewierz

Overview This document explains how to retrieve VoD DASH and HLS manifests from Serverside.ai using MRSS playlists. It also describes the required request parameters and headers, and includes information about ad cue points embedded in the stream. DASH VoD manifest Request POST https://mydomain.com/ad-aggregation-service/mrss/channel/:channelId Retr

Channels: detailed analysis errors

Published August 21st, 2025 by Karolina Dziewierz

Overview This document describes the detailed error messages included in 500 Server Errors returned by the analyzer. It covers general errors, stream format errors, and HLS or DASH-specific errors. Analysis error formats General errors General errors appear as strings inside the data array field. { "type": "ERR_INVALID_MANIFEST", "code": 500, "messa

Monthly Product Update Maestro: April 2026

Published May 8th, 2026 by Karolina Dziewierz

Maestro activation update: Shared-budget campaign delivery Shared-budget campaigns now distribute delivery more fairly across all eligible line items. Previously, the bidder favored the highest-bid line item, which often limited delivery for others. The system now allocates a portion of bid opportunities randomly to ensure each line item delivers. T

Set up and manage campaigns

Published April 24th, 2026 by Karolina Dziewierz

Overview The Maestro AI agent simplifies campaign setup and management by guiding you through each step using natural language. It helps create advertisers, campaigns, and line items, and supports configuration of targeting, budgets, and settings while ensuring all required steps are completed. Most of the workflow is automated, but some actions—suc

Keep track of line items

Published June 9th, 2025 by Karolina Dziewierz

Overview You can monitor line items to track their performance and ensure optimal outcomes. This can be achieved through the following methods: Monitor line items with the Line items list: view and filter line items based on various criteria, and track KPIs. Monitor line item s with Instant Insights : gain detailed, data-driven insights into line it

Ad conditioning and asset management

Published August 21st, 2025 by Karolina Dziewierz

Overview This guide explains how Serverside.ai conditions ads, manages assets, and handles encoding and delivery for VoD and live channels. Ad conditioning Serverside.ai offers pre-integrated media services for ad conditioning and provides built-in workflows to encode, package, and deliver video creatives and content assets. Channel format specifica

Troubleshoot line items

Published May 5th, 2025 by Karolina Dziewierz

Overview The Troubleshooting tool helps identify and resolve issues that might affect line item performance. Its Bid Status chart visually shows, with exact numbers, where ad opportunities exit the auction process. It also provides detailed bid status statistics, offering valuable insights to help resolve issues efficiently. Access To troubleshoot a

Create line item: creatives

Published April 29th, 2025 by Karolina Dziewierz

Overview   A creative is the visual or audio element of an ad, such as a banner, video, or audio clip, that users directly see or hear. You can add creatives in Display, Video, or Native formats to your campaign’s line items. Depending on the format, creatives can either be uploaded from your computer or added using a third-party tag. The Activation

Track enhanced impressions

Published March 11th, 2026 by Karolina Dziewierz

You can track enhanced impressions and clicks in the Instant Report Builder using the following dimensions and metrics: Enhanced content clicks: the number of user interactions with enhanced elements. Enhanced engagement clicks: the number of clicks on engagement features within the creative. Enhanced shoppable carousel arrow clicks: the number of t

Buyer and DSP seat targeting

Published April 16th, 2025 by Karolina Dziewierz

Overview DSP and buyer seat targeting lets you either target a specific DSP or refine targeting to a specific buyer seat within a DSP. This helps ensure deals are directed to DSPs with available inventory and supports more informed decision‑making based on how each DSP or buyer seat performs. You can either target a buyer seat or a DSP, not both. If

Predicted viewability/video completion targeting

Published April 16th, 2025 by Karolina Dziewierz

Overview Predicted viewability With predicted viewability targeting, you can target a percentage threshold of viewable impressions. For example, a targeted predicted viewability of "50% and more" ensures that at least half of an Auction Package's impressions will also be viewable to the end user. Equativ’s viewability measurement has limited coverag

Create out-stream video insertion

Published May 21st, 2025 by Karolina Dziewierz

Overview Equativ's out-stream video solution allows you to create, deliver and report VAST video campaigns on websites of virtually any type, integrating seamlessly into the rest of your content. Unlike in-stream video, the out-stream video solution can be used independently from video content on the page - any non-video format can be used (medium r

Monetize with VAST partners (Video Exchange): authorized partners

Published May 28th, 2025 by Karolina Dziewierz

Overview This article aims at providing information on Equativ’s authorized partners within the Video Exchange. Equativ is bound by European privacy and data protection laws which require certain mechanisms to be in place whenever an international data transfer occurs. At this time, the following partners are covered by a legal transfer mechanism, i

Troubleshoot delivery using bid performance analysis

Published March 26th, 2026 by Karolina Dziewierz

Overview If a deal has a low win rate or isn’t delivering, the Maestro AI agent analyzes the possible causes. The agent examines the deal’s bid-funnel data, including the number of bids sent, accepted, and won. Based on this analysis, it identifies patterns that might indicate issues such as: Bids that are too low Limited available inventory Other c

Error responses for all routes

Published August 22nd, 2025 by Karolina Dziewierz

Overview This document covers the HTTP error responses that might occur with any route. Responses specific to a particular route are documented in that route’s section. 400 Bad Request The server couldn't understand the request due to invalid syntax. 401 Unauthorized Although the HTTP standard specifies "unauthorized", semantically this response mea

Create direct insertion: priorities and volumes

Published June 2nd, 2025 by Karolina Dziewierz

Overview This article explains the priority and volume settings in direct insertions. Group volumes This article describes priorities and volumes for single insertions. To set group volumes shared by multiple insertions, see Create direct insertion: group volumes . Ad selection process Understanding the ad selection process is essential for managing

Send IRIS_ID

Published May 21st, 2025 by Karolina Dziewierz

Overview IRIS․TV provides a video data platform where it assigns a persistent, unique video identifier, called IRIS_ID, to any video ingested into the IRIS․TV platform. The characteristics of the video (and additional enriched data) are attached to this IRIS_ID.  Publishers pass the IRIS_ID to the programmatic chain and SSPs and DSPs can retrieve th

Create direct insertion: create direct campaign

Published June 2nd, 2025 by Karolina Dziewierz

Overview Campaign management is organized in a three-level structure: Advertiser - the client (brand) whose ads are served Campaign - typically represents an advertised product; a campaign consists of one or multiple insertions Insertion - includes one or multiple creatives as well as all the delivery settings (time frame, placements, targeting etc.

Monetize with VAST partners (Video Exchange): setup guide

Published May 28th, 2025 by Karolina Dziewierz

Before you start Before you start monetizing with VAST partners, make sure you complete the following steps:  Sign a direct contract with each third-party SSP you intend to integrate. Sign the contract addendum with Equativ for the use of this offer. Await activation of the workflow in your network. Creating a Video Exchange campaign To create a Vid

Monetize with VAST partners (Video Exchange): get started

Published May 28th, 2025 by Karolina Dziewierz

Overview The monetization with VAST partners, previously referred to as “Video Exchange”, lets publishers integrate third party SSPs with whom the publisher has a direct contract. The terms and conditions are negotiated directly between the publisher and the third party SSP. Technically, the integration is implemented with a VAST ad tag: a URL that

Configure channels and streams

Published August 20th, 2025 by Karolina Dziewierz

Overview This guide explains how to create and manage VoD or live channels in Serverside.ai, including adding a source, configuring encoding and ad settings, and enabling playback with ad insertion. 1. Create new channel Go to your channel page and click on the Add Channel button. 2. Configure general settings Decide whether the channel you want to

Create programmatic guaranteed deal

Published June 4th, 2025 by Karolina Dziewierz

Overview Programmatic guaranteed deals have a fixed price and only one buyer. The buyer commits to buy all the impressions, as agreed upon in the deal. With programmatic guaranteed deals, publishers monetize inventory similarly to direct campaign monetization, but rely on programmatic transaction mechanisms. Programmatic guaranteed deals share a pri

Analyze data with Instant Insights

Published June 3rd, 2025 by Karolina Dziewierz

Overview Instant Insights is a reporting tool with data output in real time, as you compose your query. The data freshness is approx. 10 minutes, with some initial inaccuracies that may occur; however, continuous recalculations in Instant Insights make sure that any data older than 5 hours is 100% accurate.  If the financial metrics, such as revenue

Create direct insertion: general settings and delivery

Published May 23rd, 2025 by Karolina Dziewierz

Overview In the General settings and Delivery sections of an insertion, you define its general data and the options that determine how it delivers its target(s). General settings Before you start creating an insertion, create an advertiser and a campaign as explained in Create direct insertion: create direct campaign . In the General settings sectio

Report metric reference

Published May 28th, 2025 by Karolina Dziewierz

Overview This article provides definitions of the metrics available in Instant Insights and Instant Report Builder. Metrics Metrics in Instant Insights and Instant Report Builder are organized by view (e. g. Programmatic view, as shown in the screenshot below). Consider switching the view if you cannot find a metric. Metric name Metric definition Da

Create line item: general settings

Published April 25th, 2025 by Karolina Dziewierz

Overview Line items contain budget and bid price information, along with one creative and its targeting criteria. To activate your campaign, you need to create a line item first. A line item must be then linked to a deal. You can associate a deal with a line item in the following ways: Retrieve pre-created deal: select a deal already created in Medi

Report metrics

Published May 8th, 2025 by Karolina Dziewierz

Overview This article provides definitions for the metrics available in Instant Insights, Instant Report Builder, and in the reporting APIs.   Report metrics Columns The list in section “Metric list”, later in this document, contains each metric with the following details: Name: the metric name, mainly named according to the name used in Instant Ins

Troubleshoot direct insertion delivery

Published May 28th, 2025 by Karolina Dziewierz

Overview This article explains the checks to perform when an insertion (creative(s)) you expect on a website is not displayed. Developer tools Using developer tools available in browsers (e. g. Chrome Developer Tools) is strongly recommended. The following table shows the relevant tabs in Chrome Developer Tools with some examples of usage: Tab Examp

Ad media: CDN integration

Published August 20th, 2025 by Karolina Dziewierz

Overview This document outlines the specifications for delivering ad media via CDN using MPEG-DASH, HLS, and MPEG-DASH for HbbTV. MPEG-DASH The following are the requirements for MPEG-DASH CDN integration: The container format must be ISOBMFF fMP4 .m4s (MIME-type: video/iso.segment) with multiple video segments. The filename extension must be .mpd.

Addressable TV targeting

Published April 14th, 2025 by Karolina Dziewierz

Overview Addressable TV is a specific form of in-stream video advertising for internet-connected TV sets that offer video on demand.  Access To access addressable TV targeting, select Media Planning from the navigation menu. The addressable TV targeting options will appear in the Advanced TV section of the Targeting panel. You can also access addres

Create private auction and preferred deal (legacy workflow)

Published June 3rd, 2025 by Karolina Dziewierz

This article explains the legacy workflow to create a private auction or preferred deal. A new workflow has been made available to a group of customers – read Create private auction and preferred deal (new workflow) for more details.    Overview Deals are agreements between publishers and buyers that are set up on the supply side (Equativ) and the d

Questionnaire

Published August 25th, 2025 by Karolina Dziewierz

Overview The following questions are intended to help stakeholders involved in an SSAI setup define all requirements and successfully launch an ad-insertion deployment with Nowtilus. While not all questions directly impact the technical feasibility of server-side ad insertion, they are relevant for understanding and adapting the underlying over-the-

Files

Published August 25th, 2025 by Karolina Dziewierz

Create deals

Published April 21st, 2025 by Karolina Dziewierz

Overview  Once you've configured the targeting settings for your upcoming deal in the Media Planning module, click Create a deal to move forward with the next steps in the deal creation process. These include configuring the deal settings, such as the deal name, start and end dates, and buyer seat; setting up the pricing details to define how the de

Content metadata targeting

Published April 15th, 2025 by Karolina Dziewierz

Overview Content metadata, mainly relevant to Connected TV (CTV) environments, describe the content in which impression opportunities are available. It involves using specific information about content to deliver targeted ads. Access To access content metadata targeting, select Media Planning from the navigation menu. The content metadata targeting

Configure and optimize deals

Published March 26th, 2026 by Karolina Dziewierz

Overview The Maestro AI agent helps you create, edit, and optimize deals using natural language. It can propose deal configurations, refine existing deals, provide suggestions based on media plan context, and offer insights to improve delivery and performance. When creating or editing deals, the Maestro AI agent takes available inventory into accoun

Request SSAI-enabled stream

Published August 5th, 2025 by Karolina Dziewierz

Overview This document explains the schema and parameters of the HLS live manifest URL used for server-side ad insertion. The URL contains placeholders that must be replaced with the appropriate values for each request. HLS live manifest URL The manifest URL and its parameters use the following schema: https://$DOMAIN/hls/$CHAN_ID/master.m3u8?api-ke

SSAI stream preparation

Published August 7th, 2025 by Karolina Dziewierz

Overview This document outlines the requirements and best practices for preparing HLS and DASH streams for Serverside.ai. Following these standards ensures optimal streaming quality and user experience. General requirements The manifest must satisfy the following requirements: Manifests must be accessible on the public internet via the origin (PULL)

Create in-stream video insertion

Published May 22nd, 2025 by Karolina Dziewierz

About in-stream video insertions With in-stream video insertions, you can run video ads embedded in video content. For instance, you can display one or multiple pre-roll ads to be played before the video content. Video formats Your service contact at Equativ will enable the in-stream video formats in your network. They are listed under Inventory >

Explore client portal resources

Published June 16th, 2025 by Karolina Dziewierz

Overview  The client portal is your central access point for all of Equativ’s support resources, tools, and communication channels. This article provides an overview of the key features and essential information you will use regularly when working in the client portal. Access The client portal is accessible without logging in.  However, to submit a

Server-to-server requests and SSAI configuration

Published August 19th, 2025 by Karolina Dziewierz

Overview Serverside.ai enables integration with both certified third-party ad servers and your own ad server through a generic connector, supporting server-to-server ad requests, SSAI inventory management, and advanced audience targeting.  This documents provides the requirements, structure, and parameter configuration needed to maximize ad delivery

Live stream and AVOD targeting

Published September 1st, 2025 by Karolina Dziewierz

Overview Live stream and AVOD targeting lets you choose to include or exclude live or on demand video content in your campaigns and deals. The options are defined as follows: Live stream: displays ads only during live, real-time videos such as sports, concerts, or broadcasts. AVOD (Advertising-Based Video On Demand): displays ads only on recorded or

Geolocation targeting

Published April 7th, 2025 by Karolina Dziewierz

Overview Geolocation enables ads to be shown to users based on their physical location. You can define targeting criteria manually or import a list of postal codes. Equativ relies on data from third-party providers to support geolocation targeting. Access To access geolocation targeting, select Media Planning from the navigation menu. The geolocatio

Get started with deal management

Published April 24th, 2025 by Karolina Dziewierz

Overview  In Maestro, a deal represents a predefined commercial agreement used to facilitate programmatic media transactions. Each deal outlines how inventory will be made available to buyers, under what conditions, and at what price. Deals are essential for enabling curated access to inventory and establishing clear terms between sellers and demand

Timeshift and startover for HLS and DASH live streams

Published August 18th, 2025 by Karolina Dziewierz

Overview This document provides a detailed explanation of the Timeshift and Startover features, including their purpose, usage, and configuration. Timeshift playback with ad replacement Serverside.ai requests the playlist and manifest from the source and stores them in the channel cache for the configured period. This includes both content segment r

Supply seller defined audiences and contexts

Published May 23rd, 2025 by Karolina Dziewierz

Overview  Seller Defined Audiences (SDA) and Seller Defined Context (SDC) are IAB Tech Lab specifications helping publishers in leveraging their first-party data to monetize their audiences/contexts. SDA/SDC work without the need to use ID-based identity solutions, such as third-party cookies or universal ID solutions. Instead, publishers translate

Link and exclude ads

Published June 4th, 2025 by Karolina Dziewierz

Insertion links With insertion links, you can ensure that creatives from multiple insertions always appear together on the page. When the page loads, either all linked insertions will be displayed on the page's formats or no linked insertion at all. Insertion links require OneCall ad requests. For more information about OneCall, see One call and Sta

GET Ad request API

Published May 21st, 2025 by Karolina Dziewierz

Overview This article describes Equativ’s GET Ad API, which is based on the HTTP GET method, mainly used for in-stream video and in Connected TV environments. Note that the HTTP POST method is the preferred method for any HTTP POST compatible integration. See POST Ad request API: usage and POST Ad request API: parameter reference for more details. 

Tagging guide: advanced operations

Published May 16th, 2025 by Karolina Dziewierz

Overview This article describes extra features you can use for Equativ ad tags.  Refreshing ads To refresh ads, use the sas.refresh([formatId], [options]) method. sas.refresh([formatId]) / sas.refresh([tagId]) When using sas.refresh, the following rules apply for the formatId:   the formatId can be integer, string or array if no formatId is specifie

Requirements for inline video creatives

Published August 20th, 2025 by Karolina Dziewierz

Overview This document outlines the technical and general requirements for inline video creatives, including video and audio specifications. General requirements The following are the general requirements for inline video creatives: The container format must be mp4 (ISO/IEC 14496-14).  The video duration should be 5, 10, 15, 20, 25, 30, or 60 second

VAST tracking: Live - DASH

Published August 13th, 2025 by Karolina Dziewierz

Overview This document provides an overview of client-side VAST tracking for Serverside.ai DASH live streams. It explains how to fetch VAST data, track ad playback events, and integrate with the player timeline. The instructions cover both DASH event timeline events and standard HTML5 video element events for comprehensive tracking. DASH live stream

Welcome to Maestro help center

Published May 9th, 2025 by Karolina Dziewierz

Overview Maestro is a platform that connects media buyers who are looking to purchase advertising space (demand side) with publishers who sell their ad inventory using the Equativ Monetization Platform (supply side).  It includes two main modules, that is, Media Planning and Activation, each designed to address different needs on the demand side, an

Monthly Product Update Maestro: January 2026

Published February 10th, 2026 by Karolina Dziewierz

Improved sorting capabilities Your browser does not support HTML5 video. Sorting is now supported for metric columns in campaigns, line items, and deals, enabling you to order metrics such as Spend, Impressions, Clicks, CTR, CPM, CPC, and more in ascending or descending order.  Documentation: Keep track of campaigns Setting performance goals Your br

Tagging guide: implementation

Published May 20th, 2025 by Karolina Dziewierz

Overview  This article describes implementation examples of Equativ ad tags for both OneCall and Standard call implementations. OneCall tagging with HTTP POST request method With OneCall tagging, you can call all the formats of a given page in a single call, rather than each format separately.  OneCall tags use the HTTP POST request method rather th

Ad format targeting

Published April 7th, 2025 by Karolina Dziewierz

Overview Publishers use ad formats to set the behavior, shape, and size of displayed ads. By configuring ad format targeting, you ensure to reach inventories where the ads match the specified behavior, shape, and size. For more information about creative specifications of the ad formats, see Open RTB creative specs . Access To access ad format targe

Ad-marker specification

Published August 7th, 2025 by Karolina Dziewierz

Overview This document explains how Serverside.ai uses SCTE-104 and SCTE-35 signals to manage ad breaks and enable dynamic ad insertion in live and VoD streams. SCTE signals for dynamic ad insertion SCTE-104 information is injected into an SDI signal during the playout of a TV program or live event. It marks cue-out and cue-in points to create room

DMP integration

Published August 19th, 2025 by Karolina Dziewierz

Overview This document provides an overview of integrating Serverside.ai with a customer’s Data Management Platform (DMP). DMP integration Serverside.ai can seamlessly integrate with your customer's DMP to access enriched user data, thereby enhancing the overall advertising experience.   Preconditions Before integrating with a DMP, ensure the follow

Ad server parameters: Google Ad Manager

Published August 19th, 2025 by Karolina Dziewierz

Overview The client can set certain parameters at a per-session level by including them as URL parameters in the initial session request. This document describes the available query parameters and how they are used to configure ad requests in Google Ad Manager. Query parameters The following table lists the query parameters that can be included in t

Creative enhancement parameters

Published March 11th, 2026 by Karolina Dziewierz

When you select an enhancement, you might need to configure additional parameters. The available parameters depend on the enhancement type and the inventory it applies to. Enhancement layout for instream CTV and OLV enhancements  For instream CTV and OLV enhancements, you can configure the visual placement and styling in the Enhancement Layout secti

Explore deals and market context

Published March 26th, 2026 by Karolina Dziewierz

Overview The Maestro AI agent includes a smart search capability that can access both Maestro data and public web sources. This lets you explore your deals and obtain additional market context using natural language queries. Internal search in Maestro You can ask questions about your deals in natural language. The agent searches your existing deals

Troubleshoot deals

Published April 24th, 2025 by Karolina Dziewierz

Overview The Troubleshooting tool helps identify and resolve issues that might affect deal performance. Its Bid status chart visually represents, with numbers, the stages at which ad opportunities exit the auction process. Additionally, it offers detailed statistics on the bid status, providing valuable insights that are crucial for resolving issues

Equativ advertiser and creative policy

Published March 11th, 2025 by Karolina Dziewierz

Overview   This Equativ policy describes the digital advertising standards applicable to any advertising agency, demand-side platform, or advertiser using Equativ’s Services. The policy includes prohibited advertiser content with possible exceptions and customizations as well as prohibited creative attributes and creative behavior types. Prohibited

Create Serverside.ai account

Published August 5th, 2025 by Karolina Dziewierz

Reach out to your contact at Equativ for registration instructions.    

Generic VAST Adapter (GVA)

Published August 19th, 2025 by Karolina Dziewierz

Overview The Generic VAST Adapter (GVA) allows integration with any VAST-serving ad server. This document explains the technical requirements, request and response parameters, and deliverables needed for GVA setup. Generic VAST Adapter (GVA) With the GVA (Generic VAST Adapter), Serverside.ai offers a versatile and efficient solution for seamless int

REST API: overview

Published August 21st, 2025 by Karolina Dziewierz

Overview This document covers the Serverside.ai API, including secure API key management, request rate limits and monitoring, and guidance on limits and exceptions. A basic understanding of APIs, OTT video, and video advertising is assumed. API key All access is protected with a customer-specific API key, initially generated within the Serverside.ai

Create programmatic guaranteed deal for header bidding

Published May 28th, 2025 by Karolina Dziewierz

Overview Header Bidding with prebid.js allows you to connect Equativ as a bidder to the prebid.js wrapper in the header of the page while using your primary ad server (Google Ad Manager, Xandr, etc.) to display either Equativ's winner ad, a winning ad from another SSP (bidder), a direct campaign or another RTB ad. This type of usage is what Equativ

PauseLiveTV

Published August 18th, 2025 by Karolina Dziewierz

Overview This document provides a detailed explanation of the PauseLiveTV feature, including its purpose, usage, and configuration. This feature complements Playlist size for live and shares some of its requirements. PauseLiveTV requires both backend configuration and a playback request parameter.   Ad replacement behavior When the absolute playlist

Open RTB creative specs

Published March 10th, 2025 by Karolina Dziewierz

Overview  This article lists the creative specifications for the ad formats available to target in the Maestro platform. Adhering to these specifications ensures compliance with platform requirements and allows for efficient integration and optimal performance across placements. Banner types The following table provides an overview of different bann

Create private auction and preferred deal (new workflow)

Published May 23rd, 2025 by Karolina Dziewierz

About private auctions and preferred deals Private auctions and preferred deals are agreements between publishers and buyers that are set up on the supply side (Equativ) and the demand side (DSP) and are identified through a unique identifier.  Private auctions are for a limited set of buyers where eligible impressions are purchased via first-price

Create line item: Inventory Insights

Published April 28th, 2025 by Karolina Dziewierz

The Inventory Insights offer a detailed view of available inventory and historical CPM data based on your targeting and supply criteria. They present the data in clear, interactive charts for easier analysis.  For more information, see Get inventory insights .

Get started with creative enhancements

Published March 11th, 2026 by Karolina Dziewierz

Overview Creative enhancements are visual upgrades that apply automatically to your existing ads on the Equativ exchange. You don't need to rebuild or re-upload creatives as Equativ adds an enhancement layer to your existing assets. The system renders enhancements at auction time. This allows you to maintain your current workflow with existing creat

Channels: API routes

Published August 21st, 2025 by Karolina Dziewierz

Overview This document describes the channels API, which provides endpoints to create, retrieve, update, enable, and delete streaming channels in the Serverside.ai platform. It also outlines the full channel JSON schema and the required fields for channel configuration. Channels: GET schema GET  https://mydomain.com/api/v2/channels/schema Returns th

Ad server parameters: Freewheel

Published August 19th, 2025 by Karolina Dziewierz

For information on Freewheel ad server parameters, contact Serverside.ai support.  

SSAI stream protection

Published August 7th, 2025 by Karolina Dziewierz

Overview This document explains how to protect SSAI live and VoD content streams using token authentication and DRM. It also covers implementation details for FairPlay (HLS) and CENC (DASH) encryption. Content protection There are two main ways to protect the source stream: Token authentication of the manifest URL. Encryption (DRM) of the video and

Sync cookies in server to server integrations

Published June 4th, 2025 by Karolina Dziewierz

Overview  In programmatic advertising, buyers need to rely on user identification for many purposes. If Equativ is integrated client side, Equativ has direct access to the website through the Equativ ad tags implemented there. In this case, user identification works seamlessly.  If Equativ is integrated server side, user identification is not availa

Create users

Published April 17th, 2025 by Karolina Dziewierz

Overview A user can perform various tasks in the platform depending on their assigned role, such as viewing or booking deals and managing other users. The first user is assigned the Administrator role when Equativ sets up a Maestro company. This user can then create new user accounts and associate them with the company. For more information, see Get

Get started with activation

Published April 25th, 2025 by Karolina Dziewierz

Overview The Activation module is an end-to-end buying solution that extends the capabilities of Maestro to provide a single platform for Equativ premium inventory curation and trading. It lets you manage advertisers, deliver campaigns, organize line items and creatives, and monitor performance in real time. With the Activation module, you get acces

Reports: API routes

Published August 22nd, 2025 by Karolina Dziewierz

Overview This document describes the Serverside.ai API routes for accessing systems and reports. Systems: GET systems GET https://mydomain.com/api/v2/systems This API route lists all your systems. Each system has a unique ID, which is required when listing or querying reports. Path parameters Field Type Description x-api-key string Your Serverside.a

SSAI authentication

Published August 12th, 2025 by Karolina Dziewierz

Overview This document describes how to access protected SSAI endpoints and lists the device platforms and players supported for SSAI-enabled streams. For each SSAI-enabled stream (VoD endpoint or live channel), a dedicated API key is generated. This key is required for every playback request and must be included in the URL as the api-key parameter.

Environment and device targeting

Published April 7th, 2025 by Karolina Dziewierz

Overview You can target environments and devices to control where your ads are displayed. This type of targeting allows you to reach users based on the environments they operate in and the devices they use. For environment targeting, you can choose to target either all inventory or only Open Measurement SDK (OM SDK) inventory. OM SDK is an IAB stand

Report dimensions

Published May 8th, 2025 by Karolina Dziewierz

Overview This article provides definitions for the dimensions available in Maestro’s Instant Insights, Instant Report Builder, and Reporting API. Report dimensions Columns The list in section “Dimension list”, later in this document, contains each dimension with the following details: Name: the dimension name, mainly named according to the name used

Protection against invalid traffic

Published February 26th, 2025 by Karolina Dziewierz

Overview   Equativ prevents invalid traffic (IVT) using HUMAN Security’s advanced detection technology, scanning all traffic pre-bid to filter out bots and fraud. This article explores invalid traffic (IVT) and details how Equativ addresses it. Access Invalid traffic detection is automatically enabled on all programmatic campaigns running through Eq

Work with deals

Published April 22nd, 2025 by Karolina Dziewierz

Overview  Deals can be managed using a variety of actions, each designed to give you full control over your deal configurations. These actions enable you to modify deal settings, duplicate deals, delete them, or review their history. Specifically, you can:  Edit: adjust the settings of a deal to meet your needs.  Copy: create a new deal by duplicati

Get started with media planning

Published April 18th, 2025 by Karolina Dziewierz

Overview The Media Planning module presents the inventory of publishers using Equativ’s Monetization Platform (SSP) to potential media buyers, including estimates of available ad opportunities. Based on the output of media planning, media buyers can then create deals with optimal settings. Media planning is solely used for inventory discovery, integ

Create and manage campaigns

Published April 25th, 2025 by Karolina Dziewierz

Overview Once you've created an advertiser, you can launch a campaign. This guide walks you through setting up a campaign, choosing budgets, selecting delivery modes, and applying delivery capping. It also includes examples to show how different settings affect delivery, helping you make the most of your budget. Campaigns automatically use Supply Pa

Ad server parameters: Equativ / Smart AdServer

Published August 19th, 2025 by Karolina Dziewierz

Overview Use the following example VAST tag to configure your ad requests for integration with Equativ (formerly Smart AdServer). Replace the placeholder values, such as [playerHeight], [playerWidth], or [timestamp] with your dynamic parameters. Example tag https://videoapi.smartadserver.com/ac?siteid=425856&pgid=1403635&fmtid=101815&ab=

Work with line items

Published April 28th, 2025 by Karolina Dziewierz

Overview Line items can be managed using a variety of actions, each designed to give you full control over your configurations. Specifically, you can:  Edit: adjust the settings of a line item. Duplicate: create a new line item by duplicating an existing one, with the option to modify settings as needed.  Archive: archive a line item that is no long

Channels: overview

Published August 21st, 2025 by Karolina Dziewierz

A channel is a video stream into which adverts are automatically inserted by the Serverside.ai system. Advertisements can originate from various sources (for example, Equativ, SpotX, FreeWheel, or Google), and the source must be specified as part of the channel. Before using the Channels API, make sure you know which ad source will be used and enter

Keep track of campaigns

Published June 9th, 2025 by Karolina Dziewierz

Overview You can monitor campaigns to track their performance and ensure optimal outcomes. This can be achieved through the following methods: Monitor campaigns with the Campaigns list: view and filter campaigns based on various criteria, track KPIs, and monitor the delivery data. Monitor campaign s with Instant Insights : gain detailed, data-driven

Set up account

Published August 20th, 2025 by Karolina Dziewierz

Overview As the first self-manageable SSAI solution on the market, Serverside.ai provides a convenient and easy-to-use interface. This document covers account setup, user management, and notification settings. Create account Reach out to your contact at Equativ for registration instructions. Add users To add additional users to your company account,

Implementation requirements

Published August 5th, 2025 by Karolina Dziewierz

Overview This document explains the systems, components, and content-specific requirements needed to implement Serverside.ai for both live linear streaming and video on demand (VoD), including guidance on demonstration channels and the onboarding checklist. System requirements Before incorporating Serverside.ai into your video business, ensure that

Ad-marker specification: SSAI live - SCTE35

Published August 5th, 2025 by Karolina Dziewierz

Overview This document describes the SCTE-35 marker requirements for ad insertion in live and VoD content.  SCTE-35 marker requirements  For accurate ad insertion or replacement, the type and timing of the SCTE-35 marker are critical and must meet the following requirements:  The signal must follow the SCTE-35 specification.  The signal must include

Set up and manage client-side header bidding

Published May 30th, 2025 by Karolina Dziewierz

About this article This article explains the prebid.js setup in Equativ’s user interface. The setup of Equativ as a bidder on the client side (publisher's website) is explained in Supply inventory with prebid.js header bidding . Read Supply inventory with Prebid server  for the setup of Prebid Server in Equativ’s UI. Activation Using Equativ as a de

Create meta-deals

Published April 23rd, 2025 by Karolina Dziewierz

Overview  A meta-deal functions as a "parent" deal that aggregates multiple "child" deals, allowing for simplified targeting and management. Like any other deal, a meta-deal has its own deal ID. Instead of targeting each individual child deal separately in DSPs, you can use the single meta-deal ID to target all associated deals at once.  Meta-deals

Introduction to Monthly Product Updates

Published July 16th, 2025 by Karolina Dziewierz

Equativ's Monthly Product Updates are summaries of all product releases from the previous month, published on this documentation portal.  Each update includes:   The name of the released feature  A short screen recording for illustration, if applicable  A brief description of the feature  Links to documentation or other relevant resources  Once publ

Tagging guide: get started

Published May 22nd, 2025 by Karolina Dziewierz

Overview This guide is addressed to web developers. It describes the available ad tag types available in Equativ’s Monetization Platform (EMP) as well as the main functions and options to configure the tagging.  Ad tags  Generate ad tags For instructions on generating ad tags, see the "Ad tags" section in the Create placements article. Ad tag types

VAST tracking

Published August 13th, 2025 by Karolina Dziewierz

Overview There are two ways to report ad playback: client-side and server-side tracking. While Serverside.ai includes server-side tracking by default and requires no additional setup, it might not be suitable for all use cases. To enable client-side tracking, additional implementation is required in your app or website. VAST standard The IAB (Intera