RTB House Connector Reference

16 metrics24 dimensions

 

https://connectors.windsor.ai/rtbhouse?api_key=[your API key]&date_preset=last_7d&fields=campaign,clicks,cost,impressions,subcampaign,date

The RTB House connector exposes 40 fields (16 metrics, 24 dimensions). Every field ID below can be passed to the Windsor.ai API in the fields parameter.


RTB House Fields

RTB House Campaign fields

The Campaign report of the RTB House connector includes 22 fields.

IDTypeNameDescription
advertiser_urlTEXTAdvertiser UrlAdvertiser url
campaignTEXTCampaignThe Campaign Name
clicksNUMERICClick CountThe Click Count
conversion_countNUMERICConversion CountThe Conversion Count
conversion_valueNUMERICConversion ValueThe Conversion Value
costNUMERICCampaign CostThe Campaign Cost
crNUMERICConversion rateThe CR
ctrPERCENTCTRThe CTR
dateDATEThe DateThe Date
deviceTEXTDeviceDevice type
ecpaNUMERICECPAEffective Cost Per Action: Cost / Conversions
ecpcNUMERICECPCEffective Cost Per Click: Cost / Clicks
ecpmNUMERICECPMEffective Cost Per Mille: (Cost / Impressions) * 1000
impressionsNUMERICImpression CountThe Impression Count
pc_conversion_countNUMERICPost-Click Conversion CountThe post-click Conversion Count
pc_conversion_valueNUMERICPost-Click Conversion ValueThe post-click Conversion Value
pv_conversion_countNUMERICPost-View Conversion CountThe post-view Conversion Count
pv_conversion_valueNUMERICPost-View Conversion ValueThe post-view Conversion Value
roasPERCENTReturn on ad spend: Conversion value / CostThe ROAS
subcampaignTEXTSubcampaignSubcampaign
subcampaign_idTEXTSubcampaign IdSubcampaign id
totalcostNUMERICTotal CostThe Campaign Cost

RTB House other fields

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

IDTypeNameDescription
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