[{"data":1,"prerenderedAt":602},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fadvertisers\u002Frtb-feeds":3,"docs-nav":450},{"id":4,"title":5,"body":6,"description":441,"extension":442,"meta":443,"navigation":444,"order":445,"path":446,"seo":447,"stem":448,"__hash__":449},"docs\u002Fdocs\u002F2.advertisers\u002F10.rtb-feeds.md","Buy through an RTB feed",{"type":7,"value":8,"toc":427},"minimark",[9,26,35,40,51,56,182,186,225,229,282,285,289,299,303,310,366,379,383,409,413],[10,11,12,13,17,18,21,22,25],"p",{},"An ",[14,15,16],"strong",{},"RTB feed"," connects your own bidder (DSP) to TrafficOX. Instead of setting\na bid in a buy order, you receive a bid request for each impression and answer\nwith your price in real time. Feeds are available for ",[14,19,20],{},"Popunder"," and\n",[14,23,24],{},"Sticky banner"," traffic.",[27,28,29],"blockquote",{},[10,30,31,34],{},[14,32,33],{},"Note:"," Creating and editing feeds is switched on per account. If the form\nsays feed editing isn't enabled, ask your account manager to set it up.",[36,37,39],"h2",{"id":38},"create-a-feed","Create a feed",[10,41,42,43,46,47,50],{},"Open ",[14,44,45],{},"RTB Feeds",", click ",[14,48,49],{},"+ New feed"," and fill in the form.",[52,53,55],"h3",{"id":54},"feed-settings","Feed settings",[57,58,59,72],"table",{},[60,61,62],"thead",{},[63,64,65,69],"tr",{},[66,67,68],"th",{},"Field",[66,70,71],{},"What to enter",[73,74,75,86,108,124,144,165],"tbody",{},[63,76,77,83],{},[78,79,80],"td",{},[14,81,82],{},"Name",[78,84,85],{},"Shown in stats and the feed list, up to 60 characters. Defaults to your endpoint's host",[63,87,88,93],{},[78,89,90],{},[14,91,92],{},"Endpoint URL",[78,94,95,96,100,101,104,105],{},"Your bidder's URL, starting with ",[97,98,99],"code",{},"http:\u002F\u002F"," or ",[97,102,103],{},"https:\u002F\u002F",", for example ",[97,106,107],{},"https:\u002F\u002Fdsp.example.com\u002Fbid",[63,109,110,115],{},[78,111,112],{},[14,113,114],{},"Request method",[78,116,117,120,121],{},[14,118,119],{},"POST"," (default) or ",[14,122,123],{},"GET",[63,125,126,131],{},[78,127,128],{},[14,129,130],{},"Response format",[78,132,133,136,137,100,140,143],{},[14,134,135],{},"OpenRTB"," (default), ",[14,138,139],{},"Custom JSON",[14,141,142],{},"Custom XML",". Pick a custom format only if your DSP answers in its own shape",[63,145,146,155],{},[78,147,148,151,152],{},[14,149,150],{},"Bid price key",", ",[14,153,154],{},"Click URL key",[78,156,157,158,161,162],{},"For custom formats only: the names of the fields that hold the price and the click URL in your response, for example ",[97,159,160],{},"cpm"," and ",[97,163,164],{},"url",[63,166,167,172],{},[78,168,169],{},[14,170,171],{},"Payment model",[78,173,174,177,178,181],{},[14,175,176],{},"CPM"," — you pay per 1,000 impressions won; ",[14,179,180],{},"CPC"," — you pay per click",[52,183,185],{"id":184},"limits","Limits",[57,187,188,197],{},[60,189,190],{},[63,191,192,194],{},[66,193,68],{},[66,195,196],{},"What it does",[73,198,199,213],{},[63,200,201,206],{},[78,202,203],{},[14,204,205],{},"QPS limit",[78,207,208,209,212],{},"The most bid requests per second sent to your endpoint, counted per TrafficOX server. ",[97,210,211],{},"0"," means unlimited",[63,214,215,220],{},[78,216,217],{},[14,218,219],{},"Frequency capping",[78,221,222,223,212],{},"How many times one visitor can be sent to this feed within 24 hours. ",[97,224,211],{},[52,226,228],{"id":227},"targeting","Targeting",[230,231,232,246,252,258,264,270,276],"ul",{},[233,234,235,238,239,100,242,245],"li",{},[14,236,237],{},"Countries"," — ",[14,240,241],{},"Target selected",[14,243,244],{},"Block selected",". An empty list means all countries.",[233,247,248,251],{},[14,249,250],{},"Blocked platforms"," — desktop and\u002For mobile. Blocking both means the feed gets no traffic.",[233,253,254,257],{},[14,255,256],{},"Blocked browsers"," — browser groups to reject before bidding, such as Webview or Puffin.",[233,259,260,263],{},[14,261,262],{},"Buy no-referrer traffic"," — on by default.",[233,265,266,269],{},[14,267,268],{},"Reject mismatch IP"," — off by default.",[233,271,272,275],{},[14,273,274],{},"Content categories (thematic)"," — keep at least one.",[233,277,278,281],{},[14,279,280],{},"Domain filtering"," — a blacklist or whitelist of domains, one per line.",[10,283,284],{},"Save the feed. Bid requests start arriving once the feed is active.",[36,286,288],{"id":287},"pause-and-resume","Pause and resume",[10,290,291,292,161,295,298],{},"Use ",[14,293,294],{},"Pause",[14,296,297],{},"Play"," in the feed list. Bidding stops or resumes within\nabout 10 seconds, and your account manager is notified.",[36,300,302],{"id":301},"check-the-feeds-health","Check the feed's health",[10,304,305,306,309],{},"Open a popunder feed to see ",[14,307,308],{},"Feed health"," for the last 24 hours: requests,\nrequests sent to you, bid rate, win rate, timeouts, errors, requests dropped by\nyour QPS limit, and your average response time. It warns you when something is\noff:",[57,311,312,322],{},[60,313,314],{},[63,315,316,319],{},[66,317,318],{},"Warning",[66,320,321],{},"What to check",[73,323,324,332,340,348,356],{},[63,325,326,329],{},[78,327,328],{},"Feed receives traffic but nothing is sent",[78,330,331],{},"Your targeting filters or QPS limit",[63,333,334,337],{},[78,335,336],{},"Feed is not bidding",[78,338,339],{},"Your bidder answers almost no requests with a bid",[63,341,342,345],{},[78,343,344],{},"High timeout rate",[78,346,347],{},"Your endpoint is too slow to answer",[63,349,350,353],{},[78,351,352],{},"High error rate",[78,354,355],{},"Your endpoint returns errors or invalid responses",[63,357,358,361],{},[78,359,360],{},"More requests are dropped by the QPS limit than sent",[78,362,363,364],{},"Raise the ",[14,365,205],{},[10,367,368,369,372,373,378],{},"To get these warnings in Telegram, turn on ",[14,370,371],{},"RTB Feed Health Alerts"," — see\n",[374,375,377],"a",{"href":376},"\u002Fdocs\u002Fgetting-started\u002Faccount#get-alerts-in-telegram","Telegram alerts",".",[36,380,382],{"id":381},"statistics","Statistics",[10,384,385,386,151,389,151,392,151,395,151,398,401,402,161,405,408],{},"Each feed has its own statistics with the same tabs as a buy order:\n",[14,387,388],{},"Overview",[14,390,391],{},"By source",[14,393,394],{},"By country",[14,396,397],{},"By ISP",[14,399,400],{},"By Operating System",",\n",[14,403,404],{},"By Browser",[14,406,407],{},"By Browser Language",", plus CSV export.",[36,410,412],{"id":411},"related","Related",[230,414,415,421],{},[233,416,417],{},[374,418,420],{"href":419},"\u002Fdocs\u002Fadvertisers\u002Fstatistics","Read your statistics",[233,422,423],{},[374,424,426],{"href":425},"\u002Fdocs\u002Fglossary","Glossary",{"title":428,"searchDepth":429,"depth":429,"links":430},"",3,[431,437,438,439,440],{"id":38,"depth":432,"text":39,"children":433},2,[434,435,436],{"id":54,"depth":429,"text":55},{"id":184,"depth":429,"text":185},{"id":227,"depth":429,"text":228},{"id":287,"depth":432,"text":288},{"id":301,"depth":432,"text":302},{"id":381,"depth":432,"text":382},{"id":411,"depth":432,"text":412},"Connect your DSP endpoint so TrafficOX sends you bid requests and you answer with bids.","md",{},true,null,"\u002Fdocs\u002Fadvertisers\u002Frtb-feeds",{"title":5,"description":441},"docs\u002F2.advertisers\u002F10.rtb-feeds","7tLoYRBokpLVCVHyamqjxYX-aQF_fnavhiK5LWOwrrc",[451],{"title":452,"path":453,"stem":454,"children":455},"Docs","\u002Fdocs","docs",[456,460,486,535,574,599],{"title":457,"path":453,"stem":458,"description":459},"TrafficOX Documentation","docs\u002Findex","How to buy and sell traffic on TrafficOX — from your first top-up to tracking conversions.",{"title":461,"path":462,"stem":463,"children":464,"page":485},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started",[465,470,475,480],{"title":466,"path":467,"stem":468,"description":469},"Create your account","\u002Fdocs\u002Fgetting-started\u002Faccount","docs\u002F1.getting-started\u002F1.account","Sign up, confirm your email, complete your profile and secure your account.",{"title":471,"path":472,"stem":473,"description":474},"Top up your balance","\u002Fdocs\u002Fgetting-started\u002Ftop-up","docs\u002F1.getting-started\u002F2.top-up","Payment methods, minimum amounts, VAT, and what your first top-up unlocks.",{"title":476,"path":477,"stem":478,"description":479},"How your balance works","\u002Fdocs\u002Fgetting-started\u002Fbalance","docs\u002F1.getting-started\u002F3.balance","Buyer, seller and reserved balance — what each one holds, what you can spend and what you can withdraw.",{"title":481,"path":482,"stem":483,"description":484},"Referral program","\u002Fdocs\u002Fgetting-started\u002Freferrals","docs\u002F1.getting-started\u002F4.referrals","Invite advertisers and publishers with your link and earn 5% from them.",false,{"title":487,"path":488,"stem":489,"children":490,"page":485},"Advertisers","\u002Fdocs\u002Fadvertisers","docs\u002F2.advertisers",[491,496,501,506,511,516,521,526,531,534],{"title":492,"path":493,"stem":494,"description":495},"How buy orders work","\u002Fdocs\u002Fadvertisers\u002Fbuy-orders","docs\u002F2.advertisers\u002F01.buy-orders","What a buy order is, the ad formats you can buy, and what each order status means.",{"title":497,"path":498,"stem":499,"description":500},"Create a buy order","\u002Fdocs\u002Fadvertisers\u002Fcreate-buy-order","docs\u002F2.advertisers\u002F02.create-buy-order","Walk through the five steps of the order wizard — general settings, ads, targeting, pricing and limits.",{"title":502,"path":503,"stem":504,"description":505},"Targeting reference","\u002Fdocs\u002Fadvertisers\u002Ftargeting","docs\u002F2.advertisers\u002F03.targeting","Every targeting option in a buy order — what it does, its default, and how to narrow or block traffic.",{"title":507,"path":508,"stem":509,"description":510},"Landing pages and creatives","\u002Fdocs\u002Fadvertisers\u002Flanding-pages","docs\u002F2.advertisers\u002F04.landing-pages","Save landing page URLs and banner images in the Media Library, get them approved, and reuse them across orders.",{"title":512,"path":513,"stem":514,"description":515},"Track conversions","\u002Fdocs\u002Fadvertisers\u002Ftrack-conversions","docs\u002F2.advertisers\u002F05.track-conversions","Send conversions back to TrafficOX with a server-to-server postback or a pixel, and see cost per conversion and ROI in your stats.",{"title":517,"path":518,"stem":519,"description":520},"URL macros","\u002Fdocs\u002Fadvertisers\u002Furl-macros","docs\u002F2.advertisers\u002F06.url-macros","Placeholders you can put in your landing page URL — TrafficOX fills them in on every click.",{"title":522,"path":523,"stem":524,"description":525},"Domain filters","\u002Fdocs\u002Fadvertisers\u002Fdomain-filters","docs\u002F2.advertisers\u002F07.domain-filters","Keep lists of sites to buy from or to avoid, and attach them to your buy orders.",{"title":527,"path":528,"stem":529,"description":530},"Automation rules","\u002Fdocs\u002Fadvertisers\u002Fautomation-rules","docs\u002F2.advertisers\u002F08.automation-rules","Let TrafficOX raise or lower bids and black- or whitelist sources for you, based on your statistics.",{"title":420,"path":419,"stem":532,"description":533},"docs\u002F2.advertisers\u002F09.statistics","Where to find your numbers — the dashboard, order statistics and total stats — and what each metric means.",{"title":5,"path":446,"stem":448,"description":441},{"title":536,"path":537,"stem":538,"children":539,"page":485},"Publishers","\u002Fdocs\u002Fpublishers","docs\u002F3.publishers",[540,545,550,555,560,565,569],{"title":541,"path":542,"stem":543,"description":544},"How selling works","\u002Fdocs\u002Fpublishers\u002Fhow-selling-works","docs\u002F3.publishers\u002F1.how-selling-works","Sell orders, the formats you can sell, and how your sites are approved before traffic is bought.",{"title":546,"path":547,"stem":548,"description":549},"Add and verify your domains","\u002Fdocs\u002Fpublishers\u002Fdomains","docs\u002F3.publishers\u002F2.domains","Add your sites, prove you own them, and get them approved so their traffic is bought.",{"title":551,"path":552,"stem":553,"description":554},"Create a sell order","\u002Fdocs\u002Fpublishers\u002Fcreate-sell-order","docs\u002F3.publishers\u002F3.create-sell-order","Set up a placement — name, price floor, fallback URL and the settings for popunder or sticky banners.",{"title":556,"path":557,"stem":558,"description":559},"Install the code","\u002Fdocs\u002Fpublishers\u002Finstall-code","docs\u002F3.publishers\u002F4.install-code","Put your sell order's script on your site, pass a sub ID, and add the lite script to the rest of your pages.",{"title":561,"path":562,"stem":563,"description":564},"Better Ads status","\u002Fdocs\u002Fpublishers\u002Fbetter-ads","docs\u002F3.publishers\u002F5.better-ads","Check whether ad-quality lists and Chrome's filters affect your domains, and what to do if they do.",{"title":420,"path":566,"stem":567,"description":568},"\u002Fdocs\u002Fpublishers\u002Fstatistics","docs\u002F3.publishers\u002F6.statistics","Your earnings, sold and returned traffic on the dashboard, per sell order and in total.",{"title":570,"path":571,"stem":572,"description":573},"Withdraw your earnings","\u002Fdocs\u002Fpublishers\u002Fwithdrawals","docs\u002F3.publishers\u002F7.withdrawals","Request a payout of your seller balance by Capitalist, Paxum or wire transfer.",{"title":575,"path":576,"stem":577,"children":578,"page":485},"Api","\u002Fdocs\u002Fapi","docs\u002F4.api",[579,584,589,594],{"title":580,"path":581,"stem":582,"description":583},"API authentication","\u002Fdocs\u002Fapi\u002Fauthentication","docs\u002F4.api\u002F1.authentication","Create an API key, authenticate your requests, and understand the API's conventions and errors.",{"title":585,"path":586,"stem":587,"description":588},"API quickstart","\u002Fdocs\u002Fapi\u002Fquickstart","docs\u002F4.api\u002F2.quickstart","Three requests to get going — check your account, pull yesterday's stats by country, and pause an order.",{"title":590,"path":591,"stem":592,"description":593},"API reference","\u002Fdocs\u002Fapi\u002Freference","docs\u002F4.api\u002F3.reference","Every endpoint of the TrafficOX API, grouped by what it manages.",{"title":595,"path":596,"stem":597,"description":598},"Statistics requests","\u002Fdocs\u002Fapi\u002Fstatistics","docs\u002F4.api\u002F4.statistics","Breakdowns, filters, sub-breakdowns and the fields returned by every statistics endpoint.",{"title":426,"path":425,"stem":600,"description":601},"docs\u002F5.glossary","The terms used across TrafficOX and these docs, in plain words.",1793025800214]