zernio-sdk 0.0.550 → 0.0.552

data/docs/MessagingAdsApi.md

@@ -0,0 +1,215 @@
+# Zernio::MessagingAdsApi
+
+All URIs are relative to *https://zernio.com/api*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**create_call_ad**](MessagingAdsApi.md#create_call_ad) | **POST** /v1/ads/call | Create Click-to-Call ad |
+| [**create_ctwa_ad**](MessagingAdsApi.md#create_ctwa_ad) | **POST** /v1/ads/ctwa | Create Click-to-WhatsApp ad (deprecated) |
+| [**create_messaging_ad**](MessagingAdsApi.md#create_messaging_ad) | **POST** /v1/ads/messaging | Create click-to-message ad (WhatsApp / Messenger / Instagram Direct) |
+
+
+## create_call_ad
+
+> create_call_ad(create_call_ad_request)
+
+Create Click-to-Call ad
+
+Same shape and flow as POST /v1/ads/ctwa, but the CTA is CALL_NOW dialing `phoneNumber` via a tel: link. The ad set is destination_type PHONE_CALL optimizing QUALITY_CALL and the campaign objective defaults to OUTCOME_LEADS. Supports the same single-creative and multi-creative shapes as CTWA.
+
+### 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::MessagingAdsApi.new
+create_call_ad_request = Zernio::CreateCallAdRequest.new({account_id: 'account_id_example', ad_account_id: 'ad_account_id_example', name: 'name_example', budget_amount: 3.56, budget_type: 'daily', phone_number: 'phone_number_example', link_url: 'link_url_example'}) # CreateCallAdRequest | 
+
+begin
+  # Create Click-to-Call ad
+  api_instance.create_call_ad(create_call_ad_request)
+rescue Zernio::ApiError => e
+  puts "Error when calling MessagingAdsApi->create_call_ad: #{e}"
+end
+```
+
+#### Using the create_call_ad_with_http_info variant
+
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
+
+> <Array(nil, Integer, Hash)> create_call_ad_with_http_info(create_call_ad_request)
+
+```ruby
+begin
+  # Create Click-to-Call ad
+  data, status_code, headers = api_instance.create_call_ad_with_http_info(create_call_ad_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue Zernio::ApiError => e
+  puts "Error when calling MessagingAdsApi->create_call_ad_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **create_call_ad_request** | [**CreateCallAdRequest**](CreateCallAdRequest.md) |  |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## create_ctwa_ad
+
+> <CreateCtwaAd201Response> create_ctwa_ad(ctwa_ad_request_body)
+
+Create Click-to-WhatsApp ad (deprecated)
+
+Deprecated: use POST /v1/ads/messaging with `destination: whatsapp`. This endpoint stays available for back-compat; no removal planned.  Creates one or more Click-to-WhatsApp (CTWA) ads on Meta under a single campaign and ad set. When tapped, each ad opens a WhatsApp conversation with the business attached to the supplied Facebook Page. The full hierarchy (campaign, ad set, creative(s), ad(s)) is created and activated in one call. The CTA is locked to WHATSAPP_MESSAGE and the destination is hard-coded to api.whatsapp.com/send; Meta resolves the actual WhatsApp number from the Page-to-WA pairing configured in Page settings or Business Manager.  Supports two mutually-exclusive shapes:  - **Single-creative**: supply top-level `headline`, `body`, and one of `imageUrl` / `video`. Creates 1 campaign + 1 ad set + 1 ad.  - **Multi-creative**: supply a `creatives[]` array with N entries (each carrying its own headline, body, and image/video). Creates 1 campaign + 1 ad set + N ads sharing budget and targeting so Meta A/Bs the creatives inside a single auction instead of fragmenting budget across N parallel campaigns. Recommended when launching multiple creative variants for the same campaign.  Prerequisites enforced by Meta (surfaced as platform_error on failure): the Facebook Page must be paired with a verified WhatsApp Business number, the WhatsApp Business Account must be business-verified, and the Meta access token must carry ads_management.
+
+### 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::MessagingAdsApi.new
+ctwa_ad_request_body = Zernio::CtwaAdRequestBody.new({account_id: 'account_id_example', ad_account_id: 'ad_account_id_example', name: 'name_example', budget_amount: 3.56, budget_type: 'daily'}) # CtwaAdRequestBody | 
+
+begin
+  # Create Click-to-WhatsApp ad (deprecated)
+  result = api_instance.create_ctwa_ad(ctwa_ad_request_body)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling MessagingAdsApi->create_ctwa_ad: #{e}"
+end
+```
+
+#### Using the create_ctwa_ad_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<CreateCtwaAd201Response>, Integer, Hash)> create_ctwa_ad_with_http_info(ctwa_ad_request_body)
+
+```ruby
+begin
+  # Create Click-to-WhatsApp ad (deprecated)
+  data, status_code, headers = api_instance.create_ctwa_ad_with_http_info(ctwa_ad_request_body)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <CreateCtwaAd201Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling MessagingAdsApi->create_ctwa_ad_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **ctwa_ad_request_body** | [**CtwaAdRequestBody**](CtwaAdRequestBody.md) |  |  |
+
+### Return type
+
+[**CreateCtwaAd201Response**](CreateCtwaAd201Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## create_messaging_ad
+
+> create_messaging_ad(create_messaging_ad_request)
+
+Create click-to-message ad (WhatsApp / Messenger / Instagram Direct)
+
+Creates a click-to-message ad; `destination` selects where the tapped ad opens a conversation: WhatsApp, the Page's Messenger inbox or the linked Instagram account's Direct inbox. The ad set is created with the matching destination_type and CONVERSATIONS optimization; the campaign objective defaults to OUTCOME_ENGAGEMENT. Supports single-creative and multi-creative shapes. Supersedes POST /v1/ads/ctwa (deprecated, equivalent to `destination: whatsapp`).
+
+### 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::MessagingAdsApi.new
+create_messaging_ad_request = Zernio::CreateMessagingAdRequest.new({account_id: 'account_id_example', ad_account_id: 'ad_account_id_example', name: 'name_example', budget_amount: 3.56, budget_type: 'daily', destination: 'whatsapp'}) # CreateMessagingAdRequest | 
+
+begin
+  # Create click-to-message ad (WhatsApp / Messenger / Instagram Direct)
+  api_instance.create_messaging_ad(create_messaging_ad_request)
+rescue Zernio::ApiError => e
+  puts "Error when calling MessagingAdsApi->create_messaging_ad: #{e}"
+end
+```
+
+#### Using the create_messaging_ad_with_http_info variant
+
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
+
+> <Array(nil, Integer, Hash)> create_messaging_ad_with_http_info(create_messaging_ad_request)
+
+```ruby
+begin
+  # Create click-to-message ad (WhatsApp / Messenger / Instagram Direct)
+  data, status_code, headers = api_instance.create_messaging_ad_with_http_info(create_messaging_ad_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue Zernio::ApiError => e
+  puts "Error when calling MessagingAdsApi->create_messaging_ad_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **create_messaging_ad_request** | [**CreateMessagingAdRequest**](CreateMessagingAdRequest.md) |  |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+

data/docs/ReachAndFrequencyApi.md

@@ -0,0 +1,294 @@
+# Zernio::ReachAndFrequencyApi
+
+All URIs are relative to *https://zernio.com/api*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**cancel_rf_reservation**](ReachAndFrequencyApi.md#cancel_rf_reservation) | **DELETE** /v1/ads/rf-predictions/{predictionId} | Cancel a Reach & Frequency reservation |
+| [**create_rf_prediction**](ReachAndFrequencyApi.md#create_rf_prediction) | **POST** /v1/ads/rf-predictions | Create a Reach & Frequency prediction |
+| [**get_rf_prediction**](ReachAndFrequencyApi.md#get_rf_prediction) | **GET** /v1/ads/rf-predictions/{predictionId} | Read a Reach & Frequency prediction |
+| [**reserve_rf_prediction**](ReachAndFrequencyApi.md#reserve_rf_prediction) | **POST** /v1/ads/rf-predictions/{predictionId}/reserve | Reserve a Reach & Frequency prediction |
+
+
+## cancel_rf_reservation
+
+> cancel_rf_reservation(prediction_id, account_id, ad_account_id)
+
+Cancel a Reach & Frequency reservation
+
+Releases a RESERVATION's locked price and inventory. Unreserved predictions expire on their own.
+
+### 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::ReachAndFrequencyApi.new
+prediction_id = 'prediction_id_example' # String | 
+account_id = 'account_id_example' # String | 
+ad_account_id = 'ad_account_id_example' # String | 
+
+begin
+  # Cancel a Reach & Frequency reservation
+  api_instance.cancel_rf_reservation(prediction_id, account_id, ad_account_id)
+rescue Zernio::ApiError => e
+  puts "Error when calling ReachAndFrequencyApi->cancel_rf_reservation: #{e}"
+end
+```
+
+#### Using the cancel_rf_reservation_with_http_info variant
+
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
+
+> <Array(nil, Integer, Hash)> cancel_rf_reservation_with_http_info(prediction_id, account_id, ad_account_id)
+
+```ruby
+begin
+  # Cancel a Reach & Frequency reservation
+  data, status_code, headers = api_instance.cancel_rf_reservation_with_http_info(prediction_id, account_id, ad_account_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue Zernio::ApiError => e
+  puts "Error when calling ReachAndFrequencyApi->cancel_rf_reservation_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **prediction_id** | **String** |  |  |
+| **account_id** | **String** |  |  |
+| **ad_account_id** | **String** |  |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## create_rf_prediction
+
+> <CreateRfPrediction201Response> create_rf_prediction(create_rf_prediction_request)
+
+Create a Reach & Frequency prediction
+
+Creates an R&F prediction — a QUOTE, nothing is bought and no ad entities are created. Provide a date range plus exactly one of `budgetAmount` (Meta predicts reach) or `reach` (Meta predicts the budget). The response carries the estimate and its allowed bounds (min/max budget and reach). Predictions expire on their own; to buy, reserve one via POST /v1/ads/rf-predictions/{predictionId}/reserve and pass the RESERVED id to POST /v1/ads/create with `buyingType: \"RESERVED\"`.  Reservation campaigns reject automatic placements, so omitted `placements` default to Facebook feed (+ Instagram stream when a linked IG professional account resolves); Instagram placements require that IG account.
+
+### 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::ReachAndFrequencyApi.new
+create_rf_prediction_request = Zernio::CreateRfPredictionRequest.new({account_id: 'account_id_example', ad_account_id: 'ad_account_id_example', start_date: Time.now, end_date: Time.now}) # CreateRfPredictionRequest | 
+
+begin
+  # Create a Reach & Frequency prediction
+  result = api_instance.create_rf_prediction(create_rf_prediction_request)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling ReachAndFrequencyApi->create_rf_prediction: #{e}"
+end
+```
+
+#### Using the create_rf_prediction_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<CreateRfPrediction201Response>, Integer, Hash)> create_rf_prediction_with_http_info(create_rf_prediction_request)
+
+```ruby
+begin
+  # Create a Reach & Frequency prediction
+  data, status_code, headers = api_instance.create_rf_prediction_with_http_info(create_rf_prediction_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <CreateRfPrediction201Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling ReachAndFrequencyApi->create_rf_prediction_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **create_rf_prediction_request** | [**CreateRfPredictionRequest**](CreateRfPredictionRequest.md) |  |  |
+
+### Return type
+
+[**CreateRfPrediction201Response**](CreateRfPrediction201Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## get_rf_prediction
+
+> <CreateRfPrediction201Response> get_rf_prediction(prediction_id, account_id, ad_account_id)
+
+Read a Reach & Frequency prediction
+
+### 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::ReachAndFrequencyApi.new
+prediction_id = 'prediction_id_example' # String | 
+account_id = 'account_id_example' # String | 
+ad_account_id = 'ad_account_id_example' # String | 
+
+begin
+  # Read a Reach & Frequency prediction
+  result = api_instance.get_rf_prediction(prediction_id, account_id, ad_account_id)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling ReachAndFrequencyApi->get_rf_prediction: #{e}"
+end
+```
+
+#### Using the get_rf_prediction_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<CreateRfPrediction201Response>, Integer, Hash)> get_rf_prediction_with_http_info(prediction_id, account_id, ad_account_id)
+
+```ruby
+begin
+  # Read a Reach & Frequency prediction
+  data, status_code, headers = api_instance.get_rf_prediction_with_http_info(prediction_id, account_id, ad_account_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <CreateRfPrediction201Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling ReachAndFrequencyApi->get_rf_prediction_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **prediction_id** | **String** |  |  |
+| **account_id** | **String** |  |  |
+| **ad_account_id** | **String** |  |  |
+
+### Return type
+
+[**CreateRfPrediction201Response**](CreateRfPrediction201Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## reserve_rf_prediction
+
+> <ReserveRfPrediction201Response> reserve_rf_prediction(prediction_id, reserve_rf_prediction_request)
+
+Reserve a Reach & Frequency prediction
+
+Locks the quoted price + inventory until the returned `expiresAt` and mints a NEW prediction id — pass that RESERVED id (not the original) as `rfPredictionId` on POST /v1/ads/create. Release an unused reservation via DELETE.
+
+### 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::ReachAndFrequencyApi.new
+prediction_id = 'prediction_id_example' # String | 
+reserve_rf_prediction_request = Zernio::ReserveRfPredictionRequest.new({account_id: 'account_id_example', ad_account_id: 'ad_account_id_example'}) # ReserveRfPredictionRequest | 
+
+begin
+  # Reserve a Reach & Frequency prediction
+  result = api_instance.reserve_rf_prediction(prediction_id, reserve_rf_prediction_request)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling ReachAndFrequencyApi->reserve_rf_prediction: #{e}"
+end
+```
+
+#### Using the reserve_rf_prediction_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ReserveRfPrediction201Response>, Integer, Hash)> reserve_rf_prediction_with_http_info(prediction_id, reserve_rf_prediction_request)
+
+```ruby
+begin
+  # Reserve a Reach & Frequency prediction
+  data, status_code, headers = api_instance.reserve_rf_prediction_with_http_info(prediction_id, reserve_rf_prediction_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ReserveRfPrediction201Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling ReachAndFrequencyApi->reserve_rf_prediction_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **prediction_id** | **String** |  |  |
+| **reserve_rf_prediction_request** | [**ReserveRfPredictionRequest**](ReserveRfPredictionRequest.md) |  |  |
+
+### Return type
+
+[**ReserveRfPrediction201Response**](ReserveRfPrediction201Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+

data/docs/TrackingTagsApi.md

@@ -6,11 +6,13 @@ All URIs are relative to *https://zernio.com/api*
 | ------ | ------------ | ----------- |
 | [**add_tracking_tag_shared_account**](TrackingTagsApi.md#add_tracking_tag_shared_account) | **POST** /v1/accounts/{accountId}/tracking-tags/{tagId}/shared-accounts | Share with an ad account |
 | [**create_tracking_tag**](TrackingTagsApi.md#create_tracking_tag) | **POST** /v1/accounts/{accountId}/tracking-tags | Create a tracking tag |
+| [**get_ad_tracking_tags**](TrackingTagsApi.md#get_ad_tracking_tags) | **GET** /v1/ads/{adId}/tracking-tags | Get ad tracking tags |
 | [**get_tracking_tag**](TrackingTagsApi.md#get_tracking_tag) | **GET** /v1/accounts/{accountId}/tracking-tags/{tagId} | Get a tracking tag |
 | [**get_tracking_tag_stats**](TrackingTagsApi.md#get_tracking_tag_stats) | **GET** /v1/accounts/{accountId}/tracking-tags/{tagId}/stats | Get aggregated event stats |
 | [**list_tracking_tag_shared_accounts**](TrackingTagsApi.md#list_tracking_tag_shared_accounts) | **GET** /v1/accounts/{accountId}/tracking-tags/{tagId}/shared-accounts | List accounts it is shared with |
 | [**list_tracking_tags**](TrackingTagsApi.md#list_tracking_tags) | **GET** /v1/accounts/{accountId}/tracking-tags | List tracking tags |
 | [**remove_tracking_tag_shared_account**](TrackingTagsApi.md#remove_tracking_tag_shared_account) | **DELETE** /v1/accounts/{accountId}/tracking-tags/{tagId}/shared-accounts | Stop sharing with an account |
+| [**update_ad_tracking_tags**](TrackingTagsApi.md#update_ad_tracking_tags) | **PATCH** /v1/ads/{adId}/tracking-tags | Set ad tracking tags |
 | [**update_tracking_tag**](TrackingTagsApi.md#update_tracking_tag) | **PATCH** /v1/accounts/{accountId}/tracking-tags/{tagId} | Update a tracking tag |
 
 
@@ -158,6 +160,75 @@ end
 - **Accept**: application/json
 
 
+## get_ad_tracking_tags
+
+> <GetAdTrackingTags200Response> get_ad_tracking_tags(ad_id)
+
+Get ad tracking tags
+
+Unified read of the platform's native click-URL tracking params. - Meta (facebook/instagram): the creative's `url_tags` (and template_url_spec). - Google (googleads): the campaign's `trackingUrlTemplate` + `finalUrlSuffix`.   Subject to the Google Ads API access-tier daily quota; bulk audits need Standard access. - LinkedIn (linkedinads): the campaign's Dynamic UTM `dynamicValueParameters` + `customValueParameters`. Returns 405 for platforms without a click-URL tracking surface (TikTok, X, Pinterest). 
+
+### 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::TrackingTagsApi.new
+ad_id = 'ad_id_example' # String | Ad id (hex _id, platformAdId, or effective story/media id).
+
+begin
+  # Get ad tracking tags
+  result = api_instance.get_ad_tracking_tags(ad_id)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling TrackingTagsApi->get_ad_tracking_tags: #{e}"
+end
+```
+
+#### Using the get_ad_tracking_tags_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetAdTrackingTags200Response>, Integer, Hash)> get_ad_tracking_tags_with_http_info(ad_id)
+
+```ruby
+begin
+  # Get ad tracking tags
+  data, status_code, headers = api_instance.get_ad_tracking_tags_with_http_info(ad_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetAdTrackingTags200Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling TrackingTagsApi->get_ad_tracking_tags_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **ad_id** | **String** | Ad id (hex _id, platformAdId, or effective story/media id). |  |
+
+### Return type
+
+[**GetAdTrackingTags200Response**](GetAdTrackingTags200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## get_tracking_tag
 
 > <CreateTrackingTag201Response> get_tracking_tag(account_id, tag_id)
@@ -526,6 +597,76 @@ nil (empty response body)
 - **Accept**: application/json
 
 
+## update_ad_tracking_tags
+
+> update_ad_tracking_tags(ad_id, update_ad_tracking_tags_request)
+
+Set ad tracking tags
+
+Unified update. Send only the fields for the ad's platform: - Meta: `urlTags` (array of {key,value}). Meta creatives are immutable, so this rebuilds the   creative and repoints the ad. By DEFAULT we PRESERVE the existing creative verbatim   (re-post its object_story_spec + the new url_tags, reusing the image), so you send `urlTags`   ALONE — no need to read back headline/body/CTA. `creative` (headline, body, callToAction,   linkUrl, imageUrl) is OPTIONAL and only needed to rebuild explicitly, or for SHARE / page-post   / dark / asset_feed creatives whose object_story_spec Meta strips (those return 422 asking for   `creative`). - Google: `trackingUrlTemplate` and/or `finalUrlSuffix` (full template strings; account quota applies). - LinkedIn: `dynamicValueParameters` and/or `customValueParameters` (campaign-level Dynamic UTM). 
+
+### 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::TrackingTagsApi.new
+ad_id = 'ad_id_example' # String | 
+update_ad_tracking_tags_request = Zernio::UpdateAdTrackingTagsRequest.new # UpdateAdTrackingTagsRequest | 
+
+begin
+  # Set ad tracking tags
+  api_instance.update_ad_tracking_tags(ad_id, update_ad_tracking_tags_request)
+rescue Zernio::ApiError => e
+  puts "Error when calling TrackingTagsApi->update_ad_tracking_tags: #{e}"
+end
+```
+
+#### Using the update_ad_tracking_tags_with_http_info variant
+
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
+
+> <Array(nil, Integer, Hash)> update_ad_tracking_tags_with_http_info(ad_id, update_ad_tracking_tags_request)
+
+```ruby
+begin
+  # Set ad tracking tags
+  data, status_code, headers = api_instance.update_ad_tracking_tags_with_http_info(ad_id, update_ad_tracking_tags_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue Zernio::ApiError => e
+  puts "Error when calling TrackingTagsApi->update_ad_tracking_tags_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **ad_id** | **String** |  |  |
+| **update_ad_tracking_tags_request** | [**UpdateAdTrackingTagsRequest**](UpdateAdTrackingTagsRequest.md) |  |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## update_tracking_tag
 
 > <CreateTrackingTag201Response> update_tracking_tag(account_id, tag_id, update_tracking_tag_request)

data/docs/YouTubeDailyViewsResponse.md

@@ -8,6 +8,7 @@
 | **video_id** | **String** | The YouTube video ID | [optional] |
 | **duration_seconds** | **Integer** | Video length in seconds (from YouTube contentDetails.duration) | [optional] |
 | **date_range** | [**YouTubeDailyViewsResponseDateRange**](YouTubeDailyViewsResponseDateRange.md) |  | [optional] |
+| **provisional_since** | **Date** | Present only when the range reaches into YouTube's ~3-day processing window: the first date whose numbers are provisional and may still be revised by YouTube. | [optional] |
 | **total_views** | **Integer** | Sum of views across all days in the range | [optional] |
 | **daily_views** | [**Array<YouTubeDailyViewsResponseDailyViewsInner>**](YouTubeDailyViewsResponseDailyViewsInner.md) |  | [optional] |
 | **last_synced_at** | **Time** | When the data was last synced from YouTube | [optional] |
@@ -23,6 +24,7 @@ instance = Zernio::YouTubeDailyViewsResponse.new(
   video_id: null,
   duration_seconds: null,
   date_range: null,
+  provisional_since: null,
   total_views: null,
   daily_views: null,
   last_synced_at: null,