Facebook Launches Graph API v23.0 and Marketing API v23.0 for Developers

The new GAPI/MAPI changes for V23 include the introduction of the Content Monetization Earnings metric for Creators, which allows them to track earnings at the page or post level over customizable periods. This metric, content_monetization_earnings, reflects potential earnings based on qualified views, total plays, and interactions on eligible public posts.

New Endpoints

• Content Monetization Earnings:

  • POST /{page_id}/content_monetization_earnings
  • POST /{page_id}_{asset_id}/content_monetization_earnings

• Monetization Approximate Earnings:

  • A new metric, monetization_approximate_earnings, is available for Creators to view earnings from various revenue sources, excluding bonuses.
  • New endpoints:
    • POST /{page_id}/monetization_approximate_earnings
    • POST /{page_id}_{asset_id}/monetization_approximate_earnings

Budget Flexibility

Meta Ads Manager accounts will see increased daily budget flexibility from 25% to 75%, allowing for greater spending on high-opportunity days while maintaining a weekly cap of 7 times the daily budget.

Advantage+ Campaign Experience

Advertisers can now combine Advantage+ shopping and app campaigns with manual campaigns, enhancing performance with a unified experience. A new indicator will show if campaigns are Advantage+ ON.

Age and Gender Automation

Meta’s Marketing API introduces automation for age and gender settings, initially available for selected advertisers focusing on OUCTOME_SALES and APP_INSTALLS objectives. This feature allows ads to reach audiences outside specified settings for improved performance.

Changes to Advantage+ Audience Behaviors

Starting from API version V23.0, the advantage_audience parameter within targeting automation will default to 1 or require explicit settings when creating new ad sets.

New ‘Videos’ Field

A new videos field in Catalog’s Product Item Graph API allows advertisers to confirm the properties of uploaded videos for product items, improving ad readiness.

Embedded Signup Versioning

Version 3 of Embedded Signup will align with Graph API, releasing on May 29th. This versioning will provide partners time to transition to the latest version.

Error Code Updates

Updates to Cloud API and MM Lite API will introduce specific error codes for common scenarios, enhancing troubleshooting efficiency.

Deprecations & Breaking Changes

• Instagram User ID Changes: The legacy Instagram account ID will be replaced with IG User ID in the Marketing API, affecting various endpoints.
• Ad Sets for Special Ad Category Campaigns: The field is_sac_cfca_terms_certified will no longer be required in ad sets, with a similar change for is_eligible_for_sac_campaigns.

Meta Business SDKs

The Meta Business SDK v23 will include upgrades and new features, with a deprecation schedule for older versions.

API Version Deprecations

Upcoming deprecations for Graph API and Marketing API versions are scheduled, with recommendations to migrate to the latest version to avoid disruptions.