Adtraction Field Reference


Fields

IDTypeNameDescriptionReport
account_idTEXTAccount IDThe Account ID
account_nameTEXTAccount NameThe Account Name
advertiser_account_currencyTEXTAdvertiser Account CurrencyThe currency used in your account in ISO 4217 format
advertiser_account_marketTEXTAdvertiser Account MarketThe Market on which your program is available, defined by an ISO 3166-1 Alpha-2 country code
advertiser_account_program_idTEXTAdvertiser Account Program IDNumerical ID of your program
advertiser_account_program_nameTEXTAdvertiser Account Program NameName of your program
advertiser_channel_affiliate_idTEXTChannel Affiliate IDNumerical ID of a partner account.
advertiser_channel_affiliate_nameTEXTChannel Affiliate NameName of the partner. Individual or company.
advertiser_channel_application_dateDATEChannel Application DateThe date when the channel first applied to join your program.
advertiser_channel_approval_statusTEXTChannel Approval StatusApproval status of a channel for a partner program: 0 = rejected, 1 = approved, 2 = pending review
advertiser_channel_descriptionTEXTChannel DescriptionA description of a channel.
advertiser_channel_idTEXTChannel IDID of the channel.
advertiser_channel_nameTEXTChannel NameName of the channel.
advertiser_channel_reject_reason_idTEXTChannel Reject Reason IDAvailable when approvalStatus is set to: 0. The reason for the program application being rejected, where: 0 = Not enough content/posts, 1 = Not relevant content, 2 = A closed site/group/account, 3 = 404 on site, 4 = Site does not exist, 5 = Wrong contact details / shady details, 6 = Unethical content, 7 = Incorrect site owner, 8 = Missing info about the channel. No URL/link, 9 = To few followers/visitors, 10 = Poor design, 11 = Traffic is not relevant. 12 = Outdated content
advertiser_channel_reject_reason_textTEXTChannel Reject ReasonAvailable when approvalStatus is set to: 0. The reason for the program application being rejected.
advertiser_channel_typeTEXTChannel TypeThe type of a channel, such as Blog, Content, Facebook, Cashback, etc.
advertiser_channel_urlTEXTChannel URLThe URL of a channel, if applicable.
advertiser_segment_idTEXTSegment IDNumerical Adtraction ID of the segment
advertiser_segment_nameTEXTAdvertiser Segment NameThe name of the segment
advertiser_stats_channel_aovNUMERICAdvertiser Statistics Average Order Value (AOV)Average order value, obtained by dividing order value by number of sale transactions
advertiser_stats_channel_clicksNUMERICAdvertiser Statistics ClicksNumber of clicks
advertiser_stats_channel_clicks_uniqueNUMERICAdvertiser Statistics Unique ClicksNumber of unique clicks
advertiser_stats_channel_conversion_ratioNUMERICAdvertiser Statistics Conversion RatioConversion Ratio, obtained by dividing sales by clicksUnique
advertiser_stats_channel_costNUMERICAdvertiser Statistics CostThe total cost of the transaction, including partner commission and platform fee
advertiser_stats_channel_ctrNUMERICAdvertiser Statistics CTRClick Through Ratio, obtained by dividing clicks by impressions
advertiser_stats_channel_idTEXTAdvertiser Statistics Channel IDID of the channel
advertiser_stats_channel_impressionsNUMERICAdvertiser Statistics ImpressionsNumber of banner / links impressions
advertiser_stats_channel_impressions_uniqueNUMERICAdvertiser Statistics Unique ImpressionsNumber of unique banner / links impressions
advertiser_stats_channel_lead_ratioNUMERICAdvertiser Statistics Lead RatioLead Ratio, obtained by dividing leads by clicksUnique
advertiser_stats_channel_leadsNUMERICAdvertiser Statistics LeadsNumber of lead transactions
advertiser_stats_channel_order_valueNUMERICAdvertiser Statistics Order ValueOrder value of the sale transactions
advertiser_stats_channel_salesNUMERICAdvertiser Statistics SalesNumber of sale transactions
datasourceTEXTData SourceThe name of the Windsor connector returning the row
dateDATEDateThe Date
day_of_monthTEXTDay of monthDay of the month
monthTEXTMonthNumber of the month
partner_marketTEXTPartner MarketISO 3166-1 Alpha-2 country code
partner_market_idTEXTPartner Market IDNumerical Adtraction ID of the market
partner_market_nameTEXTPartner Market NameMarket name
partner_program_ad_idTEXTPartner Program Ad IDNumerical ID of the ad. When using /partner/programs/ the adId provided is equal to the programAdId for each partner program. Use this as the parameter 'a' in your tracking links
partner_program_approval_statusTEXTPartner Program Approval StatusApproval status for a partner program. Only available when channelId is provided as input and when an application has been made by the channelId to the programId. 0 = rejected, 1 = approved, 2 = pending review
partner_program_cashback_marketingTEXTPartner Program Cashback Marketing RuleRules for cashback / reward partners: 0 = not allowed, 1 = allowed
partner_program_category_idTEXTPartner Program Category IDNumerical ID of the category that the partner program belongs to on the Adtraction platform
partner_program_category_nameTEXTPartner Program Category NameThe name of the category that the partner program belongs to on the Adtraction platform
partner_program_commissionsTEXTPartner Program CommisionsArray containing the name, value and type of all currently active commissions types in a partner program
TEXTPartner Program Cookie DurationNumber of days after each click during which transactions are tracked
partner_program_coupon_marketingTEXTPartner Program Coupon Marketing RuleAdvertising rules for voucher / coupon partners, where: 0 = not allowed, 1 = allowed
partner_program_currencyTEXTPartner Program CurrencyThe currency used for the program. ISO 4217 format
partner_program_current_segmentTEXTPartner Program Current SegmentThe commission segment the specified channel currently belongs to in the specified partner program. Only available when channelId is provided as input.
partner_program_email_marketingTEXTPartner Program Email Marketing RuleRules for Email Marketing, where: 0 = not allowed, 1 = allowed, 2 = restricted (preview is required)
partner_program_epcNUMERICPartner Program EPCEPC (Earnings Per Click) is a measurement of the average amount that partners earn every time they direct a click to a partner program. It serves as an indicator of the profitability of each program, and is determined by averaging the EPC for all channels active on the program, excluding the top and bottom 5 %.
partner_program_feedsTEXTPartner Program FeedsInformation about product data feeds provided by the advertiser. Only available when channelId is provided and approvalStatus = 1.
partner_program_idTEXTPartner Program IDNumerical ID of the partner program.
partner_program_logo_urlIMAGE_URLPartner Program Logo URLURL of the advertiser logo image file
partner_program_marketTEXTPartner Program MarketGeographical market on which a partner program is available, defined by an ISO 3166-1 Alpha-2 country code
partner_program_nameTEXTPartner Program NameName of the partner program
partner_program_pending_activeBOOLEANPartner Program Pending ActiveSet to true if the advertiser reviews transactions manually. Transactions will have status Pending until they are approved or rejected by the advertiser
partner_program_ppc_marketingTEXTPartner Program PPC Marketing RuleRules for Pay Per Click Marketing (Google Adwords, etc), where: 0 = not allowed,1 = allowed, 2 = restricted (no brand bidding)
partner_program_social_marketingTEXTPartner Program Social Marketing RuleRules for Social Media Marketing (Facebook, etc), where: 0 = not allowed, 1 = allowed
partner_program_statusTEXTPartner Program StatusThe status of the partner program on the Adtraction platform, where Live = 0 and Closing = 3
partner_program_tracking_typeTEXTPartner Program Tracking TypeThe type of tracking the advertiser has implemented where 1 or 5 = first-party cookie tracking, 2 = server-to-server tracking, 3 = legacy cookie tracking, 4 = dedicated subdomain tracking
partner_program_tracking_urlTEXTPartner Program Tracking URLDefault click tracking URL for a specified channel and partner program, where "a" is the adId and "as" is the channelId. Only available when channelId is provided as input and approvalStatus is "1" (approved).
partner_program_urlTEXTPartner Program URLMain URL for a specified partner program
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_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