Outbrain: Most-used fields#
The table below gives information about most-used fields that you can import from Outbrain. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
Conversions.averageValue Metric
The average value generated per conversion event. This metric helps evaluate the efficiency of conversions.
Conversions.conversionRate Metric
The rate at which ad engagements (e.g., clicks) lead to a conversion event. It is calculated as (Conversions / Clicks or Impressions) * 100%.
Conversions.conversions Metric
The total number of conversion events recorded for a campaign or promoted content.
Conversions.cpa Metric
The Cost Per Acquisition (CPA), which is the average cost incurred to achieve one conversion event.
Conversions.roas Metric
The Return On Ad Spend (ROAS), which indicates the revenue generated for every unit of currency spent on advertising.
Conversions.sumValue Metric
The sum of values for all recorded conversion events.
Conversions.totalAverageValue Metric
The average value generated per conversion across all conversions tracked.
Conversions.totalConversions Metric
The aggregate total number of all conversion events, often including different types of conversions or across various campaigns.
Conversions.totalCpa Metric
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.
Conversions.totalRoas Metric
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.
Conversions.totalSumValue Metric
The sum of values for all conversions recorded. This represents the total value attributed to successful conversion events.
Conversions.viewAverageValue Metric
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.
Conversions.viewConversionRate Metric
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.
Conversions.viewConversions Metric
The total number of view-through conversions. A view-through conversion is attributed to an ad impression (view) rather than a direct click.
Conversions.viewSumValue Metric
The sum of values for all view-through conversions recorded. This represents the total value attributed to conversions that occurred after an ad view.
Date Dimension
The date of the report or metric breakdown.
Report End Date Dimension
The end date for the requested report data range.
Report Start Date Dimension
The start date for the requested report data range.
Ticketconfirmation.averageValue Metric
The average monetary value generated per conversion event for ticket confirmations.
Ticketconfirmation.conversionRate Metric
The rate at which users complete a desired action, such as a ticket confirmation, after interacting with an ad.
Ticketconfirmation.conversions Metric
The total number of completed desired actions, such as ticket confirmations, recorded.
Ticketconfirmation.cpa Metric
The Cost Per Acquisition (CPA) for ticket confirmations, representing the average cost to achieve one conversion.
Ticketconfirmation.sumValue Metric
The total monetary value generated from all ticket confirmation conversion events.
approvalStatus.isEditable Dimension
A boolean value indicating whether the promoted link can be edited, which is true if its approval review status is pending.
approvalStatus.status Dimension
The current approval status of the promoted link, indicating if it is Approved, Pending review, or Rejected.
archived promotedLinkArchived Dimension
Designates whether the promoted link is archived.
averageValue Metric
The average monetary amount reported for conversions from clicks.
budget Dimension
An object containing details about the budget allocated for a campaign or shared across campaigns.
budget.amount Metric
The monetary amount of this budget.
budget.amountRemaining Metric
The unspent monetary amount remaining on this budget.
budget.amountSpent Metric
The monetary amount spent from this budget.
budget.creationTime Dimension
The time when this budget was created.
budget.currency Dimension
The currency denomination applied to the budget amount.
budget.dailyTarget Metric
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.
budget.endDate Dimension
The date this budget is scheduled to stop spending.
budget.id Dimension
The unique identifier of this budget.
budget.lastModified Dimension
The last modification date of this budget.
budget.name Dimension
The name of this budget.
budget.pacing Dimension
Controls how fast the budget will be spent, such as SPEND_ASAP, AUTOMATIC, or DAILY_TARGET.
budget.runForever Dimension
Designates whether the budget has an end date. If true, the endDate attribute will not be used.
budget.shared Dimension
Indicates whether the budget is shared between multiple campaigns.
budget.startDate Dimension
The date this budget is scheduled to begin spending.
budget.type Dimension
Controls on which period the budget refreshes, such as CAMPAIGN (one-time), MONTHLY, or DAILY.
cachedImageUrl promotedLinkCachedImageUrl Dimension
The URL of the PromotedLink's logo image, cached on Outbrain's servers.
campaignEnabled Dimension
Indicates whether the campaign is currently enabled.
campaignId Dimension
The unique identifier of the campaign.
campaignIdentifier Metric
The unique identifier for the campaign.
campaignName Dimension
The name of the campaign.
campaignOnAir Dimension
Indicates whether the campaign is currently active and serving.
campaignOnAirReason Dimension
The reason for the campaign's current on-air status, such as campaign disabled, budget capped, or waiting for start hour.
campaignOptimization.automaticModeMaxAvgDailyCpc Metric
The maximum average daily Cost Per Click (CPC) that a campaign is permitted to reach when using MAX_CONVERSION_FULLY_AUTOMATED, TARGET_ROAS_FULLY_AUTOMATED, and TARGET_CPA_FULLY_AUTOMATED optimization types.
campaignOptimization.baseCpc Metric
The latest Cost Per Click (CPC) value updated by the user for campaigns using TARGET_ROAS_FULLY_AUTOMATED, MAX_CONVERSION_FULLY_AUTOMATED, or TARGET_CPA_FULLY_AUTOMATED optimizations.
campaignOptimization.maxCpcAdjustmentOverManualInFullyAutomated Metric
The maximum percentage by which the algorithm is allowed to increase the campaign's Cost Per Click (CPC) in fully automated optimization modes (MAX_CONVERSION_FULLY_AUTOMATED, TARGET_ROAS_FULLY_AUTOMATED, and TARGET_CPA_FULLY_AUTOMATED).
campaignOptimization.maxCpcBidPercentage Metric
The maximum percentage allowed per serving above the campaign's Cost Per Click (CPC). It is mandatory for CPC optimization and defaults to 1 for fully automated optimization types if not specified.
campaignOptimization.maxCpcRecommendation Dimension
A recommendation provided by the algorithm for automatic campaigns when the Cost Per Click (CPC) cannot be increased, suggesting actions like increasing the bid cap or target CPA.
campaignOptimization.optimizationType Dimension
The strategy used to optimize the campaign, such as maximizing traffic, optimizing for CPC, or targeting specific CPA or ROAS goals.
campaignOptimization.targetConversionId Dimension
The ID of the primary conversion event that the campaign is optimized towards, relevant for CPC and MAX_CONVERSION_FULLY_AUTOMATED optimization types.
category Dimension
The category of the conversion event, such as PURCHASE, LEAD, or VIDEO_VIEW.
clicks Metric
The total number of PromotedLinks clicks across the entire query range.
conversionRate Metric
The average rate of conversions from clicks per click percentage.
conversionWindow Metric
The time in days from click to conversion that is tracked for a conversion event.
conversions Metric
The total number of conversions from clicks across the entire query range.
cpa Metric
The average Cost Per Acquisition (CPA) calculated for conversions from clicks.
cpc Metric
The cost per click for the campaign or promoted link.
cpm Metric
Cost per thousand impressions (CPM), calculated by dividing the amount spent by impressions multiplied by 1000.
creationTime Dimension
The time when the promoted link was created.
creationTime_date Dimension
The date when the entity (e.g., marketer, campaign, promoted link, budget, or conversion event) was created.
creativeFormat Dimension
The creative format of the campaign, such as Standard, AppInstall, Carousel, or Clip.
ctr Dimension
The average Click Through Rate (CTR) percentage, calculated as (clicks / impressions) * 100.
currency Dimension
The three-letter ISO 4217 code for the currency used for financial values like budget amounts or conversion order values.
dstFeeCost Metric
The Digital Services Tax (DST) added in some targeted countries.
ecpc Metric
The effective (calculated) average Cost Per Click (CPC), calculated as spend / clicks.
enabled Dimension
Designates whether this promoted link will be served.
fromDate Dimension
The first day of the result date period for a report.
geoCode Dimension
The code identifying the geographic entity.
geoId Dimension
The unique identifier of the geographic entity.
geoName Dimension
The name of the geographic entity.
id Dimension
A unique identifier for an entity such as a marketer, budget, campaign, or promoted link.
identifier Metric
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.
imageMetadata.id Dimension
The unique identifier for the image associated with a promoted link.
imageMetadata.originalImageUrl Dimension
The URL of the image with its original dimensions, as provided by Outbrain.
imageMetadata.requestedImageUrl Dimension
The URL of the image formatted to the requested dimensions for a promoted link.
impressions Metric
The total number of PromotedLinks impressions across the entire query range.
includeInConversions Dimension
Indicates whether a conversion event is included in total conversions reporting.
lastModified promotedLinkLastModified Dimension
The time when the promoted link was last modified.
lastModified_date Dimension
The date when the entity (e.g., marketer, campaign, promoted link, budget, or conversion event) was last modified.
marketerId Dimension
The unique identifier of the marketer account.
marketerName Dimension
The name of the marketer account.
name Dimension
The descriptive name of an entity such as a marketer, budget, campaign, or conversion event.
objective Dimension
The objective of the campaign, such as Awareness, Traffic, Conversions, or AppInstalls.
platform Dimension
The platform where the content was consumed, such as DESKTOP, MOBILE, or TABLET.
promotedLinkId Dimension
The unique identifier of the promoted link.
publisherId Dimension
The unique identifier of the publisher.
publisherName Dimension
The name of the publisher.
roas Metric
Return On Ad Spend (ROAS) calculated as total conversion value attributed to clicks, divided by spend.
sectionId Dimension
The unique identifier of the section within a publisher's site.
sectionName Dimension
The name of the section of the site where the PromotedLink URL points to.
segment Dimension
The conversion segment associated with an event, if it exists.
spend Metric
The total amount of money spent across the entire query range.
sumValue Metric
The total monetary amount reported for conversions from clicks.
text promotedLinkText Dimension
The text or headline of the promoted link.
title Dimension
The headline or title text for the promoted content or promoted link sequence.
toDate Dimension
The last day (inclusive) of the result date period for a report.
totalAverageValue Metric
The average monetary amount reported for all conversions (including view-through).
totalConversions Metric
The total number of all conversions (including view-through) across the entire query range.
totalCpa Metric
The average Cost Per Acquisition (CPA) calculated for all conversions (including view-through).
totalRoas Metric
Total Return On Ad Spend (ROAS) calculated as total conversion value attributed to clicks or views, divided by spend.
totalSumValue Metric
The total monetary amount reported for all conversions (including view-through) for the entire query range.
trackingStatus Dimension
Indicates the tracking status of the conversion event or segment, such as active or inactive.
type Dimension
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.
url promotedLinkUrl Dimension
The URL visitors will be sent to upon clicking the promoted link.
viewAverageValue Metric
The average monetary amount reported for view-through conversions.
viewConversionRate Metric
The average rate of view-through conversions per viewable impression percentage.
viewConversions Metric
The total number of view-through conversions across the entire query range.
viewSumValue Metric
The total monetary amount reported for view-through conversions for the entire query range.