late-sdk 0.0.1403 → 0.0.1404

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 84ed192f7d2fab4c093a63b652b45e42dc603b89a14113aaec86cdcc3cf585c7
-  data.tar.gz: 717f05995fc3acf38b984e9d1b27afc8a3f2c2f0b50a1b317bfaab719dcec959
+  metadata.gz: 8510d16cc8e7290a7b4a225ffd0278824a63c3c9b2ae23b43a085973fc8e3e3f
+  data.tar.gz: 9eb7a35b71116a34e42d7339f227770045b14942aab2a60688e48015f5ace3f1
 SHA512:
-  metadata.gz: 5632bf3a9981e9348a88ca199ed6d0ceea02106ecdf7cfb50e57c196f17f08c63ac7d34edbd0464349f8da0845e012efa9759536f51ca55afcdd049c58e67c6d
-  data.tar.gz: bd6211d4bba84f4330d86e2507754bdbbf23f27e16bc3bddbc05cb840f66fb92ef4d2bc0bf044e0c52dea91de46793f788e4893bf62890b6c9fc1182a1f207fa
+  metadata.gz: 4a01e3c64d8e05a4e8126fa18203ed3d16da915fdaf937362860f0e5ece5eacc87b3b5fbcb8002955b4834d9ec8973ef7b377d61b0e69e5318ddc05e8e6fbdbb
+  data.tar.gz: 24952b6d468321c6f173d975237c87164a7f51704e1414103cff078aa46d9f9f6e14607675b0c767742d0cd5446f2b700157d33ef9a88749056dee6583d4bfae

data/README.md

@@ -1295,6 +1295,8 @@ Class | Method | HTTP request | Description
  - [Zernio::CallRecordTranscriptInner](docs/CallRecordTranscriptInner.md)
  - [Zernio::CampaignAnalyticsResponse](docs/CampaignAnalyticsResponse.md)
  - [Zernio::CampaignAnalyticsResponseAnalytics](docs/CampaignAnalyticsResponseAnalytics.md)
+ - [Zernio::CampaignAnalyticsResponseAnalyticsBreakdownErrorsInner](docs/CampaignAnalyticsResponseAnalyticsBreakdownErrorsInner.md)
+ - [Zernio::CampaignAnalyticsResponseAnalyticsBreakdownsRange](docs/CampaignAnalyticsResponseAnalyticsBreakdownsRange.md)
  - [Zernio::CampaignAnalyticsResponseAnalyticsDailyInner](docs/CampaignAnalyticsResponseAnalyticsDailyInner.md)
  - [Zernio::CampaignAnalyticsResponseAnalyticsImpressionShareCache](docs/CampaignAnalyticsResponseAnalyticsImpressionShareCache.md)
  - [Zernio::CampaignAnalyticsResponseAnalyticsSummary](docs/CampaignAnalyticsResponseAnalyticsSummary.md)

data/docs/AdAnalyticsResponseAnalytics.md

@@ -6,7 +6,12 @@
 | ---- | ---- | ----------- | ----- |
 | **summary** | [**AdMetrics**](AdMetrics.md) |  | [optional] |
 | **daily** | [**Array<CampaignAnalyticsResponseAnalyticsDailyInner>**](CampaignAnalyticsResponseAnalyticsDailyInner.md) |  | [optional] |
-| **breakdowns** | **Hash<String, Array<Object>>** | Requested demographic breakdowns, keyed by dimension. Fetched live from the platform per request and never stored, so these rows can carry fields the stored `summary` and `daily` series do not.  LinkedIn rows carry `value` (the pivot URN), `name` (resolved label where LinkedIn provides one), the usual spend/impressions/clicks/ctr/cpc/cpm/engagement figures, plus two reach fields:  - `reach`: the segment's `approximateMemberReach`. - `audiencePenetration`: LinkedIn's own ratio of members reached to the size of   the targeted audience, passed through verbatim.  LinkedIn withholds both below its audience privacy threshold, in which case the keys are ABSENT rather than 0. `audiencePenetration` is available here only: it is not part of the stored metrics series.  | [optional] |
+| **breakdowns** | **Hash<String, Array<Object>>** | Requested demographic breakdowns, keyed by dimension. Fetched live from the platform per request and never stored, so these rows can carry fields the stored `summary` and `daily` series do not.  LinkedIn rows carry `value` (the pivot URN), `name` (resolved label where LinkedIn provides one), the usual spend/impressions/clicks/ctr/cpc/cpm/engagement figures, plus two reach fields:  - `reach`: the segment's `approximateMemberReach`. - `audiencePenetration`: LinkedIn's own ratio of members reached to the size of   the targeted audience, passed through verbatim.  LinkedIn withholds both below its audience privacy threshold, in which case the keys are ABSENT rather than 0. `audiencePenetration` is available here only: it is not part of the stored metrics series.  TikTok rows are keyed by TikTok's own dimension name (`country_code` for `country`, `platform` for `publisher_platform`). `placement` rows carry the label TikTok Ads Manager shows (`TikTok`, `TikTok Ad Network`, `News Feed App Series`) in `placement` and TikTok's API value (`PLACEMENT_TIKTOK`, `PLACEMENT_PANGLE`, `PLACEMENT_GLOBAL_APP_BUNDLE`) in `placementRaw`; a value without a known label carries the raw value in both.  A requested dimension with no data in the range is an empty array.  | [optional] |
+| **unsupported_breakdowns** | **Array<String>** | Requested breakdowns this platform cannot break down by (e.g. region on TikTok, any breakdown on Google). Absent when every requested breakdown is supported. | [optional] |
+| **breakdown_hints** | **Hash<String, String>** | Guidance for some names in unsupportedBreakdowns, keyed by that name (e.g. placement on Meta points at publisher_platform and platform_position; platform_position on TikTok points at placement). Absent when no unsupported name has a hint. | [optional] |
+| **breakdown_errors** | [**Array<CampaignAnalyticsResponseAnalyticsBreakdownErrorsInner>**](CampaignAnalyticsResponseAnalyticsBreakdownErrorsInner.md) | TikTok only: breakdowns the platform failed to return (rate limit, permission, rejected query). Each one is an empty array under breakdowns; summary and daily are unaffected. Absent when every breakdown answered. | [optional] |
+| **breakdown_dropped_metrics** | **Hash<String, Array<String>>** | TikTok only: TikTok metric names TikTok refused for a breakdown, keyed by the requested breakdown (e.g. total_purchase and total_purchase_value have no relation to platform, ac or language). Every row value derived from a refused metric is null in that breakdown (purchaseValue and roas, or the matching actions and actionValues entries), never a number computed without it. Absent when no metric was refused. | [optional] |
+| **breakdowns_range** | [**CampaignAnalyticsResponseAnalyticsBreakdownsRange**](CampaignAnalyticsResponseAnalyticsBreakdownsRange.md) |  | [optional] |
 
 ## Example
 
@@ -16,7 +21,12 @@ require 'zernio-sdk'
 instance = Zernio::AdAnalyticsResponseAnalytics.new(
   summary: null,
   daily: null,
-  breakdowns: null
+  breakdowns: null,
+  unsupported_breakdowns: null,
+  breakdown_hints: null,
+  breakdown_errors: null,
+  breakdown_dropped_metrics: {publisher_platform=[total_purchase, total_purchase_value, total_initiate_checkout_value]},
+  breakdowns_range: null
 )
 ```
 

data/docs/AdInsightsApi.md

@@ -230,7 +230,7 @@ end
 
 Get ad analytics
 
-Returns one ad's performance summary and daily timeline, with optional audience breakdowns on Meta and TikTok.  Includes summary metrics, a daily timeline over the requested date range, and optional demographic breakdowns (Meta and TikTok only). If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max. 
+Returns one ad's performance summary and daily timeline, with optional audience breakdowns on Meta, TikTok and LinkedIn.  Includes summary metrics, a daily timeline over the requested date range, and optional demographic breakdowns (Meta, TikTok and LinkedIn only). If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max. 
 
 ### Examples
 
@@ -248,7 +248,7 @@ ad_id = 'ad_id_example' # String |
 opts = {
   from_date: Date.parse('2013-10-20'), # Date | Start of date range (YYYY-MM-DD). Defaults to 90 days ago.
   to_date: Date.parse('2013-10-20'), # Date | End of date range (YYYY-MM-DD). Defaults to today. Max 730-day range.
-  breakdowns: 'breakdowns_example' # String | 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. 
+  breakdowns: 'breakdowns_example' # String | 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.  **TikTok**: gender, age, country (or country_code), publisher_platform (or platform), ac, language, placement. TikTok serves at most 365 days per breakdown, so a longer range is read over its last 365 days and `analytics.breakdownsRange` says which window.  **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.  A known dimension the platform cannot break down by is listed in `analytics.unsupportedBreakdowns` instead of being dropped (with guidance in `analytics.breakdownHints` where there is an alternative); the rest of the response is unchanged. An unknown name returns 400. A TikTok dimension that fails is listed in `analytics.breakdownErrors` and the response stays 200. Metrics TikTok refuses for a dimension are listed in `analytics.breakdownDroppedMetrics`, and the row values derived from them are null. 
 }
 
 begin
@@ -285,7 +285,7 @@ end
 | **ad_id** | **String** |  |  |
 | **from_date** | **Date** | Start of date range (YYYY-MM-DD). Defaults to 90 days ago. | [optional] |
 | **to_date** | **Date** | End of date range (YYYY-MM-DD). Defaults to today. Max 730-day range. | [optional] |
-| **breakdowns** | **String** | 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.  | [optional] |
+| **breakdowns** | **String** | 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.  **TikTok**: gender, age, country (or country_code), publisher_platform (or platform), ac, language, placement. TikTok serves at most 365 days per breakdown, so a longer range is read over its last 365 days and `analytics.breakdownsRange` says which window.  **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.  A known dimension the platform cannot break down by is listed in `analytics.unsupportedBreakdowns` instead of being dropped (with guidance in `analytics.breakdownHints` where there is an alternative); the rest of the response is unchanged. An unknown name returns 400. A TikTok dimension that fails is listed in `analytics.breakdownErrors` and the response stays 200. Metrics TikTok refuses for a dimension are listed in `analytics.breakdownDroppedMetrics`, and the row values derived from them are null.  | [optional] |
 
 ### Return type
 
@@ -471,7 +471,7 @@ end
 
 Get campaign analytics
 
-Returns a campaign's performance summary and daily timeline, with optional breakdowns by age, gender and other audience dimensions.  Returns performance analytics for a whole campaign in one call: summary metrics, a daily timeline over the requested date range (summed across the campaign's ads), and optional demographic breakdowns. Breakdowns are fetched live from Meta at the campaign level (one call per dimension, no per-ad fan-out), so an agency dashboard gets campaign-level age/gender/etc. without summing thousands of per-ad reads. `campaignId` is the platform campaign id; pass `platform` when a campaign id could be ambiguous across platforms. If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max. Google adds searchImpressionShare, searchBudgetLostImpressionShare, searchRankLostImpressionShare, searchTopImpressionShare and searchAbsoluteTopImpressionShare under analytics.summary for the requested inclusive range. These ratios are queried together without daily segmentation and cached for 10 minutes. Unavailable values are null. analytics.impressionShareCache reports cachedAt and stale independently of synced metrics. 
+Returns a campaign's performance summary and daily timeline, with optional breakdowns by age, gender and other audience dimensions.  Returns performance analytics for a whole campaign in one call: summary metrics, a daily timeline over the requested date range (summed across the campaign's ads), and optional demographic breakdowns. Breakdowns are fetched live from Meta, TikTok or LinkedIn at the campaign level (one call per dimension, no per-ad fan-out), so an agency dashboard gets campaign-level age/gender/placement/etc. without summing thousands of per-ad reads. `campaignId` is the platform campaign id; pass `platform` when a campaign id could be ambiguous across platforms. If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max. Google adds searchImpressionShare, searchBudgetLostImpressionShare, searchRankLostImpressionShare, searchTopImpressionShare and searchAbsoluteTopImpressionShare under analytics.summary for the requested inclusive range. These ratios are queried together without daily segmentation and cached for 10 minutes. Unavailable values are null. analytics.impressionShareCache reports cachedAt and stale independently of synced metrics. 
 
 ### Examples
 
@@ -490,7 +490,7 @@ opts = {
   platform: 'platform_example', # String | Disambiguate when the campaign id exists across platforms (e.g. facebook, instagram).
   from_date: Date.parse('2013-10-20'), # Date | Start of date range (YYYY-MM-DD). Defaults to 90 days ago.
   to_date: Date.parse('2013-10-20'), # Date | End of date range (YYYY-MM-DD). Defaults to today. Max 730-day range.
-  breakdowns: 'breakdowns_example' # String | 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 `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. 
+  breakdowns: 'breakdowns_example' # String | 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.  **TikTok**: gender, age, country (or country_code), publisher_platform (or platform), ac, language, placement. TikTok serves at most 365 days per breakdown, so a longer range is read over its last 365 days and `analytics.breakdownsRange` says which window.  **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.  A known dimension the platform cannot break down by is listed in `analytics.unsupportedBreakdowns` instead of being dropped (with guidance in `analytics.breakdownHints` where there is an alternative); the rest of the response is unchanged. An unknown name returns 400. A TikTok dimension that fails is listed in `analytics.breakdownErrors` and the response stays 200. Metrics TikTok refuses for a dimension are listed in `analytics.breakdownDroppedMetrics`, and the row values derived from them are null. 
 }
 
 begin
@@ -528,7 +528,7 @@ end
 | **platform** | **String** | Disambiguate when the campaign id exists across platforms (e.g. facebook, instagram). | [optional] |
 | **from_date** | **Date** | Start of date range (YYYY-MM-DD). Defaults to 90 days ago. | [optional] |
 | **to_date** | **Date** | End of date range (YYYY-MM-DD). Defaults to today. Max 730-day range. | [optional] |
-| **breakdowns** | **String** | 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 `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.  | [optional] |
+| **breakdowns** | **String** | 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.  **TikTok**: gender, age, country (or country_code), publisher_platform (or platform), ac, language, placement. TikTok serves at most 365 days per breakdown, so a longer range is read over its last 365 days and `analytics.breakdownsRange` says which window.  **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.  A known dimension the platform cannot break down by is listed in `analytics.unsupportedBreakdowns` instead of being dropped (with guidance in `analytics.breakdownHints` where there is an alternative); the rest of the response is unchanged. An unknown name returns 400. A TikTok dimension that fails is listed in `analytics.breakdownErrors` and the response stays 200. Metrics TikTok refuses for a dimension are listed in `analytics.breakdownDroppedMetrics`, and the row values derived from them are null.  | [optional] |
 
 ### Return type
 
@@ -832,7 +832,7 @@ opts = {
   page_token: 'page_token_example', # String | Google only: cursor from paging.nextPageToken of the previous page.
   level: 'ad', # String | Row granularity
   fields: 'fields_example', # String | Comma-separated Graph insights fields (e.g. spend,impressions,frequency,website_purchase_roas). Omitted = Meta's default set.
-  breakdowns: 'breakdowns_example', # String | Comma-separated Graph breakdowns (e.g. age,gender or publisher_platform).
+  breakdowns: 'breakdowns_example', # String | Meta only: comma-separated Graph breakdowns (e.g. age,gender or publisher_platform). Returns 400 on TikTok (add the breakdown to dimensions with reportType=AUDIENCE, e.g. dimensions=campaign_id,placement) and on Google (select segments.* in the query).
   action_breakdowns: 'action_breakdowns_example', # String | Comma-separated Graph action breakdowns; segments the actions[] arrays in each row. Pass `none` to clear Meta's default action_type breakdown, required to combine some non-action breakdowns such as instagram_ads_follow_type (otherwise Meta returns a (#100) invalid-combination error).
   action_attribution_windows: 'action_attribution_windows_example', # String | Comma-separated Meta attribution windows. Action values are returned keyed per window.
   action_report_time: 'action_report_time_example', # String | When actions are counted: impression, conversion or mixed.
@@ -891,7 +891,7 @@ end
 | **page_token** | **String** | Google only: cursor from paging.nextPageToken of the previous page. | [optional] |
 | **level** | **String** | Row granularity | [optional] |
 | **fields** | **String** | Comma-separated Graph insights fields (e.g. spend,impressions,frequency,website_purchase_roas). Omitted = Meta's default set. | [optional] |
-| **breakdowns** | **String** | Comma-separated Graph breakdowns (e.g. age,gender or publisher_platform). | [optional] |
+| **breakdowns** | **String** | Meta only: comma-separated Graph breakdowns (e.g. age,gender or publisher_platform). Returns 400 on TikTok (add the breakdown to dimensions with reportType=AUDIENCE, e.g. dimensions=campaign_id,placement) and on Google (select segments.* in the query). | [optional] |
 | **action_breakdowns** | **String** | Comma-separated Graph action breakdowns; segments the actions[] arrays in each row. Pass `none` to clear Meta's default action_type breakdown, required to combine some non-action breakdowns such as instagram_ads_follow_type (otherwise Meta returns a (#100) invalid-combination error). | [optional] |
 | **action_attribution_windows** | **String** | Comma-separated Meta attribution windows. Action values are returned keyed per window. | [optional] |
 | **action_report_time** | **String** | When actions are counted: impression, conversion or mixed. | [optional] |

data/docs/CampaignAnalyticsResponseAnalytics.md

@@ -7,7 +7,12 @@
 | **summary** | [**CampaignAnalyticsResponseAnalyticsSummary**](CampaignAnalyticsResponseAnalyticsSummary.md) |  | [optional] |
 | **impression_share_cache** | [**CampaignAnalyticsResponseAnalyticsImpressionShareCache**](CampaignAnalyticsResponseAnalyticsImpressionShareCache.md) |  | [optional] |
 | **daily** | [**Array<CampaignAnalyticsResponseAnalyticsDailyInner>**](CampaignAnalyticsResponseAnalyticsDailyInner.md) |  | [optional] |
-| **breakdowns** | **Hash<String, Array<Object>>** | Requested demographic breakdowns, keyed by dimension. Fetched live from the platform per request and never stored, so these rows can carry fields the stored `summary` and `daily` series do not.  LinkedIn rows carry `value` (the pivot URN), `name` (resolved label where LinkedIn provides one), the usual spend/impressions/clicks/ctr/cpc/cpm/engagement figures, plus two reach fields:  - `reach`: the segment's `approximateMemberReach`. - `audiencePenetration`: LinkedIn's own ratio of members reached to the size of   the targeted audience, passed through verbatim.  LinkedIn withholds both below its audience privacy threshold, in which case the keys are ABSENT rather than 0. `audiencePenetration` is available here only: it is not part of the stored metrics series.  | [optional] |
+| **breakdowns** | **Hash<String, Array<Object>>** | Requested demographic breakdowns, keyed by dimension. Fetched live from the platform per request and never stored, so these rows can carry fields the stored `summary` and `daily` series do not.  LinkedIn rows carry `value` (the pivot URN), `name` (resolved label where LinkedIn provides one), the usual spend/impressions/clicks/ctr/cpc/cpm/engagement figures, plus two reach fields:  - `reach`: the segment's `approximateMemberReach`. - `audiencePenetration`: LinkedIn's own ratio of members reached to the size of   the targeted audience, passed through verbatim.  LinkedIn withholds both below its audience privacy threshold, in which case the keys are ABSENT rather than 0. `audiencePenetration` is available here only: it is not part of the stored metrics series.  TikTok rows are keyed by TikTok's own dimension name (`country_code` for `country`, `platform` for `publisher_platform`). `placement` rows carry the label TikTok Ads Manager shows (`TikTok`, `TikTok Ad Network`, `News Feed App Series`) in `placement` and TikTok's API value (`PLACEMENT_TIKTOK`, `PLACEMENT_PANGLE`, `PLACEMENT_GLOBAL_APP_BUNDLE`) in `placementRaw`; a value without a known label carries the raw value in both.  A requested dimension with no data in the range is an empty array.  | [optional] |
+| **unsupported_breakdowns** | **Array<String>** | Requested breakdowns this platform cannot break down by (e.g. region on TikTok, any breakdown on Google). Absent when every requested breakdown is supported. | [optional] |
+| **breakdown_hints** | **Hash<String, String>** | Guidance for some names in unsupportedBreakdowns, keyed by that name (e.g. placement on Meta points at publisher_platform and platform_position; platform_position on TikTok points at placement). Absent when no unsupported name has a hint. | [optional] |
+| **breakdown_errors** | [**Array<CampaignAnalyticsResponseAnalyticsBreakdownErrorsInner>**](CampaignAnalyticsResponseAnalyticsBreakdownErrorsInner.md) | TikTok only: breakdowns the platform failed to return (rate limit, permission, rejected query). Each one is an empty array under breakdowns; summary and daily are unaffected. Absent when every breakdown answered. | [optional] |
+| **breakdown_dropped_metrics** | **Hash<String, Array<String>>** | TikTok only: TikTok metric names TikTok refused for a breakdown, keyed by the requested breakdown (e.g. total_purchase and total_purchase_value have no relation to platform, ac or language). Every row value derived from a refused metric is null in that breakdown (purchaseValue and roas, or the matching actions and actionValues entries), never a number computed without it. Absent when no metric was refused. | [optional] |
+| **breakdowns_range** | [**CampaignAnalyticsResponseAnalyticsBreakdownsRange**](CampaignAnalyticsResponseAnalyticsBreakdownsRange.md) |  | [optional] |
 
 ## Example
 
@@ -18,7 +23,12 @@ instance = Zernio::CampaignAnalyticsResponseAnalytics.new(
   summary: null,
   impression_share_cache: null,
   daily: null,
-  breakdowns: null
+  breakdowns: null,
+  unsupported_breakdowns: null,
+  breakdown_hints: null,
+  breakdown_errors: null,
+  breakdown_dropped_metrics: {publisher_platform=[total_purchase, total_purchase_value, total_initiate_checkout_value]},
+  breakdowns_range: null
 )
 ```
 

data/docs/CampaignAnalyticsResponseAnalyticsBreakdownErrorsInner.md

@@ -0,0 +1,20 @@
+# Zernio::CampaignAnalyticsResponseAnalyticsBreakdownErrorsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **breakdown** | **String** |  | [optional] |
+| **message** | **String** | The platform's error message. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CampaignAnalyticsResponseAnalyticsBreakdownErrorsInner.new(
+  breakdown: null,
+  message: null
+)
+```
+

data/docs/CampaignAnalyticsResponseAnalyticsBreakdownsRange.md

@@ -0,0 +1,20 @@
+# Zernio::CampaignAnalyticsResponseAnalyticsBreakdownsRange
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **from_date** | **Date** |  | [optional] |
+| **to_date** | **Date** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CampaignAnalyticsResponseAnalyticsBreakdownsRange.new(
+  from_date: null,
+  to_date: null
+)
+```
+

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

@@ -224,12 +224,12 @@ module Zernio
     end
 
     # Get ad analytics
-    # Returns one ad's performance summary and daily timeline, with optional audience breakdowns on Meta and TikTok.  Includes summary metrics, a daily timeline over the requested date range, and optional demographic breakdowns (Meta and TikTok only). If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max. 
+    # Returns one ad's performance summary and daily timeline, with optional audience breakdowns on Meta, TikTok and LinkedIn.  Includes summary metrics, a daily timeline over the requested date range, and optional demographic breakdowns (Meta, TikTok and LinkedIn only). If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max. 
     # @param ad_id [String] 
     # @param [Hash] opts the optional parameters
     # @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. 
+    # @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.  **TikTok**: gender, age, country (or country_code), publisher_platform (or platform), ac, language, placement. TikTok serves at most 365 days per breakdown, so a longer range is read over its last 365 days and `analytics.breakdownsRange` says which window.  **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.  A known dimension the platform cannot break down by is listed in `analytics.unsupportedBreakdowns` instead of being dropped (with guidance in `analytics.breakdownHints` where there is an alternative); the rest of the response is unchanged. An unknown name returns 400. A TikTok dimension that fails is listed in `analytics.breakdownErrors` and the response stays 200. Metrics TikTok refuses for a dimension are listed in `analytics.breakdownDroppedMetrics`, and the row values derived from them are null. 
     # @return [AdAnalyticsResponse]
     def get_ad_analytics(ad_id, opts = {})
       data, _status_code, _headers = get_ad_analytics_with_http_info(ad_id, opts)
@@ -237,12 +237,12 @@ module Zernio
     end
 
     # Get ad analytics
-    # Returns one ad's performance summary and daily timeline, with optional audience breakdowns on Meta and TikTok.  Includes summary metrics, a daily timeline over the requested date range, and optional demographic breakdowns (Meta and TikTok only). If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max. 
+    # Returns one ad's performance summary and daily timeline, with optional audience breakdowns on Meta, TikTok and LinkedIn.  Includes summary metrics, a daily timeline over the requested date range, and optional demographic breakdowns (Meta, TikTok and LinkedIn only). If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max. 
     # @param ad_id [String] 
     # @param [Hash] opts the optional parameters
     # @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. 
+    # @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.  **TikTok**: gender, age, country (or country_code), publisher_platform (or platform), ac, language, placement. TikTok serves at most 365 days per breakdown, so a longer range is read over its last 365 days and `analytics.breakdownsRange` says which window.  **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.  A known dimension the platform cannot break down by is listed in `analytics.unsupportedBreakdowns` instead of being dropped (with guidance in `analytics.breakdownHints` where there is an alternative); the rest of the response is unchanged. An unknown name returns 400. A TikTok dimension that fails is listed in `analytics.breakdownErrors` and the response stays 200. Metrics TikTok refuses for a dimension are listed in `analytics.breakdownDroppedMetrics`, and the row values derived from them are null. 
     # @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
@@ -468,13 +468,13 @@ module Zernio
     end
 
     # Get campaign analytics
-    # Returns a campaign's performance summary and daily timeline, with optional breakdowns by age, gender and other audience dimensions.  Returns performance analytics for a whole campaign in one call: summary metrics, a daily timeline over the requested date range (summed across the campaign's ads), and optional demographic breakdowns. Breakdowns are fetched live from Meta at the campaign level (one call per dimension, no per-ad fan-out), so an agency dashboard gets campaign-level age/gender/etc. without summing thousands of per-ad reads. `campaignId` is the platform campaign id; pass `platform` when a campaign id could be ambiguous across platforms. If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max. Google adds searchImpressionShare, searchBudgetLostImpressionShare, searchRankLostImpressionShare, searchTopImpressionShare and searchAbsoluteTopImpressionShare under analytics.summary for the requested inclusive range. These ratios are queried together without daily segmentation and cached for 10 minutes. Unavailable values are null. analytics.impressionShareCache reports cachedAt and stale independently of synced metrics. 
+    # Returns a campaign's performance summary and daily timeline, with optional breakdowns by age, gender and other audience dimensions.  Returns performance analytics for a whole campaign in one call: summary metrics, a daily timeline over the requested date range (summed across the campaign's ads), and optional demographic breakdowns. Breakdowns are fetched live from Meta, TikTok or LinkedIn at the campaign level (one call per dimension, no per-ad fan-out), so an agency dashboard gets campaign-level age/gender/placement/etc. without summing thousands of per-ad reads. `campaignId` is the platform campaign id; pass `platform` when a campaign id could be ambiguous across platforms. If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max. Google adds searchImpressionShare, searchBudgetLostImpressionShare, searchRankLostImpressionShare, searchTopImpressionShare and searchAbsoluteTopImpressionShare under analytics.summary for the requested inclusive range. These ratios are queried together without daily segmentation and cached for 10 minutes. Unavailable values are null. analytics.impressionShareCache reports cachedAt and stale independently of synced metrics. 
     # @param campaign_id [String] Platform campaign id (platformCampaignId).
     # @param [Hash] opts the optional parameters
     # @option opts [String] :platform Disambiguate when the campaign id exists across platforms (e.g. facebook, instagram).
     # @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. 
+    # @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.  **TikTok**: gender, age, country (or country_code), publisher_platform (or platform), ac, language, placement. TikTok serves at most 365 days per breakdown, so a longer range is read over its last 365 days and &#x60;analytics.breakdownsRange&#x60; says which window.  **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.  A known dimension the platform cannot break down by is listed in &#x60;analytics.unsupportedBreakdowns&#x60; instead of being dropped (with guidance in &#x60;analytics.breakdownHints&#x60; where there is an alternative); the rest of the response is unchanged. An unknown name returns 400. A TikTok dimension that fails is listed in &#x60;analytics.breakdownErrors&#x60; and the response stays 200. Metrics TikTok refuses for a dimension are listed in &#x60;analytics.breakdownDroppedMetrics&#x60;, and the row values derived from them are null. 
     # @return [CampaignAnalyticsResponse]
     def get_campaign_analytics(campaign_id, opts = {})
       data, _status_code, _headers = get_campaign_analytics_with_http_info(campaign_id, opts)
@@ -482,13 +482,13 @@ module Zernio
     end
 
     # Get campaign analytics
-    # Returns a campaign&#39;s performance summary and daily timeline, with optional breakdowns by age, gender and other audience dimensions.  Returns performance analytics for a whole campaign in one call: summary metrics, a daily timeline over the requested date range (summed across the campaign&#39;s ads), and optional demographic breakdowns. Breakdowns are fetched live from Meta at the campaign level (one call per dimension, no per-ad fan-out), so an agency dashboard gets campaign-level age/gender/etc. without summing thousands of per-ad reads. &#x60;campaignId&#x60; is the platform campaign id; pass &#x60;platform&#x60; when a campaign id could be ambiguous across platforms. If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max. Google adds searchImpressionShare, searchBudgetLostImpressionShare, searchRankLostImpressionShare, searchTopImpressionShare and searchAbsoluteTopImpressionShare under analytics.summary for the requested inclusive range. These ratios are queried together without daily segmentation and cached for 10 minutes. Unavailable values are null. analytics.impressionShareCache reports cachedAt and stale independently of synced metrics. 
+    # Returns a campaign&#39;s performance summary and daily timeline, with optional breakdowns by age, gender and other audience dimensions.  Returns performance analytics for a whole campaign in one call: summary metrics, a daily timeline over the requested date range (summed across the campaign&#39;s ads), and optional demographic breakdowns. Breakdowns are fetched live from Meta, TikTok or LinkedIn at the campaign level (one call per dimension, no per-ad fan-out), so an agency dashboard gets campaign-level age/gender/placement/etc. without summing thousands of per-ad reads. &#x60;campaignId&#x60; is the platform campaign id; pass &#x60;platform&#x60; when a campaign id could be ambiguous across platforms. If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max. Google adds searchImpressionShare, searchBudgetLostImpressionShare, searchRankLostImpressionShare, searchTopImpressionShare and searchAbsoluteTopImpressionShare under analytics.summary for the requested inclusive range. These ratios are queried together without daily segmentation and cached for 10 minutes. Unavailable values are null. analytics.impressionShareCache reports cachedAt and stale independently of synced metrics. 
     # @param campaign_id [String] Platform campaign id (platformCampaignId).
     # @param [Hash] opts the optional parameters
     # @option opts [String] :platform Disambiguate when the campaign id exists across platforms (e.g. facebook, instagram).
     # @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. 
+    # @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.  **TikTok**: gender, age, country (or country_code), publisher_platform (or platform), ac, language, placement. TikTok serves at most 365 days per breakdown, so a longer range is read over its last 365 days and &#x60;analytics.breakdownsRange&#x60; says which window.  **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.  A known dimension the platform cannot break down by is listed in &#x60;analytics.unsupportedBreakdowns&#x60; instead of being dropped (with guidance in &#x60;analytics.breakdownHints&#x60; where there is an alternative); the rest of the response is unchanged. An unknown name returns 400. A TikTok dimension that fails is listed in &#x60;analytics.breakdownErrors&#x60; and the response stays 200. Metrics TikTok refuses for a dimension are listed in &#x60;analytics.breakdownDroppedMetrics&#x60;, and the row values derived from them are null. 
     # @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
@@ -846,7 +846,7 @@ module Zernio
     # @option opts [String] :page_token Google only: cursor from paging.nextPageToken of the previous page.
     # @option opts [String] :level Row granularity
     # @option opts [String] :fields Comma-separated Graph insights fields (e.g. spend,impressions,frequency,website_purchase_roas). Omitted &#x3D; Meta&#39;s default set.
-    # @option opts [String] :breakdowns Comma-separated Graph breakdowns (e.g. age,gender or publisher_platform).
+    # @option opts [String] :breakdowns Meta only: comma-separated Graph breakdowns (e.g. age,gender or publisher_platform). Returns 400 on TikTok (add the breakdown to dimensions with reportType&#x3D;AUDIENCE, e.g. dimensions&#x3D;campaign_id,placement) and on Google (select segments.* in the query).
     # @option opts [String] :action_breakdowns Comma-separated Graph action breakdowns; segments the actions[] arrays in each row. Pass &#x60;none&#x60; to clear Meta&#39;s default action_type breakdown, required to combine some non-action breakdowns such as instagram_ads_follow_type (otherwise Meta returns a (#100) invalid-combination error).
     # @option opts [String] :action_attribution_windows Comma-separated Meta attribution windows. Action values are returned keyed per window.
     # @option opts [String] :action_report_time When actions are counted: impression, conversion or mixed.
@@ -881,7 +881,7 @@ module Zernio
     # @option opts [String] :page_token Google only: cursor from paging.nextPageToken of the previous page.
     # @option opts [String] :level Row granularity
     # @option opts [String] :fields Comma-separated Graph insights fields (e.g. spend,impressions,frequency,website_purchase_roas). Omitted &#x3D; Meta&#39;s default set.
-    # @option opts [String] :breakdowns Comma-separated Graph breakdowns (e.g. age,gender or publisher_platform).
+    # @option opts [String] :breakdowns Meta only: comma-separated Graph breakdowns (e.g. age,gender or publisher_platform). Returns 400 on TikTok (add the breakdown to dimensions with reportType&#x3D;AUDIENCE, e.g. dimensions&#x3D;campaign_id,placement) and on Google (select segments.* in the query).
     # @option opts [String] :action_breakdowns Comma-separated Graph action breakdowns; segments the actions[] arrays in each row. Pass &#x60;none&#x60; to clear Meta&#39;s default action_type breakdown, required to combine some non-action breakdowns such as instagram_ads_follow_type (otherwise Meta returns a (#100) invalid-combination error).
     # @option opts [String] :action_attribution_windows Comma-separated Meta attribution windows. Action values are returned keyed per window.
     # @option opts [String] :action_report_time When actions are counted: impression, conversion or mixed.

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

@@ -19,15 +19,34 @@ module Zernio
 
     attr_accessor :daily
 
-    # Requested demographic breakdowns, keyed by dimension. Fetched live from the platform per request and never stored, so these rows can carry fields the stored `summary` and `daily` series do not.  LinkedIn rows carry `value` (the pivot URN), `name` (resolved label where LinkedIn provides one), the usual spend/impressions/clicks/ctr/cpc/cpm/engagement figures, plus two reach fields:  - `reach`: the segment's `approximateMemberReach`. - `audiencePenetration`: LinkedIn's own ratio of members reached to the size of   the targeted audience, passed through verbatim.  LinkedIn withholds both below its audience privacy threshold, in which case the keys are ABSENT rather than 0. `audiencePenetration` is available here only: it is not part of the stored metrics series. 
+    # Requested demographic breakdowns, keyed by dimension. Fetched live from the platform per request and never stored, so these rows can carry fields the stored `summary` and `daily` series do not.  LinkedIn rows carry `value` (the pivot URN), `name` (resolved label where LinkedIn provides one), the usual spend/impressions/clicks/ctr/cpc/cpm/engagement figures, plus two reach fields:  - `reach`: the segment's `approximateMemberReach`. - `audiencePenetration`: LinkedIn's own ratio of members reached to the size of   the targeted audience, passed through verbatim.  LinkedIn withholds both below its audience privacy threshold, in which case the keys are ABSENT rather than 0. `audiencePenetration` is available here only: it is not part of the stored metrics series.  TikTok rows are keyed by TikTok's own dimension name (`country_code` for `country`, `platform` for `publisher_platform`). `placement` rows carry the label TikTok Ads Manager shows (`TikTok`, `TikTok Ad Network`, `News Feed App Series`) in `placement` and TikTok's API value (`PLACEMENT_TIKTOK`, `PLACEMENT_PANGLE`, `PLACEMENT_GLOBAL_APP_BUNDLE`) in `placementRaw`; a value without a known label carries the raw value in both.  A requested dimension with no data in the range is an empty array. 
     attr_accessor :breakdowns
 
+    # Requested breakdowns this platform cannot break down by (e.g. region on TikTok, any breakdown on Google). Absent when every requested breakdown is supported.
+    attr_accessor :unsupported_breakdowns
+
+    # Guidance for some names in unsupportedBreakdowns, keyed by that name (e.g. placement on Meta points at publisher_platform and platform_position; platform_position on TikTok points at placement). Absent when no unsupported name has a hint.
+    attr_accessor :breakdown_hints
+
+    # TikTok only: breakdowns the platform failed to return (rate limit, permission, rejected query). Each one is an empty array under breakdowns; summary and daily are unaffected. Absent when every breakdown answered.
+    attr_accessor :breakdown_errors
+
+    # TikTok only: TikTok metric names TikTok refused for a breakdown, keyed by the requested breakdown (e.g. total_purchase and total_purchase_value have no relation to platform, ac or language). Every row value derived from a refused metric is null in that breakdown (purchaseValue and roas, or the matching actions and actionValues entries), never a number computed without it. Absent when no metric was refused.
+    attr_accessor :breakdown_dropped_metrics
+
+    attr_accessor :breakdowns_range
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'summary' => :'summary',
         :'daily' => :'daily',
-        :'breakdowns' => :'breakdowns'
+        :'breakdowns' => :'breakdowns',
+        :'unsupported_breakdowns' => :'unsupportedBreakdowns',
+        :'breakdown_hints' => :'breakdownHints',
+        :'breakdown_errors' => :'breakdownErrors',
+        :'breakdown_dropped_metrics' => :'breakdownDroppedMetrics',
+        :'breakdowns_range' => :'breakdownsRange'
       }
     end
 
@@ -46,7 +65,12 @@ module Zernio
       {
         :'summary' => :'AdMetrics',
         :'daily' => :'Array<CampaignAnalyticsResponseAnalyticsDailyInner>',
-        :'breakdowns' => :'Hash<String, Array<Object>>'
+        :'breakdowns' => :'Hash<String, Array<Object>>',
+        :'unsupported_breakdowns' => :'Array<String>',
+        :'breakdown_hints' => :'Hash<String, String>',
+        :'breakdown_errors' => :'Array<CampaignAnalyticsResponseAnalyticsBreakdownErrorsInner>',
+        :'breakdown_dropped_metrics' => :'Hash<String, Array<String>>',
+        :'breakdowns_range' => :'CampaignAnalyticsResponseAnalyticsBreakdownsRange'
       }
     end
 
@@ -87,6 +111,34 @@ module Zernio
           self.breakdowns = value
         end
       end
+
+      if attributes.key?(:'unsupported_breakdowns')
+        if (value = attributes[:'unsupported_breakdowns']).is_a?(Array)
+          self.unsupported_breakdowns = value
+        end
+      end
+
+      if attributes.key?(:'breakdown_hints')
+        if (value = attributes[:'breakdown_hints']).is_a?(Hash)
+          self.breakdown_hints = value
+        end
+      end
+
+      if attributes.key?(:'breakdown_errors')
+        if (value = attributes[:'breakdown_errors']).is_a?(Array)
+          self.breakdown_errors = value
+        end
+      end
+
+      if attributes.key?(:'breakdown_dropped_metrics')
+        if (value = attributes[:'breakdown_dropped_metrics']).is_a?(Hash)
+          self.breakdown_dropped_metrics = value
+        end
+      end
+
+      if attributes.key?(:'breakdowns_range')
+        self.breakdowns_range = attributes[:'breakdowns_range']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -111,7 +163,12 @@ module Zernio
       self.class == o.class &&
           summary == o.summary &&
           daily == o.daily &&
-          breakdowns == o.breakdowns
+          breakdowns == o.breakdowns &&
+          unsupported_breakdowns == o.unsupported_breakdowns &&
+          breakdown_hints == o.breakdown_hints &&
+          breakdown_errors == o.breakdown_errors &&
+          breakdown_dropped_metrics == o.breakdown_dropped_metrics &&
+          breakdowns_range == o.breakdowns_range
     end
 
     # @see the `==` method
@@ -123,7 +180,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [summary, daily, breakdowns].hash
+      [summary, daily, breakdowns, unsupported_breakdowns, breakdown_hints, breakdown_errors, breakdown_dropped_metrics, breakdowns_range].hash
     end
 
     # Builds the object from hash

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

@@ -21,16 +21,35 @@ module Zernio
 
     attr_accessor :daily
 
-    # Requested demographic breakdowns, keyed by dimension. Fetched live from the platform per request and never stored, so these rows can carry fields the stored `summary` and `daily` series do not.  LinkedIn rows carry `value` (the pivot URN), `name` (resolved label where LinkedIn provides one), the usual spend/impressions/clicks/ctr/cpc/cpm/engagement figures, plus two reach fields:  - `reach`: the segment's `approximateMemberReach`. - `audiencePenetration`: LinkedIn's own ratio of members reached to the size of   the targeted audience, passed through verbatim.  LinkedIn withholds both below its audience privacy threshold, in which case the keys are ABSENT rather than 0. `audiencePenetration` is available here only: it is not part of the stored metrics series. 
+    # Requested demographic breakdowns, keyed by dimension. Fetched live from the platform per request and never stored, so these rows can carry fields the stored `summary` and `daily` series do not.  LinkedIn rows carry `value` (the pivot URN), `name` (resolved label where LinkedIn provides one), the usual spend/impressions/clicks/ctr/cpc/cpm/engagement figures, plus two reach fields:  - `reach`: the segment's `approximateMemberReach`. - `audiencePenetration`: LinkedIn's own ratio of members reached to the size of   the targeted audience, passed through verbatim.  LinkedIn withholds both below its audience privacy threshold, in which case the keys are ABSENT rather than 0. `audiencePenetration` is available here only: it is not part of the stored metrics series.  TikTok rows are keyed by TikTok's own dimension name (`country_code` for `country`, `platform` for `publisher_platform`). `placement` rows carry the label TikTok Ads Manager shows (`TikTok`, `TikTok Ad Network`, `News Feed App Series`) in `placement` and TikTok's API value (`PLACEMENT_TIKTOK`, `PLACEMENT_PANGLE`, `PLACEMENT_GLOBAL_APP_BUNDLE`) in `placementRaw`; a value without a known label carries the raw value in both.  A requested dimension with no data in the range is an empty array. 
     attr_accessor :breakdowns
 
+    # Requested breakdowns this platform cannot break down by (e.g. region on TikTok, any breakdown on Google). Absent when every requested breakdown is supported.
+    attr_accessor :unsupported_breakdowns
+
+    # Guidance for some names in unsupportedBreakdowns, keyed by that name (e.g. placement on Meta points at publisher_platform and platform_position; platform_position on TikTok points at placement). Absent when no unsupported name has a hint.
+    attr_accessor :breakdown_hints
+
+    # TikTok only: breakdowns the platform failed to return (rate limit, permission, rejected query). Each one is an empty array under breakdowns; summary and daily are unaffected. Absent when every breakdown answered.
+    attr_accessor :breakdown_errors
+
+    # TikTok only: TikTok metric names TikTok refused for a breakdown, keyed by the requested breakdown (e.g. total_purchase and total_purchase_value have no relation to platform, ac or language). Every row value derived from a refused metric is null in that breakdown (purchaseValue and roas, or the matching actions and actionValues entries), never a number computed without it. Absent when no metric was refused.
+    attr_accessor :breakdown_dropped_metrics
+
+    attr_accessor :breakdowns_range
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'summary' => :'summary',
         :'impression_share_cache' => :'impressionShareCache',
         :'daily' => :'daily',
-        :'breakdowns' => :'breakdowns'
+        :'breakdowns' => :'breakdowns',
+        :'unsupported_breakdowns' => :'unsupportedBreakdowns',
+        :'breakdown_hints' => :'breakdownHints',
+        :'breakdown_errors' => :'breakdownErrors',
+        :'breakdown_dropped_metrics' => :'breakdownDroppedMetrics',
+        :'breakdowns_range' => :'breakdownsRange'
       }
     end
 
@@ -50,7 +69,12 @@ module Zernio
         :'summary' => :'CampaignAnalyticsResponseAnalyticsSummary',
         :'impression_share_cache' => :'CampaignAnalyticsResponseAnalyticsImpressionShareCache',
         :'daily' => :'Array<CampaignAnalyticsResponseAnalyticsDailyInner>',
-        :'breakdowns' => :'Hash<String, Array<Object>>'
+        :'breakdowns' => :'Hash<String, Array<Object>>',
+        :'unsupported_breakdowns' => :'Array<String>',
+        :'breakdown_hints' => :'Hash<String, String>',
+        :'breakdown_errors' => :'Array<CampaignAnalyticsResponseAnalyticsBreakdownErrorsInner>',
+        :'breakdown_dropped_metrics' => :'Hash<String, Array<String>>',
+        :'breakdowns_range' => :'CampaignAnalyticsResponseAnalyticsBreakdownsRange'
       }
     end
 
@@ -95,6 +119,34 @@ module Zernio
           self.breakdowns = value
         end
       end
+
+      if attributes.key?(:'unsupported_breakdowns')
+        if (value = attributes[:'unsupported_breakdowns']).is_a?(Array)
+          self.unsupported_breakdowns = value
+        end
+      end
+
+      if attributes.key?(:'breakdown_hints')
+        if (value = attributes[:'breakdown_hints']).is_a?(Hash)
+          self.breakdown_hints = value
+        end
+      end
+
+      if attributes.key?(:'breakdown_errors')
+        if (value = attributes[:'breakdown_errors']).is_a?(Array)
+          self.breakdown_errors = value
+        end
+      end
+
+      if attributes.key?(:'breakdown_dropped_metrics')
+        if (value = attributes[:'breakdown_dropped_metrics']).is_a?(Hash)
+          self.breakdown_dropped_metrics = value
+        end
+      end
+
+      if attributes.key?(:'breakdowns_range')
+        self.breakdowns_range = attributes[:'breakdowns_range']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -120,7 +172,12 @@ module Zernio
           summary == o.summary &&
           impression_share_cache == o.impression_share_cache &&
           daily == o.daily &&
-          breakdowns == o.breakdowns
+          breakdowns == o.breakdowns &&
+          unsupported_breakdowns == o.unsupported_breakdowns &&
+          breakdown_hints == o.breakdown_hints &&
+          breakdown_errors == o.breakdown_errors &&
+          breakdown_dropped_metrics == o.breakdown_dropped_metrics &&
+          breakdowns_range == o.breakdowns_range
     end
 
     # @see the `==` method
@@ -132,7 +189,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [summary, impression_share_cache, daily, breakdowns].hash
+      [summary, impression_share_cache, daily, breakdowns, unsupported_breakdowns, breakdown_hints, breakdown_errors, breakdown_dropped_metrics, breakdowns_range].hash
     end
 
     # Builds the object from hash