late-sdk 0.0.627 → 0.0.629

data/openapi.yaml

@@ -6536,8 +6536,8 @@ components:
         cpm: { type: number, description: Cost per 1000 impressions }
         engagement: { type: integer }
         conversions:
-          type: integer
-          description: "Count of conversion events over the requested date range. Meta: events matching the campaign's promoted_object.custom_event_type (PURCHASE, LEAD, etc.). Google: the account's tracked conversions. X and LinkedIn: their reported website/lead conversions (added 2026-07). 0 for non-conversion campaigns or when no events have fired."
+          type: number
+          description: "Count of conversion events over the requested date range. FRACTIONAL: attribution splits one conversion across touchpoints and Google additionally reports modeled conversions, so values like 0.347 are normal. Meta: events matching the campaign's promoted_object.custom_event_type (PURCHASE, LEAD, etc.). Google: the account's tracked conversions. X and LinkedIn: their reported website/lead conversions (added 2026-07). 0 for non-conversion campaigns or when no events have fired."
         costPerConversion:
           type: number
           description: "Derived spend / conversions in the same currency as spend. 0 when conversions is 0."
@@ -6772,7 +6772,7 @@ components:
                   address: { type: string, description: "Optional label, sent to Meta as `address_string`. latitude/longitude take precedence for the pin location." }
         ageMin: { type: integer, minimum: 13, maximum: 100 }
         ageMax: { type: integer, minimum: 13, maximum: 100 }
-        gender: { type: string, enum: [all, male, female], description: "Restrict by gender. 'all' (default) targets everyone." }
+        gender: { type: string, enum: [all, male, female], description: "Restrict by gender. 'all' (default) targets everyone. Applied on Meta, TikTok and Pinterest. Ignored on Google, LinkedIn and X." }
         incomeTier:
           type: string
           enum: [top_5, top_10, top_10_25, top_25_50]
@@ -34914,8 +34914,21 @@ paths:
         (CBO) by definition; omit it for ABO (each ad set carries its own budget). Created
         `PAUSED` unless `status: ACTIVE`. The campaign materializes in `/v1/ads/tree` via the
         next sync discovery pass.
+
+        **Idempotency:** send an `Idempotency-Key` header to make retries safe.
       security:
         - bearerAuth: []
+      parameters:
+        - name: Idempotency-Key
+          in: header
+          required: false
+          schema: { type: string, maxLength: 255 }
+          description: >-
+            Optional client-generated unique key (e.g. a UUID) that makes
+            retries safe. Same key + same body replays the original response;
+            same key + different body → 422; key still processing → 409. Only
+            2xx responses are stored, so a request that failed with a 4xx can
+            be retried with a corrected body under the SAME key.
       requestBody:
         required: true
         content:
@@ -34937,6 +34950,12 @@ paths:
                 budgetAmount: { type: number, description: "Campaign-level (CBO) budget in whole currency units. Requires budgetType." }
                 budgetType: { type: string, enum: [daily, lifetime] }
                 status: { type: string, enum: [ACTIVE, PAUSED], default: PAUSED }
+                bidStrategy:
+                  type: string
+                  enum: [LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS]
+                  description: "Campaign bid strategy. Meta puts `bid_strategy` where the budget lives, so this applies only alongside a campaign budget (CBO). Previously settable only via `PUT /v1/ads/campaigns/{campaignId}`."
+                bidAmount: { type: number, description: "Whole currency units (USD: 5 = $5.00). Required for LOWEST_COST_WITH_BID_CAP and COST_CAP; ignored otherwise." }
+                roasAverageFloor: { type: number, description: "Decimal ROAS multiplier (2.0 = 2.0x). Required for LOWEST_COST_WITH_MIN_ROAS." }
       responses:
         '201':
           description: Campaign created
@@ -35198,6 +35217,16 @@ paths:
       security:
         - bearerAuth: []
       parameters:
+        - name: Idempotency-Key
+          in: header
+          required: false
+          schema: { type: string, maxLength: 255 }
+          description: >-
+            Optional client-generated unique key (e.g. a UUID) that makes
+            retries safe. Same key + same body replays the original response;
+            same key + different body → 422; key still processing → 409. Only
+            2xx responses are stored, so a request that failed with a 4xx can
+            be retried with a corrected body under the SAME key.
         - { name: campaignId, in: path, required: true, schema: { type: string }, description: Source platform campaign ID }
       requestBody:
         required: true
@@ -35260,6 +35289,16 @@ paths:
       security:
         - bearerAuth: []
       parameters:
+        - name: Idempotency-Key
+          in: header
+          required: false
+          schema: { type: string, maxLength: 255 }
+          description: >-
+            Optional client-generated unique key (e.g. a UUID) that makes
+            retries safe. Same key + same body replays the original response;
+            same key + different body → 422; key still processing → 409. Only
+            2xx responses are stored, so a request that failed with a 4xx can
+            be retried with a corrected body under the SAME key.
         - { name: adSetId, in: path, required: true, schema: { type: string }, description: Source platform ad set ID }
       requestBody:
         required: true
@@ -35309,6 +35348,16 @@ paths:
       security:
         - bearerAuth: []
       parameters:
+        - name: Idempotency-Key
+          in: header
+          required: false
+          schema: { type: string, maxLength: 255 }
+          description: >-
+            Optional client-generated unique key (e.g. a UUID) that makes
+            retries safe. Same key + same body replays the original response;
+            same key + different body → 422; key still processing → 409. Only
+            2xx responses are stored, so a request that failed with a 4xx can
+            be retried with a corrected body under the SAME key.
         - { name: adId, in: path, required: true, schema: { type: string }, description: Zernio ad ID or platform ad ID }
       requestBody:
         required: false
@@ -35631,7 +35680,7 @@ paths:
                         ctr: { type: number, description: "Click-through rate as a percentage (0–100)." }
                         cpc: { type: number, description: "Cost per click in native currency." }
                         cpm: { type: number, description: "Cost per 1000 impressions in native currency." }
-                        conversions: { type: integer, description: "Sum of conversion events over the range. Meta: events matching the campaign optimization goal. Google: tracked conversions. X / LinkedIn: reported website/lead conversions (added 2026-07)." }
+                        conversions: { type: number, description: "Sum of conversion events over the range. Fractional values are normal (attribution splitting + Google modeled conversions). Meta: events matching the campaign optimization goal. Google: tracked conversions. X / LinkedIn: reported website/lead conversions (added 2026-07)." }
                         costPerConversion: { type: number }
                         actions:
                           type: object
@@ -37376,7 +37425,7 @@ paths:
                   properties:
                     ageMin: { type: integer, minimum: 13, maximum: 65 }
                     ageMax: { type: integer, minimum: 13, maximum: 65 }
-                    gender: { type: string, enum: [all, male, female], description: "Meta only." }
+                    gender: { type: string, enum: [all, male, female], description: "Applied on Meta, TikTok and Pinterest. Ignored on Google, LinkedIn and X." }
                     languages: { type: array, items: { type: string }, description: "Meta locale ids (numeric), passed through as given." }
                     countries: { type: array, items: { type: string }, description: "ISO country codes. Required for TikTok boosts (TikTok's ad group requires location_ids); optional on other platforms." }
                     regions:
@@ -37704,9 +37753,9 @@ paths:
                 video:
                   type: object
                   description: "Meta (facebook, instagram) and LinkedIn. When set, creates a VIDEO ad on the legacy (or, for Meta, attach) shape. Mutually exclusive with `imageUrl`. For Meta multi-creative, set `video` per entry inside `creatives[]` instead. For LinkedIn the video is uploaded to LinkedIn under the authoring Company Page (see `organizationId`) and the campaign format is set to SINGLE_VIDEO; LinkedIn ignores `thumbnailUrl` (it auto-generates the poster frame) — supply MP4 H.264/AAC, 3s-30min, 75KB-500MB."
-                  required: [url]
                   properties:
-                    url: { type: string, format: uri, description: "Public URL of the video. Meta: uploaded via chunked transfer on /act_X/advideos, then the request blocks on Meta's transcoding until status.video_status === 'ready'. LinkedIn: uploaded via the Videos API (multipart), then the request blocks until LinkedIn finishes transcoding (status AVAILABLE) — short clips take ~10-30s." }
+                    url: { type: string, format: uri, description: "Public URL of the video. Meta: uploaded via chunked transfer on /act_X/advideos, then the request blocks on Meta's transcoding until status.video_status === 'ready'. LinkedIn: uploaded via the Videos API (multipart), then the request blocks until LinkedIn finishes transcoding (status AVAILABLE) — short clips take ~10-30s. Provide either `url` or `id`."}
+                    id: { type: string, description: "Meta only. Reuse a video ALREADY uploaded to this ad account instead of re-uploading the file: pass the `videoId` returned by a previous create. Wins over `url`, so N ads that differ only in copy share one upload (`existingCreativeId` only covers the identical-copy case). Provide either `url` or `id`."}
                     thumbnailUrl: { type: string, format: uri, description: "Public URL of a still-image thumbnail for the video. OPTIONAL: when omitted on Meta, the poster is auto-generated from Meta's own preferred video thumbnail (the same candidates Ads Manager shows), so video ads publish without supplying one. Provide it to control the poster frame exactly (uploaded as an ad image and referenced in object_story_spec.video_data). Ignored by LinkedIn (auto-generated poster frame)." }
                 creatives:
                   type: array
@@ -38037,6 +38086,36 @@ paths:
                       headline: { type: string, maxLength: 255, description: "Card headline, shown below the card image." }
                       description: { type: string, maxLength: 255, description: "Card description, shown under the headline." }
                       callToAction: { type: string, description: "Card CTA override. Defaults to the top-level callToAction; same enum." }
+                defaultLocale:
+                  type: string
+                  description: "Meta only. Language the top-level copy is written in (e.g. `en`, `pt_BR`), used by the `translations` default rule. Defaults to `en`. Meta rejects a language asset feed whose default rule carries no locales of its own."
+                translations:
+                  type: array
+                  minItems: 1
+                  maxItems: 10
+                  description: |
+                    Meta only. Multi-language ads (Dynamic Language Optimization): ONE ad carrying
+                    per-locale copy and, optionally, per-locale media — the "Languages" toggle in Ads
+                    Manager. Keeps social proof (likes/comments/shares) on a SINGLE post instead of
+                    splitting it across one ad per language.
+
+                    The ad's top-level copy and media are the DEFAULT every unlisted locale falls back
+                    to, and a variant inherits any field it omits, so send only what differs per
+                    language. Media shared across languages is uploaded once.
+
+                    Mutually exclusive with `dynamicCreative`, `placementAssets`, `carouselCards` and
+                    `existingCreativeId` — Meta allows one `asset_feed_spec` shape per creative.
+                  items:
+                    type: object
+                    required: [locale]
+                    properties:
+                      locale: { type: string, description: "Language code, resolved to Meta's numeric locale id. Bare codes target the '(All)' umbrella (`es` = every Spanish variant); region-qualified codes target the variant (`pt_BR`, `en_GB`)." }
+                      headline: { type: string, maxLength: 255, description: "Headline for this language. Inherits the top-level `headline` when omitted." }
+                      body: { type: string, description: "Primary text for this language. Inherits the top-level `body` when omitted." }
+                      description: { type: string, maxLength: 255, description: "Link description for this language. Inherits the top-level `description` when omitted." }
+                      imageUrl: { type: string, format: uri, description: "Image for this language. Inherits the ad's `imageUrl` when omitted. The feed is all-image OR all-video." }
+                      videoUrl: { type: string, format: uri, description: "Video for this language. Inherits the ad's `video.url` when omitted. The feed is all-image OR all-video." }
+                      thumbnailUrl: { type: string, format: uri, description: "Poster frame for this language's video." }
                 placementAssets:
                   type: object
                   description: |
@@ -38151,7 +38230,7 @@ paths:
                     `VIEW_THROUGH: 1`; `CLICK_THROUGH: 28` only on certain objectives. Invalid combos
                     surface as a Meta 400.
                     Example: `[{ "eventType": "CLICK_THROUGH", "windowDays": 7 }, { "eventType": "VIEW_THROUGH", "windowDays": 1 }]`
-                gender: { type: string, enum: [all, male, female], default: all, description: "Meta only. Restrict the audience by gender. 'male' targets men only, 'female' targets women only, 'all' (default) targets everyone. Ignored by non-Meta platforms." }
+                gender: { type: string, enum: [all, male, female], default: all, description: "Restrict the audience by gender. 'male' targets men only, 'female' targets women only, 'all' (default) targets everyone. Applied on Meta, TikTok and Pinterest. Ignored on Google, LinkedIn and X." }
                 bidStrategy:
                   allOf: [{ $ref: '#/components/schemas/BidStrategy' }]
                   description: "Meta bid strategy applied to the ad set."

data/spec/api/ad_campaigns_api_spec.rb

@@ -58,9 +58,10 @@ describe 'AdCampaignsApi' do
 
   # unit tests for create_ad_campaign
   # Create a standalone campaign
-  # Creates a campaign WITHOUT its first ad set / ad (the ODAX shell only). Ad sets join it later via `existingCampaignId` on the create endpoints. A budget here is campaign-level (CBO) by definition; omit it for ABO (each ad set carries its own budget). Created `PAUSED` unless `status: ACTIVE`. The campaign materializes in `/v1/ads/tree` via the next sync discovery pass.
+  # Creates a campaign WITHOUT its first ad set / ad (the ODAX shell only). Ad sets join it later via `existingCampaignId` on the create endpoints. A budget here is campaign-level (CBO) by definition; omit it for ABO (each ad set carries its own budget). Created `PAUSED` unless `status: ACTIVE`. The campaign materializes in `/v1/ads/tree` via the next sync discovery pass.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
   # @param create_ad_campaign_request 
   # @param [Hash] opts the optional parameters
+  # @option opts [String] :idempotency_key Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
   # @return [CreateAdCampaign201Response]
   describe 'create_ad_campaign test' do
     it 'should work' do
@@ -111,6 +112,7 @@ describe 'AdCampaignsApi' do
   # Duplicates a single ad via Meta's native `POST /{ad-id}/copies`. The copy is created paused. `adSetId` retargets the copy into another ad set; omitted = the source's own ad set. Accepts the Zernio ad id or the platform ad id. Sync discovery is triggered automatically (`syncAfter: false` to skip).
   # @param ad_id Zernio ad ID or platform ad ID
   # @param [Hash] opts the optional parameters
+  # @option opts [String] :idempotency_key Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
   # @option opts [DuplicateAdRequest] :duplicate_ad_request 
   # @return [DuplicateAd200Response]
   describe 'duplicate_ad test' do
@@ -125,6 +127,7 @@ describe 'AdCampaignsApi' do
   # @param campaign_id Source platform campaign ID
   # @param duplicate_ad_campaign_request 
   # @param [Hash] opts the optional parameters
+  # @option opts [String] :idempotency_key Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
   # @return [DuplicateAdCampaign200Response]
   describe 'duplicate_ad_campaign test' do
     it 'should work' do
@@ -138,6 +141,7 @@ describe 'AdCampaignsApi' do
   # @param ad_set_id Source platform ad set ID
   # @param duplicate_ad_set_request 
   # @param [Hash] opts the optional parameters
+  # @option opts [String] :idempotency_key Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
   # @return [DuplicateAdSet200Response]
   describe 'duplicate_ad_set test' do
     it 'should work' do

data/spec/models/create_ad_campaign_request_spec.rb

@@ -91,4 +91,26 @@ describe Zernio::CreateAdCampaignRequest do
     end
   end
 
+  describe 'test attribute "bid_strategy"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+      # validator = Petstore::EnumTest::EnumAttributeValidator.new('String', ["LOWEST_COST_WITHOUT_CAP", "LOWEST_COST_WITH_BID_CAP", "COST_CAP", "LOWEST_COST_WITH_MIN_ROAS"])
+      # validator.allowable_values.each do |value|
+      #   expect { instance.bid_strategy = value }.not_to raise_error
+      # end
+    end
+  end
+
+  describe 'test attribute "bid_amount"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "roas_average_floor"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
 end

data/spec/models/create_standalone_ad_request_spec.rb

@@ -417,6 +417,18 @@ describe Zernio::CreateStandaloneAdRequest do
     end
   end
 
+  describe 'test attribute "default_locale"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "translations"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "placement_assets"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/create_standalone_ad_request_translations_inner_spec.rb

@@ -0,0 +1,72 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+require 'date'
+
+# Unit tests for Zernio::CreateStandaloneAdRequestTranslationsInner
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe Zernio::CreateStandaloneAdRequestTranslationsInner do
+  #let(:instance) { Zernio::CreateStandaloneAdRequestTranslationsInner.new }
+
+  describe 'test an instance of CreateStandaloneAdRequestTranslationsInner' do
+    it 'should create an instance of CreateStandaloneAdRequestTranslationsInner' do
+      # uncomment below to test the instance creation
+      #expect(instance).to be_instance_of(Zernio::CreateStandaloneAdRequestTranslationsInner)
+    end
+  end
+
+  describe 'test attribute "locale"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "headline"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "body"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "description"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "image_url"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "video_url"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "thumbnail_url"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/models/create_standalone_ad_request_video_spec.rb

@@ -33,6 +33,12 @@ describe Zernio::CreateStandaloneAdRequestVideo do
     end
   end
 
+  describe 'test attribute "id"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "thumbnail_url"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: late-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.627
+  version: 0.0.629
 platform: ruby
 authors:
 - OpenAPI-Generator
@@ -340,6 +340,7 @@ files:
 - docs/CreateStandaloneAdRequestPromotedObject.md
 - docs/CreateStandaloneAdRequestRegionsInner.md
 - docs/CreateStandaloneAdRequestTracking.md
+- docs/CreateStandaloneAdRequestTranslationsInner.md
 - docs/CreateStandaloneAdRequestVideo.md
 - docs/CreateTestLead200Response.md
 - docs/CreateTestLead200ResponseTestLead.md
@@ -2006,6 +2007,7 @@ files:
 - lib/zernio-sdk/models/create_standalone_ad_request_promoted_object.rb
 - lib/zernio-sdk/models/create_standalone_ad_request_regions_inner.rb
 - lib/zernio-sdk/models/create_standalone_ad_request_tracking.rb
+- lib/zernio-sdk/models/create_standalone_ad_request_translations_inner.rb
 - lib/zernio-sdk/models/create_standalone_ad_request_video.rb
 - lib/zernio-sdk/models/create_test_lead200_response.rb
 - lib/zernio-sdk/models/create_test_lead200_response_test_lead.rb
@@ -3621,6 +3623,7 @@ files:
 - spec/models/create_standalone_ad_request_regions_inner_spec.rb
 - spec/models/create_standalone_ad_request_spec.rb
 - spec/models/create_standalone_ad_request_tracking_spec.rb
+- spec/models/create_standalone_ad_request_translations_inner_spec.rb
 - spec/models/create_standalone_ad_request_video_spec.rb
 - spec/models/create_test_lead200_response_spec.rb
 - spec/models/create_test_lead200_response_test_lead_spec.rb
@@ -4913,7 +4916,7 @@ files:
 - spec/models/you_tube_video_retention_response_retention_curve_inner_spec.rb
 - spec/models/you_tube_video_retention_response_spec.rb
 - spec/spec_helper.rb
-- zernio-sdk-0.0.627.gem
+- zernio-sdk-0.0.629.gem
 - zernio-sdk.gemspec
 homepage: https://openapi-generator.tech
 licenses:
@@ -6238,6 +6241,7 @@ test_files:
 - spec/models/analytics_list_response_spec.rb
 - spec/models/update_post_request_spec.rb
 - spec/models/activate_sequence200_response_spec.rb
+- spec/models/create_standalone_ad_request_translations_inner_spec.rb
 - spec/models/queue_schedule_spec.rb
 - spec/models/unblock_whats_app_users_request_spec.rb
 - spec/models/update_ad_status_request_spec.rb