late-sdk 0.0.681 → 0.0.682

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

@@ -0,0 +1,269 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require '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. 
+  class AdFunnelCounts < ApiModelBase
+    # 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).
+    attr_accessor :content_views
+
+    # On-site searches (Meta `Search` pixel event).
+    attr_accessor :searches
+
+    # Adds to wishlist (Meta `AddToWishlist` pixel event).
+    attr_accessor :wishlist_adds
+
+    # Adds to cart (Meta `AddToCart` pixel event).
+    attr_accessor :cart_adds
+
+    # Checkouts started (Meta `InitiateCheckout` pixel event).
+    attr_accessor :checkouts_initiated
+
+    # Payment details added at checkout (Meta `AddPaymentInfo` pixel event).
+    attr_accessor :payment_info_adds
+
+    # 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.
+    attr_accessor :leads
+
+    # Completed registrations (Meta `CompleteRegistration` pixel event).
+    attr_accessor :registrations_completed
+
+    # 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.
+    attr_accessor :messaging_conversations_started
+
+    # Messaging threads where the person sent a first reply.
+    attr_accessor :messaging_first_replies
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'landing_page_views' => :'landingPageViews',
+        :'content_views' => :'contentViews',
+        :'searches' => :'searches',
+        :'wishlist_adds' => :'wishlistAdds',
+        :'cart_adds' => :'cartAdds',
+        :'checkouts_initiated' => :'checkoutsInitiated',
+        :'payment_info_adds' => :'paymentInfoAdds',
+        :'purchases' => :'purchases',
+        :'leads' => :'leads',
+        :'registrations_completed' => :'registrationsCompleted',
+        :'app_installs' => :'appInstalls',
+        :'messaging_conversations_started' => :'messagingConversationsStarted',
+        :'messaging_first_replies' => :'messagingFirstReplies'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'landing_page_views' => :'Integer',
+        :'content_views' => :'Integer',
+        :'searches' => :'Integer',
+        :'wishlist_adds' => :'Integer',
+        :'cart_adds' => :'Integer',
+        :'checkouts_initiated' => :'Integer',
+        :'payment_info_adds' => :'Integer',
+        :'purchases' => :'Integer',
+        :'leads' => :'Integer',
+        :'registrations_completed' => :'Integer',
+        :'app_installs' => :'Integer',
+        :'messaging_conversations_started' => :'Integer',
+        :'messaging_first_replies' => :'Integer'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::AdFunnelCounts` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::AdFunnelCounts`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'landing_page_views')
+        self.landing_page_views = attributes[:'landing_page_views']
+      end
+
+      if attributes.key?(:'content_views')
+        self.content_views = attributes[:'content_views']
+      end
+
+      if attributes.key?(:'searches')
+        self.searches = attributes[:'searches']
+      end
+
+      if attributes.key?(:'wishlist_adds')
+        self.wishlist_adds = attributes[:'wishlist_adds']
+      end
+
+      if attributes.key?(:'cart_adds')
+        self.cart_adds = attributes[:'cart_adds']
+      end
+
+      if attributes.key?(:'checkouts_initiated')
+        self.checkouts_initiated = attributes[:'checkouts_initiated']
+      end
+
+      if attributes.key?(:'payment_info_adds')
+        self.payment_info_adds = attributes[:'payment_info_adds']
+      end
+
+      if attributes.key?(:'purchases')
+        self.purchases = attributes[:'purchases']
+      end
+
+      if attributes.key?(:'leads')
+        self.leads = attributes[:'leads']
+      end
+
+      if attributes.key?(:'registrations_completed')
+        self.registrations_completed = attributes[:'registrations_completed']
+      end
+
+      if attributes.key?(:'app_installs')
+        self.app_installs = attributes[:'app_installs']
+      end
+
+      if attributes.key?(:'messaging_conversations_started')
+        self.messaging_conversations_started = attributes[:'messaging_conversations_started']
+      end
+
+      if attributes.key?(:'messaging_first_replies')
+        self.messaging_first_replies = attributes[:'messaging_first_replies']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      true
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          landing_page_views == o.landing_page_views &&
+          content_views == o.content_views &&
+          searches == o.searches &&
+          wishlist_adds == o.wishlist_adds &&
+          cart_adds == o.cart_adds &&
+          checkouts_initiated == o.checkouts_initiated &&
+          payment_info_adds == o.payment_info_adds &&
+          purchases == o.purchases &&
+          leads == o.leads &&
+          registrations_completed == o.registrations_completed &&
+          app_installs == o.app_installs &&
+          messaging_conversations_started == o.messaging_conversations_started &&
+          messaging_first_replies == o.messaging_first_replies
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [landing_page_views, content_views, searches, wishlist_adds, cart_adds, checkouts_initiated, payment_info_adds, purchases, leads, registrations_completed, app_installs, messaging_conversations_started, messaging_first_replies].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

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

@@ -80,6 +80,13 @@ module Zernio
     # Average seconds watched per play (Meta `video_avg_time_watched_actions`). Aggregated over date ranges and across children as a play-weighted average (total watch time / total plays), never a plain average of averages.
     attr_accessor :video_avg_time_watched_actions
 
+    # Derived `spend / videoThruplayWatchedActions`, in ad-account native currency. Rounded to 4 decimals rather than the usual 2 because a ThruPlay routinely costs well under a cent. 0 when the ad has no ThruPlays.
+    attr_accessor :cost_per_thruplay
+
+    attr_accessor :funnel
+
+    attr_accessor :engagement_breakdown
+
     # Present on individual ads only, not on campaign aggregations
     attr_accessor :last_synced_at
 
@@ -109,6 +116,9 @@ module Zernio
         :'video_p95_watched_actions' => :'videoP95WatchedActions',
         :'video_p100_watched_actions' => :'videoP100WatchedActions',
         :'video_avg_time_watched_actions' => :'videoAvgTimeWatchedActions',
+        :'cost_per_thruplay' => :'costPerThruplay',
+        :'funnel' => :'funnel',
+        :'engagement_breakdown' => :'engagementBreakdown',
         :'last_synced_at' => :'lastSyncedAt'
       }
     end
@@ -149,6 +159,9 @@ module Zernio
         :'video_p95_watched_actions' => :'Integer',
         :'video_p100_watched_actions' => :'Integer',
         :'video_avg_time_watched_actions' => :'Float',
+        :'cost_per_thruplay' => :'Float',
+        :'funnel' => :'AdFunnelCounts',
+        :'engagement_breakdown' => :'AdEngagementCounts',
         :'last_synced_at' => :'Time'
       }
     end
@@ -271,6 +284,18 @@ module Zernio
         self.video_avg_time_watched_actions = attributes[:'video_avg_time_watched_actions']
       end
 
+      if attributes.key?(:'cost_per_thruplay')
+        self.cost_per_thruplay = attributes[:'cost_per_thruplay']
+      end
+
+      if attributes.key?(:'funnel')
+        self.funnel = attributes[:'funnel']
+      end
+
+      if attributes.key?(:'engagement_breakdown')
+        self.engagement_breakdown = attributes[:'engagement_breakdown']
+      end
+
       if attributes.key?(:'last_synced_at')
         self.last_synced_at = attributes[:'last_synced_at']
       end
@@ -319,6 +344,9 @@ module Zernio
           video_p95_watched_actions == o.video_p95_watched_actions &&
           video_p100_watched_actions == o.video_p100_watched_actions &&
           video_avg_time_watched_actions == o.video_avg_time_watched_actions &&
+          cost_per_thruplay == o.cost_per_thruplay &&
+          funnel == o.funnel &&
+          engagement_breakdown == o.engagement_breakdown &&
           last_synced_at == o.last_synced_at
     end
 
@@ -331,7 +359,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [spend, impressions, reach, clicks, ctr, cpc, cpm, engagement, conversions, cost_per_conversion, actions, action_values, purchase_value, roas, video_play_actions, video30_sec_watched_actions, video_thruplay_watched_actions, video_p25_watched_actions, video_p50_watched_actions, video_p75_watched_actions, video_p95_watched_actions, video_p100_watched_actions, video_avg_time_watched_actions, last_synced_at].hash
+      [spend, impressions, reach, clicks, ctr, cpc, cpm, engagement, conversions, cost_per_conversion, actions, action_values, purchase_value, roas, video_play_actions, video30_sec_watched_actions, video_thruplay_watched_actions, video_p25_watched_actions, video_p50_watched_actions, video_p75_watched_actions, video_p95_watched_actions, video_p100_watched_actions, video_avg_time_watched_actions, cost_per_thruplay, funnel, engagement_breakdown, last_synced_at].hash
     end
 
     # Builds the object from hash

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

@@ -80,6 +80,13 @@ module Zernio
     # Average seconds watched per play (Meta `video_avg_time_watched_actions`). Aggregated over date ranges and across children as a play-weighted average (total watch time / total plays), never a plain average of averages.
     attr_accessor :video_avg_time_watched_actions
 
+    # Derived `spend / videoThruplayWatchedActions`, in ad-account native currency. Rounded to 4 decimals rather than the usual 2 because a ThruPlay routinely costs well under a cent. 0 when the ad has no ThruPlays.
+    attr_accessor :cost_per_thruplay
+
+    attr_accessor :funnel
+
+    attr_accessor :engagement_breakdown
+
     # Present on individual ads only, not on campaign aggregations
     attr_accessor :last_synced_at
 
@@ -111,6 +118,9 @@ module Zernio
         :'video_p95_watched_actions' => :'videoP95WatchedActions',
         :'video_p100_watched_actions' => :'videoP100WatchedActions',
         :'video_avg_time_watched_actions' => :'videoAvgTimeWatchedActions',
+        :'cost_per_thruplay' => :'costPerThruplay',
+        :'funnel' => :'funnel',
+        :'engagement_breakdown' => :'engagementBreakdown',
         :'last_synced_at' => :'lastSyncedAt',
         :'date' => :'date'
       }
@@ -152,6 +162,9 @@ module Zernio
         :'video_p95_watched_actions' => :'Integer',
         :'video_p100_watched_actions' => :'Integer',
         :'video_avg_time_watched_actions' => :'Float',
+        :'cost_per_thruplay' => :'Float',
+        :'funnel' => :'AdFunnelCounts',
+        :'engagement_breakdown' => :'AdEngagementCounts',
         :'last_synced_at' => :'Time',
         :'date' => :'Date'
       }
@@ -282,6 +295,18 @@ module Zernio
         self.video_avg_time_watched_actions = attributes[:'video_avg_time_watched_actions']
       end
 
+      if attributes.key?(:'cost_per_thruplay')
+        self.cost_per_thruplay = attributes[:'cost_per_thruplay']
+      end
+
+      if attributes.key?(:'funnel')
+        self.funnel = attributes[:'funnel']
+      end
+
+      if attributes.key?(:'engagement_breakdown')
+        self.engagement_breakdown = attributes[:'engagement_breakdown']
+      end
+
       if attributes.key?(:'last_synced_at')
         self.last_synced_at = attributes[:'last_synced_at']
       end
@@ -334,6 +359,9 @@ module Zernio
           video_p95_watched_actions == o.video_p95_watched_actions &&
           video_p100_watched_actions == o.video_p100_watched_actions &&
           video_avg_time_watched_actions == o.video_avg_time_watched_actions &&
+          cost_per_thruplay == o.cost_per_thruplay &&
+          funnel == o.funnel &&
+          engagement_breakdown == o.engagement_breakdown &&
           last_synced_at == o.last_synced_at &&
           date == o.date
     end
@@ -347,7 +375,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [spend, impressions, reach, clicks, ctr, cpc, cpm, engagement, conversions, cost_per_conversion, actions, action_values, purchase_value, roas, video_play_actions, video30_sec_watched_actions, video_thruplay_watched_actions, video_p25_watched_actions, video_p50_watched_actions, video_p75_watched_actions, video_p95_watched_actions, video_p100_watched_actions, video_avg_time_watched_actions, last_synced_at, date].hash
+      [spend, impressions, reach, clicks, ctr, cpc, cpm, engagement, conversions, cost_per_conversion, actions, action_values, purchase_value, roas, video_play_actions, video30_sec_watched_actions, video_thruplay_watched_actions, video_p25_watched_actions, video_p50_watched_actions, video_p75_watched_actions, video_p95_watched_actions, video_p100_watched_actions, video_avg_time_watched_actions, cost_per_thruplay, funnel, engagement_breakdown, last_synced_at, date].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.681'
+  VERSION = '0.0.682'
 end

data/lib/zernio-sdk.rb

@@ -31,6 +31,8 @@ require 'zernio-sdk/models/ad_campaign_budget'
 require 'zernio-sdk/models/ad_campaign_campaign_budget'
 require 'zernio-sdk/models/ad_creative'
 require 'zernio-sdk/models/ad_daily_metrics'
+require 'zernio-sdk/models/ad_engagement_counts'
+require 'zernio-sdk/models/ad_funnel_counts'
 require 'zernio-sdk/models/ad_metrics'
 require 'zernio-sdk/models/ad_promoted_object'
 require 'zernio-sdk/models/ad_review_status'

data/openapi.yaml

@@ -134,7 +134,7 @@ x-documentation:
 
     Receive real-time notifications for post status changes, account events, and incoming messages:
 
-    - `post.scheduled` - Post created and scheduled for publishing
+    - `post.scheduled` - Post entered the scheduled state: created with a schedule, added to a queue, a draft promoted to scheduled or queued, a failed post retried, or a recycled clone created
     - `post.published` - Post successfully published
     - `post.failed` - Post failed on all platforms
     - `post.partial` - Post published to some platforms, failed on others
@@ -6753,7 +6753,68 @@ components:
         videoAvgTimeWatchedActions:
           type: number
           description: "Average seconds watched per play (Meta `video_avg_time_watched_actions`). Aggregated over date ranges and across children as a play-weighted average (total watch time / total plays), never a plain average of averages."
+        costPerThruplay:
+          type: number
+          description: "Derived `spend / videoThruplayWatchedActions`, in ad-account native currency. Rounded to 4 decimals rather than the usual 2 because a ThruPlay routinely costs well under a cent. 0 when the ad has no ThruPlays."
+        funnel:
+          $ref: '#/components/schemas/AdFunnelCounts'
+        engagementBreakdown:
+          $ref: '#/components/schemas/AdEngagementCounts'
         lastSyncedAt: { type: string, format: date-time, description: "Present on individual ads only, not on campaign aggregations" }
+    AdFunnelCounts:
+      type: object
+      description: |
+        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.
+      properties:
+        landingPageViews: { type: integer, description: "Landing page views — the visitor actually loaded the destination, unlike a link click. Meta `landing_page_view`." }
+        contentViews: { type: integer, description: "Content views (Meta `ViewContent` pixel event)." }
+        searches: { type: integer, description: "On-site searches (Meta `Search` pixel event)." }
+        wishlistAdds: { type: integer, description: "Adds to wishlist (Meta `AddToWishlist` pixel event)." }
+        cartAdds: { type: integer, description: "Adds to cart (Meta `AddToCart` pixel event)." }
+        checkoutsInitiated: { type: integer, description: "Checkouts started (Meta `InitiateCheckout` pixel event)." }
+        paymentInfoAdds: { type: integer, description: "Payment details added at checkout (Meta `AddPaymentInfo` pixel event)." }
+        purchases: { type: integer, description: "Purchases (Meta `Purchase` pixel event). Pair with `purchaseValue` for revenue." }
+        leads: { type: integer, description: "Leads, from either the website pixel or an instant form — whichever the ad uses." }
+        registrationsCompleted: { type: integer, description: "Completed registrations (Meta `CompleteRegistration` pixel event)." }
+        appInstalls: { type: integer, description: "Mobile app installs attributed to the ad." }
+        messagingConversationsStarted: { type: integer, description: "Messaging conversations started within 7 days — the headline metric for click-to-WhatsApp and click-to-Messenger ads." }
+        messagingFirstReplies: { type: integer, description: "Messaging threads where the person sent a first reply." }
+    AdEngagementCounts:
+      type: object
+      description: |
+        The single `engagement` total split into the interactions behind it.
+
+        Note that `engagement` is not the sum of these: Meta's own
+        `post_engagement` and `page_engagement` totals already contain the
+        individual interactions, and all of them are counted into `engagement`.
+        Use these fields when you need a specific interaction, and `engagement`
+        only as the coarse total it has always been.
+
+        Meta-only; other platforms leave these at 0.
+      properties:
+        postEngagement: { type: integer, description: "Meta's own post-engagement total (`post_engagement`)." }
+        pageEngagement: { type: integer, description: "Meta's own page-engagement total (`page_engagement`)." }
+        reactions: { type: integer, description: "Reactions on the ad's post (`post_reaction`)." }
+        comments: { type: integer, description: "Comments on the ad's post." }
+        shares: { type: integer, description: "Shares of the ad's post. Meta reports these under the action type literally named `post`." }
+        saves: { type: integer, description: "Saves of the ad's post (`onsite_conversion.post_save`)." }
+        pageLikes: { type: integer, description: "New Page likes attributed to the ad (`like`)." }
+        videoViews: { type: integer, description: "3-second video views (`video_view`). For completion-based counts use `videoThruplayWatchedActions`." }
+        linkClicks: { type: integer, description: "Attributed link clicks (`link_click`). This is the attribution-window count, which differs from the in-session `inline_link_clicks` reported by `GET /v1/ads/{adId}/analytics`." }
     AdDailyMetrics:
       description: |
         One day of metrics. Same fields as `AdMetrics` plus the `date` they
@@ -7095,6 +7156,11 @@ components:
           allOf: [{ $ref: '#/components/schemas/AdReviewStatus' }]
           description: "Platform review state of this ad, independent of delivery `status` / `configuredStatus`. Absent when the platform reports no review signal."
         adType: { type: string, enum: [boost, standalone] }
+        creativeType:
+          type: [string, "null"]
+          enum: [carousel, video, document, image, null]
+          description: "Creative format, classified from the media the creative carries. `null` when the creative carries no media to classify — an unsynced creative and a genuine text-only ad are indistinguishable, so neither is guessed at. Returned by `GET /v1/ads`, `GET /v1/ads/{adId}` and the ad nodes of `GET /v1/ads/tree`."
+          example: video
         goal: { type: string, enum: [engagement, traffic, awareness, video_views, lead_generation, lead_conversion, conversions, app_promotion, catalog_sales, job_applicants], description: "Available goals vary by platform. Meta (Facebook/Instagram) supports all 9 (incl. `lead_conversion` = website pixel lead optimization and `catalog_sales` = Advantage+ catalog ads). TikTok supports the 7 non-`lead_conversion` goals. LinkedIn supports all except app_promotion / lead_conversion. Twitter/X supports engagement, traffic, awareness, video_views, app_promotion. Pinterest and Google Ads support only engagement, traffic, awareness, video_views." }
         isExternal: { type: boolean, description: True for ads synced from platform ad managers }
         budget:
@@ -7733,7 +7799,7 @@ webhooks:
     post:
       operationId: onPostScheduled
       summary: Post scheduled event
-      description: Fired when a post is created and scheduled for publishing.
+      description: 'Fired whenever a post enters the scheduled state: created with a schedule, added to a queue, a draft promoted to scheduled or queued, a failed or partial post retried, or a recycled clone created. Not fired when an already-scheduled post is edited or rescheduled.'
       tags: [Webhook Events]
       requestBody:
         required: true
@@ -7808,7 +7874,7 @@ webhooks:
     post:
       operationId: onPostRecycled
       summary: Post recycled event
-      description: Fired when a post is recycled (cloned and re-scheduled for publishing).
+      description: 'Fired when a post is recycled (cloned and re-scheduled for publishing). The new clone also fires a post.scheduled event.'
       tags: [Webhook Events]
       requestBody:
         required: true

data/spec/models/ad_daily_metrics_spec.rb

@@ -165,6 +165,24 @@ describe Zernio::AdDailyMetrics do
     end
   end
 
+  describe 'test attribute "cost_per_thruplay"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "funnel"' 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_breakdown"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "last_synced_at"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/ad_engagement_counts_spec.rb

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