facebookbusiness 25.0.3 → 25.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a10e421eaa016e4fd2ba9b81ea6a2e6894db11cc6a25ed1d6ac3e360694efb0a
-  data.tar.gz: bd1178acf2856eacab6143bfe998b87fcc03678486a001b8f7ea663f14300f2c
+  metadata.gz: 575e0b46180dbba69e9c7f3b59af6f80ec64b67c371c97cd8fd03adb2b640779
+  data.tar.gz: 644b903dcf5470e06c16558d363d6cfa70fc590c2a23ef1bcdc9e67d1c0c189b
 SHA512:
-  metadata.gz: c319d0bda77716e2f857f684408cbc28f8ff566de91109dec1fff9fd73f950efb305c0607d4db2735d22a2d18064fa87c1162d074cbcfcfafbbd258dd33be926
-  data.tar.gz: 435ba7bdc74c109906f91989f9db7c124488890179e7f6afb099715112188dc465069bcca592f980d6c51f59c4a38e635244e60ef0cea75ffbfb3bda9c29d2c5
+  metadata.gz: '090a82e3b13c4ac35a7c411ac6f11be1859898681919dd8b8fdb944d997dbaac56cbbe7066998c9a7f35c1f9327567fc12be32479c25530caaa844fe38411dbc'
+  data.tar.gz: 91e784bb934f2438d014b2443cc58e35fc8efb9bec71afa6e0019803cb23de478b3c987b777f2e9fd9777d4f27cfd693783cae76ad5685a626b922eed4daa43b

data/README.md

@@ -256,6 +256,66 @@ FacebookAds.configure do |config|
 end
 ```
 
+## Conversions API
+
+The Business SDK includes a server-side client for the [Conversions API](https://developers.facebook.com/docs/marketing-api/conversions-api), used to send web, app, and offline events to Meta directly from your server.
+
+```ruby
+require 'facebook_ads'
+
+FacebookAds.configure { |config| config.access_token = '<ACCESS_TOKEN>' }
+
+user_data = FacebookAds::ServerSide::UserData.new(
+  email: 'joe@eg.com',
+  client_ip_address: request.remote_ip,
+  client_user_agent: request.user_agent
+)
+custom_data = FacebookAds::ServerSide::CustomData.new(
+  currency: 'usd',
+  value: 123.45
+)
+event = FacebookAds::ServerSide::Event.new(
+  event_name: 'Purchase',
+  event_time: Time.now.to_i,
+  user_data: user_data,
+  custom_data: custom_data,
+  event_source_url: 'http://jaspers-market.com/product/123',
+  action_source: 'website'
+)
+response = FacebookAds::ServerSide::EventRequest.new(
+  pixel_id: '<PIXEL_ID>',
+  events: [event]
+).execute
+print "#{response}\n"
+```
+
+For advanced features — asynchronous requests, concurrent batching, and a custom HTTP service — see [Meta Business SDK Features for Conversions API](https://developers.facebook.com/documentation/ads-commerce/conversions-api/guides/business-sdk-features/).
+
+### Conversions API Parameter Builder integration
+
+The SDK bundles the [Conversions API Parameter Builder](https://github.com/facebook/capi-param-builder) ([Ruby README](https://github.com/facebook/capi-param-builder/blob/main/ruby/README.md)) so it can auto-fill key event parameters straight from the incoming HTTP request. Call `set_request_context` on an event and pass the incoming request — see [Framework support](https://github.com/facebook/capi-param-builder/blob/main/ruby/README.md#framework-support) for exactly what to pass for your framework (e.g. a Rails `ActionDispatch::Request`, a Sinatra request, or any Rack `env`). At send time the SDK runs the Parameter Builder and fills in any of these fields you left empty:
+
+- `user_data.fbc`, `user_data.fbp`
+- `event_source_url`, `referrer_url`
+
+```ruby
+event = FacebookAds::ServerSide::Event.new(
+  event_name: 'Purchase',
+  event_time: Time.now.to_i,
+  user_data: FacebookAds::ServerSide::UserData.new(email: 'joe@eg.com'),
+  action_source: 'website'
+)
+event.set_request_context(request)
+
+# Optional: gate which fields may be auto-filled (all default true).
+#   event.set_request_context(
+#     request,
+#     preference: FacebookAds::ServerSide::Preference.new(is_event_source_url_allowed: false)
+#   )
+```
+
+Auto-fill is **gated** by the optional `Preference` allowlist, **non-destructive** (a value you set yourself is never overwritten), and **order-independent**. Note that in Ruby, `client_ip_address` is not auto-derived yet — keep setting it (and `client_user_agent`) yourself.
+
 ## SDK Codegen
 Our SDK is autogenerated from [SDK Codegen](https://github.com/facebook/facebook-business-sdk-codegen). If you want to learn more about how our SDK code is generated, please check this repository.
 

data/lib/facebook_ads/ad_objects/ad_account.rb

@@ -500,6 +500,7 @@ module FacebookAds
         api.has_param :updated_since, 'int'
       end
       edge.post 'AdSet' do |api|
+        api.has_param :ad_set_goal, 'hash'
         api.has_param :adlabels, { list: 'object' }
         api.has_param :adset_schedule, { list: 'object' }
         api.has_param :attribution_count_type, { enum: -> { AdSet::ATTRIBUTION_COUNT_TYPE }}
@@ -510,6 +511,7 @@ module FacebookAds
         api.has_param :bid_constraints, 'hash'
         api.has_param :bid_strategy, { enum: -> { AdSet::BID_STRATEGY }}
         api.has_param :billing_event, { enum: -> { AdSet::BILLING_EVENT }}
+        api.has_param :brand_safety_config, 'hash'
         api.has_param :budget_schedule_specs, { list: 'object' }
         api.has_param :budget_source, { enum: -> { AdSet::BUDGET_SOURCE }}
         api.has_param :budget_split_set_id, 'string'
@@ -538,6 +540,7 @@ module FacebookAds
         api.has_param :is_dynamic_creative, 'bool'
         api.has_param :is_incremental_attribution_enabled, 'bool'
         api.has_param :is_sac_cfca_terms_certified, 'bool'
+        api.has_param :is_sequenced_conversion_creation, 'bool'
         api.has_param :lifetime_budget, 'int'
         api.has_param :lifetime_imps, 'int'
         api.has_param :lifetime_min_spend_target, 'int'
@@ -1061,12 +1064,12 @@ module FacebookAds
       edge.post do |api|
         api.has_param :bid_amount, 'int'
         api.has_param :daily_budget, 'int'
-        api.has_param :end_time, 'int'
+        api.has_param :end_time, 'datetime'
         api.has_param :lifetime_budget, 'int'
         api.has_param :name, 'string'
         api.has_param :page_id, 'string'
         api.has_param :pixel_id, 'int'
-        api.has_param :start_time, 'int'
+        api.has_param :start_time, 'datetime'
       end
     end
 

data/lib/facebook_ads/ad_objects/ad_account_ad_volume.rb

@@ -149,6 +149,7 @@ module FacebookAds
       "CAPI_PENETRATION",
       "CAPI_PERFORMANCE_MATCH_KEY",
       "CAPI_PERFORMANCE_MATCH_KEY_V2",
+      "CAPI_PERFORMANCE_MATCH_KEY_V3",
       "CASH_REWARDS_OPT_IN",
       "CATALOG_DYNAMIC_MEDIA",
       "CATALOG_MATCH_RATE",

data/lib/facebook_ads/ad_objects/{ig_shopping_review_status.rb → ad_account_feature_preferences.rb}

@@ -13,15 +13,16 @@ module FacebookAds
   # on github and we'll fix in our codegen framework. We'll not be able to accept
   # pull request for this class.
 
-  class IgShoppingReviewStatus < AdObject
+  class AdAccountFeaturePreferences < AdObject
 
-    field :onsite_eligibility, 'IgShoppingReviewStatusOnsiteEligibility'
-    field :reasons, { list: 'IgShoppingReviewStatusReasonWithHelpMessage' }
-    field :status, 'string'
-    has_no_id
+    field :id, 'string'
     has_no_get
     has_no_post
     has_no_delete
 
+    has_edge :feature_preferences do |edge|
+      edge.post 'AdAccountFeaturePreferencesPost'
+    end
+
   end
 end

data/lib/facebook_ads/ad_objects/ad_account_feature_preferences_post.rb

@@ -0,0 +1,24 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+
+# This source code is licensed under the license found in the
+# LICENSE file in the root directory of this source tree.
+
+# FB:AUTOGEN
+
+module FacebookAds
+  # This class is auto-generated.
+
+  # For any issues or feature requests related to this class, please let us know
+  # on github and we'll fix in our codegen framework. We'll not be able to accept
+  # pull request for this class.
+
+  class AdAccountFeaturePreferencesPost < AdObject
+
+    field :id, 'string'
+    has_no_get
+    has_no_post
+    has_no_delete
+
+  end
+end

data/lib/facebook_ads/ad_objects/ad_account_targeting_unified.rb

@@ -420,6 +420,7 @@ module FacebookAds
       "product_audience_specs",
       "prospecting_audience",
       "publisher_platforms",
+      "purchase_intent",
       "radius",
       "region_keys",
       "regions",

data/lib/facebook_ads/ad_objects/ad_account_user_settings.rb

@@ -48,6 +48,7 @@ module FacebookAds
     field :ads_manager_footer_row_toast_impressions, 'int'
     field :auto_review_video_caption, 'bool'
     field :budget_optimization_quick_view_created, 'bool'
+    field :budget_pool_qv_created, 'bool'
     field :campaign_overview_columns, { list: 'string' }
     field :column_suggestion_status, 'string'
     field :conditional_formatting_rules, { list: 'string' }

data/lib/facebook_ads/ad_objects/ad_activity.rb

@@ -79,6 +79,9 @@ module FacebookAds
       "update_ad_set_bid_strategy",
       "update_ad_set_bidding",
       "update_ad_set_budget",
+      "update_ad_set_budget_scaling_cost_target",
+      "update_ad_set_budget_scaling_extra_budget",
+      "update_ad_set_budget_scaling_status",
       "update_ad_set_cost_bidding_mode",
       "update_ad_set_duration",
       "update_ad_set_learning_stage_status",
@@ -105,6 +108,9 @@ module FacebookAds
       "update_campaign_delivery_type",
       "update_campaign_group_ad_scheduling",
       "update_campaign_group_agency_fee",
+      "update_campaign_group_budget_scaling_cost_target",
+      "update_campaign_group_budget_scaling_extra_budget",
+      "update_campaign_group_budget_scaling_status",
       "update_campaign_group_budget_scheduling_state",
       "update_campaign_group_delivery_type",
       "update_campaign_group_high_demand_periods",
@@ -150,6 +156,7 @@ module FacebookAds
     field :object_id, 'string'
     field :object_name, 'string'
     field :object_type, 'string'
+    field :tool, 'string'
     field :translated_event_type, 'string'
     has_no_id
     has_no_get

data/lib/facebook_ads/ad_objects/ad_campaign_goal.rb

@@ -0,0 +1,36 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+
+# This source code is licensed under the license found in the
+# LICENSE file in the root directory of this source tree.
+
+# FB:AUTOGEN
+
+module FacebookAds
+  # This class is auto-generated.
+
+  # For any issues or feature requests related to this class, please let us know
+  # on github and we'll fix in our codegen framework. We'll not be able to accept
+  # pull request for this class.
+
+  class AdCampaignGoal < AdObject
+
+    field :engaged_audiences_audience_label_exclusions, { list: 'string' }
+    field :engaged_audiences_audience_label_inclusions, { list: 'string' }
+    field :engaged_audiences_exclusions, { list: 'string' }
+    field :engaged_audiences_inclusions, { list: 'string' }
+    field :existing_customers_audience_label_exclusions, { list: 'string' }
+    field :existing_customers_audience_label_inclusions, { list: 'string' }
+    field :existing_customers_exclusions, { list: 'string' }
+    field :existing_customers_inclusions, { list: 'string' }
+    field :is_ca_expansion_enabled, 'bool'
+    field :is_lookalike_inclusion_enabled, 'bool'
+    field :lookalike_inclusions, { list: 'string' }
+    field :type, 'int'
+    has_no_id
+    has_no_get
+    has_no_post
+    has_no_delete
+
+  end
+end

data/lib/facebook_ads/ad_objects/ad_creative_object_story_spec.rb

@@ -23,6 +23,7 @@ module FacebookAds
     field :template_data, 'AdCreativeLinkData'
     field :text_data, 'AdCreativeTextData'
     field :video_data, 'AdCreativeVideoData'
+    field :whats_app_business_phone_number, 'string'
     has_no_id
     has_no_get
     has_no_post

data/lib/facebook_ads/ad_objects/ad_creative_sourcing_spec.rb

@@ -24,6 +24,7 @@ module FacebookAds
     field :enable_social_feedback_preservation, 'bool'
     field :featured_offering_spec, 'object'
     field :intent, 'object'
+    field :ncs_testimonial, 'object'
     field :pca_spec, 'object'
     field :product_media_metadata_spec, 'object'
     field :promotion_metadata_spec, { list: 'AdCreativePromotionMetadataSpec' }

data/lib/facebook_ads/ad_objects/ad_set.rb

@@ -224,6 +224,9 @@ module FacebookAds
       "17",
       "18",
       "19",
+      "20",
+      "21",
+      "22",
     ]
 
     TUNE_FOR_CATEGORY = [
@@ -249,6 +252,7 @@ module FacebookAds
 
 
     field :account_id, 'string'
+    field :ad_set_goal, 'AdCampaignGoal'
     field :adlabels, { list: 'AdLabel' }
     field :adset_schedule, { list: 'DayPart' }
     field :asset_feed_id, 'string'
@@ -293,6 +297,7 @@ module FacebookAds
     field :is_dynamic_creative, 'bool'
     field :is_incremental_attribution_enabled, 'bool'
     field :is_organic_ad_joint_optimized, 'bool'
+    field :is_sequenced_conversion_creation, 'bool'
     field :issues_info, { list: 'AdCampaignIssuesInfo' }
     field :learning_stage_info, 'AdCampaignLearningStageInfo'
     field :lifetime_budget, 'string'

data/lib/facebook_ads/ad_objects/ads_action_stats.rb

@@ -22,6 +22,7 @@ module FacebookAds
     field :_1d_ev_all_conversions, 'string'
     field :_1d_ev_first_conversion, 'string'
     field :_1d_passback, 'string'
+    field :_1d_sequenced, 'string'
     field :_1d_view, 'string'
     field :_1d_view_all_conversions, 'string'
     field :_1d_view_first_conversion, 'string'
@@ -29,6 +30,7 @@ module FacebookAds
     field :_28d_click_all_conversions, 'string'
     field :_28d_click_first_conversion, 'string'
     field :_28d_passback, 'string'
+    field :_28d_sequenced, 'string'
     field :_28d_view, 'string'
     field :_28d_view_all_conversions, 'string'
     field :_28d_view_first_conversion, 'string'
@@ -36,6 +38,7 @@ module FacebookAds
     field :_7d_click_all_conversions, 'string'
     field :_7d_click_first_conversion, 'string'
     field :_7d_passback, 'string'
+    field :_7d_sequenced, 'string'
     field :_7d_view, 'string'
     field :_7d_view_all_conversions, 'string'
     field :_7d_view_first_conversion, 'string'

data/lib/facebook_ads/ad_objects/ads_histogram_stats.rb

@@ -22,6 +22,7 @@ module FacebookAds
     field :_1d_ev_all_conversions, { list: 'int' }
     field :_1d_ev_first_conversion, { list: 'int' }
     field :_1d_passback, { list: 'int' }
+    field :_1d_sequenced, { list: 'int' }
     field :_1d_view, { list: 'int' }
     field :_1d_view_all_conversions, { list: 'int' }
     field :_1d_view_first_conversion, { list: 'int' }
@@ -29,6 +30,7 @@ module FacebookAds
     field :_28d_click_all_conversions, { list: 'int' }
     field :_28d_click_first_conversion, { list: 'int' }
     field :_28d_passback, { list: 'int' }
+    field :_28d_sequenced, { list: 'int' }
     field :_28d_view, { list: 'int' }
     field :_28d_view_all_conversions, { list: 'int' }
     field :_28d_view_first_conversion, { list: 'int' }
@@ -36,6 +38,7 @@ module FacebookAds
     field :_7d_click_all_conversions, { list: 'int' }
     field :_7d_click_first_conversion, { list: 'int' }
     field :_7d_passback, { list: 'int' }
+    field :_7d_sequenced, { list: 'int' }
     field :_7d_view, { list: 'int' }
     field :_7d_view_all_conversions, { list: 'int' }
     field :_7d_view_first_conversion, { list: 'int' }

data/lib/facebook_ads/ad_objects/ads_insights.rb

@@ -17,17 +17,24 @@ module FacebookAds
     ACTION_ATTRIBUTION_WINDOWS = [
       "1d_click",
       "1d_ev",
+      "1d_sequenced",
       "1d_view",
       "28d_click",
+      "28d_sequenced",
       "28d_view",
       "28d_view_all_conversions",
       "28d_view_first_conversion",
       "7d_click",
+      "7d_sequenced",
       "7d_view",
       "7d_view_all_conversions",
       "7d_view_first_conversion",
+      "custom",
       "dda",
       "default",
+      "incrementality",
+      "incrementality_all_conversions",
+      "incrementality_first_conversion",
       "skan_click",
       "skan_click_second_postback",
       "skan_click_third_postback",
@@ -302,6 +309,8 @@ module FacebookAds
     field :creative_diversity_data, { list: 'object' }
     field :creative_diversity_label, 'string'
     field :creative_diversity_score, 'string'
+    field :creative_fatigue_summary, { list: 'object' }
+    field :creative_fatigued_ads, { list: 'object' }
     field :creative_media_type, 'string'
     field :ctr, 'string'
     field :date_start, 'string'
@@ -382,7 +391,6 @@ module FacebookAds
     field :result_rate, { list: 'object' }
     field :result_values_performance_indicator, 'string'
     field :results, { list: 'object' }
-    field :shop_clicks, 'string'
     field :shops_assisted_purchases, 'string'
     field :social_spend, 'string'
     field :spend, 'string'

data/lib/facebook_ads/ad_objects/ads_value_adjustment_rule_collection.rb

@@ -16,6 +16,7 @@ module FacebookAds
   class AdsValueAdjustmentRuleCollection < AdObject
     ENTRY_POINT = [
       "ADVERTISING_SETTINGS",
+      "L2_AUDIENCE",
       "L2_CONVERSION_LOCATION",
       "L2_GLOBAL",
       "L2_NCA_GOAL",

data/lib/facebook_ads/ad_objects/album.rb

@@ -115,6 +115,7 @@ module FacebookAds
         api.has_param :privacy, 'string'
         api.has_param :profile_id, 'int'
         api.has_param :provenance_info, 'hash'
+        api.has_param :provenance_metadata, 'hash'
         api.has_param :proxied_app_id, 'string'
         api.has_param :published, 'bool'
         api.has_param :qn, 'string'

data/lib/facebook_ads/ad_objects/audio_copyright.rb

@@ -15,6 +15,7 @@ module FacebookAds
 
   class AudioCopyright < AdObject
 
+    field :audio_asset, 'AudioAsset'
     field :creation_time, 'datetime'
     field :displayed_matches_count, 'int'
     field :id, 'string'

data/lib/facebook_ads/ad_objects/audio_isrc.rb

@@ -18,6 +18,7 @@ module FacebookAds
     field :all_kg_featured_artists, 'string'
     field :all_kg_main_artists, 'string'
     field :artist_profile_picture_url, 'string'
+    field :canonical_audio_asset, 'AudioAsset'
     field :id, 'string'
     field :isrc, 'string'
     field :publishing_rights_data, 'object'

data/lib/facebook_ads/ad_objects/business.rb

@@ -1240,6 +1240,7 @@ module FacebookAds
       edge.get 'OpenBridgeConfiguration'
       edge.post 'OpenBridgeConfiguration' do |api|
         api.has_param :active, 'bool'
+        api.has_param :associated_sgw_data_source_id, 'int'
         api.has_param :blocked_event_types, { list: 'string' }
         api.has_param :blocked_websites, { list: 'string' }
         api.has_param :capi_publishing_state, { enum: -> { OpenBridgeConfiguration::CAPI_PUBLISHING_STATE }}

data/lib/facebook_ads/ad_objects/comment.rb

@@ -27,6 +27,7 @@ module FacebookAds
       "GRAPHQL_MULTIPLE_VALUE_HACK_DO_NOT_USE",
       "OWNER_OR_COMMENTER",
       "PENDING_APPROVAL",
+      "PRIVATE_CONVERSATION_PARTICIPANTS_ONLY",
       "REMOVED_BY_ADMIN_ASSISTANT",
       "SIDE_CONVERSATION",
       "SIDE_CONVERSATION_AND_POST_OWNER",

data/lib/facebook_ads/ad_objects/copyright_audio_asset.rb

@@ -17,10 +17,12 @@ module FacebookAds
 
     field :audio_availability_status, 'string'
     field :audio_library_policy, { list: 'map<string, list<map<string, Object>>>' }
+    field :canonical_reference_file, 'AudioAsset'
     field :creation_time, 'datetime'
     field :id, 'string'
     field :reference_file_isrcs, { list: 'string' }
     field :reference_files, { list: 'object' }
+    field :representative_reference_file, 'AudioAsset'
     field :title, 'string'
     field :update_time, 'datetime'
     has_no_get

data/lib/facebook_ads/ad_objects/custom_audience.rb

@@ -16,25 +16,21 @@ module FacebookAds
   class CustomAudience < AdObject
     include CustomAudienceHelpers
     AUDIENCE_LABELS = [
-      "APP_INSTALLERS",
       "APP_USERS",
       "AT_RISK",
       "CART_ABANDONERS",
-      "CUSTOMER_LEADS",
       "DISENGAGED",
       "DISQUALIFIED_LEADS",
       "ENGAGED_USERS",
+      "GENERAL_CUSTOMERS",
       "HIGH_VALUE_CUSTOMERS",
       "LOW_VALUE_CUSTOMERS",
       "OTHER_1",
       "OTHER_2",
       "OTHER_3",
-      "PERSONAS",
       "QUALIFIED_LEADS",
       "RECENT_PURCHASERS",
-      "RESTRICTED_USERS",
       "TRIAL_USERS",
-      "UNWANTED_CUSTOMERS",
     ]
 
     CLAIM_OBJECTIVE = [

data/lib/facebook_ads/ad_objects/group.rb

@@ -357,6 +357,7 @@ module FacebookAds
         api.has_param :privacy, 'string'
         api.has_param :profile_id, 'int'
         api.has_param :provenance_info, 'hash'
+        api.has_param :provenance_metadata, 'hash'
         api.has_param :proxied_app_id, 'string'
         api.has_param :published, 'bool'
         api.has_param :qn, 'string'

data/lib/facebook_ads/ad_objects/ig_media.rb

@@ -16,6 +16,7 @@ module FacebookAds
   class IgMedia < AdObject
 
     field :alt_text, 'string'
+    field :audio_id, 'string'
     field :boost_eligibility_info, 'IgMediaBoostEligibilityInfo'
     field :caption, 'string'
     field :comments_count, 'int'
@@ -25,6 +26,7 @@ module FacebookAds
     field :has_slider, 'bool'
     field :id, 'string'
     field :ig_id, 'string'
+    field :is_ai_generated, 'bool'
     field :is_comment_enabled, 'bool'
     field :is_shared_to_feed, 'bool'
     field :legacy_instagram_media_id, 'string'

data/lib/facebook_ads/ad_objects/ig_media_for_ig_only_api.rb

@@ -20,6 +20,7 @@ module FacebookAds
     field :comments_count, 'int'
     field :current_live_viewer_count, 'int'
     field :id, 'string'
+    field :is_ai_generated, 'bool'
     field :is_comment_enabled, 'bool'
     field :is_shared_to_feed, 'bool'
     field :like_count, 'int'

data/lib/facebook_ads/ad_objects/ig_user.rb

@@ -28,6 +28,7 @@ module FacebookAds
     field :media_count, 'int'
     field :mentioned_comment, 'IgComment'
     field :mentioned_media, 'IgMedia'
+    field :mini_shop_storefront, 'Shop'
     field :name, 'string'
     field :owner_business, 'Business'
     field :profile_picture_url, 'string'
@@ -146,6 +147,7 @@ module FacebookAds
         api.has_param :major_audience_device_type, { list: 'object' }
         api.has_param :major_audience_gender, { list: { enum: -> { IgUserExportForCam::MAJOR_AUDIENCE_GENDER }} }
         api.has_param :major_audience_states, { list: 'string' }
+        api.has_param :platform, { list: { enum: -> { IgUserExportForCam::PLATFORM }} }
         api.has_param :query, 'string'
         api.has_param :recommendation_type, { enum: -> { IgUserExportForCam::RECOMMENDATION_TYPE }}
         api.has_param :reels_interaction_rate, 'object'
@@ -202,6 +204,7 @@ module FacebookAds
         api.has_param :collaborators, { list: 'string' }
         api.has_param :cover_url, 'string'
         api.has_param :image_url, 'string'
+        api.has_param :is_ai_generated, 'bool'
         api.has_param :is_carousel_item, 'bool'
         api.has_param :is_paid_partnership, 'bool'
         api.has_param :location_id, 'string'
@@ -264,7 +267,11 @@ module FacebookAds
     end
 
     has_edge :tags do |edge|
-      edge.get 'IgMedia'
+      edge.get 'IgMedia' do |api|
+        api.has_param :media_type, 'string'
+        api.has_param :posted_after, 'string'
+        api.has_param :posted_before, 'string'
+      end
     end
 
     has_edge :upcoming_events do |edge|

data/lib/facebook_ads/ad_objects/ig_user_export_for_cam.rb

@@ -538,6 +538,11 @@ module FacebookAds
       "unknown",
     ]
 
+    PLATFORM = [
+      "facebook",
+      "instagram",
+    ]
+
     RECOMMENDATION_TYPE = [
       "high_ad_performance",
       "most_ads_experience",
@@ -560,7 +565,10 @@ module FacebookAds
     field :is_paid_partnership_messages_enabled, 'bool'
     field :messaging_id, 'string'
     field :onboarded_status, 'bool'
+    field :page_id, 'string'
+    field :page_name, 'string'
     field :past_brand_partnership_partners, { list: 'string' }
+    field :platforms, { list: 'string' }
     field :portfolio_url, 'string'
     field :profile_picture_url, 'string'
     field :username, 'string'
@@ -577,6 +585,7 @@ module FacebookAds
         api.has_param :breakdown, { enum: %w{AGE FOLLOW_TYPE GENDER MEDIA_TYPE TOP_CITIES TOP_COUNTRIES }}
         api.has_param :metrics, { list: { enum: %w{CREATOR_ENGAGED_ACCOUNTS CREATOR_REACH REELS_HOOK_RATE REELS_INTERACTION_RATE TOTAL_FOLLOWERS }} }
         api.has_param :period, { enum: %w{DAY OVERALL }}
+        api.has_param :platform, { list: { enum: %w{FACEBOOK INSTAGRAM }} }
         api.has_param :time_range, { enum: %w{LAST_14_DAYS LAST_90_DAYS LIFETIME THIS_MONTH THIS_WEEK }}
       end
     end

data/lib/facebook_ads/ad_objects/ig_user_for_ig_only_api.rb

@@ -81,6 +81,7 @@ module FacebookAds
         api.has_param :collaborators, { list: 'string' }
         api.has_param :cover_url, 'string'
         api.has_param :image_url, 'string'
+        api.has_param :is_ai_generated, 'bool'
         api.has_param :is_carousel_item, 'bool'
         api.has_param :is_paid_partnership, 'bool'
         api.has_param :location_id, 'string'
@@ -140,6 +141,20 @@ module FacebookAds
       end
     end
 
+    has_edge :passthreadcontrol do |edge|
+      edge.post do |api|
+        api.has_param :metadata, 'string'
+        api.has_param :recipient, 'object'
+        api.has_param :target_app_id, 'string'
+      end
+    end
+
+    has_edge :releasethreadcontrol do |edge|
+      edge.post do |api|
+        api.has_param :recipient, 'object'
+      end
+    end
+
     has_edge :stories do |edge|
       edge.get
     end
@@ -153,7 +168,11 @@ module FacebookAds
     end
 
     has_edge :tags do |edge|
-      edge.get
+      edge.get do |api|
+        api.has_param :media_type, 'string'
+        api.has_param :posted_after, 'string'
+        api.has_param :posted_before, 'string'
+      end
     end
 
     has_edge :welcome_message_flows do |edge|

data/lib/facebook_ads/ad_objects/insights_result.rb

@@ -23,7 +23,6 @@ module FacebookAds
 
     METRIC = [
       "comments",
-      "content_views",
       "crossposted_views",
       "facebook_views",
       "follows",

data/lib/facebook_ads/ad_objects/instagram_insights_result.rb

@@ -23,7 +23,6 @@ module FacebookAds
 
     METRIC = [
       "comments",
-      "content_views",
       "crossposted_views",
       "facebook_views",
       "follows",

data/lib/facebook_ads/ad_objects/lead_gen_form_preview_details.rb

@@ -54,6 +54,7 @@ module FacebookAds
     field :return_to_facebook_text, 'string'
     field :review_your_info_text, 'string'
     field :secure_sharing_text, 'string'
+    field :secure_sharing_text_for_embedded_booking, 'string'
     field :secure_sharing_text_for_embedded_booking_calendly, 'string'
     field :secure_sharing_text_for_embedded_booking_ghl, 'string'
     field :secure_sharing_text_for_optional_privacy_policy, 'string'

data/lib/facebook_ads/ad_objects/open_bridge_configuration.rb

@@ -40,6 +40,7 @@ module FacebookAds
 
 
     field :active, 'bool'
+    field :associated_sgw_data_source_id, 'string'
     field :blocked_event_types, { list: 'string' }
     field :blocked_websites, { list: 'string' }
     field :browser_agent, { list: 'string' }
@@ -58,6 +59,7 @@ module FacebookAds
     field :instance_version, 'string'
     field :is_sgw_instance, 'bool'
     field :is_sgw_pixel_from_meta_pixel, 'bool'
+    field :mpc_fallback_domain, 'string'
     field :partner_name, 'string'
     field :pixel_id, 'string'
     field :sgw_account_id, 'string'

data/lib/facebook_ads/ad_objects/page.rb

@@ -1013,6 +1013,7 @@ module FacebookAds
         api.has_param :custom_disclaimer, 'object'
         api.has_param :follow_up_action_url, 'string'
         api.has_param :is_for_canvas, 'bool'
+        api.has_param :is_lead_capture_ai_agent_enabled, 'bool'
         api.has_param :is_optimized_for_quality, 'bool'
         api.has_param :is_phone_sms_verify_enabled, 'bool'
         api.has_param :locale, { enum: -> { LeadgenForm::LOCALE }}
@@ -1341,6 +1342,7 @@ module FacebookAds
         api.has_param :privacy, 'string'
         api.has_param :profile_id, 'int'
         api.has_param :provenance_info, 'hash'
+        api.has_param :provenance_metadata, 'hash'
         api.has_param :proxied_app_id, 'string'
         api.has_param :published, 'bool'
         api.has_param :qn, 'string'

data/lib/facebook_ads/ad_objects/product_catalog.rb

@@ -288,7 +288,7 @@ module FacebookAds
     end
 
     has_edge :geolocated_items_batch do |edge|
-      edge.post 'ProductCatalog' do |api|
+      edge.post do |api|
         api.has_param :allow_upsert, 'bool'
         api.has_param :item_type, 'string'
         api.has_param :requests, 'hash'

data/lib/facebook_ads/ad_objects/product_item.rb

@@ -401,6 +401,7 @@ module FacebookAds
       "ITEM_OVERRIDE_NOT_VISIBLE",
       "ITEM_PRICE_NOT_POSITIVE",
       "ITEM_STALE_OUT_OF_STOCK",
+      "ITEM_WITHOUT_VIDEO",
       "MARKETPLACE_DISABLED_BY_USER",
       "MARKETPLACE_NOT_SHIPPED_ITEM",
       "MARKETPLACE_PARTNER_AUCTION_NO_BID_CLOSE_TIME",

data/lib/facebook_ads/ad_objects/third_party_partner_viewability_request.rb

@@ -24,6 +24,7 @@ module FacebookAds
       "AUDIENCE_NETWORK",
       "FACEBOOK",
       "INSTAGRAM",
+      "THREADS",
     ]
 
     STATUS = [

data/lib/facebook_ads/ad_objects/user.rb

@@ -533,6 +533,7 @@ module FacebookAds
         api.has_param :privacy, 'string'
         api.has_param :profile_id, 'int'
         api.has_param :provenance_info, 'hash'
+        api.has_param :provenance_metadata, 'hash'
         api.has_param :proxied_app_id, 'string'
         api.has_param :published, 'bool'
         api.has_param :qn, 'string'

data/lib/facebook_ads/ad_objects/whats_app_business_account.rb

@@ -37,6 +37,11 @@ module FacebookAds
       "UNTIERED",
     ]
 
+    WHATSAPP_MANAGER_MARKETING_MESSAGES_MAX_PRICE_ENROLL_STATUS = [
+      "OPT_IN",
+      "OPT_OUT",
+    ]
+
     TASKS = [
       "DEVELOP",
       "MANAGE",
@@ -120,6 +125,7 @@ module FacebookAds
     field :template_auto_archival_enabled, 'bool'
     field :timezone_id, 'string'
     field :whatsapp_business_manager_messaging_limit, { enum: -> { WHATSAPP_BUSINESS_MANAGER_MESSAGING_LIMIT }}
+    field :whatsapp_manager_marketing_messages_max_price_enroll_status, 'string'
     has_no_delete
 
     has_edge :activities do |edge|
@@ -271,6 +277,7 @@ module FacebookAds
         api.has_param :is_primary_device_delivery_only, 'bool'
         api.has_param :language, 'string'
         api.has_param :library_template_body_inputs, 'hash'
+        api.has_param :library_template_body_param_inputs, { list: 'hash' }
         api.has_param :library_template_button_inputs, { list: 'hash' }
         api.has_param :library_template_name, 'string'
         api.has_param :message_send_ttl_seconds, 'int'

data/lib/facebook_ads/version.rb

@@ -7,6 +7,6 @@
 # FB:AUTOGEN
 
 module FacebookAds
-  VERSION = '25.0.3'
+  VERSION = '25.0.4'
   API_VERSION = '25.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: facebookbusiness
 version: !ruby/object:Gem::Version
-  version: 25.0.3
+  version: 25.0.4
 platform: ruby
 authors:
 - Facebook
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-08 00:00:00.000000000 Z
+date: 2026-07-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: capi_param_builder_ruby
@@ -298,6 +298,8 @@ files:
 - lib/facebook_ads/ad_objects/ad_account_default_objective.rb
 - lib/facebook_ads/ad_objects/ad_account_delivery_estimate.rb
 - lib/facebook_ads/ad_objects/ad_account_dsa_recommendations.rb
+- lib/facebook_ads/ad_objects/ad_account_feature_preferences.rb
+- lib/facebook_ads/ad_objects/ad_account_feature_preferences_post.rb
 - lib/facebook_ads/ad_objects/ad_account_ios_fourteen_campaign_limits.rb
 - lib/facebook_ads/ad_objects/ad_account_live_video_advertiser.rb
 - lib/facebook_ads/ad_objects/ad_account_marketing_messages_settings.rb
@@ -371,6 +373,7 @@ files:
 - lib/facebook_ads/ad_objects/ad_campaign_delivery_stats_get.rb
 - lib/facebook_ads/ad_objects/ad_campaign_delivery_stats_unsupported_reasons.rb
 - lib/facebook_ads/ad_objects/ad_campaign_frequency_control_specs.rb
+- lib/facebook_ads/ad_objects/ad_campaign_goal.rb
 - lib/facebook_ads/ad_objects/ad_campaign_group.rb
 - lib/facebook_ads/ad_objects/ad_campaign_group_advantage_state.rb
 - lib/facebook_ads/ad_objects/ad_campaign_group_agency_fee_config_for_api.rb
@@ -845,7 +848,6 @@ files:
 - lib/facebook_ads/ad_objects/ig_refresh_access_token_for_ig_only_api.rb
 - lib/facebook_ads/ad_objects/ig_resumable_video_upload_status.rb
 - lib/facebook_ads/ad_objects/ig_shopping_product_appeal.rb
-- lib/facebook_ads/ad_objects/ig_shopping_review_status.rb
 - lib/facebook_ads/ad_objects/ig_shopping_review_status_onsite_eligibility.rb
 - lib/facebook_ads/ad_objects/ig_shopping_review_status_reason_with_help_message.rb
 - lib/facebook_ads/ad_objects/ig_upcoming_event.rb