late-sdk 0.0.897 → 0.0.899

data/lib/zernio-sdk/models/ad_creative.rb

@@ -28,6 +28,11 @@ module Zernio
     # Public Facebook watch URL for VIDEO-type ads (https://www.facebook.com/watch/?v={videoId}). Null for non-video ads.
     attr_accessor :video_url
 
+    # Meta offer read from the live creative on creation or GET /v1/ads/{adId}. Null when metadata is not returned or cannot be read. Requested values are never echoed as applied.
+    attr_accessor :promotion
+
+    attr_accessor :promotion_status
+
     # Meta ad creative id backing this ad. Reusable via existingCreativeId on POST /v1/ads/create.
     attr_accessor :creative_id
 
@@ -82,6 +87,28 @@ module Zernio
 
     attr_accessor :pinterest_description
 
+    class EnumAttributeValidator
+      attr_reader :datatype
+      attr_reader :allowable_values
+
+      def initialize(datatype, allowable_values)
+        @allowable_values = allowable_values.map do |value|
+          case datatype.to_s
+          when /Integer/i
+            value.to_i
+          when /Float/i
+            value.to_f
+          else
+            value
+          end
+        end
+      end
+
+      def valid?(value)
+        !value || allowable_values.include?(value)
+      end
+    end
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
@@ -89,6 +116,8 @@ module Zernio
         :'image_url' => :'imageUrl',
         :'video_id' => :'videoId',
         :'video_url' => :'videoUrl',
+        :'promotion' => :'promotion',
+        :'promotion_status' => :'promotionStatus',
         :'creative_id' => :'creativeId',
         :'object_type' => :'objectType',
         :'object_story_id' => :'objectStoryId',
@@ -128,6 +157,8 @@ module Zernio
         :'image_url' => :'String',
         :'video_id' => :'String',
         :'video_url' => :'String',
+        :'promotion' => :'MetaPromotion',
+        :'promotion_status' => :'MetaPromotionStatus',
         :'creative_id' => :'String',
         :'object_type' => :'String',
         :'object_story_id' => :'String',
@@ -199,6 +230,14 @@ module Zernio
         self.video_url = attributes[:'video_url']
       end
 
+      if attributes.key?(:'promotion')
+        self.promotion = attributes[:'promotion']
+      end
+
+      if attributes.key?(:'promotion_status')
+        self.promotion_status = attributes[:'promotion_status']
+      end
+
       if attributes.key?(:'creative_id')
         self.creative_id = attributes[:'creative_id']
       end
@@ -304,6 +343,8 @@ module Zernio
           image_url == o.image_url &&
           video_id == o.video_id &&
           video_url == o.video_url &&
+          promotion == o.promotion &&
+          promotion_status == o.promotion_status &&
           creative_id == o.creative_id &&
           object_type == o.object_type &&
           object_story_id == o.object_story_id &&
@@ -334,7 +375,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [thumbnail_url, image_url, video_id, video_url, creative_id, object_type, object_story_id, effective_object_story_id, page_id, effective_instagram_media_id, instagram_user_id, instagram_permalink_url, media_urls, is_serving, serving_hold_reasons, body, google_headline, google_description, link_url, whatsapp_phone_number, pinterest_image_url, pinterest_title, pinterest_description].hash
+      [thumbnail_url, image_url, video_id, video_url, promotion, promotion_status, creative_id, object_type, object_story_id, effective_object_story_id, page_id, effective_instagram_media_id, instagram_user_id, instagram_permalink_url, media_urls, is_serving, serving_hold_reasons, body, google_headline, google_description, link_url, whatsapp_phone_number, pinterest_image_url, pinterest_title, pinterest_description].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/boost_post_request.rb

@@ -15,6 +15,9 @@ require 'time'
 
 module Zernio
   class BoostPostRequest < ApiModelBase
+    # Meta Advantage+ creative enhancements. Map snake_case feature names to OPT_IN or OPT_OUT; Meta validates supported keys and unspecified features default to OPT_OUT. auto_promotion_tag is an enhancement; use the separate promotion field for an explicit offer. The deprecated standard_enhancements bundle is rejected by Meta.
+    attr_accessor :creative_features
+
     # Zernio post ID (provide this or platformPostId)
     attr_accessor :post_id
 
@@ -130,6 +133,7 @@ module Zernio
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
+        :'creative_features' => :'creativeFeatures',
         :'post_id' => :'postId',
         :'platform_post_id' => :'platformPostId',
         :'account_id' => :'accountId',
@@ -178,6 +182,7 @@ module Zernio
     # Attribute type mapping.
     def self.openapi_types
       {
+        :'creative_features' => :'Hash<String, String>',
         :'post_id' => :'String',
         :'platform_post_id' => :'String',
         :'account_id' => :'String',
@@ -235,6 +240,12 @@ module Zernio
         h[k.to_sym] = v
       }
 
+      if attributes.key?(:'creative_features')
+        if (value = attributes[:'creative_features']).is_a?(Hash)
+          self.creative_features = value
+        end
+      end
+
       if attributes.key?(:'post_id')
         self.post_id = attributes[:'post_id']
       end
@@ -584,6 +595,7 @@ module Zernio
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
+          creative_features == o.creative_features &&
           post_id == o.post_id &&
           platform_post_id == o.platform_post_id &&
           account_id == o.account_id &&
@@ -627,7 +639,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [post_id, platform_post_id, account_id, ad_account_id, name, goal, ad_set_id, budget, instagram_account_id, destination_type, whatsapp_phone_number, currency, schedule, targeting, raw_targeting, bid_strategy, bid_amount, roas_average_floor, platform_specific_data, tracking, special_ad_categories, special_ad_category_country, regional_regulated_categories, regional_regulation_identities, link_url, call_to_action, spark_auth_code, dsa_beneficiary, dsa_payor, lead_gen_form_id, status, optimization_goal].hash
+      [creative_features, post_id, platform_post_id, account_id, ad_account_id, name, goal, ad_set_id, budget, instagram_account_id, destination_type, whatsapp_phone_number, currency, schedule, targeting, raw_targeting, bid_strategy, bid_amount, roas_average_floor, platform_specific_data, tracking, special_ad_categories, special_ad_category_country, regional_regulated_categories, regional_regulation_identities, link_url, call_to_action, spark_auth_code, dsa_beneficiary, dsa_payor, lead_gen_form_id, status, optimization_goal].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/create_ad_creative201_response.rb

@@ -20,11 +20,39 @@ module Zernio
     # Platform creative id, reusable via existingCreativeId.
     attr_accessor :creative_id
 
+    attr_accessor :promotion
+
+    attr_accessor :promotion_status
+
+    class EnumAttributeValidator
+      attr_reader :datatype
+      attr_reader :allowable_values
+
+      def initialize(datatype, allowable_values)
+        @allowable_values = allowable_values.map do |value|
+          case datatype.to_s
+          when /Integer/i
+            value.to_i
+          when /Float/i
+            value.to_f
+          else
+            value
+          end
+        end
+      end
+
+      def valid?(value)
+        !value || allowable_values.include?(value)
+      end
+    end
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'ad_account_id' => :'adAccountId',
-        :'creative_id' => :'creativeId'
+        :'creative_id' => :'creativeId',
+        :'promotion' => :'promotion',
+        :'promotion_status' => :'promotionStatus'
       }
     end
 
@@ -42,7 +70,9 @@ module Zernio
     def self.openapi_types
       {
         :'ad_account_id' => :'String',
-        :'creative_id' => :'String'
+        :'creative_id' => :'String',
+        :'promotion' => :'MetaPromotion',
+        :'promotion_status' => :'MetaPromotionStatus'
       }
     end
 
@@ -75,6 +105,14 @@ module Zernio
       if attributes.key?(:'creative_id')
         self.creative_id = attributes[:'creative_id']
       end
+
+      if attributes.key?(:'promotion')
+        self.promotion = attributes[:'promotion']
+      end
+
+      if attributes.key?(:'promotion_status')
+        self.promotion_status = attributes[:'promotion_status']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -98,7 +136,9 @@ module Zernio
       return true if self.equal?(o)
       self.class == o.class &&
           ad_account_id == o.ad_account_id &&
-          creative_id == o.creative_id
+          creative_id == o.creative_id &&
+          promotion == o.promotion &&
+          promotion_status == o.promotion_status
     end
 
     # @see the `==` method
@@ -110,7 +150,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [ad_account_id, creative_id].hash
+      [ad_account_id, creative_id, promotion, promotion_status].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/create_ad_creative_request.rb

@@ -45,7 +45,9 @@ module Zernio
     # Appended to every outbound URL (e.g. utm_source=fb).
     attr_accessor :url_tags
 
-    # Advantage+ creative enhancements: partial map of Meta creative feature keys (snake_case) to enroll status, forwarded as degrees_of_freedom_spec.creative_features_spec. Unspecified features default to OPT_OUT.
+    attr_accessor :promotion
+
+    # Meta only. Applied to each new creative, including standalone and attach shapes. With creatives[], these are defaults; an item replaces the whole feature map, including an empty map. auto_promotion_tag is an enhancement; an explicit offer uses promotion.
     attr_accessor :creative_features
 
     # Meta only. Multi-advertiser ads: whether Meta may show this ad alongside other advertisers' in one unit. Meta auto-enrols since Aug 2024, so send OPT_OUT to leave. It is a top-level creative field, NOT a `creativeFeatures` key, and Meta rejects it there.
@@ -87,6 +89,7 @@ module Zernio
         :'image_hash' => :'imageHash',
         :'carousel_cards' => :'carouselCards',
         :'url_tags' => :'urlTags',
+        :'promotion' => :'promotion',
         :'creative_features' => :'creativeFeatures',
         :'multi_advertiser' => :'multiAdvertiser'
       }
@@ -116,6 +119,7 @@ module Zernio
         :'image_hash' => :'String',
         :'carousel_cards' => :'Array<CreateAdCreativeRequestCarouselCardsInner>',
         :'url_tags' => :'String',
+        :'promotion' => :'MetaPromotion',
         :'creative_features' => :'Hash<String, String>',
         :'multi_advertiser' => :'String'
       }
@@ -201,6 +205,10 @@ module Zernio
         self.url_tags = attributes[:'url_tags']
       end
 
+      if attributes.key?(:'promotion')
+        self.promotion = attributes[:'promotion']
+      end
+
       if attributes.key?(:'creative_features')
         if (value = attributes[:'creative_features']).is_a?(Hash)
           self.creative_features = value
@@ -386,6 +394,7 @@ module Zernio
           image_hash == o.image_hash &&
           carousel_cards == o.carousel_cards &&
           url_tags == o.url_tags &&
+          promotion == o.promotion &&
           creative_features == o.creative_features &&
           multi_advertiser == o.multi_advertiser
     end
@@ -399,7 +408,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, ad_account_id, headline, body, description, call_to_action, link_url, image_url, image_hash, carousel_cards, url_tags, creative_features, multi_advertiser].hash
+      [account_id, ad_account_id, headline, body, description, call_to_action, link_url, image_url, image_hash, carousel_cards, url_tags, promotion, creative_features, multi_advertiser].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/create_call_ad_request.rb

@@ -15,6 +15,9 @@ require 'time'
 
 module Zernio
   class CreateCallAdRequest < ApiModelBase
+    # Meta enhancement settings for single or attached ads, and defaults for creatives[]. An item replaces the entire map, including with an empty object.
+    attr_accessor :creative_features
+
     # Facebook or Instagram SocialAccount ID.
     attr_accessor :account_id
 
@@ -157,6 +160,7 @@ module Zernio
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
+        :'creative_features' => :'creativeFeatures',
         :'account_id' => :'accountId',
         :'ad_account_id' => :'adAccountId',
         :'name' => :'name',
@@ -214,6 +218,7 @@ module Zernio
     # Attribute type mapping.
     def self.openapi_types
       {
+        :'creative_features' => :'Hash<String, String>',
         :'account_id' => :'String',
         :'ad_account_id' => :'String',
         :'name' => :'String',
@@ -287,6 +292,12 @@ module Zernio
         h[k.to_sym] = v
       }
 
+      if attributes.key?(:'creative_features')
+        if (value = attributes[:'creative_features']).is_a?(Hash)
+          self.creative_features = value
+        end
+      end
+
       if attributes.key?(:'account_id')
         self.account_id = attributes[:'account_id']
       else
@@ -925,6 +936,7 @@ module Zernio
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
+          creative_features == o.creative_features &&
           account_id == o.account_id &&
           ad_account_id == o.ad_account_id &&
           name == o.name &&
@@ -977,7 +989,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, ad_account_id, name, existing_post_id, object_story_id, whatsapp_phone_number, headline, body, image_url, video, welcome_message, creatives, ad_set_id, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, status, campaign_status, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor, regional_regulated_categories, regional_regulation_identities, phone_number, link_url].hash
+      [creative_features, account_id, ad_account_id, name, existing_post_id, object_story_id, whatsapp_phone_number, headline, body, image_url, video, welcome_message, creatives, ad_set_id, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, status, campaign_status, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor, regional_regulated_categories, regional_regulation_identities, phone_number, link_url].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/create_messaging_ad_request.rb

@@ -15,6 +15,9 @@ require 'time'
 
 module Zernio
   class CreateMessagingAdRequest < ApiModelBase
+    # Meta enhancement settings for single or attached ads, and defaults for creatives[]. An item replaces the entire map, including with an empty object.
+    attr_accessor :creative_features
+
     # Facebook or Instagram SocialAccount ID.
     attr_accessor :account_id
 
@@ -154,6 +157,7 @@ module Zernio
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
+        :'creative_features' => :'creativeFeatures',
         :'account_id' => :'accountId',
         :'ad_account_id' => :'adAccountId',
         :'name' => :'name',
@@ -210,6 +214,7 @@ module Zernio
     # Attribute type mapping.
     def self.openapi_types
       {
+        :'creative_features' => :'Hash<String, String>',
         :'account_id' => :'String',
         :'ad_account_id' => :'String',
         :'name' => :'String',
@@ -282,6 +287,12 @@ module Zernio
         h[k.to_sym] = v
       }
 
+      if attributes.key?(:'creative_features')
+        if (value = attributes[:'creative_features']).is_a?(Hash)
+          self.creative_features = value
+        end
+      end
+
       if attributes.key?(:'account_id')
         self.account_id = attributes[:'account_id']
       else
@@ -901,6 +912,7 @@ module Zernio
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
+          creative_features == o.creative_features &&
           account_id == o.account_id &&
           ad_account_id == o.ad_account_id &&
           name == o.name &&
@@ -952,7 +964,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, ad_account_id, name, existing_post_id, object_story_id, whatsapp_phone_number, headline, body, image_url, video, welcome_message, creatives, ad_set_id, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, status, campaign_status, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor, regional_regulated_categories, regional_regulation_identities, destination].hash
+      [creative_features, account_id, ad_account_id, name, existing_post_id, object_story_id, whatsapp_phone_number, headline, body, image_url, video, welcome_message, creatives, ad_set_id, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, status, campaign_status, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor, regional_regulated_categories, regional_regulation_identities, destination].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/create_standalone_ad_request.rb

@@ -47,7 +47,9 @@ module Zernio
     # Meta only. The RESERVED prediction id the R&F ad set runs on (reserving mints a new id, so pass that one). Requires buyingType RESERVED.
     attr_accessor :rf_prediction_id
 
-    # Meta only. Advantage+ creative enhancements: a partial map of Meta creative feature keys (snake_case, e.g. enhance_cta, image_brightness_and_contrast, text_optimizations) to enroll status, forwarded as degrees_of_freedom_spec.creative_features_spec. Meta validates the keys; unspecified features default to OPT_OUT. The legacy standard_enhancements bundle is deprecated by Meta and rejected.
+    attr_accessor :promotion
+
+    # Meta only. Applied to each new creative, including standalone and attach shapes. With creatives[], these are defaults; an item replaces the whole feature map, including an empty map. auto_promotion_tag is an enhancement; an explicit offer uses promotion.
     attr_accessor :creative_features
 
     # Meta only. Multi-advertiser ads: whether Meta may show this ad alongside other advertisers' in one unit. Meta auto-enrols since Aug 2024, so send OPT_OUT to leave. It is a top-level creative field, NOT a `creativeFeatures` key, and Meta rejects it there.
@@ -114,7 +116,7 @@ module Zernio
     # Meta-only. When present, switches to the multi-creative shape: creates 1 campaign + 1 ad set + N ads (one per entry here). Top-level `headline` / `body` / `imageUrl` / `linkUrl` / `callToAction` are ignored in this mode. Mutually exclusive with `adSetId`. 
     attr_accessor :creatives
 
-    # When present, switches to the attach shape: adds one new ad to this existing ad set without creating a new campaign. Budget, targeting, goal, schedule, AND bid strategy are inherited from the ad set on Meta, and passing `bidStrategy` in attach mode returns 400. To change an existing ad set's bid, use `PUT /v1/ads/ad-sets/{adSetId}`. Mutually exclusive with `creatives[]`.  The attached ad takes the full single-creative surface: `headline`/`body`/`description`/`callToAction` plus either `imageUrl`/`video` OR `placementAssets` (its own per-placement Feed/Story assets) OR `translations`/`defaultLocale` (its own per-locale asset feed, Meta only), and `leadGenFormId` when the target is a lead ad set (the parent must be ON_AD, true for ad sets created via goal `lead_generation`; Meta rejects a formless ad there, so pass the form on EVERY attached ad). This is the way to build N full ads sharing one ad set: create the first ad via the normal shape, then attach the rest one call each.  Supported on Meta (facebook, instagram), Google Ads, TikTok, and LinkedIn. On TikTok the `adSetId` is the ad group ID; the new ad inherits the ad group's bid + budget + targeting. On LinkedIn the `adSetId` is the LinkedIn Campaign ID (numeric); we attach a new Creative to that Campaign, so the Campaign's `platformSpecificData` bidding, targeting, budget and schedule are inherited (passing those fields returns 400).  On Google Ads the `adSetId` is the AD GROUP id. `goal` is still REQUIRED even though budget and targeting are inherited from the ad group. Send `campaignType: \"search\"` to attach into a Search ad group, including one created by `POST /v1/ads/ad-sets` (always SEARCH_STANDARD): without it the request is treated as Display and requires `images.landscape` + `images.square` + `businessName`, and the resulting display creative does not match a Search ad group. `budgetAmount`/`budgetType` and bidding fields (`bidStrategy`, `bidAmount`, `portfolioBidStrategyId`) return 400 on this shape; the ad group already owns them. 
+    # When present, switches to the attach shape: adds one new ad to this existing ad set without creating a new campaign. Budget, targeting, goal, schedule, AND bid strategy are inherited from the ad set on Meta, and passing `bidStrategy` in attach mode returns 400. To change an existing ad set's bid, use `PUT /v1/ads/ad-sets/{adSetId}`. Mutually exclusive with `creatives[]`. `dynamicCreative` returns 400 in attach mode: create a new dynamic ad set by omitting `adSetId` instead.  The attached ad takes the full single-creative surface: `headline`/`body`/`description`/`callToAction` plus either `imageUrl`/`video` OR `placementAssets` (its own per-placement Feed/Story assets) OR `translations`/`defaultLocale` (its own per-locale asset feed, Meta only), and `leadGenFormId` when the target is a lead ad set (the parent must be ON_AD, true for ad sets created via goal `lead_generation`; Meta rejects a formless ad there, so pass the form on EVERY attached ad). This is the way to build N full ads sharing one ad set: create the first ad via the normal shape, then attach the rest one call each.  Supported on Meta (facebook, instagram), Google Ads, TikTok, and LinkedIn. On TikTok the `adSetId` is the ad group ID; the new ad inherits the ad group's bid + budget + targeting. On LinkedIn the `adSetId` is the LinkedIn Campaign ID (numeric); we attach a new Creative to that Campaign, so the Campaign's `platformSpecificData` bidding, targeting, budget and schedule are inherited (passing those fields returns 400).  On Google Ads the `adSetId` is the AD GROUP id. `goal` is still REQUIRED even though budget and targeting are inherited from the ad group. Send `campaignType: \"search\"` to attach into a Search ad group, including one created by `POST /v1/ads/ad-sets` (always SEARCH_STANDARD): without it the request is treated as Display and requires `images.landscape` + `images.square` + `businessName`, and the resulting display creative does not match a Search ad group. `budgetAmount`/`budgetType` and bidding fields (`bidStrategy`, `bidAmount`, `portfolioBidStrategyId`) return 400 on this shape; the ad group already owns them. 
     attr_accessor :ad_set_id
 
     # Meta, Google Ads, and LinkedIn. On Meta: add the new ad set under this EXISTING campaign instead of creating a new one (multi-ad-set audience testing). The new ad set's budget is matched to the campaign's mode automatically: for a CBO campaign (campaign-level budget) omit `budgetAmount`/`budgetType`, since the campaign owns the budget; for an ABO campaign pass them (they go on the new ad set). On LinkedIn: create a new Campaign (and its Creative) under this EXISTING CampaignGroup. On Google Ads: create a new ad group under this EXISTING campaign; the new ad group inherits the campaign's budget, so omit `budgetAmount`/`budgetType` (and any bidding field), or the request returns 400. On failure only the entities we authored are cleaned up; the pre-existing parent is left untouched and is never (re)activated. Mutually exclusive with `adSetId` and `creatives[]`. 
@@ -332,6 +334,7 @@ module Zernio
         :'billing_event' => :'billingEvent',
         :'buying_type' => :'buyingType',
         :'rf_prediction_id' => :'rfPredictionId',
+        :'promotion' => :'promotion',
         :'creative_features' => :'creativeFeatures',
         :'multi_advertiser' => :'multiAdvertiser',
         :'validate_only' => :'validateOnly',
@@ -446,6 +449,7 @@ module Zernio
         :'billing_event' => :'String',
         :'buying_type' => :'String',
         :'rf_prediction_id' => :'String',
+        :'promotion' => :'MetaPromotion',
         :'creative_features' => :'Hash<String, String>',
         :'multi_advertiser' => :'String',
         :'validate_only' => :'Boolean',
@@ -611,6 +615,10 @@ module Zernio
         self.rf_prediction_id = attributes[:'rf_prediction_id']
       end
 
+      if attributes.key?(:'promotion')
+        self.promotion = attributes[:'promotion']
+      end
+
       if attributes.key?(:'creative_features')
         if (value = attributes[:'creative_features']).is_a?(Hash)
           self.creative_features = value
@@ -1876,6 +1884,7 @@ module Zernio
           billing_event == o.billing_event &&
           buying_type == o.buying_type &&
           rf_prediction_id == o.rf_prediction_id &&
+          promotion == o.promotion &&
           creative_features == o.creative_features &&
           multi_advertiser == o.multi_advertiser &&
           validate_only == o.validate_only &&
@@ -1973,7 +1982,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, ad_account_id, name, campaign_name, ad_set_name, ad_name, tracking, goal, optimization_goal, billing_event, buying_type, rf_prediction_id, creative_features, multi_advertiser, validate_only, budget_amount, budget_type, status, campaign_status, budget_level, currency, headline, long_headline, body, description, bodies, headlines, descriptions, call_to_action, link_url, lead_gen_form_id, image_url, images, video, creatives, ad_set_id, existing_campaign_id, existing_creative_id, business_name, board_id, organization_id, targeting, countries, cities, regions, age_min, age_max, interests, zips, metros, custom_locations, behaviors, work_positions, work_employers, work_industries, income_tier, languages, placements, saved_targeting_id, raw_targeting, special_ad_categories, special_ad_category_country, regional_regulated_categories, regional_regulation_identities, end_date, start_date, instagram_account_id, dynamic_creative, carousel_cards, default_locale, translations, placement_assets, audience_id, campaign_type, keywords, negative_keywords, campaign_negative_keywords, additional_headlines, additional_descriptions, sitelinks, callouts, structured_snippets, advantage_audience, attribution_spec, gender, bid_strategy, bid_amount, roas_average_floor, portfolio_bid_strategy_id, value_rule_set_id, value_rules_applied, platform_specific_data, dsa_beneficiary, dsa_payor, brand_identity, identity_type, smart_plus, promoted_object].hash
+      [account_id, ad_account_id, name, campaign_name, ad_set_name, ad_name, tracking, goal, optimization_goal, billing_event, buying_type, rf_prediction_id, promotion, creative_features, multi_advertiser, validate_only, budget_amount, budget_type, status, campaign_status, budget_level, currency, headline, long_headline, body, description, bodies, headlines, descriptions, call_to_action, link_url, lead_gen_form_id, image_url, images, video, creatives, ad_set_id, existing_campaign_id, existing_creative_id, business_name, board_id, organization_id, targeting, countries, cities, regions, age_min, age_max, interests, zips, metros, custom_locations, behaviors, work_positions, work_employers, work_industries, income_tier, languages, placements, saved_targeting_id, raw_targeting, special_ad_categories, special_ad_category_country, regional_regulated_categories, regional_regulation_identities, end_date, start_date, instagram_account_id, dynamic_creative, carousel_cards, default_locale, translations, placement_assets, audience_id, campaign_type, keywords, negative_keywords, campaign_negative_keywords, additional_headlines, additional_descriptions, sitelinks, callouts, structured_snippets, advantage_audience, attribution_spec, gender, bid_strategy, bid_amount, roas_average_floor, portfolio_bid_strategy_id, value_rule_set_id, value_rules_applied, platform_specific_data, dsa_beneficiary, dsa_payor, brand_identity, identity_type, smart_plus, promoted_object].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/create_standalone_ad_request_creatives_inner.rb

@@ -16,6 +16,12 @@ require 'time'
 module Zernio
   # Each creative must supply EXACTLY ONE of `imageUrl` (image creative) or `video` (video creative).
   class CreateStandaloneAdRequestCreativesInner < ApiModelBase
+    # Overrides the top-level offer for this item. Omit to inherit; null disables the inherited offer.
+    attr_accessor :promotion
+
+    # Replaces the entire top-level creativeFeatures map for this item. Omit to inherit; an empty map clears these defaults.
+    attr_accessor :creative_features
+
     # Exact name for this ad. Falls back to `<name> #N` (N = 1-based position).
     attr_accessor :name
 
@@ -60,6 +66,8 @@ module Zernio
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
+        :'promotion' => :'promotion',
+        :'creative_features' => :'creativeFeatures',
         :'name' => :'name',
         :'headline' => :'headline',
         :'body' => :'body',
@@ -84,6 +92,8 @@ module Zernio
     # Attribute type mapping.
     def self.openapi_types
       {
+        :'promotion' => :'MetaPromotion',
+        :'creative_features' => :'Hash<String, String>',
         :'name' => :'String',
         :'headline' => :'String',
         :'body' => :'String',
@@ -117,6 +127,16 @@ module Zernio
         h[k.to_sym] = v
       }
 
+      if attributes.key?(:'promotion')
+        self.promotion = attributes[:'promotion']
+      end
+
+      if attributes.key?(:'creative_features')
+        if (value = attributes[:'creative_features']).is_a?(Hash)
+          self.creative_features = value
+        end
+      end
+
       if attributes.key?(:'name')
         self.name = attributes[:'name']
       end
@@ -287,6 +307,8 @@ module Zernio
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
+          promotion == o.promotion &&
+          creative_features == o.creative_features &&
           name == o.name &&
           headline == o.headline &&
           body == o.body &&
@@ -306,7 +328,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [name, headline, body, description, image_url, video, link_url, call_to_action].hash
+      [promotion, creative_features, name, headline, body, description, image_url, video, link_url, call_to_action].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/create_standalone_ad_request_dynamic_creative.rb

@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module Zernio
-  # Meta only. Dynamic Creative: supply a POOL of assets and Meta auto-combines and optimises them into the best-performing variations within a single ad (mapped to the creative's `asset_feed_spec`). When set, the top-level single-creative fields (`imageUrl`, `headline`, `body`, `linkUrl`, `callToAction`) are ignored. Mutually exclusive with the `creatives[]` multi-creative shape. Exactly ONE of `imageUrls` / `videoUrls` is required (Meta allows one ad format per asset feed; sending both → 400). Meta limits: ≤10 images or ≤10 videos, ≤5 bodies / titles / descriptions. 
+  # Meta only. Dynamic Creative: supply a POOL of assets and Meta auto-combines and optimises them into the best-performing variations within a single ad (mapped to the creative's `asset_feed_spec`). When set, the top-level single-creative fields (`imageUrl`, `headline`, `body`, `linkUrl`, `callToAction`) are ignored. Mutually exclusive with the `creatives[]` multi-creative shape. Exactly ONE of `imageUrls` / `videoUrls` is required (Meta allows one ad format per asset feed; sending both → 400). Limits remain 10 images or videos and 5 bodies, titles or descriptions. The ad set is created with `is_dynamic_creative: true`. Combining this field with `adSetId` returns 400: omit `adSetId` to create a new dynamic ad set. Multiple headlines go in `titles`; multiple primary texts go in `bodies`. 
   class CreateStandaloneAdRequestDynamicCreative < ApiModelBase
     # Pool of image URLs (1-10). Uploaded to the ad account and referenced by hash in the asset feed. Mutually exclusive with `videoUrls`.
     attr_accessor :image_urls

data/lib/zernio-sdk/models/create_standalone_ad_request_promoted_object.rb

@@ -37,10 +37,10 @@ module Zernio
     # Custom Conversion ID, when optimising against one instead of a standard event. Accepted alone by this API, without `pixelId` or `customEventType`. If `pixelId` is also sent, `customEventType` is still required on the promoted_object (Meta rejects `pixel_id` without `custom_event_type`, error_subcode 1885014). 
     attr_accessor :custom_conversion_id
 
-    # Catalog ID for catalog/Advantage+ Shopping campaigns.
+    # Optional catalog ID. If supplied with productSetId, the set must belong to this catalog. A catalog ID cannot replace productSetId.
     attr_accessor :product_catalog_id
 
-    # Product Set ID inside the catalog.
+    # Meta product SET ID from GET /v1/ads/catalogs/{catalogId}/product-sets. Zernio checks that the token can read the set and its product_catalog before creation. A catalog ID or inaccessible set returns a precise 400 naming promotedObject.productSetId. A mismatch with productCatalogId names promotedObject.productCatalogId.
     attr_accessor :product_set_id
 
     # Meta only. Offline event set (dataset) to optimise toward. Post-merger these are datasets: the id is the dataset id (for pixel-backed datasets, the pixel id).

data/lib/zernio-sdk/models/ctwa_ad_request_body.rb

@@ -16,6 +16,9 @@ require 'time'
 module Zernio
   # In addition to the `required` list, the request must use EXACTLY ONE of the two shapes:  - Single-creative: `headline`, `body`, and one of `imageUrl` / `video`,   OR `existingPostId` / `objectStoryId` to reuse an organic post. - Multi-creative: a non-empty `creatives[]` array. Top-level   creative fields must NOT be set on this shape.  Existing post references work on messaging and CTWA only (not call ads). They cannot be combined with each other or with headline, body, imageUrl, video, or welcomeMessage. No media is uploaded and the organic post is retained. Fresh creatives still require headline, body, and image or video.  The route enforces this at the Zod boundary; OpenAPI's `required` cannot express the OR cleanly. 
   class CtwaAdRequestBody < ApiModelBase
+    # Meta enhancement settings for single or attached ads, and defaults for creatives[]. An item replaces the entire map, including with an empty object.
+    attr_accessor :creative_features
+
     # Facebook or Instagram SocialAccount ID.
     attr_accessor :account_id
 
@@ -152,6 +155,7 @@ module Zernio
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
+        :'creative_features' => :'creativeFeatures',
         :'account_id' => :'accountId',
         :'ad_account_id' => :'adAccountId',
         :'name' => :'name',
@@ -207,6 +211,7 @@ module Zernio
     # Attribute type mapping.
     def self.openapi_types
       {
+        :'creative_features' => :'Hash<String, String>',
         :'account_id' => :'String',
         :'ad_account_id' => :'String',
         :'name' => :'String',
@@ -271,6 +276,12 @@ module Zernio
         h[k.to_sym] = v
       }
 
+      if attributes.key?(:'creative_features')
+        if (value = attributes[:'creative_features']).is_a?(Hash)
+          self.creative_features = value
+        end
+      end
+
       if attributes.key?(:'account_id')
         self.account_id = attributes[:'account_id']
       else
@@ -867,6 +878,7 @@ module Zernio
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
+          creative_features == o.creative_features &&
           account_id == o.account_id &&
           ad_account_id == o.ad_account_id &&
           name == o.name &&
@@ -917,7 +929,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, ad_account_id, name, existing_post_id, object_story_id, whatsapp_phone_number, headline, body, image_url, video, welcome_message, creatives, ad_set_id, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, status, campaign_status, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor, regional_regulated_categories, regional_regulation_identities].hash
+      [creative_features, account_id, ad_account_id, name, existing_post_id, object_story_id, whatsapp_phone_number, headline, body, image_url, video, welcome_message, creatives, ad_set_id, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, status, campaign_status, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor, regional_regulated_categories, regional_regulation_identities].hash
     end
 
     # Builds the object from hash