late-sdk 0.0.871 → 0.0.873

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

@@ -14,9 +14,9 @@ require 'date'
 require 'time'
 
 module Zernio
-  # Named conversion-funnel steps, resolved from the same data as `actions` so you never have to parse action-type strings yourself.  Meta reports one event under several action types at once (`offsite_conversion.fb_pixel_purchase`, `omni_purchase`, `purchase`, …). Each field below takes the FIRST family member present rather than summing them, which is what makes these counts safe to add up — summing the raw `actions` keys yourself double or triple counts. The same priority order backs `conversions`, so a purchase-optimised campaign reports the identical number in `conversions` and `funnel.purchases`.  Every field is 0 when that step never fired. Populated for Meta ads; other platforms report a different action taxonomy and generally leave these at 0 (read `actions` for those). At ad-set and campaign level each step is summed from its per-ad values. 
+  # Named conversion-funnel steps, resolved from the same data as `actions` so you never have to parse action-type strings yourself.  Meta reports one event under several action types at once (`offsite_conversion.fb_pixel_purchase`, `omni_purchase`, `purchase`, …). Each field below takes the FIRST family member present rather than summing them, which is what makes these counts safe to add up. Summing the raw `actions` keys yourself double or triple counts. The same priority order backs `conversions`, so a purchase-optimised campaign reports the identical number in `conversions` and `funnel.purchases`.  Every field is 0 when that step never fired. Populated for Meta ads; other platforms report a different action taxonomy and generally leave these at 0 (read `actions` for those). At ad-set and campaign level each step is summed from its per-ad values. 
   class AdFunnelCounts < ApiModelBase
-    # Landing page views — the visitor actually loaded the destination, unlike a link click. Meta `landing_page_view`.
+    # Landing page views: the visitor actually loaded the destination, unlike a link click. Meta `landing_page_view`.
     attr_accessor :landing_page_views
 
     # Content views (Meta `ViewContent` pixel event).
@@ -40,7 +40,7 @@ module Zernio
     # Purchases (Meta `Purchase` pixel event). Pair with `purchaseValue` for revenue.
     attr_accessor :purchases
 
-    # Leads, from either the website pixel or an instant form — whichever the ad uses.
+    # Leads, from either the website pixel or an instant form, whichever the ad uses.
     attr_accessor :leads
 
     # Completed registrations (Meta `CompleteRegistration` pixel event).
@@ -49,7 +49,7 @@ module Zernio
     # Mobile app installs attributed to the ad.
     attr_accessor :app_installs
 
-    # Messaging conversations started within 7 days — the headline metric for click-to-WhatsApp and click-to-Messenger ads.
+    # Messaging conversations started within 7 days, the headline metric for click-to-WhatsApp and click-to-Messenger ads.
     attr_accessor :messaging_conversations_started
 
     # Messaging threads where the person sent a first reply.

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

@@ -17,7 +17,7 @@ module Zernio
   class AdKeyword < ApiModelBase
     attr_accessor :id
 
-    # Social account ID owning the sync
+    # Account ID owning the sync
     attr_accessor :account_id
 
     attr_accessor :profile_id

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

@@ -44,16 +44,16 @@ module Zernio
     # Derived spend / conversions in the same currency as spend. 0 when conversions is 0.
     attr_accessor :cost_per_conversion
 
-    # 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. TikTok: pixel conversions (purchase, add_to_cart, initiate_checkout, view_content, complete_payment, lead) plus the paid-engagement family (follow, post_reaction for paid likes, comment, share) — follow is how FOLLOWERS-goal campaigns report their result. 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.
+    # 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, ...), covering both engagement and conversion events. TikTok: pixel conversions (purchase, add_to_cart, initiate_checkout, view_content, complete_payment, lead) plus the paid-engagement family (follow, post_reaction for paid likes, comment, share). Follow is how FOLLOWERS-goal campaigns report their result. 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.
     attr_accessor :actions
 
-    # 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 {}.
+    # 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 {}.
     attr_accessor :action_values
 
-    # Convenience sum of purchase-type action values — picked from `actionValues` via the same priority list as `conversions` so both fields describe the same events. In ad-account native currency. 0 when the campaign has no purchase event configured. Meta-only.
+    # Convenience sum of purchase-type action values, picked from `actionValues` via the same priority list as `conversions` so both fields describe the same events. In ad-account native currency. 0 when the campaign has no purchase event configured. Meta-only.
     attr_accessor :purchase_value
 
-    # Return on ad spend — derived as `purchaseValue / spend`. 0 when `spend` is 0. Equivalent to Meta's `purchase_roas` under default attribution. At ad-set and campaign levels this is recomputed from summed purchaseValue + spend (NOT averaged across children) so it's mathematically correct at every rollup level.
+    # Return on ad spend, derived as `purchaseValue / spend`. 0 when `spend` is 0. Equivalent to Meta's `purchase_roas` under default attribution. At ad-set and campaign levels this is recomputed from summed purchaseValue + spend (NOT averaged across children) so it's mathematically correct at every rollup level.
     attr_accessor :roas
 
     # Derived `spend / actions[type]` for every action type with a non-zero count, in ad-account native currency. Same keys as `actions`. Rounded to 4 decimals because cheap actions cost well under a cent. Recomputed from summed spend + counts at every rollup level. Empty object when spend is 0 or no actions are reported.

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

@@ -23,7 +23,7 @@ module Zernio
     # Derived from child ad statuses
     attr_accessor :status
 
-    # Earliest `platformCreatedAt` (platform ad creation time; falls back to `createdAt`, Zernio's sync time, for ads synced before that field existed) across this ad set's ads. Not the ad set's own creation time on the platform — a proxy usable for sorting.
+    # Earliest `platformCreatedAt` (platform ad creation time; falls back to `createdAt`, Zernio's sync time, for ads synced before that field existed) across this ad set's ads. Not the ad set's own creation time on the platform, but a proxy usable for sorting.
     attr_accessor :created_time
 
     attr_accessor :ad_count

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

@@ -22,7 +22,7 @@ module Zernio
 
     attr_accessor :campaign_name
 
-    # Earliest `platformCreatedAt` (platform ad creation time; falls back to `createdAt`, Zernio's sync time, for ads synced before that field existed) across every ad in the campaign. Not the platform campaign's own creation time (Meta's `Campaign.created_time` etc. is not synced) — a campaign created empty and populated later will show its first ad's time, not the campaign's. Usable for sorting \"most recently created\" without the numeric-campaign-id heuristic. Same source as `AdTreeAdSet.createdTime` and `Ad.platformCreatedAt`; mirrors `AdCampaign.earliestAd`.
+    # Earliest `platformCreatedAt` (platform ad creation time; falls back to `createdAt`, Zernio's sync time, for ads synced before that field existed) across every ad in the campaign. Not the platform campaign's own creation time (Meta's `Campaign.created_time` etc. is not synced). A campaign created empty and populated later will show its first ad's time, not the campaign's. Usable for sorting \"most recently created\" without the numeric-campaign-id heuristic. Same source as `AdTreeAdSet.createdTime` and `Ad.platformCreatedAt`; mirrors `AdCampaign.earliestAd`.
     attr_accessor :created_time
 
     # Delivery status derived from child ad statuses. Distinct from `reviewStatus`, which reflects the platform-side review state.
@@ -48,7 +48,7 @@ module Zernio
     # Canonical CBO/ABO indicator. `campaign` = CBO (Advantage Campaign Budget, budget lives on the campaign). `adset` = ABO (budget lives on each ad set). Route budget updates to the matching Meta entity.
     attr_accessor :budget_level
 
-    # Meta-only. Mirrors Campaign.is_budget_schedule_enabled — true when the campaign uses budget scheduling (time-based budget changes). Independent of CBO/ABO.
+    # Meta-only. Mirrors Campaign.is_budget_schedule_enabled: true when the campaign uses budget scheduling (time-based budget changes). Independent of CBO/ABO.
     attr_accessor :is_budget_schedule_enabled
 
     # ISO 4217 currency code (e.g. USD, EUR, CLP, JPY) for all budget amounts in this campaign node. Budgets are NOT normalized to USD.
@@ -78,14 +78,14 @@ module Zernio
     # 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).
+    # Representative ROAS floor for the campaign, bubbled up from the top-spending ad set. Decimal multiplier (2.0 = 2.0x).
     attr_accessor :roas_average_floor
 
     attr_accessor :promoted_object
 
     attr_accessor :ad_sets
 
-    # Per-day metric series for this campaign. Present only when `GET /v1/ads/tree` is called with `timeIncrement=1` (any `dailyLevel`). This is the per-campaign daily trend — summing its additive fields reproduces the campaign `metrics` total, except `reach`: on Meta the range total is de-duplicated, so daily reach does not sum to it.
+    # Per-day metric series for this campaign. Present only when `GET /v1/ads/tree` is called with `timeIncrement=1` (any `dailyLevel`). This is the per-campaign daily trend. Summing its additive fields reproduces the campaign `metrics` total, except `reach`: on Meta the range total is de-duplicated, so daily reach does not sum to it.
     attr_accessor :daily
 
     class EnumAttributeValidator

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

@@ -15,7 +15,7 @@ require 'time'
 
 module Zernio
   class AddAdKeywordsRequest < ApiModelBase
-    # Social account ID (Google Ads)
+    # Account ID (Google Ads)
     attr_accessor :account_id
 
     # Google ad group ID to add the keywords to

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

@@ -15,7 +15,7 @@ require 'time'
 
 module Zernio
   class AddMessageReactionRequest < ApiModelBase
-    # Social account ID
+    # Account ID
     attr_accessor :account_id
 
     # Emoji character (e.g. \"👍\", \"❤️\")

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

@@ -23,21 +23,21 @@ module Zernio
     # Transaction ID of the original conversion (the `eventId` you sent). Recommended; required for ENHANCEMENT.
     attr_accessor :order_id
 
-    # Alternative key — the original click ID. Pair with `conversionTime`. Not valid for ENHANCEMENT.
+    # Alternative key. The original click ID. Pair with `conversionTime`. Not valid for ENHANCEMENT.
     attr_accessor :gclid
 
     # The original conversion's time, unix seconds. Required when identifying by `gclid`.
     attr_accessor :conversion_time
 
-    # RESTATEMENT only — the corrected TOTAL conversion value.
+    # RESTATEMENT only. The corrected TOTAL conversion value.
     attr_accessor :restatement_value
 
-    # RESTATEMENT only — ISO 4217 currency for `restatementValue`.
+    # RESTATEMENT only. ISO 4217 currency for `restatementValue`.
     attr_accessor :currency
 
     attr_accessor :user
 
-    # ENHANCEMENT only — the original conversion's user agent (improves match quality).
+    # ENHANCEMENT only. The original conversion's user agent (improves match quality).
     attr_accessor :user_agent
 
     class EnumAttributeValidator

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

@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module Zernio
-  # ENHANCEMENT only — first-party identifiers (hashed server-side). At least one of email/phone required.
+  # ENHANCEMENT only. First-party identifiers (hashed server-side). At least one of email/phone required.
   class AdjustConversionsRequestAdjustmentsInnerUser < ApiModelBase
     attr_accessor :email
 

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

@@ -29,7 +29,7 @@ module Zernio
 
     attr_accessor :engagement
 
-    # Click-through rate as a percentage (0–100).
+    # Click-through rate as a percentage (0 to 100).
     attr_accessor :ctr
 
     # Cost per click in native currency.

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

@@ -19,7 +19,7 @@ module Zernio
     # External post ID. The same identifier as `posts[]._id` in GET /v1/analytics.
     attr_accessor :post_id
 
-    # Social account this post was published through
+    # Account this post was published through
     attr_accessor :account_id
 
     # Profile the account belongs to

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

@@ -21,7 +21,7 @@ module Zernio
 
     attr_accessor :pagination
 
-    # Connected social accounts (followerCount and followersLastUpdated only included if user has analytics add-on)
+    # Connected accounts (followerCount and followersLastUpdated only included if user has analytics add-on)
     attr_accessor :accounts
 
     # Whether user has analytics add-on access

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

@@ -37,7 +37,7 @@ module Zernio
     # 'read-write' allows all operations, 'read' restricts to GET requests only
     attr_accessor :permission
 
-    # Resource groups this key can NOT access (opt-out denylist). Absent or empty means legacy full access. A key with any group disabled is a restricted key (zrk_ prefix) and can never manage API keys, invites, or member identity. Each operation's group is published as x-resource-group. With 'messages' disabled, the key cannot read or send private messages through any API surface, and it cannot create or edit a webhook subscription broader than itself: it cannot subscribe to, test-fire, redeliver, or read delivery logs for message events. Subscriptions created earlier, from the dashboard, or with a full-access key keep delivering whatever their own `disabledResourceGroups` allows, so restricting an existing integration end to end means restricting the subscription too. OAuth connector tokens (AI assistants and MCP clients) resolve against the same registry, but their groups are not settable yet: treat an authorized connector as full access.
+    # Resource groups this key can NOT access (opt-out denylist). Absent or empty means legacy full access. A key with any group disabled is a restricted key (zrk_ prefix) and can never manage API keys, invites, or member identity. Each operation's group is published as x-resource-group. With 'messages' disabled, the key cannot read or send direct messages through any API surface, and it cannot create or edit a webhook subscription broader than itself: it cannot subscribe to, test-fire, redeliver, or read delivery logs for message events. Subscriptions created earlier, from the dashboard, or with a full-access key keep delivering whatever their own `disabledResourceGroups` allows, so restricting an existing integration end to end means restricting the subscription too. OAuth connector tokens (AI assistants and MCP clients) resolve against the same registry, but their groups are not settable yet: treat an authorized connector as full access.
     attr_accessor :disabled_resource_groups
 
     class EnumAttributeValidator

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

@@ -15,7 +15,7 @@ require 'time'
 
 module Zernio
   class AppealSmsRegistrationRequest < ApiModelBase
-    # Goes verbatim to the carrier reviewer — address the decline reason directly.
+    # Goes verbatim to the carrier reviewer. Address the decline reason directly.
     attr_accessor :appeal_reason
 
     # Corrected opt-in flow; include a link to the opt-in page/form.

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

@@ -28,7 +28,7 @@ module Zernio
     # Human-readable location display name (e.g. \"Snap Fitness Dianella\"), NOT a resource name. Do not use it to build API paths.
     attr_accessor :selected_location_name
 
-    # Bare GBP location id (digits only). Combine with the GBP account id as accounts/{gbpAccountId}/locations/{selectedLocationId} to form the location resource names that gmb-reviews/batch expects in locationNames.
+    # Bare Google Business Profile location id (digits only). Combine with the Google Business Profile account id as accounts/{gbpAccountId}/locations/{selectedLocationId} to form the location resource names that gmb-reviews/batch expects in locationNames.
     attr_accessor :selected_location_id
 
     # Attribute mapping from ruby-style variable name to JSON key.

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

@@ -18,10 +18,10 @@ module Zernio
     # Target profile to connect the location onto.
     attr_accessor :profile_id
 
-    # The Google Business location ID to assign (e.g. \"locations/123\").
+    # The Google Business Profile location ID to assign (e.g. \"locations/123\").
     attr_accessor :selected_location_id
 
-    # Optional but recommended. The Google Business Account resource name (\"accounts/123\") that owns the location (from GET gmb-locations). When provided the location is resolved directly instead of by enumerating the account, required for accounts with many locations. 
+    # Optional but recommended. The Google Business Profile Account resource name (\"accounts/123\") that owns the location (from GET gmb-locations). When provided the location is resolved directly instead of by enumerating the account, required for accounts with many locations. 
     attr_accessor :google_account_id
 
     # Attribute mapping from ruby-style variable name to JSON key.

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

@@ -15,13 +15,13 @@ require 'time'
 
 module Zernio
   class AttachCampaignAssetsRequest < ApiModelBase
-    # Zernio Google Ads SocialAccount id — resolves the customer id + refresh token.
+    # Zernio Google Ads SocialAccount id. Resolves the customer id + refresh token.
     attr_accessor :account_id
 
     # Numeric Google Ads customer id. Required when the connection has multiple Google Ads accounts; optional (and inferred) when it has only one.
     attr_accessor :customer_id
 
-    # See POST /v1/ads/create sitelinks — same shape.
+    # See POST /v1/ads/create sitelinks, same shape.
     attr_accessor :sitelinks
 
     attr_accessor :callouts

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

@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module Zernio
-  # Account billing state — plan, cycle, balance, spend caps, and payment / access status. Returned by `GET /v1/billing`. 
+  # Account billing state: plan, cycle, balance, spend caps, and payment / access status. Returned by `GET /v1/billing`. 
   class BillingSnapshot < ApiModelBase
     attr_accessor :billing_system
 

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

@@ -19,7 +19,7 @@ module Zernio
 
     attr_accessor :is_usage_based
 
-    # True when the key belongs to an account with an active paid billing relationship (Stripe subscription, Metronome enrollment, or Shopify-managed billing).
+    # True when the key belongs to an account with an active paid billing relationship (Stripe subscription, usage-based billing, or Shopify-managed billing).
     attr_accessor :is_paid
 
     # Attribute mapping from ruby-style variable name to JSON key.

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

@@ -15,7 +15,7 @@ require 'time'
 
 module Zernio
   class BlockWhatsAppUsersRequest < ApiModelBase
-    # WhatsApp social account ID
+    # WhatsApp account ID
     attr_accessor :account_id
 
     # Phone numbers (E.164, e.g. \"+16505551234\") or WhatsApp user IDs to block.

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

@@ -15,7 +15,7 @@ require 'time'
 
 module Zernio
   class BookmarkPostRequest < ApiModelBase
-    # The social account ID
+    # The account ID
     attr_accessor :account_id
 
     # The ID of the tweet to bookmark

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

@@ -21,7 +21,7 @@ module Zernio
     # Platform post ID (alternative to postId)
     attr_accessor :platform_post_id
 
-    # Social account ID
+    # Account ID
     attr_accessor :account_id
 
     # Platform ad account ID
@@ -29,7 +29,7 @@ module Zernio
 
     attr_accessor :name
 
-    # Available goals vary by platform. Meta (Facebook/Instagram) and TikTok support all 7. LinkedIn supports all except app_promotion. Twitter/X supports engagement, traffic, awareness, video_views, app_promotion. Pinterest and Google Ads support only engagement, traffic, awareness, video_views.
+    # Available goals vary by platform. Meta (Facebook/Instagram) and TikTok support all 7. LinkedIn supports all except app_promotion. X supports engagement, traffic, awareness, video_views, app_promotion. Pinterest and Google Ads support only engagement, traffic, awareness, video_views.
     attr_accessor :goal
 
     # Meta only. Attach the boosted post to this existing ad set instead of creating a campaign. The ad set then owns budget, schedule and targeting; sending those too is a 400.
@@ -40,7 +40,7 @@ module Zernio
     # Meta only. Instagram identity the ad runs AS (creative.instagram_user_id), overriding the account linked to the Page. Live-verified against a Page-post creative.
     attr_accessor :instagram_account_id
 
-    # Meta only. Ad-set destination_type — where the click LANDS, as opposed to instagramAccountId which is who the ad runs as. Lead ads force ON_AD and ignore this.
+    # Meta only. Ad-set destination_type: where the click LANDS, as opposed to instagramAccountId which is who the ad runs as. Lead ads force ON_AD and ignore this.
     attr_accessor :destination_type
 
     # ISO 4217 currency code matching the ad account's currency. Meta only. Optional: Zernio resolves it from the ad account when omitted. The value selects the minor-unit exponent Zernio converts budget/bid amounts by before calling Meta (most currencies are cents; zero-decimal currencies like JPY/KRW are sent as-is).
@@ -81,10 +81,10 @@ module Zernio
     # Destination URL for the CTA button. Send it together with `callToAction`.  **Meta**: adds a top-level `call_to_action` to the post-reference creative. This is what gives a `traffic` boost a clickable destination without replacing the creative and losing the post's social proof. Ignored when `leadGenFormId` is set, which supplies its own destination. Live-verified against a Page-post creative.  **TikTok**: maps to `landing_page_url` on the Spark Ad creative (`AdcreateCreatives.landing_page_url`); Spark Ads have no clickable destination without it.  Ignored on LinkedIn / Pinterest / X / Google, which infer the destination from the boosted post. 
     attr_accessor :link_url
 
-    # CTA button label. Send it together with `linkUrl` — a CTA without a destination produces a button that goes nowhere, so sending one alone is a 400.  **Meta**: the CTA enum of POST /v1/ads/create plus `VIEW_INSTAGRAM_PROFILE`, which is accepted on boost only. For that value `linkUrl` is typically the Instagram profile URL.  **TikTok**: pass-through to `call_to_action` on the Spark Ad creative; the platform validates the value. See TikTok's \"Enumeration - Call-to-Action\". 
+    # CTA button label. Send it together with `linkUrl`: a CTA without a destination produces a button that goes nowhere, so sending one alone is a 400.  **Meta**: the CTA enum of POST /v1/ads/create plus `VIEW_INSTAGRAM_PROFILE`, which is accepted on boost only. For that value `linkUrl` is typically the Instagram profile URL.  **TikTok**: pass-through to `call_to_action` on the Spark Ad creative; the platform validates the value. See TikTok's \"Enumeration - Call-to-Action\". 
     attr_accessor :call_to_action
 
-    # TikTok-only. Spark Code (creator's `auth_code`) authorizing cross-creator Spark Ads — the advertiser can boost a video owned by a DIFFERENT TikTok account. Without this, boosts are limited to videos owned by the same account running the ads (same-BC creators only). The creator generates the code in their TikTok app's Promote settings and shares it with the advertiser. Maps to `auth_code` on the creative entry of /v2/ad/create/. 
+    # TikTok-only. Spark Code (creator's `auth_code`) authorizing cross-creator Spark Ads: the advertiser can boost a video owned by a DIFFERENT TikTok account. Without this, boosts are limited to videos owned by the same account running the ads (same-BC creators only). The creator generates the code in their TikTok app's Promote settings and shares it with the advertiser. Maps to `auth_code` on the creative entry of /v2/ad/create/. 
     attr_accessor :spark_auth_code
 
     # Legal entity that benefits from the ad. Required when targeting EU users (EU DSA, Article 26). Optional if the ad account has a default beneficiary: set it once via `PATCH /v1/ads/accounts` or in Meta Ads Manager, and Meta fills it in whenever the field is omitted. 

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

@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module Zernio
-  # Platform-specific options. The platform is derived from `accountId`; sending options for a different platform returns a 400. LinkedIn (campaign bidding and delivery controls) and Meta (the bid trio) have options today.  **Meta**: `bidStrategy`, `bidAmount` and `roasAverageFloor` may be sent here instead of at the root — the preferred home going forward. Sending the bid fields in BOTH places returns a 400 (`mutually_exclusive_fields`). 
+  # Platform-specific options. The platform is derived from `accountId`; sending options for a different platform returns a 400. LinkedIn (campaign bidding and delivery controls) and Meta (the bid trio) have options today.  **Meta**: `bidStrategy`, `bidAmount` and `roasAverageFloor` may be sent here instead of at the root, which is the preferred home going forward. Sending the bid fields in BOTH places returns a 400 (`mutually_exclusive_fields`). 
   module BoostPostRequestPlatformSpecificData
     class << self
       # List of class defined in oneOf (OpenAPI v3)

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

@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module Zernio
-  # TikTok Business Center entity. Returned by `GET /v1/ads/business-centers`. BCs are TikTok's agency container — one BC owns N advertisers (ad accounts). Most solo advertisers don't have one; the agency token uses BCs to roll up multi-client access. 
+  # TikTok Business Center entity. Returned by `GET /v1/ads/business-centers`. BCs are TikTok's agency container: one BC owns N advertisers (ad accounts). Most solo advertisers don't have one; the agency token uses BCs to roll up multi-client access. 
   class BusinessCenter < ApiModelBase
     # Business Center ID
     attr_accessor :bc_id
@@ -22,7 +22,7 @@ module Zernio
     # Display name set by the BC owner
     attr_accessor :name
 
-    # Number of advertisers reachable under this BC for the calling token. `null` when the BC asset walk returned empty or failed (typical for agency apps without full BC asset read scope) — distinct from `0`, which would imply the BC genuinely has no advertisers. 
+    # Number of advertisers reachable under this BC for the calling token. `null` when the BC asset walk returned empty or failed (typical for agency apps without full BC asset read scope), distinct from `0`, which would imply the BC genuinely has no advertisers. 
     attr_accessor :advertiser_count
 
     # Attribute mapping from ruby-style variable name to JSON key.

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

@@ -18,7 +18,7 @@ module Zernio
   class CallRecord < ApiModelBase
     attr_accessor :_id
 
-    # Owning social account. The unified /v1/calls/{id} detail + recording endpoints work for any channel; the channel-specific endpoints remain for account-scoped access.
+    # Owning account. The unified /v1/calls/{id} detail + recording endpoints work for any channel; the channel-specific endpoints remain for account-scoped access.
     attr_accessor :account_id
 
     # Inbox conversation with the counterparty, when one exists.
@@ -77,7 +77,7 @@ module Zernio
 
     attr_accessor :end_reason
 
-    # Raw carrier hangup cause behind endReason (e.g. normal_clearing, not_found, time_limit) — the actual motive when endReason is a coarse bucket.
+    # Raw carrier hangup cause behind endReason (e.g. normal_clearing, not_found, time_limit). The actual motive when endReason is a coarse bucket.
     attr_accessor :hangup_cause
 
     # SIP response code that ended the call, when SIP-signalled (e.g. '403', '488'). The real failure reason for SIP legs.

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

@@ -44,16 +44,16 @@ module Zernio
     # Derived spend / conversions in the same currency as spend. 0 when conversions is 0.
     attr_accessor :cost_per_conversion
 
-    # 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. TikTok: pixel conversions (purchase, add_to_cart, initiate_checkout, view_content, complete_payment, lead) plus the paid-engagement family (follow, post_reaction for paid likes, comment, share) — follow is how FOLLOWERS-goal campaigns report their result. 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.
+    # 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, ...), covering both engagement and conversion events. TikTok: pixel conversions (purchase, add_to_cart, initiate_checkout, view_content, complete_payment, lead) plus the paid-engagement family (follow, post_reaction for paid likes, comment, share). Follow is how FOLLOWERS-goal campaigns report their result. 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.
     attr_accessor :actions
 
-    # 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 {}.
+    # 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 {}.
     attr_accessor :action_values
 
-    # Convenience sum of purchase-type action values — picked from `actionValues` via the same priority list as `conversions` so both fields describe the same events. In ad-account native currency. 0 when the campaign has no purchase event configured. Meta-only.
+    # Convenience sum of purchase-type action values, picked from `actionValues` via the same priority list as `conversions` so both fields describe the same events. In ad-account native currency. 0 when the campaign has no purchase event configured. Meta-only.
     attr_accessor :purchase_value
 
-    # Return on ad spend — derived as `purchaseValue / spend`. 0 when `spend` is 0. Equivalent to Meta's `purchase_roas` under default attribution. At ad-set and campaign levels this is recomputed from summed purchaseValue + spend (NOT averaged across children) so it's mathematically correct at every rollup level.
+    # Return on ad spend, derived as `purchaseValue / spend`. 0 when `spend` is 0. Equivalent to Meta's `purchase_roas` under default attribution. At ad-set and campaign levels this is recomputed from summed purchaseValue + spend (NOT averaged across children) so it's mathematically correct at every rollup level.
     attr_accessor :roas
 
     # Derived `spend / actions[type]` for every action type with a non-zero count, in ad-account native currency. Same keys as `actions`. Rounded to 4 decimals because cheap actions cost well under a cent. Recomputed from summed spend + counts at every rollup level. Empty object when spend is 0 or no actions are reported.

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

@@ -24,7 +24,7 @@ module Zernio
 
     attr_accessor :address_constraint
 
-    # For `geo` only — the area(s) the registered address must be in.
+    # For `geo` only: the area(s) the registered address must be in.
     attr_accessor :areas
 
     # Live inventory grouped by area code. For US and CA this is the full country inventory (every area code with stock, recognizable metros listed first, then alphabetical); other countries are ordered largest stock first; they list the areas in the latest inventory page (up to 500 numbers, which for most countries is the entire pool). Empty when out of stock (or the area lookup failed). Pass a chosen `ndc` as `areaCode` on POST /v1/phone-numbers/purchase (or on the KYC submit for regulated countries) to require that area. 

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

@@ -25,10 +25,10 @@ module Zernio
     # Line type when known (mobile, landline, voip…). A US/CA mobile number requires the transfer PIN at submit.
     attr_accessor :line_type
 
-    # ISO country of the number — pass it to GET /v1/phone-numbers/port-in/requirements for international numbers.
+    # ISO country of the number. Pass it to GET /v1/phone-numbers/port-in/requirements for international numbers.
     attr_accessor :country_code
 
-    # Carrier number-type classification (local, mobile, national, toll_free…) — the numberType for the requirements endpoint.
+    # Carrier number-type classification (local, mobile, national, toll_free…), the numberType for the requirements endpoint.
     attr_accessor :phone_number_type
 
     # Carrier reason when not portable; null when portable.

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

@@ -15,17 +15,18 @@ require 'time'
 
 module Zernio
   class ConnectWhatsAppEmbeddedSignupRequest < ApiModelBase
-    # Authorization code from the WA_EMBEDDED_SIGNUP postMessage
+    # Authorization code from the FB.login response (authResponse.code)
     attr_accessor :code
 
     attr_accessor :profile_id
 
-    # WhatsApp Business Account id, when the SDK reported one
+    # waba_id from the WA_EMBEDDED_SIGNUP message event
     attr_accessor :waba_id
 
+    # phone_number_id from the WA_EMBEDDED_SIGNUP message event. With wabaId it skips the number picker.
     attr_accessor :phone_number_id
 
-    # Number is also live in the WhatsApp Business app
+    # Set when the popup ended with the FINISH_WHATSAPP_BUSINESS_APP_ONBOARDING event, so the number stays live in the WhatsApp Business app
     attr_accessor :is_coexistence
 
     # Rejects the connect when Meta returns a different number