zernio-sdk 0.0.125 → 0.0.521

data/docs/CreateStandaloneAdRequest.md

@@ -1,4 +1,4 @@
-# Late::CreateStandaloneAdRequest
+# Zernio::CreateStandaloneAdRequest
 
 ## Properties
 
@@ -7,60 +7,152 @@
 | **account_id** | **String** |  |  |
 | **ad_account_id** | **String** |  |  |
 | **name** | **String** |  |  |
-| **goal** | **String** |  |  |
-| **budget_amount** | **Float** |  |  |
-| **budget_type** | **String** |  |  |
+| **campaign_name** | **String** | Meta only. Exact campaign name. Overrides the default `<name> - Campaign`. | [optional] |
+| **ad_set_name** | **String** | Meta only. Exact ad set name. Overrides the default `<name> - Ad Set`. (For per-ad names on the multi-creative shape, set `name` on each `creatives[]` entry.) | [optional] |
+| **ad_name** | **String** | Meta only. Exact ad name (the single-creative ad object's name). Overrides the default, which is `name`. (For per-ad names on the multi-creative shape, set `name` on each `creatives[]` entry instead.) | [optional] |
+| **tracking** | [**CreateStandaloneAdRequestTracking**](CreateStandaloneAdRequestTracking.md) |  | [optional] |
+| **goal** | **String** | Required on legacy and multi-creative shapes; the attach shape inherits it from the ad set. Available goals vary by platform.  **Meta** - `conversions`: OUTCOME_SALES. Requires `promotedObject.pixelId` and `promotedObject.customEventType` with a commerce event such as PURCHASE or START_TRIAL. - `lead_conversion`: OUTCOME_LEADS optimizing website pixel leads. Same pixel and event fields, but with a leads-class event such as LEAD, SUBMIT_APPLICATION, SCHEDULE or CONTACT. Meta gates conversion events by objective, so leads-class events are rejected under `conversions`. - `lead_generation`: OUTCOME_LEADS with instant forms. Requires `leadGenFormId`. `promotedObject.pageId` is optional and auto-filled from the connected Page. - `app_promotion`: requires `promotedObject.applicationId` and `promotedObject.objectStoreUrl`. - `catalog_sales`: Advantage+ catalog ads, for example vehicle inventory. Requires `promotedObject.productSetId`, `promotedObject.pixelId` and `promotedObject.customEventType`. Builds a catalog TEMPLATE creative from the copy fields, which may carry template tags like {{product.name}} or {{vehicle.make}}. No imageUrl or video is sent; Meta renders the visuals per catalog item. Discover catalogs via GET /v1/ads/catalogs and product sets via GET /v1/ads/catalogs/{catalogId}/product-sets. Single shape only, no creatives[], adSetId, dynamicCreative or placementAssets.  **TikTok** - `conversions`: website-conversion ad group. Requires `promotedObject.pixelId`, your TikTok Pixel ID. Accepts an optional `promotedObject.customEventType` with a TikTok optimization_event code your pixel tracks (newer pixels use e.g. SHOPPING for purchase events; legacy pixels use ON_WEB_ORDER, INITIATE_ORDER, ON_WEB_REGISTER or FORM). To inherit pixel and event from an existing ad group, pass `adSetId` instead.  **LinkedIn** - `engagement`, `traffic`, `awareness` and `video_views` create standalone Direct Sponsored Content ads. `traffic` requires `linkUrl`; `video_views` requires `video`. - `job_applicants` requires a `platformSpecificData.jobs` creative. - For `lead_generation` or `conversions` on LinkedIn, or to promote an existing post, use POST /v1/ads/boost.  | [optional] |
+| **optimization_goal** | **String** | Meta only. Explicit ad-set `optimization_goal` (e.g. `LANDING_PAGE_VIEWS`, `LINK_CLICKS`, `REACH`, `IMPRESSIONS`, `OFFSITE_CONVERSIONS`, `THRUPLAY`, `LEAD_GENERATION`). Overrides the default derived from `goal` (e.g. `traffic` defaults to `LINK_CLICKS`). Forwarded verbatim to Meta, which validates compatibility with the campaign objective and rejects incompatible combinations. | [optional] |
+| **billing_event** | **String** | Meta only. Explicit ad-set `billing_event`. Defaults to `IMPRESSIONS`. Forwarded verbatim to Meta, which validates compatibility with the optimization goal. | [optional] |
+| **budget_amount** | **Float** | Required on legacy + multi-creative shapes. Inherited on attach. | [optional] |
+| **budget_type** | **String** | Required on legacy + multi-creative shapes. Inherited on attach. | [optional] |
+| **status** | **String** | Meta only. Publish state of the created ad set + ad. Omitted or ACTIVE publishes live (default, back-compat); PAUSED creates them paused and skips activation, so you can review before they spend. | [optional] |
+| **budget_level** | **String** | Meta only. Where the budget lives, which selects the Meta budget model:   - `adset` (default): ABO (Ad-set Budget Optimization). The budget is set on the     ad set. This is the back-compatible behaviour — omit this field to keep it.   - `campaign`: CBO (Campaign Budget Optimization / Advantage Campaign Budget). The     budget AND `bidStrategy` are set on the CAMPAIGN, and Meta distributes spend     across ad sets automatically. Meta requires the budget at exactly one level, never both. Non-Meta platforms ignore this field. Ignored on the attach shape (`adSetId`), which inherits the existing budget.  | [optional][default to 'adset'] |
 | **currency** | **String** |  | [optional] |
-| **headline** | **String** | Required for most platforms. Max: Meta=255, Google=30, Pinterest=100 | [optional] |
-| **long_headline** | **String** | Google Display only | [optional] |
-| **body** | **String** | Max: Google=90, Pinterest=500 |  |
-| **call_to_action** | **String** | Meta only | [optional] |
-| **link_url** | **String** |  | [optional] |
-| **image_url** | **String** | Image URL (or video URL for TikTok). Not required for Google Search campaigns. | [optional] |
+| **headline** | **String** | Required for Meta, Google, Pinterest, and LinkedIn on legacy + attach shapes (skip for multi-creative — use `creatives[].headline`). Ignored for TikTok and X/Twitter. Max: Meta=255, Google=30, Pinterest=100, LinkedIn=400. On LinkedIn this is the ad's headline (the bold text on the creative); for traffic ads it's the link card title. | [optional] |
+| **long_headline** | **String** | Google Display only — defaults to `headline` if omitted. On LinkedIn, reused as the optional secondary description text on traffic (link) ads; omitted if not provided. | [optional] |
+| **body** | **String** | Required on legacy + attach shapes. For X/Twitter this is the tweet text (max 280 chars including a ~24-char URL when `linkUrl` is set). On LinkedIn this is the post commentary (the intro text shown above the ad). Max: Google=90, Pinterest=500. | [optional] |
+| **description** | **String** | Meta only (facebook/instagram). Link description — the secondary text shown below the headline (Meta's link_data.description; on video creatives mapped to video_data.link_description). When omitted, Meta auto-pulls the destination URL's OpenGraph description. Applies on legacy, attach, and placementAssets shapes; for multi-creative use creatives[].description (this field is the shared fallback). For multi-text variations use dynamicCreative.descriptions instead. | [optional] |
+| **call_to_action** | **String** | Required on legacy + attach shapes for Meta. Honoured on TikTok (passes through to the Spark Ad creative's `call_to_action`) and on LinkedIn (the CTA button on the ad; defaults to LEARN_MORE when `linkUrl` is set). LinkedIn accepts: LEARN_MORE, SIGN_UP, DOWNLOAD, SUBSCRIBE, REGISTER, JOIN, ATTEND, REQUEST_DEMO, VIEW_QUOTE, APPLY, SEE_MORE, SHOP_NOW, BUY_NOW. Ignored by Google, Pinterest, and X/Twitter. | [optional] |
+| **link_url** | **String** | Required on legacy + attach shapes (skip for multi-creative). On LinkedIn it's the ad's destination URL; required for `traffic` ads, optional for `engagement` / `awareness`. NOT required when `goal` is `lead_generation` (the ad opens a Lead Gen form instead of a destination). On LinkedIn, `imageUrl` + `linkUrl` publishes an ARTICLE-content creative; this is LinkedIn's article ad format, with the image as thumbnail and `longHeadline` as description. | [optional] |
+| **lead_gen_form_id** | **String** | Meta Lead Gen forms only (facebook/instagram). The leadgen_forms ID to attach to the ad's creative — create one via POST /v1/ads/lead-forms. REQUIRED when `goal` is `lead_generation`, and on every ATTACH (`adSetId`) call that targets a lead ad set (the form attaches per-ad; Meta rejects a formless ad in a lead ad set). Ignored otherwise. The ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on instant-form lead ads — the form is attached for you, and for `dynamicCreative` the ad set is created as a Dynamic Creative ad set automatically (Meta requires that for any multi-text feed; there is no non-DCO multi-text path). Send a single `imageUrls` entry plus your text variations to get Meta's \"Multiple Text Options\" behavior on a lead ad. | [optional] |
+| **image_url** | **String** | Image creative for Meta/Google/Pinterest/LinkedIn on legacy + attach shapes (mutually exclusive with `video`). Required for LinkedIn ads unless `video` is set. Not required for Google Search campaigns. For TikTok, this field carries the VIDEO URL (the TikTok ads endpoint is video-only; the field retains the `imageUrl` name for cross-platform consistency). Ignored for X/Twitter. For Google Display, treated as the landscape image (alias of `images.landscape`); supply `images.square` alongside or the request is rejected. For LinkedIn the image is uploaded to LinkedIn under the authoring Company Page (see `organizationId`); recommended ratio 1.91:1 (e.g. 1200×627). | [optional] |
+| **images** | [**CreateStandaloneAdRequestImages**](CreateStandaloneAdRequestImages.md) |  | [optional] |
+| **video** | [**CreateStandaloneAdRequestVideo**](CreateStandaloneAdRequestVideo.md) |  | [optional] |
+| **creatives** | [**Array<CreateStandaloneAdRequestCreativesInner>**](CreateStandaloneAdRequestCreativesInner.md) | Meta-only. When present, switches to the multi-creative shape: creates 1 campaign + 1 ad set + N ads (one per entry here). Top-level `headline` / `body` / `imageUrl` / `linkUrl` / `callToAction` are ignored in this mode. Mutually exclusive with `adSetId`.  | [optional] |
+| **ad_set_id** | **String** | Meta-only. When present, switches to the attach shape: adds one new ad to this existing ad set without creating a new campaign. Budget, targeting, goal, schedule, AND bid strategy are inherited from the ad set on Meta — passing `bidStrategy` in attach mode returns 400. To change an existing ad set's bid, use `PUT /v1/ads/ad-sets/{adSetId}`. Mutually exclusive with `creatives[]`.  The attached ad takes the full single-creative surface: `headline`/`body`/`description`/`callToAction` plus either `imageUrl`/`video` OR `placementAssets` (its own per-placement Feed/Story assets), and `leadGenFormId` when the target is a lead ad set (the parent must be ON_AD — true for ad sets created via goal `lead_generation`; Meta rejects a formless ad there, so pass the form on EVERY attached ad). This is the way to build N full ads sharing one ad set: create the first ad via the normal shape, then attach the rest one call each.  Supported on Meta (facebook, instagram), TikTok, and LinkedIn. On TikTok the `adSetId` is the ad group ID; the new ad inherits the ad group's bid + budget + targeting. On LinkedIn the `adSetId` is the LinkedIn Campaign ID (numeric); we attach a new Creative to that Campaign, so the Campaign's `platformSpecificData` bidding, targeting, budget and schedule are inherited (passing those fields returns 400).  | [optional] |
+| **existing_campaign_id** | **String** | Meta + LinkedIn. On Meta: add the new ad set under this EXISTING campaign instead of creating a new one (multi-ad-set audience testing). The new ad set's budget is matched to the campaign's mode automatically: for a CBO campaign (campaign-level budget) omit `budgetAmount`/`budgetType` — the campaign owns the budget; for an ABO campaign pass them (they go on the new ad set). On LinkedIn: create a new Campaign (and its Creative) under this EXISTING CampaignGroup. On failure only the entities we authored are cleaned up; the pre-existing parent is left untouched and is never (re)activated. Mutually exclusive with `adSetId` and `creatives[]`.  | [optional] |
+| **existing_creative_id** | **String** | Meta only. Reuse an EXISTING ad creative by id instead of building a new one from the copy/media fields (which are then ignored). Combine with `existingCampaignId` to build a multi-ad-set campaign that shares one creative. Mutually exclusive with `creatives[]`, `dynamicCreative`, and `placementAssets`. The creative id used is returned as `creativeId` on the create response.  | [optional] |
 | **business_name** | **String** | Google Display only | [optional] |
 | **board_id** | **String** | Pinterest only. Board ID (auto-creates if not provided). | [optional] |
-| **countries** | **Array<String>** |  | [optional] |
+| **organization_id** | **String** | LinkedIn only. The Company Page that authors the Direct Sponsored Content (\"dark\") post backing the ad — accepts a numeric organization ID or a full `urn:li:organization:N` URN. Required unless the resolved `accountId` is a connected LinkedIn Company-Page account (defaults to that page) or the LinkedIn ad account is org-owned (defaults to the account's owning organization). The authenticated member must be an ADMINISTRATOR or DIRECT_SPONSORED_CONTENT_POSTER of this page (and the page must be associated with the ad account), or LinkedIn returns 403. Ignored by every other platform. | [optional] |
+| **targeting** | [**TargetingSpec**](TargetingSpec.md) | Nested targeting object — the same TargetingSpec shape as `POST /v1/ads/boost`, `POST /v1/ads/targeting/reach-estimate`, and `saved_targeting` audiences. Merged UNDER the flat inline targeting fields below: `savedTargetingId` < `targeting` < flat fields (a flat field present on the body replaces the nested value entirely). Both forms are equivalent; use whichever your integration already builds.  | [optional] |
+| **countries** | **Array<String>** | ISO 3166-1 alpha-2 country codes (e.g. ['NL']). Defaults to ['US'] when no other geo targeting (flat or nested `targeting`) is provided. (LinkedIn currently honours country-level targeting only.) | [optional] |
+| **cities** | [**Array<CreateStandaloneAdRequestCitiesInner>**](CreateStandaloneAdRequestCitiesInner.md) | Meta-only. City-level geo targeting. Each city is targeted by Meta's opaque `key` (the city ID) which can be looked up via `GET /v1/ads/targeting/search?type=city&q=<name>&country_code=<ISO>`. Optional `radius` + `distance_unit` extend the targeting beyond the city limits (e.g. radius 25 km around the city center). Both must be set together, or both omitted (Meta defaults to ~16 km when omitted).  Cannot overlap with the same country in `countries` (Meta returns a \"locations overlap\" error). Either drop the country or scope it to a different country.  | [optional] |
+| **regions** | [**Array<CreateStandaloneAdRequestRegionsInner>**](CreateStandaloneAdRequestRegionsInner.md) | Meta-only. Region-level (state/province) geo targeting. Each region is targeted by Meta's opaque `key` (the region ID) which can be looked up via `GET /v1/ads/targeting/search?type=region&q=<name>&country_code=<ISO>`.  | [optional] |
 | **age_min** | **Integer** |  | [optional] |
 | **age_max** | **Integer** |  | [optional] |
-| **interests** | **Array<String>** |  | [optional] |
+| **interests** | [**Array<UpdateAdRequestTargetingInterestsInner>**](UpdateAdRequestTargetingInterestsInner.md) | Interest objects from /v1/ads/interests. Each must include id and name. | [optional] |
+| **zips** | [**Array<BoostPostRequestTargetingRegionsInner>**](BoostPostRequestTargetingRegionsInner.md) | Postal/ZIP geo targeting. `key` is the platform's postal location ID from /v1/ads/targeting/search?dimension=geo&geoType=zip. Supported on Meta, Google, TikTok, Pinterest, X. | [optional] |
+| **metros** | [**Array<BoostPostRequestTargetingRegionsInner>**](BoostPostRequestTargetingRegionsInner.md) | DMA / metro-area geo targeting. `key` is the platform's metro ID from /v1/ads/targeting/search?dimension=geo&geoType=metro. | [optional] |
+| **custom_locations** | [**Array<CreateStandaloneAdRequestCustomLocationsInner>**](CreateStandaloneAdRequestCustomLocationsInner.md) | Point-radius (lat/lng) geo targeting. Meta only (custom_locations). Rejected on platforms without radius support. | [optional] |
+| **behaviors** | [**Array<CreateStandaloneAdRequestBehaviorsInner>**](CreateStandaloneAdRequestBehaviorsInner.md) | Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta and TikTok. Each must include id. | [optional] |
+| **income_tier** | **String** | Normalized household-income tier. Meta and TikTok express all four; Google maps only `top_10`; rejected on LinkedIn, X, and Pinterest. On Meta, income targeting is incompatible with housing/employment/credit `specialAdCategories`.  | [optional] |
+| **languages** | **Array<String>** | Language codes restricting the audience by language. On Meta, ISO 639-1 codes (e.g. ['en'], ['de']); a bare code targets all regional variants (\"en\" = all English), or use a region-qualified code for a specific one (\"en_GB\", \"pt_BR\", \"zh_TW\"). Unknown codes are rejected. Other ad platforms use their own language-code systems. | [optional] |
+| **placements** | [**CreateStandaloneAdRequestPlacements**](CreateStandaloneAdRequestPlacements.md) |  | [optional] |
+| **saved_targeting_id** | **String** | ID of a `saved_targeting` audience (created via POST /v1/ads/audiences). When set, its stored TargetingSpec is expanded as the base targeting; inline fields on this body merge on top. Lets you reuse a named targeting preset without re-sending every field.  | [optional] |
+| **raw_targeting** | **Hash<String, Object>** | Meta only. A raw Meta-native targeting spec passed to the ad set VERBATIM (snake_case: `geo_locations`, `age_min`, `excluded_custom_audiences`, `flexible_spec`, `targeting_automation`, business places, etc.) — exactly the shape `GET /v1/ads/{adId}` returns for external ads. Use it to clone a campaign's targeting EXACTLY, preserving advanced fields the camelCase targeting fields can't model. Mutually exclusive with the camelCase targeting fields (countries/regions/cities/interests/ ageMin/...), `audienceId`, and `savedTargetingId` (sending both → 422). Sent as-is; Meta validates and surfaces any errors. If cloning an EU campaign, also pass `dsaBeneficiary` / `dsaPayor` (those are separate fields, not part of targeting).  | [optional] |
+| **special_ad_categories** | **Array<String>** | Meta only. Declares the ad's special category, required for housing, employment, credit, or political/social-issue ads (Meta enforces restricted targeting for these). Note: setting a special category disables income/zip targeting on Meta.  | [optional] |
 | **end_date** | **Time** | Required for lifetime budgets | [optional] |
+| **start_date** | **Time** | Meta only. Ad-set start time (ISO 8601, e.g. \"2026-06-10T09:00:00Z\"), mapped to the ad set's `start_time`. When omitted the ad starts delivering immediately. For lifetime budgets Meta also requires `endDate`. (Same `schedule.startDate` semantics already available on `POST /v1/ads/boost`.)  | [optional] |
+| **instagram_account_id** | **String** | Meta only. Override the Instagram account the ad is delivered as — pass an Instagram Business Account ID (e.g. 17841...), mapped to the creative's `instagram_user_id`. When omitted we auto-resolve the IG account linked to the connected Facebook Page (the existing default). Useful when a Page has more than one eligible IG account.  | [optional] |
+| **dynamic_creative** | [**CreateStandaloneAdRequestDynamicCreative**](CreateStandaloneAdRequestDynamicCreative.md) |  | [optional] |
+| **placement_assets** | [**CreateStandaloneAdRequestPlacementAssets**](CreateStandaloneAdRequestPlacementAssets.md) |  | [optional] |
 | **audience_id** | **String** | Custom audience ID for targeting | [optional] |
 | **campaign_type** | **String** | Google only | [optional][default to 'display'] |
 | **keywords** | **Array<String>** | Google Search only | [optional] |
 | **additional_headlines** | **Array<String>** | Google Search RSA only. Extra headlines. | [optional] |
 | **additional_descriptions** | **Array<String>** | Google Search RSA only. Extra descriptions. | [optional] |
+| **advantage_audience** | **Integer** | Meta only. Controls the Advantage audience feature (targeting_automation). 0 = disabled (default), 1 = enabled. Meta Marketing API requires this field on all ad set creation requests. | [optional] |
+| **attribution_spec** | [**Array<CreateStandaloneAdRequestAttributionSpecInner>**](CreateStandaloneAdRequestAttributionSpecInner.md) | Meta only. Conversion attribution window for the ad set — maps 1:1 to Meta's ad-set `attribution_spec`. Only honored for conversion goals (`conversions`, `lead_generation`, `app_promotion`); ignored for awareness/traffic/engagement. Omit to use Meta's default (`7-day click` + `1-day view`). Meta enforces the valid combinations: `VIEW_THROUGH` only allows `windowDays: 1` (7d/28d view windows were removed Jan 2026); `ENGAGED_VIDEO_VIEW` only `1` and only alongside `VIEW_THROUGH: 1`; `CLICK_THROUGH: 28` only on certain objectives. Invalid combos surface as a Meta 400. Example: `[{ \"eventType\": \"CLICK_THROUGH\", \"windowDays\": 7 }, { \"eventType\": \"VIEW_THROUGH\", \"windowDays\": 1 }]`  | [optional] |
+| **gender** | **String** | Meta only. Restrict the audience by gender. 'male' targets men only, 'female' targets women only, 'all' (default) targets everyone. Ignored by non-Meta platforms. | [optional][default to 'all'] |
+| **bid_strategy** | [**BidStrategy**](BidStrategy.md) | Meta bid strategy applied to the ad set. | [optional] |
+| **bid_amount** | **Float** | Bid cap in WHOLE currency units (USD: 5 = $5.00; JPY: 100 = ¥100). Required when `bidStrategy` is `LOWEST_COST_WITH_BID_CAP` or `COST_CAP`.  | [optional] |
+| **roas_average_floor** | **Float** | Minimum ROAS as a decimal multiplier (e.g. 2.0 = 2.0x ROAS). Required when `bidStrategy` is `LOWEST_COST_WITH_MIN_ROAS`. Sent to Meta as `bid_constraints.roas_average_floor` × 10000.  | [optional] |
+| **platform_specific_data** | [**LinkedInAdsPlatformData**](LinkedInAdsPlatformData.md) |  | [optional] |
+| **dsa_beneficiary** | **String** | Legal entity that benefits from the ad. Required when targeting EU users (EU DSA, Article 26). Optional if the ad account has a default beneficiary: set it once via `PATCH /v1/ads/accounts` or in Meta Ads Manager, and Meta fills it in whenever the field is omitted.  | [optional] |
+| **dsa_payor** | **String** | Legal entity that pays for the ad. Can differ from `dsaBeneficiary` (for example, an agency paying for a client's ads). Same rules as `dsaBeneficiary`: required for EU targeting unless the ad account has a default payor.  | [optional] |
+| **brand_identity** | [**CreateStandaloneAdRequestBrandIdentity**](CreateStandaloneAdRequestBrandIdentity.md) |  | [optional] |
+| **identity_type** | **String** | TikTok only. Forces the identity attribution on the ad:    - `TT_USER`: the posting account's open_id (real @username     branding). Requires a connected TikTok posting account     on the same profile.   - `CUSTOMIZED_USER`: synthetic Brand Identity (display     name + avatar). Requires a configured Brand Identity     (cached on the `tiktokads` SocialAccount via     `PATCH /v1/connect/tiktok-ads`) or an inline     `brandIdentity` to create one on the fly.  When omitted, defaults to `TT_USER` if a posting account is connected on this profile, else `CUSTOMIZED_USER`. Spark Ads (`POST /v1/ads/boost`) always use `TT_USER` regardless of this field — TikTok requires the original organic post's author identity for Spark.  | [optional] |
+| **promoted_object** | [**CreateStandaloneAdRequestPromotedObject**](CreateStandaloneAdRequestPromotedObject.md) |  | [optional] |
 
 ## Example
 
 ```ruby
-require 'late-sdk'
+require 'zernio-sdk'
 
-instance = Late::CreateStandaloneAdRequest.new(
+instance = Zernio::CreateStandaloneAdRequest.new(
   account_id: null,
   ad_account_id: null,
   name: null,
+  campaign_name: null,
+  ad_set_name: null,
+  ad_name: null,
+  tracking: null,
   goal: null,
+  optimization_goal: null,
+  billing_event: null,
   budget_amount: null,
   budget_type: null,
+  status: null,
+  budget_level: null,
   currency: null,
   headline: null,
   long_headline: null,
   body: null,
+  description: null,
   call_to_action: null,
   link_url: null,
+  lead_gen_form_id: null,
   image_url: null,
+  images: null,
+  video: null,
+  creatives: null,
+  ad_set_id: null,
+  existing_campaign_id: null,
+  existing_creative_id: null,
   business_name: null,
   board_id: null,
+  organization_id: null,
+  targeting: null,
   countries: null,
+  cities: null,
+  regions: null,
   age_min: null,
   age_max: null,
   interests: null,
+  zips: null,
+  metros: null,
+  custom_locations: null,
+  behaviors: null,
+  income_tier: null,
+  languages: null,
+  placements: null,
+  saved_targeting_id: null,
+  raw_targeting: null,
+  special_ad_categories: null,
   end_date: null,
+  start_date: null,
+  instagram_account_id: null,
+  dynamic_creative: null,
+  placement_assets: null,
   audience_id: null,
   campaign_type: null,
   keywords: null,
   additional_headlines: null,
-  additional_descriptions: null
+  additional_descriptions: null,
+  advantage_audience: null,
+  attribution_spec: null,
+  gender: null,
+  bid_strategy: null,
+  bid_amount: null,
+  roas_average_floor: null,
+  platform_specific_data: null,
+  dsa_beneficiary: null,
+  dsa_payor: null,
+  brand_identity: null,
+  identity_type: null,
+  promoted_object: null
 )
 ```
 

data/docs/CreateStandaloneAdRequestAttributionSpecInner.md

@@ -0,0 +1,20 @@
+# Zernio::CreateStandaloneAdRequestAttributionSpecInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **event_type** | **String** |  |  |
+| **window_days** | **Integer** |  |  |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateStandaloneAdRequestAttributionSpecInner.new(
+  event_type: null,
+  window_days: null
+)
+```
+

data/docs/CreateStandaloneAdRequestBehaviorsInner.md

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

data/docs/CreateStandaloneAdRequestBrandIdentity.md

@@ -0,0 +1,20 @@
+# Zernio::CreateStandaloneAdRequestBrandIdentity
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **display_name** | **String** | Brand name shown above the ad on TikTok. |  |
+| **image_url** | **String** | Public URL of a square brand image (≥98×98 px, JPG/PNG). Used as the brand avatar on the ad. |  |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateStandaloneAdRequestBrandIdentity.new(
+  display_name: null,
+  image_url: null
+)
+```
+

data/docs/CreateStandaloneAdRequestCitiesInner.md

@@ -0,0 +1,22 @@
+# Zernio::CreateStandaloneAdRequestCitiesInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **key** | **String** | Meta city ID, from /v1/ads/targeting/search results. |  |
+| **radius** | **Float** | Optional radius around the city. Must be set together with distance_unit. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng). | [optional] |
+| **distance_unit** | **String** | Unit for radius. Required if radius is set. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateStandaloneAdRequestCitiesInner.new(
+  key: null,
+  radius: null,
+  distance_unit: null
+)
+```
+

data/docs/CreateStandaloneAdRequestCreativesInner.md

@@ -0,0 +1,32 @@
+# Zernio::CreateStandaloneAdRequestCreativesInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **name** | **String** | Exact name for this ad. Falls back to `<name> #N` (N = 1-based position). | [optional] |
+| **headline** | **String** |  |  |
+| **body** | **String** |  |  |
+| **description** | **String** | Link description for this ad (link_data.description; video creatives: video_data.link_description). Falls back to the top-level `description`; when both are omitted Meta scrapes the destination URL's OG description. | [optional] |
+| **image_url** | **String** | Image creative. Mutually exclusive with `video`. | [optional] |
+| **video** | [**CreateStandaloneAdRequestCreativesInnerVideo**](CreateStandaloneAdRequestCreativesInnerVideo.md) |  | [optional] |
+| **link_url** | **String** |  |  |
+| **call_to_action** | **String** |  |  |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateStandaloneAdRequestCreativesInner.new(
+  name: null,
+  headline: null,
+  body: null,
+  description: null,
+  image_url: null,
+  video: null,
+  link_url: null,
+  call_to_action: null
+)
+```
+

data/docs/CreateStandaloneAdRequestCreativesInnerVideo.md

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

data/docs/CreateStandaloneAdRequestCustomLocationsInner.md

@@ -0,0 +1,28 @@
+# Zernio::CreateStandaloneAdRequestCustomLocationsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **latitude** | **Float** |  |  |
+| **longitude** | **Float** |  |  |
+| **radius** | **Float** |  |  |
+| **distance_unit** | **String** |  |  |
+| **name** | **String** |  | [optional] |
+| **address** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateStandaloneAdRequestCustomLocationsInner.new(
+  latitude: null,
+  longitude: null,
+  radius: null,
+  distance_unit: null,
+  name: null,
+  address: null
+)
+```
+

data/docs/CreateStandaloneAdRequestDynamicCreative.md

@@ -0,0 +1,30 @@
+# Zernio::CreateStandaloneAdRequestDynamicCreative
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **image_urls** | **Array<String>** | Pool of image URLs (1-10). Uploaded to the ad account and referenced by hash in the asset feed. |  |
+| **bodies** | **Array<String>** | Primary-text variations (the body copy). | [optional] |
+| **titles** | **Array<String>** | Headline variations. | [optional] |
+| **descriptions** | **Array<String>** | Description (link caption) variations. | [optional] |
+| **link_urls** | **Array<String>** | Destination URL variations. At least one is required unless `goal` is `lead_generation`. | [optional] |
+| **call_to_action_types** | **Array<String>** | CTA-button variations. Required. | [optional] |
+| **ad_format** | **String** | Asset-feed ad format. Defaults to SINGLE_IMAGE. | [optional][default to 'SINGLE_IMAGE'] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateStandaloneAdRequestDynamicCreative.new(
+  image_urls: null,
+  bodies: null,
+  titles: null,
+  descriptions: null,
+  link_urls: null,
+  call_to_action_types: null,
+  ad_format: null
+)
+```
+

data/docs/CreateStandaloneAdRequestImages.md

@@ -0,0 +1,20 @@
+# Zernio::CreateStandaloneAdRequestImages
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **landscape** | **String** | Landscape 1.91:1 marketing image URL (e.g. 1200x628). Also accepted via the top-level `imageUrl` for backward compatibility. | [optional] |
+| **square** | **String** | Square 1:1 marketing image URL (e.g. 1080x1080). Required for Google Display. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateStandaloneAdRequestImages.new(
+  landscape: null,
+  square: null
+)
+```
+

data/docs/CreateStandaloneAdRequestPlacementAssets.md

@@ -0,0 +1,24 @@
+# Zernio::CreateStandaloneAdRequestPlacementAssets
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **default_image_url** | **String** | Image mode. Catch-all image for any placement no rule matches. Required in image mode (Meta mandates a default rule). | [optional] |
+| **default_video_url** | **String** | Video mode. Catch-all video for any placement no rule matches. Required in video mode. | [optional] |
+| **default_thumbnail_url** | **String** | Video mode (optional). Poster image for the default video; Meta auto-generates one when omitted. | [optional] |
+| **rules** | [**Array<CreateStandaloneAdRequestPlacementAssetsRulesInner>**](CreateStandaloneAdRequestPlacementAssetsRulesInner.md) | One entry per placement group you want to pin a specific asset to. |  |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateStandaloneAdRequestPlacementAssets.new(
+  default_image_url: null,
+  default_video_url: null,
+  default_thumbnail_url: null,
+  rules: null
+)
+```
+

data/docs/CreateStandaloneAdRequestPlacementAssetsRulesInner.md

@@ -0,0 +1,24 @@
+# Zernio::CreateStandaloneAdRequestPlacementAssetsRulesInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **image_url** | **String** | Image mode. The image to deliver for this rule's placements. | [optional] |
+| **video_url** | **String** | Video mode. The video to deliver for this rule's placements. | [optional] |
+| **thumbnail_url** | **String** | Video mode (optional). Poster image for this rule's video; auto-generated when omitted. | [optional] |
+| **placements** | [**CreateStandaloneAdRequestPlacementAssetsRulesInnerPlacements**](CreateStandaloneAdRequestPlacementAssetsRulesInnerPlacements.md) |  |  |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateStandaloneAdRequestPlacementAssetsRulesInner.new(
+  image_url: null,
+  video_url: null,
+  thumbnail_url: null,
+  placements: null
+)
+```
+

data/docs/CreateStandaloneAdRequestPlacementAssetsRulesInnerPlacements.md

@@ -0,0 +1,32 @@
+# Zernio::CreateStandaloneAdRequestPlacementAssetsRulesInnerPlacements
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **publisher_platforms** | **Array<String>** |  | [optional] |
+| **facebook_positions** | **Array<String>** |  | [optional] |
+| **instagram_positions** | **Array<String>** |  | [optional] |
+| **messenger_positions** | **Array<String>** |  | [optional] |
+| **audience_network_positions** | **Array<String>** |  | [optional] |
+| **threads_positions** | **Array<String>** |  | [optional] |
+| **whatsapp_positions** | **Array<String>** |  | [optional] |
+| **device_platforms** | **Array<String>** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateStandaloneAdRequestPlacementAssetsRulesInnerPlacements.new(
+  publisher_platforms: null,
+  facebook_positions: null,
+  instagram_positions: null,
+  messenger_positions: null,
+  audience_network_positions: null,
+  threads_positions: null,
+  whatsapp_positions: null,
+  device_platforms: null
+)
+```
+

data/docs/CreateStandaloneAdRequestPlacements.md

@@ -0,0 +1,32 @@
+# Zernio::CreateStandaloneAdRequestPlacements
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **publisher_platforms** | **Array<String>** | Top-level platforms to deliver on. A position field below is only honoured when its parent platform is included here. | [optional] |
+| **facebook_positions** | **Array<String>** |  | [optional] |
+| **instagram_positions** | **Array<String>** |  | [optional] |
+| **messenger_positions** | **Array<String>** |  | [optional] |
+| **audience_network_positions** | **Array<String>** |  | [optional] |
+| **threads_positions** | **Array<String>** |  | [optional] |
+| **whatsapp_positions** | **Array<String>** |  | [optional] |
+| **device_platforms** | **Array<String>** | Restrict by device. Omit to deliver on both mobile and desktop. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateStandaloneAdRequestPlacements.new(
+  publisher_platforms: null,
+  facebook_positions: null,
+  instagram_positions: null,
+  messenger_positions: null,
+  audience_network_positions: null,
+  threads_positions: null,
+  whatsapp_positions: null,
+  device_platforms: null
+)
+```
+

data/docs/CreateStandaloneAdRequestPromotedObject.md

@@ -0,0 +1,32 @@
+# Zernio::CreateStandaloneAdRequestPromotedObject
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **pixel_id** | **String** | Pixel ID. **Meta:** Facebook Pixel ID, required for `goal: conversions`. **TikTok:** TikTok Pixel ID, required for `goal: conversions`.  | [optional] |
+| **custom_event_type** | **String** | The event the campaign/ad group optimises against.  **Meta:** standard event like `PURCHASE`, `LEAD`, `COMPLETE_REGISTRATION`, `ADD_TO_CART`. Uppercased internally so callers can pass any case. Required for `goal: conversions`.  **TikTok:** an `optimization_event` code (UPPER_SNAKE, not Meta's vocabulary and not PascalCase). Must be one of the event types your TikTok Pixel is configured to track; passed through verbatim and validated by TikTok. Newer pixels (Events API / funnel-template setups) use TikTok's updated taxonomy, e.g. `SHOPPING` for purchase/payment events; legacy pixels use codes like `ON_WEB_ORDER` (Complete Payment), `INITIATE_ORDER` (Place an Order), `ON_WEB_CART` (Add to Cart), `ON_WEB_REGISTER` (Complete Registration), `FORM` (Submit Form), `ON_WEB_DETAIL` (View Content). On rejection the error lists the event types your pixel actually tracks. Optional for `goal: conversions`.  | [optional] |
+| **page_id** | **String** | Facebook Page ID. Used by `goal: lead_generation`. Auto-filled from the connected Page when omitted.  | [optional] |
+| **application_id** | **String** | App ID. Required for `goal: app_promotion`. | [optional] |
+| **object_store_url** | **String** | App Store / Play Store listing URL. Required for `goal: app_promotion`. | [optional] |
+| **custom_conversion_id** | **String** | Custom Conversion ID, when optimising against one instead of a standard event. | [optional] |
+| **product_catalog_id** | **String** | Catalog ID for catalog/Advantage+ Shopping campaigns. | [optional] |
+| **product_set_id** | **String** | Product Set ID inside the catalog. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateStandaloneAdRequestPromotedObject.new(
+  pixel_id: null,
+  custom_event_type: null,
+  page_id: null,
+  application_id: null,
+  object_store_url: null,
+  custom_conversion_id: null,
+  product_catalog_id: null,
+  product_set_id: null
+)
+```
+

data/docs/CreateStandaloneAdRequestRegionsInner.md

@@ -0,0 +1,18 @@
+# Zernio::CreateStandaloneAdRequestRegionsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **key** | **String** | Meta region ID, from /v1/ads/targeting/search results. |  |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateStandaloneAdRequestRegionsInner.new(
+  key: null
+)
+```
+

data/docs/CreateStandaloneAdRequestTracking.md

@@ -0,0 +1,20 @@
+# Zernio::CreateStandaloneAdRequestTracking
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **pixel_id** | **String** | Meta Pixel ID to attach for offsite-conversion measurement. | [optional] |
+| **url_tags** | [**Array<UpdateAdTrackingTagsRequestUrlTagsInner>**](UpdateAdTrackingTagsRequestUrlTagsInner.md) | Click-URL params appended to the ad's destination as `url_tags` (e.g. utm_source). | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateStandaloneAdRequestTracking.new(
+  pixel_id: null,
+  url_tags: null
+)
+```
+

data/docs/CreateStandaloneAdRequestVideo.md

@@ -0,0 +1,20 @@
+# Zernio::CreateStandaloneAdRequestVideo
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **url** | **String** | Public URL of the video. Meta: uploaded via chunked transfer on /act_X/advideos, then the request blocks on Meta's transcoding until status.video_status === 'ready'. LinkedIn: uploaded via the Videos API (multipart), then the request blocks until LinkedIn finishes transcoding (status AVAILABLE) — short clips take ~10-30s. |  |
+| **thumbnail_url** | **String** | Public URL of a still-image thumbnail for the video. OPTIONAL: when omitted on Meta, the poster is auto-generated from Meta's own preferred video thumbnail (the same candidates Ads Manager shows), so video ads publish without supplying one. Provide it to control the poster frame exactly (uploaded as an ad image and referenced in object_story_spec.video_data). Ignored by LinkedIn (auto-generated poster frame). | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateStandaloneAdRequestVideo.new(
+  url: null,
+  thumbnail_url: null
+)
+```
+