late-sdk 0.0.628 → 0.0.630

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fb3a36da617e2797bb6d0d284c6d49a9e1c6eceacf59344855db2f5fc59842dc
-  data.tar.gz: e8a14eb77fb4f7aff571448016d2ea9cdefa368d53d6924e0f218c10bbc95b19
+  metadata.gz: 3ee8170329c2bab7ac4cd1ffbcb49c451b12b664f75cf0c19c49b42a252d4d28
+  data.tar.gz: 330c5e8841706919d35a79c056800fbaaeda22e9babd1c631973d53e06c78beb
 SHA512:
-  metadata.gz: f988c0fb3137cdcaac15195aff6011bc6cdc87499262c1801e7abac380fdc6115a5f49d1b9eff49b6e444c691271750bcd998d5b30ba5c11f5e4633331dafb6c
-  data.tar.gz: 7727c62c02377e594b7ede16ed5af3f965b7f911b6b8740e8e5315ba9085ca1266b8790ea51ed69624faede9c6c956c283dc3810d44283885100f2a5fa8ce0a9
+  metadata.gz: 1a0eb796306396b600f0d10e5e9f30cbb419c51be1ea43e15d529d1f2ed699d1b985c2249470f1d037f08e2d74c62da6bd1041970c9f747e6e7279f9e44ac632
+  data.tar.gz: 44683ab22f569dca906e054528d86c0fc608accaa3fb117174cbe8505f4bf2130cf51eb8be6c4230b5687738709f57697019d4a72521adf89ad2eadd1d4a79e0

data/README.md

@@ -861,6 +861,7 @@ Class | Method | HTTP request | Description
  - [Zernio::CreateStandaloneAdRequestPromotedObject](docs/CreateStandaloneAdRequestPromotedObject.md)
  - [Zernio::CreateStandaloneAdRequestRegionsInner](docs/CreateStandaloneAdRequestRegionsInner.md)
  - [Zernio::CreateStandaloneAdRequestTracking](docs/CreateStandaloneAdRequestTracking.md)
+ - [Zernio::CreateStandaloneAdRequestTranslationsInner](docs/CreateStandaloneAdRequestTranslationsInner.md)
  - [Zernio::CreateStandaloneAdRequestVideo](docs/CreateStandaloneAdRequestVideo.md)
  - [Zernio::CreateTestLead200Response](docs/CreateTestLead200Response.md)
  - [Zernio::CreateTestLead200ResponseTestLead](docs/CreateTestLead200ResponseTestLead.md)

data/docs/AdCampaignsApi.md

@@ -168,11 +168,11 @@ end
 
 ## create_ad_campaign
 
-> <CreateAdCampaign201Response> create_ad_campaign(create_ad_campaign_request)
+> <CreateAdCampaign201Response> create_ad_campaign(create_ad_campaign_request, opts)
 
 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.
 
 ### Examples
 
@@ -187,10 +187,13 @@ end
 
 api_instance = Zernio::AdCampaignsApi.new
 create_ad_campaign_request = Zernio::CreateAdCampaignRequest.new({account_id: 'account_id_example', ad_account_id: 'ad_account_id_example', name: 'name_example', goal: 'engagement'}) # CreateAdCampaignRequest | 
+opts = {
+  idempotency_key: 'idempotency_key_example' # String | 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.
+}
 
 begin
   # Create a standalone campaign
-  result = api_instance.create_ad_campaign(create_ad_campaign_request)
+  result = api_instance.create_ad_campaign(create_ad_campaign_request, opts)
   p result
 rescue Zernio::ApiError => e
   puts "Error when calling AdCampaignsApi->create_ad_campaign: #{e}"
@@ -201,12 +204,12 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<CreateAdCampaign201Response>, Integer, Hash)> create_ad_campaign_with_http_info(create_ad_campaign_request)
+> <Array(<CreateAdCampaign201Response>, Integer, Hash)> create_ad_campaign_with_http_info(create_ad_campaign_request, opts)
 
 ```ruby
 begin
   # Create a standalone campaign
-  data, status_code, headers = api_instance.create_ad_campaign_with_http_info(create_ad_campaign_request)
+  data, status_code, headers = api_instance.create_ad_campaign_with_http_info(create_ad_campaign_request, opts)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => <CreateAdCampaign201Response>
@@ -220,6 +223,7 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **create_ad_campaign_request** | [**CreateAdCampaignRequest**](CreateAdCampaignRequest.md) |  |  |
+| **idempotency_key** | **String** | 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. | [optional] |
 
 ### Return type
 
@@ -470,6 +474,7 @@ end
 api_instance = Zernio::AdCampaignsApi.new
 ad_id = 'ad_id_example' # String | Zernio ad ID or platform ad ID
 opts = {
+  idempotency_key: 'idempotency_key_example', # String | 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.
   duplicate_ad_request: Zernio::DuplicateAdRequest.new # DuplicateAdRequest | 
 }
 
@@ -505,6 +510,7 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **ad_id** | **String** | Zernio ad ID or platform ad ID |  |
+| **idempotency_key** | **String** | 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. | [optional] |
 | **duplicate_ad_request** | [**DuplicateAdRequest**](DuplicateAdRequest.md) |  | [optional] |
 
 ### Return type
@@ -523,7 +529,7 @@ end
 
 ## duplicate_ad_campaign
 
-> <DuplicateAdCampaign200Response> duplicate_ad_campaign(campaign_id, duplicate_ad_campaign_request)
+> <DuplicateAdCampaign200Response> duplicate_ad_campaign(campaign_id, duplicate_ad_campaign_request, opts)
 
 Duplicate a campaign
 
@@ -543,10 +549,13 @@ end
 api_instance = Zernio::AdCampaignsApi.new
 campaign_id = 'campaign_id_example' # String | Source platform campaign ID
 duplicate_ad_campaign_request = Zernio::DuplicateAdCampaignRequest.new({platform: 'facebook'}) # DuplicateAdCampaignRequest | 
+opts = {
+  idempotency_key: 'idempotency_key_example' # String | 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.
+}
 
 begin
   # Duplicate a campaign
-  result = api_instance.duplicate_ad_campaign(campaign_id, duplicate_ad_campaign_request)
+  result = api_instance.duplicate_ad_campaign(campaign_id, duplicate_ad_campaign_request, opts)
   p result
 rescue Zernio::ApiError => e
   puts "Error when calling AdCampaignsApi->duplicate_ad_campaign: #{e}"
@@ -557,12 +566,12 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<DuplicateAdCampaign200Response>, Integer, Hash)> duplicate_ad_campaign_with_http_info(campaign_id, duplicate_ad_campaign_request)
+> <Array(<DuplicateAdCampaign200Response>, Integer, Hash)> duplicate_ad_campaign_with_http_info(campaign_id, duplicate_ad_campaign_request, opts)
 
 ```ruby
 begin
   # Duplicate a campaign
-  data, status_code, headers = api_instance.duplicate_ad_campaign_with_http_info(campaign_id, duplicate_ad_campaign_request)
+  data, status_code, headers = api_instance.duplicate_ad_campaign_with_http_info(campaign_id, duplicate_ad_campaign_request, opts)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => <DuplicateAdCampaign200Response>
@@ -577,6 +586,7 @@ end
 | ---- | ---- | ----------- | ----- |
 | **campaign_id** | **String** | Source platform campaign ID |  |
 | **duplicate_ad_campaign_request** | [**DuplicateAdCampaignRequest**](DuplicateAdCampaignRequest.md) |  |  |
+| **idempotency_key** | **String** | 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. | [optional] |
 
 ### Return type
 
@@ -594,7 +604,7 @@ end
 
 ## duplicate_ad_set
 
-> <DuplicateAdSet200Response> duplicate_ad_set(ad_set_id, duplicate_ad_set_request)
+> <DuplicateAdSet200Response> duplicate_ad_set(ad_set_id, duplicate_ad_set_request, opts)
 
 Duplicate an ad set
 
@@ -614,10 +624,13 @@ end
 api_instance = Zernio::AdCampaignsApi.new
 ad_set_id = 'ad_set_id_example' # String | Source platform ad set ID
 duplicate_ad_set_request = Zernio::DuplicateAdSetRequest.new({platform: 'facebook'}) # DuplicateAdSetRequest | 
+opts = {
+  idempotency_key: 'idempotency_key_example' # String | 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.
+}
 
 begin
   # Duplicate an ad set
-  result = api_instance.duplicate_ad_set(ad_set_id, duplicate_ad_set_request)
+  result = api_instance.duplicate_ad_set(ad_set_id, duplicate_ad_set_request, opts)
   p result
 rescue Zernio::ApiError => e
   puts "Error when calling AdCampaignsApi->duplicate_ad_set: #{e}"
@@ -628,12 +641,12 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<DuplicateAdSet200Response>, Integer, Hash)> duplicate_ad_set_with_http_info(ad_set_id, duplicate_ad_set_request)
+> <Array(<DuplicateAdSet200Response>, Integer, Hash)> duplicate_ad_set_with_http_info(ad_set_id, duplicate_ad_set_request, opts)
 
 ```ruby
 begin
   # Duplicate an ad set
-  data, status_code, headers = api_instance.duplicate_ad_set_with_http_info(ad_set_id, duplicate_ad_set_request)
+  data, status_code, headers = api_instance.duplicate_ad_set_with_http_info(ad_set_id, duplicate_ad_set_request, opts)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => <DuplicateAdSet200Response>
@@ -648,6 +661,7 @@ end
 | ---- | ---- | ----------- | ----- |
 | **ad_set_id** | **String** | Source platform ad set ID |  |
 | **duplicate_ad_set_request** | [**DuplicateAdSetRequest**](DuplicateAdSetRequest.md) |  |  |
+| **idempotency_key** | **String** | 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. | [optional] |
 
 ### Return type
 

data/docs/AdDailyMetrics.md

@@ -12,7 +12,7 @@
 | **cpc** | **Float** | Cost per click | [optional] |
 | **cpm** | **Float** | Cost per 1000 impressions | [optional] |
 | **engagement** | **Integer** |  | [optional] |
-| **conversions** | **Integer** | 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. | [optional] |
+| **conversions** | **Float** | 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. | [optional] |
 | **cost_per_conversion** | **Float** | Derived spend / conversions in the same currency as spend. 0 when conversions is 0. | [optional] |
 | **actions** | **Hash<String, Integer>** | Per-action-type counts summed over the date range, keyed by the platform's action-type names. Meta: raw Insights action_type keys (link_click, offsite_conversion.fb_pixel_purchase, onsite_conversion.lead_grouped, ...) — both engagement and conversion events. X: conversion types (purchase, sign_up, site_visit, download, custom). LinkedIn: conversion types (post_click, post_view, lead_gen). Google returns {} (its per-action names aren't synced per ad). Empty object when no actions are reported. NOTE: keys differ by platform, so branch on the ad's platform when interpreting them. | [optional] |
 | **action_values** | **Hash<String, Float>** | Monetary mirror of `actions`, from Meta's Insights `action_values[]` array. Same keying — values are the revenue attributed to each action_type, in ad-account native currency (same unit as `spend`; see the campaign node's `currency` field). Use this to compute revenue-per-event (e.g. avg purchase value). Meta-only; other platforms return {}. | [optional] |

data/docs/AdMetrics.md

@@ -12,7 +12,7 @@
 | **cpc** | **Float** | Cost per click | [optional] |
 | **cpm** | **Float** | Cost per 1000 impressions | [optional] |
 | **engagement** | **Integer** |  | [optional] |
-| **conversions** | **Integer** | 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. | [optional] |
+| **conversions** | **Float** | 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. | [optional] |
 | **cost_per_conversion** | **Float** | Derived spend / conversions in the same currency as spend. 0 when conversions is 0. | [optional] |
 | **actions** | **Hash<String, Integer>** | Per-action-type counts summed over the date range, keyed by the platform's action-type names. Meta: raw Insights action_type keys (link_click, offsite_conversion.fb_pixel_purchase, onsite_conversion.lead_grouped, ...) — both engagement and conversion events. X: conversion types (purchase, sign_up, site_visit, download, custom). LinkedIn: conversion types (post_click, post_view, lead_gen). Google returns {} (its per-action names aren't synced per ad). Empty object when no actions are reported. NOTE: keys differ by platform, so branch on the ad's platform when interpreting them. | [optional] |
 | **action_values** | **Hash<String, Float>** | Monetary mirror of `actions`, from Meta's Insights `action_values[]` array. Same keying — values are the revenue attributed to each action_type, in ad-account native currency (same unit as `spend`; see the campaign node's `currency` field). Use this to compute revenue-per-event (e.g. avg purchase value). Meta-only; other platforms return {}. | [optional] |

data/docs/CreateAdCampaignRequest.md

@@ -12,6 +12,9 @@
 | **budget_amount** | **Float** | Campaign-level (CBO) budget in whole currency units. Requires budgetType. | [optional] |
 | **budget_type** | **String** |  | [optional] |
 | **status** | **String** |  | [optional][default to 'PAUSED'] |
+| **bid_strategy** | **String** | 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}`. | [optional] |
+| **bid_amount** | **Float** | Whole currency units (USD: 5 = $5.00). Required for LOWEST_COST_WITH_BID_CAP and COST_CAP; ignored otherwise. | [optional] |
+| **roas_average_floor** | **Float** | Decimal ROAS multiplier (2.0 = 2.0x). Required for LOWEST_COST_WITH_MIN_ROAS. | [optional] |
 
 ## Example
 
@@ -26,7 +29,10 @@ instance = Zernio::CreateAdCampaignRequest.new(
   special_ad_categories: null,
   budget_amount: null,
   budget_type: null,
-  status: null
+  status: null,
+  bid_strategy: null,
+  bid_amount: null,
+  roas_average_floor: null
 )
 ```
 

data/docs/CreateStandaloneAdRequest.md

@@ -63,6 +63,8 @@
 | **instagram_account_id** | **String** | Meta only. Override the Instagram account the ad is delivered as — pass an Instagram Business Account ID (e.g. 17841...), mapped to the creative's `instagram_user_id`. When omitted we auto-resolve the IG account linked to the connected Facebook Page (the existing default). Useful when a Page has more than one eligible IG account.  | [optional] |
 | **dynamic_creative** | [**CreateStandaloneAdRequestDynamicCreative**](CreateStandaloneAdRequestDynamicCreative.md) |  | [optional] |
 | **carousel_cards** | [**Array<CreateStandaloneAdRequestCarouselCardsInner>**](CreateStandaloneAdRequestCarouselCardsInner.md) | Meta only. Hand-built carousel: 2-10 authored cards in DETERMINISTIC order, mapped to the creative's `link_data.child_attachments`. Unlike `dynamicCreative`, you control the card order and per-card copy/link. Requires top-level `body`, `linkUrl` and `callToAction`. Mutually exclusive with `imageUrl`/`video`, `creatives[]`, `dynamicCreative`, `placementAssets`, `existingCreativeId`, `adSetId`, `leadGenFormId` and goal `catalog_sales`.  | [optional] |
+| **default_locale** | **String** | 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. | [optional] |
+| **translations** | [**Array<CreateStandaloneAdRequestTranslationsInner>**](CreateStandaloneAdRequestTranslationsInner.md) | 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.  | [optional] |
 | **placement_assets** | [**CreateStandaloneAdRequestPlacementAssets**](CreateStandaloneAdRequestPlacementAssets.md) |  | [optional] |
 | **audience_id** | **String** | Custom audience ID for targeting | [optional] |
 | **campaign_type** | **String** | Google only | [optional][default to 'display'] |
@@ -147,6 +149,8 @@ instance = Zernio::CreateStandaloneAdRequest.new(
   instagram_account_id: null,
   dynamic_creative: null,
   carousel_cards: null,
+  default_locale: null,
+  translations: null,
   placement_assets: null,
   audience_id: null,
   campaign_type: null,

data/docs/CreateStandaloneAdRequestTranslationsInner.md

@@ -0,0 +1,30 @@
+# Zernio::CreateStandaloneAdRequestTranslationsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **locale** | **String** | 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** | **String** | Headline for this language. Inherits the top-level `headline` when omitted. | [optional] |
+| **body** | **String** | Primary text for this language. Inherits the top-level `body` when omitted. | [optional] |
+| **description** | **String** | Link description for this language. Inherits the top-level `description` when omitted. | [optional] |
+| **image_url** | **String** | Image for this language. Inherits the ad's `imageUrl` when omitted. The feed is all-image OR all-video. | [optional] |
+| **video_url** | **String** | Video for this language. Inherits the ad's `video.url` when omitted. The feed is all-image OR all-video. | [optional] |
+| **thumbnail_url** | **String** | Poster frame for this language's video. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateStandaloneAdRequestTranslationsInner.new(
+  locale: null,
+  headline: null,
+  body: null,
+  description: null,
+  image_url: null,
+  video_url: null,
+  thumbnail_url: null
+)
+```
+

data/docs/CreateStandaloneAdRequestVideo.md

@@ -4,7 +4,8 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **url** | **String** | 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** | **String** | 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`. | [optional] |
+| **id** | **String** | 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`. | [optional] |
 | **thumbnail_url** | **String** | 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). | [optional] |
 
 ## Example
@@ -14,6 +15,7 @@ require 'zernio-sdk'
 
 instance = Zernio::CreateStandaloneAdRequestVideo.new(
   url: null,
+  id: null,
   thumbnail_url: null
 )
 ```

data/docs/GetAdsTimeline200ResponseRowsInner.md

@@ -13,7 +13,7 @@
 | **ctr** | **Float** | Click-through rate as a percentage (0–100). | [optional] |
 | **cpc** | **Float** | Cost per click in native currency. | [optional] |
 | **cpm** | **Float** | Cost per 1000 impressions in native currency. | [optional] |
-| **conversions** | **Integer** | 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). | [optional] |
+| **conversions** | **Float** | 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). | [optional] |
 | **cost_per_conversion** | **Float** |  | [optional] |
 | **actions** | **Hash<String, Float>** | Per-action-type counts merged across all ads on this day. Keys are platform-native action types. | [optional] |
 | **action_values** | **Hash<String, Float>** | Monetary mirror of `actions` in native currency. | [optional] |

data/docs/GetCampaignAnalytics200ResponseAnalyticsDailyInner.md

@@ -12,7 +12,7 @@
 | **cpc** | **Float** | Cost per click | [optional] |
 | **cpm** | **Float** | Cost per 1000 impressions | [optional] |
 | **engagement** | **Integer** |  | [optional] |
-| **conversions** | **Integer** | 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. | [optional] |
+| **conversions** | **Float** | 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. | [optional] |
 | **cost_per_conversion** | **Float** | Derived spend / conversions in the same currency as spend. 0 when conversions is 0. | [optional] |
 | **actions** | **Hash<String, Integer>** | Per-action-type counts summed over the date range, keyed by the platform's action-type names. Meta: raw Insights action_type keys (link_click, offsite_conversion.fb_pixel_purchase, onsite_conversion.lead_grouped, ...) — both engagement and conversion events. X: conversion types (purchase, sign_up, site_visit, download, custom). LinkedIn: conversion types (post_click, post_view, lead_gen). Google returns {} (its per-action names aren't synced per ad). Empty object when no actions are reported. NOTE: keys differ by platform, so branch on the ad's platform when interpreting them. | [optional] |
 | **action_values** | **Hash<String, Float>** | Monetary mirror of `actions`, from Meta's Insights `action_values[]` array. Same keying — values are the revenue attributed to each action_type, in ad-account native currency (same unit as `spend`; see the campaign node's `currency` field). Use this to compute revenue-per-event (e.g. avg purchase value). Meta-only; other platforms return {}. | [optional] |

data/lib/zernio-sdk/api/ad_campaigns_api.rb

@@ -156,9 +156,10 @@ module Zernio
     end
 
     # 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 [CreateAdCampaignRequest] 
     # @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]
     def create_ad_campaign(create_ad_campaign_request, opts = {})
       data, _status_code, _headers = create_ad_campaign_with_http_info(create_ad_campaign_request, opts)
@@ -166,9 +167,10 @@ module Zernio
     end
 
     # 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 [CreateAdCampaignRequest] 
     # @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 [Array<(CreateAdCampaign201Response, Integer, Hash)>] CreateAdCampaign201Response data, response status code and response headers
     def create_ad_campaign_with_http_info(create_ad_campaign_request, opts = {})
       if @api_client.config.debugging
@@ -178,6 +180,10 @@ module Zernio
       if @api_client.config.client_side_validation && create_ad_campaign_request.nil?
         fail ArgumentError, "Missing the required parameter 'create_ad_campaign_request' when calling AdCampaignsApi.create_ad_campaign"
       end
+      if @api_client.config.client_side_validation && !opts[:'idempotency_key'].nil? && opts[:'idempotency_key'].to_s.length > 255
+        fail ArgumentError, 'invalid value for "opts[:"idempotency_key"]" when calling AdCampaignsApi.create_ad_campaign, the character length must be smaller than or equal to 255.'
+      end
+
       # resource path
       local_var_path = '/v1/ads/campaigns'
 
@@ -193,6 +199,7 @@ module Zernio
       if !content_type.nil?
           header_params['Content-Type'] = content_type
       end
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -439,6 +446,7 @@ module Zernio
     # 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 [String] 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]
     def duplicate_ad(ad_id, opts = {})
@@ -450,6 +458,7 @@ module Zernio
     # Duplicates a single ad via Meta&#39;s native &#x60;POST /{ad-id}/copies&#x60;. The copy is created paused. &#x60;adSetId&#x60; retargets the copy into another ad set; omitted &#x3D; the source&#39;s own ad set. Accepts the Zernio ad id or the platform ad id. Sync discovery is triggered automatically (&#x60;syncAfter: false&#x60; to skip).
     # @param ad_id [String] 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 [Array<(DuplicateAd200Response, Integer, Hash)>] DuplicateAd200Response data, response status code and response headers
     def duplicate_ad_with_http_info(ad_id, opts = {})
@@ -460,6 +469,10 @@ module Zernio
       if @api_client.config.client_side_validation && ad_id.nil?
         fail ArgumentError, "Missing the required parameter 'ad_id' when calling AdCampaignsApi.duplicate_ad"
       end
+      if @api_client.config.client_side_validation && !opts[:'idempotency_key'].nil? && opts[:'idempotency_key'].to_s.length > 255
+        fail ArgumentError, 'invalid value for "opts[:"idempotency_key"]" when calling AdCampaignsApi.duplicate_ad, the character length must be smaller than or equal to 255.'
+      end
+
       # resource path
       local_var_path = '/v1/ads/{adId}/duplicate'.sub('{' + 'adId' + '}', CGI.escape(ad_id.to_s))
 
@@ -475,6 +488,7 @@ module Zernio
       if !content_type.nil?
           header_params['Content-Type'] = content_type
       end
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -510,6 +524,7 @@ module Zernio
     # @param campaign_id [String] Source platform campaign ID
     # @param duplicate_ad_campaign_request [DuplicateAdCampaignRequest] 
     # @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]
     def duplicate_ad_campaign(campaign_id, duplicate_ad_campaign_request, opts = {})
       data, _status_code, _headers = duplicate_ad_campaign_with_http_info(campaign_id, duplicate_ad_campaign_request, opts)
@@ -521,6 +536,7 @@ module Zernio
     # @param campaign_id [String] Source platform campaign ID
     # @param duplicate_ad_campaign_request [DuplicateAdCampaignRequest] 
     # @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 [Array<(DuplicateAdCampaign200Response, Integer, Hash)>] DuplicateAdCampaign200Response data, response status code and response headers
     def duplicate_ad_campaign_with_http_info(campaign_id, duplicate_ad_campaign_request, opts = {})
       if @api_client.config.debugging
@@ -534,6 +550,10 @@ module Zernio
       if @api_client.config.client_side_validation && duplicate_ad_campaign_request.nil?
         fail ArgumentError, "Missing the required parameter 'duplicate_ad_campaign_request' when calling AdCampaignsApi.duplicate_ad_campaign"
       end
+      if @api_client.config.client_side_validation && !opts[:'idempotency_key'].nil? && opts[:'idempotency_key'].to_s.length > 255
+        fail ArgumentError, 'invalid value for "opts[:"idempotency_key"]" when calling AdCampaignsApi.duplicate_ad_campaign, the character length must be smaller than or equal to 255.'
+      end
+
       # resource path
       local_var_path = '/v1/ads/campaigns/{campaignId}/duplicate'.sub('{' + 'campaignId' + '}', CGI.escape(campaign_id.to_s))
 
@@ -549,6 +569,7 @@ module Zernio
       if !content_type.nil?
           header_params['Content-Type'] = content_type
       end
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -584,6 +605,7 @@ module Zernio
     # @param ad_set_id [String] Source platform ad set ID
     # @param duplicate_ad_set_request [DuplicateAdSetRequest] 
     # @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]
     def duplicate_ad_set(ad_set_id, duplicate_ad_set_request, opts = {})
       data, _status_code, _headers = duplicate_ad_set_with_http_info(ad_set_id, duplicate_ad_set_request, opts)
@@ -595,6 +617,7 @@ module Zernio
     # @param ad_set_id [String] Source platform ad set ID
     # @param duplicate_ad_set_request [DuplicateAdSetRequest] 
     # @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 [Array<(DuplicateAdSet200Response, Integer, Hash)>] DuplicateAdSet200Response data, response status code and response headers
     def duplicate_ad_set_with_http_info(ad_set_id, duplicate_ad_set_request, opts = {})
       if @api_client.config.debugging
@@ -608,6 +631,10 @@ module Zernio
       if @api_client.config.client_side_validation && duplicate_ad_set_request.nil?
         fail ArgumentError, "Missing the required parameter 'duplicate_ad_set_request' when calling AdCampaignsApi.duplicate_ad_set"
       end
+      if @api_client.config.client_side_validation && !opts[:'idempotency_key'].nil? && opts[:'idempotency_key'].to_s.length > 255
+        fail ArgumentError, 'invalid value for "opts[:"idempotency_key"]" when calling AdCampaignsApi.duplicate_ad_set, the character length must be smaller than or equal to 255.'
+      end
+
       # resource path
       local_var_path = '/v1/ads/ad-sets/{adSetId}/duplicate'.sub('{' + 'adSetId' + '}', CGI.escape(ad_set_id.to_s))
 
@@ -623,6 +650,7 @@ module Zernio
       if !content_type.nil?
           header_params['Content-Type'] = content_type
       end
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}

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

@@ -35,7 +35,7 @@ module Zernio
 
     attr_accessor :engagement
 
-    # 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.
+    # 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.
     attr_accessor :conversions
 
     # Derived spend / conversions in the same currency as spend. 0 when conversions is 0.
@@ -138,7 +138,7 @@ module Zernio
         :'cpc' => :'Float',
         :'cpm' => :'Float',
         :'engagement' => :'Integer',
-        :'conversions' => :'Integer',
+        :'conversions' => :'Float',
         :'cost_per_conversion' => :'Float',
         :'actions' => :'Hash<String, Integer>',
         :'action_values' => :'Hash<String, Float>',

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

@@ -34,7 +34,7 @@ module Zernio
 
     attr_accessor :engagement
 
-    # 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.
+    # 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.
     attr_accessor :conversions
 
     # Derived spend / conversions in the same currency as spend. 0 when conversions is 0.
@@ -133,7 +133,7 @@ module Zernio
         :'cpc' => :'Float',
         :'cpm' => :'Float',
         :'engagement' => :'Integer',
-        :'conversions' => :'Integer',
+        :'conversions' => :'Float',
         :'cost_per_conversion' => :'Float',
         :'actions' => :'Hash<String, Integer>',
         :'action_values' => :'Hash<String, Float>',

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

@@ -35,6 +35,15 @@ module Zernio
 
     attr_accessor :status
 
+    # 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}`.
+    attr_accessor :bid_strategy
+
+    # Whole currency units (USD: 5 = $5.00). Required for LOWEST_COST_WITH_BID_CAP and COST_CAP; ignored otherwise.
+    attr_accessor :bid_amount
+
+    # Decimal ROAS multiplier (2.0 = 2.0x). Required for LOWEST_COST_WITH_MIN_ROAS.
+    attr_accessor :roas_average_floor
+
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -67,7 +76,10 @@ module Zernio
         :'special_ad_categories' => :'specialAdCategories',
         :'budget_amount' => :'budgetAmount',
         :'budget_type' => :'budgetType',
-        :'status' => :'status'
+        :'status' => :'status',
+        :'bid_strategy' => :'bidStrategy',
+        :'bid_amount' => :'bidAmount',
+        :'roas_average_floor' => :'roasAverageFloor'
       }
     end
 
@@ -91,7 +103,10 @@ module Zernio
         :'special_ad_categories' => :'Array<String>',
         :'budget_amount' => :'Float',
         :'budget_type' => :'String',
-        :'status' => :'String'
+        :'status' => :'String',
+        :'bid_strategy' => :'String',
+        :'bid_amount' => :'Float',
+        :'roas_average_floor' => :'Float'
       }
     end
 
@@ -160,6 +175,18 @@ module Zernio
       else
         self.status = 'PAUSED'
       end
+
+      if attributes.key?(:'bid_strategy')
+        self.bid_strategy = attributes[:'bid_strategy']
+      end
+
+      if attributes.key?(:'bid_amount')
+        self.bid_amount = attributes[:'bid_amount']
+      end
+
+      if attributes.key?(:'roas_average_floor')
+        self.roas_average_floor = attributes[:'roas_average_floor']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -205,6 +232,8 @@ module Zernio
       return false unless budget_type_validator.valid?(@budget_type)
       status_validator = EnumAttributeValidator.new('String', ["ACTIVE", "PAUSED"])
       return false unless status_validator.valid?(@status)
+      bid_strategy_validator = EnumAttributeValidator.new('String', ["LOWEST_COST_WITHOUT_CAP", "LOWEST_COST_WITH_BID_CAP", "COST_CAP", "LOWEST_COST_WITH_MIN_ROAS"])
+      return false unless bid_strategy_validator.valid?(@bid_strategy)
       true
     end
 
@@ -272,6 +301,16 @@ module Zernio
       @status = status
     end
 
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] bid_strategy Object to be assigned
+    def bid_strategy=(bid_strategy)
+      validator = EnumAttributeValidator.new('String', ["LOWEST_COST_WITHOUT_CAP", "LOWEST_COST_WITH_BID_CAP", "COST_CAP", "LOWEST_COST_WITH_MIN_ROAS"])
+      unless validator.valid?(bid_strategy)
+        fail ArgumentError, "invalid value for \"bid_strategy\", must be one of #{validator.allowable_values}."
+      end
+      @bid_strategy = bid_strategy
+    end
+
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)
@@ -284,7 +323,10 @@ module Zernio
           special_ad_categories == o.special_ad_categories &&
           budget_amount == o.budget_amount &&
           budget_type == o.budget_type &&
-          status == o.status
+          status == o.status &&
+          bid_strategy == o.bid_strategy &&
+          bid_amount == o.bid_amount &&
+          roas_average_floor == o.roas_average_floor
     end
 
     # @see the `==` method
@@ -296,7 +338,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, ad_account_id, name, goal, special_ad_categories, budget_amount, budget_type, status].hash
+      [account_id, ad_account_id, name, goal, special_ad_categories, budget_amount, budget_type, status, bid_strategy, bid_amount, roas_average_floor].hash
     end
 
     # Builds the object from hash