News for Developers

Back to News

Updates to the Ad Rules Engine

Zain Aziz
November 8, 2017

Related News


December 13 2017

Targeting Exclusions

December 06 2017

In April 2017, we announced the release of our Ad Rules engine. The Ad Rules engine is a central rule management service that helps you manage ads more easily, efficiently, and intelligently.

As a recap, there are two types of rules:

  • Trigger-Based Rules—Evaluate rules in real-time, as soon as the ad object's insights or metadata changes.
  • Schedule-Based Rules—Evaluate rules based on set intervals.

Today, we're excited to announce updates, including the public release of near real-time Trigger-Based Rules, enhancements to both Trigger- and Schedule-Based Rules, and new API features.

Trigger-Based Rules Public Launch

  • Metadata Triggers—Allow real-time triggers for ad object creation and update, and support new metadata fields both for filtering and as the triggers. For example:
  • New Execution TypesPAUSE and NOTIFICATION.
  • History Endpoint—Supports a history of all rule executions for a Trigger-Based Rule. For more information on how to use this endpoint, see Access a Rule's Execution History.

Shared Updates for Trigger- and Schedule-Based Rules

  • Action Type Breakdowns—A wide set of performance metrics, including most Ads Action Stats based on mobile app events, Facebook Pixel website conversions, and post engagement events. For more information on the new expanded list of Insights metrics, see Insights Filters.
  • New Metadata Filters for Metadata Triggers and Schedule-Based Rules—Includes fields, such as spend_cap and bid_amount. For more information on the new supported list, see Metadata Filters.
  • New Execution TypeUNPAUSE is a new execution type to activate objects that pass rule evaluation.

Schedule-Based Rules Updates

  • Advanced Scheduling—Allows more flexible scheduling of rules; for example, at specific times of day or specific days of the week. For more information, see Ad Rules Examples - Advanced Scheduling.
  • ROI Based Budget Rebalancing Rules—Allow automatic rebalancing of budgets between ad sets within and across campaigns based on any Insights metric; for example, cost_per_mobile_app_install. For more information, see Ad Rules Examples - Rebalance Budget.
  • ROI Target Rules—Allow automatic scaling of bids and budgets based on a target Insights metric and value. For more information, see Ad Rules Examples - Change Spec.
  • ROAS Metrics—New ROAS metrics and customized time presets that include only matured data. For more information, see Ad Rules Examples - ROAS.
    • New Metrics—mobile_app_purchase_roas, website_purchase_roas
    • New Time Presets—LAST_ND_14_8, ..., LAST_ND_60_29, ...
  • Miscellaneous New Filters
    • Time-Based Filters—active_time, current_time
    • Delivery-Based Filters—estimated_budget_spending_percentage, audience_reached_percentage
  • Miscellaneous New Time Presets and Attribution Windows
    • Time Presets (also useful for 1D ROAS)—LAST_2D, LAST_3D, LAST_7D, LAST_14D, LAST_30D
    • Attribution Windows—ACCOUNT_DEFAULT, INLINE

Tools and Communication Channels for Rules APIs

  • Rule Engine Quickstart—Marketing API Quickstart guide, designed to help guide new developers create their first notification-based rule. Learn more about the Rules Engine Quickstart.
  • Preview and Execute Endpoints—Preview objects that pass the evaluation phase and manual execution of Schedule-Based Rules. For more information, see Preview and Manually Execute a Rule.
  • Account-Level History Endpoint—An endpoint that aggregates all rule execution histories for the ad account. For more information, see Access an Account's Execution History.
  • Communication Channels—Support both email and Facebook page as developer channels for questions, feedback, feature requests, and more.

Related News

December 13 2017

November 28 2017

November 08 2017

November 07 2017