@getlatedev/node 0.2.458 → 0.2.460

package/dist/index.d.mts

@@ -1409,6 +1409,10 @@ type Ad = {
          * Meta `effective_object_story_id` — `{pageId}_{postId}` of the Facebook post the ad's engagement (comments) lives on. Pass to GET /v1/ads?effectiveObjectStoryId= to map a Business-Manager-visible post back to this ad; GET /v1/ads/{adId}/comments resolves comments against it.
          */
         effectiveObjectStoryId?: (string) | null;
+        /**
+         * Facebook Page backing the creative (Meta only). What the `pageId` filter on /v1/ads, /v1/ads/campaigns and /v1/ads/tree matches against. Absent for non-Meta ads and rare Meta creatives with no page signal.
+         */
+        pageId?: (string) | null;
         /**
          * Meta `effective_instagram_media_id` — the Instagram media ID of the boosted post the ad's engagement lives on. Pass to GET /v1/ads?effectiveInstagramMediaId= to map a Business-Manager-visible IG post back to this ad.
          */
@@ -24302,6 +24306,10 @@ type ListAdsData = {
          * Page number (1-based)
          */
         page?: number;
+        /**
+         * Meta only: Facebook Page ID. Returns only ads whose creative is backed by this Page (a Meta ad account serves ads for every Page in the Business Manager). Matches each ad's `creative.pageId`; ads with no page signal (rare IG-only creatives) never match. Mirrors the same filter on /v1/ads/campaigns and /v1/ads/tree.
+         */
+        pageId?: string;
         platform?: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai';
         /**
          * Meta ad ID. Returns the ad with this platform-side ad ID.
@@ -24427,6 +24435,10 @@ type ListAdCampaignsData = {
          * Page number (1-based)
          */
         page?: number;
+        /**
+         * Meta only: Facebook Page ID. Campaigns have no Page of their own, so this keeps campaigns having at least one ad backed by this Page, with adCount and metrics computed over those ads only. Mirrors the same filter on /v1/ads and /v1/ads/tree.
+         */
+        pageId?: string;
         platform?: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai';
         /**
          * Profile ID
@@ -24929,6 +24941,10 @@ type GetAdTreeData = {
          * Page number (1-based)
          */
         page?: number;
+        /**
+         * Meta only: Facebook Page ID. Prunes the tree to ads whose creative is backed by this Page — campaigns and ad sets with no ad on the Page drop out, and rolled-up metrics cover only the Page's ads. Mirrors the same filter on /v1/ads and /v1/ads/campaigns.
+         */
+        pageId?: string;
         platform?: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai';
         /**
          * Profile ID
@@ -25716,7 +25732,7 @@ type GetAdTrackingTagsError = ({
 type UpdateAdTrackingTagsData = {
     body: {
         /**
-         * Meta only. Click-URL params appended to a freshly-rebuilt creative.
+         * Meta only. Click-URL params appended to a freshly-rebuilt creative. Meta dynamic macros ({{ad.id}}, {{campaign.id}}, {{placement}}, ...) are sent through unescaped so Meta expands them; every other character is percent-encoded.
          */
         urlTags?: Array<{
             key: string;
@@ -26642,7 +26658,7 @@ type BoostPostData = {
         tracking?: {
             pixelId?: string;
             /**
-             * URL parameters appended to the ad link, rendered as `key=value` pairs joined with `&`.
+             * URL parameters appended to the ad link, rendered as `key=value` pairs joined with `&`. Meta dynamic macros ({{ad.id}}, {{campaign.id}}, {{placement}}, ...) are sent through unescaped so Meta expands them; every other character is percent-encoded.
              */
             urlTags?: Array<{
                 key?: string;
@@ -26736,7 +26752,7 @@ type CreateStandaloneAdData = {
              */
             pixelId?: string;
             /**
-             * Click-URL params appended to the ad's destination as `url_tags` (e.g. utm_source).
+             * Click-URL params appended to the ad's destination as `url_tags` (e.g. utm_source). Meta dynamic macros ({{ad.id}}, {{campaign.id}}, {{placement}}, ...) are sent through unescaped so Meta expands them; every other character is percent-encoded.
              */
             urlTags?: Array<{
                 key: string;

package/dist/index.d.ts

@@ -1409,6 +1409,10 @@ type Ad = {
          * Meta `effective_object_story_id` — `{pageId}_{postId}` of the Facebook post the ad's engagement (comments) lives on. Pass to GET /v1/ads?effectiveObjectStoryId= to map a Business-Manager-visible post back to this ad; GET /v1/ads/{adId}/comments resolves comments against it.
          */
         effectiveObjectStoryId?: (string) | null;
+        /**
+         * Facebook Page backing the creative (Meta only). What the `pageId` filter on /v1/ads, /v1/ads/campaigns and /v1/ads/tree matches against. Absent for non-Meta ads and rare Meta creatives with no page signal.
+         */
+        pageId?: (string) | null;
         /**
          * Meta `effective_instagram_media_id` — the Instagram media ID of the boosted post the ad's engagement lives on. Pass to GET /v1/ads?effectiveInstagramMediaId= to map a Business-Manager-visible IG post back to this ad.
          */
@@ -24302,6 +24306,10 @@ type ListAdsData = {
          * Page number (1-based)
          */
         page?: number;
+        /**
+         * Meta only: Facebook Page ID. Returns only ads whose creative is backed by this Page (a Meta ad account serves ads for every Page in the Business Manager). Matches each ad's `creative.pageId`; ads with no page signal (rare IG-only creatives) never match. Mirrors the same filter on /v1/ads/campaigns and /v1/ads/tree.
+         */
+        pageId?: string;
         platform?: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai';
         /**
          * Meta ad ID. Returns the ad with this platform-side ad ID.
@@ -24427,6 +24435,10 @@ type ListAdCampaignsData = {
          * Page number (1-based)
          */
         page?: number;
+        /**
+         * Meta only: Facebook Page ID. Campaigns have no Page of their own, so this keeps campaigns having at least one ad backed by this Page, with adCount and metrics computed over those ads only. Mirrors the same filter on /v1/ads and /v1/ads/tree.
+         */
+        pageId?: string;
         platform?: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai';
         /**
          * Profile ID
@@ -24929,6 +24941,10 @@ type GetAdTreeData = {
          * Page number (1-based)
          */
         page?: number;
+        /**
+         * Meta only: Facebook Page ID. Prunes the tree to ads whose creative is backed by this Page — campaigns and ad sets with no ad on the Page drop out, and rolled-up metrics cover only the Page's ads. Mirrors the same filter on /v1/ads and /v1/ads/campaigns.
+         */
+        pageId?: string;
         platform?: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai';
         /**
          * Profile ID
@@ -25716,7 +25732,7 @@ type GetAdTrackingTagsError = ({
 type UpdateAdTrackingTagsData = {
     body: {
         /**
-         * Meta only. Click-URL params appended to a freshly-rebuilt creative.
+         * Meta only. Click-URL params appended to a freshly-rebuilt creative. Meta dynamic macros ({{ad.id}}, {{campaign.id}}, {{placement}}, ...) are sent through unescaped so Meta expands them; every other character is percent-encoded.
          */
         urlTags?: Array<{
             key: string;
@@ -26642,7 +26658,7 @@ type BoostPostData = {
         tracking?: {
             pixelId?: string;
             /**
-             * URL parameters appended to the ad link, rendered as `key=value` pairs joined with `&`.
+             * URL parameters appended to the ad link, rendered as `key=value` pairs joined with `&`. Meta dynamic macros ({{ad.id}}, {{campaign.id}}, {{placement}}, ...) are sent through unescaped so Meta expands them; every other character is percent-encoded.
              */
             urlTags?: Array<{
                 key?: string;
@@ -26736,7 +26752,7 @@ type CreateStandaloneAdData = {
              */
             pixelId?: string;
             /**
-             * Click-URL params appended to the ad's destination as `url_tags` (e.g. utm_source).
+             * Click-URL params appended to the ad's destination as `url_tags` (e.g. utm_source). Meta dynamic macros ({{ad.id}}, {{campaign.id}}, {{placement}}, ...) are sent through unescaped so Meta expands them; every other character is percent-encoded.
              */
             urlTags?: Array<{
                 key: string;

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.458",
+  version: "0.2.460",
   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: "@getlatedev/node",
-  version: "0.2.458",
+  version: "0.2.460",
   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": "@getlatedev/node",
-  "version": "0.2.458",
+  "version": "0.2.460",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/types.gen.ts

@@ -235,6 +235,10 @@ export type Ad = {
          * Meta `effective_object_story_id` — `{pageId}_{postId}` of the Facebook post the ad's engagement (comments) lives on. Pass to GET /v1/ads?effectiveObjectStoryId= to map a Business-Manager-visible post back to this ad; GET /v1/ads/{adId}/comments resolves comments against it.
          */
         effectiveObjectStoryId?: (string) | null;
+        /**
+         * Facebook Page backing the creative (Meta only). What the `pageId` filter on /v1/ads, /v1/ads/campaigns and /v1/ads/tree matches against. Absent for non-Meta ads and rare Meta creatives with no page signal.
+         */
+        pageId?: (string) | null;
         /**
          * Meta `effective_instagram_media_id` — the Instagram media ID of the boosted post the ad's engagement lives on. Pass to GET /v1/ads?effectiveInstagramMediaId= to map a Business-Manager-visible IG post back to this ad.
          */
@@ -24667,6 +24671,10 @@ export type ListAdsData = {
          * Page number (1-based)
          */
         page?: number;
+        /**
+         * Meta only: Facebook Page ID. Returns only ads whose creative is backed by this Page (a Meta ad account serves ads for every Page in the Business Manager). Matches each ad's `creative.pageId`; ads with no page signal (rare IG-only creatives) never match. Mirrors the same filter on /v1/ads/campaigns and /v1/ads/tree.
+         */
+        pageId?: string;
         platform?: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai';
         /**
          * Meta ad ID. Returns the ad with this platform-side ad ID.
@@ -24798,6 +24806,10 @@ export type ListAdCampaignsData = {
          * Page number (1-based)
          */
         page?: number;
+        /**
+         * Meta only: Facebook Page ID. Campaigns have no Page of their own, so this keeps campaigns having at least one ad backed by this Page, with adCount and metrics computed over those ads only. Mirrors the same filter on /v1/ads and /v1/ads/tree.
+         */
+        pageId?: string;
         platform?: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai';
         /**
          * Profile ID
@@ -25336,6 +25348,10 @@ export type GetAdTreeData = {
          * Page number (1-based)
          */
         page?: number;
+        /**
+         * Meta only: Facebook Page ID. Prunes the tree to ads whose creative is backed by this Page — campaigns and ad sets with no ad on the Page drop out, and rolled-up metrics cover only the Page's ads. Mirrors the same filter on /v1/ads and /v1/ads/campaigns.
+         */
+        pageId?: string;
         platform?: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai';
         /**
          * Profile ID
@@ -26171,7 +26187,7 @@ export type GetAdTrackingTagsError = ({
 export type UpdateAdTrackingTagsData = {
     body: {
         /**
-         * Meta only. Click-URL params appended to a freshly-rebuilt creative.
+         * Meta only. Click-URL params appended to a freshly-rebuilt creative. Meta dynamic macros ({{ad.id}}, {{campaign.id}}, {{placement}}, ...) are sent through unescaped so Meta expands them; every other character is percent-encoded.
          */
         urlTags?: Array<{
             key: string;
@@ -27163,7 +27179,7 @@ export type BoostPostData = {
         tracking?: {
             pixelId?: string;
             /**
-             * URL parameters appended to the ad link, rendered as `key=value` pairs joined with `&`.
+             * URL parameters appended to the ad link, rendered as `key=value` pairs joined with `&`. Meta dynamic macros ({{ad.id}}, {{campaign.id}}, {{placement}}, ...) are sent through unescaped so Meta expands them; every other character is percent-encoded.
              */
             urlTags?: Array<{
                 key?: string;
@@ -27260,7 +27276,7 @@ export type CreateStandaloneAdData = {
              */
             pixelId?: string;
             /**
-             * Click-URL params appended to the ad's destination as `url_tags` (e.g. utm_source).
+             * Click-URL params appended to the ad's destination as `url_tags` (e.g. utm_source). Meta dynamic macros ({{ad.id}}, {{campaign.id}}, {{placement}}, ...) are sent through unescaped so Meta expands them; every other character is percent-encoded.
              */
             urlTags?: Array<{
                 key: string;