[{"data":1,"prerenderedAt":506},["ShallowReactive",2],{"navigation_docs_fr":3,"-fr-advertiser-api-estimate":135,"-fr-advertiser-api-estimate-surround":501},[4,18,47,60,69,102,131],{"title":5,"path":6,"stem":7,"children":8,"page":17},"Getting Started","\u002Ffr\u002Fgetting-started","fr\u002F1.getting-started",[9,13],{"title":10,"path":11,"stem":12},"Installation","\u002Ffr\u002Fgetting-started\u002Finstallation","fr\u002F1.getting-started\u002F1.installation",{"title":14,"path":15,"stem":16},"Configuration","\u002Ffr\u002Fgetting-started\u002Fconfiguration","fr\u002F1.getting-started\u002F2.configuration",false,{"title":19,"path":20,"stem":21,"children":22,"page":17},"Features","\u002Ffr\u002Ffeatures","fr\u002F2.features",[23,27,31,35,39,43],{"title":24,"path":25,"stem":26},"Suivi des Pages Vues","\u002Ffr\u002Ffeatures\u002Fpageview-tracking","fr\u002F2.features\u002F1.pageview-tracking",{"title":28,"path":29,"stem":30},"Suivi des Conversions","\u002Ffr\u002Ffeatures\u002Fconversion-tracking","fr\u002F2.features\u002F2.conversion-tracking",{"title":32,"path":33,"stem":34},"Support SPA","\u002Ffr\u002Ffeatures\u002Fspa-support","fr\u002F2.features\u002F3.spa-support",{"title":36,"path":37,"stem":38},"React & Next.js","\u002Ffr\u002Ffeatures\u002Freact-integration","fr\u002F2.features\u002F4.react-integration",{"title":40,"path":41,"stem":42},"Vue & Nuxt","\u002Ffr\u002Ffeatures\u002Fvue-integration","fr\u002F2.features\u002F5.vue-integration",{"title":44,"path":45,"stem":46},"Google Tag Manager","\u002Ffr\u002Ffeatures\u002Fgtm-integration","fr\u002F2.features\u002F6.gtm-integration",{"title":48,"path":49,"stem":50,"children":51,"page":17},"Api","\u002Ffr\u002Fapi","fr\u002F3.api",[52,56],{"title":53,"path":54,"stem":55},"Référence API","\u002Ffr\u002Fapi\u002Freference","fr\u002F3.api\u002F1.reference",{"title":57,"path":58,"stem":59},"Référence des Événements","\u002Ffr\u002Fapi\u002Fevents-reference","fr\u002F3.api\u002F2.events-reference",{"title":61,"path":62,"stem":63,"children":64,"page":17},"Privacy","\u002Ffr\u002Fprivacy","fr\u002F4.privacy",[65],{"title":66,"path":67,"stem":68},"Collecte de Données & Vie Privée","\u002Ffr\u002Fprivacy\u002Fdata-collection","fr\u002F4.privacy\u002F1.data-collection",{"title":70,"path":71,"stem":72,"children":73,"page":17},"Chat SDK","\u002Ffr\u002Fchat-sdk","fr\u002F5.chat-sdk",[74,78,82,86,90,94,98],{"title":75,"path":76,"stem":77},"Chat SDK - Démarrage","\u002Ffr\u002Fchat-sdk\u002Fgetting-started","fr\u002F5.chat-sdk\u002F1.getting-started",{"title":79,"path":80,"stem":81},"Intégration Vue hors chat","\u002Ffr\u002Fchat-sdk\u002Fvue-non-chat","fr\u002F5.chat-sdk\u002F2.vue-non-chat",{"title":83,"path":84,"stem":85},"Intégration React","\u002Ffr\u002Fchat-sdk\u002Freact-integration","fr\u002F5.chat-sdk\u002F3.react-integration",{"title":87,"path":88,"stem":89},"Middleware AI SDK","\u002Ffr\u002Fchat-sdk\u002Fai-sdk-middleware","fr\u002F5.chat-sdk\u002F4.ai-sdk-middleware",{"title":91,"path":92,"stem":93},"Formats d'annonces","\u002Ffr\u002Fchat-sdk\u002Fad-formats","fr\u002F5.chat-sdk\u002F5.ad-formats",{"title":95,"path":96,"stem":97},"Tracking et attribution","\u002Ffr\u002Fchat-sdk\u002Ftracking-and-attribution","fr\u002F5.chat-sdk\u002F6.tracking-and-attribution",{"title":99,"path":100,"stem":101},"Dépannage","\u002Ffr\u002Fchat-sdk\u002Ftroubleshooting","fr\u002F5.chat-sdk\u002F7.troubleshooting",{"title":103,"path":104,"stem":105,"children":106,"page":17},"API annonceurs","\u002Ffr\u002Fadvertiser-api","fr\u002F6.advertiser-api",[107,111,115,119,123,127],{"title":108,"path":109,"stem":110},"Vue d'ensemble","\u002Ffr\u002Fadvertiser-api\u002Foverview","fr\u002F6.advertiser-api\u002F1.overview",{"title":112,"path":113,"stem":114},"Lecture","\u002Ffr\u002Fadvertiser-api\u002Fread","fr\u002F6.advertiser-api\u002F2.read",{"title":116,"path":117,"stem":118},"Écriture","\u002Ffr\u002Fadvertiser-api\u002Fwrite","fr\u002F6.advertiser-api\u002F3.write",{"title":120,"path":121,"stem":122},"API conversions","\u002Ffr\u002Fadvertiser-api\u002Fconversions","fr\u002F6.advertiser-api\u002F4.conversions",{"title":124,"path":125,"stem":126},"Serveur MCP","\u002Ffr\u002Fadvertiser-api\u002Fmcp","fr\u002F6.advertiser-api\u002F5.mcp",{"title":128,"path":129,"stem":130},"Estimation","\u002Ffr\u002Fadvertiser-api\u002Festimate","fr\u002F6.advertiser-api\u002F6.estimate",{"title":132,"path":133,"stem":134},"Commencer ici","\u002Ffr\u002Fstart-here","fr\u002Fstart-here",{"id":136,"title":128,"body":137,"description":494,"extension":495,"links":496,"meta":497,"navigation":498,"path":129,"seo":499,"stem":130,"__hash__":500},"docs_fr\u002Ffr\u002F6.advertiser-api\u002F6.estimate.md",{"type":138,"value":139,"toc":490},"minimark",[140,144,160,207,248,254,261,403,408,415,428,431,438,441,445,466,469,479,486],[141,142,128],"h1",{"id":143},"estimation",[145,146,147,151,152,155,156,159],"p",{},[148,149,150],"code",{},"GET \u002Festimate"," exige le droit ",[148,153,154],{},"read",". Il appelle une seule fonction, ",[148,157,158],{},"estimate_budget_delivery",". Le site public, Ads Manager et cette API utilisent la même fonction.",[161,162,167],"pre",{"className":163,"code":164,"language":165,"meta":166,"style":166},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl 'https:\u002F\u002Ftyfrhxfejrawgdlhryfu.supabase.co\u002Ffunctions\u002Fv1\u002Fadvertiser-api\u002Festimate?deposit_cents=5000&billing_model=cpm&apply_first_deposit_bonus=true' \\\n  -H 'Authorization: Bearer idl_adv_xxx'\n","bash","",[148,168,169,193],{"__ignoreMap":166},[170,171,174,178,182,186,189],"span",{"class":172,"line":173},"line",1,[170,175,177],{"class":176},"sBMFI","curl",[170,179,181],{"class":180},"sMK4o"," '",[170,183,185],{"class":184},"sfazB","https:\u002F\u002Ftyfrhxfejrawgdlhryfu.supabase.co\u002Ffunctions\u002Fv1\u002Fadvertiser-api\u002Festimate?deposit_cents=5000&billing_model=cpm&apply_first_deposit_bonus=true",[170,187,188],{"class":180},"'",[170,190,192],{"class":191},"sTEyZ"," \\\n",[170,194,196,199,201,204],{"class":172,"line":195},2,[170,197,198],{"class":184},"  -H",[170,200,181],{"class":180},[170,202,203],{"class":184},"Authorization: Bearer idl_adv_xxx",[170,205,206],{"class":180},"'\n",[145,208,209,210,213,214,217,218,221,222,213,225,228,229,232,233,236,237,240,241,244,245,247],{},"Passez ",[148,211,212],{},"budget_cents"," ou ",[148,215,216],{},"deposit_cents",". Les montants sont en centimes d'euro. ",[148,219,220],{},"billing_model"," vaut ",[148,223,224],{},"cpm",[148,226,227],{},"cpc",". Omettez ",[148,230,231],{},"bid_cents"," pour utiliser le prix médian facturé sur la fenêtre. ",[148,234,235],{},"countries"," et ",[148,238,239],{},"placements"," sont séparés par des virgules. ",[148,242,243],{},"daily=true"," traite ",[148,246,212],{}," comme un jour.",[145,249,250,253],{},[148,251,252],{},"apply_first_deposit_bonus=true"," ajoute le bonus de premier dépôt configuré quand le dépôt y a droit. Un premier dépôt de 50 € est estimé comme 100 € de crédit.",[145,255,256,257,260],{},"La réponse est ",[148,258,259],{},"{ \"data\": { ... } }",".",[262,263,264,277],"table",{},[265,266,267],"thead",{},[268,269,270,274],"tr",{},[271,272,273],"th",{},"Champ",[271,275,276],{},"Sens",[278,279,280,296,314,335,345,361,373,383,393],"tbody",{},[268,281,282,288],{},[283,284,285],"td",{},[148,286,287],{},"status",[283,289,290,213,293],{},[148,291,292],{},"ok",[148,294,295],{},"not_enough_data",[268,297,298,303],{},[283,299,300],{},[148,301,302],{},"reason",[283,304,305,306,309,310,313],{},"Pourquoi la fourchette est vide ou retenue. ",[148,307,308],{},"too_few_wins"," : l'enchère gagne trop peu du marché observé. ",[148,311,312],{},"budget_below_one_unit"," : le crédit ne couvre pas une unité facturée.",[268,315,316,328],{},[283,317,318,321,322,321,325],{},[148,319,320],{},"window_start",", ",[148,323,324],{},"window_end",[148,326,327],{},"window_days",[283,329,330,331,334],{},"La fenêtre de livraison. La durée est ",[148,332,333],{},"platform_settings.budget_estimate.windowDays"," (28 par défaut).",[268,336,337,342],{},[283,338,339],{},[148,340,341],{},"credit_cents",[283,343,344],{},"Ce que l'estimation dépense, bonus compris quand il s'applique",[268,346,347,355],{},[283,348,349,321,352],{},[148,350,351],{},"impressions",[148,353,354],{},"clicks",[283,356,357,360],{},[148,358,359],{},"{ \"low\", \"high\" }",", ou null",[268,362,363,368],{},[283,364,365],{},[148,366,367],{},"clicks_status",[283,369,370,372],{},[148,371,295],{}," quand il n'y a pas assez de clics pour publier une fourchette de clics",[268,374,375,380],{},[283,376,377],{},[148,378,379],{},"win_share",[283,381,382],{},"Part des enchères tarifées de la fenêtre sous l'eCPM de cette enchère. Absente quand cette part est trop petite pour être publiée.",[268,384,385,390],{},[283,386,387],{},[148,388,389],{},"market_ecpm_cents",[283,391,392],{},"25e et 75e percentiles des prix facturés, en centimes d'eCPM",[268,394,395,400],{},[283,396,397],{},[148,398,399],{},"method",[283,401,402],{},"Le calcul, en un paragraphe",[404,405,407],"h2",{"id":406},"comment-la-fourchette-est-calculée","Comment la fourchette est calculée",[145,409,410,411,414],{},"L'inventaire est les impressions livrées sur la fenêtre, pour les pays et les emplacements demandés. Un emplacement correspond à un emplacement d'ensemble d'annonces, à un format, ou à la surface enregistrée sur l'impression (",[148,412,413],{},"editor",").",[145,416,417,418,421,422,236,425,260],{},"Une enchère gagne la part de ces ventes dont le prix facturé, converti en eCPM, est sous l'enchère. L'eCPM CPM est l'enchère en centimes pour 1 000 impressions. L'eCPM CPC est l'enchère fois le CTR lissé ",[148,419,420],{},"(clics + 1) \u002F (impressions + 50)",", le même a priori que ",[148,423,424],{},"serve_ad_v2_paid",[148,426,427],{},"serve_chat_ad_core",[145,429,430],{},"Les prix facturés viennent des impressions CPM facturées, des clics CPC, et des prix de clôture d'enchère quand une ligne de journal est liée à l'impression. Le prix que cette enchère paierait est le 25e au 75e percentile des ventes qu'elle gagnerait, plafonné à l'enchère. Les impressions CPM sont facturées en centimes entiers, au moins 1 centime, comme à l'enregistrement d'une impression.",[145,432,433,434,437],{},"Le crédit ne peut pas acheter plus que l'inventaire que cette enchère aurait gagné sur l'horizon. Un budget quotidien utilise un jour de cet inventaire. Le bas de la fourchette est réduit de ",[148,435,436],{},"safetyMargin"," (0,2 par défaut). Quand il y a assez de clics, les bornes de clics utilisent aussi un intervalle de Wilson à 80 % du CTR observé.",[145,439,440],{},"Les requêtes chat sans annonce ne comptent en inventaire supplémentaire que si ce volume non servi dépasse lui-même le minimum.",[404,442,444],{"id":443},"pas-assez-de-données","Pas assez de données",[145,446,447,448,236,451,321,454,221,456,458,459,462,463,465],{},"Si la tranche a moins d'impressions ou d'enchères tarifées que ",[148,449,450],{},"minImpressions",[148,452,453],{},"minPriceObservations",[148,455,287],{},[148,457,295],{},". Les comptes sont omis. Il en va de même pour les clics sous ",[148,460,461],{},"minClicks"," : la fourchette d'impressions peut rester, et ",[148,464,354],{}," est null.",[145,467,468],{},"Le résultat est un agrégat de la plateforme. Il ne contient pas les campagnes, annonces ou enchères d'un autre annonceur.",[145,470,471,472,475,476,478],{},"Une enchère, un pays ou un montant invalide donne HTTP 400 avec ",[148,473,474],{},"invalid_request",". ",[148,477,295],{}," est HTTP 200.",[145,480,481,482,485],{},"L'outil MCP est ",[148,483,484],{},"estimate_budget",". Il envoie cette route.",[487,488,489],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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);}",{"title":166,"searchDepth":195,"depth":195,"links":491},[492,493],{"id":406,"depth":195,"text":407},{"id":443,"depth":195,"text":444},"Estimer les impressions et les clics à partir de la livraison récente","md",null,{},true,{"title":128,"description":494},"HKrVqZix6hmZ6dshiFnjdINMdCIFmdt_NENwxeYp2WY",[502,504],{"title":124,"path":125,"stem":126,"description":503,"children":-1},"Serveur MCP Streamable HTTP de l'API annonceurs, avec 15 outils",{"title":132,"path":133,"stem":134,"description":505,"children":-1},"Choisissez le bon parcours de documentation pour votre intégration",1793864622635]