[{"data":1,"prerenderedAt":1601},["ShallowReactive",2],{"navigation_docs_en":3,"-en-advertiser-api-write":131,"-en-advertiser-api-write-surround":1596},[4,18,47,60,69,102,127],{"title":5,"path":6,"stem":7,"children":8,"page":17},"Getting Started","\u002Fen\u002Fgetting-started","en\u002F1.getting-started",[9,13],{"title":10,"path":11,"stem":12},"Installation","\u002Fen\u002Fgetting-started\u002Finstallation","en\u002F1.getting-started\u002F1.installation",{"title":14,"path":15,"stem":16},"Configuration","\u002Fen\u002Fgetting-started\u002Fconfiguration","en\u002F1.getting-started\u002F2.configuration",false,{"title":19,"path":20,"stem":21,"children":22,"page":17},"Features","\u002Fen\u002Ffeatures","en\u002F2.features",[23,27,31,35,39,43],{"title":24,"path":25,"stem":26},"Page View Tracking","\u002Fen\u002Ffeatures\u002Fpageview-tracking","en\u002F2.features\u002F1.pageview-tracking",{"title":28,"path":29,"stem":30},"Conversion Tracking","\u002Fen\u002Ffeatures\u002Fconversion-tracking","en\u002F2.features\u002F2.conversion-tracking",{"title":32,"path":33,"stem":34},"SPA Support","\u002Fen\u002Ffeatures\u002Fspa-support","en\u002F2.features\u002F3.spa-support",{"title":36,"path":37,"stem":38},"React & Next.js","\u002Fen\u002Ffeatures\u002Freact-integration","en\u002F2.features\u002F4.react-integration",{"title":40,"path":41,"stem":42},"Vue & Nuxt","\u002Fen\u002Ffeatures\u002Fvue-integration","en\u002F2.features\u002F5.vue-integration",{"title":44,"path":45,"stem":46},"Google Tag Manager","\u002Fen\u002Ffeatures\u002Fgtm-integration","en\u002F2.features\u002F6.gtm-integration",{"title":48,"path":49,"stem":50,"children":51,"page":17},"Api","\u002Fen\u002Fapi","en\u002F3.api",[52,56],{"title":53,"path":54,"stem":55},"API Reference","\u002Fen\u002Fapi\u002Freference","en\u002F3.api\u002F1.reference",{"title":57,"path":58,"stem":59},"Events Reference","\u002Fen\u002Fapi\u002Fevents-reference","en\u002F3.api\u002F2.events-reference",{"title":61,"path":62,"stem":63,"children":64,"page":17},"Privacy","\u002Fen\u002Fprivacy","en\u002F4.privacy",[65],{"title":66,"path":67,"stem":68},"Data Collection & Privacy","\u002Fen\u002Fprivacy\u002Fdata-collection","en\u002F4.privacy\u002F1.data-collection",{"title":70,"path":71,"stem":72,"children":73,"page":17},"Chat SDK","\u002Fen\u002Fchat-sdk","en\u002F5.chat-sdk",[74,78,82,86,90,94,98],{"title":75,"path":76,"stem":77},"Chat SDK Getting Started","\u002Fen\u002Fchat-sdk\u002Fgetting-started","en\u002F5.chat-sdk\u002F1.getting-started",{"title":79,"path":80,"stem":81},"Vue Non-chat Integration","\u002Fen\u002Fchat-sdk\u002Fvue-non-chat","en\u002F5.chat-sdk\u002F2.vue-non-chat",{"title":83,"path":84,"stem":85},"React Integration","\u002Fen\u002Fchat-sdk\u002Freact-integration","en\u002F5.chat-sdk\u002F3.react-integration",{"title":87,"path":88,"stem":89},"AI SDK Middleware","\u002Fen\u002Fchat-sdk\u002Fai-sdk-middleware","en\u002F5.chat-sdk\u002F4.ai-sdk-middleware",{"title":91,"path":92,"stem":93},"Ad Formats","\u002Fen\u002Fchat-sdk\u002Fad-formats","en\u002F5.chat-sdk\u002F5.ad-formats",{"title":95,"path":96,"stem":97},"Tracking and Attribution","\u002Fen\u002Fchat-sdk\u002Ftracking-and-attribution","en\u002F5.chat-sdk\u002F6.tracking-and-attribution",{"title":99,"path":100,"stem":101},"Troubleshooting","\u002Fen\u002Fchat-sdk\u002Ftroubleshooting","en\u002F5.chat-sdk\u002F7.troubleshooting",{"title":103,"path":104,"stem":105,"children":106,"page":17},"Advertiser API","\u002Fen\u002Fadvertiser-api","en\u002F6.advertiser-api",[107,111,115,119,123],{"title":108,"path":109,"stem":110},"Overview","\u002Fen\u002Fadvertiser-api\u002Foverview","en\u002F6.advertiser-api\u002F1.overview",{"title":112,"path":113,"stem":114},"Read","\u002Fen\u002Fadvertiser-api\u002Fread","en\u002F6.advertiser-api\u002F2.read",{"title":116,"path":117,"stem":118},"Write","\u002Fen\u002Fadvertiser-api\u002Fwrite","en\u002F6.advertiser-api\u002F3.write",{"title":120,"path":121,"stem":122},"Conversions API","\u002Fen\u002Fadvertiser-api\u002Fconversions","en\u002F6.advertiser-api\u002F4.conversions",{"title":124,"path":125,"stem":126},"MCP server","\u002Fen\u002Fadvertiser-api\u002Fmcp","en\u002F6.advertiser-api\u002F5.mcp",{"title":128,"path":129,"stem":130},"Start Here","\u002Fen\u002Fstart-here","en\u002Fstart-here",{"id":132,"title":116,"body":133,"description":1589,"extension":1590,"links":1591,"meta":1592,"navigation":1593,"path":117,"seo":1594,"stem":118,"__hash__":1595},"docs_en\u002Fen\u002F6.advertiser-api\u002F3.write.md",{"type":134,"value":135,"toc":1579},"minimark",[136,140,159,169,186,195,200,233,243,301,337,496,505,508,628,661,666,670,676,734,779,784,829,835,839,870,990,1013,1017,1055,1158,1174,1179,1195,1198,1207,1217,1274,1278,1284,1354,1379,1383,1389,1401,1420,1425,1428,1498,1565,1575],[137,138,116],"h1",{"id":139},"write",[141,142,143,147,148,151,152,154,155,158],"p",{},[144,145,146],"code",{},"POST"," and ",[144,149,150],{},"PATCH"," require the ",[144,153,139],{}," scope. Amounts are euro cents. Send ",[144,156,157],{},"Content-Type: application\u002Fjson",".",[160,161,167],"pre",{"className":162,"code":164,"language":165,"meta":166},[163],"language-text","https:\u002F\u002Ftyfrhxfejrawgdlhryfu.supabase.co\u002Ffunctions\u002Fv1\u002Fadvertiser-api\n","text","",[144,168,164],{"__ignoreMap":166},[141,170,171,173,174,177,178,182,183,158],{},[144,172,146],{}," accepts ",[144,175,176],{},"Idempotency-Key",". See ",[179,180,108],"a",{"href":181},"\u002Fadvertiser-api\u002Foverview",". Pause and resume take no JSON body. A non-empty body on those routes is ",[144,184,185],{},"400",[141,187,188,191,192,158],{},[144,189,190],{},"\u002Fcreatives"," is the same resource as ",[144,193,194],{},"\u002Fads",[196,197,199],"h2",{"id":198},"create-a-campaign","Create a campaign",[141,201,202,205,206,209,210,213,214,217,218,213,221,217,224,213,227,217,230,158],{},[144,203,204],{},"POST \u002Fcampaigns"," creates the campaign and its ad set in this organization with ",[144,207,208],{},"created_via"," set to ",[144,211,212],{},"api",". ",[144,215,216],{},"status"," defaults to ",[144,219,220],{},"draft",[144,222,223],{},"objective",[144,225,226],{},"traffic",[144,228,229],{},"budget_type",[144,231,232],{},"daily",[141,234,235,238,239,242],{},[144,236,237],{},"name"," (1–120 characters) and ",[144,240,241],{},"budget_cents"," are required.",[244,245,246,262],"table",{},[247,248,249],"thead",{},[250,251,252,256,259],"tr",{},[253,254,255],"th",{},"Objective",[253,257,258],{},"Billing",[253,260,261],{},"Bid field",[263,264,265,282],"tbody",{},[250,266,267,273,276],{},[268,269,270],"td",{},[144,271,272],{},"awareness",[268,274,275],{},"CPM",[268,277,278,281],{},[144,279,280],{},"cpm_bid_cents",", €10–€100 per 1,000 impressions",[250,283,284,292,295],{},[268,285,286,288,289],{},[144,287,226],{},", ",[144,290,291],{},"conversion",[268,293,294],{},"CPC",[268,296,297,300],{},[144,298,299],{},"cpc_bid_cents",", €0.50–€10 per click",[141,302,303,306,307,310,311,314,315,310,318,321,322,325,326,328,329,332,333,336],{},[144,304,305],{},"bid_cents"," is an alias of the bid for that billing model. Daily budget is €10–€1,000 (",[144,308,309],{},"1000","–",[144,312,313],{},"100000"," cents). Lifetime budget is €50–€10,000 (",[144,316,317],{},"5000",[144,319,320],{},"1000000"," cents). ",[144,323,324],{},"daily_budget_cents"," is an optional daily spend cap when ",[144,327,229],{}," is ",[144,330,331],{},"lifetime"," (€10–€1,000), or ",[144,334,335],{},"null"," to clear it.",[160,338,342],{"className":339,"code":340,"language":341,"meta":166,"style":166},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl -X POST 'https:\u002F\u002Ftyfrhxfejrawgdlhryfu.supabase.co\u002Ffunctions\u002Fv1\u002Fadvertiser-api\u002Fcampaigns' \\\n  -H 'Authorization: Bearer idl_adv_xxx' \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -H 'Idempotency-Key: campaign-2026-11-04' \\\n  -d '{\n    \"name\": \"Spring launch\",\n    \"objective\": \"traffic\",\n    \"budget_type\": \"daily\",\n    \"budget_cents\": 2000,\n    \"cpc_bid_cents\": 100,\n    \"targeting\": {\n      \"placements\": [\"inline\", \"chat_sponsored_recommendation\"],\n      \"countries\": [\"FR\", \"DE\"],\n      \"tech_stack\": { \"include\": [\"react\"], \"exclude\": [\"vue\"] }\n    }\n  }'\n","bash",[144,343,344,374,389,402,416,427,433,439,445,451,457,463,469,475,481,487],{"__ignoreMap":166},[345,346,349,353,357,360,364,367,370],"span",{"class":347,"line":348},"line",1,[345,350,352],{"class":351},"sBMFI","curl",[345,354,356],{"class":355},"sfazB"," -X",[345,358,359],{"class":355}," POST",[345,361,363],{"class":362},"sMK4o"," '",[345,365,366],{"class":355},"https:\u002F\u002Ftyfrhxfejrawgdlhryfu.supabase.co\u002Ffunctions\u002Fv1\u002Fadvertiser-api\u002Fcampaigns",[345,368,369],{"class":362},"'",[345,371,373],{"class":372},"sTEyZ"," \\\n",[345,375,377,380,382,385,387],{"class":347,"line":376},2,[345,378,379],{"class":355},"  -H",[345,381,363],{"class":362},[345,383,384],{"class":355},"Authorization: Bearer idl_adv_xxx",[345,386,369],{"class":362},[345,388,373],{"class":372},[345,390,392,394,396,398,400],{"class":347,"line":391},3,[345,393,379],{"class":355},[345,395,363],{"class":362},[345,397,157],{"class":355},[345,399,369],{"class":362},[345,401,373],{"class":372},[345,403,405,407,409,412,414],{"class":347,"line":404},4,[345,406,379],{"class":355},[345,408,363],{"class":362},[345,410,411],{"class":355},"Idempotency-Key: campaign-2026-11-04",[345,413,369],{"class":362},[345,415,373],{"class":372},[345,417,419,422,424],{"class":347,"line":418},5,[345,420,421],{"class":355},"  -d",[345,423,363],{"class":362},[345,425,426],{"class":355},"{\n",[345,428,430],{"class":347,"line":429},6,[345,431,432],{"class":355},"    \"name\": \"Spring launch\",\n",[345,434,436],{"class":347,"line":435},7,[345,437,438],{"class":355},"    \"objective\": \"traffic\",\n",[345,440,442],{"class":347,"line":441},8,[345,443,444],{"class":355},"    \"budget_type\": \"daily\",\n",[345,446,448],{"class":347,"line":447},9,[345,449,450],{"class":355},"    \"budget_cents\": 2000,\n",[345,452,454],{"class":347,"line":453},10,[345,455,456],{"class":355},"    \"cpc_bid_cents\": 100,\n",[345,458,460],{"class":347,"line":459},11,[345,461,462],{"class":355},"    \"targeting\": {\n",[345,464,466],{"class":347,"line":465},12,[345,467,468],{"class":355},"      \"placements\": [\"inline\", \"chat_sponsored_recommendation\"],\n",[345,470,472],{"class":347,"line":471},13,[345,473,474],{"class":355},"      \"countries\": [\"FR\", \"DE\"],\n",[345,476,478],{"class":347,"line":477},14,[345,479,480],{"class":355},"      \"tech_stack\": { \"include\": [\"react\"], \"exclude\": [\"vue\"] }\n",[345,482,484],{"class":347,"line":483},15,[345,485,486],{"class":355},"    }\n",[345,488,490,493],{"class":347,"line":489},16,[345,491,492],{"class":355},"  }",[345,494,495],{"class":362},"'\n",[141,497,498,499,147,502,158],{},"A successful create returns ",[144,500,501],{},"201",[144,503,504],{},"{ \"data\": { ...campaign } }",[141,506,507],{},"Other write fields:",[244,509,510,520],{},[247,511,512],{},[250,513,514,517],{},[253,515,516],{},"Field",[253,518,519],{},"Rule",[263,521,522,542,563,575,585,595,612],{},[250,523,524,528],{},[268,525,526],{},[144,527,216],{},[268,529,530,288,532,535,536,213,539,541],{},[144,531,220],{},[144,533,534],{},"active",", or ",[144,537,538],{},"paused",[144,540,534],{}," on the first API campaign is refused",[250,543,544,552],{},[268,545,546,288,549],{},[144,547,548],{},"start_date",[144,550,551],{},"end_date",[268,553,554,555,557,558,560,561],{},"ISO-8601, or ",[144,556,335],{}," to clear. ",[144,559,551],{}," must be on or after ",[144,562,548],{},[250,564,565,570],{},[268,566,567],{},[144,568,569],{},"conversion_event",[268,571,572,573],{},"String up to 80 characters, or ",[144,574,335],{},[250,576,577,582],{},[268,578,579],{},[144,580,581],{},"conversion_window_days",[268,583,584],{},"Integer, 1–90",[250,586,587,592],{},[268,588,589],{},[144,590,591],{},"targeting.placements",[268,593,594],{},"At least one of the placements below",[250,596,597,602],{},[268,598,599],{},[144,600,601],{},"targeting.countries",[268,603,604,605,608,609,611],{},"ISO country codes. ",[144,606,607],{},"[]"," or ",[144,610,335],{}," means worldwide",[250,613,614,619],{},[268,615,616],{},[144,617,618],{},"targeting.tech_stack",[268,620,621,147,624,627],{},[144,622,623],{},"include",[144,625,626],{},"exclude"," string lists. A technology cannot be in both",[141,629,630,631,288,634,288,637,288,640,288,643,288,646,288,649,288,652,288,655,288,658,158],{},"Placements: ",[144,632,633],{},"browser_overlay",[144,635,636],{},"browser_toast",[144,638,639],{},"chat_sponsored_recommendation",[144,641,642],{},"chat_cta_card",[144,644,645],{},"chat_contextual_link",[144,647,648],{},"chat_sponsored_answer",[144,650,651],{},"inline",[144,653,654],{},"toast",[144,656,657],{},"sidebar",[144,659,660],{},"popup",[141,662,663,664,158],{},"Unknown JSON fields are ",[144,665,185],{},[196,667,669],{"id":668},"update-pause-resume","Update, pause, resume",[141,671,672,675],{},[144,673,674],{},"PATCH \u002Fcampaigns\u002F{id}"," updates only the fields you send. Targeting, bid, and budget fields update the campaign's earliest ad set.",[160,677,679],{"className":339,"code":678,"language":341,"meta":166,"style":166},"curl -X PATCH 'https:\u002F\u002Ftyfrhxfejrawgdlhryfu.supabase.co\u002Ffunctions\u002Fv1\u002Fadvertiser-api\u002Fcampaigns\u002FCAMPAIGN_UUID' \\\n  -H 'Authorization: Bearer idl_adv_xxx' \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{ \"cpc_bid_cents\": 150 }'\n",[144,680,681,699,711,723],{"__ignoreMap":166},[345,682,683,685,687,690,692,695,697],{"class":347,"line":348},[345,684,352],{"class":351},[345,686,356],{"class":355},[345,688,689],{"class":355}," PATCH",[345,691,363],{"class":362},[345,693,694],{"class":355},"https:\u002F\u002Ftyfrhxfejrawgdlhryfu.supabase.co\u002Ffunctions\u002Fv1\u002Fadvertiser-api\u002Fcampaigns\u002FCAMPAIGN_UUID",[345,696,369],{"class":362},[345,698,373],{"class":372},[345,700,701,703,705,707,709],{"class":347,"line":376},[345,702,379],{"class":355},[345,704,363],{"class":362},[345,706,384],{"class":355},[345,708,369],{"class":362},[345,710,373],{"class":372},[345,712,713,715,717,719,721],{"class":347,"line":391},[345,714,379],{"class":355},[345,716,363],{"class":362},[345,718,157],{"class":355},[345,720,369],{"class":362},[345,722,373],{"class":372},[345,724,725,727,729,732],{"class":347,"line":404},[345,726,421],{"class":355},[345,728,363],{"class":362},[345,730,731],{"class":355},"{ \"cpc_bid_cents\": 150 }",[345,733,495],{"class":362},[160,735,737],{"className":339,"code":736,"language":341,"meta":166,"style":166},"curl -X POST 'https:\u002F\u002Ftyfrhxfejrawgdlhryfu.supabase.co\u002Ffunctions\u002Fv1\u002Fadvertiser-api\u002Fcampaigns\u002FCAMPAIGN_UUID\u002Fpause' \\\n  -H 'Authorization: Bearer idl_adv_xxx' \\\n  -H 'Idempotency-Key: pause-campaign-1'\n",[144,738,739,756,768],{"__ignoreMap":166},[345,740,741,743,745,747,749,752,754],{"class":347,"line":348},[345,742,352],{"class":351},[345,744,356],{"class":355},[345,746,359],{"class":355},[345,748,363],{"class":362},[345,750,751],{"class":355},"https:\u002F\u002Ftyfrhxfejrawgdlhryfu.supabase.co\u002Ffunctions\u002Fv1\u002Fadvertiser-api\u002Fcampaigns\u002FCAMPAIGN_UUID\u002Fpause",[345,753,369],{"class":362},[345,755,373],{"class":372},[345,757,758,760,762,764,766],{"class":347,"line":376},[345,759,379],{"class":355},[345,761,363],{"class":362},[345,763,384],{"class":355},[345,765,369],{"class":362},[345,767,373],{"class":372},[345,769,770,772,774,777],{"class":347,"line":391},[345,771,379],{"class":355},[345,773,363],{"class":362},[345,775,776],{"class":355},"Idempotency-Key: pause-campaign-1",[345,778,495],{"class":362},[141,780,781,782,158],{},"Pause sets the campaign and its ad sets to ",[144,783,538],{},[160,785,787],{"className":339,"code":786,"language":341,"meta":166,"style":166},"curl -X POST 'https:\u002F\u002Ftyfrhxfejrawgdlhryfu.supabase.co\u002Ffunctions\u002Fv1\u002Fadvertiser-api\u002Fcampaigns\u002FCAMPAIGN_UUID\u002Fresume' \\\n  -H 'Authorization: Bearer idl_adv_xxx' \\\n  -H 'Idempotency-Key: resume-campaign-1'\n",[144,788,789,806,818],{"__ignoreMap":166},[345,790,791,793,795,797,799,802,804],{"class":347,"line":348},[345,792,352],{"class":351},[345,794,356],{"class":355},[345,796,359],{"class":355},[345,798,363],{"class":362},[345,800,801],{"class":355},"https:\u002F\u002Ftyfrhxfejrawgdlhryfu.supabase.co\u002Ffunctions\u002Fv1\u002Fadvertiser-api\u002Fcampaigns\u002FCAMPAIGN_UUID\u002Fresume",[345,803,369],{"class":362},[345,805,373],{"class":372},[345,807,808,810,812,814,816],{"class":347,"line":376},[345,809,379],{"class":355},[345,811,363],{"class":362},[345,813,384],{"class":355},[345,815,369],{"class":362},[345,817,373],{"class":372},[345,819,820,822,824,827],{"class":347,"line":391},[345,821,379],{"class":355},[345,823,363],{"class":362},[345,825,826],{"class":355},"Idempotency-Key: resume-campaign-1",[345,828,495],{"class":362},[141,830,831,832,834],{},"Resume sets the campaign and its ad sets to ",[144,833,534],{}," when the wallet has a balance and at least one ad is approved.",[196,836,838],{"id":837},"first-campaign","First campaign",[141,840,841,842,328,844,846,847,849,850,288,853,855,856,858,859,861,862,865,866,869],{},"The organization's first campaign cannot be turned on from this API when that campaign was created through the API (",[144,843,208],{},[144,845,212],{},"). ",[144,848,204],{}," with ",[144,851,852],{},"\"status\": \"active\"",[144,854,150],{}," that sets ",[144,857,216],{}," to ",[144,860,534],{},", and ",[144,863,864],{},"POST \u002Fcampaigns\u002F{id}\u002Fresume"," all return ",[144,867,868],{},"409",". The campaign stays a draft.",[160,871,875],{"className":872,"code":873,"language":874,"meta":166,"style":166},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"error\": {\n    \"code\": \"first_campaign_requires_dashboard_validation\",\n    \"message\": \"This organization's first campaign was created through the API. Activate it in the adsmanager before the API can turn a campaign on.\",\n    \"campaign_id\": \"CAMPAIGN_UUID\",\n    \"dashboard_url\": \"https:\u002F\u002Fadsmanager.idlen.io\u002Fcampaigns\u002FCAMPAIGN_UUID\"\n  }\n}\n","json",[144,876,877,881,899,921,941,961,980,985],{"__ignoreMap":166},[345,878,879],{"class":347,"line":348},[345,880,426],{"class":362},[345,882,883,886,890,893,896],{"class":347,"line":376},[345,884,885],{"class":362},"  \"",[345,887,889],{"class":888},"spNyl","error",[345,891,892],{"class":362},"\"",[345,894,895],{"class":362},":",[345,897,898],{"class":362}," {\n",[345,900,901,904,906,908,910,913,916,918],{"class":347,"line":391},[345,902,903],{"class":362},"    \"",[345,905,144],{"class":351},[345,907,892],{"class":362},[345,909,895],{"class":362},[345,911,912],{"class":362}," \"",[345,914,915],{"class":355},"first_campaign_requires_dashboard_validation",[345,917,892],{"class":362},[345,919,920],{"class":362},",\n",[345,922,923,925,928,930,932,934,937,939],{"class":347,"line":404},[345,924,903],{"class":362},[345,926,927],{"class":351},"message",[345,929,892],{"class":362},[345,931,895],{"class":362},[345,933,912],{"class":362},[345,935,936],{"class":355},"This organization's first campaign was created through the API. Activate it in the adsmanager before the API can turn a campaign on.",[345,938,892],{"class":362},[345,940,920],{"class":362},[345,942,943,945,948,950,952,954,957,959],{"class":347,"line":418},[345,944,903],{"class":362},[345,946,947],{"class":351},"campaign_id",[345,949,892],{"class":362},[345,951,895],{"class":362},[345,953,912],{"class":362},[345,955,956],{"class":355},"CAMPAIGN_UUID",[345,958,892],{"class":362},[345,960,920],{"class":362},[345,962,963,965,968,970,972,974,977],{"class":347,"line":429},[345,964,903],{"class":362},[345,966,967],{"class":351},"dashboard_url",[345,969,892],{"class":362},[345,971,895],{"class":362},[345,973,912],{"class":362},[345,975,976],{"class":355},"https:\u002F\u002Fadsmanager.idlen.io\u002Fcampaigns\u002FCAMPAIGN_UUID",[345,978,979],{"class":362},"\"\n",[345,981,982],{"class":347,"line":435},[345,983,984],{"class":362},"  }\n",[345,986,987],{"class":347,"line":441},[345,988,989],{"class":362},"}\n",[141,991,992,993,995,996,147,998,328,1001,288,1004,288,1007,535,1010,158],{},"Open ",[144,994,967],{}," and turn that campaign on in Ads Manager. A later campaign is not blocked by this rule. It can go active only when the wallet has funds and at least one ad is approved. Otherwise the status is ",[144,997,868],{},[144,999,1000],{},"error.code",[144,1002,1003],{},"insufficient_balance",[144,1005,1006],{},"ads_pending_moderation",[144,1008,1009],{},"ad_required",[144,1011,1012],{},"no_active_ad_set",[196,1014,1016],{"id":1015},"create-an-ad","Create an ad",[141,1018,1019,1022,1023,1025,1026,1029,1030,1033,1034,1037,1038,1041,1042,1045,1046,1049,1050,1052,1053,158],{},[144,1020,1021],{},"POST \u002Fads"," requires ",[144,1024,947],{}," (UUID in this organization), ",[144,1027,1028],{},"title"," (1–60 characters), and ",[144,1031,1032],{},"cta_url"," (an ",[144,1035,1036],{},"https:\u002F\u002F"," URL). ",[144,1039,1040],{},"body"," defaults to empty and is at most 150 characters. ",[144,1043,1044],{},"cta_text"," is 1–40 characters. ",[144,1047,1048],{},"image_url"," is an ",[144,1051,1036],{}," URL or ",[144,1054,335],{},[160,1056,1058],{"className":339,"code":1057,"language":341,"meta":166,"style":166},"curl -X POST 'https:\u002F\u002Ftyfrhxfejrawgdlhryfu.supabase.co\u002Ffunctions\u002Fv1\u002Fadvertiser-api\u002Fads' \\\n  -H 'Authorization: Bearer idl_adv_xxx' \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -H 'Idempotency-Key: ad-2026-11-04' \\\n  -d '{\n    \"campaign_id\": \"CAMPAIGN_UUID\",\n    \"title\": \"Ship the integration\",\n    \"body\": \"Native ads in your AI product.\",\n    \"cta_text\": \"Get started\",\n    \"cta_url\": \"https:\u002F\u002Fexample.com\u002Fsignup\",\n    \"format\": \"inline\"\n  }'\n",[144,1059,1060,1077,1089,1101,1114,1122,1127,1132,1137,1142,1147,1152],{"__ignoreMap":166},[345,1061,1062,1064,1066,1068,1070,1073,1075],{"class":347,"line":348},[345,1063,352],{"class":351},[345,1065,356],{"class":355},[345,1067,359],{"class":355},[345,1069,363],{"class":362},[345,1071,1072],{"class":355},"https:\u002F\u002Ftyfrhxfejrawgdlhryfu.supabase.co\u002Ffunctions\u002Fv1\u002Fadvertiser-api\u002Fads",[345,1074,369],{"class":362},[345,1076,373],{"class":372},[345,1078,1079,1081,1083,1085,1087],{"class":347,"line":376},[345,1080,379],{"class":355},[345,1082,363],{"class":362},[345,1084,384],{"class":355},[345,1086,369],{"class":362},[345,1088,373],{"class":372},[345,1090,1091,1093,1095,1097,1099],{"class":347,"line":391},[345,1092,379],{"class":355},[345,1094,363],{"class":362},[345,1096,157],{"class":355},[345,1098,369],{"class":362},[345,1100,373],{"class":372},[345,1102,1103,1105,1107,1110,1112],{"class":347,"line":404},[345,1104,379],{"class":355},[345,1106,363],{"class":362},[345,1108,1109],{"class":355},"Idempotency-Key: ad-2026-11-04",[345,1111,369],{"class":362},[345,1113,373],{"class":372},[345,1115,1116,1118,1120],{"class":347,"line":418},[345,1117,421],{"class":355},[345,1119,363],{"class":362},[345,1121,426],{"class":355},[345,1123,1124],{"class":347,"line":429},[345,1125,1126],{"class":355},"    \"campaign_id\": \"CAMPAIGN_UUID\",\n",[345,1128,1129],{"class":347,"line":435},[345,1130,1131],{"class":355},"    \"title\": \"Ship the integration\",\n",[345,1133,1134],{"class":347,"line":441},[345,1135,1136],{"class":355},"    \"body\": \"Native ads in your AI product.\",\n",[345,1138,1139],{"class":347,"line":447},[345,1140,1141],{"class":355},"    \"cta_text\": \"Get started\",\n",[345,1143,1144],{"class":347,"line":453},[345,1145,1146],{"class":355},"    \"cta_url\": \"https:\u002F\u002Fexample.com\u002Fsignup\",\n",[345,1148,1149],{"class":347,"line":459},[345,1150,1151],{"class":355},"    \"format\": \"inline\"\n",[345,1153,1154,1156],{"class":347,"line":465},[345,1155,492],{"class":355},[345,1157,495],{"class":362},[141,1159,1160,1161,147,1163,213,1166,1169,1170,1173],{},"The response is ",[144,1162,501],{},[144,1164,1165],{},"{ \"data\": { ...ad } }",[144,1167,1168],{},"format"," and each entry of ",[144,1171,1172],{},"formats"," must be one of the placements listed above.",[1175,1176,1178],"h3",{"id":1177},"moderation","Moderation",[141,1180,1181,1182,1185,1186,147,1188,1185,1191,1194],{},"A new ad is inserted with moderation applied. For a non-staff caller, ",[144,1183,1184],{},"is_approved"," stays ",[144,1187,335],{},[144,1189,1190],{},"is_active",[144,1192,1193],{},"false"," until a person approves it. The ad does not deliver before that.",[141,1196,1197],{},"The site-creative rule can auto-approve on insert when the title, body, button, link, and image match a recent server-generated creative, the image was copied by the extractor, and the link's domain matches the organization website.",[141,1199,1200,1201,1203,1204,1206],{},"Changing the headline, body, button text, link, image, video, or media type sends the ad back to pending (",[144,1202,1184],{}," null, ",[144,1205,1190],{}," false) until it is approved again.",[141,1208,1209,1212,1213,1216],{},[144,1210,1211],{},"PATCH \u002Fads\u002F{id}"," (and ",[144,1214,1215],{},"PATCH \u002Fcreatives\u002F{id}",") updates only the fields you send.",[160,1218,1220],{"className":339,"code":1219,"language":341,"meta":166,"style":166},"curl -X PATCH 'https:\u002F\u002Ftyfrhxfejrawgdlhryfu.supabase.co\u002Ffunctions\u002Fv1\u002Fadvertiser-api\u002Fads\u002FAD_UUID' \\\n  -H 'Authorization: Bearer idl_adv_xxx' \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{ \"title\": \"Updated headline\" }'\n",[144,1221,1222,1239,1251,1263],{"__ignoreMap":166},[345,1223,1224,1226,1228,1230,1232,1235,1237],{"class":347,"line":348},[345,1225,352],{"class":351},[345,1227,356],{"class":355},[345,1229,689],{"class":355},[345,1231,363],{"class":362},[345,1233,1234],{"class":355},"https:\u002F\u002Ftyfrhxfejrawgdlhryfu.supabase.co\u002Ffunctions\u002Fv1\u002Fadvertiser-api\u002Fads\u002FAD_UUID",[345,1236,369],{"class":362},[345,1238,373],{"class":372},[345,1240,1241,1243,1245,1247,1249],{"class":347,"line":376},[345,1242,379],{"class":355},[345,1244,363],{"class":362},[345,1246,384],{"class":355},[345,1248,369],{"class":362},[345,1250,373],{"class":372},[345,1252,1253,1255,1257,1259,1261],{"class":347,"line":391},[345,1254,379],{"class":355},[345,1256,363],{"class":362},[345,1258,157],{"class":355},[345,1260,369],{"class":362},[345,1262,373],{"class":372},[345,1264,1265,1267,1269,1272],{"class":347,"line":404},[345,1266,421],{"class":355},[345,1268,363],{"class":362},[345,1270,1271],{"class":355},"{ \"title\": \"Updated headline\" }",[345,1273,495],{"class":362},[196,1275,1277],{"id":1276},"ad-from-a-url","Ad from a URL",[141,1279,1280,1283],{},[144,1281,1282],{},"POST \u002Fads\u002Ffrom-url"," uses the same landing-page extractor as Ads Manager, stores the proof, then creates the ad. Moderation still applies. This shares the extractor limit of 10 requests per organization per hour.",[160,1285,1287],{"className":339,"code":1286,"language":341,"meta":166,"style":166},"curl -X POST 'https:\u002F\u002Ftyfrhxfejrawgdlhryfu.supabase.co\u002Ffunctions\u002Fv1\u002Fadvertiser-api\u002Fads\u002Ffrom-url' \\\n  -H 'Authorization: Bearer idl_adv_xxx' \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -H 'Idempotency-Key: ad-from-url-1' \\\n  -d '{ \"campaign_id\": \"CAMPAIGN_UUID\", \"url\": \"https:\u002F\u002Fexample.com\" }'\n",[144,1288,1289,1306,1318,1330,1343],{"__ignoreMap":166},[345,1290,1291,1293,1295,1297,1299,1302,1304],{"class":347,"line":348},[345,1292,352],{"class":351},[345,1294,356],{"class":355},[345,1296,359],{"class":355},[345,1298,363],{"class":362},[345,1300,1301],{"class":355},"https:\u002F\u002Ftyfrhxfejrawgdlhryfu.supabase.co\u002Ffunctions\u002Fv1\u002Fadvertiser-api\u002Fads\u002Ffrom-url",[345,1303,369],{"class":362},[345,1305,373],{"class":372},[345,1307,1308,1310,1312,1314,1316],{"class":347,"line":376},[345,1309,379],{"class":355},[345,1311,363],{"class":362},[345,1313,384],{"class":355},[345,1315,369],{"class":362},[345,1317,373],{"class":372},[345,1319,1320,1322,1324,1326,1328],{"class":347,"line":391},[345,1321,379],{"class":355},[345,1323,363],{"class":362},[345,1325,157],{"class":355},[345,1327,369],{"class":362},[345,1329,373],{"class":372},[345,1331,1332,1334,1336,1339,1341],{"class":347,"line":404},[345,1333,379],{"class":355},[345,1335,363],{"class":362},[345,1337,1338],{"class":355},"Idempotency-Key: ad-from-url-1",[345,1340,369],{"class":362},[345,1342,373],{"class":372},[345,1344,1345,1347,1349,1352],{"class":347,"line":418},[345,1346,421],{"class":355},[345,1348,363],{"class":362},[345,1350,1351],{"class":355},"{ \"campaign_id\": \"CAMPAIGN_UUID\", \"url\": \"https:\u002F\u002Fexample.com\" }",[345,1353,495],{"class":362},[141,1355,1356,147,1358,1361,1362,1364,1365,1368,1369,849,1372,213,1375,1378],{},[144,1357,947],{},[144,1359,1360],{},"url"," are required. ",[144,1363,1360],{}," is at most 2048 characters. A page that cannot be read returns ",[144,1366,1367],{},"422",". Over the hourly limit returns ",[144,1370,1371],{},"429",[144,1373,1374],{},"rate_limited",[144,1376,1377],{},"POST \u002Fcreatives\u002Ffrom-url"," is the same call.",[196,1380,1382],{"id":1381},"deposit-checkout","Deposit Checkout",[141,1384,1385,1388],{},[144,1386,1387],{},"POST \u002Fwallet\u002Fcheckout"," returns a Stripe Checkout URL. It does not charge a card. The webhook credits the wallet after payment. The session currency is EUR, matching the wallet. This response has no currency field.",[141,1390,1391,1394,1395,1397,1398,1400],{},[144,1392,1393],{},"amount_cents"," is required, from ",[144,1396,309],{}," (€10) to ",[144,1399,320],{}," (€10,000), excluding tax.",[141,1402,1403,147,1406,1409,1410,288,1413,535,1416,1419],{},[144,1404,1405],{},"success_url",[144,1407,1408],{},"cancel_url"," must be on ",[144,1411,1412],{},"https:\u002F\u002Fadsmanager.idlen.io",[144,1414,1415],{},"https:\u002F\u002Fads.idlen.io",[144,1417,1418],{},"http:\u002F\u002Flocalhost:3002",". Anything else is replaced with the billing page.",[141,1421,1422,1424],{},[144,1423,947],{}," is optional. When that campaign is a non-archived draft in this organization, the deposit is attached to it.",[141,1426,1427],{},"The first-deposit bonus is the same rule as the billing page. The default match is €50 once: pay at least €50 excluding tax and the bonus is €50 of credit. The webhook decides the bonus from the amount paid, excluding tax and after any promotion code.",[160,1429,1431],{"className":339,"code":1430,"language":341,"meta":166,"style":166},"curl -X POST 'https:\u002F\u002Ftyfrhxfejrawgdlhryfu.supabase.co\u002Ffunctions\u002Fv1\u002Fadvertiser-api\u002Fwallet\u002Fcheckout' \\\n  -H 'Authorization: Bearer idl_adv_xxx' \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -H 'Idempotency-Key: deposit-5000' \\\n  -d '{ \"amount_cents\": 5000 }'\n",[144,1432,1433,1450,1462,1474,1487],{"__ignoreMap":166},[345,1434,1435,1437,1439,1441,1443,1446,1448],{"class":347,"line":348},[345,1436,352],{"class":351},[345,1438,356],{"class":355},[345,1440,359],{"class":355},[345,1442,363],{"class":362},[345,1444,1445],{"class":355},"https:\u002F\u002Ftyfrhxfejrawgdlhryfu.supabase.co\u002Ffunctions\u002Fv1\u002Fadvertiser-api\u002Fwallet\u002Fcheckout",[345,1447,369],{"class":362},[345,1449,373],{"class":372},[345,1451,1452,1454,1456,1458,1460],{"class":347,"line":376},[345,1453,379],{"class":355},[345,1455,363],{"class":362},[345,1457,384],{"class":355},[345,1459,369],{"class":362},[345,1461,373],{"class":372},[345,1463,1464,1466,1468,1470,1472],{"class":347,"line":391},[345,1465,379],{"class":355},[345,1467,363],{"class":362},[345,1469,157],{"class":355},[345,1471,369],{"class":362},[345,1473,373],{"class":372},[345,1475,1476,1478,1480,1483,1485],{"class":347,"line":404},[345,1477,379],{"class":355},[345,1479,363],{"class":362},[345,1481,1482],{"class":355},"Idempotency-Key: deposit-5000",[345,1484,369],{"class":362},[345,1486,373],{"class":372},[345,1488,1489,1491,1493,1496],{"class":347,"line":418},[345,1490,421],{"class":355},[345,1492,363],{"class":362},[345,1494,1495],{"class":355},"{ \"amount_cents\": 5000 }",[345,1497,495],{"class":362},[160,1499,1501],{"className":872,"code":1500,"language":874,"meta":166,"style":166},"{\n  \"data\": {\n    \"url\": \"https:\u002F\u002Fcheckout.stripe.com\u002Fc\u002Fpay\u002Fcs_example\",\n    \"session_id\": \"cs_example\"\n  }\n}\n",[144,1502,1503,1507,1520,1539,1557,1561],{"__ignoreMap":166},[345,1504,1505],{"class":347,"line":348},[345,1506,426],{"class":362},[345,1508,1509,1511,1514,1516,1518],{"class":347,"line":376},[345,1510,885],{"class":362},[345,1512,1513],{"class":888},"data",[345,1515,892],{"class":362},[345,1517,895],{"class":362},[345,1519,898],{"class":362},[345,1521,1522,1524,1526,1528,1530,1532,1535,1537],{"class":347,"line":391},[345,1523,903],{"class":362},[345,1525,1360],{"class":351},[345,1527,892],{"class":362},[345,1529,895],{"class":362},[345,1531,912],{"class":362},[345,1533,1534],{"class":355},"https:\u002F\u002Fcheckout.stripe.com\u002Fc\u002Fpay\u002Fcs_example",[345,1536,892],{"class":362},[345,1538,920],{"class":362},[345,1540,1541,1543,1546,1548,1550,1552,1555],{"class":347,"line":404},[345,1542,903],{"class":362},[345,1544,1545],{"class":351},"session_id",[345,1547,892],{"class":362},[345,1549,895],{"class":362},[345,1551,912],{"class":362},[345,1553,1554],{"class":355},"cs_example",[345,1556,979],{"class":362},[345,1558,1559],{"class":347,"line":418},[345,1560,984],{"class":362},[345,1562,1563],{"class":347,"line":429},[345,1564,989],{"class":362},[141,1566,1567,1569,1570,1572,1573,158],{},[144,1568,1360],{}," can be ",[144,1571,335],{}," if Stripe does not return one. An organization with no owner returns ",[144,1574,185],{},[1576,1577,1578],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}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);}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}",{"title":166,"searchDepth":376,"depth":376,"links":1580},[1581,1582,1583,1584,1587,1588],{"id":198,"depth":376,"text":199},{"id":668,"depth":376,"text":669},{"id":837,"depth":376,"text":838},{"id":1015,"depth":376,"text":1016,"children":1585},[1586],{"id":1177,"depth":391,"text":1178},{"id":1276,"depth":376,"text":1277},{"id":1381,"depth":376,"text":1382},"Create and update campaigns and ads, and open a deposit Checkout link","md",null,{},true,{"title":116,"description":1589},"ZO-VEnwaTGNGmYSZdJimANC5hdn1B0Pg33Bhfmt9L5E",[1597,1599],{"title":112,"path":113,"stem":114,"description":1598,"children":-1},"List campaigns, ads, daily stats, the wallet, and transactions",{"title":120,"path":121,"stem":122,"description":1600,"children":-1},"Record a conversion from your server with an advertiser API key",1793804440449]