[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-en-\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fopenai-ads":3},{"id":4,"title":5,"body":6,"category":777,"code_examples":778,"demos":778,"description":779,"extension":780,"meta":781,"navigation":778,"order":782,"path":783,"seo":784,"sitemap":793,"stem":795,"tags":796,"toc":801,"videos":778,"__hash__":802},"docsEn\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fopenai-ads.md","Connect ChatGPT Ads",{"type":7,"value":8,"toc":758},"minimark",[9,13,17,22,25,55,59,112,119,123,177,180,187,192,199,203,206,237,240,250,265,268,285,289,314,317,385,391,395,401,407,411,445,456,460,481,484,488,573,578,588,592,595,640,643,737,741],[10,11,5],"h1",{"id":12},"connect-chatgpt-ads",[14,15,16],"p",{},"After you connect, leads and sales from your ChatGPT ads show in Konektor. You see which ad brings each lead. When your team closes a sale, Konektor sends the result back to ChatGPT Ads. The ads then learn from real sales, not only from clicks.",[18,19,21],"h2",{"id":20},"before-you-start","Before you start",[14,23,24],{},"Make sure you have these three items:",[26,27,28,40,47],"ul",{},[29,30,31,32,39],"li",{},"A ChatGPT Ads Manager account at ",[33,34,38],"a",{"href":35,"rel":36},"https:\u002F\u002Fads.openai.com",[37],"nofollow","ads.openai.com",".",[29,41,42,43,39],{},"The Konektor tracking code, installed on your landing page. See ",[33,44,46],{"href":45},"\u002Fen\u002Fdocs\u002Ftracking-installation","Install and Verify the Konektor Tracking Script",[29,48,49,50,54],{},"The ",[51,52,53],"strong",{},"owner"," role in your Konektor workspace.",[18,56,58],{"id":57},"step-1-create-a-data-source-and-a-conversions-api-key","Step 1: Create a data source and a Conversions API key",[60,61,62,69,79,89,96,106],"ol",{},[29,63,64,65,39],{},"Open ",[33,66,68],{"href":35,"rel":67},[37],"Ads Manager",[29,70,71,72,75,76,39],{},"Go to ",[51,73,74],{},"Tools"," > ",[51,77,78],{},"Conversions",[29,80,81,82,85,86,39],{},"Click ",[51,83,84],{},"Create data source",", then select ",[51,87,88],{},"Web",[29,90,91,92,95],{},"Copy the ",[51,93,94],{},"Pixel ID"," of that data source.",[29,97,98,99,102,103,39],{},"Go to the ",[51,100,101],{},"Conversion keys"," section, then click ",[51,104,105],{},"Create new key",[29,107,91,108,111],{},[51,109,110],{},"Conversions API key"," that appears.",[113,114,116],"warning",{"title":115},"The key shows only once",[14,117,118],{},"Ads Manager shows the key one time only. Keep the key in a safe place. Do not send the key in chat or email. If you lose the key, create a new one.",[18,120,122],{"id":121},"step-2-connect-in-konektor","Step 2: Connect in Konektor",[60,124,125,130,135,142,149,160,165,168,174],{},[29,126,64,127,39],{},[51,128,129],{},"Tracking Website",[29,131,81,132,39],{},[51,133,134],{},"Add ad platform",[29,136,137,138,141],{},"Select the ",[51,139,140],{},"ChatGPT Ads"," card.",[29,143,144,145,148],{},"At the ",[51,146,147],{},"Copy from Ads Manager"," step, read the instructions, then continue.",[29,150,144,151,154,155,157,158,39],{},[51,152,153],{},"Paste credentials"," step, paste your ",[51,156,94],{}," and ",[51,159,110],{},[29,161,81,162,39],{},[51,163,164],{},"Test connection",[29,166,167],{},"Make sure this message shows: \"Connected. The test event was received and is not counted in reports.\"",[29,169,144,170,173],{},[51,171,172],{},"Set up ad link"," step, copy the link template for Step 3.",[29,175,176],{},"Save.",[14,178,179],{},"After you save, the key field shows \"Saved ••••\" and the last 4 characters. Konektor never shows the full key again.",[14,181,182,183,39],{},"If a failure message shows, copy the Pixel ID and key again from Ads Manager. See ",[33,184,186],{"href":185},"#common-problems","Common problems",[188,189,191],"h3",{"id":190},"install-the-pixel-automatically","Install the pixel automatically",[14,193,194,195,198],{},"Turn on ",[51,196,197],{},"Install the ChatGPT Ads pixel automatically on the landing page"," so that Konektor installs the pixel on your site. Turn this option off only if your site already has its own ChatGPT Ads pixel.",[18,200,202],{"id":201},"step-3-set-up-your-ad-link","Step 3: Set up your ad link",[14,204,205],{},"Konektor needs an ad link that uses the template. Without the template, Konektor cannot tell which ad brought a lead.",[60,207,208,218,226,234],{},[29,209,210,211,213,214,217],{},"In ",[51,212,129],{},", open the ",[51,215,216],{},"Ad link template"," section.",[29,219,137,220,222,223,39],{},[51,221,140],{}," tab, then click ",[51,224,225],{},"Copy",[29,227,228,229,233],{},"Replace ",[230,231,232],"code",{},"your-landing-page.com"," with the address of your landing page.",[29,235,236],{},"Paste the link as the destination URL of each ChatGPT Ads ad.",[14,238,239],{},"Link template:",[241,242,247],"pre",{"className":243,"code":245,"language":246},[244],"language-text","https:\u002F\u002Fyour-landing-page.com\u002F?utm_source=chatgpt-ads&utm_medium=paid&utm_campaign={campaign_id}&campaign_id={campaign_id}&ad_group_id={ad_group_id}&ad_id={ad_id}\n","text",[230,248,245],{"__ignoreMap":249},"",[14,251,252,253,256,257,260,261,264],{},"Do not change the parts in curly brackets. ChatGPT Ads replaces ",[230,254,255],{},"{campaign_id}",", ",[230,258,259],{},"{ad_group_id}",", and ",[230,262,263],{},"{ad_id}"," with the real values when the ad runs.",[14,266,267],{},"ChatGPT adds the click ID to the link automatically. You do not need to write it.",[269,270,272],"tip",{"title":271},"A link that already has a question mark",[14,273,274,275,278,279,282,283,39],{},"If your destination URL already has a ",[230,276,277],{},"?",", join the parameters with ",[230,280,281],{},"&",". A URL can have only one ",[230,284,277],{},[18,286,288],{"id":287},"step-4-choose-the-events-to-send","Step 4: Choose the events to send",[60,290,291,298,305,311],{},[29,292,71,293,75,295,39],{},[51,294,78],{},[51,296,297],{},"Conversion Settings",[29,299,300,301,304],{},"Open the ",[51,302,303],{},"Mapping"," tab.",[29,306,307,308,310],{},"Find the ",[51,309,140],{}," column.",[29,312,313],{},"For each lead status, select the event that Konektor sends.",[14,315,316],{},"Default mapping:",[318,319,320,337],"table",{},[321,322,323],"thead",{},[324,325,326,331,334],"tr",{},[327,328,330],"th",{"align":329},"left","Lead status",[327,332,333],{"align":329},"Event sent",[327,335,336],{"align":329},"Event type",[338,339,340,352,365,375],"tbody",{},[324,341,342,346,349],{},[343,344,345],"td",{"align":329},"New",[343,347,348],{"align":329},"Lead created",[343,350,351],{"align":329},"Standard",[324,353,354,357,362],{},[343,355,356],{"align":329},"Qualified",[343,358,359],{"align":329},[230,360,361],{},"qualified_lead",[343,363,364],{"align":329},"Custom event",[324,366,367,370,373],{},[343,368,369],{"align":329},"Proposal",[343,371,372],{"align":329},"Checkout started",[343,374,351],{"align":329},[324,376,377,380,383],{},[343,378,379],{"align":329},"Won",[343,381,382],{"align":329},"Purchase",[343,384,351],{"align":329},[14,386,387,388,39],{},"Other statuses default to ",[51,389,390],{},"Not sent",[188,392,394],{"id":393},"the-optimizable-badge","The \"Optimizable\" badge",[14,396,49,397,400],{},[51,398,399],{},"Optimizable"," badge shows on standard events. You can select only a standard event as the optimization goal of a campaign. A custom event still shows in reports, but it cannot be an optimization goal.",[14,402,403,404,406],{},"Konektor sends a custom event when you select ",[51,405,364],{}," and enter its name. Use lowercase letters, digits, underscores, or hyphens, with a maximum of 64 characters.",[188,408,410],{"id":409},"strict-mode-and-send-all","Strict mode and Send all",[318,412,413,423],{},[321,414,415],{},[324,416,417,420],{},[327,418,419],{"align":329},"Strategy",[327,421,422],{"align":329},"How it works",[338,424,425,435],{},[324,426,427,432],{},[343,428,429],{"align":329},[51,430,431],{},"Strict mode",[343,433,434],{"align":329},"Konektor sends only conversions from ChatGPT Ads leads. Your ad data stays clean.",[324,436,437,442],{},[343,438,439],{"align":329},[51,440,441],{},"Send all",[343,443,444],{"align":329},"Konektor sends all eligible conversions, including those that did not come from an ad click.",[14,446,447,448,450,451,455],{},"Start with ",[51,449,431],{},". Read ",[33,452,454],{"href":453},"\u002Fen\u002Fdocs\u002Fbusiness\u002Fconversion-strategy","Conversion Strategy"," for the full comparison.",[18,457,459],{"id":458},"step-5-create-a-conversion-event-in-ads-manager-and-add-it-to-your-campaign","Step 5: Create a conversion event in Ads Manager and add it to your campaign",[60,461,462,469,472,475,478],{},[29,463,464,465,75,467,39],{},"In Ads Manager, go to ",[51,466,74],{},[51,468,78],{},[29,470,471],{},"Create a conversion event for the same event you chose in Step 4. Example: Purchase.",[29,473,474],{},"Set the attribution window to 30 days.",[29,476,477],{},"Open your campaign.",[29,479,480],{},"Select that conversion event as the goal of the campaign.",[14,482,483],{},"Choose a standard event if you want to optimize the campaign for that event.",[18,485,487],{"id":486},"check-the-result","Check the result",[318,489,490,500],{},[321,491,492],{},[324,493,494,497],{},[327,495,496],{"align":329},"Where",[327,498,499],{"align":329},"What you see",[338,501,502,517,539,550,562],{},[324,503,504,514],{},[343,505,506,75,508,75,510,513],{"align":329},[51,507,78],{},[51,509,297],{},[51,511,512],{},"Delivery log"," tab",[343,515,516],{"align":329},"The status of each event that Konektor sent.",[324,518,519,526],{},[343,520,49,521,523,524],{"align":329},[51,522,140],{}," row in ",[51,525,129],{},[343,527,528,529,256,532,535,536,39],{"align":329},"The status ",[51,530,531],{},"Healthy",[51,533,534],{},"Waiting for events",", or ",[51,537,538],{},"Problem",[324,540,541,547],{},[343,542,543,546],{"align":329},[51,544,545],{},"Event Stream"," in Ads Manager",[343,548,549],{"align":329},"The events that ChatGPT Ads received.",[324,551,552,559],{},[343,553,554,75,557,513],{"align":329},[51,555,556],{},"Ad Analytics",[51,558,140],{},[343,560,561],{"align":329},"Leads and results for each campaign.",[324,563,564,567],{},[343,565,566],{"align":329},"Lead details",[343,568,49,569,572],{"align":329},[51,570,571],{},"ChatGPT Ads click"," badge on leads that came from an ad.",[14,574,528,575,577],{},[51,576,534],{}," means the connection is correct, but no event has been sent yet. This status is normal right after you connect.",[14,579,580,581,584,585,587],{},"Use ",[51,582,583],{},"Send test"," on the ",[51,586,140],{}," row to send a test event at any time. Test events do not enter reports.",[18,589,591],{"id":590},"sites-with-a-content-security-policy","Sites with a Content Security Policy",[14,593,594],{},"If your site uses a Content Security Policy (CSP), ask your developer to allow the addresses below. Without them, the browser blocks the ChatGPT Ads pixel.",[318,596,597,607],{},[321,598,599],{},[324,600,601,604],{},[327,602,603],{"align":329},"Permission type",[327,605,606],{"align":329},"Address",[338,608,609,619,631],{},[324,610,611,614],{},[343,612,613],{"align":329},"Script",[343,615,616],{"align":329},[230,617,618],{},"https:\u002F\u002Fbzrcdn.openai.com",[324,620,621,624],{},[343,622,623],{"align":329},"Connection",[343,625,626,157,629],{"align":329},[230,627,628],{},"https:\u002F\u002Fbzr.openai.com",[230,630,618],{},[324,632,633,636],{},[343,634,635],{"align":329},"Image",[343,637,638],{"align":329},[230,639,628],{},[18,641,186],{"id":642},"common-problems",[318,644,645,658],{},[321,646,647],{},[324,648,649,652,655],{},[327,650,651],{"align":329},"Symptom",[327,653,654],{"align":329},"Cause",[327,656,657],{"align":329},"Action",[338,659,660,671,688,699,710,721],{},[324,661,662,665,668],{},[343,663,664],{"align":329},"The message \"Pixel ID or key does not match\" shows",[343,666,667],{"align":329},"The Pixel ID and the key come from different data sources, or the key was replaced.",[343,669,670],{"align":329},"Copy the Pixel ID and key again from the same data source. If you lost the key, create a new one.",[324,672,673,676,681],{},[343,674,675],{"align":329},"No event shows in Event Stream",[343,677,678,679,39],{"align":329},"No lead has reached a mapped status yet, or the status is still ",[51,680,534],{},[343,682,580,683,685,686,304],{"align":329},[51,684,583],{},". Then move one test lead to a mapped status and check the ",[51,687,512],{},[324,689,690,693,696],{},[343,691,692],{"align":329},"A conversion is not sent again",[343,694,695],{"align":329},"ChatGPT Ads accepts only conversions from the last 7 days. The resend button shows this reason.",[343,697,698],{"align":329},"No action. A conversion older than 7 days cannot be sent. Send new conversions sooner.",[324,700,701,704,707],{},[343,702,703],{"align":329},"A lead from a ChatGPT ad does not show as an ad lead",[343,705,706],{"align":329},"The ad link does not use the template, so Konektor cannot recognize the source.",[343,708,709],{"align":329},"Use the template from Step 3 in all ads. Change the URL of ads that already run.",[324,711,712,715,718],{},[343,713,714],{"align":329},"A lead from a normal ChatGPT answer is not counted as an ad",[343,716,717],{"align":329},"A link in a normal ChatGPT answer is organic traffic, not an ad.",[343,719,720],{"align":329},"No action. Konektor counts only clicks from ChatGPT Ads ads as ads.",[324,722,723,728,731],{},[343,724,725,726],{"align":329},"An event is not sent in ",[51,727,431],{},[343,729,730],{"align":329},"The lead did not come from a ChatGPT Ads ad.",[343,732,733,734,736],{"align":329},"Use the link with the template. Or select ",[51,735,441],{}," if you want to send all conversions.",[18,738,740],{"id":739},"next-steps","Next steps",[26,742,743,748,754],{},[29,744,745],{},[33,746,297],{"href":747},"\u002Fen\u002Fdocs\u002Fadvanced\u002Fconversion-settings",[29,749,750],{},[33,751,753],{"href":752},"\u002Fen\u002Fdocs\u002Ftracking\u002Futm-parameters","UTM Parameters",[29,755,756],{},[33,757,454],{"href":453},{"title":249,"searchDepth":759,"depth":759,"links":760},2,[761,762,763,767,768,772,773,774,775,776],{"id":20,"depth":759,"text":21},{"id":57,"depth":759,"text":58},{"id":121,"depth":759,"text":122,"children":764},[765],{"id":190,"depth":766,"text":191},3,{"id":201,"depth":759,"text":202},{"id":287,"depth":759,"text":288,"children":769},[770,771],{"id":393,"depth":766,"text":394},{"id":409,"depth":766,"text":410},{"id":458,"depth":759,"text":459},{"id":486,"depth":759,"text":487},{"id":590,"depth":759,"text":591},{"id":642,"depth":759,"text":186},{"id":739,"depth":759,"text":740},"platform-guides",null,"How to connect ChatGPT Ads to Konektor: create a key in Ads Manager, set up your ad link, choose events, and check the result.","md",{},9,"\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fopenai-ads",{"title":785,"description":786,"keywords":787,"canonical":783},"Connect ChatGPT Ads to Konektor","Measure leads and sales from ChatGPT ads. Connect your Pixel ID and Conversions API key, set up your ad link, and send closed sales back to ChatGPT Ads.",[788,789,790,791,792],"chatgpt ads","chatgpt ads tracking","openai ads tracking","chatgpt conversions api","how to track chatgpt ads",{"loc":783,"lastmod":794},"2026-10-02","en\u002Fdocs\u002Fplatform-guides\u002Fopenai-ads",[788,797,798,799,800],"openai ads","conversions api","tracking","pixel",true,"Go5CWMsmblSQ6TMInELJ7ccV14qNE7TGvZFVLzV2U9Q"]