Get delivery estimate (adsap_get_delivery_estimate)
Platform: Meta · Read or write: Read · Plan: All plans · Consumes a task: No · Preview supported: No
What it does
Asks Meta for a delivery estimate for a proposed audience and optimization goal. It returns estimated daily reach, outcome ranges, and an audience size label on a five-step scale from too narrow to broadest. Add a daily budget to make the estimate budget-constrained. Use it to sanity-check targeting before you build an ad set.
Parameters
Descriptions are shortened from the tool schema. Your assistant sees the full text.
| Name | Type | Required | Description |
|---|---|---|---|
ad_account_id | string | Yes | Must include act_ prefix. |
targeting_spec | object | Yes | Targeting specification. Must include at least countries. |
targeting_spec.countries | array of string | Yes | ISO 3166-1 alpha-2 codes (e.g. [‘FR’, ‘DE’]). |
targeting_spec.age_min | number | No | |
targeting_spec.age_max | number | No | |
targeting_spec.genders | array of number | No | [0]=all, [1]=male, [2]=female. |
targeting_spec.interests | array of object | No | |
targeting_spec.behaviors | array of object | No | |
targeting_spec.locales | array of number | No | |
optimization_goal | one of OFFSITE_CONVERSIONS, LINK_CLICKS, IMPRESSIONS, REACH, LANDING_PAGE_VIEWS, LEAD_GENERATION, VALUE, APP_INSTALLS | Yes | Optimization goal for the estimate. |
daily_budget | number | No | Daily budget in cents. If provided, estimates are budget-constrained. |
promoted_object | object | No | Required for conversion goals. E.g. { pixel_id: ‘123’, custom_event_type: ‘Purchase’ }. |
promoted_object.pixel_id | string | No | |
promoted_object.custom_event_type | string | No | |
promoted_object.page_id | string | No | |
promoted_object.application_id | string | No | |
promoted_object.object_store_url | string | No |
Example prompts
- “How many people could I reach per day targeting women 25 to 44 in France, optimizing for purchases?”
- “Is an audience of US yoga interests too narrow for a lead campaign?”
- “Estimate reach for this targeting with 50 euros a day.”
Notes
Conversion goals need a promoted object, such as a pixel and an event. The targeting must include at least one country.
Related tools
adsap_search_behaviors: Search Meta behavior targeting by keyword/category.adsap_search_geo_locations: Search Meta city/region location keys for targeting.adsap_search_interests: Search Meta interest targeting by keyword.
Guide
Read Audiences and targeting for the workflow around this tool, and the Tool reference for every tool.
Last updated on