@zernio/node 0.2.57 → 0.2.59

package/dist/index.d.mts

@@ -676,6 +676,43 @@ type Ad = {
     platformAdSetId?: string;
     campaignName?: string;
     adSetName?: string;
+    /**
+     * Raw Meta campaign objective (e.g. OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC). Only present for Meta ads.
+     */
+    platformObjective?: (string) | null;
+    /**
+     * Meta ad set optimization goal (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION, LINK_CLICKS). Only present for Meta ads.
+     */
+    optimizationGoal?: (string) | null;
+    /**
+     * Bid strategy (e.g. LOWEST_COST_WITHOUT_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS). Ad set level overrides campaign level. Only present for Meta ads.
+     */
+    bidStrategy?: (string) | null;
+    /**
+     * Meta promoted object containing conversion event details. Structure varies by objective. Only present for Meta ads.
+     */
+    promotedObject?: {
+        /**
+         * Conversion event type (e.g. PURCHASE, LEAD, COMPLETE_REGISTRATION, ADD_TO_CART)
+         */
+        custom_event_type?: string;
+        /**
+         * Meta pixel ID
+         */
+        pixel_id?: string;
+        /**
+         * Facebook page ID
+         */
+        page_id?: string;
+        /**
+         * Facebook app ID
+         */
+        application_id?: string;
+        /**
+         * Product catalog set ID
+         */
+        product_set_id?: string;
+    } | null;
     /**
      * Platform-specific creative data. Fields vary by platform.
      */
@@ -757,6 +794,26 @@ type AdCampaign = {
     platformAdAccountId?: string;
     accountId?: string;
     profileId?: string;
+    /**
+     * Raw Meta campaign objective (e.g. OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC)
+     */
+    platformObjective?: (string) | null;
+    /**
+     * Meta optimization goal. String if all ad sets share the same goal, array of distinct values if they differ.
+     */
+    optimizationGoal?: ((string | Array<(string)>) | null);
+    /**
+     * Campaign-level bid strategy (e.g. LOWEST_COST_WITHOUT_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS)
+     */
+    bidStrategy?: (string) | null;
+    /**
+     * Meta promoted object at campaign level (conversion event details)
+     */
+    promotedObject?: {
+        custom_event_type?: string;
+        pixel_id?: string;
+        page_id?: string;
+    } | null;
     earliestAd?: string;
     latestAd?: string;
 };
@@ -799,6 +856,22 @@ type AdTreeAdSet = {
         type?: 'daily' | 'lifetime';
     } | null;
     metrics?: AdMetrics;
+    /**
+     * Meta ad set optimization goal (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION)
+     */
+    optimizationGoal?: (string) | null;
+    /**
+     * Bid strategy for this ad set (overrides campaign level when set)
+     */
+    bidStrategy?: (string) | null;
+    /**
+     * Meta promoted object for this ad set (conversion event details)
+     */
+    promotedObject?: {
+        custom_event_type?: string;
+        pixel_id?: string;
+        page_id?: string;
+    } | null;
     /**
      * Individual ads within this ad set (capped at 100). Returns a subset of Ad fields from the aggregation (core fields like _id, name, platform, status, budget, metrics, creative, goal are included; targeting and schedule may be absent).
      */
@@ -828,6 +901,26 @@ type AdTreeCampaign = {
     platformAdAccountId?: string;
     accountId?: string;
     profileId?: string;
+    /**
+     * Raw Meta campaign objective (e.g. OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC)
+     */
+    platformObjective?: (string) | null;
+    /**
+     * Meta optimization goal. String if all ad sets share the same goal, array of distinct values if they differ.
+     */
+    optimizationGoal?: ((string | Array<(string)>) | null);
+    /**
+     * Campaign-level bid strategy (e.g. LOWEST_COST_WITHOUT_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS)
+     */
+    bidStrategy?: (string) | null;
+    /**
+     * Meta promoted object at campaign level (conversion event details)
+     */
+    promotedObject?: {
+        custom_event_type?: string;
+        pixel_id?: string;
+        page_id?: string;
+    } | null;
     adSets?: Array<AdTreeAdSet>;
 };
 type AnalyticsListResponse = {
@@ -10767,7 +10860,13 @@ type UpdateAdData = {
             ageMin?: number;
             ageMax?: number;
             countries?: Array<(string)>;
-            interests?: Array<(string)>;
+            /**
+             * Interest objects from /v1/ads/interests. Each must include id and name.
+             */
+            interests?: Array<{
+                id: string;
+                name: string;
+            }>;
         };
         name?: string;
     };
@@ -10895,7 +10994,13 @@ type BoostPostData = {
             ageMin?: number;
             ageMax?: number;
             countries?: Array<(string)>;
-            interests?: Array<(string)>;
+            /**
+             * Interest objects from /v1/ads/interests. Each must include id and name.
+             */
+            interests?: Array<{
+                id: string;
+                name: string;
+            }>;
         };
         /**
          * Max bid cap (Meta only)
@@ -10962,7 +11067,13 @@ type CreateStandaloneAdData = {
         countries?: Array<(string)>;
         ageMin?: number;
         ageMax?: number;
-        interests?: Array<(string)>;
+        /**
+         * Interest objects from /v1/ads/interests. Each must include id and name.
+         */
+        interests?: Array<{
+            id: string;
+            name: string;
+        }>;
         /**
          * Required for lifetime budgets
          */

package/dist/index.d.ts

@@ -676,6 +676,43 @@ type Ad = {
     platformAdSetId?: string;
     campaignName?: string;
     adSetName?: string;
+    /**
+     * Raw Meta campaign objective (e.g. OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC). Only present for Meta ads.
+     */
+    platformObjective?: (string) | null;
+    /**
+     * Meta ad set optimization goal (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION, LINK_CLICKS). Only present for Meta ads.
+     */
+    optimizationGoal?: (string) | null;
+    /**
+     * Bid strategy (e.g. LOWEST_COST_WITHOUT_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS). Ad set level overrides campaign level. Only present for Meta ads.
+     */
+    bidStrategy?: (string) | null;
+    /**
+     * Meta promoted object containing conversion event details. Structure varies by objective. Only present for Meta ads.
+     */
+    promotedObject?: {
+        /**
+         * Conversion event type (e.g. PURCHASE, LEAD, COMPLETE_REGISTRATION, ADD_TO_CART)
+         */
+        custom_event_type?: string;
+        /**
+         * Meta pixel ID
+         */
+        pixel_id?: string;
+        /**
+         * Facebook page ID
+         */
+        page_id?: string;
+        /**
+         * Facebook app ID
+         */
+        application_id?: string;
+        /**
+         * Product catalog set ID
+         */
+        product_set_id?: string;
+    } | null;
     /**
      * Platform-specific creative data. Fields vary by platform.
      */
@@ -757,6 +794,26 @@ type AdCampaign = {
     platformAdAccountId?: string;
     accountId?: string;
     profileId?: string;
+    /**
+     * Raw Meta campaign objective (e.g. OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC)
+     */
+    platformObjective?: (string) | null;
+    /**
+     * Meta optimization goal. String if all ad sets share the same goal, array of distinct values if they differ.
+     */
+    optimizationGoal?: ((string | Array<(string)>) | null);
+    /**
+     * Campaign-level bid strategy (e.g. LOWEST_COST_WITHOUT_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS)
+     */
+    bidStrategy?: (string) | null;
+    /**
+     * Meta promoted object at campaign level (conversion event details)
+     */
+    promotedObject?: {
+        custom_event_type?: string;
+        pixel_id?: string;
+        page_id?: string;
+    } | null;
     earliestAd?: string;
     latestAd?: string;
 };
@@ -799,6 +856,22 @@ type AdTreeAdSet = {
         type?: 'daily' | 'lifetime';
     } | null;
     metrics?: AdMetrics;
+    /**
+     * Meta ad set optimization goal (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION)
+     */
+    optimizationGoal?: (string) | null;
+    /**
+     * Bid strategy for this ad set (overrides campaign level when set)
+     */
+    bidStrategy?: (string) | null;
+    /**
+     * Meta promoted object for this ad set (conversion event details)
+     */
+    promotedObject?: {
+        custom_event_type?: string;
+        pixel_id?: string;
+        page_id?: string;
+    } | null;
     /**
      * Individual ads within this ad set (capped at 100). Returns a subset of Ad fields from the aggregation (core fields like _id, name, platform, status, budget, metrics, creative, goal are included; targeting and schedule may be absent).
      */
@@ -828,6 +901,26 @@ type AdTreeCampaign = {
     platformAdAccountId?: string;
     accountId?: string;
     profileId?: string;
+    /**
+     * Raw Meta campaign objective (e.g. OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC)
+     */
+    platformObjective?: (string) | null;
+    /**
+     * Meta optimization goal. String if all ad sets share the same goal, array of distinct values if they differ.
+     */
+    optimizationGoal?: ((string | Array<(string)>) | null);
+    /**
+     * Campaign-level bid strategy (e.g. LOWEST_COST_WITHOUT_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS)
+     */
+    bidStrategy?: (string) | null;
+    /**
+     * Meta promoted object at campaign level (conversion event details)
+     */
+    promotedObject?: {
+        custom_event_type?: string;
+        pixel_id?: string;
+        page_id?: string;
+    } | null;
     adSets?: Array<AdTreeAdSet>;
 };
 type AnalyticsListResponse = {
@@ -10767,7 +10860,13 @@ type UpdateAdData = {
             ageMin?: number;
             ageMax?: number;
             countries?: Array<(string)>;
-            interests?: Array<(string)>;
+            /**
+             * Interest objects from /v1/ads/interests. Each must include id and name.
+             */
+            interests?: Array<{
+                id: string;
+                name: string;
+            }>;
         };
         name?: string;
     };
@@ -10895,7 +10994,13 @@ type BoostPostData = {
             ageMin?: number;
             ageMax?: number;
             countries?: Array<(string)>;
-            interests?: Array<(string)>;
+            /**
+             * Interest objects from /v1/ads/interests. Each must include id and name.
+             */
+            interests?: Array<{
+                id: string;
+                name: string;
+            }>;
         };
         /**
          * Max bid cap (Meta only)
@@ -10962,7 +11067,13 @@ type CreateStandaloneAdData = {
         countries?: Array<(string)>;
         ageMin?: number;
         ageMax?: number;
-        interests?: Array<(string)>;
+        /**
+         * Interest objects from /v1/ads/interests. Each must include id and name.
+         */
+        interests?: Array<{
+            id: string;
+            name: string;
+        }>;
         /**
          * Required for lifetime budgets
          */

package/package.json

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

package/src/generated/types.gen.ts

@@ -106,6 +106,43 @@ export type Ad = {
     platformAdSetId?: string;
     campaignName?: string;
     adSetName?: string;
+    /**
+     * Raw Meta campaign objective (e.g. OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC). Only present for Meta ads.
+     */
+    platformObjective?: (string) | null;
+    /**
+     * Meta ad set optimization goal (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION, LINK_CLICKS). Only present for Meta ads.
+     */
+    optimizationGoal?: (string) | null;
+    /**
+     * Bid strategy (e.g. LOWEST_COST_WITHOUT_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS). Ad set level overrides campaign level. Only present for Meta ads.
+     */
+    bidStrategy?: (string) | null;
+    /**
+     * Meta promoted object containing conversion event details. Structure varies by objective. Only present for Meta ads.
+     */
+    promotedObject?: {
+        /**
+         * Conversion event type (e.g. PURCHASE, LEAD, COMPLETE_REGISTRATION, ADD_TO_CART)
+         */
+        custom_event_type?: string;
+        /**
+         * Meta pixel ID
+         */
+        pixel_id?: string;
+        /**
+         * Facebook page ID
+         */
+        page_id?: string;
+        /**
+         * Facebook app ID
+         */
+        application_id?: string;
+        /**
+         * Product catalog set ID
+         */
+        product_set_id?: string;
+    } | null;
     /**
      * Platform-specific creative data. Fields vary by platform.
      */
@@ -193,6 +230,26 @@ export type AdCampaign = {
     platformAdAccountId?: string;
     accountId?: string;
     profileId?: string;
+    /**
+     * Raw Meta campaign objective (e.g. OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC)
+     */
+    platformObjective?: (string) | null;
+    /**
+     * Meta optimization goal. String if all ad sets share the same goal, array of distinct values if they differ.
+     */
+    optimizationGoal?: ((string | Array<(string)>) | null);
+    /**
+     * Campaign-level bid strategy (e.g. LOWEST_COST_WITHOUT_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS)
+     */
+    bidStrategy?: (string) | null;
+    /**
+     * Meta promoted object at campaign level (conversion event details)
+     */
+    promotedObject?: {
+        custom_event_type?: string;
+        pixel_id?: string;
+        page_id?: string;
+    } | null;
     earliestAd?: string;
     latestAd?: string;
 };
@@ -237,6 +294,22 @@ export type AdTreeAdSet = {
         type?: 'daily' | 'lifetime';
     } | null;
     metrics?: AdMetrics;
+    /**
+     * Meta ad set optimization goal (e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION)
+     */
+    optimizationGoal?: (string) | null;
+    /**
+     * Bid strategy for this ad set (overrides campaign level when set)
+     */
+    bidStrategy?: (string) | null;
+    /**
+     * Meta promoted object for this ad set (conversion event details)
+     */
+    promotedObject?: {
+        custom_event_type?: string;
+        pixel_id?: string;
+        page_id?: string;
+    } | null;
     /**
      * Individual ads within this ad set (capped at 100). Returns a subset of Ad fields from the aggregation (core fields like _id, name, platform, status, budget, metrics, creative, goal are included; targeting and schedule may be absent).
      */
@@ -267,6 +340,26 @@ export type AdTreeCampaign = {
     platformAdAccountId?: string;
     accountId?: string;
     profileId?: string;
+    /**
+     * Raw Meta campaign objective (e.g. OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC)
+     */
+    platformObjective?: (string) | null;
+    /**
+     * Meta optimization goal. String if all ad sets share the same goal, array of distinct values if they differ.
+     */
+    optimizationGoal?: ((string | Array<(string)>) | null);
+    /**
+     * Campaign-level bid strategy (e.g. LOWEST_COST_WITHOUT_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS)
+     */
+    bidStrategy?: (string) | null;
+    /**
+     * Meta promoted object at campaign level (conversion event details)
+     */
+    promotedObject?: {
+        custom_event_type?: string;
+        pixel_id?: string;
+        page_id?: string;
+    } | null;
     adSets?: Array<AdTreeAdSet>;
 };
 
@@ -11043,7 +11136,13 @@ export type UpdateAdData = {
             ageMin?: number;
             ageMax?: number;
             countries?: Array<(string)>;
-            interests?: Array<(string)>;
+            /**
+             * Interest objects from /v1/ads/interests. Each must include id and name.
+             */
+            interests?: Array<{
+                id: string;
+                name: string;
+            }>;
         };
         name?: string;
     };
@@ -11183,7 +11282,13 @@ export type BoostPostData = {
             ageMin?: number;
             ageMax?: number;
             countries?: Array<(string)>;
-            interests?: Array<(string)>;
+            /**
+             * Interest objects from /v1/ads/interests. Each must include id and name.
+             */
+            interests?: Array<{
+                id: string;
+                name: string;
+            }>;
         };
         /**
          * Max bid cap (Meta only)
@@ -11253,7 +11358,13 @@ export type CreateStandaloneAdData = {
         countries?: Array<(string)>;
         ageMin?: number;
         ageMax?: number;
-        interests?: Array<(string)>;
+        /**
+         * Interest objects from /v1/ads/interests. Each must include id and name.
+         */
+        interests?: Array<{
+            id: string;
+            name: string;
+        }>;
         /**
          * Required for lifetime budgets
          */