late-sdk 0.0.637 → 0.0.639

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5ebe1bb31790fb37d31bde9137c5b05e86f723cd3c08c4c9f027aef7bcaaa7cb
-  data.tar.gz: db336ffe0bdee07a42159925a5285a2813ba8fe7f707ca60fbf5ff3b7d485a14
+  metadata.gz: 8a1e52f2fc494ac1d77f85382297c83612bcd8e957b9dc2186d9d35a2cc2ad92
+  data.tar.gz: dd09be0c5c864e3fa64571f2386a49c0c373c0446f25507823ed09612606d17b
 SHA512:
-  metadata.gz: 9309a47c51d5eeb83953a2c718919e047a3d035d39323a7183ae15d93fcd72a13b6e17a0c3d8580fb536b0d10584b174a4012073b858acaabc5ae337e4e9b3a1
-  data.tar.gz: 292b6e3da3e3cad95bf85a84ba74021525a16b1bbdd824705b43884e8004d9ab1f2a642800e203743322bcfb3ec089570f25889a0ed761b760a6e88a929899b9
+  metadata.gz: 7d127baaef1e5725924e3e0b3b185c9c0461c02c43029ea224cfb3b615e0b064ef0aede0588bafd82638e695b65002a105baf755ec78591037413e8fdf59192d
+  data.tar.gz: 75c1561d78e50d3d7c64b9240e3601cc90206509180771f5f01efdd8ebc2b62e15187f5130c1b31e499ba72f9048a265a8ba0e41687aaffac809a760ab55cd33

data/docs/Ad.md

@@ -22,11 +22,13 @@
 | **campaign_name** | **String** |  | [optional] |
 | **ad_set_name** | **String** |  | [optional] |
 | **platform_objective** | **String** | Raw Meta campaign objective (e.g. OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC). Only present for Meta ads. | [optional] |
-| **optimization_goal** | **String** | Meta ad set optimization goal (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION, LINK_CLICKS). Only present for Meta ads. | [optional] |
+| **optimization_goal** | **String** | What the delivery system optimizes for, at ad-set level. The value space depends on `platform`:  - Meta: ad set `optimization_goal` (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION, LINK_CLICKS). - LinkedIn: the campaign's EFFECTIVE `optimizationTargetType`, refreshed from LinkedIn on every   sync rather than echoing what was passed on create. `NONE` means manual bidding, and it is a   real value, not missing data. Auto-bid values are MAX_IMPRESSION / MAX_CLICK / MAX_CONVERSION /   MAX_VIDEO_VIEW / MAX_LEAD / MAX_REACH; target-cost values are TARGET_COST_PER_CLICK /   TARGET_COST_PER_IMPRESSION / TARGET_COST_PER_VIDEO_VIEW; cost-cap values are the   CAP_COST_AND_MAXIMIZE_* family.  | [optional] |
+| **cost_type** | **String** | LinkedIn only. The campaign's EFFECTIVE cost model (billing event) as applied by LinkedIn, refreshed on every sync rather than echoing what was passed on create. One of `CPM` (cost per thousand impressions), `CPC` (cost per click) or `CPV` (cost per video view). On LinkedIn this is the axis that pairs with `bidAmount`; there is no `bidStrategy`. For campaign type SPONSORED_INMAILS, `CPM` bills as cost-per-send x 1000. `null` for non-LinkedIn ads.  | [optional] |
+| **serving_statuses** | **Array<String>** | LinkedIn only. Why the parent campaign is (or is not) delivering, verbatim from LinkedIn. A campaign can report `status: ACTIVE` and still serve nothing; this array is what says so.  - `[]` means no serving data: a non-LinkedIn ad, or a LinkedIn ad not yet re-synced. - `[\"RUNNABLE\"]` means the campaign is eligible to serve. - Anything else is a hold. Known values include ACCOUNT_SERVING_HOLD, ACCOUNT_TOTAL_BUDGET_HOLD,   ACCOUNT_END_DATE_HOLD, CAMPAIGN_START_DATE_HOLD, CAMPAIGN_END_DATE_HOLD,   CAMPAIGN_TOTAL_BUDGET_HOLD, CAMPAIGN_AUDIENCE_COUNT_HOLD, CAMPAIGN_GROUP_START_DATE_HOLD,   CAMPAIGN_GROUP_END_DATE_HOLD, CAMPAIGN_GROUP_TOTAL_BUDGET_HOLD, CAMPAIGN_GROUP_STATUS_HOLD and   STOPPED. The list is open on purpose, so treat unrecognized values as holds rather than errors.  The end-date and total-budget holds are terminal and surface as `status: completed`; the rest surface as `status: paused`. Note that a hold is not the only cause of zero delivery: with manual, target-cost or cost-cap bidding, a `bidAmount` of 0 stops delivery while `servingStatuses` still reads `[\"RUNNABLE\"]`. Check `costType` / `bidAmount` / `optimizationGoal` as well.  | [optional] |
 | **platform_ad_account_name** | **String** | Human-readable advertiser/account name (Meta `AdAccount.name`, TikTok `advertiser_name`, LinkedIn / X / Pinterest equivalents). Refreshed every sync so platform-side renames propagate within one cycle. `null` when the platform doesn't return a name or the sync hasn't run yet.  | [optional] |
 | **platform_created_at** | **Time** | Platform-reported creation timestamp (Meta `created_time`, TikTok `create_time`). Distinct from `createdAt` which reflects when Zernio first synced the doc — for sort/filter by \"when the ad was actually created on the platform\", read this field. `null` for legacy ads synced before this field was added; aggregations fall back to `createdAt` in that case.  | [optional] |
 | **bid_strategy** | [**BidStrategy**](BidStrategy.md) |  | [optional] |
-| **bid_amount** | **Float** | Bid cap in WHOLE currency units of the ad account (USD: 5 = $5.00; JPY: 100 = ¥100). Populated when bidStrategy is `LOWEST_COST_WITH_BID_CAP` or `COST_CAP`. `null` for auto-bid (`LOWEST_COST_WITHOUT_CAP`).  - Meta source: `bid_amount` on the ad set (smallest-denomination int, decoded here). - TikTok source: priority order `bid_price` -> `conversion_bid_price` -> `deep_cpa_bid`   (whichever is set on the ad group). TikTok stores all three in whole currency units.  Source: facebook-business-sdk-codegen api_specs/specs/AdSet.json (`bid_amount`).  | [optional] |
+| **bid_amount** | **Float** | Bid amount in WHOLE currency units of the ad account (USD: 5 = $5.00; JPY: 100 = ¥100).  - Meta source: `bid_amount` on the ad set (smallest-denomination int, decoded here). Populated   when bidStrategy is `LOWEST_COST_WITH_BID_CAP` or `COST_CAP`; `null` for auto-bid   (`LOWEST_COST_WITHOUT_CAP`). - TikTok source: priority order `bid_price` -> `conversion_bid_price` -> `deep_cpa_bid`   (whichever is set on the ad group). TikTok stores all three in whole currency units. - LinkedIn source: the campaign's EFFECTIVE `unitCost`, refreshed on every sync rather than   echoing what was passed on create. Its meaning depends on the bidding mode implied by   `optimizationGoal`: bid amount (manual), target cost, or cost cap. It pairs with `costType`,   NOT with `bidStrategy`, which LinkedIn does not have. A value of `0` is a real, delivery-   stopping configuration and not \"unset\", so do not gate this field on `bidStrategy` for   LinkedIn ads.  Source: facebook-business-sdk-codegen api_specs/specs/AdSet.json (`bid_amount`).  | [optional] |
 | **roas_average_floor** | **Float** | Minimum ROAS as a decimal multiplier (2.0 = 2.0x ROAS). Populated when bidStrategy is `LOWEST_COST_WITH_MIN_ROAS`.  - Meta source: decoded from `bid_constraints.roas_average_floor` (Meta stores as   fixed-point int × 10000; we return the decimal). - TikTok source: `roas_bid` on the ad group (already a decimal).  Source: facebook-business-sdk-codegen api_specs/specs/AdCampaignBidConstraint.json.  | [optional] |
 | **promoted_object** | [**AdPromotedObject**](AdPromotedObject.md) |  | [optional] |
 | **creative** | [**AdCreative**](AdCreative.md) |  | [optional] |
@@ -61,6 +63,8 @@ instance = Zernio::Ad.new(
   ad_set_name: null,
   platform_objective: OUTCOME_SALES,
   optimization_goal: OFFSITE_CONVERSIONS,
+  cost_type: CPC,
+  serving_statuses: [ACCOUNT_TOTAL_BUDGET_HOLD],
   platform_ad_account_name: Zernio - previously Late,
   platform_created_at: null,
   bid_strategy: null,

data/docs/AdCampaign.md

@@ -24,9 +24,9 @@
 | **profile_id** | **String** |  | [optional] |
 | **advertising_channel_type** | **String** | Google-only. Raw campaign.advertising_channel_type. See AdTreeCampaign.advertisingChannelType. | [optional] |
 | **platform_objective** | **String** | Raw Meta campaign objective (e.g. OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC) | [optional] |
-| **optimization_goal** | **String** | Meta optimization goal shared across ad sets, or comma-separated values when ad sets differ (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION) | [optional] |
+| **optimization_goal** | **String** | Optimization goal shared across ad sets, or comma-separated values when ad sets differ. Meta: e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION. LinkedIn: the campaign optimizationTargetType (e.g. MAX_CLICK, MAX_IMPRESSION, NONE); `NONE` with a manual costType is a campaign LinkedIn will not deliver. | [optional] |
 | **bid_strategy** | [**BidStrategy**](BidStrategy.md) |  | [optional] |
-| **bid_amount** | **Float** | Representative bid cap from the top-spending ad set (whole currency units). Populated when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. | [optional] |
+| **bid_amount** | **Float** | Representative bid from the top-spending ad set (whole currency units). Meta: populated when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. LinkedIn: the campaign unitCost, ungated, where 0 is a real delivery-stopping value. | [optional] |
 | **roas_average_floor** | **Float** | Representative ROAS floor from the top-spending ad set. Decimal multiplier (2.0 = 2.0x). | [optional] |
 | **promoted_object** | [**AdTreeCampaignPromotedObject**](AdTreeCampaignPromotedObject.md) |  | [optional] |
 | **earliest_ad** | **Time** |  | [optional] |

data/docs/AdCreative.md

@@ -16,6 +16,8 @@
 | **instagram_user_id** | **String** | Meta `instagram_user_id` — the Instagram-scoped business ID that owns the boosted media. | [optional] |
 | **instagram_permalink_url** | **String** | Meta `instagram_permalink_url` — public Instagram post URL of the boosted media. | [optional] |
 | **media_urls** | **Array<String>** | All media URLs for this ad (carousel images, multiple assets). Populated for Meta (carousel child_attachments), Google Ads (responsive display marketing_images), and LinkedIn (multi-image posts). | [optional] |
+| **is_serving** | **Boolean** | LinkedIn only. Whether LinkedIn is currently serving this specific creative. Complements the ad-level `servingStatuses`, which describes the parent campaign. | [optional] |
+| **serving_hold_reasons** | **Array<String>** | LinkedIn only. Why this specific creative is not being served. Empty when it is serving. A superset of the ad-level `servingStatuses`: it repeats the inherited campaign, campaign group and account holds AND adds creative-only causes such as UNDER_REVIEW, REJECTED, PROCESSING, PROCESSING_FAILED, FORM_HOLD (lead-gen-form creatives), REFERRED_CONTENT_QUALITY_HOLD, JOB_POSTING_ON_HOLD and JOB_POSTING_INVALID (job ads). Some values are format-specific and will never appear on other ad formats. The list is open, so treat unrecognized values as holds rather than errors.  | [optional] |
 | **body** | **String** | Ad copy/text | [optional] |
 | **google_headline** | **String** | Google Ads headline | [optional] |
 | **google_description** | **String** | Google Ads description | [optional] |
@@ -42,6 +44,8 @@ instance = Zernio::AdCreative.new(
   instagram_user_id: null,
   instagram_permalink_url: null,
   media_urls: null,
+  is_serving: null,
+  serving_hold_reasons: [UNDER_REVIEW],
   body: null,
   google_headline: null,
   google_description: null,

data/docs/AdTreeAdSet.md

@@ -11,10 +11,12 @@
 | **budget** | [**AdTreeAdSetBudget**](AdTreeAdSetBudget.md) |  | [optional] |
 | **ad_set_budget** | [**AdTreeAdSetAdSetBudget**](AdTreeAdSetAdSetBudget.md) |  | [optional] |
 | **metrics** | [**AdMetrics**](AdMetrics.md) |  | [optional] |
-| **optimization_goal** | **String** | Meta ad set optimization goal (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION) | [optional] |
+| **optimization_goal** | **String** | What the delivery system optimizes for. Meta ad set optimization goal (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION), or on LinkedIn the campaign's effective optimizationTargetType (NONE means manual bidding). See the `optimizationGoal` field on `Ad` for the full value spaces. | [optional] |
 | **bid_strategy** | [**BidStrategy**](BidStrategy.md) |  | [optional] |
-| **bid_amount** | **Float** | Bid cap in whole currency units. Populated when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. | [optional] |
+| **bid_amount** | **Float** | Bid amount in whole currency units. On Meta/TikTok populated when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP; on LinkedIn it is the campaign's effective unitCost and pairs with `costType`, where 0 is a real, delivery-stopping value. | [optional] |
 | **roas_average_floor** | **Float** | Minimum ROAS as a decimal multiplier (2.0 = 2.0x). Populated when bidStrategy is LOWEST_COST_WITH_MIN_ROAS. | [optional] |
+| **cost_type** | **String** | LinkedIn only. Effective cost model (billing event) of the LinkedIn campaign backing this ad set: CPM, CPC or CPV. Null for non-LinkedIn ad sets. | [optional] |
+| **serving_statuses** | **Array<String>** | LinkedIn only. Why the LinkedIn campaign backing this ad set is (or is not) delivering. A LinkedIn Campaign maps to this ad-set node, so this is the level where LinkedIn's holds actually apply. Empty means no serving data, [\"RUNNABLE\"] means eligible to serve, anything else is a hold. See the `servingStatuses` field on `Ad` for the known values. | [optional] |
 | **promoted_object** | [**AdTreeAdSetPromotedObject**](AdTreeAdSetPromotedObject.md) |  | [optional] |
 | **ads** | [**Array<Ad>**](Ad.md) | Individual ads within this ad set (capped at 100). Returns a subset of Ad fields from the aggregation (core fields like _id, name, platform, status, budget, metrics, creative, goal are included; targeting and schedule may be absent). When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`. | [optional] |
 | **daily** | [**Array<AdDailyMetrics>**](AdDailyMetrics.md) | Per-day metric series for this ad set. Present only when `GET /v1/ads/tree` is called with `timeIncrement=1` and `dailyLevel` is `adset` or `ad`. | [optional] |
@@ -36,6 +38,8 @@ instance = Zernio::AdTreeAdSet.new(
   bid_strategy: null,
   bid_amount: null,
   roas_average_floor: null,
+  cost_type: null,
+  serving_statuses: [RUNNABLE],
   promoted_object: null,
   ads: null,
   daily: null

data/docs/AdTreeCampaign.md

@@ -25,9 +25,9 @@
 | **profile_id** | **String** |  | [optional] |
 | **advertising_channel_type** | **String** | Google-only. Raw campaign.advertising_channel_type (SEARCH, PERFORMANCE_MAX, VIDEO, DEMAND_GEN, DISPLAY, SHOPPING, ...). Serving surface, distinct from platformObjective (advertiser intent). Null/absent for non-Google platforms. | [optional] |
 | **platform_objective** | **String** | Raw Meta campaign objective (e.g. OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC) | [optional] |
-| **optimization_goal** | **String** | Meta optimization goal shared across ad sets, or comma-separated values when ad sets differ (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION) | [optional] |
+| **optimization_goal** | **String** | Optimization goal shared across ad sets, or comma-separated values when ad sets differ. Meta: e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION. LinkedIn: the campaign optimizationTargetType (e.g. MAX_CLICK, MAX_IMPRESSION, NONE); `NONE` with a manual costType is a campaign LinkedIn will not deliver. | [optional] |
 | **bid_strategy** | [**BidStrategy**](BidStrategy.md) |  | [optional] |
-| **bid_amount** | **Float** | Representative bid cap for the campaign — bubbled up from the top-spending ad set's `bid_amount` (whole currency units). Populated when the ad-set bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. | [optional] |
+| **bid_amount** | **Float** | Representative bid for the campaign, bubbled up from the top-spending ad set (whole currency units). Meta: populated when the ad-set bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. LinkedIn: the campaign unitCost, which has no bidStrategy gate and where 0 is a real, delivery-stopping value rather than unset. | [optional] |
 | **roas_average_floor** | **Float** | Representative ROAS floor for the campaign — bubbled up from the top-spending ad set. Decimal multiplier (2.0 = 2.0x). | [optional] |
 | **promoted_object** | [**AdTreeCampaignPromotedObject**](AdTreeCampaignPromotedObject.md) |  | [optional] |
 | **ad_sets** | [**Array<AdTreeAdSet>**](AdTreeAdSet.md) |  | [optional] |

data/docs/PostAnalytics.md

@@ -15,6 +15,7 @@
 | **follows** | **Integer** | Instagram feed posts and stories only: organic accounts that started following from this post. 0 for reels and other platforms. | [optional] |
 | **ig_reels_avg_watch_time** | **Integer** | Instagram Reels only: average watch time per play, in milliseconds. 0 for non-Reels media and other platforms. | [optional] |
 | **ig_reels_video_view_total_time** | **Integer** | Instagram Reels only: total watch time including replays, in milliseconds. 0 for non-Reels media and other platforms. | [optional] |
+| **video_duration_seconds** | **Integer** | Video length in seconds. Currently Instagram Reels only; combine with igReelsAvgWatchTime (ms) to estimate retention. Null when unknown (other platforms, non-video media, or when Instagram does not expose the media URL, e.g. reels with copyrighted audio). | [optional] |
 | **engagement_rate** | **Float** |  | [optional] |
 | **last_updated** | **Time** |  | [optional] |
 
@@ -35,6 +36,7 @@ instance = Zernio::PostAnalytics.new(
   follows: 0,
   ig_reels_avg_watch_time: 0,
   ig_reels_video_view_total_time: 0,
+  video_duration_seconds: 30,
   engagement_rate: 0,
   last_updated: null
 )

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

@@ -57,9 +57,15 @@ module Zernio
     # Raw Meta campaign objective (e.g. OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC). Only present for Meta ads.
     attr_accessor :platform_objective
 
-    # Meta ad set optimization goal (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION, LINK_CLICKS). Only present for Meta ads.
+    # What the delivery system optimizes for, at ad-set level. The value space depends on `platform`:  - Meta: ad set `optimization_goal` (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION, LINK_CLICKS). - LinkedIn: the campaign's EFFECTIVE `optimizationTargetType`, refreshed from LinkedIn on every   sync rather than echoing what was passed on create. `NONE` means manual bidding, and it is a   real value, not missing data. Auto-bid values are MAX_IMPRESSION / MAX_CLICK / MAX_CONVERSION /   MAX_VIDEO_VIEW / MAX_LEAD / MAX_REACH; target-cost values are TARGET_COST_PER_CLICK /   TARGET_COST_PER_IMPRESSION / TARGET_COST_PER_VIDEO_VIEW; cost-cap values are the   CAP_COST_AND_MAXIMIZE_* family. 
     attr_accessor :optimization_goal
 
+    # LinkedIn only. The campaign's EFFECTIVE cost model (billing event) as applied by LinkedIn, refreshed on every sync rather than echoing what was passed on create. One of `CPM` (cost per thousand impressions), `CPC` (cost per click) or `CPV` (cost per video view). On LinkedIn this is the axis that pairs with `bidAmount`; there is no `bidStrategy`. For campaign type SPONSORED_INMAILS, `CPM` bills as cost-per-send x 1000. `null` for non-LinkedIn ads. 
+    attr_accessor :cost_type
+
+    # LinkedIn only. Why the parent campaign is (or is not) delivering, verbatim from LinkedIn. A campaign can report `status: ACTIVE` and still serve nothing; this array is what says so.  - `[]` means no serving data: a non-LinkedIn ad, or a LinkedIn ad not yet re-synced. - `[\"RUNNABLE\"]` means the campaign is eligible to serve. - Anything else is a hold. Known values include ACCOUNT_SERVING_HOLD, ACCOUNT_TOTAL_BUDGET_HOLD,   ACCOUNT_END_DATE_HOLD, CAMPAIGN_START_DATE_HOLD, CAMPAIGN_END_DATE_HOLD,   CAMPAIGN_TOTAL_BUDGET_HOLD, CAMPAIGN_AUDIENCE_COUNT_HOLD, CAMPAIGN_GROUP_START_DATE_HOLD,   CAMPAIGN_GROUP_END_DATE_HOLD, CAMPAIGN_GROUP_TOTAL_BUDGET_HOLD, CAMPAIGN_GROUP_STATUS_HOLD and   STOPPED. The list is open on purpose, so treat unrecognized values as holds rather than errors.  The end-date and total-budget holds are terminal and surface as `status: completed`; the rest surface as `status: paused`. Note that a hold is not the only cause of zero delivery: with manual, target-cost or cost-cap bidding, a `bidAmount` of 0 stops delivery while `servingStatuses` still reads `[\"RUNNABLE\"]`. Check `costType` / `bidAmount` / `optimizationGoal` as well. 
+    attr_accessor :serving_statuses
+
     # Human-readable advertiser/account name (Meta `AdAccount.name`, TikTok `advertiser_name`, LinkedIn / X / Pinterest equivalents). Refreshed every sync so platform-side renames propagate within one cycle. `null` when the platform doesn't return a name or the sync hasn't run yet. 
     attr_accessor :platform_ad_account_name
 
@@ -68,7 +74,7 @@ module Zernio
 
     attr_accessor :bid_strategy
 
-    # Bid cap in WHOLE currency units of the ad account (USD: 5 = $5.00; JPY: 100 = ¥100). Populated when bidStrategy is `LOWEST_COST_WITH_BID_CAP` or `COST_CAP`. `null` for auto-bid (`LOWEST_COST_WITHOUT_CAP`).  - Meta source: `bid_amount` on the ad set (smallest-denomination int, decoded here). - TikTok source: priority order `bid_price` -> `conversion_bid_price` -> `deep_cpa_bid`   (whichever is set on the ad group). TikTok stores all three in whole currency units.  Source: facebook-business-sdk-codegen api_specs/specs/AdSet.json (`bid_amount`). 
+    # Bid amount in WHOLE currency units of the ad account (USD: 5 = $5.00; JPY: 100 = ¥100).  - Meta source: `bid_amount` on the ad set (smallest-denomination int, decoded here). Populated   when bidStrategy is `LOWEST_COST_WITH_BID_CAP` or `COST_CAP`; `null` for auto-bid   (`LOWEST_COST_WITHOUT_CAP`). - TikTok source: priority order `bid_price` -> `conversion_bid_price` -> `deep_cpa_bid`   (whichever is set on the ad group). TikTok stores all three in whole currency units. - LinkedIn source: the campaign's EFFECTIVE `unitCost`, refreshed on every sync rather than   echoing what was passed on create. Its meaning depends on the bidding mode implied by   `optimizationGoal`: bid amount (manual), target cost, or cost cap. It pairs with `costType`,   NOT with `bidStrategy`, which LinkedIn does not have. A value of `0` is a real, delivery-   stopping configuration and not \"unset\", so do not gate this field on `bidStrategy` for   LinkedIn ads.  Source: facebook-business-sdk-codegen api_specs/specs/AdSet.json (`bid_amount`). 
     attr_accessor :bid_amount
 
     # Minimum ROAS as a decimal multiplier (2.0 = 2.0x ROAS). Populated when bidStrategy is `LOWEST_COST_WITH_MIN_ROAS`.  - Meta source: decoded from `bid_constraints.roas_average_floor` (Meta stores as   fixed-point int × 10000; we return the decimal). - TikTok source: `roas_bid` on the ad group (already a decimal).  Source: facebook-business-sdk-codegen api_specs/specs/AdCampaignBidConstraint.json. 
@@ -133,6 +139,8 @@ module Zernio
         :'ad_set_name' => :'adSetName',
         :'platform_objective' => :'platformObjective',
         :'optimization_goal' => :'optimizationGoal',
+        :'cost_type' => :'costType',
+        :'serving_statuses' => :'servingStatuses',
         :'platform_ad_account_name' => :'platformAdAccountName',
         :'platform_created_at' => :'platformCreatedAt',
         :'bid_strategy' => :'bidStrategy',
@@ -180,6 +188,8 @@ module Zernio
         :'ad_set_name' => :'String',
         :'platform_objective' => :'String',
         :'optimization_goal' => :'String',
+        :'cost_type' => :'String',
+        :'serving_statuses' => :'Array<String>',
         :'platform_ad_account_name' => :'String',
         :'platform_created_at' => :'Time',
         :'bid_strategy' => :'BidStrategy',
@@ -202,6 +212,7 @@ module Zernio
         :'metrics',
         :'platform_objective',
         :'optimization_goal',
+        :'cost_type',
         :'platform_ad_account_name',
         :'platform_created_at',
         :'bid_strategy',
@@ -302,6 +313,16 @@ module Zernio
         self.optimization_goal = attributes[:'optimization_goal']
       end
 
+      if attributes.key?(:'cost_type')
+        self.cost_type = attributes[:'cost_type']
+      end
+
+      if attributes.key?(:'serving_statuses')
+        if (value = attributes[:'serving_statuses']).is_a?(Array)
+          self.serving_statuses = value
+        end
+      end
+
       if attributes.key?(:'platform_ad_account_name')
         self.platform_ad_account_name = attributes[:'platform_ad_account_name']
       end
@@ -426,6 +447,8 @@ module Zernio
           ad_set_name == o.ad_set_name &&
           platform_objective == o.platform_objective &&
           optimization_goal == o.optimization_goal &&
+          cost_type == o.cost_type &&
+          serving_statuses == o.serving_statuses &&
           platform_ad_account_name == o.platform_ad_account_name &&
           platform_created_at == o.platform_created_at &&
           bid_strategy == o.bid_strategy &&
@@ -449,7 +472,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [_id, name, platform, status, configured_status, review_status, ad_type, goal, is_external, budget, metrics, platform_ad_id, platform_ad_account_id, platform_campaign_id, platform_ad_set_id, campaign_name, ad_set_name, platform_objective, optimization_goal, platform_ad_account_name, platform_created_at, bid_strategy, bid_amount, roas_average_floor, promoted_object, creative, targeting, schedule, rejection_reason, created_at, updated_at].hash
+      [_id, name, platform, status, configured_status, review_status, ad_type, goal, is_external, budget, metrics, platform_ad_id, platform_ad_account_id, platform_campaign_id, platform_ad_set_id, campaign_name, ad_set_name, platform_objective, optimization_goal, cost_type, serving_statuses, platform_ad_account_name, platform_created_at, bid_strategy, bid_amount, roas_average_floor, promoted_object, creative, targeting, schedule, rejection_reason, created_at, updated_at].hash
     end
 
     # Builds the object from hash

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

@@ -64,12 +64,12 @@ module Zernio
     # Raw Meta campaign objective (e.g. OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC)
     attr_accessor :platform_objective
 
-    # Meta optimization goal shared across ad sets, or comma-separated values when ad sets differ (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION)
+    # Optimization goal shared across ad sets, or comma-separated values when ad sets differ. Meta: e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION. LinkedIn: the campaign optimizationTargetType (e.g. MAX_CLICK, MAX_IMPRESSION, NONE); `NONE` with a manual costType is a campaign LinkedIn will not deliver.
     attr_accessor :optimization_goal
 
     attr_accessor :bid_strategy
 
-    # Representative bid cap from the top-spending ad set (whole currency units). Populated when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP.
+    # Representative bid from the top-spending ad set (whole currency units). Meta: populated when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. LinkedIn: the campaign unitCost, ungated, where 0 is a real delivery-stopping value.
     attr_accessor :bid_amount
 
     # Representative ROAS floor from the top-spending ad set. Decimal multiplier (2.0 = 2.0x).

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

@@ -52,6 +52,12 @@ module Zernio
     # All media URLs for this ad (carousel images, multiple assets). Populated for Meta (carousel child_attachments), Google Ads (responsive display marketing_images), and LinkedIn (multi-image posts).
     attr_accessor :media_urls
 
+    # LinkedIn only. Whether LinkedIn is currently serving this specific creative. Complements the ad-level `servingStatuses`, which describes the parent campaign.
+    attr_accessor :is_serving
+
+    # LinkedIn only. Why this specific creative is not being served. Empty when it is serving. A superset of the ad-level `servingStatuses`: it repeats the inherited campaign, campaign group and account holds AND adds creative-only causes such as UNDER_REVIEW, REJECTED, PROCESSING, PROCESSING_FAILED, FORM_HOLD (lead-gen-form creatives), REFERRED_CONTENT_QUALITY_HOLD, JOB_POSTING_ON_HOLD and JOB_POSTING_INVALID (job ads). Some values are format-specific and will never appear on other ad formats. The list is open, so treat unrecognized values as holds rather than errors. 
+    attr_accessor :serving_hold_reasons
+
     # Ad copy/text
     attr_accessor :body
 
@@ -85,6 +91,8 @@ module Zernio
         :'instagram_user_id' => :'instagramUserId',
         :'instagram_permalink_url' => :'instagramPermalinkUrl',
         :'media_urls' => :'mediaUrls',
+        :'is_serving' => :'isServing',
+        :'serving_hold_reasons' => :'servingHoldReasons',
         :'body' => :'body',
         :'google_headline' => :'googleHeadline',
         :'google_description' => :'googleDescription',
@@ -120,6 +128,8 @@ module Zernio
         :'instagram_user_id' => :'String',
         :'instagram_permalink_url' => :'String',
         :'media_urls' => :'Array<String>',
+        :'is_serving' => :'Boolean',
+        :'serving_hold_reasons' => :'Array<String>',
         :'body' => :'String',
         :'google_headline' => :'String',
         :'google_description' => :'String',
@@ -141,6 +151,7 @@ module Zernio
         :'effective_instagram_media_id',
         :'instagram_user_id',
         :'instagram_permalink_url',
+        :'is_serving',
       ])
     end
 
@@ -210,6 +221,16 @@ module Zernio
         end
       end
 
+      if attributes.key?(:'is_serving')
+        self.is_serving = attributes[:'is_serving']
+      end
+
+      if attributes.key?(:'serving_hold_reasons')
+        if (value = attributes[:'serving_hold_reasons']).is_a?(Array)
+          self.serving_hold_reasons = value
+        end
+      end
+
       if attributes.key?(:'body')
         self.body = attributes[:'body']
       end
@@ -271,6 +292,8 @@ module Zernio
           instagram_user_id == o.instagram_user_id &&
           instagram_permalink_url == o.instagram_permalink_url &&
           media_urls == o.media_urls &&
+          is_serving == o.is_serving &&
+          serving_hold_reasons == o.serving_hold_reasons &&
           body == o.body &&
           google_headline == o.google_headline &&
           google_description == o.google_description &&
@@ -289,7 +312,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [thumbnail_url, image_url, video_id, video_url, object_type, object_story_id, effective_object_story_id, page_id, effective_instagram_media_id, instagram_user_id, instagram_permalink_url, media_urls, body, google_headline, google_description, link_url, pinterest_image_url, pinterest_title, pinterest_description].hash
+      [thumbnail_url, image_url, video_id, video_url, 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, pinterest_image_url, pinterest_title, pinterest_description].hash
     end
 
     # Builds the object from hash

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

@@ -31,17 +31,23 @@ module Zernio
 
     attr_accessor :metrics
 
-    # Meta ad set optimization goal (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION)
+    # What the delivery system optimizes for. Meta ad set optimization goal (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION), or on LinkedIn the campaign's effective optimizationTargetType (NONE means manual bidding). See the `optimizationGoal` field on `Ad` for the full value spaces.
     attr_accessor :optimization_goal
 
     attr_accessor :bid_strategy
 
-    # Bid cap in whole currency units. Populated when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP.
+    # Bid amount in whole currency units. On Meta/TikTok populated when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP; on LinkedIn it is the campaign's effective unitCost and pairs with `costType`, where 0 is a real, delivery-stopping value.
     attr_accessor :bid_amount
 
     # Minimum ROAS as a decimal multiplier (2.0 = 2.0x). Populated when bidStrategy is LOWEST_COST_WITH_MIN_ROAS.
     attr_accessor :roas_average_floor
 
+    # LinkedIn only. Effective cost model (billing event) of the LinkedIn campaign backing this ad set: CPM, CPC or CPV. Null for non-LinkedIn ad sets.
+    attr_accessor :cost_type
+
+    # LinkedIn only. Why the LinkedIn campaign backing this ad set is (or is not) delivering. A LinkedIn Campaign maps to this ad-set node, so this is the level where LinkedIn's holds actually apply. Empty means no serving data, [\"RUNNABLE\"] means eligible to serve, anything else is a hold. See the `servingStatuses` field on `Ad` for the known values.
+    attr_accessor :serving_statuses
+
     attr_accessor :promoted_object
 
     # Individual ads within this ad set (capped at 100). Returns a subset of Ad fields from the aggregation (core fields like _id, name, platform, status, budget, metrics, creative, goal are included; targeting and schedule may be absent). When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`.
@@ -86,6 +92,8 @@ module Zernio
         :'bid_strategy' => :'bidStrategy',
         :'bid_amount' => :'bidAmount',
         :'roas_average_floor' => :'roasAverageFloor',
+        :'cost_type' => :'costType',
+        :'serving_statuses' => :'servingStatuses',
         :'promoted_object' => :'promotedObject',
         :'ads' => :'ads',
         :'daily' => :'daily'
@@ -116,6 +124,8 @@ module Zernio
         :'bid_strategy' => :'BidStrategy',
         :'bid_amount' => :'Float',
         :'roas_average_floor' => :'Float',
+        :'cost_type' => :'String',
+        :'serving_statuses' => :'Array<String>',
         :'promoted_object' => :'AdTreeAdSetPromotedObject',
         :'ads' => :'Array<Ad>',
         :'daily' => :'Array<AdDailyMetrics>'
@@ -129,6 +139,7 @@ module Zernio
         :'bid_strategy',
         :'bid_amount',
         :'roas_average_floor',
+        :'cost_type',
       ])
     end
 
@@ -192,6 +203,16 @@ module Zernio
         self.roas_average_floor = attributes[:'roas_average_floor']
       end
 
+      if attributes.key?(:'cost_type')
+        self.cost_type = attributes[:'cost_type']
+      end
+
+      if attributes.key?(:'serving_statuses')
+        if (value = attributes[:'serving_statuses']).is_a?(Array)
+          self.serving_statuses = value
+        end
+      end
+
       if attributes.key?(:'promoted_object')
         self.promoted_object = attributes[:'promoted_object']
       end
@@ -240,6 +261,8 @@ module Zernio
           bid_strategy == o.bid_strategy &&
           bid_amount == o.bid_amount &&
           roas_average_floor == o.roas_average_floor &&
+          cost_type == o.cost_type &&
+          serving_statuses == o.serving_statuses &&
           promoted_object == o.promoted_object &&
           ads == o.ads &&
           daily == o.daily
@@ -254,7 +277,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [platform_ad_set_id, ad_set_name, status, ad_count, budget, ad_set_budget, metrics, optimization_goal, bid_strategy, bid_amount, roas_average_floor, promoted_object, ads, daily].hash
+      [platform_ad_set_id, ad_set_name, status, ad_count, budget, ad_set_budget, metrics, optimization_goal, bid_strategy, bid_amount, roas_average_floor, cost_type, serving_statuses, promoted_object, ads, daily].hash
     end
 
     # Builds the object from hash

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

@@ -68,12 +68,12 @@ module Zernio
     # Raw Meta campaign objective (e.g. OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC)
     attr_accessor :platform_objective
 
-    # Meta optimization goal shared across ad sets, or comma-separated values when ad sets differ (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION)
+    # Optimization goal shared across ad sets, or comma-separated values when ad sets differ. Meta: e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION. LinkedIn: the campaign optimizationTargetType (e.g. MAX_CLICK, MAX_IMPRESSION, NONE); `NONE` with a manual costType is a campaign LinkedIn will not deliver.
     attr_accessor :optimization_goal
 
     attr_accessor :bid_strategy
 
-    # Representative bid cap for the campaign — bubbled up from the top-spending ad set's `bid_amount` (whole currency units). Populated when the ad-set bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP.
+    # Representative bid for the campaign, bubbled up from the top-spending ad set (whole currency units). Meta: populated when the ad-set bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. LinkedIn: the campaign unitCost, which has no bidStrategy gate and where 0 is a real, delivery-stopping value rather than unset.
     attr_accessor :bid_amount
 
     # Representative ROAS floor for the campaign — bubbled up from the top-spending ad set. Decimal multiplier (2.0 = 2.0x).

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

@@ -41,6 +41,9 @@ module Zernio
     # Instagram Reels only: total watch time including replays, in milliseconds. 0 for non-Reels media and other platforms.
     attr_accessor :ig_reels_video_view_total_time
 
+    # Video length in seconds. Currently Instagram Reels only; combine with igReelsAvgWatchTime (ms) to estimate retention. Null when unknown (other platforms, non-video media, or when Instagram does not expose the media URL, e.g. reels with copyrighted audio).
+    attr_accessor :video_duration_seconds
+
     attr_accessor :engagement_rate
 
     attr_accessor :last_updated
@@ -59,6 +62,7 @@ module Zernio
         :'follows' => :'follows',
         :'ig_reels_avg_watch_time' => :'igReelsAvgWatchTime',
         :'ig_reels_video_view_total_time' => :'igReelsVideoViewTotalTime',
+        :'video_duration_seconds' => :'videoDurationSeconds',
         :'engagement_rate' => :'engagementRate',
         :'last_updated' => :'lastUpdated'
       }
@@ -88,6 +92,7 @@ module Zernio
         :'follows' => :'Integer',
         :'ig_reels_avg_watch_time' => :'Integer',
         :'ig_reels_video_view_total_time' => :'Integer',
+        :'video_duration_seconds' => :'Integer',
         :'engagement_rate' => :'Float',
         :'last_updated' => :'Time'
       }
@@ -96,6 +101,7 @@ module Zernio
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
+        :'video_duration_seconds',
       ])
     end
 
@@ -159,6 +165,10 @@ module Zernio
         self.ig_reels_video_view_total_time = attributes[:'ig_reels_video_view_total_time']
       end
 
+      if attributes.key?(:'video_duration_seconds')
+        self.video_duration_seconds = attributes[:'video_duration_seconds']
+      end
+
       if attributes.key?(:'engagement_rate')
         self.engagement_rate = attributes[:'engagement_rate']
       end
@@ -199,6 +209,7 @@ module Zernio
           follows == o.follows &&
           ig_reels_avg_watch_time == o.ig_reels_avg_watch_time &&
           ig_reels_video_view_total_time == o.ig_reels_video_view_total_time &&
+          video_duration_seconds == o.video_duration_seconds &&
           engagement_rate == o.engagement_rate &&
           last_updated == o.last_updated
     end
@@ -212,7 +223,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [impressions, reach, likes, comments, shares, saves, clicks, views, follows, ig_reels_avg_watch_time, ig_reels_video_view_total_time, engagement_rate, last_updated].hash
+      [impressions, reach, likes, comments, shares, saves, clicks, views, follows, ig_reels_avg_watch_time, ig_reels_video_view_total_time, video_duration_seconds, engagement_rate, last_updated].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.19.0
 =end
 
 module Zernio
-  VERSION = '0.0.637'
+  VERSION = '0.0.639'
 end

data/openapi.yaml

@@ -6093,6 +6093,7 @@ components:
         follows: { type: integer, example: 0, description: 'Instagram feed posts and stories only: organic accounts that started following from this post. 0 for reels and other platforms.' }
         igReelsAvgWatchTime: { type: integer, example: 0, description: 'Instagram Reels only: average watch time per play, in milliseconds. 0 for non-Reels media and other platforms.' }
         igReelsVideoViewTotalTime: { type: integer, example: 0, description: 'Instagram Reels only: total watch time including replays, in milliseconds. 0 for non-Reels media and other platforms.' }
+        videoDurationSeconds: { type: [integer, "null"], example: 30, description: 'Video length in seconds. Currently Instagram Reels only; combine with igReelsAvgWatchTime (ms) to estimate retention. Null when unknown (other platforms, non-video media, or when Instagram does not expose the media URL, e.g. reels with copyrighted audio).' }
         engagementRate: { type: number, example: 0 }
         lastUpdated: { type: string, format: date-time }
     PlatformAnalytics:
@@ -6855,8 +6856,47 @@ components:
           example: OUTCOME_SALES
         optimizationGoal:
           type: [string, "null"]
-          description: "Meta ad set optimization goal (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION, LINK_CLICKS). Only present for Meta ads."
+          description: |
+            What the delivery system optimizes for, at ad-set level. The value space depends on `platform`:
+
+            - Meta: ad set `optimization_goal` (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION, LINK_CLICKS).
+            - LinkedIn: the campaign's EFFECTIVE `optimizationTargetType`, refreshed from LinkedIn on every
+              sync rather than echoing what was passed on create. `NONE` means manual bidding, and it is a
+              real value, not missing data. Auto-bid values are MAX_IMPRESSION / MAX_CLICK / MAX_CONVERSION /
+              MAX_VIDEO_VIEW / MAX_LEAD / MAX_REACH; target-cost values are TARGET_COST_PER_CLICK /
+              TARGET_COST_PER_IMPRESSION / TARGET_COST_PER_VIDEO_VIEW; cost-cap values are the
+              CAP_COST_AND_MAXIMIZE_* family.
           example: OFFSITE_CONVERSIONS
+        costType:
+          type: [string, "null"]
+          description: |
+            LinkedIn only. The campaign's EFFECTIVE cost model (billing event) as applied by LinkedIn,
+            refreshed on every sync rather than echoing what was passed on create. One of `CPM` (cost per
+            thousand impressions), `CPC` (cost per click) or `CPV` (cost per video view). On LinkedIn this is
+            the axis that pairs with `bidAmount`; there is no `bidStrategy`. For campaign type
+            SPONSORED_INMAILS, `CPM` bills as cost-per-send x 1000. `null` for non-LinkedIn ads.
+          example: CPC
+        servingStatuses:
+          type: array
+          items: { type: string }
+          description: |
+            LinkedIn only. Why the parent campaign is (or is not) delivering, verbatim from LinkedIn.
+            A campaign can report `status: ACTIVE` and still serve nothing; this array is what says so.
+
+            - `[]` means no serving data: a non-LinkedIn ad, or a LinkedIn ad not yet re-synced.
+            - `["RUNNABLE"]` means the campaign is eligible to serve.
+            - Anything else is a hold. Known values include ACCOUNT_SERVING_HOLD, ACCOUNT_TOTAL_BUDGET_HOLD,
+              ACCOUNT_END_DATE_HOLD, CAMPAIGN_START_DATE_HOLD, CAMPAIGN_END_DATE_HOLD,
+              CAMPAIGN_TOTAL_BUDGET_HOLD, CAMPAIGN_AUDIENCE_COUNT_HOLD, CAMPAIGN_GROUP_START_DATE_HOLD,
+              CAMPAIGN_GROUP_END_DATE_HOLD, CAMPAIGN_GROUP_TOTAL_BUDGET_HOLD, CAMPAIGN_GROUP_STATUS_HOLD and
+              STOPPED. The list is open on purpose, so treat unrecognized values as holds rather than errors.
+
+            The end-date and total-budget holds are terminal and surface as `status: completed`; the rest
+            surface as `status: paused`. Note that a hold is not the only cause of zero delivery: with
+            manual, target-cost or cost-cap bidding, a `bidAmount` of 0 stops delivery while
+            `servingStatuses` still reads `["RUNNABLE"]`. Check `costType` / `bidAmount` /
+            `optimizationGoal` as well.
+          example: ["ACCOUNT_TOTAL_BUDGET_HOLD"]
         platformAdAccountName:
           type: [string, "null"]
           description: |
@@ -6888,13 +6928,19 @@ components:
         bidAmount:
           type: [number, "null"]
           description: |
-            Bid cap in WHOLE currency units of the ad account (USD: 5 = $5.00; JPY: 100 = ¥100).
-            Populated when bidStrategy is `LOWEST_COST_WITH_BID_CAP` or `COST_CAP`. `null` for
-            auto-bid (`LOWEST_COST_WITHOUT_CAP`).
+            Bid amount in WHOLE currency units of the ad account (USD: 5 = $5.00; JPY: 100 = ¥100).
 
-            - Meta source: `bid_amount` on the ad set (smallest-denomination int, decoded here).
+            - Meta source: `bid_amount` on the ad set (smallest-denomination int, decoded here). Populated
+              when bidStrategy is `LOWEST_COST_WITH_BID_CAP` or `COST_CAP`; `null` for auto-bid
+              (`LOWEST_COST_WITHOUT_CAP`).
             - TikTok source: priority order `bid_price` -> `conversion_bid_price` -> `deep_cpa_bid`
               (whichever is set on the ad group). TikTok stores all three in whole currency units.
+            - LinkedIn source: the campaign's EFFECTIVE `unitCost`, refreshed on every sync rather than
+              echoing what was passed on create. Its meaning depends on the bidding mode implied by
+              `optimizationGoal`: bid amount (manual), target cost, or cost cap. It pairs with `costType`,
+              NOT with `bidStrategy`, which LinkedIn does not have. A value of `0` is a real, delivery-
+              stopping configuration and not "unset", so do not gate this field on `bidStrategy` for
+              LinkedIn ads.
 
             Source: facebook-business-sdk-codegen api_specs/specs/AdSet.json (`bid_amount`).
           example: 5
@@ -6938,6 +6984,19 @@ components:
               type: array
               items: { type: string }
               description: All media URLs for this ad (carousel images, multiple assets). Populated for Meta (carousel child_attachments), Google Ads (responsive display marketing_images), and LinkedIn (multi-image posts).
+            isServing: { type: [boolean, "null"], description: "LinkedIn only. Whether LinkedIn is currently serving this specific creative. Complements the ad-level `servingStatuses`, which describes the parent campaign." }
+            servingHoldReasons:
+              type: array
+              items: { type: string }
+              description: |
+                LinkedIn only. Why this specific creative is not being served. Empty when it is serving.
+                A superset of the ad-level `servingStatuses`: it repeats the inherited campaign, campaign
+                group and account holds AND adds creative-only causes such as UNDER_REVIEW, REJECTED,
+                PROCESSING, PROCESSING_FAILED, FORM_HOLD (lead-gen-form creatives),
+                REFERRED_CONTENT_QUALITY_HOLD, JOB_POSTING_ON_HOLD and JOB_POSTING_INVALID (job ads).
+                Some values are format-specific and will never appear on other ad formats. The list is
+                open, so treat unrecognized values as holds rather than errors.
+              example: ["UNDER_REVIEW"]
             body: { type: string, description: Ad copy/text }
             googleHeadline: { type: string, description: Google Ads headline }
             googleDescription: { type: string, description: Google Ads description }
@@ -6983,14 +7042,20 @@ components:
             amount: { type: number }
             type: { type: string, enum: [daily, lifetime] }
         metrics: { $ref: '#/components/schemas/AdMetrics' }
-        optimizationGoal: { type: [string, "null"], description: "Meta ad set optimization goal (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION)" }
+        optimizationGoal: { type: [string, "null"], description: "What the delivery system optimizes for. Meta ad set optimization goal (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION), or on LinkedIn the campaign's effective optimizationTargetType (NONE means manual bidding). See the `optimizationGoal` field on `Ad` for the full value spaces." }
         bidStrategy:
           anyOf:
             - $ref: '#/components/schemas/BidStrategy'
             - type: "null"
-          description: "Bid strategy for this ad set (overrides campaign level when set)"
-        bidAmount: { type: [number, "null"], description: "Bid cap in whole currency units. Populated when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP." }
+          description: "Bid strategy for this ad set (overrides campaign level when set). Meta and TikTok only; LinkedIn uses `costType` instead."
+        bidAmount: { type: [number, "null"], description: "Bid amount in whole currency units. On Meta/TikTok populated when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP; on LinkedIn it is the campaign's effective unitCost and pairs with `costType`, where 0 is a real, delivery-stopping value." }
         roasAverageFloor: { type: [number, "null"], description: "Minimum ROAS as a decimal multiplier (2.0 = 2.0x). Populated when bidStrategy is LOWEST_COST_WITH_MIN_ROAS." }
+        costType: { type: [string, "null"], description: "LinkedIn only. Effective cost model (billing event) of the LinkedIn campaign backing this ad set: CPM, CPC or CPV. Null for non-LinkedIn ad sets." }
+        servingStatuses:
+          type: array
+          items: { type: string }
+          description: "LinkedIn only. Why the LinkedIn campaign backing this ad set is (or is not) delivering. A LinkedIn Campaign maps to this ad-set node, so this is the level where LinkedIn's holds actually apply. Empty means no serving data, [\"RUNNABLE\"] means eligible to serve, anything else is a hold. See the `servingStatuses` field on `Ad` for the known values."
+          example: ["RUNNABLE"]
         promotedObject:
           type: [object, "null"]
           description: "Meta promoted object for this ad set (conversion event details)"
@@ -7069,13 +7134,13 @@ components:
         platformObjective: { type: [string, "null"], description: "Raw Meta campaign objective (e.g. OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC)" }
         optimizationGoal:
           type: [string, "null"]
-          description: "Meta optimization goal shared across ad sets, or comma-separated values when ad sets differ (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION)"
+          description: "Optimization goal shared across ad sets, or comma-separated values when ad sets differ. Meta: e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION. LinkedIn: the campaign optimizationTargetType (e.g. MAX_CLICK, MAX_IMPRESSION, NONE); `NONE` with a manual costType is a campaign LinkedIn will not deliver."
         bidStrategy:
           anyOf:
             - $ref: '#/components/schemas/BidStrategy'
             - type: "null"
           description: "Campaign-level bid strategy. Ad sets inherit this unless they override."
-        bidAmount: { type: [number, "null"], description: "Representative bid cap for the campaign — bubbled up from the top-spending ad set's `bid_amount` (whole currency units). Populated when the ad-set bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP." }
+        bidAmount: { type: [number, "null"], description: "Representative bid for the campaign, bubbled up from the top-spending ad set (whole currency units). Meta: populated when the ad-set bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. LinkedIn: the campaign unitCost, which has no bidStrategy gate and where 0 is a real, delivery-stopping value rather than unset." }
         roasAverageFloor: { type: [number, "null"], description: "Representative ROAS floor for the campaign — bubbled up from the top-spending ad set. Decimal multiplier (2.0 = 2.0x)." }
         promotedObject:
           type: [object, "null"]
@@ -7146,13 +7211,13 @@ components:
         platformObjective: { type: [string, "null"], description: "Raw Meta campaign objective (e.g. OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC)" }
         optimizationGoal:
           type: [string, "null"]
-          description: "Meta optimization goal shared across ad sets, or comma-separated values when ad sets differ (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION)"
+          description: "Optimization goal shared across ad sets, or comma-separated values when ad sets differ. Meta: e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION. LinkedIn: the campaign optimizationTargetType (e.g. MAX_CLICK, MAX_IMPRESSION, NONE); `NONE` with a manual costType is a campaign LinkedIn will not deliver."
         bidStrategy:
           anyOf:
             - $ref: '#/components/schemas/BidStrategy'
             - type: "null"
           description: "Campaign-level bid strategy. Ad sets inherit this unless they override."
-        bidAmount: { type: [number, "null"], description: "Representative bid cap from the top-spending ad set (whole currency units). Populated when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP." }
+        bidAmount: { type: [number, "null"], description: "Representative bid from the top-spending ad set (whole currency units). Meta: populated when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. LinkedIn: the campaign unitCost, ungated, where 0 is a real delivery-stopping value." }
         roasAverageFloor: { type: [number, "null"], description: "Representative ROAS floor from the top-spending ad set. Decimal multiplier (2.0 = 2.0x)." }
         promotedObject:
           type: [object, "null"]

data/spec/models/ad_creative_spec.rb

@@ -99,6 +99,18 @@ describe Zernio::AdCreative do
     end
   end
 
+  describe 'test attribute "is_serving"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "serving_hold_reasons"' 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/

data/spec/models/ad_spec.rb

@@ -153,6 +153,18 @@ describe Zernio::Ad do
     end
   end
 
+  describe 'test attribute "cost_type"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "serving_statuses"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "platform_ad_account_name"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/ad_tree_ad_set_spec.rb

@@ -93,6 +93,18 @@ describe Zernio::AdTreeAdSet do
     end
   end
 
+  describe 'test attribute "cost_type"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "serving_statuses"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "promoted_object"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/post_analytics_spec.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: late-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.637
+  version: 0.0.639
 platform: ruby
 authors:
 - OpenAPI-Generator
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-01 00:00:00.000000000 Z
+date: 2026-08-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: typhoeus
@@ -4919,7 +4919,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.637.gem
+- zernio-sdk-0.0.639.gem
 - zernio-sdk.gemspec
 homepage: https://openapi-generator.tech
 licenses: