@zernio/node 0.2.1070 → 0.2.1072

package/dist/index.d.mts

@@ -11751,7 +11751,7 @@ type TargetingSpec = {
      */
     languages?: Array<(string)>;
     /**
-     * Interest entities from /v1/ads/targeting/search?dimension=interest. Each carries the platform's opaque id. Rejected with 400 on Google (use Demand Gen audience userInterests there) and OpenAI.
+     * Interest entities from /v1/ads/targeting/search?dimension=interest. Each carries the platform's opaque id. On Google, applied as ad-group interest criteria (affinity and in-market categories) on Display and Search ad groups the request creates; rejected with 400 on Performance Max, on Demand Gen (use the Demand Gen audience `userInterests` there), when attaching to an existing ad group (`adSetId`), and on OpenAI. On Google, interests are create-only.
      */
     interests?: Array<{
         id: string;
@@ -39682,6 +39682,26 @@ type UpdateAdSetData = {
          *
          */
         bidStrategy?: (BidStrategy);
+        /**
+         * TikTok only (a 400 elsewhere). TikTok Smart Targeting on the ad group: `audience` is
+         * TikTok's `smart_audience_enabled`, `interestsBehaviors` its `smart_interest_behavior_enabled`.
+         * When on, TikTok may deliver beyond the selected audiences or interests. Available on
+         * Video views, Traffic, Lead generation, App install, Web conversion and Community interaction.
+         * Only the flags you send are written; an unwritten flag reads back null in
+         * `nativeSettings`, so send `false` explicitly to be able to verify it is off.
+         * Applied with TikTok's adgroup/update; read it back with GET /v1/ads/ad-sets?adSetId=...&live=true.
+         *
+         */
+        smartTargeting?: {
+            /**
+             * TikTok smart_audience_enabled.
+             */
+            audience?: boolean;
+            /**
+             * TikTok smart_interest_behavior_enabled.
+             */
+            interestsBehaviors?: boolean;
+        };
         /**
          * 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. Internally converted to Meta's
@@ -44254,6 +44274,26 @@ type BoostPostData = {
          * Meta only. Extra primary-text options Meta rotates on the boosted post (asset_feed_spec.bodies with DEGREES_OF_FREEDOM); the post keeps its own text as one of the options. Works for Facebook posts and Instagram media. Under a conversions or traffic goal Meta also wants a website URL on the options, taken from `linkUrl` (send it with a `callToAction`); engagement boosts need none.
          */
         bodies?: Array<(string)>;
+        /**
+         * TikTok only (a 400 elsewhere). TikTok Smart Targeting on the ad group: `audience` is
+         * TikTok's `smart_audience_enabled`, `interestsBehaviors` its `smart_interest_behavior_enabled`.
+         * When on, TikTok may deliver beyond the selected audiences or interests. Available on
+         * Video views, Traffic, Lead generation, App install, Web conversion and Community interaction.
+         * Only the flags you send are written; an unwritten flag reads back null in
+         * `nativeSettings`, so send `false` explicitly to be able to verify it is off.
+         * Not available with smartPlus or when attaching to an existing ad set (adSetId).
+         *
+         */
+        smartTargeting?: {
+            /**
+             * TikTok smart_audience_enabled.
+             */
+            audience?: boolean;
+            /**
+             * TikTok smart_interest_behavior_enabled.
+             */
+            interestsBehaviors?: boolean;
+        };
         /**
          * Meta, or TikTok with `goal: video_views`. TikTok: ENGAGED_VIEW (6-second
          * Focused View, the default) or ENGAGED_VIEW_FIFTEEN (15-second views), both
@@ -44504,6 +44544,26 @@ type CreateStandaloneAdData = {
          *
          */
         goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'conversions' | 'app_promotion' | 'catalog_sales' | 'page_likes' | 'page_visits' | 'job_applicants';
+        /**
+         * TikTok only (a 400 elsewhere). TikTok Smart Targeting on the ad group: `audience` is
+         * TikTok's `smart_audience_enabled`, `interestsBehaviors` its `smart_interest_behavior_enabled`.
+         * When on, TikTok may deliver beyond the selected audiences or interests. Available on
+         * Video views, Traffic, Lead generation, App install, Web conversion and Community interaction.
+         * Only the flags you send are written; an unwritten flag reads back null in
+         * `nativeSettings`, so send `false` explicitly to be able to verify it is off.
+         * Not available with smartPlus or when attaching to an existing ad set (adSetId).
+         *
+         */
+        smartTargeting?: {
+            /**
+             * TikTok smart_audience_enabled.
+             */
+            audience?: boolean;
+            /**
+             * TikTok smart_interest_behavior_enabled.
+             */
+            interestsBehaviors?: boolean;
+        };
         /**
          * Meta, or TikTok with goal video_views (ENGAGED_VIEW, the 6-second default, or ENGAGED_VIEW_FIFTEEN; both bill per view). Meta: 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.
          */

package/dist/index.d.ts

@@ -11751,7 +11751,7 @@ type TargetingSpec = {
      */
     languages?: Array<(string)>;
     /**
-     * Interest entities from /v1/ads/targeting/search?dimension=interest. Each carries the platform's opaque id. Rejected with 400 on Google (use Demand Gen audience userInterests there) and OpenAI.
+     * Interest entities from /v1/ads/targeting/search?dimension=interest. Each carries the platform's opaque id. On Google, applied as ad-group interest criteria (affinity and in-market categories) on Display and Search ad groups the request creates; rejected with 400 on Performance Max, on Demand Gen (use the Demand Gen audience `userInterests` there), when attaching to an existing ad group (`adSetId`), and on OpenAI. On Google, interests are create-only.
      */
     interests?: Array<{
         id: string;
@@ -39682,6 +39682,26 @@ type UpdateAdSetData = {
          *
          */
         bidStrategy?: (BidStrategy);
+        /**
+         * TikTok only (a 400 elsewhere). TikTok Smart Targeting on the ad group: `audience` is
+         * TikTok's `smart_audience_enabled`, `interestsBehaviors` its `smart_interest_behavior_enabled`.
+         * When on, TikTok may deliver beyond the selected audiences or interests. Available on
+         * Video views, Traffic, Lead generation, App install, Web conversion and Community interaction.
+         * Only the flags you send are written; an unwritten flag reads back null in
+         * `nativeSettings`, so send `false` explicitly to be able to verify it is off.
+         * Applied with TikTok's adgroup/update; read it back with GET /v1/ads/ad-sets?adSetId=...&live=true.
+         *
+         */
+        smartTargeting?: {
+            /**
+             * TikTok smart_audience_enabled.
+             */
+            audience?: boolean;
+            /**
+             * TikTok smart_interest_behavior_enabled.
+             */
+            interestsBehaviors?: boolean;
+        };
         /**
          * 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. Internally converted to Meta's
@@ -44254,6 +44274,26 @@ type BoostPostData = {
          * Meta only. Extra primary-text options Meta rotates on the boosted post (asset_feed_spec.bodies with DEGREES_OF_FREEDOM); the post keeps its own text as one of the options. Works for Facebook posts and Instagram media. Under a conversions or traffic goal Meta also wants a website URL on the options, taken from `linkUrl` (send it with a `callToAction`); engagement boosts need none.
          */
         bodies?: Array<(string)>;
+        /**
+         * TikTok only (a 400 elsewhere). TikTok Smart Targeting on the ad group: `audience` is
+         * TikTok's `smart_audience_enabled`, `interestsBehaviors` its `smart_interest_behavior_enabled`.
+         * When on, TikTok may deliver beyond the selected audiences or interests. Available on
+         * Video views, Traffic, Lead generation, App install, Web conversion and Community interaction.
+         * Only the flags you send are written; an unwritten flag reads back null in
+         * `nativeSettings`, so send `false` explicitly to be able to verify it is off.
+         * Not available with smartPlus or when attaching to an existing ad set (adSetId).
+         *
+         */
+        smartTargeting?: {
+            /**
+             * TikTok smart_audience_enabled.
+             */
+            audience?: boolean;
+            /**
+             * TikTok smart_interest_behavior_enabled.
+             */
+            interestsBehaviors?: boolean;
+        };
         /**
          * Meta, or TikTok with `goal: video_views`. TikTok: ENGAGED_VIEW (6-second
          * Focused View, the default) or ENGAGED_VIEW_FIFTEEN (15-second views), both
@@ -44504,6 +44544,26 @@ type CreateStandaloneAdData = {
          *
          */
         goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'conversions' | 'app_promotion' | 'catalog_sales' | 'page_likes' | 'page_visits' | 'job_applicants';
+        /**
+         * TikTok only (a 400 elsewhere). TikTok Smart Targeting on the ad group: `audience` is
+         * TikTok's `smart_audience_enabled`, `interestsBehaviors` its `smart_interest_behavior_enabled`.
+         * When on, TikTok may deliver beyond the selected audiences or interests. Available on
+         * Video views, Traffic, Lead generation, App install, Web conversion and Community interaction.
+         * Only the flags you send are written; an unwritten flag reads back null in
+         * `nativeSettings`, so send `false` explicitly to be able to verify it is off.
+         * Not available with smartPlus or when attaching to an existing ad set (adSetId).
+         *
+         */
+        smartTargeting?: {
+            /**
+             * TikTok smart_audience_enabled.
+             */
+            audience?: boolean;
+            /**
+             * TikTok smart_interest_behavior_enabled.
+             */
+            interestsBehaviors?: boolean;
+        };
         /**
          * Meta, or TikTok with goal video_views (ENGAGED_VIEW, the 6-second default, or ENGAGED_VIEW_FIFTEEN; both bill per view). Meta: 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.
          */

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.1070",
+  version: "0.2.1072",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.1070",
+  version: "0.2.1072",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zernio/node",
-  "version": "0.2.1070",
+  "version": "0.2.1072",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/types.gen.ts

@@ -10224,7 +10224,7 @@ export type TargetingSpec = {
      */
     languages?: Array<(string)>;
     /**
-     * Interest entities from /v1/ads/targeting/search?dimension=interest. Each carries the platform's opaque id. Rejected with 400 on Google (use Demand Gen audience userInterests there) and OpenAI.
+     * Interest entities from /v1/ads/targeting/search?dimension=interest. Each carries the platform's opaque id. On Google, applied as ad-group interest criteria (affinity and in-market categories) on Display and Search ad groups the request creates; rejected with 400 on Performance Max, on Demand Gen (use the Demand Gen audience `userInterests` there), when attaching to an existing ad group (`adSetId`), and on OpenAI. On Google, interests are create-only.
      */
     interests?: Array<{
         id: string;
@@ -40087,6 +40087,26 @@ export type UpdateAdSetData = {
          *
          */
         bidStrategy?: (BidStrategy);
+        /**
+         * TikTok only (a 400 elsewhere). TikTok Smart Targeting on the ad group: `audience` is
+         * TikTok's `smart_audience_enabled`, `interestsBehaviors` its `smart_interest_behavior_enabled`.
+         * When on, TikTok may deliver beyond the selected audiences or interests. Available on
+         * Video views, Traffic, Lead generation, App install, Web conversion and Community interaction.
+         * Only the flags you send are written; an unwritten flag reads back null in
+         * `nativeSettings`, so send `false` explicitly to be able to verify it is off.
+         * Applied with TikTok's adgroup/update; read it back with GET /v1/ads/ad-sets?adSetId=...&live=true.
+         *
+         */
+        smartTargeting?: {
+            /**
+             * TikTok smart_audience_enabled.
+             */
+            audience?: boolean;
+            /**
+             * TikTok smart_interest_behavior_enabled.
+             */
+            interestsBehaviors?: boolean;
+        };
         /**
          * 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. Internally converted to Meta's
@@ -44965,6 +44985,26 @@ export type BoostPostData = {
          * Meta only. Extra primary-text options Meta rotates on the boosted post (asset_feed_spec.bodies with DEGREES_OF_FREEDOM); the post keeps its own text as one of the options. Works for Facebook posts and Instagram media. Under a conversions or traffic goal Meta also wants a website URL on the options, taken from `linkUrl` (send it with a `callToAction`); engagement boosts need none.
          */
         bodies?: Array<(string)>;
+        /**
+         * TikTok only (a 400 elsewhere). TikTok Smart Targeting on the ad group: `audience` is
+         * TikTok's `smart_audience_enabled`, `interestsBehaviors` its `smart_interest_behavior_enabled`.
+         * When on, TikTok may deliver beyond the selected audiences or interests. Available on
+         * Video views, Traffic, Lead generation, App install, Web conversion and Community interaction.
+         * Only the flags you send are written; an unwritten flag reads back null in
+         * `nativeSettings`, so send `false` explicitly to be able to verify it is off.
+         * Not available with smartPlus or when attaching to an existing ad set (adSetId).
+         *
+         */
+        smartTargeting?: {
+            /**
+             * TikTok smart_audience_enabled.
+             */
+            audience?: boolean;
+            /**
+             * TikTok smart_interest_behavior_enabled.
+             */
+            interestsBehaviors?: boolean;
+        };
         /**
          * Meta, or TikTok with `goal: video_views`. TikTok: ENGAGED_VIEW (6-second
          * Focused View, the default) or ENGAGED_VIEW_FIFTEEN (15-second views), both
@@ -45239,6 +45279,26 @@ export type CreateStandaloneAdData = {
          *
          */
         goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'conversions' | 'app_promotion' | 'catalog_sales' | 'page_likes' | 'page_visits' | 'job_applicants';
+        /**
+         * TikTok only (a 400 elsewhere). TikTok Smart Targeting on the ad group: `audience` is
+         * TikTok's `smart_audience_enabled`, `interestsBehaviors` its `smart_interest_behavior_enabled`.
+         * When on, TikTok may deliver beyond the selected audiences or interests. Available on
+         * Video views, Traffic, Lead generation, App install, Web conversion and Community interaction.
+         * Only the flags you send are written; an unwritten flag reads back null in
+         * `nativeSettings`, so send `false` explicitly to be able to verify it is off.
+         * Not available with smartPlus or when attaching to an existing ad set (adSetId).
+         *
+         */
+        smartTargeting?: {
+            /**
+             * TikTok smart_audience_enabled.
+             */
+            audience?: boolean;
+            /**
+             * TikTok smart_interest_behavior_enabled.
+             */
+            interestsBehaviors?: boolean;
+        };
         /**
          * Meta, or TikTok with goal video_views (ENGAGED_VIEW, the 6-second default, or ENGAGED_VIEW_FIFTEEN; both bill per view). Meta: 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.
          */