Opportunity Score and Recommendations

Updated: Aug 27, 2026

Copy for LLM

Ads in WhatsApp Status are available via the Marketing API. Learn more about ads in WhatsApp Status.

Diagram of the Opportunity score card with callouts labeling 'Your score' and 'Your recommendations'

Opportunity score⁠ and recommendations⁠ enable advertisers to discover and implement best practices that can optimize their ad campaigns with Meta. This guide will help you understand the components of opportunity score and how to integrate them with your application.

Opportunity score is a tool for understanding how well-optimized an ad account is for achieving optimal performance and generates recommendations that could improve performance. It consists of two parts:

Your opportunity score (range: 0–100) — Reflects how optimized your ad account is. A higher score indicates better optimality and a greater likelihood of improved performance over time.
- Opportunity score is provided as a field of an ad account.
- Opportunity score is updated in near real-time in response to campaign changes and the application of available recommendations.
Recommendations — Experimentally-proven best practices that are personalized to each ad account. They may relate to your campaigns, ad sets, or ads, and have been rigorously tested to show they can deliver statistically significant performance improvements.*
- Implementing recommendations will improve setup and increase opportunity score.
- Recommendations have assigned point values based on how much each is expected to improve your campaign performance.*
- You may see recommendations related to a variety of categories including campaign objectives and goals, audience, automation, creative, and placements, budget, and bidding, or signals.

Ads Manager Account Overview showing a 71-point Opportunity score and a fragmentation recommendation card

* Note: Meta is frequently testing new types of recommendations on the Ads Manager Web UI. Under certain circumstances, there could be fewer recommendations returned by the API versus what is shown in Ads Manager.

By applying performance recommendations from Meta, you agree to the Facebook Terms of Service⁠ including your obligation to comply with the Self-serve ad terms⁠, the Commercial terms⁠, and the Facebook Advertising Policies⁠.

Supported inventory and APIs

Fetching recommendations

To fetch all the recommendations available for your ad account, make a GET request to the /act_<AD_ACCOUNT_ID>/recommendations endpoint where <AD_ACCOUNT_ID> is the ID for your Meta ad account. Alternatively, you can fetch all the recommendations available for ad accounts across your business portfolio by replacing act_<AD_ACCOUNT_ID> with <BUSINESS_ID>.

Example ad account request

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v26.0/act_<AD_ACCOUNT_ID>/recommendations

Ad Account request parameters

Optional query parameters for the Ad Account request.

Name	Description
`recommendation_stages` list<string>	Optional. Filter by recommendation lifecycle stage. Supported values include `mfr` and `pcr`.
`recommendation_names` list<string>	Optional. Filter to specific recommendation names in lowercase snake case, such as `fragmentation` and `aplusc_standard_enhancements_bundle`.

Example ad account response

On success, your app receives a list of recommendations that Meta has generated. If this list is empty, Meta has not identified any changes that can be made to increase the ad performance in your ad account.

{
  "data": [
    {
      "recommendations": [
       {
         "recommendation_signature": "1234567",
         "recommendation_stage": "mid_flight_recommendation",
         "recommendation_time": "2026-04-02T23:12:34+0000",
         "type": "MUSIC",
         "object_ids": ["7656787679008", "2345678765423", ...],
         "recommendation_content": {
          "lift_estimate": "Up to 3% more Traffic",
          "body": "2 of your ad sets have similar objectives and creatives..",
          "opportunity_score_lift": "14"
        },
         "url": "https://adsmanager.facebook.com/adsmanager/...."
      }
    ],
   }
  ]
  ...
}

Example business portfolio request

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v26.0/<BUSINESS_ID>/recommendations

Business portfolio request parameters

Optional query parameters for the business portfolio request.

Name	Description
`ad_account_ids` list<numeric string>	Optional. Comma-separated ad account IDs without the `act_` prefix, restricting the response to a subset of the Business's owned or shared ad accounts. Maximum 100 per request. When supplied, pagination is disabled and all matching accounts are returned.
`scopes` list<string>	Optional. Specifies the relationship between the business and the ad accounts to return recommendations for. Supported values include `owned` (ad accounts owned by the business, the default value) and `shared` (ad accounts not owned by the business but shared with it). Should not be set when `ad_account_ids` is passed explicitly.
`recommendation_stages` list<string>	Optional. Filter by recommendation lifecycle stage. Supported values include `mid_flight_recommendation` and `pre_create_guidance`.
`recommendation_names` list<string>	Optional. Filter to specific recommendation names in lowercase snake case, such as `fragmentation` and `aplusc_standard_enhancements_bundle`.
`locale` string	Optional. Locale for human-readable strings inside `recommendation_content`, such as `en_US`. Defaults to the viewer's locale.
`fields` list<string>	Optional. API field expansion. Use `recommendation_content` to include the `lift_estimate` and `body` strings, which are omitted by default.
`limit` integer	Optional. Page size for ad-account-level cursor pagination. Default `25`, maximum `100`. Ignored when `ad_account_ids` is supplied.
`after` / `before` cursor string	Optional. Cursors returned in `paging.cursors` on the previous response.

* Note: There are a few limitations for a Business ID:

Returns recommendations only for ad accounts owned or shared by the Business ID.
Pagination is at the business account level, with a maximum of 100 ad accounts per page. Supplying ad_account_ids disables pagination, with a maximum of 100 IDs per request.

Example business portfolio response

{
  "data": [
    {
      "ad_account_id": "1234567890",
      "opportunity_score": 78,
      "recommendations": [
        {
          "recommendation_name": "reels_pc_recommendation",
          "recommendation_stage": "mid_flight_recommendation",
          "level": "ad_set",
          "object_ids": ["9876543210"],
          "recommendation_signature": "7720466",
          "recommendation_time": "2026-05-15T08:32:11+0000",
          "opportunity_score_lift": "26",
          "url": "https://adsmanager.facebook.com/adsmanager...",
          "recommendation_content": {
            "lift_estimate": "Up to 8% lower cost per result",
            "body": "Using full-screen 9:16 video..."
          }
        }
      ]
    }
  ],
  "paging": {
    "cursors": {
      "before": "...",
      "after": "..."
    },
    "next": "https://graph.facebook.com/...",
    "previous": "https://graph.facebook.com/..."
  }
}

Fields

Ad-account-level fields

Name	Description
`ad_account_id`	Available on Business-level requests only. The ad account ID that the recommendations apply to.
`opportunity_score`	Available on Business-level requests only. Current opportunity score from 0 to 100. Omitted if no score is available.
`recommendations`	List of recommendations for the ad account.

Recommendation-level fields

Name	Description
`recommendation_signature`	Unique identifier for this recommendation. Required to refer to this recommendation in the recommendation application API. Recommendations are refreshed periodically. A `recommendation_signature` may become invalid if the recommendation is no longer applicable. For recommendations that cannot be resolved in the API, this value will not be returned.
`recommendation_stage`	The stage for this recommendation. The stage provides information on the step of the lifecycle of a recommendation. The list of recommendations: pre_create_guidance - Account-level recommendations that surface opportunities for creating new campaigns. These appear before entering a creation or editing flow. pre_flight_recommendation - Recommendations provided during the ad creation or editing flow, on draft objects. These help optimize campaign, ad set, or ad configuration before publishing. mid_flight_recommendation - Recommendations for active, running ad objects. These identify optimization opportunities or issues with published campaigns, ad sets, or ads.
`recommendation_time`	The timestamp in ISO 8601 of when the recommendation is created. Generally, recommendations have an expiration time. Stale or old recommendations cannot be applied and will fail during apply.
`recommendation_name`	Available on Business-level requests only. Recommendation name, such as `fragmentation`.
`type`	Available on Ad Account requests only. Enum value denoting what type of recommendation this is. Description of what each possible value means and what applying them entails is provided in the Applying recommendations section below.
`level`	Available on Business-level requests only. Object level: `ad`, `ad_set`, `campaign`, or `ad_account`.
`object_ids`	List of ads objects that pertain to this recommendation. May be a campaign, ad set, or ad.
`lift_estimate`	Describes the estimated performance improvement that could be seen in accepting a given recommendation.
`body`	This is a description of the recommendation similar to the descriptions listed in the Performance recommendation types section below.
`opportunity_score_lift`	This is the lift in opportunity score (number of points) that would be expected from applying this recommendation.
`url`	This is the URL that links directly to the user flow in Ads Manager to apply the recommendation.

Applying recommendations

There are three options for MAPI powered apps to enable users to apply recommendations for improving opportunity scores. Which option is right for your application will depend on the experience you want to deliver to your user.

Option 1: Apply via Deep Link URL to Ads Manager

Each recommendation includes a URL to Ads Manager where your user can review and apply changes directly. This is the simplest path and is ideal for apps that do not traditionally perform campaign management functions such as reporting focused solutions like dashboards.

Option 2: Apply via API

For recommendations that support it, use the POST /act_<AD_ACCOUNT_ID>/recommendations endpoint to apply changes directly to the ad account. This is ideal for apps that already support campaign management functionality and want to provide a one-click apply experience such as toggling Advantage+ settings for a set of campaigns.

Option 3: Apply via custom workflow using campaign management APIs

Use the ad object IDs returned with each recommendation to build a custom workflow to draft the changes to be made and use standard Campaign, Ad Set, and Ad APIs to POST the changes. This is ideal for apps that already perform campaign management functions where users expect granular control to draft, review, and publish changes. An example of this is launching a native budget reallocation workflow for determining the precise budget adjustments to make.

Apply via API details

To apply a recommendation for your ad account, make a POST request to the /act_<AD_ACCOUNT_ID>/recommendations endpoint where <AD_ACCOUNT_ID> is the ID for your Meta ad account.

Note: All requests require a recommendation_signature field which is obtained from the recommendation object.

Example request

curl -X POST \
  -d 'access_token=<ACCESS_TOKEN>' \
  -d 'recommendation_signature="1234567"' \
  -d 'extra_data={"object_selection": "7656787679008"}' \
https://graph.facebook.com/v26.0/act_<AD_ACCOUNT_ID>/recommendations

Example response

On success, your app receives a Boolean value denoting whether the recommendation was successfully applied. If it was not successfully applied, your ad objects will remain unchanged.

{
  "success": true
}

Recommendation-specific parameters

The following sections document the input parameters for applying various recommendation types via the Graph API. Parameters are passed in the extra_data object.

ADVANTAGE_PLUS_AUDIENCE

This recommendation enables Advantage+ Audience targeting on your ad sets, allowing Meta’s AI to automatically find the best audiences for your ads beyond your initial targeting settings to improve performance.

All ad set IDs are derived from the recommendation target. No input parameters required.

{
  "recommendation_signature": "12345",
  "extra_data": {}
}

APLUSC_STANDARD_ENHANCEMENTS_BUNDLE

This recommendation suggests enabling Advantage+ Creative Standard Enhancements on ads to automatically optimize ad creatives. Standard Enhancements uses machine learning to dynamically adjust creative elements for better performance.

Parameter	Type	Description
`object_selection`	string (optional)	Comma-separated list of ad IDs to enable Standard Enhancements on. If not provided, defaults to all ad IDs from the recommendation target. Maximum: Must not exceed the number of recommended ad IDs.
`creative_feature_opt_in_overrides`	string (optional)	JSON array of creative feature opt-in overrides for specific ads. Each object contains: ad_id: string - The ad ID opted_in_creative_feature_names: array< string > - List of creative feature names to opt in. Possible values include: image_templates, image_touchups, text_optimizations, video_auto_crop, video_uncrop, standard_enhancements. Note: standard_enhancements must be included alongside any other feature.

{
  "recommendation_signature": "12345",
  "extra_data": {
    "object_selection": "123456789",
    "creative_feature_opt_in_overrides": "[{\"ad_id\": \"123456789\", \"opted_in_creative_feature_names\": [\"standard_enhancements\"]}]"
  }
}

AUTOFLOW_OPT_IN

This recommendation suggests enabling Autoflow creative features on ads to automatically optimize ad creatives. Autoflow uses machine learning to dynamically adjust creative elements for better performance.

Parameter	Type	Description
`object_selection`	string (optional)	Comma-separated list of ad IDs to enable Autoflow creative features on. If not provided, defaults to all ad IDs from the recommendation target.

{
  "recommendation_signature": "12345",
  "extra_data": {
    "object_selection": "123456789,987654321,456789123"
  }
}

AUTOMATIC_PLACEMENTS

This recommendation enables Advantage+ Placements (automatic placements) on your ad sets, allowing Meta to automatically show your ads across all available placements (Facebook, Instagram, Messenger, Audience Network) to maximize performance.

All ad set IDs are derived from the recommendation target. No input parameters required.

{
  "recommendation_signature": "12345",
  "extra_data": {}
}

BACKGROUND_GENERATION

This recommendation enables AI-powered background generation for your ad creatives. When enabled, Meta’s generative AI will automatically create contextual backgrounds for your product images to improve visual appeal and ad performance.

Parameter	Type	Description
`action_type`	string (required)	The action to perform on the creative feature. Valid values: “OPT_IN”, “OPT_OUT”
`object_selection`	string (required)	Comma-separated list of ad IDs to apply the background generation feature to.

{
  "recommendation_signature": "12345",
  "extra_data": {
    "action_type": "OPT_IN",
    "object_selection": "123456789,987654321"
  }
}

CONVERSION_LEADS_OPTIMIZATION

This recommendation helps improve the quality of leads generated by your campaigns. When applied, it duplicates your existing ad sets and ads with an optimized goal focused on finding higher-quality leads that are more likely to convert.

All ad set IDs are derived from the recommendation target. No input parameters required.

{
  "recommendation_signature": "12345",
  "extra_data": {}
}

CREATIVE_FATIGUE

This recommendation helps refresh ads that are showing signs of creative fatigue, where audiences have seen the same creative too many times and engagement is declining. When applied, it uses generative AI to create new creative variations for your ads.

Parameter	Type	Description
`object_selection`	string (optional)	Comma-separated list of ad IDs to refresh with new generative AI creative variations. If not provided, defaults to all ad IDs from the recommendation target.

{
  "recommendation_signature": "12345",
  "extra_data": {
    "object_selection": "123456789,987654321"
  }
}

LANDING_PAGE_VIEW_OPTIMIZATION_GOAL

This recommendation changes your ad set’s optimization goal to Landing Page Views. Instead of optimizing for link clicks, your ads will be shown to people more likely to wait for your website to load, resulting in higher-quality traffic.

All adset IDs are derived from the recommendation target. No input parameters required.

{
  "recommendation_signature": "12345",
  "extra_data": {}
}

MUSIC

This recommendation adds music and audio features to your ads to make them more engaging. Music can help capture attention and improve ad recall, especially in Reels and Stories placements.

Parameter	Type	Description
`object_selection`	string (optional)	Comma-separated list of ad IDs to enable music audio features on. If not provided, defaults to all ad IDs from the recommendation target.

{
  "recommendation_signature": "12345",
  "extra_data": {
    "object_selection": "123456789,987654321,456789123"
  }
}

PERFORMANT_CREATIVE_REELS_OPT_IN

This recommendation adds Facebook Reels and Instagram Reels placements to your ad sets to reach more people through short-form video content. Reels placements can help you connect with audiences who consume vertical, full-screen video content.

Parameter	Type	Description
`object_selection`	string (optional)	Comma-separated list of ad set IDs to add Reels placements to. Skips ad sets with automatic placements enabled. If not provided, defaults to all ad set IDs from the recommendation target.

{
  "recommendation_signature": "12345",
  "extra_data": {
    "object_selection": "123456789,987654321"
  }
}

PRODUCT_SET_BOOSTING

This recommendation enables Product Set Expansion for your catalog ads. When enabled, your ads can show products from your broader catalog beyond your specified product set, helping reach more potential customers with relevant products they’re likely to be interested in.

All ad IDs are derived from the recommendation target. No input parameters required.

{
  "recommendation_signature": "12345",
  "extra_data": {}
}

SCALE_GOOD_CAMPAIGN

This recommendation helps you scale high-performing campaigns and ad sets by increasing their budgets. Based on performance data, it identifies opportunities where additional budget could help you reach more people and improve results.

Parameter	Type	Description
`adsets`	string (optional)	JSON array of ad set budget adjustments for ad sets not using campaign budget optimization. Each object contains: ad_object_id (string) and additional_budget (int, in cents e.g., 6000 = $60). Cannot be used for ad sets under campaigns with Advantage Campaign Budget enabled.
`campaigns`	string (optional)	JSON array of campaign budget adjustments for campaigns using Advantage Campaign Budget. Each object contains: ad_object_id (string) and additional_budget (int, in cents e.g., 6000 = $60).

{
  "recommendation_signature": "12345",
  "extra_data": {
    "adsets": "[{\"ad_object_id\": \"123456789\", \"additional_budget\": 6000}]",
    "campaigns": "[{\"ad_object_id\": \"111111111\", \"additional_budget\": 10000}]"
  }
}

SHOPS_ADS_SAOFF

This recommendation transforms your existing ad sets into Shops ads, which allows some customers to browse and build a cart of your products directly within the Facebook or Instagram app. Checkout still happens on your website.

Parameter	Type	Description
`object_selection`	string (optional)	Comma-separated list of ad set IDs to transform into Shop ads. If not provided, all ad sets from the recommendation will be transformed. Invalid IDs (not in recommendation) will return an error.

{
  "recommendation_signature": "12345",
  "extra_data": {
    "object_selection": "123456789,987654321"
  }
}

UNCROP_IMAGE

This recommendation enables image expansion (uncropping) using generative AI. When applied, Meta’s AI will automatically extend your images to fill different aspect ratios, ensuring your ads look great across all placements without cropping important content.

Parameter	Type	Description
`object_selection`	string (optional)	Comma-separated list of ad IDs to enable image expansion on. Skips ads that already have image expansion enabled. If not provided, defaults to all ad IDs from the recommendation target.

{
  "recommendation_signature": "12345",
  "extra_data": {
    "object_selection": "123456789,987654321"
  }
}

Deprecated: Legacy parameters format

> DEPRECATION NOTICE: The following parameters format is deprecated. Please use the extra_data object format documented in the recommendation-specific sections below.

The legacy recommendation application API supports the following parameters.

Name	Description
`recommendation_signature` string	Required. Signature provided in the recommendation fetching API, which corresponds to a unique recommendation.
`music_parameters` object	Optional. Music recommendation parameters. Specific parameters are listed below.
`autoflow_parameters` object	Optional. Autoflow opt-in recommendation parameters. Specific parameters are listed below.
`fragmentation_parameters` object	Optional. Fragmentation recommendation parameters. Specific parameters are listed below.

The `music_parameters` object

Name	Description
`object_selection` array of numeric strings	Optional. A list of ad IDs to apply the music recommendation to. List must be a subset of provided IDs in `object_ids`.

The `autoflow_parameters` object

Name	Description
`object_selection` array of numeric strings	Optional. A list of ad IDs to apply the autoflow opt-in recommendation to. List must be a subset of provided IDs in `object_ids`.

The `fragmentation_parameters` object

Name	Description
`object_selection` array of numeric strings	Optional. A list of ad set IDs to apply the fragmentation recommendation to. List must be a subset of provided IDs in `object_ids`.

Performance recommendation types

These are the currently supported performance recommendation types and what happens when the recommendation is successfully applied.

Name	Description
`ADVANTAGE_PLUS_AUDIENCE`	Leverage Advantage+ audiences to let Meta automatically identify and target the most relevant audience segments for your ad sets, optimizing your budget for maximum impact. Learn more about Advantage+ Audiences⁠.
`ADVANTAGE_PLUS_CATALOG_ADS`	Recommends adoption of Advantage+ Catalog Ads to Ad Accounts with an active catalog but not using Advantage+ Catalog Ads
`APLUSC_ADD_OVERLAYS`	Recommends enabling Advantage+ Overlays for eligible Ads which are currently opted out
`APLUSC_STANDARD_ENHANCEMENTS_BUNDLE`	Recommends enabling Advantage+ Catalog features (Overlays, Text Improvements, and Visual Touch Up) for eligible Ads which are currently opted out
`APLUSC_TEXT_IMPROVEMENTS`	Recommends enabling Advantage+ Text Improvements for eligible Ads which are currently opted out
`APLUSC_VISUAL_TOUCHUPS`	Recommends enabling Advantage+ Visual Touch-Ups for eligible Ads which are currently opted out
`AUTOFLOW_OPT_IN`	Enable standard enhancements, which uses Meta’s data to deliver different variations of your ad when likely to improve performance. Applying this recommendation will enable this functionality for the selected ads objects. If no selection is provided, it will be enabled for all listed ads objects.
`AUTOMATIC_PLACEMENTS`	Allow Meta to automatically select additional placements for your ad sets while making the most of your budget. Learn more about Advantage+ Placements⁠.
`BACKGROUND_GENERATION`	Help your products stand out by using AI-generated backgrounds with eligible product images to show the version that’s likely to perform best.
`BUDGET_LIMITED`	Your current budget may be limiting the performance of your campaigns. You could get more results by increasing the budget.
`CAPI_CRM_GUIDANCE_V2`	Recommends setting up CRM data integration with Conversions API to ad accounts running campaigns to capture leads via instant form
`CAPI_CRM_SETUP`	Recommends finishing setup of CRM data integration with Conversions API to ad accounts running campaigns to capture leads via instant form
`CAPI_PERFORMANCE_MATCH_KEY_V2`	Recommends sending Conversions API more complete event/match-key data when event match quality is low
`CONVERSION_LEADS_OPTIMIZATION`	Choose “Maximize number of conversion leads” as your performance goal to help lower the cost of reaching people most likely to convert.
`CREATIVE_FATIGUE`	Cost per result for this ad set may be higher than ads you ran in the past because its image or video has been shown to parts of your audience too many times. Applying this recommendation requires an ad ID and creative ID, and will create a copy of the provided ad, except with the provided new creative.
`CREATIVE_LIMITED`	Cost per result for this ad set may be higher than ads you ran in the past because its image or video has been shown to parts of your audience too many times. Applying this recommendation requires an ad ID and creative ID, and will create a copy of the provided ad, except with the provided new creative.
`CTX_CREATION_PACKAGE`	This pre-create guidance recommends CTX creation package in Account Overview surface. When adopted, users will be re-directed to open CTX creation package.
`FRAGMENTATION_V3`	Recommends consolidating ad sets to improve liquidity when 2 or more have similar variables, such as objective, audience, or creative, while some variables differ.
`GEN_AI_MVP`	The GenAI MVP recommendation in Ads Manager suggests AI-generated creative variations to help advertisers improve ad performance. It proactively surfaces creative options based on eligibility criteria and encourages adoption of AI-enhanced assets during ad creation and editing (PFR) and can also recommend updates after the ad is live and running (MFR)
`LANDING_PAGE_VIEW_OPTIMIZATION_GOAL`	Create a campaign with the performance goal of “Maximize landing page views” to deliver ads to audiences who are most likely to visit your website.
`MESSAGING_EVENTS`	This pre-create guidance recommends Messaging events in Account Overview surface. When adopted, users will open a help doc about messaging events.
`MESSAGING_PARTNERS`	This pre-create guidance recommends advertisers running Click-to-Messenger and IG Direct ads to use Meta Messaging partners to improve performance and manage high messages volume. Will redirect advertisers to Partner Showcase when Meta Approved partners can be found.
`MULTI_TEXT`	Select more text options so they can be mixed and matched to create different versions of your ad. The version that may perform best will be shown for each placement.
`MUSIC`	Allow Meta to automatically select and add music to your ads, at no cost to you, based on their content. Applying this recommendation will enable this functionality for the selected ads objects. If no selection is provided, it will be enabled for all listed ads objects. Use of music in your ads is subject to the Sound Collection Terms⁠.
`OFFSITE_CONVERSION`	Select the “Maximize number of conversions” performance goal to help drive new customers to your website and lower your cost per result.
`PARTNERSHIP_ADS`	Recommends including a partnership ad in your campaign to help improve performance.
`PERFORMANT_CREATIVE_REELS_OPT_IN`	Select “Reels” placements for ads already using media that works well in Reels placements, so people are more likely to interact with them.
`PIXEL_OPTIMIZATION_HIE`	Recommends advertisers with unoptimized Meta Pixels enable high intent events to be sent for improving performance
`PIXEL_UPSELL`	Connect your website using Meta Pixel to help improve audience targeting, better understand your conversions, and help reduce your cost per result over time.
`PRODUCT_SET_BOOSTING`	Recommends enabling Product Set Expansion for advertisers running Advantage Plus Catalog, enabling Meta to show products from your broader catalog beyond your specified product set.
`SCALE_GOOD_CAMPAIGN`	Some ad sets or campaigns have had stable delivery and a lower cost per result compared to ad sets and campaigns with the same optimization goal that you or your peers have run. Increase their budgets to further scale your results.
`SHOPS_ADS_SAOFF`	Improve your ad performance by selecting “Website” and “Shop” conversion locations for ad sets currently using the Website conversion location. This lets you automatically send traffic either to your website or shop on Facebook or Instagram.
`SIGNALS_GROWTH_CAPI_V2`	Recommends advertisers using only the Meta Pixel adopt Conversions API
`UNCROP_IMAGE`	Expand your images to fit more placements. You can use generated images that expand the aspect ratios of your media, which can fit your ad into new placements and show them to more people. Applying this recommendation will enable this functionality for the selected ads objects. If no selection is provided, it will be enabled for all listed ads objects.
`UNIFIED_INBOX`	Answer unread customer messages within 5 hours of receipt to help increase their value.
`VALUE_OPTIMIZATION_GOAL`	Reach people more likely to generate higher value for your business by focusing on key events across the customer journey, like “Add to cart”. Use the “Maximize value of conversions” performance goal to get started.
`WA_MESSAGING_PARTNERS`	This pre-create guidance recommends advertisers running Click-to-WhatsApp ads to use WhatsApp business partners to improve performance and manage high messages volume. Will redirect advertisers to Partner Showcase when Meta Approved partners can be found.

Best practices for querying ads

Use time range filters

When querying for ads using the Marketing API, it is highly recommended to always apply a time range filter to your requests. This best practice ensures that your queries are efficient, performant, and return only the relevant data you need. By specifying a time range, you reduce the amount of data processed and transferred, which helps avoid unnecessary load on the system and improves response times.

For example, when using an API endpoint such as /{ad-account-id}/ads, you should include parameters that define the start and end dates for your query. This not only aligns with the performance recommendations outlined in this guide, but also helps you avoid common pitfalls like timeouts or excessive data retrieval.

Example request

curl -G \
  -d "access_token=<ACCESS_TOKEN>" \
  -d "limit=200" \
  -d "effective_status=['ACTIVE','PAUSED']" \
  -d "fields=id,name,created_time,updated_time" \
  -d "time_range={'since':'2025-12-01','until':'2025-12-15'}" \
  -d "summary=true" \
"https://graph.facebook.com/v26.0/act_<AD_ACCOUNT_ID>/ads"

In this example, the time_range parameter restricts the results to ads active between December 1, 2025, and December 15, 2025. Always tailor the time range to your specific use case to maximize query performance and relevance.

Opportunity Score and Recommendations

Supported inventory and APIs

Fetching recommendations

Example ad account request

Example ad account response

Example business portfolio request

Example business portfolio response

Fields

Ad-account-level fields

Recommendation-level fields

Applying recommendations

Option 1: Apply via Deep Link URL to Ads Manager

Option 2: Apply via API

Option 3: Apply via custom workflow using campaign management APIs

Apply via API details

Example request

Example response

Recommendation-specific parameters

ADVANTAGE_PLUS_AUDIENCE

APLUSC_STANDARD_ENHANCEMENTS_BUNDLE

AUTOFLOW_OPT_IN

AUTOMATIC_PLACEMENTS

BACKGROUND_GENERATION

CONVERSION_LEADS_OPTIMIZATION

CREATIVE_FATIGUE

LANDING_PAGE_VIEW_OPTIMIZATION_GOAL

MUSIC

PERFORMANT_CREATIVE_REELS_OPT_IN

PRODUCT_SET_BOOSTING

SCALE_GOOD_CAMPAIGN

SHOPS_ADS_SAOFF

UNCROP_IMAGE

Deprecated: Legacy parameters format

The music_parameters object

The autoflow_parameters object

The fragmentation_parameters object

Performance recommendation types

Best practices for querying ads

Use time range filters

Example request

The `music_parameters` object

The `autoflow_parameters` object

The `fragmentation_parameters` object