Pixel Joined Table

The Pixel Joined table shows Pixel-attributed ad performance by channel, campaign, ad set, and ad, combining ad spend with attributed revenue and customer acquisition. One row per ad per day.

📋

Table Guide

What You Can Answer With This Table

  • How do spend, attributed revenue, ROAS, or CPA compare by channel, campaign, or ad? — use spend, order_revenue, pixel_roas, pixel_cpa
  • Which channels are driving new customer acquisition? — use new_customer_orders with channel
  • What are my channel-reported vs Pixel-reported metrics? — compare channel_reported_conversion_value with order_revenue

Before You Query

  • Required field: event_date (by default refers to the purchase date)
  • Attribution defaults: Triple Attribution model and Lifetime attribution window are applied by default.
  • Channel-Reported vs Pixel-Reported: Channel-Reported data (e.g., channel_reported_conversions, channel_reported_conversion_value) comes directly from ad platforms. Pixel-Reported data (e.g., orders_quantity, order_revenue) is captured via the Triple Whale Pixel.
  • Custom events: Custom conversion event columns are added as <Event Name>_conversion (count) and <Event Name>_conversion_value (value). See the custom event tracking docs for setup details.
  • Purchase vs checkout counts: Purchase columns count individual orders/conversions, while checkout columns (checkouts, addresses, shipping, contacts, payments) count unique users per row. This means purchases may exceed checkouts.
  • Unique user pre-aggregation: Metrics that count unique users (e.g., unique_visitors, add_to_carts, checkouts) are pre-aggregated by channel. Queries that don't group by channel will overcount users, because a user active on multiple channels counts once per channel, not once overall.
  • Query limitations: group by attribution_window and group by model may not work on certain complex queries. The Pixel Joined table functions as a simulated view that dynamically processes data, which can introduce constraints compared to typical SQL behavior.
  • Onsite shop counts: Order counts for onsite shop channels (e.g., Meta Shop, TikTok Shop) may differ from Pixel Orders. Both are correct: Pixel Joined uses platform-reported counts from the ads API for onsite channels; Pixel Orders uses pixel-tracked counts, which include organic onsite purchases, but only at the channel level, not by campaign or ad.

Key Relationships

TableJoin KeyUse This Join To
Creativesad_idExplain ad-level attributed performance with creative asset and engagement context
Adsad_idExplain ad-level attributed performance with targeting and ad set context

When to Use a Different Table

  • Use Ads table when you need channel-reported ad platform metrics such as spend, clicks, impressions, or platform-reported conversions. The Pixel Joined table is for Triple Whale-attributed performance by channel, campaign, ad set, or ad.
  • Use Pixel Orders table when you need order-level attribution detail, such as individual orders, click timing, or session data. The Pixel Joined table is for aggregated attributed performance by channel, campaign, ad set, or ad.
  • Use Orders table when you need non-duplicated order totals without attribution. The Pixel Joined table is for attributed performance, and attribution models can create multiple rows from the same order.
  • Use Pixel Keywords Joined table when you need keyword-level attributed revenue or ROAS. The Pixel Joined table is for channel, campaign, ad set, and ad-level attribution.

View the full Triple Whale Data Ontology →

Parameters

Parameters can be used to customize and filter the data in the table, and are applied before aggregation.

TitleIDDescription
City Filtercity_filterFilters results by city.
Country Filtercountry_filterFilters results by country.
Include Custom Ad Spendinclude_custom_ad_spend

Includes custom ad spend in the spend column.

Possible: true, false

Order Tags Filterorder_tags_filterFilters orders by tags. Matches any order containing the specified comma-separated tags.
Sales Platform Filtersales_platform_filter

Filter results by sales platform.

Possible values: shopify, amazon, woocommerce, bigcommerce, walmart, tiktok-shops

Subscription Filtersubscription_filter

Filters results by subscription type.

Possible values:
  • subscription_first_order: Subscription First Order

  • subscription_recurring_order: Subscription Recurring Order

  • subscription_order: Subscription First Order + Subscription Recurring Order

  • non_subscription_order: Non-Subscription Purchases

  • non_subscription_recurring_order: Subscription First Order + Non-Subscription Purchases

Use Click Dateuse_click_date

Uses click date instead of purchase date for event_date.

Possible values: true, false

Dimensions

Dimensions are immutable properties that can be used for grouping data.

TitleIDTypeDescription
Event Hourevent_hourstring

The hour of the day on which the ad was run or the order was placed, according to a 24-hour clock. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).

Example values: 07, 16, 21

Event Dateevent_datedateThe date the ad was run or the order was placed. Based on the shop time zone at the moment of the event (or the user time zone, if no sales platform is connected).
Event Dayevent_date.daydateThe day on which the event occurred. Derived from event_date.
Event Weekevent_date.weekdateThe Sunday of the week during which the event occurred. Derived from event_date.
Event Monthevent_date.monthdateThe month during which the event occurred. Derived from event_date.
Event Quarterevent_date.quarterdateThe first month of the quarter during which the event occurred. Derived from event_date.
Event Yearevent_date.yeardateThe year during which the event occurred. Derived from event_date.
Ad Account IDaccount_idstring

The unique ID for the ad account associated with the ad. Assigned by the ad platform.

Example values: act_2168791943307744, 18ce55770zl, 1986494684391480

Ad Bid Amountad_bid_amountstring

The bid amount for the ad.

Example values: 15, 28, 30

Ad Copyad_copystringThe full text (copy) of the ad.
Ad IDad_idstring

The unique ad ID. Assigned by the ad platform.

Example value: 120210439891110007

Ad Image URLad_image_urlstring

The URL of the ad image.

Example value: https://www.example.com/ad-image.jpg

Ad Manager URLad_manager_urlstring

Direct link to this ad in the advertising platform (Facebook, Google Ads, etc.) for quick access to campaign management and performance data.

Example value: https://adwords.google.com/aw/overview?campaignId=9117023204

Ad Namead_namestring

The internal name of the ad within the ad platform.

Example values: Kids Ad 1, Blog 03/12/2023, 10460_video_black_#5

Ad Statusad_statusstring

The status of the ad.

Example values: ACTIVE, PAUSED

Ad Titlead_titlestring

The external, published title that viewers see when the ad is served.

Example values: UP TO 50% OFF, The Hype Is Real, Trusted by 4 Million+ Women Worldwide

Ad Typead_typestring

The format of the ad.

Example values: video, image, carousel, link, VIDEO, GRAPHIC

Currently available for Meta and Axon.

Ad Set Bid Amountadset_bid_amountstring

The bid amount for the ad set.

Example values: 25, 35, 40

Ad Set Bid Strategyadset_bid_strategystring

The bidding strategy for the ad set.

Example values: LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS

Ad Set IDadset_idstring

The unique ID for the ad set associated with the ad click. Assigned by the ad platform.

Example value: 120210439890740003

Ad Set Nameadset_namestring

The name of the ad set within a campaign.

Example values: Broad Audience, Bracelets, Wellness

Ad Set Statusadset_statusstring

The status of the ad set.

Example values: ACTIVE, PAUSED

Attribution Windowattribution_windowstring

The time frame for attributing conversions to the ad. By default lifetime.

Example values: 1_day, 7_days, 14_days, 28_days, lifetime

Campaign Bid Strategycampaign_bid_strategystring

The bidding strategy for the campaign.

Example values: LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS

Campaign IDcampaign_idstring

The unique ID for the marketing campaign associated with the ad. Assigned by the ad platform.

Example values: 23852438666180053, 531011533, 20620285829

Campaign Namecampaign_namestring

The name of the marketing campaign associated with the ad.

Example values: Catalog Retargeting, US Generic Search, Breakfast of Champions Campaign

Campaign Statuscampaign_statusstring

The status of the campaign.

Example values: ACTIVE, PAUSED

Campaign Typecampaign_typestring

The type of campaign. For Email/SMS data, this maps to report_type.

Example values: PERFORMANCE_MAX, SEARCH, flow, campaign

Channelchannelstring

The platform through which the ad was delivered.

Example values: facebook-ads, google-ads, Direct

Messaging Channel Typechannel_typestring

The messaging channel used to deliver the communication. Populated for email/SMS providers only; NULL for ad platforms.

Example values: email, sms, push

Session Countrycountrystring

The country of the session where the order originated. See list of countries.

Example values: United States, Canada, United Kingdom

MS Session Countryms_countrystring

The marketplace country code of the session. See list of countries.

Example values: US, CA, GB

Creative CTA Typecreative_cta_typestring

The type of call-to-action (CTA) used in the ad.

Example values: Shop Now, Learn More, Sign Up

Creative Distribution Formatcreative_distribution_formatstring

The ad creative distribution format.

Example values: Standard Ad, Dynamic Creative Ad, Unknown

Creative Formatcreative_formatstring

The format of the ad creative.

Example values: SHARE, VIDEO

Creative IDcreative_idstring

The unique identifier assigned to the creative asset by the ad platform.

Example value: 1326015151986179

Destination URLdestination_urlstring

The destination URL where users land after clicking the ad. Currently available for Meta, Google, and Pinterest.

Example value: https://www.myshop.com/products/productA

Attribution Modelmodelstring

The attribution model used. By default Triple Attribution.

Possible values: Total Impact, Triple Attribution, Triple Attribution + Views, Clicks & Views, Linear All, Linear Paid, First Click, Last Click

Shop IDshop_idstring

The unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports.

Example values: example-US.myshopify.com, example-EU.myshopify.com

Shop Nameshop_namestring

The name of the shop. Can be used to group or filter data by shop in multi-store reports.

Example values: example-US, example-EU

URL Templateurl_templatestring

A template URL used to dynamically populate ad URLs with relevant tracking parameters.

Example value: utm_source=facebook&utm_campaign={{campaign.name}}

Video URLvideo_urlstring

The URL of the ad video.

Example value: https://www.youtube.com/embed/example

Video URL Iframevideo_url_iframestring

The iframe embed code for displaying the video ad within a web page or app.

Example value: https://www.facebook.com/plugins/ video.phpwidth=1080&href=https:// www.facebook.com/123456789/videos/987654321

Video URL Sourcevideo_url_sourcestring

The direct file path to the hosted video source, typically used for playback.

Example value: https://video-ord5-2.xx.fbcdn.net/o1/v/t2/f2/m69/example-video.mp4?_nc_ht=video-ord5-2.xx.fbcdn.net&_nc_cat=111& oh=1234567890abcdef&oe=67C3D77F

Measures

Measures are numeric fields that can be aggregated and/or combined to calculate new metrics.

TitleIDTypeDescription
Pixel Add to Cartsadd_to_cartsnumericThe number of unique users who triggered an Add-to-Cart event, as reported by the Pixel.
Address Details SubmittedaddressesnumericThe Pixel-reported number of unique users who submitted address details during checkout.
Ad Set Daily Budgetadset_daily_budgetnumeric

The daily budget (in cents) set for the ad set within a campaign. By default shown in the shop's currency.

Example values: 1750, 6000, 40000

Ad Set Lifetime Budgetadset_lifetime_budgetnumeric

The total budget (in cents) set for the ad set within a campaign over its lifetime. By default shown in the shop's currency.

Example values: 5000, 10000, 20000

Pixel BouncesbouncesnumericThe Pixel-reported number of single-page sessions where the visitor left the site after a single page view.
Campaign Daily Budgetcampaign_daily_budgetnumeric

The daily budget (in cents) for the campaign.

Example values: 8000, 10000, 15000

Campaign Lifetime Budgetcampaign_lifetime_budgetnumeric

The lifetime budget (in cents) for the campaign.

Example values: 5000, 10000, 20000

Channel-Reported Conversion Valuechannel_reported_conversion_valuenumericRevenue generated from channel-reported conversions (purchases).
Channel-Reported Conversions (Purchases)channel_reported_conversionsnumericNumber of channel-reported conversions (purchases).
Channel-Reported Onsite Conversion Valuechannel_reported_onsite_conversion_valuenumericRevenue from channel-reported purchases made on the ad channel shop (e.g. Meta Shop, TikTok Shop).
Channel-Reported Onsite Purchaseschannel_reported_onsite_purchasesnumericNumber of channel-reported purchases made on the ad channel shop (e.g. Meta Shop, TikTok Shop).
Channel-Reported Visitschannel_reported_visitsnumericNumber of channel-reported visits. Currently available for Criteo only.
Checkouts StartedcheckoutsnumericThe Pixel-reported number of unique users who started a checkout.
ClicksclicksnumericNumber of channel-reported clicks.
Pixel Cost of Goodscogsnumeric

The cost of goods for Pixel-reported purchases within the selected time frame (before refunds).

Imported from the main sales platform, or edit these in Cost Settings > Cost of Goods.

Note that COGS for Pixel data is set at attribution time and does not get updated subsequently, so may vary from COGS data in the Orders table.

Add Contact InfocontactsnumericThe Pixel-reported number of unique users who submitted contact details during checkout.
SMS Messages DelivereddeliverednumericThe channel-reported number of messages that successfully reached the recipients' phones.
Pixel Email Signupsemail_signupsnumericThe Pixel-reported total number of users who signed up for the mailing list during a session.
Pixel Gross Salesgross_product_salesnumeric

Pixel-reported gross sales revenue (before shipping, taxes, discounts, or refunds).

Gross Sales = Product Price x Units Sold

ImpressionsimpressionsnumericNumber of channel-reported impressions.
Pixel New Customer Cost of Goodsnew_customer_cogsnumeric

The cost of goods for Pixel-reported purchases by new customers within the selected time frame (before refunds).

Imported from the main sales platform, or edit these in Cost Settings > Cost of Goods.

Note that COGS for Pixel data is set at attribution time and does not get updated subsequently, so may vary from COGS data in the Orders table.

Learn how Triple Whale classifies new/returning customers.

Pixel New Customer Conversion Valuenew_customer_order_revenuenumeric

Pixel-reported conversion value (order revenue) derived from New Customers.

Learn how Triple Whale classifies new/returning customers.

Pixel New Customer Purchasesnew_customer_ordersnumeric

Number of Pixel-reported orders placed by New Customers.

Learn how Triple Whale classifies new/returning customers.

Pixel New Visitorsnew_visitorsnumericThe Pixel-reported number of first-time visitors to the site.
One-Day View Conversion Valueone_day_view_conversion_valuenumericThe total value of channel-reported purchases made within one day of viewing the ad.
One-Day View Purchasesone_day_view_purchasesnumericThe total number of channel-reported purchases made within one day of viewing the ad.
OpensopenednumericThe channel-reported number of times the email/sms was opened by recipients.
Pixel Conversion Value (CV)order_revenuenumeric

Pixel-reported conversion value (order revenue) after shipping, taxes, and discounts (before refunds).

Order Revenue = Gross Sales + Shipping + Taxes − Discounts

Pixel Purchasesorders_quantitynumeric

The total number of Pixel-reported purchases (orders) within the selected timeframe.

Note: This value is calculated based on the attribution model, and may be a fractional number.

Outbound Clicksoutbound_clicksnumericNumber of channel-reported outbound clicks.
Add Payment InfopaymentsnumericThe Pixel-reported number of unique users who submitted payment details during checkout.
Units Soldproduct_quantity_sold_in_ordernumericThe total number of individual product units sold in the order.
Received MessagesreceivednumericThe channel-reported number of email messages successfully received by the target audience.
Refundsrefund_moneynumeric

Total amount returned to customers for refunded sales, refunded taxes, and refunded shipping. Calculated based on the order date.

Note that Triple Whale does not track refunds from third-party return management apps (e.g., Loop), so totals may vary from the sales platform.

Refunds = Refunded Sales + Refunded Shipping + Refunded Tax

SMS Messages SentsentnumericThe channel-reported number of SMS messages sent in the campaign.
Pixel Session Page Viewssession_page_viewsnumericThe Pixel-reported number of pages viewed during a website session.
Pixel Sessionssessionsnumeric

The Pixel-reported number of online store sessions.

Note that Triple Whale defines and tracks sessions differently from the main sales platform so there may be variance between the two. Learn how Triple Whale defines and tracks sessions.

Shipping Details SubmittedshippingnumericThe Pixel-reported number of unique users who submitted shipping details during checkout.
Ad SpendspendnumericChannel-reported ad spend, excluding any custom expenses marked as ad spend.
Subscribed to Mailing Listsubscribed_to_listnumericThe channel-reported number of recipients subscribed to any mailing list.
Pixel Time on Sitetime_on_sitenumericThe Pixel-reported time spent by users on the site during a session, measured in seconds.
Pixel Unique Visitorsunique_visitorsnumericThe Pixel-reported number of unique visitors to the site.
UnsubscribedunsubscribednumericThe channel-reported number of recipients who unsubscribed from any mailing list.
Website Purchaseswebsite_purchasesnumericThe total number of Pixel-reported purchases (orders) during a website session. Excludes recurring subscription purchases.

Derived

Derived fields are metrics that are pre-calculated using multiple measures or advanced formulas.

TitleIDTypeDescription
Pixel Average Page Views Per Sessionaverage_page_views_per_sessionformula

The average number of pages viewed by users during each session.

Pixel Average Page Views Per Session = Session Page Views / Number of Sessions

Pixel Average Session Durationaverage_session_durationformula

The average time users spend on your site per session.

Pixel Average Session Duration (in seconds) = Time on Site / (Number of Sessions - Number of Bounces)

Pixel Bounce Ratebounce_rateformula

The percentage of single-page visits (bounces) out of total sessions.

Pixel Bounce Rate = Number of Bounces / Number of Sessions

Channel-Reported AOVchannel_reported_aovformula

The average order value as reported by the advertising channel.

Channel-Reported AOV = Channel-Reported Conversion Value / Number of Channel-Reported Conversions

Channel-Reported Conversion Ratechannel_reported_conversion_rateformula

The percentage of visits that convert into orders, as reported by the channel.

Channel-Reported Conversion Rate = Number of Channel-Reported Conversions / Number of Visits

Channel-Reported Cost Per Acquisitionchannel_reported_cpaformula

The cost to acquire a single conversion, as reported by the channel.

Channel-Reported CPA = Ad Spend / Number of Channel-Reported Conversions

Channel-Reported Return on Ad Spendchannel_reported_roasformula

Revenue generated per dollar spent on ads, as reported by the channel.

Channel-Reported ROAS = Channel-Reported Conversion Value / Ad Spend

Cost Per Click (CPC)cpcformula

The average cost for each ad click.

Cost Per Click (CPC) = Ad Spend / Clicks

Cost Per Mille (CPM)cpmformula

The cost for 1,000 ad impressions.

Cost Per Mille (CPM) = Ad Spend / Impressions x 1000

Cost Per Visit (CPV)cpvformula

The cost for each visit driven by ads.

Cost Per Visit (CPV) = Ad Spend / Number of Visits

Click-Through Ratectrformula

The percentage of impressions that result in a click.

Click-Through Rate (CTR) = Clicks / Impressions

Pixel Email Signup Rateemail_signup_rateformula

The percentage of sessions that result in email signups.

Pixel Email SUR = Number of Email Signups / Number of Sessions

Pixel Incremental Return on Ad SpendiroasformulaThe additional revenue generated per dollar spent on advertising by comparing conversions between an exposed group (audience that sees the ad) and a holdout group (control group that does not see the ad). Isolates the incremental ROAS of an ad campaign on driving purchases.
Pixel New Customer Cost Per Acquisitionncpaformula

The cost to acquire a new customer, as reported by Pixel.

Pixel NCPA = Blended Ad Spend / Number of New Customer Orders

Learn how Triple Whale classifies new/returning customers.

Pixel New Customer ROASnew_customer_roasformula

Revenue from new customers relative to ad spend.

Pixel NC ROAS = New Customer Pixel Conversion Value / Ad Spend

Learn how Triple Whale classifies new/returning customers.

Pixel New Customers Percentnew_customers_percentformula

The percentage of Pixel-reported purchases made by new customers.

Pixel New Customers % = Number of New Customer Pixel Purchases / Total Pixel Purchases

Learn how Triple Whale classifies new/returning customers.

Outbound Click-Through Rateoutbound_ctrformula

The percentage of impressions that result in outbound clicks.

Outbound CTR = Outbound Clicks / Impressions

Pixel AOVpixel_aovformula

The Pixel-reported average order value.

Pixel AOV = Pixel Conversion Value / Number of Pixel Purchases

Pixel Conversion Ratepixel_conversion_rateformula

The percentage of website sessions that result in purchases, as reported by Pixel.

Conversion Rate = Number of Website Purchases / Number of Sessions

Pixel Conversion Value Deltapixel_conversion_value_deltaformula

The difference between Pixel-reported conversion value and channel-reported conversion value.

Pixel CV Delta = Pixel Conversion Value - Channel-Reported Conversion Value

Pixel Cost Per Add To Cartpixel_cost_per_add_to_cartformula

The cost associated with each add-to-cart action as reported by Pixel.

Pixel Cost Per ATC = Ad Spend / Number of Add to Carts

Pixel Cost Per Email Signuppixel_cost_per_email_signupformula

The cost associated with each email signup as reported by Pixel.

Pixel Cost Per ESU = Ad Spend / Number of Email Signups

Pixel Cost Per New Visitorpixel_cost_per_new_visitorformula

The cost to acquire a new visitor as reported by Pixel.

Pixel Cost Per New Visitor = Ad Spend / Number of New Visitors

Pixel Cost Per Visitorpixel_cost_per_visitorformula

The cost to acquire a unique visitor as reported by Pixel.

Pixel Cost Per Visitor = Ad Spend / Number of Unique Visitors

Pixel Cost Per Acquisitionpixel_cpaformula

The cost to acquire a purchase as reported by Pixel.

Pixel CPA = Ad Spend / Number of Pixel Purchases

Pixel New Customer Average Order Valuepixel_nc_aovformula

The average order value for new customers as reported by Pixel.

Pixel NC AOV = New Customer Pixel Conversion Value / Number of New Customer Pixel Purchases

Learn how Triple Whale classifies new/returning customers.

Pixel New Customer Conversion Ratepixel_nc_conversion_rateformula

The conversion rate for new customers as reported by Pixel.

Pixel NC CR = Number of New Customer Pixel Purchases / Number of New Visitors

Learn how Triple Whale classifies new/returning customers.

Pixel New Visitor Percentpixel_new_visitor_percentformula

The percentage of all visitors that are new as reported by Pixel.

Pixel New Visitor % = Number of New Visitors / Number of Unique Visitors

Pixel Profitpixel_profitformula

The profit calculated as conversion value (order revenue) minus ad spend and cost of goods, as reported by Pixel.

Pixel Profit = Pixel Conversion Value - Ad Spend - Pixel COGS

Pixel Return on Ad Spendpixel_roasformula

Pixel-reported revenue relative to ad spend.

Pixel ROAS = Pixel Conversion Value / Ad Spend

Pixel Returning Customer Purchasesreturning_customer_ordersformula

Number of Pixel-reported orders placed by Returning Customers.

Learn how Triple Whale classifies new/returning customers.

Pixel Returning Customer Revenuereturning_customer_revenueformula

Pixel-reported conversion value (order revenue) derived from Returning Customers.

Learn how Triple Whale classifies new/returning customers.

Pixel Returning Customers Percentreturning_customers_percentformula

The percentage of Pixel-reported purchases made by Returning Customers.

Pixel New Customers % = Number of Returning Customer Pixel Purchases / Total Pixel Purchases

Learn how Triple Whale classifies new/returning customers.