[{"data":1,"prerenderedAt":980},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fadvertisers\u002Ftrack-conversions":3,"docs-nav":830},{"id":4,"title":5,"body":6,"description":821,"extension":822,"meta":823,"navigation":824,"order":825,"path":826,"seo":827,"stem":828,"__hash__":829},"docs\u002Fdocs\u002F2.advertisers\u002F05.track-conversions.md","Track conversions",{"type":7,"value":8,"toc":806},"minimark",[9,19,22,40,48,54,64,70,74,87,214,224,228,231,237,248,253,370,393,397,529,532,536,543,595,666,676,680,683,698,705,709,716,736,740,772,779,783,802],[10,11,12,13,18],"p",{},"When TrafficOX knows which visits converted, your statistics show conversions,\ncost per conversion, profit and ROI for every order, country and source — and\n",[14,15,17],"a",{"href":16},"\u002Fdocs\u002Fadvertisers\u002Fautomation-rules","automation rules"," can act on them.",[10,20,21],{},"Tracking works in three parts:",[23,24,25,34,37],"ol",{},[26,27,28,29,33],"li",{},"Your landing page URL carries the ",[30,31,32],"code",{},"{visitor_id}"," macro, so every visit arrives with its TrafficOX ID.",[26,35,36],{},"Your tracker or site keeps that ID.",[26,38,39],{},"When the visitor converts, the ID is sent back to TrafficOX — by a server-to-server postback or by a pixel.",[41,42,44,45,47],"h2",{"id":43},"step-1-add-visitor_id-to-your-landing-page-url","Step 1. Add ",[30,46,32],{}," to your landing page URL",[10,49,50,51,53],{},"In your buy order's landing page URL, pass ",[30,52,32],{}," in the parameter your\ntracker reads, for example:",[55,56,62],"pre",{"className":57,"code":59,"language":60,"meta":61},[58],"language-text","https:\u002F\u002Fexample.com\u002Foffer?click_id={visitor_id}\n","text","",[30,63,59],{"__ignoreMap":61},[10,65,66,67,69],{},"TrafficOX replaces ",[30,68,32],{}," with the visit's ID on every click.",[41,71,73],{"id":72},"step-2-create-a-conversion-tracker","Step 2. Create a conversion tracker",[23,75,76,84],{},[26,77,78,79,83],{},"Open ",[80,81,82],"strong",{},"Tracking"," and click to add a tracker.",[26,85,86],{},"Fill in the form:",[88,89,90,103],"table",{},[91,92,93],"thead",{},[94,95,96,100],"tr",{},[97,98,99],"th",{},"Field",[97,101,102],{},"What to enter",[104,105,106,117,134,161,178,188,201],"tbody",{},[94,107,108,114],{},[109,110,111],"td",{},[80,112,113],{},"Name",[109,115,116],{},"Any name you'll recognise",[94,118,119,124],{},[109,120,121],{},[80,122,123],{},"Tracker Type",[109,125,126,129,130,133],{},[80,127,128],{},"S2S (Server-to-Server)"," if your tracker or backend sends the postback; ",[80,131,132],{},"Pixel (Browser)"," if you can only place code on your pages",[94,135,136,141],{},[109,137,138],{},[80,139,140],{},"Event Type",[109,142,143,146,147,146,150,146,153,156,157,160],{},[80,144,145],{},"install",", ",[80,148,149],{},"sale",[80,151,152],{},"signup",[80,154,155],{},"lead"," or ",[80,158,159],{},"rebill"," — the event this tracker counts by default",[94,162,163,168],{},[109,164,165],{},[80,166,167],{},"Count Mode",[109,169,170,173,174,177],{},[80,171,172],{},"unique"," counts one conversion per visitor and event; ",[80,175,176],{},"multiple"," counts every one",[94,179,180,185],{},[109,181,182],{},[80,183,184],{},"Value, USD",[109,186,187],{},"The payout to record when the postback doesn't send one. Optional",[94,189,190,195],{},[109,191,192],{},[80,193,194],{},"Attribution window",[109,196,197,198,200],{},"In days, 90 by default. With ",[80,199,172],{},", a repeat conversion from the same visitor inside this window is marked as a duplicate",[94,202,203,208],{},[109,204,205],{},[80,206,207],{},"Status",[109,209,210,213],{},[80,211,212],{},"Active"," to accept conversions",[23,215,217],{"start":216},3,[26,218,219,220,223],{},"Save. The tracker page shows the code to use under ",[80,221,222],{},"Tracking Code",".",[41,225,227],{"id":226},"step-3a-server-to-server-postback","Step 3a. Server-to-server postback",[10,229,230],{},"Call this URL from your tracker or server when a conversion happens:",[55,232,235],{"className":233,"code":234,"language":60,"meta":61},[58],"https:\u002F\u002Ftracking.trafficox.com\u002Fs2s?visitor_id={VISITOR_ID}&tracker_id=TRACKER_ID&event=EVENT\n",[30,236,234],{"__ignoreMap":61},[10,238,239,240,243,244,247],{},"Replace ",[30,241,242],{},"{VISITOR_ID}"," with your tracker's token for the ID you stored in step 1,\nand ",[30,245,246],{},"TRACKER_ID"," with the ID shown on the tracker page — the page gives you the\nfull URL ready to copy.",[249,250,252],"h3",{"id":251},"parameters","Parameters",[88,254,255,268],{},[91,256,257],{},[94,258,259,262,265],{},[97,260,261],{},"Parameter",[97,263,264],{},"Required",[97,266,267],{},"What it is",[104,269,270,285,300,325,346,358],{},[94,271,272,277,280],{},[109,273,274],{},[30,275,276],{},"visitor_id",[109,278,279],{},"Yes",[109,281,282,283],{},"The ID TrafficOX passed in ",[30,284,32],{},[94,286,287,292,295],{},[109,288,289],{},[30,290,291],{},"tracker_id",[109,293,294],{},"No",[109,296,297,298],{},"Your tracker's ID. When set, the tracker must be ",[80,299,212],{},[94,301,302,310,312],{},[109,303,304,156,307],{},[30,305,306],{},"event",[30,308,309],{},"goal",[109,311,294],{},[109,313,314,315,318,319,322,323],{},"Event name: lowercase letters, digits, ",[30,316,317],{},"_"," and ",[30,320,321],{},"-",", up to 32 characters. Defaults to the tracker's ",[80,324,140],{},[94,326,327,335,337],{},[109,328,329,156,332],{},[30,330,331],{},"value",[30,333,334],{},"payout",[109,336,294],{},[109,338,339,340,343,344],{},"Conversion payout in USD, for example ",[30,341,342],{},"1.5",". Defaults to the tracker's ",[80,345,184],{},[94,347,348,353,355],{},[109,349,350],{},[30,351,352],{},"click_id",[109,354,294],{},[109,356,357],{},"Your own click ID, stored with the conversion",[94,359,360,365,367],{},[109,361,362],{},[30,363,364],{},"sub_id",[109,366,294],{},[109,368,369],{},"Your own sub ID, stored with the conversion",[10,371,372,373,376,377,380,381,376,384,318,387,376,390,223],{},"To report up to three events in one call, use ",[30,374,375],{},"event1","\u002F",[30,378,379],{},"value1",",\n",[30,382,383],{},"event2",[30,385,386],{},"value2",[30,388,389],{},"event3",[30,391,392],{},"value3",[249,394,396],{"id":395},"tokens-for-popular-trackers","Tokens for popular trackers",[88,398,399,412],{},[91,400,401],{},[94,402,403,406,409],{},[97,404,405],{},"Tracker",[97,407,408],{},"Visitor ID token",[97,410,411],{},"Payout token",[104,413,414,429,444,457,472,485,499,514],{},[94,415,416,419,424],{},[109,417,418],{},"Keitaro",[109,420,421],{},[30,422,423],{},"{external_id}",[109,425,426],{},[30,427,428],{},"{revenue}",[94,430,431,434,439],{},[109,432,433],{},"Binom",[109,435,436],{},[30,437,438],{},"{externalid}",[109,440,441],{},[30,442,443],{},"{payout}",[94,445,446,449,453],{},[109,447,448],{},"Voluum",[109,450,451],{},[30,452,438],{},[109,454,455],{},[30,456,443],{},[94,458,459,462,467],{},[109,460,461],{},"RedTrack",[109,463,464],{},[30,465,466],{},"{ref_id}",[109,468,469],{},[30,470,471],{},"{offer_payout}",[94,473,474,477,481],{},[109,475,476],{},"PeerClick",[109,478,479],{},[30,480,438],{},[109,482,483],{},[30,484,443],{},[94,486,487,490,495],{},[109,488,489],{},"BeMob",[109,491,492],{},[30,493,494],{},"{externalId}",[109,496,497],{},[30,498,443],{},[94,500,501,504,509],{},[109,502,503],{},"LandingTrack",[109,505,506],{},[30,507,508],{},"{{PID}}",[109,510,511],{},[30,512,513],{},"{{PAYOUT}}",[94,515,516,519,524],{},[109,517,518],{},"CPBLab",[109,520,521],{},[30,522,523],{},"{!tscode!}",[109,525,526],{},[30,527,528],{},"{!revenue!}",[10,530,531],{},"Check the token names against your tracker's documentation — they depend on how\nyou set it up.",[249,533,535],{"id":534},"responses","Responses",[10,537,538,539,542],{},"A successful call returns ",[30,540,541],{},"200"," with the events that were accepted and any that\nwere rejected:",[55,544,548],{"className":545,"code":546,"language":547,"meta":61,"style":61},"language-json shiki shiki-themes github-light github-dark","{\"accepted\":[{\"event\":\"sale\",\"value\":1.5}],\"rejected\":[]}\n","json",[30,549,550],{"__ignoreMap":61},[551,552,555,559,563,566,569,572,576,579,582,584,586,589,592],"span",{"class":553,"line":554},"line",1,[551,556,558],{"class":557},"sVt8B","{",[551,560,562],{"class":561},"sj4cs","\"accepted\"",[551,564,565],{"class":557},":[{",[551,567,568],{"class":561},"\"event\"",[551,570,571],{"class":557},":",[551,573,575],{"class":574},"sZZnC","\"sale\"",[551,577,578],{"class":557},",",[551,580,581],{"class":561},"\"value\"",[551,583,571],{"class":557},[551,585,342],{"class":561},[551,587,588],{"class":557},"}],",[551,590,591],{"class":561},"\"rejected\"",[551,593,594],{"class":557},":[]}\n",[88,596,597,607],{},[91,598,599],{},[94,600,601,604],{},[97,602,603],{},"Error",[97,605,606],{},"Cause",[104,608,609,622,636,646,656],{},[94,610,611,616],{},[109,612,613],{},[30,614,615],{},"missing_visitor_id",[109,617,618,619,621],{},"No ",[30,620,276],{}," in the request",[94,623,624,629],{},[109,625,626],{},[30,627,628],{},"unknown_tracker",[109,630,631,633,634],{},[30,632,291],{}," doesn't exist or the tracker isn't ",[80,635,212],{},[94,637,638,643],{},[109,639,640],{},[30,641,642],{},"invalid_value",[109,644,645],{},"The payout isn't a valid, non-negative number",[94,647,648,653],{},[109,649,650],{},[30,651,652],{},"too_many_events",[109,654,655],{},"More than three events in one request",[94,657,658,663],{},[109,659,660],{},[30,661,662],{},"no_valid_events",[109,664,665],{},"None of the events could be accepted",[10,667,668,669,672,673,675],{},"A rejected event with reason ",[30,670,671],{},"duplicate"," was already counted for this visitor —\nexpected with ",[80,674,172],{}," count mode.",[41,677,679],{"id":678},"step-3b-pixel","Step 3b. Pixel",[10,681,682],{},"Use the pixel when you can't send a postback from a server.",[23,684,685,692],{},[26,686,687,688,691],{},"Put the ",[80,689,690],{},"Landing Page Script"," from the tracker page on your landing page. It saves the visitor ID from the URL in a cookie.",[26,693,687,694,697],{},[80,695,696],{},"Conversion Page Script"," on your thank-you page. It reads the cookie and reports the conversion.",[10,699,700,701,704],{},"Both pages must be on the same hostname — for example both on ",[30,702,703],{},"www.example.com",".\nThe visitor ID is kept in a cookie on the landing page's exact host, so a\ndifferent subdomain can't read it.",[41,706,708],{"id":707},"check-that-it-works","Check that it works",[10,710,711,712,715],{},"The tracker page has an ",[80,713,714],{},"Event Log"," that refreshes every 10 seconds. Send a\ntest conversion and watch it appear with its status:",[717,718,719,725,730],"ul",{},[26,720,721,724],{},[80,722,723],{},"accepted"," — counted;",[26,726,727,729],{},[80,728,671],{}," — already counted for this visitor;",[26,731,732,735],{},[80,733,734],{},"invalid_click"," — the visitor ID matches no TrafficOX visit: it's missing, mistyped, or older than about 90 days.",[41,737,739],{"id":738},"where-conversions-show-up","Where conversions show up",[717,741,742,757],{},[26,743,744,745,146,748,146,751,318,754,223],{},"Buy order statistics: ",[80,746,747],{},"Conversions",[80,749,750],{},"Conv. value",[80,752,753],{},"Profit",[80,755,756],{},"ROI %",[26,758,759,760,146,763,146,766,318,769,223],{},"The dashboard's detailed stats: ",[80,761,762],{},"Conv.",[80,764,765],{},"Cost\u002FConv.",[80,767,768],{},"Conv. Rate",[80,770,771],{},"ROI",[10,773,774,775,778],{},"ROI shows ",[80,776,777],{},"N\u002FA"," until an order has at least one conversion.",[41,780,782],{"id":781},"related","Related",[717,784,785,791,796],{},[26,786,787],{},[14,788,790],{"href":789},"\u002Fdocs\u002Fadvertisers\u002Furl-macros","URL macros",[26,792,793],{},[14,794,795],{"href":16},"Automation rules",[26,797,798],{},[14,799,801],{"href":800},"\u002Fdocs\u002Fadvertisers\u002Fstatistics","Read your statistics",[803,804,805],"style",{},"html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":61,"searchDepth":216,"depth":216,"links":807},[808,811,812,817,818,819,820],{"id":43,"depth":809,"text":810},2,"Step 1. Add {visitor_id} to your landing page URL",{"id":72,"depth":809,"text":73},{"id":226,"depth":809,"text":227,"children":813},[814,815,816],{"id":251,"depth":216,"text":252},{"id":395,"depth":216,"text":396},{"id":534,"depth":216,"text":535},{"id":678,"depth":809,"text":679},{"id":707,"depth":809,"text":708},{"id":738,"depth":809,"text":739},{"id":781,"depth":809,"text":782},"Send conversions back to TrafficOX with a server-to-server postback or a pixel, and see cost per conversion and ROI in your stats.","md",{},true,null,"\u002Fdocs\u002Fadvertisers\u002Ftrack-conversions",{"title":5,"description":821},"docs\u002F2.advertisers\u002F05.track-conversions","nXaYlsE6VpGgerQIWLax08064hrgm2ndvTlweHQr8as",[831],{"title":832,"path":833,"stem":834,"children":835},"Docs","\u002Fdocs","docs",[836,840,866,911,950,975],{"title":837,"path":833,"stem":838,"description":839},"TrafficOX Documentation","docs\u002Findex","How to buy and sell traffic on TrafficOX — from your first top-up to tracking conversions.",{"title":841,"path":842,"stem":843,"children":844,"page":865},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started",[845,850,855,860],{"title":846,"path":847,"stem":848,"description":849},"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":851,"path":852,"stem":853,"description":854},"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":856,"path":857,"stem":858,"description":859},"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":861,"path":862,"stem":863,"description":864},"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":867,"path":868,"stem":869,"children":870,"page":865},"Advertisers","\u002Fdocs\u002Fadvertisers","docs\u002F2.advertisers",[871,876,881,886,891,892,895,900,903,906],{"title":872,"path":873,"stem":874,"description":875},"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":877,"path":878,"stem":879,"description":880},"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":882,"path":883,"stem":884,"description":885},"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":887,"path":888,"stem":889,"description":890},"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":5,"path":826,"stem":828,"description":821},{"title":790,"path":789,"stem":893,"description":894},"docs\u002F2.advertisers\u002F06.url-macros","Placeholders you can put in your landing page URL — TrafficOX fills them in on every click.",{"title":896,"path":897,"stem":898,"description":899},"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":795,"path":16,"stem":901,"description":902},"docs\u002F2.advertisers\u002F08.automation-rules","Let TrafficOX raise or lower bids and black- or whitelist sources for you, based on your statistics.",{"title":801,"path":800,"stem":904,"description":905},"docs\u002F2.advertisers\u002F09.statistics","Where to find your numbers — the dashboard, order statistics and total stats — and what each metric means.",{"title":907,"path":908,"stem":909,"description":910},"Buy through an RTB feed","\u002Fdocs\u002Fadvertisers\u002Frtb-feeds","docs\u002F2.advertisers\u002F10.rtb-feeds","Connect your DSP endpoint so TrafficOX sends you bid requests and you answer with bids.",{"title":912,"path":913,"stem":914,"children":915,"page":865},"Publishers","\u002Fdocs\u002Fpublishers","docs\u002F3.publishers",[916,921,926,931,936,941,945],{"title":917,"path":918,"stem":919,"description":920},"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":922,"path":923,"stem":924,"description":925},"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":927,"path":928,"stem":929,"description":930},"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":932,"path":933,"stem":934,"description":935},"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":937,"path":938,"stem":939,"description":940},"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":801,"path":942,"stem":943,"description":944},"\u002Fdocs\u002Fpublishers\u002Fstatistics","docs\u002F3.publishers\u002F6.statistics","Your earnings, sold and returned traffic on the dashboard, per sell order and in total.",{"title":946,"path":947,"stem":948,"description":949},"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":951,"path":952,"stem":953,"children":954,"page":865},"Api","\u002Fdocs\u002Fapi","docs\u002F4.api",[955,960,965,970],{"title":956,"path":957,"stem":958,"description":959},"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":961,"path":962,"stem":963,"description":964},"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":966,"path":967,"stem":968,"description":969},"API reference","\u002Fdocs\u002Fapi\u002Freference","docs\u002F4.api\u002F3.reference","Every endpoint of the TrafficOX API, grouped by what it manages.",{"title":971,"path":972,"stem":973,"description":974},"Statistics requests","\u002Fdocs\u002Fapi\u002Fstatistics","docs\u002F4.api\u002F4.statistics","Breakdowns, filters, sub-breakdowns and the fields returned by every statistics endpoint.",{"title":976,"path":977,"stem":978,"description":979},"Glossary","\u002Fdocs\u002Fglossary","docs\u002F5.glossary","The terms used across TrafficOX and these docs, in plain words.",1793025800214]