Outbrain: Most-used fields

The average value generated per conversion event. This metric helps evaluate the efficiency of conversions.

The rate at which ad engagements (e.g., clicks) lead to a conversion event. It is calculated as (Conversions / Clicks or Impressions) * 100%.

The total number of conversion events recorded for a campaign or promoted content.

The Cost Per Acquisition (CPA), which is the average cost incurred to achieve one conversion event.

The Return On Ad Spend (ROAS), which indicates the revenue generated for every unit of currency spent on advertising.

The sum of values for all recorded conversion events.

The average value generated per conversion across all conversions tracked.

The aggregate total number of all conversion events, often including different types of conversions or across various campaigns.

The total cost per acquisition (CPA) for all conversions, calculated as the total spend divided by the total number of conversions. This metric helps evaluate the efficiency of campaigns in acquiring conversions.

The total return on ad spend (ROAS) for all conversions, indicating the revenue generated for every unit of currency spent on advertising. This metric is crucial for assessing campaign profitability.

The sum of values for all conversions recorded. This represents the total value attributed to successful conversion events.

The average value generated per view-through conversion. View-through conversions occur when a user sees an ad but does not click on it, and later completes a conversion.

The rate at which ad views lead to view-through conversions, calculated as the number of view-through conversions divided by the total number of ad impressions.

The total number of view-through conversions. A view-through conversion is attributed to an ad impression (view) rather than a direct click.

The sum of values for all view-through conversions recorded. This represents the total value attributed to conversions that occurred after an ad view.

The date of the report or metric breakdown.

The end date for the requested report data range.

The start date for the requested report data range.

A boolean value indicating whether the promoted link can be edited, which is true if its approval review status is pending.

The current approval status of the promoted link, indicating if it is Approved, Pending review, or Rejected.

Designates whether the promoted link is archived.

The average monetary amount reported for conversions from clicks.

An object containing details about the budget allocated for a campaign or shared across campaigns.

The monetary amount of this budget.

The unspent monetary amount remaining on this budget.

The monetary amount spent from this budget.

The time when this budget was created.

The currency denomination applied to the budget amount.

The maximum amount of money allowed to be spent per day for a campaign. This field is mandatory when the pacing is set to 'DAILY_TARGET' and represents the daily budget for advertising campaigns.

The date this budget is scheduled to stop spending.

The unique identifier of this budget.

The last modification date of this budget.

The name of this budget.

Controls how fast the budget will be spent, such as SPEND_ASAP, AUTOMATIC, or DAILY_TARGET.

Designates whether the budget has an end date. If true, the endDate attribute will not be used.

Indicates whether the budget is shared between multiple campaigns.

The date this budget is scheduled to begin spending.

Controls on which period the budget refreshes, such as CAMPAIGN (one-time), MONTHLY, or DAILY.

The URL of the PromotedLink's logo image, cached on Outbrain's servers.

Indicates whether the campaign is currently enabled.

The unique identifier of the campaign.

The unique identifier for the campaign.

The name of the campaign.

Indicates whether the campaign is currently active and serving.

The reason for the campaign's current on-air status, such as campaign disabled, budget capped, or waiting for start hour.

The category of the conversion event, such as PURCHASE, LEAD, or VIDEO_VIEW.

The total number of PromotedLinks clicks across the entire query range.

The average rate of conversions from clicks per click percentage.

The time in days from click to conversion that is tracked for a conversion event.

The total number of conversions from clicks across the entire query range.

The average Cost Per Acquisition (CPA) calculated for conversions from clicks.

The cost per click for the campaign or promoted link.

Cost per thousand impressions (CPM), calculated by dividing the amount spent by impressions multiplied by 1000.

The time when the promoted link was created.

The date when the entity (e.g., marketer, campaign, promoted link, budget, or conversion event) was created.

The creative format of the campaign, such as Standard, AppInstall, Carousel, or Clip.

The average Click Through Rate (CTR) percentage, calculated as (clicks / impressions) * 100.

The three-letter ISO 4217 code for the currency used for financial values like budget amounts or conversion order values.

The Digital Services Tax (DST) added in some targeted countries.

The effective (calculated) average Cost Per Click (CPC), calculated as spend / clicks.

Designates whether this promoted link will be served.

The first day of the result date period for a report.

The code identifying the geographic entity.

The unique identifier of the geographic entity.

The name of the geographic entity.

A unique identifier for an entity such as a marketer, budget, campaign, or promoted link.

A unique identifier for an entity within the Outbrain Amplify platform. The specific entity it identifies (e.g., campaign, marketer, promoted link) depends on the context of the report or data being processed.

The unique identifier for the image associated with a promoted link.

The URL of the image with its original dimensions, as provided by Outbrain.

The URL of the image formatted to the requested dimensions for a promoted link.

The total number of PromotedLinks impressions across the entire query range.

Indicates whether a conversion event is included in total conversions reporting.

The time when the promoted link was last modified.

The date when the entity (e.g., marketer, campaign, promoted link, budget, or conversion event) was last modified.

The unique identifier of the marketer account.

The name of the marketer account.

The descriptive name of an entity such as a marketer, budget, campaign, or conversion event.

The objective of the campaign, such as Awareness, Traffic, Conversions, or AppInstalls.

The platform where the content was consumed, such as DESKTOP, MOBILE, or TABLET.

The unique identifier of the promoted link.

The unique identifier of the publisher.

The name of the publisher.

Return On Ad Spend (ROAS) calculated as total conversion value attributed to clicks, divided by spend.

The unique identifier of the section within a publisher's site.

The name of the section of the site where the PromotedLink URL points to.

The conversion segment associated with an event, if it exists.

The total amount of money spent across the entire query range.

The total monetary amount reported for conversions from clicks.

The text or headline of the promoted link.

The headline or title text for the promoted content or promoted link sequence.

The last day (inclusive) of the result date period for a report.

The average monetary amount reported for all conversions (including view-through).

The total number of all conversions (including view-through) across the entire query range.

The average Cost Per Acquisition (CPA) calculated for all conversions (including view-through).

Total Return On Ad Spend (ROAS) calculated as total conversion value attributed to clicks or views, divided by spend.

The total monetary amount reported for all conversions (including view-through) for the entire query range.

Indicates the tracking status of the conversion event or segment, such as active or inactive.

This field indicates the report type from which the data was collected. The Outbrain Amplify API provides various report types, such as Campaigns, Periodic Content, Publishers, Sections, Geo by Campaign, Platforms by Campaign, Conversion Events, Interest Performance, and Promoted Content, each offering different performance metrics and metadata.

The URL visitors will be sent to upon clicking the promoted link.

The average monetary amount reported for view-through conversions.

The average rate of view-through conversions per viewable impression percentage.

The total number of view-through conversions across the entire query range.

The total monetary amount reported for view-through conversions for the entire query range.

The average value generated per conversion event.

The percentage of interactions (e.g., clicks or impressions) that resulted in a conversion.

The total number of conversion events recorded.

The average cost incurred for each conversion event (Cost Per Acquisition/Conversion).

The total cumulative value generated by all conversion events.

The overall average value across all reported conversion events for the selected scope.

The grand total number of conversions, potentially including all types or across all campaigns/marketers.

The overall cost per acquisition across all reported conversion events for the selected scope.

The grand total value generated by all conversions for the selected scope.

The average value generated per conversion event attributed to ad views (view-through conversions).

The conversion rate specifically for conversions attributed to ad views (view-through conversions).

The number of conversions attributed to ad views (view-through conversions).

The total value generated by conversions attributed to ad views (view-through conversions).