late-sdk 0.0.644 → 0.0.646

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0c37e96a5200bb19db198f77b363ecf71a95d9099150878d25bb132689f3c0c9
-  data.tar.gz: a5fb7b3a484807b2cd8672e8532c2c5f950f71b8d74de17f139aee79d2b6d109
+  metadata.gz: 978cc54b12b88c8dbce3617d7759d0e15727a984c5b62a0082b12d94e9390d3c
+  data.tar.gz: ea95c6c0bbc61bb30e7b3844a7f46dd88e2210871d1f448e80554a8dbcee330d
 SHA512:
-  metadata.gz: 0ee47da80536a16c94f908770374ffd1dce9ed2aa68708610dcffac71225d19edd4199f2fb8c542fcfc1f4186a167acf56dbebf12e97f4f24708d24fba58681a
-  data.tar.gz: a5fef5e5b8e4bc87bce0900a26610316b5471309f72611b6c87724a66473de9c4b70347767995c1ca299e6177d06d3bf0711b082166f6ea7cde59fd47799d556
+  metadata.gz: 8881623a149e17881dee2aabc1a2fc4f230fb6e299b68b601e62c21cb0ed7431a033b0280c49c59c8b42ef0f183de5f43020de9a310fbfd80b3cd9d3765fffbe
+  data.tar.gz: 3a3db87cb68ff2a9685fa514b5c72033f4b21e74cae9e990feab434950acd453079c3672afc2ca10dda6fc2161bc8aebff6db10ef141e566a8cd80ed83ccb423

data/README.md

@@ -1136,6 +1136,7 @@ Class | Method | HTTP request | Description
  - [Zernio::GetGoogleBusinessVerifications200ResponseVoiceOfMerchantStateVerify](docs/GetGoogleBusinessVerifications200ResponseVoiceOfMerchantStateVerify.md)
  - [Zernio::GetInboxConversation200Response](docs/GetInboxConversation200Response.md)
  - [Zernio::GetInboxConversation200ResponseData](docs/GetInboxConversation200ResponseData.md)
+ - [Zernio::GetInboxConversation200ResponseDataMetadata](docs/GetInboxConversation200ResponseDataMetadata.md)
  - [Zernio::GetInboxConversationAnalytics200Response](docs/GetInboxConversationAnalytics200Response.md)
  - [Zernio::GetInboxConversationAnalytics200ResponseBySourceInner](docs/GetInboxConversationAnalytics200ResponseBySourceInner.md)
  - [Zernio::GetInboxConversationAnalytics200ResponseSummary](docs/GetInboxConversationAnalytics200ResponseSummary.md)
@@ -1458,6 +1459,7 @@ Class | Method | HTTP request | Description
  - [Zernio::ListInboxConversations200Response](docs/ListInboxConversations200Response.md)
  - [Zernio::ListInboxConversations200ResponseDataInner](docs/ListInboxConversations200ResponseDataInner.md)
  - [Zernio::ListInboxConversations200ResponseDataInnerInstagramProfile](docs/ListInboxConversations200ResponseDataInnerInstagramProfile.md)
+ - [Zernio::ListInboxConversations200ResponseDataInnerMetadata](docs/ListInboxConversations200ResponseDataInnerMetadata.md)
  - [Zernio::ListInboxConversations200ResponseMeta](docs/ListInboxConversations200ResponseMeta.md)
  - [Zernio::ListInboxConversations200ResponseMetaFailedAccountsInner](docs/ListInboxConversations200ResponseMetaFailedAccountsInner.md)
  - [Zernio::ListInboxConversations200ResponsePagination](docs/ListInboxConversations200ResponsePagination.md)

data/docs/AdCampaignsApi.md

@@ -855,7 +855,7 @@ opts = {
   from_date: Date.parse('2013-10-20'), # Date | Start of the METRICS date range (YYYY-MM-DD). Affects only the spend/impression numbers overlaid on each node, NOT which campaigns are returned. Defaults to 90 days ago.
   to_date: Date.parse('2013-10-20'), # Date | End of metrics date range (YYYY-MM-DD). Defaults to today. Max 730-day range.
   sort: 'newest', # String | 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.
-  time_increment: 1, # Integer | 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`. See `dailyLevel` to control which levels carry it.
+  time_increment: 1, # Integer | 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 Meta `reach`: the range total is Meta's de-duplicated value, so daily reach does not sum to it. See `dailyLevel` to control which levels carry it.
   daily_level: 'campaign' # String | 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.
 }
 
@@ -903,7 +903,7 @@ end
 | **from_date** | **Date** | Start of the METRICS date range (YYYY-MM-DD). Affects only the spend/impression numbers overlaid on each node, NOT which campaigns are returned. Defaults to 90 days ago. | [optional] |
 | **to_date** | **Date** | End of metrics date range (YYYY-MM-DD). Defaults to today. Max 730-day range. | [optional] |
 | **sort** | **String** | 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. | [optional][default to 'newest'] |
-| **time_increment** | **Integer** | 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`. See `dailyLevel` to control which levels carry it. | [optional] |
+| **time_increment** | **Integer** | 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 Meta `reach`: the range total is Meta's de-duplicated value, so daily reach does not sum to it. See `dailyLevel` to control which levels carry it. | [optional] |
 | **daily_level** | **String** | 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. | [optional][default to 'campaign'] |
 
 ### Return type

data/docs/AdDailyMetrics.md

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **spend** | **Float** |  | [optional] |
 | **impressions** | **Integer** |  | [optional] |
-| **reach** | **Integer** |  | [optional] |
+| **reach** | **Integer** | Unique people reached in the requested date range. Meta (facebook/instagram): Meta's own de-duplicated reach for the exact range, fetched live and cached up to ~1 hour (may lag recent delivery; on a transient Meta error the value temporarily falls back to a sum of per-day reach, which overcounts people reached on multiple days or by multiple child ads). Because it is de-duplicated, Meta reach is NOT additive: neither daily values nor child nodes sum to the range total. TikTok: sum of per-day reach, so multi-day ranges overcount vs TikTok Ads Manager. Google, LinkedIn, X, Pinterest and OpenAI report 0 (reach not synced). Only derive frequency (impressions / reach) for Meta. | [optional] |
 | **clicks** | **Integer** |  | [optional] |
 | **ctr** | **Float** | Click-through rate (%) | [optional] |
 | **cpc** | **Float** | Cost per click | [optional] |

data/docs/AdMetrics.md

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **spend** | **Float** |  | [optional] |
 | **impressions** | **Integer** |  | [optional] |
-| **reach** | **Integer** |  | [optional] |
+| **reach** | **Integer** | Unique people reached in the requested date range. Meta (facebook/instagram): Meta's own de-duplicated reach for the exact range, fetched live and cached up to ~1 hour (may lag recent delivery; on a transient Meta error the value temporarily falls back to a sum of per-day reach, which overcounts people reached on multiple days or by multiple child ads). Because it is de-duplicated, Meta reach is NOT additive: neither daily values nor child nodes sum to the range total. TikTok: sum of per-day reach, so multi-day ranges overcount vs TikTok Ads Manager. Google, LinkedIn, X, Pinterest and OpenAI report 0 (reach not synced). Only derive frequency (impressions / reach) for Meta. | [optional] |
 | **clicks** | **Integer** |  | [optional] |
 | **ctr** | **Float** | Click-through rate (%) | [optional] |
 | **cpc** | **Float** | Cost per click | [optional] |

data/docs/AdTreeCampaign.md

@@ -31,7 +31,7 @@
 | **roas_average_floor** | **Float** | Representative ROAS floor for the campaign — bubbled up from the top-spending ad set. Decimal multiplier (2.0 = 2.0x). | [optional] |
 | **promoted_object** | [**AdTreeCampaignPromotedObject**](AdTreeCampaignPromotedObject.md) |  | [optional] |
 | **ad_sets** | [**Array<AdTreeAdSet>**](AdTreeAdSet.md) |  | [optional] |
-| **daily** | [**Array<AdDailyMetrics>**](AdDailyMetrics.md) | 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. | [optional] |
+| **daily** | [**Array<AdDailyMetrics>**](AdDailyMetrics.md) | 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. | [optional] |
 
 ## Example
 

data/docs/GetAdsTimeline200ResponseRowsInner.md

@@ -7,7 +7,7 @@
 | **date** | **Date** |  | [optional] |
 | **spend** | **Float** | Native currency units (matches /ads/tree convention). | [optional] |
 | **impressions** | **Integer** |  | [optional] |
-| **reach** | **Integer** |  | [optional] |
+| **reach** | **Integer** | Reach summed across the account's ads for this single day. A person seen by two ads the same day counts twice, and reach is de-duplicated per day only: do NOT sum it across days (people reached on multiple days would be double-counted). | [optional] |
 | **clicks** | **Integer** |  | [optional] |
 | **engagement** | **Integer** |  | [optional] |
 | **ctr** | **Float** | Click-through rate as a percentage (0–100). | [optional] |

data/docs/GetCampaignAnalytics200ResponseAnalyticsDailyInner.md

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **spend** | **Float** |  | [optional] |
 | **impressions** | **Integer** |  | [optional] |
-| **reach** | **Integer** |  | [optional] |
+| **reach** | **Integer** | Unique people reached in the requested date range. Meta (facebook/instagram): Meta's own de-duplicated reach for the exact range, fetched live and cached up to ~1 hour (may lag recent delivery; on a transient Meta error the value temporarily falls back to a sum of per-day reach, which overcounts people reached on multiple days or by multiple child ads). Because it is de-duplicated, Meta reach is NOT additive: neither daily values nor child nodes sum to the range total. TikTok: sum of per-day reach, so multi-day ranges overcount vs TikTok Ads Manager. Google, LinkedIn, X, Pinterest and OpenAI report 0 (reach not synced). Only derive frequency (impressions / reach) for Meta. | [optional] |
 | **clicks** | **Integer** |  | [optional] |
 | **ctr** | **Float** | Click-through rate (%) | [optional] |
 | **cpc** | **Float** | Cost per click | [optional] |

data/docs/GetInboxConversation200ResponseData.md

@@ -17,6 +17,7 @@
 | **updated_time** | **Time** |  | [optional] |
 | **participants** | [**Array<UpdateFacebookPage200ResponseSelectedPage>**](UpdateFacebookPage200ResponseSelectedPage.md) |  | [optional] |
 | **instagram_profile** | [**ListInboxConversations200ResponseDataInnerInstagramProfile**](ListInboxConversations200ResponseDataInnerInstagramProfile.md) |  | [optional] |
+| **metadata** | [**GetInboxConversation200ResponseDataMetadata**](GetInboxConversation200ResponseDataMetadata.md) |  | [optional] |
 
 ## Example
 
@@ -36,7 +37,8 @@ instance = Zernio::GetInboxConversation200ResponseData.new(
   last_message_at: null,
   updated_time: null,
   participants: null,
-  instagram_profile: null
+  instagram_profile: null,
+  metadata: null
 )
 ```
 

data/docs/GetInboxConversation200ResponseDataMetadata.md

@@ -0,0 +1,38 @@
+# Zernio::GetInboxConversation200ResponseDataMetadata
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **meta_ad_id** | **String** | The Meta ad ID the user clicked. Always present when a referral was captured. | [optional] |
+| **meta_ad_source** | **String** | Meta-supplied source identifier, for example ADS. | [optional] |
+| **meta_ad_type** | **String** | Meta-supplied referral type, for example OPEN_THREAD. | [optional] |
+| **meta_ad_ref** | **String** | The ref parameter passed through from the ad creative. | [optional] |
+| **meta_ad_title** | **String** | Title of the ad creative at click time. | [optional] |
+| **meta_ad_photo_url** | **String** | Image of the ad creative at click time. | [optional] |
+| **meta_ad_video_url** | **String** | Video of the ad creative at click time. | [optional] |
+| **meta_ad_post_id** | **String** | The organic post the ad promoted, when the ad was a boosted post. | [optional] |
+| **meta_ad_product_id** | **String** | The catalogue product the user clicked, for product ads. | [optional] |
+| **meta_ad_flow_id** | **String** | The Meta flow the ad launched, for flow ads. | [optional] |
+| **meta_ad_captured_at** | **Time** | When Zernio stored this referral. Always present when a referral was captured. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GetInboxConversation200ResponseDataMetadata.new(
+  meta_ad_id: null,
+  meta_ad_source: null,
+  meta_ad_type: null,
+  meta_ad_ref: null,
+  meta_ad_title: null,
+  meta_ad_photo_url: null,
+  meta_ad_video_url: null,
+  meta_ad_post_id: null,
+  meta_ad_product_id: null,
+  meta_ad_flow_id: null,
+  meta_ad_captured_at: null
+)
+```
+

data/docs/ListInboxConversations200ResponseDataInner.md

@@ -18,6 +18,7 @@
 | **unread_count** | **Integer** | Number of unread messages | [optional] |
 | **url** | **String** | Direct link to open the conversation on the platform (if available) | [optional] |
 | **instagram_profile** | [**ListInboxConversations200ResponseDataInnerInstagramProfile**](ListInboxConversations200ResponseDataInnerInstagramProfile.md) |  | [optional] |
+| **metadata** | [**ListInboxConversations200ResponseDataInnerMetadata**](ListInboxConversations200ResponseDataInnerMetadata.md) |  | [optional] |
 
 ## Example
 
@@ -38,7 +39,8 @@ instance = Zernio::ListInboxConversations200ResponseDataInner.new(
   status: null,
   unread_count: null,
   url: null,
-  instagram_profile: null
+  instagram_profile: null,
+  metadata: null
 )
 ```
 

data/docs/ListInboxConversations200ResponseDataInnerMetadata.md

@@ -0,0 +1,50 @@
+# Zernio::ListInboxConversations200ResponseDataInnerMetadata
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **ctwa_clid** | **String** | WhatsApp only. Meta's click identifier, the value to forward to the Meta Conversions API for Business Messaging. Meta omits it on some numbers, so a WhatsApp referral can arrive without it. | [optional] |
+| **ctwa_source_id** | **String** | WhatsApp only. The Meta ad ID the user clicked. This is the WhatsApp equivalent of meta_ad_id. | [optional] |
+| **ctwa_source_type** | **String** | WhatsApp only. What the user clicked, as supplied by Meta (for example ad or post). | [optional] |
+| **ctwa_source_url** | **String** | WhatsApp only. Meta's URL for the ad that was clicked, normally an fb.me short link. | [optional] |
+| **ctwa_headline** | **String** | WhatsApp only. Headline of the ad creative at click time. | [optional] |
+| **ctwa_captured_at** | **Time** | WhatsApp only. When Zernio stored this referral. Always present when a WhatsApp referral was captured. | [optional] |
+| **meta_ad_id** | **String** | Instagram and Facebook only. The Meta ad ID the user clicked. Always present when an Instagram or Facebook referral was captured. | [optional] |
+| **meta_ad_source** | **String** | Instagram and Facebook only. Meta-supplied source identifier, for example ADS. | [optional] |
+| **meta_ad_type** | **String** | Instagram and Facebook only. Meta-supplied referral type, for example OPEN_THREAD. | [optional] |
+| **meta_ad_ref** | **String** | Instagram and Facebook only. The ref parameter passed through from the ad creative. | [optional] |
+| **meta_ad_title** | **String** | Instagram and Facebook only. Title of the ad creative at click time. | [optional] |
+| **meta_ad_photo_url** | **String** | Instagram and Facebook only. Image of the ad creative at click time. | [optional] |
+| **meta_ad_video_url** | **String** | Instagram and Facebook only. Video of the ad creative at click time. | [optional] |
+| **meta_ad_post_id** | **String** | Instagram and Facebook only. The organic post the ad promoted, when the ad was a boosted post. | [optional] |
+| **meta_ad_product_id** | **String** | Instagram and Facebook only. The catalogue product the user clicked, for product ads. | [optional] |
+| **meta_ad_flow_id** | **String** | Instagram and Facebook only. The Meta flow the ad launched, for flow ads. | [optional] |
+| **meta_ad_captured_at** | **Time** | Instagram and Facebook only. When Zernio stored this referral. Always present when an Instagram or Facebook referral was captured. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::ListInboxConversations200ResponseDataInnerMetadata.new(
+  ctwa_clid: null,
+  ctwa_source_id: null,
+  ctwa_source_type: null,
+  ctwa_source_url: null,
+  ctwa_headline: null,
+  ctwa_captured_at: null,
+  meta_ad_id: null,
+  meta_ad_source: null,
+  meta_ad_type: null,
+  meta_ad_ref: null,
+  meta_ad_title: null,
+  meta_ad_photo_url: null,
+  meta_ad_video_url: null,
+  meta_ad_post_id: null,
+  meta_ad_product_id: null,
+  meta_ad_flow_id: null,
+  meta_ad_captured_at: null
+)
+```
+

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

@@ -833,7 +833,7 @@ module Zernio
     # @option opts [Date] :from_date Start of the METRICS date range (YYYY-MM-DD). Affects only the spend/impression numbers overlaid on each node, NOT which campaigns are returned. 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.
     # @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`. See `dailyLevel` to control which levels carry it.
+    # @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 Meta `reach`: the range total is Meta'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]
     def get_ad_tree(opts = {})
@@ -857,7 +857,7 @@ module Zernio
     # @option opts [Date] :from_date Start of the METRICS date range (YYYY-MM-DD). Affects only the spend/impression numbers overlaid on each node, NOT which campaigns are returned. 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.
     # @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`. See `dailyLevel` to control which levels carry it.
+    # @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 Meta `reach`: the range total is Meta'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
     def get_ad_tree_with_http_info(opts = {})

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

@@ -515,7 +515,7 @@ module Zernio
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: MessagesApi.list_inbox_conversations ...'
       end
-      allowable_values = ["facebook", "instagram", "twitter", "bluesky", "reddit", "telegram"]
+      allowable_values = ["facebook", "instagram", "twitter", "bluesky", "reddit", "telegram", "whatsapp"]
       if @api_client.config.client_side_validation && opts[:'platform'] && !allowable_values.include?(opts[:'platform'])
         fail ArgumentError, "invalid value for \"platform\", must be one of #{allowable_values}"
       end

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

@@ -14,12 +14,13 @@ require 'date'
 require 'time'
 
 module Zernio
-  # One day of metrics. Same fields as `AdMetrics` plus the `date` they apply to. Returned inside a node's `daily[]` when `GET /v1/ads/tree` is called with `timeIncrement=1`. Rate metrics (ctr/cpc/cpm/costPerConversion/ roas/videoAvgTimeWatchedActions) are recomputed per day from that day's sums, so summing the additive fields across a node's `daily[]` reproduces its aggregated `metrics` total. Do NOT sum or plain-average `videoAvgTimeWatchedActions` across days: the range value is the play-weighted average of the daily values. 
+  # One day of metrics. Same fields as `AdMetrics` plus the `date` they apply to. Returned inside a node's `daily[]` when `GET /v1/ads/tree` is called with `timeIncrement=1`. Rate metrics (ctr/cpc/cpm/costPerConversion/ roas/videoAvgTimeWatchedActions) are recomputed per day from that day's sums, so summing the additive fields across a node's `daily[]` reproduces its aggregated `metrics` total. `reach` is the exception: on Meta the aggregated total is de-duplicated across the range, so daily reach does not sum to it. Do NOT sum or plain-average `videoAvgTimeWatchedActions` across days: the range value is the play-weighted average of the daily values. 
   class AdDailyMetrics < ApiModelBase
     attr_accessor :spend
 
     attr_accessor :impressions
 
+    # Unique people reached in the requested date range. Meta (facebook/instagram): Meta's own de-duplicated reach for the exact range, fetched live and cached up to ~1 hour (may lag recent delivery; on a transient Meta error the value temporarily falls back to a sum of per-day reach, which overcounts people reached on multiple days or by multiple child ads). Because it is de-duplicated, Meta reach is NOT additive: neither daily values nor child nodes sum to the range total. TikTok: sum of per-day reach, so multi-day ranges overcount vs TikTok Ads Manager. Google, LinkedIn, X, Pinterest and OpenAI report 0 (reach not synced). Only derive frequency (impressions / reach) for Meta.
     attr_accessor :reach
 
     attr_accessor :clicks

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

@@ -19,6 +19,7 @@ module Zernio
 
     attr_accessor :impressions
 
+    # Unique people reached in the requested date range. Meta (facebook/instagram): Meta's own de-duplicated reach for the exact range, fetched live and cached up to ~1 hour (may lag recent delivery; on a transient Meta error the value temporarily falls back to a sum of per-day reach, which overcounts people reached on multiple days or by multiple child ads). Because it is de-duplicated, Meta reach is NOT additive: neither daily values nor child nodes sum to the range total. TikTok: sum of per-day reach, so multi-day ranges overcount vs TikTok Ads Manager. Google, LinkedIn, X, Pinterest and OpenAI report 0 (reach not synced). Only derive frequency (impressions / reach) for Meta.
     attr_accessor :reach
 
     attr_accessor :clicks

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

@@ -83,7 +83,7 @@ module Zernio
 
     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.
+    # 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/get_ads_timeline200_response_rows_inner.rb

@@ -22,6 +22,7 @@ module Zernio
 
     attr_accessor :impressions
 
+    # Reach summed across the account's ads for this single day. A person seen by two ads the same day counts twice, and reach is de-duplicated per day only: do NOT sum it across days (people reached on multiple days would be double-counted).
     attr_accessor :reach
 
     attr_accessor :clicks

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

@@ -19,6 +19,7 @@ module Zernio
 
     attr_accessor :impressions
 
+    # Unique people reached in the requested date range. Meta (facebook/instagram): Meta's own de-duplicated reach for the exact range, fetched live and cached up to ~1 hour (may lag recent delivery; on a transient Meta error the value temporarily falls back to a sum of per-day reach, which overcounts people reached on multiple days or by multiple child ads). Because it is de-duplicated, Meta reach is NOT additive: neither daily values nor child nodes sum to the range total. TikTok: sum of per-day reach, so multi-day ranges overcount vs TikTok Ads Manager. Google, LinkedIn, X, Pinterest and OpenAI report 0 (reach not synced). Only derive frequency (impressions / reach) for Meta.
     attr_accessor :reach
 
     attr_accessor :clicks

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

@@ -42,6 +42,8 @@ module Zernio
 
     attr_accessor :instagram_profile
 
+    attr_accessor :metadata
+
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -79,7 +81,8 @@ module Zernio
         :'last_message_at' => :'lastMessageAt',
         :'updated_time' => :'updatedTime',
         :'participants' => :'participants',
-        :'instagram_profile' => :'instagramProfile'
+        :'instagram_profile' => :'instagramProfile',
+        :'metadata' => :'metadata'
       }
     end
 
@@ -108,7 +111,8 @@ module Zernio
         :'last_message_at' => :'Time',
         :'updated_time' => :'Time',
         :'participants' => :'Array<UpdateFacebookPage200ResponseSelectedPage>',
-        :'instagram_profile' => :'ListInboxConversations200ResponseDataInnerInstagramProfile'
+        :'instagram_profile' => :'ListInboxConversations200ResponseDataInnerInstagramProfile',
+        :'metadata' => :'GetInboxConversation200ResponseDataMetadata'
       }
     end
 
@@ -188,6 +192,10 @@ module Zernio
       if attributes.key?(:'instagram_profile')
         self.instagram_profile = attributes[:'instagram_profile']
       end
+
+      if attributes.key?(:'metadata')
+        self.metadata = attributes[:'metadata']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -246,7 +254,8 @@ module Zernio
           last_message_at == o.last_message_at &&
           updated_time == o.updated_time &&
           participants == o.participants &&
-          instagram_profile == o.instagram_profile
+          instagram_profile == o.instagram_profile &&
+          metadata == o.metadata
     end
 
     # @see the `==` method
@@ -258,7 +267,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, account_id, account_username, platform, status, participant_name, participant_id, participant_verified_type, last_message, last_message_at, updated_time, participants, instagram_profile].hash
+      [id, account_id, account_username, platform, status, participant_name, participant_id, participant_verified_type, last_message, last_message_at, updated_time, participants, instagram_profile, metadata].hash
     end
 
     # Builds the object from hash

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

@@ -0,0 +1,249 @@
+=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
+  # Ad-click attribution for a conversation that started from a Meta ad. Absent when the conversation did not originate from an ad click.  Captured once, on the first inbound message after the click, and never overwritten. If the same person later clicks a different ad, the original values are kept. Meta only sends the referral on that first message.  This operation currently returns only the `meta_ad_*` family, which covers Instagram Click-to-Direct and Facebook Messenger Click-to-Message. WhatsApp Click-to-WhatsApp attribution (the `ctwa_*` keys, where the ad ID is `ctwa_source_id`) is returned by `GET /v1/inbox/conversations` instead.  Every key is optional and only the keys Meta supplied are returned, so read defensively. Meta does not send a campaign or ad set ID, so none is exposed here. More keys may be added over time. Treat any key you do not recognise as an opaque string.  Key names differ from the `message.received` webhook on purpose. The webhook forwards Meta's referral verbatim (`ad_id`, `source`, `type`) while the stored conversation record uses the prefixed names below. Renaming either side would break existing integrations, so both spellings are kept. 
+  class GetInboxConversation200ResponseDataMetadata < ApiModelBase
+    # The Meta ad ID the user clicked. Always present when a referral was captured.
+    attr_accessor :meta_ad_id
+
+    # Meta-supplied source identifier, for example ADS.
+    attr_accessor :meta_ad_source
+
+    # Meta-supplied referral type, for example OPEN_THREAD.
+    attr_accessor :meta_ad_type
+
+    # The ref parameter passed through from the ad creative.
+    attr_accessor :meta_ad_ref
+
+    # Title of the ad creative at click time.
+    attr_accessor :meta_ad_title
+
+    # Image of the ad creative at click time.
+    attr_accessor :meta_ad_photo_url
+
+    # Video of the ad creative at click time.
+    attr_accessor :meta_ad_video_url
+
+    # The organic post the ad promoted, when the ad was a boosted post.
+    attr_accessor :meta_ad_post_id
+
+    # The catalogue product the user clicked, for product ads.
+    attr_accessor :meta_ad_product_id
+
+    # The Meta flow the ad launched, for flow ads.
+    attr_accessor :meta_ad_flow_id
+
+    # When Zernio stored this referral. Always present when a referral was captured.
+    attr_accessor :meta_ad_captured_at
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'meta_ad_id' => :'meta_ad_id',
+        :'meta_ad_source' => :'meta_ad_source',
+        :'meta_ad_type' => :'meta_ad_type',
+        :'meta_ad_ref' => :'meta_ad_ref',
+        :'meta_ad_title' => :'meta_ad_title',
+        :'meta_ad_photo_url' => :'meta_ad_photo_url',
+        :'meta_ad_video_url' => :'meta_ad_video_url',
+        :'meta_ad_post_id' => :'meta_ad_post_id',
+        :'meta_ad_product_id' => :'meta_ad_product_id',
+        :'meta_ad_flow_id' => :'meta_ad_flow_id',
+        :'meta_ad_captured_at' => :'meta_ad_captured_at'
+      }
+    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
+      {
+        :'meta_ad_id' => :'String',
+        :'meta_ad_source' => :'String',
+        :'meta_ad_type' => :'String',
+        :'meta_ad_ref' => :'String',
+        :'meta_ad_title' => :'String',
+        :'meta_ad_photo_url' => :'String',
+        :'meta_ad_video_url' => :'String',
+        :'meta_ad_post_id' => :'String',
+        :'meta_ad_product_id' => :'String',
+        :'meta_ad_flow_id' => :'String',
+        :'meta_ad_captured_at' => :'Time'
+      }
+    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::GetInboxConversation200ResponseDataMetadata` 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::GetInboxConversation200ResponseDataMetadata`. 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?(:'meta_ad_id')
+        self.meta_ad_id = attributes[:'meta_ad_id']
+      end
+
+      if attributes.key?(:'meta_ad_source')
+        self.meta_ad_source = attributes[:'meta_ad_source']
+      end
+
+      if attributes.key?(:'meta_ad_type')
+        self.meta_ad_type = attributes[:'meta_ad_type']
+      end
+
+      if attributes.key?(:'meta_ad_ref')
+        self.meta_ad_ref = attributes[:'meta_ad_ref']
+      end
+
+      if attributes.key?(:'meta_ad_title')
+        self.meta_ad_title = attributes[:'meta_ad_title']
+      end
+
+      if attributes.key?(:'meta_ad_photo_url')
+        self.meta_ad_photo_url = attributes[:'meta_ad_photo_url']
+      end
+
+      if attributes.key?(:'meta_ad_video_url')
+        self.meta_ad_video_url = attributes[:'meta_ad_video_url']
+      end
+
+      if attributes.key?(:'meta_ad_post_id')
+        self.meta_ad_post_id = attributes[:'meta_ad_post_id']
+      end
+
+      if attributes.key?(:'meta_ad_product_id')
+        self.meta_ad_product_id = attributes[:'meta_ad_product_id']
+      end
+
+      if attributes.key?(:'meta_ad_flow_id')
+        self.meta_ad_flow_id = attributes[:'meta_ad_flow_id']
+      end
+
+      if attributes.key?(:'meta_ad_captured_at')
+        self.meta_ad_captured_at = attributes[:'meta_ad_captured_at']
+      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 &&
+          meta_ad_id == o.meta_ad_id &&
+          meta_ad_source == o.meta_ad_source &&
+          meta_ad_type == o.meta_ad_type &&
+          meta_ad_ref == o.meta_ad_ref &&
+          meta_ad_title == o.meta_ad_title &&
+          meta_ad_photo_url == o.meta_ad_photo_url &&
+          meta_ad_video_url == o.meta_ad_video_url &&
+          meta_ad_post_id == o.meta_ad_post_id &&
+          meta_ad_product_id == o.meta_ad_product_id &&
+          meta_ad_flow_id == o.meta_ad_flow_id &&
+          meta_ad_captured_at == o.meta_ad_captured_at
+    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
+      [meta_ad_id, meta_ad_source, meta_ad_type, meta_ad_ref, meta_ad_title, meta_ad_photo_url, meta_ad_video_url, meta_ad_post_id, meta_ad_product_id, meta_ad_flow_id, meta_ad_captured_at].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