Sign inGet Started

Estimate marketing reach for a maximum price

GET
/v1/whatsapp/business-accounts/{business_account_ref}/reach-estimate
bird whatsapp business-accounts reach-estimate <business-account-ref>
प्रतिक्रिया200
{
  "currency_code": "EUR",
  "estimates": [
    {
      "bid_amount": 2590,
      "users": 1000,
      "deliveries_lower_bound": 67,
      "deliveries_upper_bound": 267,
      "cost_lower_bound": 1940.6530830145,
      "cost_upper_bound": 2590
    }
  ]
}

Returns Meta's estimate of how many marketing deliveries, and at what cost, each candidate maximum price would have won over window. Use it to choose a template language's optimization_spec.bid_amount.

Every amount is per 1,000 deliveries, in the smallest unit of currency_code. Estimates come from Meta's recent auctions and are not a guarantee. Bird asks Meta on every request and stores nothing.

Every country must support a maximum price. One that does not fails the whole request with E15090. WhatsApp does not say which country, so estimate the countries one at a time to find it.

पैरामीटर

business_account_refstring

WhatsApp Business Account ID (waa_ prefix) or the WhatsApp Business Account ID Meta reports in waba. A value that parses as a valid ID resolves by ID; any other value resolves as Meta's ID.

Query पैरामीटर

countriesarray

The recipients' countries, as ISO 3166-1 alpha-2 codes. Repeat the parameter for several.

windowstring

The days of recent auctions the estimate is based on, ending now. Omit it to use the last 7 days.

Possible values: 1d, 7d, 14d, 28d

Response Payload

currency_code
string
आवश्यक

The currency of every amount in estimates.

estimates
array of object
आवश्यक

One estimate per candidate bid, in ascending bid order.

चाइल्ड एट्रिब्यूट दिखाएँ
estimates.bid_amount
integer
आवश्यक

The candidate bid, per 1,000 deliveries in the smallest currency unit. It is the unit optimization_spec.bid_amount takes.

estimates.users
integer
आवश्यक

The audience size the estimate is for.

estimates.deliveries_lower_bound
integer
आवश्यक
estimates.deliveries_upper_bound
integer
आवश्यक
estimates.cost_lower_bound
number
आवश्यक

The lower cost estimate, per 1,000 deliveries in the smallest currency unit.

estimates.cost_upper_bound
number
आवश्यक

The upper cost estimate, per 1,000 deliveries in the smallest currency unit.

इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।