late-sdk 0.0.614 → 0.0.616

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dc5d20bb5cd05a5b429df3ea6f9465ee28fbd81e17ef85cbdcbcb71b99c0cefa
-  data.tar.gz: 24d67743fe92a591f04a939badf3f0b231466ddbaa3bd997cf31e51f9d66cdde
+  metadata.gz: f6cd803c3a4873c55bb4fa069dc9e85a476c4b61342a2f9e9987b23521d5bf2e
+  data.tar.gz: 9b43e7854f88d25ecb5e828a059bf41d460ea8a5fde8a1cb734e45acb604d40a
 SHA512:
-  metadata.gz: f5eeaafc2c12ccdd115b11bf3acf9366b144099dafc792a5156566ac7ba63effdc1e80e51f51be844d481cbc13f4d4f3c633919afc1102ef15f91a7516565788
-  data.tar.gz: efb2c2bb1ef755af7d3901c5019c63e7a790a45e08a79b0a40b2d901b1cf870abaf2583f84c2b0d18751d4393b179ac0bb8a6133847d82f5c46d534077a1b84c
+  metadata.gz: 6bbb9defe9ff040725957cb04059f49c22ec0a0de25d1886d12c18b7d9eed5a2f11f8c9a3c179356f4f2e5a892464d7639eb982865abe1d737e76749d01b908b
+  data.tar.gz: d1b5ae08e405bf2046ce8508913766fccabdf6a194b932678fcd71d2eb67af8d4d3ee6098eff2da8d00e1369c0302ad8bc84c0e5aeb564f4f412d83fa6e9163c

data/docs/AdCampaignsApi.md

@@ -834,6 +834,7 @@ opts = {
   platform: 'facebook', # String | 
   status: Zernio::AdStatus::ACTIVE, # AdStatus | Filter by derived campaign status (post-aggregation)
   ad_account_id: 'ad_account_id_example', # String | Platform ad account ID
+  page_id: 'page_id_example', # String | 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.
   account_id: 'account_id_example', # String | Social account ID
   profile_id: 'profile_id_example', # String | Profile ID
   campaign_id: 'campaign_id_example', # String | Restrict the tree to a single campaign by its platform campaign id (the id the platform assigns, e.g. Meta's numeric campaign id). Filters the campaign set itself, so it works regardless of account size and pagination — pass this when you already hold a campaign id instead of paging the tree to find it. Mirrors the `campaignId` filter on GET /v1/ads.
@@ -881,6 +882,7 @@ end
 | **platform** | **String** |  | [optional] |
 | **status** | [**AdStatus**](.md) | Filter by derived campaign status (post-aggregation) | [optional] |
 | **ad_account_id** | **String** | Platform ad account ID | [optional] |
+| **page_id** | **String** | 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. | [optional] |
 | **account_id** | **String** | Social account ID | [optional] |
 | **profile_id** | **String** | Profile ID | [optional] |
 | **campaign_id** | **String** | Restrict the tree to a single campaign by its platform campaign id (the id the platform assigns, e.g. Meta's numeric campaign id). Filters the campaign set itself, so it works regardless of account size and pagination — pass this when you already hold a campaign id instead of paging the tree to find it. Mirrors the `campaignId` filter on GET /v1/ads. | [optional] |
@@ -1010,6 +1012,7 @@ opts = {
   platform: 'facebook', # String | 
   status: Zernio::AdStatus::ACTIVE, # AdStatus | Filter by derived campaign status (post-aggregation)
   ad_account_id: 'ad_account_id_example', # String | Platform ad account ID (e.g. act_123 for Meta)
+  page_id: 'page_id_example', # String | 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.
   account_id: 'account_id_example', # String | Social account ID
   profile_id: 'profile_id_example', # String | Profile ID
   from_date: Date.parse('2013-10-20'), # Date | Start of metrics date range (YYYY-MM-DD, inclusive). Defaults to 90 days ago when both date params are omitted.
@@ -1053,6 +1056,7 @@ end
 | **platform** | **String** |  | [optional] |
 | **status** | [**AdStatus**](.md) | Filter by derived campaign status (post-aggregation) | [optional] |
 | **ad_account_id** | **String** | Platform ad account ID (e.g. act_123 for Meta) | [optional] |
+| **page_id** | **String** | 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. | [optional] |
 | **account_id** | **String** | Social account ID | [optional] |
 | **profile_id** | **String** | Profile ID | [optional] |
 | **from_date** | **Date** | Start of metrics date range (YYYY-MM-DD, inclusive). Defaults to 90 days ago when both date params are omitted. | [optional] |
@@ -1191,6 +1195,7 @@ opts = {
   platform: 'facebook', # String | 
   account_id: 'account_id_example', # String | Social account ID
   ad_account_id: 'ad_account_id_example', # String | Platform ad account ID (e.g. act_123 for Meta). Mirrors the same filter on /v1/ads/campaigns and /v1/ads/tree.
+  page_id: 'page_id_example', # String | 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.
   profile_id: 'profile_id_example', # String | Profile ID
   campaign_id: 'campaign_id_example', # String | Platform campaign ID (filter ads within a campaign)
   platform_ad_id: 'platform_ad_id_example', # String | Meta ad ID. Returns the ad with this platform-side ad ID.
@@ -1238,6 +1243,7 @@ end
 | **platform** | **String** |  | [optional] |
 | **account_id** | **String** | Social account ID | [optional] |
 | **ad_account_id** | **String** | Platform ad account ID (e.g. act_123 for Meta). Mirrors the same filter on /v1/ads/campaigns and /v1/ads/tree. | [optional] |
+| **page_id** | **String** | 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. | [optional] |
 | **profile_id** | **String** | Profile ID | [optional] |
 | **campaign_id** | **String** | Platform campaign ID (filter ads within a campaign) | [optional] |
 | **platform_ad_id** | **String** | Meta ad ID. Returns the ad with this platform-side ad ID. | [optional] |

data/docs/AdCreative.md

@@ -11,6 +11,7 @@
 | **object_type** | **String** | Meta creative object_type (e.g. SHARE, VIDEO, PRIVACY_CHECK_FAIL, POST_DELETED). Use this to render state-aware previews — when Meta moderation strips image/video fields, only thumbnailUrl at 64x64 is available. | [optional] |
 | **object_story_id** | **String** | Meta creative `object_story_id` (the SHARE reference). Frequently absent — Meta omits it for SHARE creatives. Use effectiveObjectStoryId instead. | [optional] |
 | **effective_object_story_id** | **String** | 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. | [optional] |
+| **page_id** | **String** | 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. | [optional] |
 | **effective_instagram_media_id** | **String** | 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. | [optional] |
 | **instagram_user_id** | **String** | Meta `instagram_user_id` — the Instagram-scoped business ID that owns the boosted media. | [optional] |
 | **instagram_permalink_url** | **String** | Meta `instagram_permalink_url` — public Instagram post URL of the boosted media. | [optional] |
@@ -36,6 +37,7 @@ instance = Zernio::AdCreative.new(
   object_type: null,
   object_story_id: null,
   effective_object_story_id: null,
+  page_id: null,
   effective_instagram_media_id: null,
   instagram_user_id: null,
   instagram_permalink_url: null,

data/docs/BoostPostRequestTracking.md

@@ -5,7 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **pixel_id** | **String** |  | [optional] |
-| **url_tags** | [**Array<BoostPostRequestTrackingUrlTagsInner>**](BoostPostRequestTrackingUrlTagsInner.md) | URL parameters appended to the ad link, rendered as `key=value` pairs joined with `&`. | [optional] |
+| **url_tags** | [**Array<BoostPostRequestTrackingUrlTagsInner>**](BoostPostRequestTrackingUrlTagsInner.md) | 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. | [optional] |
 
 ## Example
 

data/docs/CreateStandaloneAdRequestTracking.md

@@ -5,7 +5,7 @@
 | 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] |
+| **url_tags** | [**Array<UpdateAdTrackingTagsRequestUrlTagsInner>**](UpdateAdTrackingTagsRequestUrlTagsInner.md) | 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. | [optional] |
 
 ## Example
 

data/docs/UpdateAdTrackingTagsRequest.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **url_tags** | [**Array<UpdateAdTrackingTagsRequestUrlTagsInner>**](UpdateAdTrackingTagsRequestUrlTagsInner.md) | Meta only. Click-URL params appended to a freshly-rebuilt creative. | [optional] |
+| **url_tags** | [**Array<UpdateAdTrackingTagsRequestUrlTagsInner>**](UpdateAdTrackingTagsRequestUrlTagsInner.md) | 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. | [optional] |
 | **creative** | [**UpdateAdTrackingTagsRequestCreative**](UpdateAdTrackingTagsRequestCreative.md) |  | [optional] |
 | **tracking_url_template** | **String** | Google only. Full tracking template (must contain {lpurl}). | [optional] |
 | **final_url_suffix** | **String** | Google only. Parse-only key=value params. | [optional] |

data/lib/zernio-sdk/api/ad_campaigns_api.rb

@@ -798,6 +798,7 @@ module Zernio
     # @option opts [String] :platform 
     # @option opts [AdStatus] :status Filter by derived campaign status (post-aggregation)
     # @option opts [String] :ad_account_id Platform ad account ID
+    # @option opts [String] :page_id 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.
     # @option opts [String] :account_id Social account ID
     # @option opts [String] :profile_id Profile ID
     # @option opts [String] :campaign_id Restrict the tree to a single campaign by its platform campaign id (the id the platform assigns, e.g. Meta's numeric campaign id). Filters the campaign set itself, so it works regardless of account size and pagination — pass this when you already hold a campaign id instead of paging the tree to find it. Mirrors the `campaignId` filter on GET /v1/ads.
@@ -821,6 +822,7 @@ module Zernio
     # @option opts [String] :platform 
     # @option opts [AdStatus] :status Filter by derived campaign status (post-aggregation)
     # @option opts [String] :ad_account_id Platform ad account ID
+    # @option opts [String] :page_id 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.
     # @option opts [String] :account_id Social account ID
     # @option opts [String] :profile_id Profile ID
     # @option opts [String] :campaign_id Restrict the tree to a single campaign by its platform campaign id (the id the platform assigns, e.g. Meta's numeric campaign id). Filters the campaign set itself, so it works regardless of account size and pagination — pass this when you already hold a campaign id instead of paging the tree to find it. Mirrors the `campaignId` filter on GET /v1/ads.
@@ -877,6 +879,7 @@ module Zernio
       query_params[:'platform'] = opts[:'platform'] if !opts[:'platform'].nil?
       query_params[:'status'] = opts[:'status'] if !opts[:'status'].nil?
       query_params[:'adAccountId'] = opts[:'ad_account_id'] if !opts[:'ad_account_id'].nil?
+      query_params[:'pageId'] = opts[:'page_id'] if !opts[:'page_id'].nil?
       query_params[:'accountId'] = opts[:'account_id'] if !opts[:'account_id'].nil?
       query_params[:'profileId'] = opts[:'profile_id'] if !opts[:'profile_id'].nil?
       query_params[:'campaignId'] = opts[:'campaign_id'] if !opts[:'campaign_id'].nil?
@@ -1009,6 +1012,7 @@ module Zernio
     # @option opts [String] :platform 
     # @option opts [AdStatus] :status Filter by derived campaign status (post-aggregation)
     # @option opts [String] :ad_account_id Platform ad account ID (e.g. act_123 for Meta)
+    # @option opts [String] :page_id 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.
     # @option opts [String] :account_id Social account ID
     # @option opts [String] :profile_id Profile ID
     # @option opts [Date] :from_date Start of metrics date range (YYYY-MM-DD, inclusive). Defaults to 90 days ago when both date params are omitted.
@@ -1028,6 +1032,7 @@ module Zernio
     # @option opts [String] :platform 
     # @option opts [AdStatus] :status Filter by derived campaign status (post-aggregation)
     # @option opts [String] :ad_account_id Platform ad account ID (e.g. act_123 for Meta)
+    # @option opts [String] :page_id 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.
     # @option opts [String] :account_id Social account ID
     # @option opts [String] :profile_id Profile ID
     # @option opts [Date] :from_date Start of metrics date range (YYYY-MM-DD, inclusive). Defaults to 90 days ago when both date params are omitted.
@@ -1068,6 +1073,7 @@ module Zernio
       query_params[:'platform'] = opts[:'platform'] if !opts[:'platform'].nil?
       query_params[:'status'] = opts[:'status'] if !opts[:'status'].nil?
       query_params[:'adAccountId'] = opts[:'ad_account_id'] if !opts[:'ad_account_id'].nil?
+      query_params[:'pageId'] = opts[:'page_id'] if !opts[:'page_id'].nil?
       query_params[:'accountId'] = opts[:'account_id'] if !opts[:'account_id'].nil?
       query_params[:'profileId'] = opts[:'profile_id'] if !opts[:'profile_id'].nil?
       query_params[:'fromDate'] = opts[:'from_date'] if !opts[:'from_date'].nil?
@@ -1231,6 +1237,7 @@ module Zernio
     # @option opts [String] :platform 
     # @option opts [String] :account_id Social account ID
     # @option opts [String] :ad_account_id Platform ad account ID (e.g. act_123 for Meta). Mirrors the same filter on /v1/ads/campaigns and /v1/ads/tree.
+    # @option opts [String] :page_id 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.
     # @option opts [String] :profile_id Profile ID
     # @option opts [String] :campaign_id Platform campaign ID (filter ads within a campaign)
     # @option opts [String] :platform_ad_id Meta ad ID. Returns the ad with this platform-side ad ID.
@@ -1254,6 +1261,7 @@ module Zernio
     # @option opts [String] :platform 
     # @option opts [String] :account_id Social account ID
     # @option opts [String] :ad_account_id Platform ad account ID (e.g. act_123 for Meta). Mirrors the same filter on /v1/ads/campaigns and /v1/ads/tree.
+    # @option opts [String] :page_id 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.
     # @option opts [String] :profile_id Profile ID
     # @option opts [String] :campaign_id Platform campaign ID (filter ads within a campaign)
     # @option opts [String] :platform_ad_id Meta ad ID. Returns the ad with this platform-side ad ID.
@@ -1298,6 +1306,7 @@ module Zernio
       query_params[:'platform'] = opts[:'platform'] if !opts[:'platform'].nil?
       query_params[:'accountId'] = opts[:'account_id'] if !opts[:'account_id'].nil?
       query_params[:'adAccountId'] = opts[:'ad_account_id'] if !opts[:'ad_account_id'].nil?
+      query_params[:'pageId'] = opts[:'page_id'] if !opts[:'page_id'].nil?
       query_params[:'profileId'] = opts[:'profile_id'] if !opts[:'profile_id'].nil?
       query_params[:'campaignId'] = opts[:'campaign_id'] if !opts[:'campaign_id'].nil?
       query_params[:'platformAdId'] = opts[:'platform_ad_id'] if !opts[:'platform_ad_id'].nil?

data/lib/zernio-sdk/models/ad_creative.rb

@@ -37,6 +37,9 @@ module Zernio
     # 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.
     attr_accessor :effective_object_story_id
 
+    # 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.
+    attr_accessor :page_id
+
     # 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.
     attr_accessor :effective_instagram_media_id
 
@@ -77,6 +80,7 @@ module Zernio
         :'object_type' => :'objectType',
         :'object_story_id' => :'objectStoryId',
         :'effective_object_story_id' => :'effectiveObjectStoryId',
+        :'page_id' => :'pageId',
         :'effective_instagram_media_id' => :'effectiveInstagramMediaId',
         :'instagram_user_id' => :'instagramUserId',
         :'instagram_permalink_url' => :'instagramPermalinkUrl',
@@ -111,6 +115,7 @@ module Zernio
         :'object_type' => :'String',
         :'object_story_id' => :'String',
         :'effective_object_story_id' => :'String',
+        :'page_id' => :'String',
         :'effective_instagram_media_id' => :'String',
         :'instagram_user_id' => :'String',
         :'instagram_permalink_url' => :'String',
@@ -132,6 +137,7 @@ module Zernio
         :'video_url',
         :'object_story_id',
         :'effective_object_story_id',
+        :'page_id',
         :'effective_instagram_media_id',
         :'instagram_user_id',
         :'instagram_permalink_url',
@@ -182,6 +188,10 @@ module Zernio
         self.effective_object_story_id = attributes[:'effective_object_story_id']
       end
 
+      if attributes.key?(:'page_id')
+        self.page_id = attributes[:'page_id']
+      end
+
       if attributes.key?(:'effective_instagram_media_id')
         self.effective_instagram_media_id = attributes[:'effective_instagram_media_id']
       end
@@ -256,6 +266,7 @@ module Zernio
           object_type == o.object_type &&
           object_story_id == o.object_story_id &&
           effective_object_story_id == o.effective_object_story_id &&
+          page_id == o.page_id &&
           effective_instagram_media_id == o.effective_instagram_media_id &&
           instagram_user_id == o.instagram_user_id &&
           instagram_permalink_url == o.instagram_permalink_url &&
@@ -278,7 +289,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [thumbnail_url, image_url, video_id, video_url, object_type, object_story_id, effective_object_story_id, effective_instagram_media_id, instagram_user_id, instagram_permalink_url, media_urls, body, google_headline, google_description, link_url, pinterest_image_url, pinterest_title, pinterest_description].hash
+      [thumbnail_url, image_url, video_id, video_url, object_type, object_story_id, effective_object_story_id, page_id, effective_instagram_media_id, instagram_user_id, instagram_permalink_url, media_urls, body, google_headline, google_description, link_url, pinterest_image_url, pinterest_title, pinterest_description].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/boost_post_request_tracking.rb

@@ -18,7 +18,7 @@ module Zernio
   class BoostPostRequestTracking < ApiModelBase
     attr_accessor :pixel_id
 
-    # 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.
     attr_accessor :url_tags
 
     # Attribute mapping from ruby-style variable name to JSON key.

data/lib/zernio-sdk/models/create_standalone_ad_request_tracking.rb

@@ -19,7 +19,7 @@ module Zernio
     # Meta Pixel ID to attach for offsite-conversion measurement.
     attr_accessor :pixel_id
 
-    # 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.
     attr_accessor :url_tags
 
     # Attribute mapping from ruby-style variable name to JSON key.

data/lib/zernio-sdk/models/update_ad_tracking_tags_request.rb

@@ -15,7 +15,7 @@ require 'time'
 
 module Zernio
   class UpdateAdTrackingTagsRequest < ApiModelBase
-    # 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.
     attr_accessor :url_tags
 
     attr_accessor :creative

data/lib/zernio-sdk/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.19.0
 =end
 
 module Zernio
-  VERSION = '0.0.614'
+  VERSION = '0.0.616'
 end

data/openapi.yaml

@@ -6881,6 +6881,7 @@ components:
             objectType: { type: string, description: "Meta creative object_type (e.g. SHARE, VIDEO, PRIVACY_CHECK_FAIL, POST_DELETED). Use this to render state-aware previews — when Meta moderation strips image/video fields, only thumbnailUrl at 64x64 is available." }
             objectStoryId: { type: [string, "null"], description: "Meta creative `object_story_id` (the SHARE reference). Frequently absent — Meta omits it for SHARE creatives. Use effectiveObjectStoryId instead." }
             effectiveObjectStoryId: { type: [string, "null"], description: "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." }
+            pageId: { type: [string, "null"], description: "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." }
             effectiveInstagramMediaId: { type: [string, "null"], description: "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." }
             instagramUserId: { type: [string, "null"], description: "Meta `instagram_user_id` — the Instagram-scoped business ID that owns the boosted media." }
             instagramPermalinkUrl: { type: [string, "null"], description: "Meta `instagram_permalink_url` — public Instagram post URL of the boosted media." }
@@ -34403,6 +34404,7 @@ paths:
         - { name: platform, in: query, schema: { type: string, enum: [facebook, instagram, tiktok, linkedin, pinterest, google, twitter, openai] } }
         - { name: accountId, in: query, schema: { type: string }, description: Social account ID }
         - { name: adAccountId, in: query, schema: { type: string }, description: "Platform ad account ID (e.g. act_123 for Meta). Mirrors the same filter on /v1/ads/campaigns and /v1/ads/tree." }
+        - { name: pageId, in: query, schema: { type: string }, description: "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." }
         - { name: profileId, in: query, schema: { type: string }, description: Profile ID }
         - { name: campaignId, in: query, schema: { type: string }, description: Platform campaign ID (filter ads within a campaign) }
         - { name: platformAdId, in: query, schema: { type: string }, description: "Meta ad ID. Returns the ad with this platform-side ad ID." }
@@ -34517,6 +34519,7 @@ paths:
         - { name: platform, in: query, schema: { type: string, enum: [facebook, instagram, tiktok, linkedin, pinterest, google, twitter, openai] } }
         - { name: status, in: query, schema: { $ref: '#/components/schemas/AdStatus' }, description: Filter by derived campaign status (post-aggregation) }
         - { name: adAccountId, in: query, schema: { type: string }, description: Platform ad account ID (e.g. act_123 for Meta) }
+        - { name: pageId, in: query, schema: { type: string }, description: "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." }
         - { name: accountId, in: query, schema: { type: string }, description: Social account ID }
         - { name: profileId, in: query, schema: { type: string }, description: Profile ID }
         - { name: fromDate, in: query, schema: { type: string, format: date }, description: "Start of metrics date range (YYYY-MM-DD, inclusive). Defaults to 90 days ago when both date params are omitted." }
@@ -35186,6 +35189,7 @@ paths:
         - { name: platform, in: query, schema: { type: string, enum: [facebook, instagram, tiktok, linkedin, pinterest, google, twitter, openai] } }
         - { name: status, in: query, schema: { $ref: '#/components/schemas/AdStatus' }, description: Filter by derived campaign status (post-aggregation) }
         - { name: adAccountId, in: query, schema: { type: string }, description: Platform ad account ID }
+        - { name: pageId, in: query, schema: { type: string }, description: "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." }
         - { name: accountId, in: query, schema: { type: string }, description: Social account ID }
         - { name: profileId, in: query, schema: { type: string }, description: Profile ID }
         - { name: campaignId, in: query, schema: { type: string }, description: "Restrict the tree to a single campaign by its platform campaign id (the id the platform assigns, e.g. Meta's numeric campaign id). Filters the campaign set itself, so it works regardless of account size and pagination — pass this when you already hold a campaign id instead of paging the tree to find it. Mirrors the `campaignId` filter on GET /v1/ads." }
@@ -36069,7 +36073,7 @@ paths:
               properties:
                 urlTags:
                   type: array
-                  description: "Meta only. Click-URL params appended to a freshly-rebuilt creative."
+                  description: "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."
                   items:
                     type: object
                     required: [key, value]
@@ -37115,7 +37119,7 @@ paths:
                     pixelId: { type: string }
                     urlTags:
                       type: array
-                      description: 'URL parameters appended to the ad link, rendered as `key=value` pairs joined with `&`.'
+                      description: '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.'
                       items:
                         type: object
                         properties:
@@ -37260,7 +37264,7 @@ paths:
                     pixelId: { type: string, description: "Meta Pixel ID to attach for offsite-conversion measurement." }
                     urlTags:
                       type: array
-                      description: "Click-URL params appended to the ad's destination as `url_tags` (e.g. utm_source)."
+                      description: "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."
                       items:
                         type: object
                         required: [key, value]

data/spec/api/ad_campaigns_api_spec.rb

@@ -181,6 +181,7 @@ describe 'AdCampaignsApi' do
   # @option opts [String] :platform 
   # @option opts [AdStatus] :status Filter by derived campaign status (post-aggregation)
   # @option opts [String] :ad_account_id Platform ad account ID
+  # @option opts [String] :page_id 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.
   # @option opts [String] :account_id Social account ID
   # @option opts [String] :profile_id Profile ID
   # @option opts [String] :campaign_id Restrict the tree to a single campaign by its platform campaign id (the id the platform assigns, e.g. Meta's numeric campaign id). Filters the campaign set itself, so it works regardless of account size and pagination — pass this when you already hold a campaign id instead of paging the tree to find it. Mirrors the `campaignId` filter on GET /v1/ads.
@@ -222,6 +223,7 @@ describe 'AdCampaignsApi' do
   # @option opts [String] :platform 
   # @option opts [AdStatus] :status Filter by derived campaign status (post-aggregation)
   # @option opts [String] :ad_account_id Platform ad account ID (e.g. act_123 for Meta)
+  # @option opts [String] :page_id 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.
   # @option opts [String] :account_id Social account ID
   # @option opts [String] :profile_id Profile ID
   # @option opts [Date] :from_date Start of metrics date range (YYYY-MM-DD, inclusive). Defaults to 90 days ago when both date params are omitted.
@@ -266,6 +268,7 @@ describe 'AdCampaignsApi' do
   # @option opts [String] :platform 
   # @option opts [String] :account_id Social account ID
   # @option opts [String] :ad_account_id Platform ad account ID (e.g. act_123 for Meta). Mirrors the same filter on /v1/ads/campaigns and /v1/ads/tree.
+  # @option opts [String] :page_id 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.
   # @option opts [String] :profile_id Profile ID
   # @option opts [String] :campaign_id Platform campaign ID (filter ads within a campaign)
   # @option opts [String] :platform_ad_id Meta ad ID. Returns the ad with this platform-side ad ID.

data/spec/models/ad_creative_spec.rb

@@ -69,6 +69,12 @@ describe Zernio::AdCreative do
     end
   end
 
+  describe 'test attribute "page_id"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "effective_instagram_media_id"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: late-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.614
+  version: 0.0.616
 platform: ruby
 authors:
 - OpenAPI-Generator
@@ -4886,7 +4886,7 @@ files:
 - spec/models/you_tube_video_retention_response_retention_curve_inner_spec.rb
 - spec/models/you_tube_video_retention_response_spec.rb
 - spec/spec_helper.rb
-- zernio-sdk-0.0.614.gem
+- zernio-sdk-0.0.616.gem
 - zernio-sdk.gemspec
 homepage: https://openapi-generator.tech
 licenses: