late-sdk 0.0.853 → 0.0.855

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 05ae9f355f4dd47957afe2f4f8e1403fba96297e7c02031236ebd830ace68a6a
-  data.tar.gz: 62f0a3861bdb2fe95f82faca7e164f2775ae71035fa3d2459dcac0b495c13cef
+  metadata.gz: 1ab1864cbcad536ce6cf08e16d3ecaeb86ceacdee6c4cfbd30aa3261563f81fa
+  data.tar.gz: e5fbd5ef7c080df833cc544848741742a42a4597a4860578eb7a5eed9bcac3db
 SHA512:
-  metadata.gz: 263e5a939465443af1b8400a47e78d1ff5afb62abeed6cc5356de1d417128aa3a7aa000a012f79c7ee6166d5accb970108033a0f6997928a3eff3ecf32c412e2
-  data.tar.gz: e09470ba96c3f930f1bc294fcb9eff5b0da1ef18b630f5bb51b79320910efa2054e529495235aa10df26bc1340da65132803e5400bc8f5b054b8ad95780e6f26
+  metadata.gz: 2214e8ba6fd2266d69de612848e72086c2fa64cf2615c3ccae521255e92437fb1eca1f49cfcaa72fb39d3da53b611227b0cc74808754528cae2ca8c28d0f970d
+  data.tar.gz: 8e82cd61afe4a6cdcda8dcec3ba25426046ef011467593e010012c72b40fdbbba57a5d8a3176e86707d0e44892cc5cdc19c133331c6b9421ea92d3a1a25c41c3

data/README.md

@@ -182,6 +182,7 @@ Class | Method | HTTP request | Description
 *Zernio::AdInsightsApi* | [**list_local_services_lead_conversations**](docs/AdInsightsApi.md#list_local_services_lead_conversations) | **GET** /v1/ads/local-services/leads/{leadId}/conversations | Conversations of a Local Services lead
 *Zernio::AdInsightsApi* | [**list_local_services_leads**](docs/AdInsightsApi.md#list_local_services_leads) | **GET** /v1/ads/local-services/leads | Google Local Services Ads leads
 *Zernio::AdInsightsApi* | [**query_ad_insights**](docs/AdInsightsApi.md#query_ad_insights) | **GET** /v1/ads/insights | Flexible live insights query
+*Zernio::AdLibraryApi* | [**search_ad_library**](docs/AdLibraryApi.md#search_ad_library) | **GET** /v1/ads/library | Search the public Ad Library
 *Zernio::AdTargetingApi* | [**estimate_ad_reach**](docs/AdTargetingApi.md#estimate_ad_reach) | **POST** /v1/ads/targeting/reach-estimate | Estimate audience reach
 *Zernio::AdTargetingApi* | [**get_linked_in_bid_pricing**](docs/AdTargetingApi.md#get_linked_in_bid_pricing) | **POST** /v1/ads/targeting/bid-pricing | Suggested bid and budget bounds
 *Zernio::AdTargetingApi* | [**get_linked_in_supply_forecast**](docs/AdTargetingApi.md#get_linked_in_supply_forecast) | **POST** /v1/ads/targeting/supply-forecast | Impressions, clicks and spend forecast
@@ -1904,6 +1905,8 @@ Class | Method | HTTP request | Description
  - [Zernio::ScheduleBroadcastRequest](docs/ScheduleBroadcastRequest.md)
  - [Zernio::SearchAdInterests200Response](docs/SearchAdInterests200Response.md)
  - [Zernio::SearchAdInterests200ResponseInterestsInner](docs/SearchAdInterests200ResponseInterestsInner.md)
+ - [Zernio::SearchAdLibrary200Response](docs/SearchAdLibrary200Response.md)
+ - [Zernio::SearchAdLibrary200ResponsePaging](docs/SearchAdLibrary200ResponsePaging.md)
  - [Zernio::SearchAdTargeting200Response](docs/SearchAdTargeting200Response.md)
  - [Zernio::SearchAdTargeting200ResponseResultsInner](docs/SearchAdTargeting200ResponseResultsInner.md)
  - [Zernio::SearchAvailablePhoneNumbers200Response](docs/SearchAvailablePhoneNumbers200Response.md)

data/docs/AdCampaignsApi.md

@@ -1076,7 +1076,7 @@ end
 
 Get daily account metrics
 
-Returns daily aggregate metrics across all ads in a SocialAccount as a single time series — one row per calendar day in the requested range. Use this for dashboards that draw a daily-spend or daily-conversions chart, instead of calling `/v1/ads/tree` once per day.  `accountId` is required. The lookup is sibling-expanded so passing the `metaads` ID also includes ads under the linked `facebook` / `instagram` posting account (and vice-versa) — same convention as `/v1/ads/tree` and `/v1/ads`.  Date range defaults to the last 90 days. Capped at 730 days. Ranges older than the ingested history return a `202` immediately with the covered part and `backfillPending: true` while the rest is backfilled in the background; repeat the request shortly until it returns 200 with full data. 
+Returns daily aggregate metrics across all ads in a SocialAccount as a single time series — one row per calendar day in the requested range. Use this for dashboards that draw a daily-spend or daily-conversions chart, instead of calling `/v1/ads/tree` once per day.  `accountId` is required. The lookup is sibling-expanded so passing the `metaads` ID also includes ads under the linked `facebook` / `instagram` posting account (and vice-versa) — same convention as `/v1/ads/tree` and `/v1/ads`.  Date range defaults to the last 90 days. Capped at 730 days. Ranges older than the ingested history return a `202` immediately with the covered part and `backfillPending: true` while the rest is backfilled in the background; repeat the request shortly until it returns 200 with full data.  With adAccountId set to a Google customer id this is the customer-level performance report (clicks, cost, impressions, conversions, all conversions per day). 
 
 ### Examples
 

data/docs/AdDailyMetrics.md

@@ -13,6 +13,7 @@
 | **cpm** | **Float** | Cost per 1000 impressions | [optional] |
 | **engagement** | **Integer** |  | [optional] |
 | **conversions** | **Float** | Count of conversion events over the requested date range. FRACTIONAL: attribution splits one conversion across touchpoints and Google additionally reports modeled conversions, so values like 0.347 are normal. Meta: events matching the campaign's promoted_object.custom_event_type (PURCHASE, LEAD, etc.). Google: the account's tracked conversions. X and LinkedIn: their reported website/lead conversions (added 2026-07). 0 for non-conversion campaigns or when no events have fired. | [optional] |
+| **all_conversions** | **Float** | All conversions, including actions excluded from the Conversions column (Google metrics.all_conversions). 0 on platforms without the concept. | [optional] |
 | **cost_per_conversion** | **Float** | Derived spend / conversions in the same currency as spend. 0 when conversions is 0. | [optional] |
 | **actions** | **Hash<String, Integer>** | Per-action-type counts summed over the date range, keyed by the platform's action-type names. Meta: raw Insights action_type keys (link_click, offsite_conversion.fb_pixel_purchase, onsite_conversion.lead_grouped, ...) — both engagement and conversion events. TikTok: pixel conversions (purchase, add_to_cart, initiate_checkout, view_content, complete_payment, lead) plus the paid-engagement family (follow, post_reaction for paid likes, comment, share) — follow is how FOLLOWERS-goal campaigns report their result. X: conversion types (purchase, sign_up, site_visit, download, custom). LinkedIn: conversion types (post_click, post_view, lead_gen). Google returns {} (its per-action names aren't synced per ad). Empty object when no actions are reported. NOTE: keys differ by platform, so branch on the ad's platform when interpreting them. | [optional] |
 | **action_values** | **Hash<String, Float>** | Monetary mirror of `actions`, from Meta's Insights `action_values[]` array. Same keying — values are the revenue attributed to each action_type, in ad-account native currency (same unit as `spend`; see the campaign node's `currency` field). Use this to compute revenue-per-event (e.g. avg purchase value). Meta-only; other platforms return {}. | [optional] |
@@ -55,6 +56,7 @@ instance = Zernio::AdDailyMetrics.new(
   cpm: null,
   engagement: null,
   conversions: null,
+  all_conversions: null,
   cost_per_conversion: null,
   actions: {link_click=160, post_engagement=300, offsite_conversion.fb_pixel_purchase=42},
   action_values: {offsite_conversion.fb_pixel_purchase=2456.78, offsite_conversion.fb_pixel_add_to_cart=980.5},

data/docs/AdLibraryApi.md

@@ -0,0 +1,109 @@
+# Zernio::AdLibraryApi
+
+All URIs are relative to *https://zernio.com/api*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**search_ad_library**](AdLibraryApi.md#search_ad_library) | **GET** /v1/ads/library | Search the public Ad Library |
+
+
+## search_ad_library
+
+> <SearchAdLibrary200Response> search_ad_library(account_id, opts)
+
+Search the public Ad Library
+
+Competitor and market research over the platform's public ad archive, searched with the customer's own connected token (no extra scope): Meta's Ad Library (`GET /ads_archive`) for a `facebook` / `instagram` / `metaads` account, LinkedIn's Ad Library (`GET /rest/adLibrary`) for a `linkedin` / `linkedinads` account. Rows are returned in the platform's raw shape under `data`; `paging.after` is an opaque cursor on both (`null` when exhausted).  **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is in the archive only if it was delivered to the EU or UK within the last year, so a US-only commercial advertiser is invisible. Spend, impressions and demographics are political-only fields and are left out of the default projection; request them via `fields`. Meta serves the archive only to people who confirmed their identity and location at facebook.com/ID: until the Facebook user behind the connection has done so, the call fails with `meta_identity_confirmation_required` (403).  **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets. Pages are capped at 25 ads (`limit` > 25 is a 400); `after` is the next offset.  Which params apply: `q`, `countries`, `since`, `until`, `limit`, `after` on both; `pageIds`, `adType`, `status`, `platforms`, `mediaType`, `languages`, `searchType`, `fields` are Meta-only; `advertiser` is LinkedIn-only. Passing a param the account's platform does not support is a 400 naming the param.
+
+### Examples
+
+```ruby
+require 'time'
+require 'zernio-sdk'
+# setup authorization
+Zernio.configure do |config|
+  # Configure Bearer authorization (JWT): bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Zernio::AdLibraryApi.new
+account_id = 'account_id_example' # String | Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches.
+opts = {
+  q: 'q_example', # String | Keyword search. Meta does not translate it, so write it in the ads' language. Required unless pageIds (Meta) or advertiser (LinkedIn) is given.
+  page_ids: 'page_ids_example', # String | Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list.
+  advertiser: 'advertiser_example', # String | LinkedIn only. Advertiser (Page) name to search.
+  countries: 'countries_example', # String | Comma-separated ISO 3166-1 alpha-2 codes the ads reached. Meta defaults to ALL (an explicit ALL is Meta-only); LinkedIn searches every market when omitted.
+  ad_type: 'ALL', # String | Meta only.
+  status: 'ACTIVE', # String | Meta only. ACTIVE = eligible for delivery right now.
+  platforms: 'platforms_example', # String | Meta only. Comma-separated publisher platforms: FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, WHATSAPP, OCULUS, THREADS, STREAMING_SERVICES.
+  media_type: 'ALL', # String | Meta only.
+  languages: 'languages_example', # String | Meta only. Comma-separated ISO 639-1 codes of the ad text.
+  since: Date.parse('2013-10-20'), # Date | Earliest delivery date (YYYY-MM-DD).
+  _until: Date.parse('2013-10-20'), # Date | Latest delivery date (YYYY-MM-DD).
+  search_type: 'KEYWORD_UNORDERED', # String | Meta only. Whether q matches words in any order or as an exact phrase (comma-separate phrases to match all of them).
+  fields: 'fields_example', # String | Meta only. Raw Graph projection override, e.g. add spend,impressions,demographic_distribution for political ads.
+  limit: 56, # Integer | Rows per page. LinkedIn accepts at most 25.
+  after: 'after_example' # String | paging.after of the previous page.
+}
+
+begin
+  # Search the public Ad Library
+  result = api_instance.search_ad_library(account_id, opts)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling AdLibraryApi->search_ad_library: #{e}"
+end
+```
+
+#### Using the search_ad_library_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SearchAdLibrary200Response>, Integer, Hash)> search_ad_library_with_http_info(account_id, opts)
+
+```ruby
+begin
+  # Search the public Ad Library
+  data, status_code, headers = api_instance.search_ad_library_with_http_info(account_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SearchAdLibrary200Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling AdLibraryApi->search_ad_library_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches. |  |
+| **q** | **String** | Keyword search. Meta does not translate it, so write it in the ads&#39; language. Required unless pageIds (Meta) or advertiser (LinkedIn) is given. | [optional] |
+| **page_ids** | **String** | Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list. | [optional] |
+| **advertiser** | **String** | LinkedIn only. Advertiser (Page) name to search. | [optional] |
+| **countries** | **String** | Comma-separated ISO 3166-1 alpha-2 codes the ads reached. Meta defaults to ALL (an explicit ALL is Meta-only); LinkedIn searches every market when omitted. | [optional] |
+| **ad_type** | **String** | Meta only. | [optional][default to &#39;ALL&#39;] |
+| **status** | **String** | Meta only. ACTIVE &#x3D; eligible for delivery right now. | [optional][default to &#39;ACTIVE&#39;] |
+| **platforms** | **String** | Meta only. Comma-separated publisher platforms: FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, WHATSAPP, OCULUS, THREADS, STREAMING_SERVICES. | [optional] |
+| **media_type** | **String** | Meta only. | [optional] |
+| **languages** | **String** | Meta only. Comma-separated ISO 639-1 codes of the ad text. | [optional] |
+| **since** | **Date** | Earliest delivery date (YYYY-MM-DD). | [optional] |
+| **_until** | **Date** | Latest delivery date (YYYY-MM-DD). | [optional] |
+| **search_type** | **String** | Meta only. Whether q matches words in any order or as an exact phrase (comma-separate phrases to match all of them). | [optional][default to &#39;KEYWORD_UNORDERED&#39;] |
+| **fields** | **String** | Meta only. Raw Graph projection override, e.g. add spend,impressions,demographic_distribution for political ads. | [optional] |
+| **limit** | **Integer** | Rows per page. LinkedIn accepts at most 25. | [optional][default to 25] |
+| **after** | **String** | paging.after of the previous page. | [optional] |
+
+### Return type
+
+[**SearchAdLibrary200Response**](SearchAdLibrary200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+

data/docs/AdMetrics.md

@@ -13,6 +13,7 @@
 | **cpm** | **Float** | Cost per 1000 impressions | [optional] |
 | **engagement** | **Integer** |  | [optional] |
 | **conversions** | **Float** | Count of conversion events over the requested date range. FRACTIONAL: attribution splits one conversion across touchpoints and Google additionally reports modeled conversions, so values like 0.347 are normal. Meta: events matching the campaign's promoted_object.custom_event_type (PURCHASE, LEAD, etc.). Google: the account's tracked conversions. X and LinkedIn: their reported website/lead conversions (added 2026-07). 0 for non-conversion campaigns or when no events have fired. | [optional] |
+| **all_conversions** | **Float** | All conversions, including actions excluded from the Conversions column (Google metrics.all_conversions). 0 on platforms without the concept. | [optional] |
 | **cost_per_conversion** | **Float** | Derived spend / conversions in the same currency as spend. 0 when conversions is 0. | [optional] |
 | **actions** | **Hash<String, Integer>** | Per-action-type counts summed over the date range, keyed by the platform's action-type names. Meta: raw Insights action_type keys (link_click, offsite_conversion.fb_pixel_purchase, onsite_conversion.lead_grouped, ...) — both engagement and conversion events. TikTok: pixel conversions (purchase, add_to_cart, initiate_checkout, view_content, complete_payment, lead) plus the paid-engagement family (follow, post_reaction for paid likes, comment, share) — follow is how FOLLOWERS-goal campaigns report their result. X: conversion types (purchase, sign_up, site_visit, download, custom). LinkedIn: conversion types (post_click, post_view, lead_gen). Google returns {} (its per-action names aren't synced per ad). Empty object when no actions are reported. NOTE: keys differ by platform, so branch on the ad's platform when interpreting them. | [optional] |
 | **action_values** | **Hash<String, Float>** | Monetary mirror of `actions`, from Meta's Insights `action_values[]` array. Same keying — values are the revenue attributed to each action_type, in ad-account native currency (same unit as `spend`; see the campaign node's `currency` field). Use this to compute revenue-per-event (e.g. avg purchase value). Meta-only; other platforms return {}. | [optional] |
@@ -54,6 +55,7 @@ instance = Zernio::AdMetrics.new(
   cpm: null,
   engagement: null,
   conversions: null,
+  all_conversions: null,
   cost_per_conversion: null,
   actions: {link_click=160, post_engagement=300, offsite_conversion.fb_pixel_purchase=42},
   action_values: {offsite_conversion.fb_pixel_purchase=2456.78, offsite_conversion.fb_pixel_add_to_cart=980.5},

data/docs/AdsTimelineResponseRowsInner.md

@@ -14,6 +14,7 @@
 | **cpc** | **Float** | Cost per click in native currency. | [optional] |
 | **cpm** | **Float** | Cost per 1000 impressions in native currency. | [optional] |
 | **conversions** | **Float** | Sum of conversion events over the range. Fractional values are normal (attribution splitting + Google modeled conversions). Meta: events matching the campaign optimization goal. Google: tracked conversions. X / LinkedIn: reported website/lead conversions (added 2026-07). | [optional] |
+| **all_conversions** | **Float** | All conversions, including actions excluded from the Conversions column (Google metrics.all_conversions). 0 on platforms without the concept. | [optional] |
 | **cost_per_conversion** | **Float** |  | [optional] |
 | **actions** | **Hash<String, Float>** | Per-action-type counts merged across all ads on this day. Keys are platform-native action types. | [optional] |
 | **action_values** | **Hash<String, Float>** | Monetary mirror of `actions` in native currency. | [optional] |
@@ -36,6 +37,7 @@ instance = Zernio::AdsTimelineResponseRowsInner.new(
   cpc: null,
   cpm: null,
   conversions: null,
+  all_conversions: null,
   cost_per_conversion: null,
   actions: null,
   action_values: null,

data/docs/CampaignAnalyticsResponseAnalyticsDailyInner.md

@@ -13,6 +13,7 @@
 | **cpm** | **Float** | Cost per 1000 impressions | [optional] |
 | **engagement** | **Integer** |  | [optional] |
 | **conversions** | **Float** | Count of conversion events over the requested date range. FRACTIONAL: attribution splits one conversion across touchpoints and Google additionally reports modeled conversions, so values like 0.347 are normal. Meta: events matching the campaign's promoted_object.custom_event_type (PURCHASE, LEAD, etc.). Google: the account's tracked conversions. X and LinkedIn: their reported website/lead conversions (added 2026-07). 0 for non-conversion campaigns or when no events have fired. | [optional] |
+| **all_conversions** | **Float** | All conversions, including actions excluded from the Conversions column (Google metrics.all_conversions). 0 on platforms without the concept. | [optional] |
 | **cost_per_conversion** | **Float** | Derived spend / conversions in the same currency as spend. 0 when conversions is 0. | [optional] |
 | **actions** | **Hash<String, Integer>** | Per-action-type counts summed over the date range, keyed by the platform's action-type names. Meta: raw Insights action_type keys (link_click, offsite_conversion.fb_pixel_purchase, onsite_conversion.lead_grouped, ...) — both engagement and conversion events. TikTok: pixel conversions (purchase, add_to_cart, initiate_checkout, view_content, complete_payment, lead) plus the paid-engagement family (follow, post_reaction for paid likes, comment, share) — follow is how FOLLOWERS-goal campaigns report their result. X: conversion types (purchase, sign_up, site_visit, download, custom). LinkedIn: conversion types (post_click, post_view, lead_gen). Google returns {} (its per-action names aren't synced per ad). Empty object when no actions are reported. NOTE: keys differ by platform, so branch on the ad's platform when interpreting them. | [optional] |
 | **action_values** | **Hash<String, Float>** | Monetary mirror of `actions`, from Meta's Insights `action_values[]` array. Same keying — values are the revenue attributed to each action_type, in ad-account native currency (same unit as `spend`; see the campaign node's `currency` field). Use this to compute revenue-per-event (e.g. avg purchase value). Meta-only; other platforms return {}. | [optional] |
@@ -55,6 +56,7 @@ instance = Zernio::CampaignAnalyticsResponseAnalyticsDailyInner.new(
   cpm: null,
   engagement: null,
   conversions: null,
+  all_conversions: null,
   cost_per_conversion: null,
   actions: {link_click=160, post_engagement=300, offsite_conversion.fb_pixel_purchase=42},
   action_values: {offsite_conversion.fb_pixel_purchase=2456.78, offsite_conversion.fb_pixel_add_to_cart=980.5},

data/docs/SearchAdLibrary200Response.md

@@ -0,0 +1,22 @@
+# Zernio::SearchAdLibrary200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **platform** | **String** |  |  |
+| **data** | **Array<Object>** |  |  |
+| **paging** | [**SearchAdLibrary200ResponsePaging**](SearchAdLibrary200ResponsePaging.md) |  |  |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::SearchAdLibrary200Response.new(
+  platform: null,
+  data: null,
+  paging: null
+)
+```
+

data/docs/SearchAdLibrary200ResponsePaging.md

@@ -0,0 +1,20 @@
+# Zernio::SearchAdLibrary200ResponsePaging
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **after** | **String** | Cursor for the next page; null when exhausted. | [optional] |
+| **total** | **Integer** | LinkedIn only. Total matching ads. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::SearchAdLibrary200ResponsePaging.new(
+  after: null,
+  total: null
+)
+```
+

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

@@ -1106,7 +1106,7 @@ module Zernio
     end
 
     # Get daily account metrics
-    # Returns daily aggregate metrics across all ads in a SocialAccount as a single time series — one row per calendar day in the requested range. Use this for dashboards that draw a daily-spend or daily-conversions chart, instead of calling `/v1/ads/tree` once per day.  `accountId` is required. The lookup is sibling-expanded so passing the `metaads` ID also includes ads under the linked `facebook` / `instagram` posting account (and vice-versa) — same convention as `/v1/ads/tree` and `/v1/ads`.  Date range defaults to the last 90 days. Capped at 730 days. Ranges older than the ingested history return a `202` immediately with the covered part and `backfillPending: true` while the rest is backfilled in the background; repeat the request shortly until it returns 200 with full data. 
+    # Returns daily aggregate metrics across all ads in a SocialAccount as a single time series — one row per calendar day in the requested range. Use this for dashboards that draw a daily-spend or daily-conversions chart, instead of calling `/v1/ads/tree` once per day.  `accountId` is required. The lookup is sibling-expanded so passing the `metaads` ID also includes ads under the linked `facebook` / `instagram` posting account (and vice-versa) — same convention as `/v1/ads/tree` and `/v1/ads`.  Date range defaults to the last 90 days. Capped at 730 days. Ranges older than the ingested history return a `202` immediately with the covered part and `backfillPending: true` while the rest is backfilled in the background; repeat the request shortly until it returns 200 with full data.  With adAccountId set to a Google customer id this is the customer-level performance report (clicks, cost, impressions, conversions, all conversions per day). 
     # @param account_id [String] Social account ID. Sibling-expanded to its linked posting↔ads pair.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :ad_account_id Optional platform-native ad account ID (e.g. Meta `act_…`, TikTok advertiser ID). Use when the connection wraps multiple platform ad accounts and the chart should show one only. Note: rows ingested before 2026-05-13 don't carry this column; the recurring 7-day re-sync repopulates them naturally.
@@ -1120,7 +1120,7 @@ module Zernio
     end
 
     # Get daily account metrics
-    # Returns daily aggregate metrics across all ads in a SocialAccount as a single time series — one row per calendar day in the requested range. Use this for dashboards that draw a daily-spend or daily-conversions chart, instead of calling `/v1/ads/tree` once per day.  `accountId` is required. The lookup is sibling-expanded so passing the `metaads` ID also includes ads under the linked `facebook` / `instagram` posting account (and vice-versa) — same convention as `/v1/ads/tree` and `/v1/ads`.  Date range defaults to the last 90 days. Capped at 730 days. Ranges older than the ingested history return a `202` immediately with the covered part and `backfillPending: true` while the rest is backfilled in the background; repeat the request shortly until it returns 200 with full data. 
+    # Returns daily aggregate metrics across all ads in a SocialAccount as a single time series — one row per calendar day in the requested range. Use this for dashboards that draw a daily-spend or daily-conversions chart, instead of calling `/v1/ads/tree` once per day.  `accountId` is required. The lookup is sibling-expanded so passing the `metaads` ID also includes ads under the linked `facebook` / `instagram` posting account (and vice-versa) — same convention as `/v1/ads/tree` and `/v1/ads`.  Date range defaults to the last 90 days. Capped at 730 days. Ranges older than the ingested history return a `202` immediately with the covered part and `backfillPending: true` while the rest is backfilled in the background; repeat the request shortly until it returns 200 with full data.  With adAccountId set to a Google customer id this is the customer-level performance report (clicks, cost, impressions, conversions, all conversions per day). 
     # @param account_id [String] Social account ID. Sibling-expanded to its linked posting↔ads pair.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :ad_account_id Optional platform-native ad account ID (e.g. Meta `act_…`, TikTok advertiser ID). Use when the connection wraps multiple platform ad accounts and the chart should show one only. Note: rows ingested before 2026-05-13 don't carry this column; the recurring 7-day re-sync repopulates them naturally.

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

@@ -0,0 +1,163 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+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 'cgi'
+
+module Zernio
+  class AdLibraryApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Search the public Ad Library
+    # Competitor and market research over the platform's public ad archive, searched with the customer's own connected token (no extra scope): Meta's Ad Library (`GET /ads_archive`) for a `facebook` / `instagram` / `metaads` account, LinkedIn's Ad Library (`GET /rest/adLibrary`) for a `linkedin` / `linkedinads` account. Rows are returned in the platform's raw shape under `data`; `paging.after` is an opaque cursor on both (`null` when exhausted).  **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is in the archive only if it was delivered to the EU or UK within the last year, so a US-only commercial advertiser is invisible. Spend, impressions and demographics are political-only fields and are left out of the default projection; request them via `fields`. Meta serves the archive only to people who confirmed their identity and location at facebook.com/ID: until the Facebook user behind the connection has done so, the call fails with `meta_identity_confirmation_required` (403).  **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets. Pages are capped at 25 ads (`limit` > 25 is a 400); `after` is the next offset.  Which params apply: `q`, `countries`, `since`, `until`, `limit`, `after` on both; `pageIds`, `adType`, `status`, `platforms`, `mediaType`, `languages`, `searchType`, `fields` are Meta-only; `advertiser` is LinkedIn-only. Passing a param the account's platform does not support is a 400 naming the param.
+    # @param account_id [String] Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :q Keyword search. Meta does not translate it, so write it in the ads' language. Required unless pageIds (Meta) or advertiser (LinkedIn) is given.
+    # @option opts [String] :page_ids Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list.
+    # @option opts [String] :advertiser LinkedIn only. Advertiser (Page) name to search.
+    # @option opts [String] :countries Comma-separated ISO 3166-1 alpha-2 codes the ads reached. Meta defaults to ALL (an explicit ALL is Meta-only); LinkedIn searches every market when omitted.
+    # @option opts [String] :ad_type Meta only. (default to 'ALL')
+    # @option opts [String] :status Meta only. ACTIVE = eligible for delivery right now. (default to 'ACTIVE')
+    # @option opts [String] :platforms Meta only. Comma-separated publisher platforms: FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, WHATSAPP, OCULUS, THREADS, STREAMING_SERVICES.
+    # @option opts [String] :media_type Meta only.
+    # @option opts [String] :languages Meta only. Comma-separated ISO 639-1 codes of the ad text.
+    # @option opts [Date] :since Earliest delivery date (YYYY-MM-DD).
+    # @option opts [Date] :_until Latest delivery date (YYYY-MM-DD).
+    # @option opts [String] :search_type Meta only. Whether q matches words in any order or as an exact phrase (comma-separate phrases to match all of them). (default to 'KEYWORD_UNORDERED')
+    # @option opts [String] :fields Meta only. Raw Graph projection override, e.g. add spend,impressions,demographic_distribution for political ads.
+    # @option opts [Integer] :limit Rows per page. LinkedIn accepts at most 25. (default to 25)
+    # @option opts [String] :after paging.after of the previous page.
+    # @return [SearchAdLibrary200Response]
+    def search_ad_library(account_id, opts = {})
+      data, _status_code, _headers = search_ad_library_with_http_info(account_id, opts)
+      data
+    end
+
+    # Search the public Ad Library
+    # Competitor and market research over the platform's public ad archive, searched with the customer's own connected token (no extra scope): Meta's Ad Library (`GET /ads_archive`) for a `facebook` / `instagram` / `metaads` account, LinkedIn's Ad Library (`GET /rest/adLibrary`) for a `linkedin` / `linkedinads` account. Rows are returned in the platform's raw shape under `data`; `paging.after` is an opaque cursor on both (`null` when exhausted).  **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is in the archive only if it was delivered to the EU or UK within the last year, so a US-only commercial advertiser is invisible. Spend, impressions and demographics are political-only fields and are left out of the default projection; request them via `fields`. Meta serves the archive only to people who confirmed their identity and location at facebook.com/ID: until the Facebook user behind the connection has done so, the call fails with `meta_identity_confirmation_required` (403).  **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets. Pages are capped at 25 ads (`limit` > 25 is a 400); `after` is the next offset.  Which params apply: `q`, `countries`, `since`, `until`, `limit`, `after` on both; `pageIds`, `adType`, `status`, `platforms`, `mediaType`, `languages`, `searchType`, `fields` are Meta-only; `advertiser` is LinkedIn-only. Passing a param the account's platform does not support is a 400 naming the param.
+    # @param account_id [String] Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :q Keyword search. Meta does not translate it, so write it in the ads' language. Required unless pageIds (Meta) or advertiser (LinkedIn) is given.
+    # @option opts [String] :page_ids Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list.
+    # @option opts [String] :advertiser LinkedIn only. Advertiser (Page) name to search.
+    # @option opts [String] :countries Comma-separated ISO 3166-1 alpha-2 codes the ads reached. Meta defaults to ALL (an explicit ALL is Meta-only); LinkedIn searches every market when omitted.
+    # @option opts [String] :ad_type Meta only. (default to 'ALL')
+    # @option opts [String] :status Meta only. ACTIVE = eligible for delivery right now. (default to 'ACTIVE')
+    # @option opts [String] :platforms Meta only. Comma-separated publisher platforms: FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, WHATSAPP, OCULUS, THREADS, STREAMING_SERVICES.
+    # @option opts [String] :media_type Meta only.
+    # @option opts [String] :languages Meta only. Comma-separated ISO 639-1 codes of the ad text.
+    # @option opts [Date] :since Earliest delivery date (YYYY-MM-DD).
+    # @option opts [Date] :_until Latest delivery date (YYYY-MM-DD).
+    # @option opts [String] :search_type Meta only. Whether q matches words in any order or as an exact phrase (comma-separate phrases to match all of them). (default to 'KEYWORD_UNORDERED')
+    # @option opts [String] :fields Meta only. Raw Graph projection override, e.g. add spend,impressions,demographic_distribution for political ads.
+    # @option opts [Integer] :limit Rows per page. LinkedIn accepts at most 25. (default to 25)
+    # @option opts [String] :after paging.after of the previous page.
+    # @return [Array<(SearchAdLibrary200Response, Integer, Hash)>] SearchAdLibrary200Response data, response status code and response headers
+    def search_ad_library_with_http_info(account_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdLibraryApi.search_ad_library ...'
+      end
+      # verify the required parameter 'account_id' is set
+      if @api_client.config.client_side_validation && account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'account_id' when calling AdLibraryApi.search_ad_library"
+      end
+      if @api_client.config.client_side_validation && !opts[:'q'].nil? && opts[:'q'].to_s.length > 100
+        fail ArgumentError, 'invalid value for "opts[:"q"]" when calling AdLibraryApi.search_ad_library, the character length must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'advertiser'].nil? && opts[:'advertiser'].to_s.length > 100
+        fail ArgumentError, 'invalid value for "opts[:"advertiser"]" when calling AdLibraryApi.search_ad_library, the character length must be smaller than or equal to 100.'
+      end
+
+      allowable_values = ["ALL", "POLITICAL_AND_ISSUE_ADS", "HOUSING_ADS", "EMPLOYMENT_ADS", "FINANCIAL_PRODUCTS_AND_SERVICES_ADS"]
+      if @api_client.config.client_side_validation && opts[:'ad_type'] && !allowable_values.include?(opts[:'ad_type'])
+        fail ArgumentError, "invalid value for \"ad_type\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["ACTIVE", "INACTIVE", "ALL"]
+      if @api_client.config.client_side_validation && opts[:'status'] && !allowable_values.include?(opts[:'status'])
+        fail ArgumentError, "invalid value for \"status\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["ALL", "IMAGE", "MEME", "VIDEO", "NONE"]
+      if @api_client.config.client_side_validation && opts[:'media_type'] && !allowable_values.include?(opts[:'media_type'])
+        fail ArgumentError, "invalid value for \"media_type\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["KEYWORD_UNORDERED", "KEYWORD_EXACT_PHRASE"]
+      if @api_client.config.client_side_validation && opts[:'search_type'] && !allowable_values.include?(opts[:'search_type'])
+        fail ArgumentError, "invalid value for \"search_type\", must be one of #{allowable_values}"
+      end
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling AdLibraryApi.search_ad_library, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling AdLibraryApi.search_ad_library, must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/v1/ads/library'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'accountId'] = account_id
+      query_params[:'q'] = opts[:'q'] if !opts[:'q'].nil?
+      query_params[:'pageIds'] = opts[:'page_ids'] if !opts[:'page_ids'].nil?
+      query_params[:'advertiser'] = opts[:'advertiser'] if !opts[:'advertiser'].nil?
+      query_params[:'countries'] = opts[:'countries'] if !opts[:'countries'].nil?
+      query_params[:'adType'] = opts[:'ad_type'] if !opts[:'ad_type'].nil?
+      query_params[:'status'] = opts[:'status'] if !opts[:'status'].nil?
+      query_params[:'platforms'] = opts[:'platforms'] if !opts[:'platforms'].nil?
+      query_params[:'mediaType'] = opts[:'media_type'] if !opts[:'media_type'].nil?
+      query_params[:'languages'] = opts[:'languages'] if !opts[:'languages'].nil?
+      query_params[:'since'] = opts[:'since'] if !opts[:'since'].nil?
+      query_params[:'until'] = opts[:'_until'] if !opts[:'_until'].nil?
+      query_params[:'searchType'] = opts[:'search_type'] if !opts[:'search_type'].nil?
+      query_params[:'fields'] = opts[:'fields'] if !opts[:'fields'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'after'] = opts[:'after'] if !opts[:'after'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SearchAdLibrary200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"AdLibraryApi.search_ad_library",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AdLibraryApi#search_ad_library\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

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

@@ -39,6 +39,9 @@ module Zernio
     # Count of conversion events over the requested date range. FRACTIONAL: attribution splits one conversion across touchpoints and Google additionally reports modeled conversions, so values like 0.347 are normal. Meta: events matching the campaign's promoted_object.custom_event_type (PURCHASE, LEAD, etc.). Google: the account's tracked conversions. X and LinkedIn: their reported website/lead conversions (added 2026-07). 0 for non-conversion campaigns or when no events have fired.
     attr_accessor :conversions
 
+    # All conversions, including actions excluded from the Conversions column (Google metrics.all_conversions). 0 on platforms without the concept.
+    attr_accessor :all_conversions
+
     # Derived spend / conversions in the same currency as spend. 0 when conversions is 0.
     attr_accessor :cost_per_conversion
 
@@ -127,6 +130,7 @@ module Zernio
         :'cpm' => :'cpm',
         :'engagement' => :'engagement',
         :'conversions' => :'conversions',
+        :'all_conversions' => :'allConversions',
         :'cost_per_conversion' => :'costPerConversion',
         :'actions' => :'actions',
         :'action_values' => :'actionValues',
@@ -178,6 +182,7 @@ module Zernio
         :'cpm' => :'Float',
         :'engagement' => :'Integer',
         :'conversions' => :'Float',
+        :'all_conversions' => :'Float',
         :'cost_per_conversion' => :'Float',
         :'actions' => :'Hash<String, Integer>',
         :'action_values' => :'Hash<String, Float>',
@@ -272,6 +277,10 @@ module Zernio
         self.conversions = attributes[:'conversions']
       end
 
+      if attributes.key?(:'all_conversions')
+        self.all_conversions = attributes[:'all_conversions']
+      end
+
       if attributes.key?(:'cost_per_conversion')
         self.cost_per_conversion = attributes[:'cost_per_conversion']
       end
@@ -412,6 +421,7 @@ module Zernio
           cpm == o.cpm &&
           engagement == o.engagement &&
           conversions == o.conversions &&
+          all_conversions == o.all_conversions &&
           cost_per_conversion == o.cost_per_conversion &&
           actions == o.actions &&
           action_values == o.action_values &&
@@ -449,7 +459,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [spend, impressions, reach, clicks, ctr, cpc, cpm, engagement, conversions, cost_per_conversion, actions, action_values, purchase_value, roas, cost_per_action, outbound_clicks, outbound_clicks_ctr, inline_link_clicks, inline_link_click_ctr, unique_clicks, unique_ctr, video_play_actions, video30_sec_watched_actions, video_thruplay_watched_actions, video_p25_watched_actions, video_p50_watched_actions, video_p75_watched_actions, video_p95_watched_actions, video_p100_watched_actions, video_avg_time_watched_actions, cost_per_thruplay, funnel, engagement_breakdown, last_synced_at, date].hash
+      [spend, impressions, reach, clicks, ctr, cpc, cpm, engagement, conversions, all_conversions, cost_per_conversion, actions, action_values, purchase_value, roas, cost_per_action, outbound_clicks, outbound_clicks_ctr, inline_link_clicks, inline_link_click_ctr, unique_clicks, unique_ctr, video_play_actions, video30_sec_watched_actions, video_thruplay_watched_actions, video_p25_watched_actions, video_p50_watched_actions, video_p75_watched_actions, video_p95_watched_actions, video_p100_watched_actions, video_avg_time_watched_actions, cost_per_thruplay, funnel, engagement_breakdown, last_synced_at, date].hash
     end
 
     # Builds the object from hash

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

@@ -38,6 +38,9 @@ module Zernio
     # Count of conversion events over the requested date range. FRACTIONAL: attribution splits one conversion across touchpoints and Google additionally reports modeled conversions, so values like 0.347 are normal. Meta: events matching the campaign's promoted_object.custom_event_type (PURCHASE, LEAD, etc.). Google: the account's tracked conversions. X and LinkedIn: their reported website/lead conversions (added 2026-07). 0 for non-conversion campaigns or when no events have fired.
     attr_accessor :conversions
 
+    # All conversions, including actions excluded from the Conversions column (Google metrics.all_conversions). 0 on platforms without the concept.
+    attr_accessor :all_conversions
+
     # Derived spend / conversions in the same currency as spend. 0 when conversions is 0.
     attr_accessor :cost_per_conversion
 
@@ -123,6 +126,7 @@ module Zernio
         :'cpm' => :'cpm',
         :'engagement' => :'engagement',
         :'conversions' => :'conversions',
+        :'all_conversions' => :'allConversions',
         :'cost_per_conversion' => :'costPerConversion',
         :'actions' => :'actions',
         :'action_values' => :'actionValues',
@@ -173,6 +177,7 @@ module Zernio
         :'cpm' => :'Float',
         :'engagement' => :'Integer',
         :'conversions' => :'Float',
+        :'all_conversions' => :'Float',
         :'cost_per_conversion' => :'Float',
         :'actions' => :'Hash<String, Integer>',
         :'action_values' => :'Hash<String, Float>',
@@ -259,6 +264,10 @@ module Zernio
         self.conversions = attributes[:'conversions']
       end
 
+      if attributes.key?(:'all_conversions')
+        self.all_conversions = attributes[:'all_conversions']
+      end
+
       if attributes.key?(:'cost_per_conversion')
         self.cost_per_conversion = attributes[:'cost_per_conversion']
       end
@@ -395,6 +404,7 @@ module Zernio
           cpm == o.cpm &&
           engagement == o.engagement &&
           conversions == o.conversions &&
+          all_conversions == o.all_conversions &&
           cost_per_conversion == o.cost_per_conversion &&
           actions == o.actions &&
           action_values == o.action_values &&
@@ -431,7 +441,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [spend, impressions, reach, clicks, ctr, cpc, cpm, engagement, conversions, cost_per_conversion, actions, action_values, purchase_value, roas, cost_per_action, outbound_clicks, outbound_clicks_ctr, inline_link_clicks, inline_link_click_ctr, unique_clicks, unique_ctr, video_play_actions, video30_sec_watched_actions, video_thruplay_watched_actions, video_p25_watched_actions, video_p50_watched_actions, video_p75_watched_actions, video_p95_watched_actions, video_p100_watched_actions, video_avg_time_watched_actions, cost_per_thruplay, funnel, engagement_breakdown, last_synced_at].hash
+      [spend, impressions, reach, clicks, ctr, cpc, cpm, engagement, conversions, all_conversions, cost_per_conversion, actions, action_values, purchase_value, roas, cost_per_action, outbound_clicks, outbound_clicks_ctr, inline_link_clicks, inline_link_click_ctr, unique_clicks, unique_ctr, video_play_actions, video30_sec_watched_actions, video_thruplay_watched_actions, video_p25_watched_actions, video_p50_watched_actions, video_p75_watched_actions, video_p95_watched_actions, video_p100_watched_actions, video_avg_time_watched_actions, cost_per_thruplay, funnel, engagement_breakdown, last_synced_at].hash
     end
 
     # Builds the object from hash