facebookbusiness 25.0.3 → 26.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a10e421eaa016e4fd2ba9b81ea6a2e6894db11cc6a25ed1d6ac3e360694efb0a
-  data.tar.gz: bd1178acf2856eacab6143bfe998b87fcc03678486a001b8f7ea663f14300f2c
+  metadata.gz: '02592592c6b10e463bb2f21fe2b2a143088fbce2d718535df1021c0451f5a398'
+  data.tar.gz: e739ed3b1a92b1a32ba02810cf83c84e927c73f4f5cbfcf2f6570056b62ec9ef
 SHA512:
-  metadata.gz: c319d0bda77716e2f857f684408cbc28f8ff566de91109dec1fff9fd73f950efb305c0607d4db2735d22a2d18064fa87c1162d074cbcfcfafbbd258dd33be926
-  data.tar.gz: 435ba7bdc74c109906f91989f9db7c124488890179e7f6afb099715112188dc465069bcca592f980d6c51f59c4a38e635244e60ef0cea75ffbfb3bda9c29d2c5
+  metadata.gz: 4a82a4b120f8b23dc8b829d7d4139c3cc0185175cf9daa19bb668ece7b7d4f6d25f133626d3595a0061166d7a66c54653c868e8fd944fcbbecf307c5a282951b
+  data.tar.gz: 9dab08b13effeac1ce6d062635794f75bf0c860d07e976f9182f3fde190f2202bca6141927a5be1c3b7d2e82f32d47eeb5963e214a993d5c8acff21e37f03b6f

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.rb

@@ -135,6 +135,7 @@ module FacebookAds
     field :updated_time, 'datetime'
     field :adset_spec, 'AdSet'
     field :audience_id, 'string'
+    field :dataset_split_specs, { list: 'hash' }
     field :date_format, 'string'
     field :draft_adgroup_id, 'string'
     field :execution_options, { list: { enum: -> { EXECUTION_OPTIONS }} }

data/lib/facebook_ads/ad_objects/ad_account.rb

@@ -98,6 +98,7 @@ module FacebookAds
       "FEED_DNM",
       "FEED_NESTED_DNM",
       "FEED_RELAXED",
+      "FEED_SELECT",
       "FEED_STANDARD",
       "FEED_STRICT",
       "UNINITIALIZED",
@@ -242,6 +243,7 @@ module FacebookAds
       edge.post 'AdAccountBusinessConstraints' do |api|
         api.has_param :audience_controls, 'object'
         api.has_param :placement_controls, 'object'
+        api.has_param :placement_controls_per_objective, 'object'
       end
     end
 
@@ -451,6 +453,7 @@ module FacebookAds
         api.has_param :creative, 'AdCreative'
         api.has_param :creative_asset_groups_spec, 'object'
         api.has_param :creative_automation_spec, 'object'
+        api.has_param :dataset_split_specs, { list: 'hash' }
         api.has_param :date_format, 'string'
         api.has_param :display_sequence, 'int'
         api.has_param :draft_adgroup_id, 'string'
@@ -500,6 +503,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 +514,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 +543,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'
@@ -647,6 +653,7 @@ module FacebookAds
         api.has_param :initial_heading, 'int'
         api.has_param :initial_pitch, 'int'
         api.has_param :instant_game_entry_point_data, 'string'
+        api.has_param :is_ai_generated, 'bool'
         api.has_param :is_boost_intended, 'bool'
         api.has_param :is_group_linking_post, 'bool'
         api.has_param :is_partnership_ad, 'bool'
@@ -1061,12 +1068,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
 
@@ -1346,6 +1353,7 @@ module FacebookAds
       end
       edge.post 'AdVideo' do |api|
         api.has_param :description, 'string'
+        api.has_param :is_ai_generated, 'bool'
         api.has_param :privacy, 'string'
         api.has_param :title, 'string'
         api.has_param :upload_phase, { enum: -> { AdVideo::UPLOAD_PHASE }}

data/lib/facebook_ads/ad_objects/ad_account_ad_volume.rb

@@ -24,6 +24,7 @@ module FacebookAds
       "ACO_TOGGLE",
       "ADD_FUNDS_TO_RUN_CAMPAIGN",
       "ADOPT_CATALOG_TO_RUN_PRODUCT_CENTRIC_ADS",
+      "ADOPT_CLICK_TO_FLOWS",
       "ADOPT_CREATIVE_AUDIENCE_PAIRING",
       "ADOPT_CREATIVE_MEDIA_SOURCING_BUNDLE",
       "ADOPT_CTX_RECOMMENDED_TEMPLATE_BUNDLE",
@@ -149,6 +150,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",
@@ -165,6 +167,8 @@ module FacebookAds
       "CONVERSION_LEADS_OPTIMIZATION_V2",
       "CONVERSION_LEAD_ADS",
       "CONVERT_APP_WEB_FALLBACK_TO_A_DESTINATION",
+      "CONVERT_CTX_REPLIES_TO_CTX_LEADS",
+      "CONVERT_CTX_REPLIES_TO_CTX_PURCHASE",
       "CONVERT_IG_PROFILE_VISIT_TO_PTWA",
       "COST_GOAL",
       "COST_GOAL_BUDGET_LIMITED",
@@ -311,6 +315,7 @@ module FacebookAds
       "OPTIMAL_BAU",
       "OPT_INTO_CHAT_ON_WHATSAPP_POST_LEAD",
       "OPT_INTO_NUDGE_FOLLOW_UP_MESSAGES_CTM",
+      "OPT_INTO_REELS_GEN_AI_VIDEO_EXPANSION",
       "OPT_INTO_SINGLE_MEDIA_TO_COLLECTION_ADS",
       "OUTCOME_FORECASTER_BID_RECOMMENDATION",
       "OUTCOME_FORECASTER_BUDGET_RECOMMENDATION",

data/lib/facebook_ads/ad_objects/ad_account_business_constraints.rb

@@ -25,6 +25,7 @@ module FacebookAds
     field :campaigns_with_error, { list: 'string' }
     field :is_age_restriction_enabled, 'bool'
     field :placement_controls, 'object'
+    field :placement_controls_per_objective, 'object'
     field :status, { enum: -> { STATUS }}
     has_no_id
     has_no_get

data/lib/facebook_ads/ad_objects/ad_account_delivery_estimate.rb

@@ -51,8 +51,6 @@ module FacebookAds
     ]
 
 
-    field :daily_outcomes_curve, { list: 'OutcomePredictionPoint' }
-    field :estimate_dau, 'int'
     field :estimate_mau_lower_bound, 'int'
     field :estimate_mau_upper_bound, 'int'
     field :estimate_ready, 'bool'

data/lib/facebook_ads/ad_objects/ad_account_insights_feature_settings.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 AdAccountInsightsFeatureSettings < AdObject
+
+    field :id, 'string'
+    has_no_get
+    has_no_post
+    has_no_delete
+
+    has_edge :insights&#x2F;feature-settings&#x2F;list-features do |edge|
+      edge.get 'AdAccountInsightsFeatureSettingsListFeatures' do |api|
+        api.has_param :after, 'string'
+        api.has_param :before, 'string'
+        api.has_param :limit, 'int'
+      end
+    end
+
+    has_edge :insights&#x2F;feature-settings do |edge|
+      edge.post 'AdAccountInsightsFeatureSettingsPost'
+    end
+
+  end
+end

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

@@ -13,11 +13,10 @@ 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 AdAccountInsightsFeatureSettingsListFeatures < AdObject
 
-    field :onsite_eligibility, 'IgShoppingReviewStatusOnsiteEligibility'
-    field :reasons, { list: 'IgShoppingReviewStatusReasonWithHelpMessage' }
-    field :status, 'string'
+    field :data, { list: 'object' }
+    field :paging, 'object'
     has_no_id
     has_no_get
     has_no_post

data/lib/facebook_ads/ad_objects/ad_account_insights_feature_settings_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 AdAccountInsightsFeatureSettingsPost < 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_delivery_estimate.rb

@@ -51,8 +51,6 @@ module FacebookAds
     ]
 
 
-    field :daily_outcomes_curve, { list: 'OutcomePredictionPoint' }
-    field :estimate_dau, 'int'
     field :estimate_mau_lower_bound, 'int'
     field :estimate_mau_upper_bound, 'int'
     field :estimate_ready, 'bool'

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_media_sourcing_spec.rb

@@ -17,6 +17,7 @@ module FacebookAds
 
     field :bodies, { list: 'object' }
     field :descriptions, { list: 'object' }
+    field :destinations, { list: 'object' }
     field :images, { list: 'object' }
     field :push_metadata_ids, { list: 'string' }
     field :related_media, 'object'

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,8 +252,10 @@ module FacebookAds
 
 
     field :account_id, 'string'
+    field :ad_set_goal, 'AdCampaignGoal'
     field :adlabels, { list: 'AdLabel' }
     field :adset_schedule, { list: 'DayPart' }
+    field :anchor_event_attribution_window_days, 'int'
     field :asset_feed_id, 'string'
     field :attribution_count_type, 'string'
     field :attribution_spec, { list: 'AttributionSpec' }
@@ -293,6 +298,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/ad_video.rb

@@ -345,6 +345,7 @@ module FacebookAds
     field :initial_heading, 'int'
     field :initial_pitch, 'int'
     field :instant_game_entry_point_data, 'string'
+    field :is_ai_generated, 'bool'
     field :is_boost_intended, 'bool'
     field :is_group_linking_post, 'bool'
     field :is_partnership_ad, 'bool'

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'
@@ -323,6 +332,7 @@ module FacebookAds
     field :inline_link_click_ctr, 'string'
     field :inline_link_clicks, 'string'
     field :inline_post_engagement, 'string'
+    field :instagram_profile_follow, 'string'
     field :instagram_profile_visits, 'string'
     field :instagram_upcoming_event_reminders_set, 'string'
     field :instant_experience_clicks_to_open, 'string'
@@ -352,10 +362,6 @@ module FacebookAds
     field :marketing_messages_sent, 'string'
     field :marketing_messages_spend, 'string'
     field :marketing_messages_spend_currency, 'string'
-    field :marketing_messages_website_add_to_cart, 'string'
-    field :marketing_messages_website_initiate_checkout, 'string'
-    field :marketing_messages_website_purchase, 'string'
-    field :marketing_messages_website_purchase_values, 'string'
     field :messages_delivered, 'string'
     field :messages_delivered_ctr, 'string'
     field :mobile_app_purchase_roas, { list: 'AdsActionStats' }
@@ -369,6 +375,8 @@ module FacebookAds
     field :outbound_clicks, { list: 'AdsActionStats' }
     field :outbound_clicks_ctr, { list: 'AdsActionStats' }
     field :place_page_name, 'string'
+    field :playable_average_game_length, 'string'
+    field :playable_game_start_rate, 'string'
     field :product_group_retailer_id, 'string'
     field :product_retailer_id, 'string'
     field :product_views, 'string'
@@ -382,7 +390,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/application.rb

@@ -258,6 +258,9 @@ module FacebookAds
         api.has_param :installer_package, 'string'
         api.has_param :is_circuit_breaker_active, 'bool'
         api.has_param :is_fb, 'bool'
+        api.has_param :is_redownload, 'bool'
+        api.has_param :last_new_install_time, 'int'
+        api.has_param :last_session_time, 'int'
         api.has_param :limited_data_use, 'bool'
         api.has_param :meta_install_referrer, 'string'
         api.has_param :migration_bundle, '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/audio_visual_reference_match.rb

@@ -32,13 +32,13 @@ module FacebookAds
     field :match_state, 'string'
     field :matched_overlap_percentage, 'double'
     field :matched_owner_match_duration_in_sec, 'double'
-    field :matched_reference_owner, 'Profile'
+    field :matched_reference_owner_v2, 'object'
     field :modification_history, { list: 'object' }
     field :num_matches_on_matched_side, 'int'
     field :num_matches_on_ref_side, 'int'
     field :ref_owner_match_duration_in_sec, 'double'
     field :reference_overlap_percentage, 'double'
-    field :reference_owner, 'Profile'
+    field :reference_owner_v2, 'object'
     field :rejection_form_data_entries_with_translations, { list: 'object' }
     field :resolution_details, 'string'
     field :resolution_reason, 'string'

data/lib/facebook_ads/ad_objects/brand_safety_campaign_config.rb

@@ -16,6 +16,9 @@ module FacebookAds
   class BrandSafetyCampaignConfig < AdObject
 
     field :comment_moderation_filter, 'string'
+    field :fb_comment_moderation_filter, 'string'
+    field :ig_comment_moderation_filter, 'string'
+    field :threads_comment_moderation_filter, 'string'
     has_no_id
     has_no_get
     has_no_post