late-sdk 0.0.705 → 0.0.707

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7153cb1164607836b86fd1dbc18996db6245896bc0fe7309b7594bcd782368ff
-  data.tar.gz: 26865b20ff4a03a1657fe716dd906db9d0804fd349fd1872da9eff2f695f80c8
+  metadata.gz: 6603194bef66dba2de17168c5b8ef102ab100f6406617c4d0c3bbf0f06ce576c
+  data.tar.gz: a7f637e264a58447b04932c099ad0b8e45671a13594cff01838f225cca58beaa
 SHA512:
-  metadata.gz: 11db15896f63af5f214d89f986aff25715529dcba274391ebaecaadceaf7bb6e2f507c3d9893af7f9cd5753f1e6e13b10a3862b21b2baf7d5e141fcca829f816
-  data.tar.gz: 732da95ad6b846017cf2f086687afc6d514c46a699e1a66119df51294453921d4ac9946158a684b3e54190adefcba605829d7da4d8ccffd2f5f99d42de16d7d7
+  metadata.gz: 1aabf517b419736b6e84044b9c9dab9c4a9bb5d9d7f8aadbadfa150d07136b7b892320dba5edf99b8044a900db34eaf65fbcb14c9abfc38ec87b59d3b04831f0
+  data.tar.gz: 95a110b10d856d9d85a7463145ffbedf6719b180cbc6a6e3a14928882d49fc024f7643947d0e85e24aef9562671bfe04797a74ba04352f8866d5b7b89b0d3bf4

data/README.md

@@ -94,6 +94,8 @@ Class | Method | HTTP request | Description
 *Zernio::AccountsApi* | [**move_account_to_profile**](docs/AccountsApi.md#move_account_to_profile) | **PATCH** /v1/accounts/{accountId} | Move account to another profile
 *Zernio::AccountsApi* | [**update_account**](docs/AccountsApi.md#update_account) | **PUT** /v1/accounts/{accountId} | Update account
 *Zernio::AccountsApi* | [**update_slack_settings**](docs/AccountsApi.md#update_slack_settings) | **PATCH** /v1/accounts/{accountId}/slack-settings | Update Slack account settings
+*Zernio::AdAccountsApi* | [**create_custom_conversion**](docs/AdAccountsApi.md#create_custom_conversion) | **POST** /v1/accounts/{accountId}/custom-conversions | Create or reuse a custom conversion
+*Zernio::AdAccountsApi* | [**create_high_demand_period**](docs/AdAccountsApi.md#create_high_demand_period) | **POST** /v1/ads/high-demand-periods | Schedule a budget increase
 *Zernio::AdAccountsApi* | [**create_value_rule_set**](docs/AdAccountsApi.md#create_value_rule_set) | **POST** /v1/ads/value-rule-sets | Create a value rule set
 *Zernio::AdAccountsApi* | [**delete_value_rule_set**](docs/AdAccountsApi.md#delete_value_rule_set) | **DELETE** /v1/ads/value-rule-sets/{valueRuleSetId} | Delete a value rule set
 *Zernio::AdAccountsApi* | [**get_ad_account_finance**](docs/AdAccountsApi.md#get_ad_account_finance) | **GET** /v1/ads/accounts/finance | Ad account finances
@@ -106,6 +108,7 @@ Class | Method | HTTP request | Description
 *Zernio::AdAccountsApi* | [**list_ad_labels**](docs/AdAccountsApi.md#list_ad_labels) | **GET** /v1/ads/labels | Ad labels
 *Zernio::AdAccountsApi* | [**list_ad_studies**](docs/AdAccountsApi.md#list_ad_studies) | **GET** /v1/ads/studies | A/B tests and lift studies
 *Zernio::AdAccountsApi* | [**list_ads_business_centers**](docs/AdAccountsApi.md#list_ads_business_centers) | **GET** /v1/ads/business-centers | List TikTok Business Centers
+*Zernio::AdAccountsApi* | [**list_custom_conversions**](docs/AdAccountsApi.md#list_custom_conversions) | **GET** /v1/accounts/{accountId}/custom-conversions | List custom conversions
 *Zernio::AdAccountsApi* | [**list_high_demand_periods**](docs/AdAccountsApi.md#list_high_demand_periods) | **GET** /v1/ads/high-demand-periods | High demand periods / budget schedules
 *Zernio::AdAccountsApi* | [**list_meta_businesses**](docs/AdAccountsApi.md#list_meta_businesses) | **GET** /v1/ads/businesses | Businesses list
 *Zernio::AdAccountsApi* | [**list_value_rule_sets**](docs/AdAccountsApi.md#list_value_rule_sets) | **GET** /v1/ads/value-rule-sets | List value rule sets
@@ -799,6 +802,7 @@ Class | Method | HTTP request | Description
  - [Zernio::CreateConversionDestinationRequest](docs/CreateConversionDestinationRequest.md)
  - [Zernio::CreateConversionDestinationRequestValue](docs/CreateConversionDestinationRequestValue.md)
  - [Zernio::CreateCtwaAd201Response](docs/CreateCtwaAd201Response.md)
+ - [Zernio::CreateCustomConversionRequest](docs/CreateCustomConversionRequest.md)
  - [Zernio::CreateCustomField200Response](docs/CreateCustomField200Response.md)
  - [Zernio::CreateCustomFieldRequest](docs/CreateCustomFieldRequest.md)
  - [Zernio::CreateDiscordGuildRole201Response](docs/CreateDiscordGuildRole201Response.md)
@@ -816,6 +820,8 @@ Class | Method | HTTP request | Description
  - [Zernio::CreateGoogleBusinessMediaRequest](docs/CreateGoogleBusinessMediaRequest.md)
  - [Zernio::CreateGoogleBusinessPlaceAction200Response](docs/CreateGoogleBusinessPlaceAction200Response.md)
  - [Zernio::CreateGoogleBusinessPlaceActionRequest](docs/CreateGoogleBusinessPlaceActionRequest.md)
+ - [Zernio::CreateHighDemandPeriod201Response](docs/CreateHighDemandPeriod201Response.md)
+ - [Zernio::CreateHighDemandPeriodRequest](docs/CreateHighDemandPeriodRequest.md)
  - [Zernio::CreateInboxConversation201Response](docs/CreateInboxConversation201Response.md)
  - [Zernio::CreateInboxConversation201ResponseData](docs/CreateInboxConversation201ResponseData.md)
  - [Zernio::CreateInboxConversation400Response](docs/CreateInboxConversation400Response.md)
@@ -927,6 +933,8 @@ Class | Method | HTTP request | Description
  - [Zernio::CtwaAdRequestBodyZipsInner](docs/CtwaAdRequestBodyZipsInner.md)
  - [Zernio::CtwaMultiResponse](docs/CtwaMultiResponse.md)
  - [Zernio::CtwaSingleResponse](docs/CtwaSingleResponse.md)
+ - [Zernio::CustomConversion](docs/CustomConversion.md)
+ - [Zernio::CustomConversionResult](docs/CustomConversionResult.md)
  - [Zernio::DeactivateSmsRegistration200Response](docs/DeactivateSmsRegistration200Response.md)
  - [Zernio::DeleteAccountGroup200Response](docs/DeleteAccountGroup200Response.md)
  - [Zernio::DeleteAdCampaign200Response](docs/DeleteAdCampaign200Response.md)
@@ -1465,6 +1473,7 @@ Class | Method | HTTP request | Description
  - [Zernio::ListConversionAssociations200ResponseAssociationsInner](docs/ListConversionAssociations200ResponseAssociationsInner.md)
  - [Zernio::ListConversionDestinations200Response](docs/ListConversionDestinations200Response.md)
  - [Zernio::ListConversionDestinations200ResponseDestinationsInner](docs/ListConversionDestinations200ResponseDestinationsInner.md)
+ - [Zernio::ListCustomConversions200Response](docs/ListCustomConversions200Response.md)
  - [Zernio::ListCustomFields200Response](docs/ListCustomFields200Response.md)
  - [Zernio::ListCustomFields200ResponseFieldsInner](docs/ListCustomFields200ResponseFieldsInner.md)
  - [Zernio::ListDiscordGuildMembers200Response](docs/ListDiscordGuildMembers200Response.md)

data/docs/AdAccountsApi.md

@@ -4,6 +4,8 @@ All URIs are relative to *https://zernio.com/api*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
+| [**create_custom_conversion**](AdAccountsApi.md#create_custom_conversion) | **POST** /v1/accounts/{accountId}/custom-conversions | Create or reuse a custom conversion |
+| [**create_high_demand_period**](AdAccountsApi.md#create_high_demand_period) | **POST** /v1/ads/high-demand-periods | Schedule a budget increase |
 | [**create_value_rule_set**](AdAccountsApi.md#create_value_rule_set) | **POST** /v1/ads/value-rule-sets | Create a value rule set |
 | [**delete_value_rule_set**](AdAccountsApi.md#delete_value_rule_set) | **DELETE** /v1/ads/value-rule-sets/{valueRuleSetId} | Delete a value rule set |
 | [**get_ad_account_finance**](AdAccountsApi.md#get_ad_account_finance) | **GET** /v1/ads/accounts/finance | Ad account finances |
@@ -16,6 +18,7 @@ All URIs are relative to *https://zernio.com/api*
 | [**list_ad_labels**](AdAccountsApi.md#list_ad_labels) | **GET** /v1/ads/labels | Ad labels |
 | [**list_ad_studies**](AdAccountsApi.md#list_ad_studies) | **GET** /v1/ads/studies | A/B tests and lift studies |
 | [**list_ads_business_centers**](AdAccountsApi.md#list_ads_business_centers) | **GET** /v1/ads/business-centers | List TikTok Business Centers |
+| [**list_custom_conversions**](AdAccountsApi.md#list_custom_conversions) | **GET** /v1/accounts/{accountId}/custom-conversions | List custom conversions |
 | [**list_high_demand_periods**](AdAccountsApi.md#list_high_demand_periods) | **GET** /v1/ads/high-demand-periods | High demand periods / budget schedules |
 | [**list_meta_businesses**](AdAccountsApi.md#list_meta_businesses) | **GET** /v1/ads/businesses | Businesses list |
 | [**list_value_rule_sets**](AdAccountsApi.md#list_value_rule_sets) | **GET** /v1/ads/value-rule-sets | List value rule sets |
@@ -23,6 +26,146 @@ All URIs are relative to *https://zernio.com/api*
 | [**update_value_rule_set**](AdAccountsApi.md#update_value_rule_set) | **PUT** /v1/ads/value-rule-sets/{valueRuleSetId} | Replace a value rule set |
 
 
+## create_custom_conversion
+
+> <CustomConversionResult> create_custom_conversion(account_id, create_custom_conversion_request)
+
+Create or reuse a custom conversion
+
+Provision the Meta custom conversion an ads flow optimises toward, and hand back the `customConversionId` for `promotedObject.customConversionId` on POST /v1/ads/create. Removes the manual \"create it in Ads Manager first\" step.  **Reuse is ours, not Meta's.** Meta's create is not idempotent, so a retried request would otherwise mint a duplicate carrying none of the original's optimisation history. A non-archived conversion with the same `name` on the same `pixelId` is returned instead of created, with `reused: true` and a 200 rather than a 201.  `rule` is forwarded verbatim in Meta's own grammar (e.g. `{\"url\": {\"i_contains\": \"thank-you\"}}`); Meta validates it and rejects a malformed one with \"A conversion rule is required at creation time\".
+
+### 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::AdAccountsApi.new
+account_id = 'account_id_example' # String | Meta ads SocialAccount id.
+create_custom_conversion_request = Zernio::CreateCustomConversionRequest.new({ad_account_id: 'ad_account_id_example', name: 'name_example', pixel_id: 'pixel_id_example', custom_event_type: 'custom_event_type_example', rule: 3.56}) # CreateCustomConversionRequest | 
+
+begin
+  # Create or reuse a custom conversion
+  result = api_instance.create_custom_conversion(account_id, create_custom_conversion_request)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling AdAccountsApi->create_custom_conversion: #{e}"
+end
+```
+
+#### Using the create_custom_conversion_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<CustomConversionResult>, Integer, Hash)> create_custom_conversion_with_http_info(account_id, create_custom_conversion_request)
+
+```ruby
+begin
+  # Create or reuse a custom conversion
+  data, status_code, headers = api_instance.create_custom_conversion_with_http_info(account_id, create_custom_conversion_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <CustomConversionResult>
+rescue Zernio::ApiError => e
+  puts "Error when calling AdAccountsApi->create_custom_conversion_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | Meta ads SocialAccount id. |  |
+| **create_custom_conversion_request** | [**CreateCustomConversionRequest**](CreateCustomConversionRequest.md) |  |  |
+
+### Return type
+
+[**CustomConversionResult**](CustomConversionResult.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## create_high_demand_period
+
+> <CreateHighDemandPeriod201Response> create_high_demand_period(create_high_demand_period_request)
+
+Schedule a budget increase
+
+Pre-schedule a temporary budget increase (Black Friday, a launch, a sale) instead of editing the budget by hand on the day. Same target rule as the GET: exactly one of `campaignId` / `adSetId`.  Two Meta constraints worth knowing before you call it. `timeStart` / `timeEnd` must fall on a 15-minute boundary, and a campaign cannot mix `ABSOLUTE` and `MULTIPLIER` across its schedules — the second type is rejected with \"Can't mix your budget scaling selection\". Window rules (must sit inside the campaign's run dates, minimum lead time, no overlap) are Meta's and its message is forwarded verbatim.
+
+### 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::AdAccountsApi.new
+create_high_demand_period_request = Zernio::CreateHighDemandPeriodRequest.new({account_id: 'account_id_example', budget_value: 3.56, budget_value_type: 'ABSOLUTE', time_start: 37, time_end: 37}) # CreateHighDemandPeriodRequest | 
+
+begin
+  # Schedule a budget increase
+  result = api_instance.create_high_demand_period(create_high_demand_period_request)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling AdAccountsApi->create_high_demand_period: #{e}"
+end
+```
+
+#### Using the create_high_demand_period_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<CreateHighDemandPeriod201Response>, Integer, Hash)> create_high_demand_period_with_http_info(create_high_demand_period_request)
+
+```ruby
+begin
+  # Schedule a budget increase
+  data, status_code, headers = api_instance.create_high_demand_period_with_http_info(create_high_demand_period_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <CreateHighDemandPeriod201Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling AdAccountsApi->create_high_demand_period_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **create_high_demand_period_request** | [**CreateHighDemandPeriodRequest**](CreateHighDemandPeriodRequest.md) |  |  |
+
+### Return type
+
+[**CreateHighDemandPeriod201Response**](CreateHighDemandPeriod201Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## create_value_rule_set
 
 > <CreateValueRuleSet201Response> create_value_rule_set(create_value_rule_set_request)
@@ -907,6 +1050,77 @@ end
 - **Accept**: application/json
 
 
+## list_custom_conversions
+
+> <ListCustomConversions200Response> list_custom_conversions(account_id, ad_account_id)
+
+List custom conversions
+
+The ad account's Meta custom conversions, including archived ones (`isArchived`).
+
+### 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::AdAccountsApi.new
+account_id = 'account_id_example' # String | Meta ads SocialAccount id.
+ad_account_id = 'ad_account_id_example' # String | Meta ad account id (act_<n>).
+
+begin
+  # List custom conversions
+  result = api_instance.list_custom_conversions(account_id, ad_account_id)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling AdAccountsApi->list_custom_conversions: #{e}"
+end
+```
+
+#### Using the list_custom_conversions_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ListCustomConversions200Response>, Integer, Hash)> list_custom_conversions_with_http_info(account_id, ad_account_id)
+
+```ruby
+begin
+  # List custom conversions
+  data, status_code, headers = api_instance.list_custom_conversions_with_http_info(account_id, ad_account_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ListCustomConversions200Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling AdAccountsApi->list_custom_conversions_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | Meta ads SocialAccount id. |  |
+| **ad_account_id** | **String** | Meta ad account id (act_&lt;n&gt;). |  |
+
+### Return type
+
+[**ListCustomConversions200Response**](ListCustomConversions200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## list_high_demand_periods
 
 > <ListHighDemandPeriods200Response> list_high_demand_periods(account_id, opts)

data/docs/CreateAdCreativeRequest.md

@@ -16,6 +16,7 @@
 | **carousel_cards** | [**Array<CreateAdCreativeRequestCarouselCardsInner>**](CreateAdCreativeRequestCarouselCardsInner.md) |  | [optional] |
 | **url_tags** | **String** | Appended to every outbound URL (e.g. utm_source=fb). | [optional] |
 | **creative_features** | **Hash<String, String>** | Advantage+ creative enhancements: partial map of Meta creative feature keys (snake_case) to enroll status, forwarded as degrees_of_freedom_spec.creative_features_spec. Unspecified features default to OPT_OUT. | [optional] |
+| **multi_advertiser** | **String** | Meta only. Multi-advertiser ads: whether Meta may show this ad alongside other advertisers' in one unit. Meta auto-enrols since Aug 2024, so send OPT_OUT to leave. It is a top-level creative field, NOT a `creativeFeatures` key — Meta rejects it there. | [optional] |
 
 ## Example
 
@@ -34,7 +35,8 @@ instance = Zernio::CreateAdCreativeRequest.new(
   image_hash: null,
   carousel_cards: null,
   url_tags: null,
-  creative_features: null
+  creative_features: null,
+  multi_advertiser: null
 )
 ```
 

data/docs/CreateCustomConversionRequest.md

@@ -0,0 +1,26 @@
+# Zernio::CreateCustomConversionRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **ad_account_id** | **String** | Meta ad account id (act_<n>). |  |
+| **name** | **String** | Also the reuse key, together with pixelId. |  |
+| **pixel_id** | **String** | Meta pixel id (event_source_id). From GET /v1/accounts/{accountId}/tracking-tags. |  |
+| **custom_event_type** | **String** | Meta custom_event_type, e.g. LEAD, PURCHASE, OTHER. |  |
+| **rule** | **Object** | Meta conversion rule, forwarded verbatim. |  |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateCustomConversionRequest.new(
+  ad_account_id: null,
+  name: null,
+  pixel_id: null,
+  custom_event_type: null,
+  rule: null
+)
+```
+

data/docs/CreateHighDemandPeriod201Response.md

@@ -0,0 +1,20 @@
+# Zernio::CreateHighDemandPeriod201Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **object_id** | **String** | The campaign / ad set the schedule was attached to. | [optional] |
+| **id** | **String** | Meta budget schedule id. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateHighDemandPeriod201Response.new(
+  object_id: null,
+  id: null
+)
+```
+

data/docs/CreateHighDemandPeriodRequest.md

@@ -0,0 +1,34 @@
+# Zernio::CreateHighDemandPeriodRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | Zernio SocialAccount id used to resolve the Meta token. |  |
+| **campaign_id** | **String** | Platform campaign id. Exactly one of campaignId / adSetId. | [optional] |
+| **ad_set_id** | **String** | Platform ad set id. Exactly one of campaignId / adSetId. | [optional] |
+| **budget_value** | **Float** | With ABSOLUTE, a budget in the ad account's currency in WHOLE units (50 = $50.00). With MULTIPLIER, a factor of the existing budget (2 = double it) and NOT a currency amount. |  |
+| **budget_value_type** | **String** |  |  |
+| **time_start** | **Integer** | Unix seconds, on a 15-minute boundary (:00, :15, :30, :45). |  |
+| **time_end** | **Integer** | Unix seconds, on a 15-minute boundary and after timeStart. |  |
+| **recurrence_type** | **String** |  | [optional] |
+| **currency** | **String** | Ad account currency, for the ABSOLUTE minor-unit conversion. Ignored for MULTIPLIER. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateHighDemandPeriodRequest.new(
+  account_id: null,
+  campaign_id: null,
+  ad_set_id: null,
+  budget_value: null,
+  budget_value_type: null,
+  time_start: null,
+  time_end: null,
+  recurrence_type: null,
+  currency: null
+)
+```
+

data/docs/CreateStandaloneAdRequest.md

@@ -17,6 +17,7 @@
 | **buying_type** | **String** | Meta only. RESERVED = Reach & Frequency: requires `rfPredictionId` (a RESERVED prediction from /v1/ads/rf-predictions + /reserve). Budget, schedule and pricing come from the reservation, so budgetAmount/budgetType are not required and bid fields are ignored. Only the plain single-ad shape (no creatives[], adSetId, existingCampaignId or dynamicCreative). | [optional] |
 | **rf_prediction_id** | **String** | Meta only. The RESERVED prediction id the R&F ad set runs on (reserving mints a new id — pass that one). Requires buyingType RESERVED. | [optional] |
 | **creative_features** | **Hash<String, String>** | Meta only. Advantage+ creative enhancements: a partial map of Meta creative feature keys (snake_case, e.g. enhance_cta, image_brightness_and_contrast, text_optimizations) to enroll status, forwarded as degrees_of_freedom_spec.creative_features_spec. Meta validates the keys; unspecified features default to OPT_OUT. The legacy standard_enhancements bundle is deprecated by Meta and rejected. | [optional] |
+| **multi_advertiser** | **String** | Meta only. Multi-advertiser ads: whether Meta may show this ad alongside other advertisers' in one unit. Meta auto-enrols since Aug 2024, so send OPT_OUT to leave. It is a top-level creative field, NOT a `creativeFeatures` key — Meta rejects it there. | [optional] |
 | **validate_only** | **Boolean** | Meta only, single standalone shape only (no creatives[], adSetId, or RESERVED). Dry-run: each node runs Meta's execution_options validate_only and NOTHING is created or persisted. Children need real parents, so a fresh tree validates the campaign + creative (the ad set needs its campaign to exist — pass existingCampaignId to validate it too; the ad itself is never validatable pre-create). A Meta validation failure returns the 400 verbatim; success returns 200 with per-node results instead of an ad. | [optional] |
 | **budget_amount** | **Float** | Budget in WHOLE currency units (USD: 50 = $50.00), NOT cents — Meta's own Marketing API takes this same number in minor units, so it is an easy and expensive mix-up. Required on legacy + multi-creative shapes. Inherited on attach. OpenAI Ads requires a $1 minimum (its budget is lifetime-only, see budgetType). | [optional] |
 | **budget_type** | **String** | Required on legacy + multi-creative shapes. Inherited on attach. OpenAI Ads accepts lifetime only (no daily-budget concept on the platform); sending daily returns 422. OpenAI Ads lifetime budgets require `endDate` to give the lifetime cap a spend window. | [optional] |
@@ -105,6 +106,7 @@ instance = Zernio::CreateStandaloneAdRequest.new(
   buying_type: null,
   rf_prediction_id: null,
   creative_features: null,
+  multi_advertiser: null,
   validate_only: null,
   budget_amount: null,
   budget_type: null,

data/docs/CustomConversion.md

@@ -0,0 +1,28 @@
+# Zernio::CustomConversion
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  | [optional] |
+| **name** | **String** |  | [optional] |
+| **rule** | **Object** | Meta's rule, parsed back from the string Meta stores. | [optional] |
+| **custom_event_type** | **String** |  | [optional] |
+| **pixel_id** | **String** | Meta's event_source_id — the pixel the rule reads from. | [optional] |
+| **is_archived** | **Boolean** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CustomConversion.new(
+  id: null,
+  name: null,
+  rule: null,
+  custom_event_type: null,
+  pixel_id: null,
+  is_archived: null
+)
+```
+

data/docs/CustomConversionResult.md

@@ -0,0 +1,24 @@
+# Zernio::CustomConversionResult
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **ad_account_id** | **String** |  | [optional] |
+| **custom_conversion_id** | **String** | Drops straight into promotedObject.customConversionId on POST /v1/ads/create. | [optional] |
+| **reused** | **Boolean** | True when an existing conversion matched name + pixelId; the response is then a 200. | [optional] |
+| **custom_conversion** | [**CustomConversion**](CustomConversion.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CustomConversionResult.new(
+  ad_account_id: null,
+  custom_conversion_id: null,
+  reused: null,
+  custom_conversion: null
+)
+```
+

data/docs/InstagramApi.md

@@ -84,7 +84,7 @@ end
 
 Get Instagram story insights
 
-Returns metrics for a single story. The `source` field discriminates between three states:  - `live` — fetched from Meta in real time (story is still active) - `cached` — fetched from a persisted `story_insights` webhook payload   (story has expired but we received its final-state metrics from Meta) - `unavailable` — story has expired and we never received its webhook   payload (for example, the account connected after the story expired)  Field semantics follow Meta's API. Counts below 5 may be returned as 0 due to Meta's privacy floor on small audiences. The `navigation` field is the sum of `tapsForward + tapsBack + exits + swipesForward`. 
+Returns metrics for a single story. The `source` field discriminates between three states:  - `live` — fetched from Meta in real time (story is still active) - `cached` — fetched from a persisted `story_insights` webhook payload   (story has expired but we received its final-state metrics from Meta) - `unavailable` — story has expired and we never received its webhook   payload (for example, the account connected after the story expired)  Meta can report an expired story as an empty successful result rather than an error, so an expired story resolves to `cached` or `unavailable` even though the upstream request itself succeeded.  Field semantics follow Meta's API. Counts below 5 may be returned as 0 due to Meta's privacy floor on small audiences. The `navigation` field is the sum of `tapsForward + tapsBack + exits + swipesForward`. 
 
 ### Examples
 

data/docs/ListCustomConversions200Response.md

@@ -0,0 +1,20 @@
+# Zernio::ListCustomConversions200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **ad_account_id** | **String** |  | [optional] |
+| **data** | [**Array<CustomConversion>**](CustomConversion.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::ListCustomConversions200Response.new(
+  ad_account_id: null,
+  data: null
+)
+```
+