Reach estimate

The Reach Estimate of a given targeting spec is an approximation of the number of individuals this targeting addresses and what bids should be made to address that target group. The reach estimate of the targeting spec of an existing Ad group may also be queried

Query Result Fields

Name	Description	Permissions	Returns
users	The estimate number of users reached by this targeting	ads_management	long
bid_estimations	An array of bid estimations for this targeting and ad account combination.	ads_management	Array of bid estimations
imp_estimates	An array of impression estimations for this targeting	ads_management	Array of impression estimations

Query the reach estimate of a targeting spec

To query the reach estimate of a targeting spec, pass in the targeting spec as a query-string parameter to the reachestimate connection of the Ad account object:

act_AccountID/reachestimate?currency=USD&targeting_spec=_____

Note that currency and targeting_spec are required for accessing /{account-id}/reachestimate. The returned CPC and CPM values are based on the currency specified. For the list of supported currencies, and the ISO values you can use, see the supported currencies. targeting_spec should include a country code at least.

Note also that imp_estimates is not yet available for most accounts and is still being tested.

Query the reach estimate of an adgroup

To query the reach estimate of an ad group, query the reachestimate connection of the Ad group object:

{adgroup_id}/reachestimate

Below is an example of a response:

{
  "data": {
    "users": 20,
    "bid_estimations": [
      {
        "location": 3,
        "cpc_min": 30,
        "cpc_median": 50,
        "cpc_max": 70,
        "cpm_min": 30,
        "cpm_median": 50,
        "cpm_max": 70
      }
    ],
    "imp_estimates": []
  }
}