Graph API Version

Ad Campaign Delivery Estimate

Reading

The delivery estimates for a given ad set configuration.

Example

Graph API Explorer
GET v5.0/...?fields={fieldname_of_type_AdCampaignDeliveryEstimate} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '...?fields={fieldname_of_type_AdCampaignDeliveryEstimate}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "...?fields={fieldname_of_type_AdCampaignDeliveryEstimate}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "...?fields={fieldname_of_type_AdCampaignDeliveryEstimate}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"...?fields={fieldname_of_type_AdCampaignDeliveryEstimate}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
If you want to learn how to use the Graph API, read our Using Graph API guide.

Parameters

This endpoint doesn't have any parameters.

Fields

FieldDescription
daily_outcomes_curve
list<OutcomePredictionPoint>

The predicted daily reach and actions (if applicable) for the ad set configuration. This is a vector of points with strictly increasing spend. A given point in the vector is what we predict the outcomes of the ad set will be if the ad set spends the amount in the point. This is the value of daily estimates and budget curves in our interfaces. This field will only have data when we are able to provide high confidence predictions. When we do not have high confidence predictions we will return an array of 1 point with all 0s.

estimate_dau
integer

The estimated number of people that have been active on your selected platforms and satisfy your targeting spec in the past day

estimate_mau
integer

The estimated number of people that have been active on your selected platforms and satisfy your targeting spec in the past month

estimate_ready
bool

Whether or not an estimate is ready for the audience. Some audiences require time to populate before we can provide a delivery estimate

Creating

You can't perform this operation on this endpoint.

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.