API ReferenceAnnouncementsCommunity Discussion
API ReferenceCommunity DiscussionAnnouncementsLog In
API Reference

Standard Columns

Standard columns contain performance metrics and are present for most dimensions.

NameTypeDescription
clicksNumberTotal clicks
impressionsNumberTotal Number of Served Ads

Corresponds to the Served Ads column in Realize.

To measure impressions, use visible_impressions (as per MRC guidelines).
visible_impressionsIntegerTotal number of viewable impressions
(At least 50% of the pixels were visible.)

This is the recommended metric for impressions, and corresponds to the Impressions column in Realize.
spentMoneyTotal spent (on campaign bidding)
conversions_valueMoneyTotal revenue from conversions
roas PercentReturn On Ad Spend (%)
= conversions_value/spent
roas_clicksPercentReturn On Ad Spend for Click Through Conversions (%)
roas_viewsPercentReturn On Ad Spend for View Through Conversions (%)
ctrPercent= Clicks/Impressions

This column is deprecated. Use vctr instead (as per MRC guidelines).
vctrPercentAverage viewable CTR (Click-Through Rate).

Calculated as Clicks/Viewable Impressions

This is the recommended metric for click-through rate, and corresponds to the CTR column in Realize.
cpmMoneyCost Per 1000 Impressions
= spent/impressions * 1000
vcpmMoneyCost Per 1000 Viewable Impressions
= spent/visible_impressions * 1000
cpcMoney(Actual) Cost Per Click
= spent/clicks
campaigns_numLongNumber of campaigns
(visible for relevant dimensions only e.g. day, week, month)
cpaMoneyCost Per Action (Conversion)
= Spent/Conversions
(considers all conversions)
cpa_clicksMoneyClick Cost Per Action (Conversion)
= Spent/Click Through Conversions
(considers conversions attributed via click throughs only)
cpa_viewsMoneyView Cost Per Action (Conversion)
= Spent/View Through Conversions
(considers conversions attributed via view throughs only)
cpa_conversion_ratePercentConversion Rate (%)
= Conversions/Clicks
(considers all conversions)
cpa_conversion_rate_clicksPercentClick Conversion Rate (%)
= Click Through Conversions/Clicks
(considers conversions attributed via click throughs only)
cpa_conversion_rate_viewsPercentView Conversion Rate (%)
= View Through Conversions/Clicks
(considers conversions attributed via view throughs only)
cpa_actions_numIntegerTotal number of actions (conversions)
cpa_actions_num_from_clicksIntegerTotal number of click through actions (conversions)
Look-back window is configurable per conversion rule (default = 30 days)
cpa_actions_num_from_viewsIntegerTotal number of view through actions (conversions)
Look-back window is configurable per conversion rule (default = 24 hours)
currencyStringThe currency for columns of type Money.

An ISO 4217 currency code.

📘

ROAS

In order to report on conversions_value and roas, you must do either of the following:

  1. Assign a static conversion value to a given conversion.
  2. Pass dynamic conversion values.

    If you are using the Taboola Shopify App, the App will pass the purchase value to Taboola dynamically.

🚧

Attribution

To enable click-through and view-through attribution:

  1. Integrate Taboola Pixel in your landing pages.
  2. Set your attribution settings in Taboola Ads to clicks and view-through.