late-sdk 0.0.714 → 0.0.716

data/docs/GetCampaignAnalytics202Response.md

@@ -0,0 +1,22 @@
+# Zernio::GetCampaignAnalytics202Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **backfill_pending** | **Boolean** |  |  |
+| **campaign** | [**CampaignAnalyticsResponseCampaign**](CampaignAnalyticsResponseCampaign.md) |  | [optional] |
+| **analytics** | [**CampaignAnalyticsResponseAnalytics**](CampaignAnalyticsResponseAnalytics.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GetCampaignAnalytics202Response.new(
+  backfill_pending: null,
+  campaign: null,
+  analytics: null
+)
+```
+

data/docs/ListAds202Response.md

@@ -0,0 +1,22 @@
+# Zernio::ListAds202Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **ads** | [**Array<Ad>**](Ad.md) |  | [optional] |
+| **pagination** | [**Pagination**](Pagination.md) |  | [optional] |
+| **backfill_pending** | **Boolean** |  |  |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::ListAds202Response.new(
+  ads: null,
+  pagination: null,
+  backfill_pending: null
+)
+```
+

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

@@ -835,7 +835,7 @@ module Zernio
     # @option opts [String] :sort Campaign-level sort order. `newest` (default) / `oldest` order by the campaign's newest-ad createdAt. `spend_desc` / `spend_asc` order by aggregated spend in the requested date range; campaigns with no spend land at the end. (default to 'newest')
     # @option opts [Integer] :time_increment Set to `1` to also return a daily breakdown. Mirrors Meta Insights' `time_increment=1`: each node gains a `daily[]` array of per-day metrics (same fields as the aggregated `metrics`) alongside the range total, so you get per-entity daily trends in ONE call instead of calling the tree once per day. Only `1` (daily) is supported. The daily series covers the same date range and uses the same source data as `metrics`, except `reach` on Meta and TikTok: the range total is the platform's de-duplicated value, so daily reach does not sum to it. See `dailyLevel` to control which levels carry it.
     # @option opts [String] :daily_level Which tree levels get the `daily[]` series when `timeIncrement=1`. `campaign` (default) attaches it on campaign nodes only — the common per-campaign-trend case, and the smallest payload. `adset` adds it on ad sets too; `ad` adds it on every ad in `ads[]` as well (heaviest — a long range × up to 100 ads per ad set). Scope with `campaignId` to keep `ad`-level responses small. Ignored when `timeIncrement` is unset. (default to 'campaign')
-    # @return [GetAdTree200Response]
+    # @return [AdTreeResponse]
     def get_ad_tree(opts = {})
       data, _status_code, _headers = get_ad_tree_with_http_info(opts)
       data
@@ -859,7 +859,7 @@ module Zernio
     # @option opts [String] :sort Campaign-level sort order. `newest` (default) / `oldest` order by the campaign's newest-ad createdAt. `spend_desc` / `spend_asc` order by aggregated spend in the requested date range; campaigns with no spend land at the end. (default to 'newest')
     # @option opts [Integer] :time_increment Set to `1` to also return a daily breakdown. Mirrors Meta Insights' `time_increment=1`: each node gains a `daily[]` array of per-day metrics (same fields as the aggregated `metrics`) alongside the range total, so you get per-entity daily trends in ONE call instead of calling the tree once per day. Only `1` (daily) is supported. The daily series covers the same date range and uses the same source data as `metrics`, except `reach` on Meta and TikTok: the range total is the platform's de-duplicated value, so daily reach does not sum to it. See `dailyLevel` to control which levels carry it.
     # @option opts [String] :daily_level Which tree levels get the `daily[]` series when `timeIncrement=1`. `campaign` (default) attaches it on campaign nodes only — the common per-campaign-trend case, and the smallest payload. `adset` adds it on ad sets too; `ad` adds it on every ad in `ads[]` as well (heaviest — a long range × up to 100 ads per ad set). Scope with `campaignId` to keep `ad`-level responses small. Ignored when `timeIncrement` is unset. (default to 'campaign')
-    # @return [Array<(GetAdTree200Response, Integer, Hash)>] GetAdTree200Response data, response status code and response headers
+    # @return [Array<(AdTreeResponse, Integer, Hash)>] AdTreeResponse data, response status code and response headers
     def get_ad_tree_with_http_info(opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AdCampaignsApi.get_ad_tree ...'
@@ -929,7 +929,7 @@ module Zernio
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'GetAdTree200Response'
+      return_type = opts[:debug_return_type] || 'AdTreeResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['bearerAuth']
@@ -959,7 +959,7 @@ module Zernio
     # @option opts [Date] :from_date Inclusive start of metrics range (YYYY-MM-DD). Defaults to 90 days ago.
     # @option opts [Date] :to_date Inclusive end of metrics range (YYYY-MM-DD). Defaults to today. Max 730-day range.
     # @option opts [String] :platform Restrict to one platform.
-    # @return [GetAdsTimeline200Response]
+    # @return [AdsTimelineResponse]
     def get_ads_timeline(account_id, opts = {})
       data, _status_code, _headers = get_ads_timeline_with_http_info(account_id, opts)
       data
@@ -973,7 +973,7 @@ module Zernio
     # @option opts [Date] :from_date Inclusive start of metrics range (YYYY-MM-DD). Defaults to 90 days ago.
     # @option opts [Date] :to_date Inclusive end of metrics range (YYYY-MM-DD). Defaults to today. Max 730-day range.
     # @option opts [String] :platform Restrict to one platform.
-    # @return [Array<(GetAdsTimeline200Response, Integer, Hash)>] GetAdsTimeline200Response data, response status code and response headers
+    # @return [Array<(AdsTimelineResponse, Integer, Hash)>] AdsTimelineResponse data, response status code and response headers
     def get_ads_timeline_with_http_info(account_id, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AdCampaignsApi.get_ads_timeline ...'
@@ -1009,7 +1009,7 @@ module Zernio
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'GetAdsTimeline200Response'
+      return_type = opts[:debug_return_type] || 'AdsTimelineResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['bearerAuth']
@@ -1276,7 +1276,7 @@ module Zernio
     # @option opts [String] :effective_instagram_media_id Instagram media ID of the boosted post (Meta &#x60;effective_instagram_media_id&#x60;). Use to map a Business-Manager-visible IG post back to the Zernio ad.
     # @option opts [Date] :from_date Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago.
     # @option opts [Date] :to_date End of metrics date range (YYYY-MM-DD). Defaults to today. Max 730-day range.
-    # @return [ListAds200Response]
+    # @return [AdsListResponse]
     def list_ads(opts = {})
       data, _status_code, _headers = list_ads_with_http_info(opts)
       data
@@ -1300,7 +1300,7 @@ module Zernio
     # @option opts [String] :effective_instagram_media_id Instagram media ID of the boosted post (Meta &#x60;effective_instagram_media_id&#x60;). Use to map a Business-Manager-visible IG post back to the Zernio ad.
     # @option opts [Date] :from_date Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago.
     # @option opts [Date] :to_date End of metrics date range (YYYY-MM-DD). Defaults to today. Max 730-day range.
-    # @return [Array<(ListAds200Response, Integer, Hash)>] ListAds200Response data, response status code and response headers
+    # @return [Array<(AdsListResponse, Integer, Hash)>] AdsListResponse data, response status code and response headers
     def list_ads_with_http_info(opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AdCampaignsApi.list_ads ...'
@@ -1358,7 +1358,7 @@ module Zernio
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'ListAds200Response'
+      return_type = opts[:debug_return_type] || 'AdsListResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['bearerAuth']

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

@@ -230,7 +230,7 @@ module Zernio
     # @option opts [Date] :from_date Start of date range (YYYY-MM-DD). Defaults to 90 days ago.
     # @option opts [Date] :to_date End of date range (YYYY-MM-DD). Defaults to today. Max 730-day range.
     # @option opts [String] :breakdowns Comma-separated breakdown dimensions.  **Meta**: age, gender, country, publisher_platform, device_platform, region.  **TikTok**: gender, age, country_code, platform, ac, language.  **LinkedIn** (firmographics): job_title, job_function, seniority, industry, company, company_size, country, region. Rows carry the raw pivot `value` plus a resolved `name`. LinkedIn serves these aggregated over the whole range, delays the data 12-24h, and omits segments with fewer than 3 events. 
-    # @return [GetAdAnalytics200Response]
+    # @return [AdAnalyticsResponse]
     def get_ad_analytics(ad_id, opts = {})
       data, _status_code, _headers = get_ad_analytics_with_http_info(ad_id, opts)
       data
@@ -243,7 +243,7 @@ module Zernio
     # @option opts [Date] :from_date Start of date range (YYYY-MM-DD). Defaults to 90 days ago.
     # @option opts [Date] :to_date End of date range (YYYY-MM-DD). Defaults to today. Max 730-day range.
     # @option opts [String] :breakdowns Comma-separated breakdown dimensions.  **Meta**: age, gender, country, publisher_platform, device_platform, region.  **TikTok**: gender, age, country_code, platform, ac, language.  **LinkedIn** (firmographics): job_title, job_function, seniority, industry, company, company_size, country, region. Rows carry the raw pivot `value` plus a resolved `name`. LinkedIn serves these aggregated over the whole range, delays the data 12-24h, and omits segments with fewer than 3 events. 
-    # @return [Array<(GetAdAnalytics200Response, Integer, Hash)>] GetAdAnalytics200Response data, response status code and response headers
+    # @return [Array<(AdAnalyticsResponse, Integer, Hash)>] AdAnalyticsResponse data, response status code and response headers
     def get_ad_analytics_with_http_info(ad_id, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AdInsightsApi.get_ad_analytics ...'
@@ -273,7 +273,7 @@ module Zernio
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'GetAdAnalytics200Response'
+      return_type = opts[:debug_return_type] || 'AdAnalyticsResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['bearerAuth']
@@ -469,7 +469,7 @@ module Zernio
     # @option opts [Date] :from_date Start of date range (YYYY-MM-DD). Defaults to 90 days ago.
     # @option opts [Date] :to_date End of date range (YYYY-MM-DD). Defaults to today. Max 730-day range.
     # @option opts [String] :breakdowns Comma-separated breakdown dimensions.  **Meta**: age, gender, country, publisher_platform, device_platform, region, platform_position, impression_device, video_asset, image_asset, body_asset, title_asset.  **LinkedIn** (firmographics): job_title, job_function, seniority, industry, company, company_size, country, region. Rows carry the raw pivot &#x60;value&#x60; plus a resolved &#x60;name&#x60;. LinkedIn serves these aggregated over the whole range, delays the data 12-24h, and omits segments with fewer than 3 events. 
-    # @return [GetCampaignAnalytics200Response]
+    # @return [CampaignAnalyticsResponse]
     def get_campaign_analytics(campaign_id, opts = {})
       data, _status_code, _headers = get_campaign_analytics_with_http_info(campaign_id, opts)
       data
@@ -483,7 +483,7 @@ module Zernio
     # @option opts [Date] :from_date Start of date range (YYYY-MM-DD). Defaults to 90 days ago.
     # @option opts [Date] :to_date End of date range (YYYY-MM-DD). Defaults to today. Max 730-day range.
     # @option opts [String] :breakdowns Comma-separated breakdown dimensions.  **Meta**: age, gender, country, publisher_platform, device_platform, region, platform_position, impression_device, video_asset, image_asset, body_asset, title_asset.  **LinkedIn** (firmographics): job_title, job_function, seniority, industry, company, company_size, country, region. Rows carry the raw pivot &#x60;value&#x60; plus a resolved &#x60;name&#x60;. LinkedIn serves these aggregated over the whole range, delays the data 12-24h, and omits segments with fewer than 3 events. 
-    # @return [Array<(GetCampaignAnalytics200Response, Integer, Hash)>] GetCampaignAnalytics200Response data, response status code and response headers
+    # @return [Array<(CampaignAnalyticsResponse, Integer, Hash)>] CampaignAnalyticsResponse data, response status code and response headers
     def get_campaign_analytics_with_http_info(campaign_id, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AdInsightsApi.get_campaign_analytics ...'
@@ -514,7 +514,7 @@ module Zernio
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'GetCampaignAnalytics200Response'
+      return_type = opts[:debug_return_type] || 'CampaignAnalyticsResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['bearerAuth']

data/lib/zernio-sdk/models/{get_ad_analytics200_response.rb → ad_analytics_response.rb}

@@ -14,19 +14,19 @@ require 'date'
 require 'time'
 
 module Zernio
-  class GetAdAnalytics200Response < ApiModelBase
-    attr_accessor :ad
-
-    # Present and true only on `202` responses: part of the requested date range is still being backfilled from the platform in the background. Retry the same request shortly; it returns 200 once the range is fully ingested.
+  class AdAnalyticsResponse < ApiModelBase
+    # Present and true while historical data is being backfilled.
     attr_accessor :backfill_pending
 
+    attr_accessor :ad
+
     attr_accessor :analytics
 
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
-        :'ad' => :'ad',
         :'backfill_pending' => :'backfillPending',
+        :'ad' => :'ad',
         :'analytics' => :'analytics'
       }
     end
@@ -44,9 +44,9 @@ module Zernio
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'ad' => :'GetAdAnalytics200ResponseAd',
         :'backfill_pending' => :'Boolean',
-        :'analytics' => :'GetCampaignAnalytics200ResponseAnalytics'
+        :'ad' => :'AdAnalyticsResponseAd',
+        :'analytics' => :'CampaignAnalyticsResponseAnalytics'
       }
     end
 
@@ -60,26 +60,26 @@ module Zernio
     # @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::GetAdAnalytics200Response` initialize method"
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::AdAnalyticsResponse` 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::GetAdAnalytics200Response`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::AdAnalyticsResponse`. 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?(:'ad')
-        self.ad = attributes[:'ad']
-      end
-
       if attributes.key?(:'backfill_pending')
         self.backfill_pending = attributes[:'backfill_pending']
       end
 
+      if attributes.key?(:'ad')
+        self.ad = attributes[:'ad']
+      end
+
       if attributes.key?(:'analytics')
         self.analytics = attributes[:'analytics']
       end
@@ -105,8 +105,8 @@ module Zernio
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
-          ad == o.ad &&
           backfill_pending == o.backfill_pending &&
+          ad == o.ad &&
           analytics == o.analytics
     end
 
@@ -119,7 +119,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [ad, backfill_pending, analytics].hash
+      [backfill_pending, ad, analytics].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/{get_ad_analytics200_response_ad.rb → ad_analytics_response_ad.rb}

@@ -14,49 +14,24 @@ require 'date'
 require 'time'
 
 module Zernio
-  class GetAdAnalytics200ResponseAd < ApiModelBase
+  class AdAnalyticsResponseAd < ApiModelBase
     attr_accessor :id
 
     attr_accessor :name
 
     attr_accessor :platform
 
-    attr_accessor :trigger
-
     attr_accessor :status
 
     # ISO 4217 code of the ad account that owns this ad (e.g. USD, THB, INR). All money values in `summary` and `daily` are in this currency. Null only on legacy ads synced before currency was persisted.
     attr_accessor :currency
 
-    class EnumAttributeValidator
-      attr_reader :datatype
-      attr_reader :allowable_values
-
-      def initialize(datatype, allowable_values)
-        @allowable_values = allowable_values.map do |value|
-          case datatype.to_s
-          when /Integer/i
-            value.to_i
-          when /Float/i
-            value.to_f
-          else
-            value
-          end
-        end
-      end
-
-      def valid?(value)
-        !value || allowable_values.include?(value)
-      end
-    end
-
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'id' => :'id',
         :'name' => :'name',
         :'platform' => :'platform',
-        :'trigger' => :'trigger',
         :'status' => :'status',
         :'currency' => :'currency'
       }
@@ -78,7 +53,6 @@ module Zernio
         :'id' => :'String',
         :'name' => :'String',
         :'platform' => :'String',
-        :'trigger' => :'String',
         :'status' => :'String',
         :'currency' => :'String'
       }
@@ -95,14 +69,14 @@ module Zernio
     # @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::GetAdAnalytics200ResponseAd` initialize method"
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::AdAnalyticsResponseAd` 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::GetAdAnalytics200ResponseAd`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::AdAnalyticsResponseAd`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
         end
         h[k.to_sym] = v
       }
@@ -119,10 +93,6 @@ module Zernio
         self.platform = attributes[:'platform']
       end
 
-      if attributes.key?(:'trigger')
-        self.trigger = attributes[:'trigger']
-      end
-
       if attributes.key?(:'status')
         self.status = attributes[:'status']
       end
@@ -144,21 +114,9 @@ module Zernio
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
-      trigger_validator = EnumAttributeValidator.new('String', ["comment", "story_reply"])
-      return false unless trigger_validator.valid?(@trigger)
       true
     end
 
-    # Custom attribute writer method checking allowed values (enum).
-    # @param [Object] trigger Object to be assigned
-    def trigger=(trigger)
-      validator = EnumAttributeValidator.new('String', ["comment", "story_reply"])
-      unless validator.valid?(trigger)
-        fail ArgumentError, "invalid value for \"trigger\", must be one of #{validator.allowable_values}."
-      end
-      @trigger = trigger
-    end
-
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)
@@ -167,7 +125,6 @@ module Zernio
           id == o.id &&
           name == o.name &&
           platform == o.platform &&
-          trigger == o.trigger &&
           status == o.status &&
           currency == o.currency
     end
@@ -181,7 +138,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, name, platform, trigger, status, currency].hash
+      [id, name, platform, status, currency].hash
     end
 
     # Builds the object from hash

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

@@ -54,6 +54,27 @@ module Zernio
     # 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.
+    attr_accessor :cost_per_action
+
+    # Clicks leading off Meta's surfaces to the advertiser's destination. Meta-only; other platforms report 0.
+    attr_accessor :outbound_clicks
+
+    # Derived `outboundClicks / impressions * 100`, recomputed from sums at every rollup level.
+    attr_accessor :outbound_clicks_ctr
+
+    # In-session link clicks. Differs from the attributed `link_click` count in `actions`/`engagementBreakdown.linkClicks`, which uses the attribution window. Meta-only.
+    attr_accessor :inline_link_clicks
+
+    # Derived `inlineLinkClicks / impressions * 100`, recomputed from sums at every rollup level.
+    attr_accessor :inline_link_click_ctr
+
+    # People who clicked at least once. NOT additive: summed across days/children it overcounts people who clicked on multiple days or ads, so treat rollups as an upper bound (same caveat as `reach`). Meta-only.
+    attr_accessor :unique_clicks
+
+    # Derived `uniqueClicks / impressions * 100` (NOT Meta's reach-based unique_ctr). Inherits the non-additivity caveat of `uniqueClicks`.
+    attr_accessor :unique_ctr
+
     # Number of times the video started playing, summed over the date range and across children at ad-set/campaign level. 0 for non-video ads. Sources: Meta `video_play_actions`, TikTok `video_play_actions`.
     attr_accessor :video_play_actions
 
@@ -111,6 +132,13 @@ module Zernio
         :'action_values' => :'actionValues',
         :'purchase_value' => :'purchaseValue',
         :'roas' => :'roas',
+        :'cost_per_action' => :'costPerAction',
+        :'outbound_clicks' => :'outboundClicks',
+        :'outbound_clicks_ctr' => :'outboundClicksCtr',
+        :'inline_link_clicks' => :'inlineLinkClicks',
+        :'inline_link_click_ctr' => :'inlineLinkClickCtr',
+        :'unique_clicks' => :'uniqueClicks',
+        :'unique_ctr' => :'uniqueCtr',
         :'video_play_actions' => :'videoPlayActions',
         :'video30_sec_watched_actions' => :'video30SecWatchedActions',
         :'video_thruplay_watched_actions' => :'videoThruplayWatchedActions',
@@ -155,6 +183,13 @@ module Zernio
         :'action_values' => :'Hash<String, Float>',
         :'purchase_value' => :'Float',
         :'roas' => :'Float',
+        :'cost_per_action' => :'Hash<String, Float>',
+        :'outbound_clicks' => :'Integer',
+        :'outbound_clicks_ctr' => :'Float',
+        :'inline_link_clicks' => :'Integer',
+        :'inline_link_click_ctr' => :'Float',
+        :'unique_clicks' => :'Integer',
+        :'unique_ctr' => :'Float',
         :'video_play_actions' => :'Integer',
         :'video30_sec_watched_actions' => :'Integer',
         :'video_thruplay_watched_actions' => :'Integer',
@@ -261,6 +296,36 @@ module Zernio
         self.roas = attributes[:'roas']
       end
 
+      if attributes.key?(:'cost_per_action')
+        if (value = attributes[:'cost_per_action']).is_a?(Hash)
+          self.cost_per_action = value
+        end
+      end
+
+      if attributes.key?(:'outbound_clicks')
+        self.outbound_clicks = attributes[:'outbound_clicks']
+      end
+
+      if attributes.key?(:'outbound_clicks_ctr')
+        self.outbound_clicks_ctr = attributes[:'outbound_clicks_ctr']
+      end
+
+      if attributes.key?(:'inline_link_clicks')
+        self.inline_link_clicks = attributes[:'inline_link_clicks']
+      end
+
+      if attributes.key?(:'inline_link_click_ctr')
+        self.inline_link_click_ctr = attributes[:'inline_link_click_ctr']
+      end
+
+      if attributes.key?(:'unique_clicks')
+        self.unique_clicks = attributes[:'unique_clicks']
+      end
+
+      if attributes.key?(:'unique_ctr')
+        self.unique_ctr = attributes[:'unique_ctr']
+      end
+
       if attributes.key?(:'video_play_actions')
         self.video_play_actions = attributes[:'video_play_actions']
       end
@@ -352,6 +417,13 @@ module Zernio
           action_values == o.action_values &&
           purchase_value == o.purchase_value &&
           roas == o.roas &&
+          cost_per_action == o.cost_per_action &&
+          outbound_clicks == o.outbound_clicks &&
+          outbound_clicks_ctr == o.outbound_clicks_ctr &&
+          inline_link_clicks == o.inline_link_clicks &&
+          inline_link_click_ctr == o.inline_link_click_ctr &&
+          unique_clicks == o.unique_clicks &&
+          unique_ctr == o.unique_ctr &&
           video_play_actions == o.video_play_actions &&
           video30_sec_watched_actions == o.video30_sec_watched_actions &&
           video_thruplay_watched_actions == o.video_thruplay_watched_actions &&
@@ -377,7 +449,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, cost_per_thruplay, funnel, engagement_breakdown, last_synced_at, date].hash
+      [spend, impressions, reach, clicks, ctr, cpc, cpm, engagement, conversions, cost_per_conversion, actions, action_values, purchase_value, roas, cost_per_action, outbound_clicks, outbound_clicks_ctr, inline_link_clicks, inline_link_click_ctr, unique_clicks, unique_ctr, 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/models/ad_engagement_counts.rb

@@ -40,7 +40,7 @@ module Zernio
     # 3-second video views (`video_view`). For completion-based counts use `videoThruplayWatchedActions`.
     attr_accessor :video_views
 
-    # 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`.
+    # Attributed link clicks (`link_click`). This is the attribution-window count, which differs from the in-session count in the sibling `inlineLinkClicks` field.
     attr_accessor :link_clicks
 
     # Attribute mapping from ruby-style variable name to JSON key.

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

@@ -53,6 +53,27 @@ module Zernio
     # 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.
+    attr_accessor :cost_per_action
+
+    # Clicks leading off Meta's surfaces to the advertiser's destination. Meta-only; other platforms report 0.
+    attr_accessor :outbound_clicks
+
+    # Derived `outboundClicks / impressions * 100`, recomputed from sums at every rollup level.
+    attr_accessor :outbound_clicks_ctr
+
+    # In-session link clicks. Differs from the attributed `link_click` count in `actions`/`engagementBreakdown.linkClicks`, which uses the attribution window. Meta-only.
+    attr_accessor :inline_link_clicks
+
+    # Derived `inlineLinkClicks / impressions * 100`, recomputed from sums at every rollup level.
+    attr_accessor :inline_link_click_ctr
+
+    # People who clicked at least once. NOT additive: summed across days/children it overcounts people who clicked on multiple days or ads, so treat rollups as an upper bound (same caveat as `reach`). Meta-only.
+    attr_accessor :unique_clicks
+
+    # Derived `uniqueClicks / impressions * 100` (NOT Meta's reach-based unique_ctr). Inherits the non-additivity caveat of `uniqueClicks`.
+    attr_accessor :unique_ctr
+
     # Number of times the video started playing, summed over the date range and across children at ad-set/campaign level. 0 for non-video ads. Sources: Meta `video_play_actions`, TikTok `video_play_actions`.
     attr_accessor :video_play_actions
 
@@ -107,6 +128,13 @@ module Zernio
         :'action_values' => :'actionValues',
         :'purchase_value' => :'purchaseValue',
         :'roas' => :'roas',
+        :'cost_per_action' => :'costPerAction',
+        :'outbound_clicks' => :'outboundClicks',
+        :'outbound_clicks_ctr' => :'outboundClicksCtr',
+        :'inline_link_clicks' => :'inlineLinkClicks',
+        :'inline_link_click_ctr' => :'inlineLinkClickCtr',
+        :'unique_clicks' => :'uniqueClicks',
+        :'unique_ctr' => :'uniqueCtr',
         :'video_play_actions' => :'videoPlayActions',
         :'video30_sec_watched_actions' => :'video30SecWatchedActions',
         :'video_thruplay_watched_actions' => :'videoThruplayWatchedActions',
@@ -150,6 +178,13 @@ module Zernio
         :'action_values' => :'Hash<String, Float>',
         :'purchase_value' => :'Float',
         :'roas' => :'Float',
+        :'cost_per_action' => :'Hash<String, Float>',
+        :'outbound_clicks' => :'Integer',
+        :'outbound_clicks_ctr' => :'Float',
+        :'inline_link_clicks' => :'Integer',
+        :'inline_link_click_ctr' => :'Float',
+        :'unique_clicks' => :'Integer',
+        :'unique_ctr' => :'Float',
         :'video_play_actions' => :'Integer',
         :'video30_sec_watched_actions' => :'Integer',
         :'video_thruplay_watched_actions' => :'Integer',
@@ -248,6 +283,36 @@ module Zernio
         self.roas = attributes[:'roas']
       end
 
+      if attributes.key?(:'cost_per_action')
+        if (value = attributes[:'cost_per_action']).is_a?(Hash)
+          self.cost_per_action = value
+        end
+      end
+
+      if attributes.key?(:'outbound_clicks')
+        self.outbound_clicks = attributes[:'outbound_clicks']
+      end
+
+      if attributes.key?(:'outbound_clicks_ctr')
+        self.outbound_clicks_ctr = attributes[:'outbound_clicks_ctr']
+      end
+
+      if attributes.key?(:'inline_link_clicks')
+        self.inline_link_clicks = attributes[:'inline_link_clicks']
+      end
+
+      if attributes.key?(:'inline_link_click_ctr')
+        self.inline_link_click_ctr = attributes[:'inline_link_click_ctr']
+      end
+
+      if attributes.key?(:'unique_clicks')
+        self.unique_clicks = attributes[:'unique_clicks']
+      end
+
+      if attributes.key?(:'unique_ctr')
+        self.unique_ctr = attributes[:'unique_ctr']
+      end
+
       if attributes.key?(:'video_play_actions')
         self.video_play_actions = attributes[:'video_play_actions']
       end
@@ -335,6 +400,13 @@ module Zernio
           action_values == o.action_values &&
           purchase_value == o.purchase_value &&
           roas == o.roas &&
+          cost_per_action == o.cost_per_action &&
+          outbound_clicks == o.outbound_clicks &&
+          outbound_clicks_ctr == o.outbound_clicks_ctr &&
+          inline_link_clicks == o.inline_link_clicks &&
+          inline_link_click_ctr == o.inline_link_click_ctr &&
+          unique_clicks == o.unique_clicks &&
+          unique_ctr == o.unique_ctr &&
           video_play_actions == o.video_play_actions &&
           video30_sec_watched_actions == o.video30_sec_watched_actions &&
           video_thruplay_watched_actions == o.video_thruplay_watched_actions &&
@@ -359,7 +431,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, cost_per_thruplay, funnel, engagement_breakdown, last_synced_at].hash
+      [spend, impressions, reach, clicks, ctr, cpc, cpm, engagement, conversions, cost_per_conversion, actions, action_values, purchase_value, roas, cost_per_action, outbound_clicks, outbound_clicks_ctr, inline_link_clicks, inline_link_click_ctr, unique_clicks, unique_ctr, 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