Triple Whale Connector Reference

64 metrics81 dimensions

The Triple Whale connector exposes 145 fields (64 metrics, 81 dimensions). Every field ID below can be passed to the Windsor.ai API in the fields parameter.


Triple Whale Fields

Triple Whale Ads fields

The Ads report of the Triple Whale connector includes 20 fields.

IDTypeNameDescription
ads_adTEXTAds AdThe name of the ad.
ads_ad_idTEXTAds Ad IDThe unique identifier of the ad.
ads_ad_typeTEXTAds Ad TypeThe type of the ad.
ads_adsetTEXTAds Ad SetThe name of the ad set.
ads_adset_idTEXTAds Ad Set IDThe unique identifier of the ad set.
ads_campaignTEXTAds CampaignThe name of the campaign.
ads_campaign_idTEXTAds Campaign IDThe unique identifier of the campaign.
ads_channelTEXTAds ChannelThe marketing channel of the ad (e.g. facebook-ads).
ads_clicksNUMERICAds ClicksThe number of times the ad was clicked.
ads_conversion_valueNUMERICAds Conversion ValueThe total value of conversions attributed to the ad.
ads_conversionsNUMERICAds ConversionsThe number of conversions attributed to the ad.
ads_cpcNUMERICAds CPCCost per click: spend divided by clicks.
ads_cpmNUMERICAds CPMCost per mille: spend per thousand impressions.
ads_creative_formatTEXTAds Creative FormatThe format of the creative (e.g. video, image).
ads_creative_idTEXTAds Creative IDThe unique identifier of the creative.
ads_ctrPERCENTAds CTRClick-through rate: clicks divided by impressions.
ads_impressionsNUMERICAds ImpressionsThe number of times the ad was shown.
ads_reachNUMERICAds ReachThe number of unique users who saw the ad.
ads_roasNUMERICAds ROASReturn on ad spend: conversion value divided by spend.
ads_spendNUMERICAds SpendThe amount spent on the ad.

Triple Whale Attributed Orders fields

The Attributed Orders report of the Triple Whale connector includes 17 fields.

IDTypeNameDescription
attributed_order_ad_idTEXTAttributed Order Ad IDThe unique identifier of the attributed ad.
attributed_order_adset_idTEXTAttributed Order Ad Set IDThe unique identifier of the attributed ad set.
attributed_order_attribution_modelTEXTAttributed Order Attribution ModelThe attribution model applied to the order.
attributed_order_campaignTEXTAttributed Order CampaignThe name of the attributed campaign.
attributed_order_campaign_idTEXTAttributed Order Campaign IDThe unique identifier of the attributed campaign.
attributed_order_channelTEXTAttributed Order ChannelThe attributed marketing channel of the order.
attributed_order_customer_idTEXTAttributed Order Customer IDThe unique identifier of the customer who placed the order.
attributed_order_gross_salesNUMERICAttributed Order Gross SalesGross sales of the attributed order.
attributed_order_idTEXTAttributed Order IDThe unique identifier of the attributed order.
attributed_order_is_new_customerBOOLEANAttributed Order Is New CustomerWhether the order was placed by a new customer.
attributed_order_landing_pageTEXTAttributed Order Landing PageThe landing page associated with the order.
attributed_order_linear_weightNUMERICAttributed Order Linear WeightThe linear attribution credit assigned to the touch.
attributed_order_nameTEXTAttributed Order NameThe display name of the attributed order.
attributed_order_revenueNUMERICAttributed Order RevenueRevenue of the attributed order.
attributed_order_source_nameTEXTAttributed Order Source NameThe attributed source of the order.
attributed_order_utm_mediumTEXTAttributed Order UTM MediumThe UTM medium of the order.
attributed_order_utm_sourceTEXTAttributed Order UTM SourceThe UTM source of the order.

Triple Whale Attribution fields

The Attribution report of the Triple Whale connector includes 22 fields.

IDTypeNameDescription
attribution_adTEXTAttribution AdThe name of the ad.
attribution_ad_idTEXTAttribution Ad IDThe unique identifier of the ad.
attribution_adsetTEXTAttribution Ad SetThe name of the ad set.
attribution_adset_idTEXTAttribution Ad Set IDThe unique identifier of the ad set.
attribution_campaignTEXTAttribution CampaignThe name of the campaign.
attribution_campaign_idTEXTAttribution Campaign IDThe unique identifier of the campaign.
attribution_channelTEXTAttribution ChannelThe marketing channel of the attributed performance.
attribution_clicksNUMERICAttribution ClicksThe number of clicks for the attributed ads.
attribution_cost_of_goodsNUMERICAttribution Cost Of GoodsCost of goods for the attributed orders.
attribution_creative_formatTEXTAttribution Creative FormatThe format of the creative (e.g. video, image).
attribution_creative_idTEXTAttribution Creative IDThe unique identifier of the creative.
attribution_ctrPERCENTAttribution CTRClick-through rate: clicks divided by impressions.
attribution_gross_salesNUMERICAttribution Gross SalesGross sales attributed to the ads.
attribution_impressionsNUMERICAttribution ImpressionsThe number of impressions for the attributed ads.
attribution_modelTEXTAttribution ModelThe attribution model applied to the performance.
attribution_new_customer_ordersNUMERICAttribution New Customer OrdersNumber of new customer orders attributed to the ads.
attribution_new_customer_revenueNUMERICAttribution New Customer RevenueNew customer order revenue attributed to the ads.
attribution_ordersNUMERICAttribution OrdersNumber of orders attributed to the ads.
attribution_revenueNUMERICAttribution RevenueOrder revenue attributed to the ads.
attribution_roasNUMERICAttribution ROASAttributed return on ad spend: revenue divided by spend.
attribution_sessionsNUMERICAttribution SessionsNumber of sessions attributed to the ads.
attribution_spendNUMERICAttribution SpendThe amount spent on the attributed ads.

Triple Whale Blended Stats fields

The Blended Stats report of the Triple Whale connector includes 28 fields.

IDTypeNameDescription
blended_cost_of_goodsNUMERICBlended Cost Of GoodsCost of goods sold.
blended_cpaNUMERICBlended CPABlended cost per acquisition: ad spend divided by orders with revenue over zero.
blended_discountsNUMERICBlended DiscountsTotal discounts applied to orders.
blended_gross_product_salesNUMERICBlended Gross Product SalesGross product sales before adjustments.
blended_handling_feesNUMERICBlended Handling FeesHandling fees applied to orders.
blended_merNUMERICBlended MERMarketing efficiency ratio: ad spend divided by order revenue (Triple Whale's inverse-of-ROAS definition).
blended_ncpaNUMERICBlended NCPANew customer cost per acquisition: ad spend divided by new customer orders.
blended_net_marginPERCENTBlended Net MarginNet profit as a share of order revenue.
blended_net_profitNUMERICBlended Net ProfitOrder revenue minus refunds, ad spend and total costs.
blended_new_customer_ordersNUMERICBlended New Customer OrdersNumber of orders placed by new customers.
blended_new_customer_revenueNUMERICBlended New Customer RevenueOrder revenue from new customers.
blended_new_customer_roasNUMERICBlended New Customer ROASNew customer revenue divided by ad spend.
blended_order_revenueNUMERICBlended Order RevenueRevenue from orders after discounts, shipping, fees and taxes.
blended_ordersNUMERICBlended OrdersTotal number of orders.
blended_orders_over_zeroNUMERICBlended Orders Over ZeroNumber of orders with revenue greater than zero.
blended_payment_gateway_costsNUMERICBlended Payment Gateway CostsCosts charged by payment gateways.
blended_poasNUMERICBlended POASProfit on ad spend: total sales minus total costs, divided by ad spend.
blended_refunded_ordersNUMERICBlended Refunded OrdersNumber of orders that were refunded.
blended_refundsNUMERICBlended RefundsTotal amount refunded.
blended_roasNUMERICBlended ROASBlended return on ad spend: order revenue divided by ad spend.
blended_sessionsNUMERICBlended SessionsNumber of website sessions.
blended_shipping_costsNUMERICBlended Shipping CostsCosts incurred for shipping orders.
blended_shipping_priceNUMERICBlended Shipping PriceShipping amount charged to customers.
blended_spendNUMERICBlended Ad SpendChannel ad spend across all marketing platforms.
blended_taxesNUMERICBlended TaxesTaxes on orders.
blended_total_costsNUMERICBlended Total CostsSum of cost of goods, shipping, payment gateway, handling fees and taxes.
blended_total_salesNUMERICBlended Total SalesOrder revenue minus refunds.
dateDATEDateThe date of the record.

Triple Whale Customer Journey fields

The Customer Journey report of the Triple Whale connector includes 14 fields.

IDTypeNameDescription
journey_attribution_modelTEXTJourney Attribution ModelThe attribution model applied to the touch.
journey_campaign_idTEXTJourney Campaign IDThe campaign associated with the touch.
journey_customer_idTEXTJourney Customer IDThe unique identifier of the customer.
journey_deviceTEXTJourney DeviceThe device used during the touch.
journey_event_nameTEXTJourney Event NameThe name of the journey event.
journey_event_timeTIMESTAMPJourney Event TimeThe timestamp of the journey event.
journey_event_typeTEXTJourney Event TypeThe type of the journey event (e.g. checkout, page view).
journey_order_idTEXTJourney Order IDThe unique identifier of the order, when the touch is an order.
journey_order_nameTEXTJourney Order NameThe display name of the order, when the touch is an order.
journey_order_revenueNUMERICJourney Order RevenueOrder revenue associated with the touch, when an order.
journey_sourceTEXTJourney SourceThe source of the journey touch.
journey_subscription_idTEXTJourney Subscription IDThe subscription associated with the touch, if any.
journey_total_priceNUMERICJourney Total PriceTotal price associated with the touch, when an order.
journey_urlTEXTJourney URLThe URL associated with the touch.

Triple Whale Customers fields

The Customers report of the Triple Whale connector includes 8 fields.

IDTypeNameDescription
customer_countryCOUNTRYCustomer CountryThe country of the customer.
customer_created_atTIMESTAMPCustomer Created AtThe timestamp when the customer was created.
customer_idTEXTCustomer IDThe unique identifier of the customer.
customer_last_order_idTEXTCustomer Last Order IDThe unique identifier of the customer's last order.
customer_platformTEXTCustomer PlatformThe platform the customer record originates from.
customer_statusTEXTCustomer StatusThe marketing subscription status of the customer.
customer_total_ordersNUMERICCustomer Total OrdersThe lifetime number of orders placed by the customer.
customer_total_spentNUMERICCustomer Total SpentThe lifetime amount spent by the customer.

Triple Whale Orders fields

The Orders report of the Triple Whale connector includes 16 fields.

IDTypeNameDescription
order_cost_of_goodsNUMERICOrder Cost Of GoodsCost of goods sold for the order.
order_customer_emailTEXTOrder Customer EmailThe email of the customer who placed the order.
order_customer_idTEXTOrder Customer IDThe unique identifier of the customer who placed the order.
order_discount_amountNUMERICOrder Discount AmountTotal discount amount applied to the order.
order_discount_codeTEXTOrder Discount CodeThe discount code applied to the order.
order_gross_product_salesNUMERICOrder Gross Product SalesGross product sales for the order before adjustments.
order_idTEXTOrder IDThe unique identifier of the order.
order_is_new_customerBOOLEANOrder Is New CustomerWhether the order was placed by a new customer.
order_is_subscriptionBOOLEANOrder Is SubscriptionWhether the order is a subscription order.
order_nameTEXTOrder NameThe display name of the order.
order_net_revenueNUMERICOrder Net RevenueNet revenue for the order.
order_refunded_amountNUMERICOrder Refunded AmountAmount refunded for the order.
order_revenueNUMERICOrder RevenueRevenue for the order after adjustments.
order_shipping_priceNUMERICOrder Shipping PriceShipping amount charged for the order.
order_source_nameTEXTOrder Source NameThe attributed source of the order.
order_taxesNUMERICOrder TaxesTaxes charged on the order.

Triple Whale other fields

The Triple Whale connector has 20 fields that do not belong to a named report, or belong to a report with only one or two fields.

IDTypeNameDescriptionReport
account_idTEXTAccount IDThe Triple Whale shop domain (e.g. example.myshopify.com).Account
account_nameTEXTAccount NameThe Triple Whale shop domain, used as the account name.Account
data_fetched_atTIMESTAMPData fetched atUTC timestamp (second precision) of when the connector request that pulled the row started. Freshly pulled rows show this request's start time; cache hits keep the start time of the request that filled the cache. Selecting this field disables aggregation, so rows are returned individually (each keeping its own fetch time) instead of being summed.
datasourceTEXTData SourceThe name of the Windsor connector returning the row
day_of_monthTEXTDay of monthDay of the month
monthTEXTMonthNumber of the month
nowTIMESTAMPNowCurrent timestamp
sourceTEXTSourceThe name of the Windsor connector returning the row
todayDATETodayToday's date
weekTEXTWeekWeek (Sun-Sat).
week_dayTEXTDay of week and day numberWeekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday.
week_day_isoTEXTDay of week and day number, ISOWeekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7
week_isoTEXTWeek ISOWeek, ISO format (Mon-Sun).
yearTEXTYearYear
year_monthTEXTYearmonthYear and month, e.g. 2024|3
year_month_nameTEXTYear month nameYear and month with the month name written out, e.g. "Jan 2025".
year_of_weekTEXTYear of weekThe year that contains first day of the week (Sun-Sat).
year_of_week_isoTEXTYear of week, ISOThe year that contains first day of the ISO week (Mon-Sun).
year_weekTEXTYear weekYear and week for US weeks (Sun-Sat), e.g. 2024|15
year_week_isoTEXTYear week ISOYear and week for ISO weeks (Mon-Sun), e.g. 2024|20