Estimation
Estimation
GET /estimate exige le droit read. Il appelle une seule fonction, estimate_budget_delivery. Le site public, Ads Manager et cette API utilisent la même fonction.
curl 'https://tyfrhxfejrawgdlhryfu.supabase.co/functions/v1/advertiser-api/estimate?deposit_cents=5000&billing_model=cpm&apply_first_deposit_bonus=true' \
-H 'Authorization: Bearer idl_adv_xxx'
Passez budget_cents ou deposit_cents. Les montants sont en centimes d'euro. billing_model vaut cpm ou cpc. Omettez bid_cents pour utiliser le prix médian facturé sur la fenêtre. countries et placements sont séparés par des virgules. daily=true traite budget_cents comme un jour.
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.
La réponse est { "data": { ... } }.
| Champ | Sens |
|---|---|
status | ok ou not_enough_data |
reason | Pourquoi la fourchette est vide ou retenue. too_few_wins : l'enchère gagne trop peu du marché observé. budget_below_one_unit : le crédit ne couvre pas une unité facturée. |
window_start, window_end, window_days | La fenêtre de livraison. La durée est platform_settings.budget_estimate.windowDays (28 par défaut). |
credit_cents | Ce que l'estimation dépense, bonus compris quand il s'applique |
impressions, clicks | { "low", "high" }, ou null |
clicks_status | not_enough_data quand il n'y a pas assez de clics pour publier une fourchette de clics |
win_share | 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. |
market_ecpm_cents | 25e et 75e percentiles des prix facturés, en centimes d'eCPM |
method | Le calcul, en un paragraphe |
Comment la fourchette est calculée
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 (editor).
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é (clics + 1) / (impressions + 50), le même a priori que serve_ad_v2_paid et serve_chat_ad_core.
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.
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 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é.
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.
Pas assez de données
Si la tranche a moins d'impressions ou d'enchères tarifées que minImpressions et minPriceObservations, status vaut not_enough_data. Les comptes sont omis. Il en va de même pour les clics sous minClicks : la fourchette d'impressions peut rester, et clicks est null.
Le résultat est un agrégat de la plateforme. Il ne contient pas les campagnes, annonces ou enchères d'un autre annonceur.
Une enchère, un pays ou un montant invalide donne HTTP 400 avec invalid_request. not_enough_data est HTTP 200.
L'outil MCP est estimate_budget. Il envoie cette route.