StackAdapt Connector Reference

64 metrics82 dimensions

The StackAdapt connector pulls data StackAdapt data on campaign level.

A sample URL on how to query data:

https://connectors.windsor.ai/stackadapt?[API_KEY]&date_preset=last_7d&fields=campaign,date,campaign_budget,campaign_state,spend

The StackAdapt connector exposes 146 fields (64 metrics, 82 dimensions). Every field ID below can be passed to the Windsor.ai API in the fields parameter.


Available options


report_timezone Report Timezone

Timezone for adjusting date ranges. Select UTC if unsure.

Possible values (12)
UTCAustralia/SydneyAustralia/MelbourneAustralia/BrisbaneAustralia/PerthUS/EasternUS/CentralUS/PacificEurope/LondonEurope/BerlinAsia/TokyoAsia/Singapore

StackAdapt Fields

StackAdapt Account fields

The Account report of the StackAdapt connector includes 3 fields.

IDTypeNameDescription
account_currencyTEXTAccount CurrencyAccount Currency
account_idTEXTAccount IDThe Account ID
account_nameTEXTAccount NameThe Account Name

StackAdapt Campaign fields

The Campaign report of the StackAdapt connector includes 95 fields.

StackAdapt Campaign fields (abm_domain to campaign_pace_evenly)

IDTypeNameDescription
abm_domainTEXTABM DomainThe company (ABM/B2B) domain the impression was matched to
atosNUMERICAtosAtos
atos_unitsTEXTAtos UnitsAtos Units
audio_completion_ratePERCENTAudio Completion RateListen-through rate: audio completed / audio started
audio_completionsNUMERICAudio CompletedNumber of completed audio plays (95% listened)
campaignTEXTCampaignAlias for Campaign Name
campaign_advertiser_descriptionTEXTCampaign Advertiser DescriptionCampaign Advertiser Description
campaign_advertiser_idNUMERICCampaign Advertiser IDCampaign Advertiser ID
campaign_allow_iframe_engagementNUMERICCampaign Allow Iframe Engagement (Deprecated)Campaign Allow Iframe Engagement
campaign_bid_amount_totalNUMERICCampaign Bid Amount Total (Deprecated)Campaign Bid Amount Total
campaign_bid_typeTEXTCampaign Bid Type (Deprecated)Campaign Bid Type
campaign_budgetNUMERICCampaign Budget (Deprecated)Campaign Budget
campaign_budget_rolloverBOOLEANCampaign Budget RolloverCampaign Budget Rollover
campaign_city_optionsCITYCampaign City Options (Deprecated)Campaign City Options
campaign_created_atTIMESTAMPCampaign Created AtCampaign Created At
campaign_creative_tactic_fallbackTEXTCampaign Creative Tactic FallbackCampaign Creative Tactic Fallback
campaign_daily_capTEXTCampaign Daily Cap (Deprecated)Campaign Daily Cap
campaign_domain_actionTEXTCampaign Domain Action (Deprecated)Campaign Domain Action
campaign_end_dateDATECampaign End Date (Deprecated)Campaign End Date
campaign_engagement_tracking_typeNUMERICCampaign Engagement Tracking Type (Deprecated)Campaign Engagement Tracking Type
campaign_engagement_tracking_type_nameTEXTCampaign Engagement Tracking Type NameCampaign Engagement Tracking Type Name
campaign_freq_cap_expiryNUMERICCampaign Freq Cap ExpiryDuration of time in minutes before the limit expires
campaign_freq_cap_limitNUMERICCampaign Freq Cap LimitLimit of number of times a unique user can view the ad
campaign_freq_cap_timeNUMERICCampaign Freq Cap Time (Deprecated)Campaign Freq Cap Time
campaign_freq_min_expiryNUMERICCampaign Freq Min ExpiryDuration of time in minutes before the limit expires. Always a multiple of 60 minutes
campaign_freq_min_thresholdNUMERICCampaign Freq Min ThresholdMinimum of number of times a unique user should view the ad
campaign_ga_integration_enabledBOOLEANCampaign GA Integration EnabledAn indicator of whether the Google Analytics (GA) integration is enabled (true or false)
campaign_ga_integration_ga4web_property_idTEXTCampaign GA Integration GA4WebPropertyIdA unique identifier associated with a specific Google Analytics account. It is used to track and collect data from a particular website. The ID is typically a 9-digit number
campaign_geo_include_dmaBOOLEANCampaign Geo Include DmaWhether or not to include the designated market area of targeted city locations
campaign_goalTEXTCampaign GoalCampaign Goal
campaign_groupTEXTCampaign GroupName of the campaign group the campaign belongs to
campaign_idTEXTCampaign IDCampaign ID
campaign_is_archivedBOOLEANCampaign is ArchivedTrue if the campaign has been archived, false otherwise
campaign_is_deal_id_strictNUMERICCampaign Is Deal Id Strict (Deprecated)Campaign Is Deal Id Strict
campaign_is_draftBOOLEANCampaign is DraftTrue if the campaign is a draft, false otherwise
campaign_line_item_idNUMERICCampaign Line Item ID (Deprecated)Campaign Line Item ID
campaign_nameTEXTCampaign NameCampaign Name
campaign_optimize_typeTEXTCampaign Optimize Type (Deprecated)Campaign Optimize Type
campaign_optimize_valueNUMERICCampaign Optimize Value (Deprecated)Campaign Optimize Value
campaign_pace_evenlyNUMERICCampaign Pace Evenly (Deprecated)Campaign Pace Evenly

StackAdapt Campaign fields (campaign_pacing_daily_spend_needed to stats_page_time_15s)

IDTypeNameDescription
campaign_pacing_daily_spend_neededNUMERICCampaign Pacing Daily Spend NeededThe daily spend needed
campaign_pacing_flight_pacing_lifetime_budgetNUMERICCampaign Pacing Flight Pacing Lifetime BudgetLifetime budget
campaign_pacing_flight_pacing_overall_pacingNUMERICCampaign Pacing Flight Pacing Overall PacingOverall pacing
campaign_pacing_flight_pacing_total_projected_spendNUMERICCampaign Pacing Flight Pacing Total Projected SpendTotal projected spend
campaign_start_dateDATECampaign Start Date (Deprecated)Campaign Start Date
campaign_stateTEXTCampaign StateCampaign State
campaign_statusTEXTCampaign StatusCampaign Status
campaign_tactic_typeTEXTCampaign Tactic TypeCreative tactic logic type
campaign_timezoneTEXTCampaign TimezoneTimezone
campaign_typeTEXTCampaign TypeCampaign Type
campaign_updated_atTIMESTAMPCampaign Updated AtCampaign Updated At
campaign_use_dmaNUMERICCampaign Use Dma (Deprecated)Campaign Use Dma
campaign_weekday_enabledNUMERICCampaign Weekday Enabled (Deprecated)Campaign Weekday Enabled
click_conversionsNUMERICClick conversionsConversions attributed to clicks
clicksNUMERICClicksClicks
conversion_revenueNUMERICConversion RevenueRevenue generated through conversions
conversionsNUMERICConversionsConversions
costNUMERICCostCost
cpcNUMERICCPCCost per click
cpeNUMERICCPE (Deprecated)Cost per engagement
cpmNUMERICCPMCost per mille (thousand impressions)
ctrPERCENTCTRClick-through rate
cvrPERCENTCVRConversion rate
dateDATEDateDate
domainTEXTDomainThe domain or app the impression was served on
ecpaNUMERICECPAEnhanced cost per action
ecpcNUMERICECPCEnhanced cost per click
ecpeNUMERICECPEEcpe
ecpmNUMERICECPMEnhanced cost per mille
ecpvNUMERICECPVEcpv
engagement_ratePERCENTEngagement rateEngagement rate
impression_conversionsNUMERICImpression conversionsConversions attributed to impressions
impressionsNUMERICImpressionsImpressions
page_startsNUMERICPage startsPage start events
rcpeNUMERICRCPERevenue cost per engagement
revenueNUMERICRevenueRevenue
spendNUMERICSpendAlias for Cost
stats_conv_imp_derivedNUMERICConversion Impression Derived (Deprecated)Conversion Impression Derived
stats_page_timeNUMERICPage Time (Deprecated)Page Time
stats_page_time_15sNUMERICPage Time 15s (Deprecated)Page Time 15s

StackAdapt Campaign fields (stats_unique_imp_inverse_rate to view_through_conversions)

IDTypeNameDescription
stats_unique_imp_inverse_rateNUMERICUnique Impressions Inverse Rate (Deprecated)Unique Impressions Inverse Rate
stats_view_percentPERCENTView PercentView Percent
time_on_siteNUMERICTime on siteTime on site in seconds
total_timeNUMERICTotal TimeTotal time spent on the page (seconds)
total_time_unitsTEXTTotal time units (Deprecated)Time on site in minutes and seconds
totalcostNUMERICTotal CostAlias for Cost
unique_conversionsNUMERICUnique ConversionsUnique Conversions
unique_impressionsNUMERICUnique ImpressionsUnique Impressions
vcomp_0NUMERICvcomp_0Video completion at 0%
vcomp_25NUMERICvcomp_25Video completion at 25%
vcomp_50NUMERICvcomp_50Video completion at 50%
vcomp_75NUMERICvcomp_75Video completion at 75%
vcomp_95NUMERICvcomp_95Video completion at 95%
vcomp_ratePERCENTvcomp_rateVideo completion rate
view_through_conversionsNUMERICView-through conversions (Deprecated)Conversions attributed to views

StackAdapt Conversion_trackers fields

The Conversion_trackers report of the StackAdapt connector includes 7 fields.

IDTypeNameDescription
conversion_tracker_conv_typeTEXTConversion Tracker Conversion Type (Deprecated)Conversion Tracker Conversion Type
conversion_tracker_count_typeTEXTConversion Tracker Count Type (Deprecated)Conversion Tracker Count Type
conversion_tracker_descriptionTEXTConversion Tracker Description (Deprecated)Conversion Tracker Description
conversion_tracker_idTEXTConversion tracker id (Deprecated)Conversion Tracker ID
conversion_tracker_nameTEXTConversion Tracker Name (Deprecated)Conversion Tracker Name
conversion_tracker_post_timeTEXTConversion Tracker Post Time (Deprecated)Conversion Tracker Post Time
conversion_tracker_user_idTEXTConversion Tracker User ID (Deprecated)Conversion Tracker User ID

StackAdapt Creative fields

The Creative report of the StackAdapt connector includes 23 fields.

IDTypeNameDescription
creative_audit_statusTEXTCreative Audit StatusCreative Audit Status
creative_brandnameTEXTCreative Brand NameThe name of the brand associated with the ad
creative_channelTEXTCreative Channel (Deprecated)Creative Channel
creative_click_urlTEXTCreative Click UrlCreative Click Url
creative_created_atTIMESTAMPCreative Created At (Deprecated)Creative Created At
creative_cta_textTEXTCreative Cta TextCall to Action text
creative_headingTEXTCreative HeadingCreative Heading
creative_icon_file_nameTEXTCreative Icon File NameThe name of the file containing the image creative
creative_icon_heightNUMERICCreative Icon HeightThe height of the image creative in pixels
creative_icon_idTEXTCreative Icon IDThe ID of the image creative
creative_icon_urlIMAGE_URLCreative Icon URLThe URL hosting the image creative on the StackAdapt AWS S3 server
creative_icon_widthNUMERICCreative Icon WidthThe width of the image creative in pixels
creative_idTEXTCreative IDCreative ID
creative_input_data_headingTEXTCreative Input Data HeadingAlias for Creative Heading
creative_input_data_landing_urlTEXTCreative Input Data Landing URL (Deprecated)Creative Input Data Landing URL
creative_input_data_taglineTEXTCreative Input Data TaglineAlias for Creative Tagline
creative_input_data_vast_xmlTEXTCreative Input Data Vast XML (Deprecated)Creative Input Data Vast XML
creative_nameTEXTCreative NameCreative Name
creative_stateTEXTCreative StateCreative State
creative_status_activeTEXTCreative Status Active (Deprecated)Creative Status Active
creative_status_descriptionTEXTCreative Status Description (Deprecated)Creative Status Description
creative_taglineTEXTCreative TaglineCreative Tagline
creative_updated_atTIMESTAMPCreative Updated At (Deprecated)Creative Updated At

StackAdapt other fields

The StackAdapt connector has 18 fields that do not belong to a named report, or belong to a report with only one or two fields.

IDTypeNameDescriptionReport
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