@zernio/node 0.2.968 → 0.2.970

package/dist/index.d.mts

@@ -10258,9 +10258,20 @@ type platform10 = 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' |
  */
 type StorePixelInstall = {
     storeAccountId?: string;
+    /**
+     * The store platform.
+     */
     platform?: 'shopify' | 'wordpress';
     /**
-     * Shopify: this tag is the pixel the store fires. WordPress: the Zernio widget for this tag is in an active widget area with its script intact.
+     * Platform of the tag this install is about (e.g. `metaads`).
+     */
+    tagPlatform?: string;
+    /**
+     * The id the tag carries on the site (see `TrackingTag.siteTagId`).
+     */
+    siteTagId?: string;
+    /**
+     * Shopify: this tag is the one the store fires for its platform. WordPress: the Zernio widget for this tag is in an active widget area with its script intact.
      */
     installed?: boolean;
     /**
@@ -10268,9 +10279,28 @@ type StorePixelInstall = {
      */
     shopDomain?: string;
     /**
-     * Shopify only: the Meta pixel the store fires now (may be a different tag), or null.
+     * Shopify only: the tag of the same platform the store fires now (may be a different tag), or null.
      */
     installedTagId?: (string) | null;
+    /**
+     * GET only on WordPress, always on Shopify: every Zernio tag on the store, all platforms.
+     */
+    tags?: Array<{
+        platform?: string;
+        siteTagId?: string;
+        /**
+         * WordPress only.
+         */
+        widgetId?: string;
+        /**
+         * WordPress only.
+         */
+        sidebarId?: string;
+        /**
+         * WordPress only: false when the widget sits outside an active widget area.
+         */
+        active?: boolean;
+    }>;
     /**
      * Shopify only: web pixel id, or null when nothing is installed.
      */
@@ -10784,11 +10814,31 @@ type mediaType2 = 'video' | 'photo';
  */
 type TrackingTag = {
     /**
-     * Platform-native tag id. Meta: numeric pixel id, as a string.
+     * Platform-native tag id, the `{tagId}` of the per-tag routes. Meta: numeric pixel id, as a string. OpenAI: the pixel resource id.
      */
     id: string;
+    /**
+     * The id the on-site code carries. Equals `id` on Meta; differs on platforms with separate API and site ids (OpenAI `pixel_id`).
+     */
+    siteTagId?: string;
+    /**
+     * Platforms where each conversion is its own object: the tag's conversion events, with the id a site sends for each.
+     */
+    events?: Array<{
+        id: string;
+        name: string;
+        /**
+         * Platform category of the event.
+         */
+        type?: string;
+        /**
+         * The value the site sends to fire this event.
+         */
+        siteEvent?: string;
+        status?: string;
+    }>;
     name: string;
-    platform: 'metaads';
+    platform: 'metaads' | 'openaiads';
     /**
      * Platform-native flavor of the tag (Meta: `pixel`).
      */
@@ -10798,8 +10848,9 @@ type TrackingTag = {
      */
     status: 'active' | 'inactive';
     /**
-     * The base-code `<script>` snippet to install on the site. Meta only;
-     * populated by `getTrackingTag`, omitted from the list view.
+     * The base-code `<script>` snippet to install on the site, including
+     * the page-view call. Populated by `getTrackingTag`, omitted from the
+     * list view.
      *
      */
     code?: string;
@@ -10833,7 +10884,7 @@ type TrackingTag = {
      */
     ownerAdAccountId?: string;
 };
-type platform11 = 'metaads';
+type platform11 = 'metaads' | 'openaiads';
 /**
  * Platform-native flavor of the tag (Meta: `pixel`).
  */
@@ -21905,9 +21956,9 @@ type GrantBusinessPartnerData = {
          */
         businessId: string;
         /**
-         * Tasks granted on the Page. Defaults to ADVERTISE and ANALYZE.
+         * Tasks granted on the Page, Meta's permitted_tasks vocabulary. Defaults to ADVERTISE and ANALYZE. The bare names are what Business Settings shows; the PROFILE_PLUS_ names are the New Pages Experience tasks and the only way to grant FACEBOOK_ACCESS or REVENUE. Granting MANAGE also yields MANAGE_LEADS.
          */
-        permittedTasks?: Array<('MANAGE' | 'CREATE_CONTENT' | 'MODERATE' | 'MESSAGING' | 'ADVERTISE' | 'ANALYZE')>;
+        permittedTasks?: Array<('MANAGE' | 'CREATE_CONTENT' | 'MODERATE' | 'MESSAGING' | 'ADVERTISE' | 'ANALYZE' | 'MODERATE_COMMUNITY' | 'MANAGE_JOBS' | 'PAGES_MESSAGING' | 'PAGES_MESSAGING_SUBSCRIPTIONS' | 'READ_PAGE_MAILBOXES' | 'VIEW_MONETIZATION_INSIGHTS' | 'MANAGE_LEADS' | 'CASHIER_ROLE' | 'GLOBAL_STRUCTURE_MANAGEMENT' | 'PROFILE_PLUS_FULL_CONTROL' | 'PROFILE_PLUS_MANAGE' | 'PROFILE_PLUS_FACEBOOK_ACCESS' | 'PROFILE_PLUS_CREATE_CONTENT' | 'PROFILE_PLUS_MODERATE' | 'PROFILE_PLUS_MODERATE_DELEGATE_COMMUNITY' | 'PROFILE_PLUS_MESSAGING' | 'PROFILE_PLUS_ADVERTISE' | 'PROFILE_PLUS_ANALYZE' | 'PROFILE_PLUS_REVENUE' | 'PROFILE_PLUS_MANAGE_LEADS' | 'PROFILE_PLUS_CREATIVE_MANAGEMENT' | 'PROFILE_PLUS_CREATOR_MANAGEMENT' | 'PROFILE_PLUS_GLOBAL_STRUCTURE_MANAGEMENT')>;
     };
     path: {
         /**
@@ -47772,10 +47823,16 @@ type GetTrackingTagData = {
     path: {
         accountId: string;
         /**
-         * Pixel id.
+         * Tag id (`TrackingTag.id`).
          */
         tagId: string;
     };
+    query?: {
+        /**
+         * Scopes the lookup on platforms whose tag ids live inside an ad account. Ignored elsewhere.
+         */
+        adAccountId?: string;
+    };
 };
 type GetTrackingTagResponse = ({
     platform?: 'metaads';
@@ -47786,6 +47843,10 @@ type GetTrackingTagError = (ErrorResponse | {
 } | unknown);
 type UpdateTrackingTagData = {
     body: {
+        /**
+         * Scopes the lookup on platforms whose tag ids live inside an ad account. Ignored elsewhere.
+         */
+        adAccountId?: string;
         name?: string;
         /**
          * Meta Advanced Matching toggle (`enable_automatic_matching`).
@@ -47880,6 +47941,10 @@ type InstallTrackingTagOnStoreData = {
          * The connected Shopify (`shopify`) or WordPress (`wordpress`) account id.
          */
         storeAccountId: string;
+        /**
+         * Scopes the tag lookup on platforms whose tag ids live inside an ad account. Ignored elsewhere.
+         */
+        adAccountId?: string;
         /**
          * WordPress only: widget area to use (see `install.preflight.sidebars` from GET). Defaults to a footer area.
          */
@@ -47892,7 +47957,7 @@ type InstallTrackingTagOnStoreData = {
     path: {
         accountId: string;
         /**
-         * Meta pixel id.
+         * Tag id (`TrackingTag.id`).
          */
         tagId: string;
     };
@@ -47934,11 +47999,15 @@ type GetTrackingTagStoreInstallData = {
     path: {
         accountId: string;
         /**
-         * Meta pixel id.
+         * Tag id (`TrackingTag.id`).
          */
         tagId: string;
     };
     query: {
+        /**
+         * Scopes the tag lookup on platforms whose tag ids live inside an ad account.
+         */
+        adAccountId?: string;
         /**
          * The connected Shopify or WordPress account id.
          */
@@ -47977,11 +48046,15 @@ type RemoveTrackingTagFromStoreData = {
     path: {
         accountId: string;
         /**
-         * Meta pixel id.
+         * Tag id (`TrackingTag.id`).
          */
         tagId: string;
     };
     query: {
+        /**
+         * Scopes the tag lookup on platforms whose tag ids live inside an ad account.
+         */
+        adAccountId?: string;
         /**
          * The connected Shopify or WordPress account id.
          */
@@ -48004,13 +48077,17 @@ type GetTrackingTagStatsData = {
     path: {
         accountId: string;
         /**
-         * Pixel id.
+         * Tag id (`TrackingTag.id`).
          */
         tagId: string;
     };
     query?: {
         /**
-         * Aggregation dimension. Defaults to `event`.
+         * Scopes the lookup on platforms whose tag ids live inside an ad account. Ignored elsewhere.
+         */
+        adAccountId?: string;
+        /**
+         * Meta only (400 on other platforms): aggregation dimension. Defaults to `event`.
          */
         aggregation?: 'event' | 'host' | 'url' | 'url_by_rule' | 'pixel_fire' | 'device_type' | 'device_os' | 'browser_type' | 'had_pii' | 'custom_data_field' | 'match_keys' | 'event_source' | 'event_detection_method' | 'event_processing_results' | 'event_total_counts' | 'event_value_count';
         /**

package/dist/index.d.ts

@@ -10258,9 +10258,20 @@ type platform10 = 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' |
  */
 type StorePixelInstall = {
     storeAccountId?: string;
+    /**
+     * The store platform.
+     */
     platform?: 'shopify' | 'wordpress';
     /**
-     * Shopify: this tag is the pixel the store fires. WordPress: the Zernio widget for this tag is in an active widget area with its script intact.
+     * Platform of the tag this install is about (e.g. `metaads`).
+     */
+    tagPlatform?: string;
+    /**
+     * The id the tag carries on the site (see `TrackingTag.siteTagId`).
+     */
+    siteTagId?: string;
+    /**
+     * Shopify: this tag is the one the store fires for its platform. WordPress: the Zernio widget for this tag is in an active widget area with its script intact.
      */
     installed?: boolean;
     /**
@@ -10268,9 +10279,28 @@ type StorePixelInstall = {
      */
     shopDomain?: string;
     /**
-     * Shopify only: the Meta pixel the store fires now (may be a different tag), or null.
+     * Shopify only: the tag of the same platform the store fires now (may be a different tag), or null.
      */
     installedTagId?: (string) | null;
+    /**
+     * GET only on WordPress, always on Shopify: every Zernio tag on the store, all platforms.
+     */
+    tags?: Array<{
+        platform?: string;
+        siteTagId?: string;
+        /**
+         * WordPress only.
+         */
+        widgetId?: string;
+        /**
+         * WordPress only.
+         */
+        sidebarId?: string;
+        /**
+         * WordPress only: false when the widget sits outside an active widget area.
+         */
+        active?: boolean;
+    }>;
     /**
      * Shopify only: web pixel id, or null when nothing is installed.
      */
@@ -10784,11 +10814,31 @@ type mediaType2 = 'video' | 'photo';
  */
 type TrackingTag = {
     /**
-     * Platform-native tag id. Meta: numeric pixel id, as a string.
+     * Platform-native tag id, the `{tagId}` of the per-tag routes. Meta: numeric pixel id, as a string. OpenAI: the pixel resource id.
      */
     id: string;
+    /**
+     * The id the on-site code carries. Equals `id` on Meta; differs on platforms with separate API and site ids (OpenAI `pixel_id`).
+     */
+    siteTagId?: string;
+    /**
+     * Platforms where each conversion is its own object: the tag's conversion events, with the id a site sends for each.
+     */
+    events?: Array<{
+        id: string;
+        name: string;
+        /**
+         * Platform category of the event.
+         */
+        type?: string;
+        /**
+         * The value the site sends to fire this event.
+         */
+        siteEvent?: string;
+        status?: string;
+    }>;
     name: string;
-    platform: 'metaads';
+    platform: 'metaads' | 'openaiads';
     /**
      * Platform-native flavor of the tag (Meta: `pixel`).
      */
@@ -10798,8 +10848,9 @@ type TrackingTag = {
      */
     status: 'active' | 'inactive';
     /**
-     * The base-code `<script>` snippet to install on the site. Meta only;
-     * populated by `getTrackingTag`, omitted from the list view.
+     * The base-code `<script>` snippet to install on the site, including
+     * the page-view call. Populated by `getTrackingTag`, omitted from the
+     * list view.
      *
      */
     code?: string;
@@ -10833,7 +10884,7 @@ type TrackingTag = {
      */
     ownerAdAccountId?: string;
 };
-type platform11 = 'metaads';
+type platform11 = 'metaads' | 'openaiads';
 /**
  * Platform-native flavor of the tag (Meta: `pixel`).
  */
@@ -21905,9 +21956,9 @@ type GrantBusinessPartnerData = {
          */
         businessId: string;
         /**
-         * Tasks granted on the Page. Defaults to ADVERTISE and ANALYZE.
+         * Tasks granted on the Page, Meta's permitted_tasks vocabulary. Defaults to ADVERTISE and ANALYZE. The bare names are what Business Settings shows; the PROFILE_PLUS_ names are the New Pages Experience tasks and the only way to grant FACEBOOK_ACCESS or REVENUE. Granting MANAGE also yields MANAGE_LEADS.
          */
-        permittedTasks?: Array<('MANAGE' | 'CREATE_CONTENT' | 'MODERATE' | 'MESSAGING' | 'ADVERTISE' | 'ANALYZE')>;
+        permittedTasks?: Array<('MANAGE' | 'CREATE_CONTENT' | 'MODERATE' | 'MESSAGING' | 'ADVERTISE' | 'ANALYZE' | 'MODERATE_COMMUNITY' | 'MANAGE_JOBS' | 'PAGES_MESSAGING' | 'PAGES_MESSAGING_SUBSCRIPTIONS' | 'READ_PAGE_MAILBOXES' | 'VIEW_MONETIZATION_INSIGHTS' | 'MANAGE_LEADS' | 'CASHIER_ROLE' | 'GLOBAL_STRUCTURE_MANAGEMENT' | 'PROFILE_PLUS_FULL_CONTROL' | 'PROFILE_PLUS_MANAGE' | 'PROFILE_PLUS_FACEBOOK_ACCESS' | 'PROFILE_PLUS_CREATE_CONTENT' | 'PROFILE_PLUS_MODERATE' | 'PROFILE_PLUS_MODERATE_DELEGATE_COMMUNITY' | 'PROFILE_PLUS_MESSAGING' | 'PROFILE_PLUS_ADVERTISE' | 'PROFILE_PLUS_ANALYZE' | 'PROFILE_PLUS_REVENUE' | 'PROFILE_PLUS_MANAGE_LEADS' | 'PROFILE_PLUS_CREATIVE_MANAGEMENT' | 'PROFILE_PLUS_CREATOR_MANAGEMENT' | 'PROFILE_PLUS_GLOBAL_STRUCTURE_MANAGEMENT')>;
     };
     path: {
         /**
@@ -47772,10 +47823,16 @@ type GetTrackingTagData = {
     path: {
         accountId: string;
         /**
-         * Pixel id.
+         * Tag id (`TrackingTag.id`).
          */
         tagId: string;
     };
+    query?: {
+        /**
+         * Scopes the lookup on platforms whose tag ids live inside an ad account. Ignored elsewhere.
+         */
+        adAccountId?: string;
+    };
 };
 type GetTrackingTagResponse = ({
     platform?: 'metaads';
@@ -47786,6 +47843,10 @@ type GetTrackingTagError = (ErrorResponse | {
 } | unknown);
 type UpdateTrackingTagData = {
     body: {
+        /**
+         * Scopes the lookup on platforms whose tag ids live inside an ad account. Ignored elsewhere.
+         */
+        adAccountId?: string;
         name?: string;
         /**
          * Meta Advanced Matching toggle (`enable_automatic_matching`).
@@ -47880,6 +47941,10 @@ type InstallTrackingTagOnStoreData = {
          * The connected Shopify (`shopify`) or WordPress (`wordpress`) account id.
          */
         storeAccountId: string;
+        /**
+         * Scopes the tag lookup on platforms whose tag ids live inside an ad account. Ignored elsewhere.
+         */
+        adAccountId?: string;
         /**
          * WordPress only: widget area to use (see `install.preflight.sidebars` from GET). Defaults to a footer area.
          */
@@ -47892,7 +47957,7 @@ type InstallTrackingTagOnStoreData = {
     path: {
         accountId: string;
         /**
-         * Meta pixel id.
+         * Tag id (`TrackingTag.id`).
          */
         tagId: string;
     };
@@ -47934,11 +47999,15 @@ type GetTrackingTagStoreInstallData = {
     path: {
         accountId: string;
         /**
-         * Meta pixel id.
+         * Tag id (`TrackingTag.id`).
          */
         tagId: string;
     };
     query: {
+        /**
+         * Scopes the tag lookup on platforms whose tag ids live inside an ad account.
+         */
+        adAccountId?: string;
         /**
          * The connected Shopify or WordPress account id.
          */
@@ -47977,11 +48046,15 @@ type RemoveTrackingTagFromStoreData = {
     path: {
         accountId: string;
         /**
-         * Meta pixel id.
+         * Tag id (`TrackingTag.id`).
          */
         tagId: string;
     };
     query: {
+        /**
+         * Scopes the tag lookup on platforms whose tag ids live inside an ad account.
+         */
+        adAccountId?: string;
         /**
          * The connected Shopify or WordPress account id.
          */
@@ -48004,13 +48077,17 @@ type GetTrackingTagStatsData = {
     path: {
         accountId: string;
         /**
-         * Pixel id.
+         * Tag id (`TrackingTag.id`).
          */
         tagId: string;
     };
     query?: {
         /**
-         * Aggregation dimension. Defaults to `event`.
+         * Scopes the lookup on platforms whose tag ids live inside an ad account. Ignored elsewhere.
+         */
+        adAccountId?: string;
+        /**
+         * Meta only (400 on other platforms): aggregation dimension. Defaults to `event`.
          */
         aggregation?: 'event' | 'host' | 'url' | 'url_by_rule' | 'pixel_fire' | 'device_type' | 'device_os' | 'browser_type' | 'had_pii' | 'custom_data_field' | 'match_keys' | 'event_source' | 'event_detection_method' | 'event_processing_results' | 'event_total_counts' | 'event_value_count';
         /**

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -13442,7 +13442,7 @@ export const startBusinessAgentEvalRun = <ThrowOnError extends boolean = false>(
  * only; OpenAI Ads has no get-by-id endpoint).
  *
  * Meta (platform `metaads`) and OpenAI Ads (platform `openaiads`); other
- * platforms return 405. The `accountId` must be the ads SocialAccount
+ * platforms return 501. The `accountId` must be the ads SocialAccount
  * created by the Ads add-on connect flow (Meta) or the OpenAI Ads
  * connect flow, not a Facebook/Instagram posting account. Get your Meta
  * `act_...` ids from `GET /v1/ads/accounts`; `adAccountId` is ignored for
@@ -13485,7 +13485,7 @@ export const listTrackingTags = <ThrowOnError extends boolean = false>(options:
  * for OpenAI, a new Conversions API key plus, with `defaultEventType`, a
  * new conversion event setting). Do not retry blindly on
  * timeout. Meta (platform `metaads`) and OpenAI Ads (platform
- * `openaiads`); other platforms return 405.
+ * `openaiads`); other platforms return 501.
  *
  */
 export const createTrackingTag = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateTrackingTagData, ThrowOnError>) => {
@@ -13499,8 +13499,8 @@ export const createTrackingTag = <ThrowOnError extends boolean = false>(options:
  * Get a tracking tag
  * Returns the full tag record including the base-code `code` snippet,
  * `lastFiredTime`, `ownerBusinessId`, `isUnavailable`, etc. Meta only
- * (platform `metaads`); other platforms return 405. OpenAI Ads has no
- * get-by-id endpoint, so it 405s here too. Use
+ * (platform `metaads`); other platforms return 501. OpenAI Ads has no
+ * get-by-id endpoint, so it answers 501 here too. Use
  * `GET /v1/accounts/{accountId}/tracking-tags` (list) instead.
  *
  */
@@ -13517,7 +13517,7 @@ export const getTrackingTag = <ThrowOnError extends boolean = false>(options: Op
  * `enableAutomaticMatching`, `automaticMatchingFields`,
  * `firstPartyCookieStatus`, `dataUseSetting`. At least one is required.
  * Returns the re-fetched canonical tag. Meta only (platform `metaads`);
- * other platforms return 405.
+ * other platforms return 501.
  *
  * There is no DELETE: Meta has no API to delete a pixel. To stop using
  * one, unshare it from your ad accounts (`DELETE
@@ -13534,7 +13534,7 @@ export const updateTrackingTag = <ThrowOnError extends boolean = false>(options:
 
 /**
  * List accounts it is shared with
- * Meta only (platform `metaads`); other platforms return 405.
+ * Meta only (platform `metaads`); other platforms return 501.
  */
 export const listTrackingTagSharedAccounts = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListTrackingTagSharedAccountsData, ThrowOnError>) => {
     return (options?.client ?? client).get<ListTrackingTagSharedAccountsResponse, ListTrackingTagSharedAccountsError, ThrowOnError>({
@@ -13549,7 +13549,7 @@ export const listTrackingTagSharedAccounts = <ThrowOnError extends boolean = fal
  * account can use it. Requires that you administer both the pixel's owning
  * Business Manager and the target ad account; a pixel on a personal
  * (non-BM) ad account can't be shared (Meta will reject the call). Meta
- * only (platform `metaads`); other platforms return 405.
+ * only (platform `metaads`); other platforms return 501.
  *
  */
 export const addTrackingTagSharedAccount = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<AddTrackingTagSharedAccountData, ThrowOnError>) => {
@@ -13563,7 +13563,7 @@ export const addTrackingTagSharedAccount = <ThrowOnError extends boolean = false
  * Stop sharing with an account
  * `adAccountId` may be passed as a query parameter (recommended) or as a
  * JSON body field for clients that can send DELETE bodies. Meta only
- * (platform `metaads`); other platforms return 405.
+ * (platform `metaads`); other platforms return 501.
  *
  */
 export const removeTrackingTagSharedAccount = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<RemoveTrackingTagSharedAccountData, ThrowOnError>) => {
@@ -13582,15 +13582,16 @@ export const removeTrackingTagSharedAccount = <ThrowOnError extends boolean = fa
  * Purchase uses `shopify_order_{orderId}` as its event id, so a Conversions API Purchase
  * you send for the same order with that `eventId` is deduplicated by Meta.
  *
- * Idempotent: a store runs one Zernio pixel, so calling it again updates the install and
- * installing a different tag replaces the previous one (reported in `replacedTagId`).
+ * Idempotent: a store runs one Zernio web pixel holding one tag per platform, so calling
+ * it again updates the install, installing a different tag of the same platform replaces
+ * the previous one (reported in `replacedTagId`), and other platforms' tags are kept.
  * Events respect the store's customer privacy settings (marketing consent).
  *
  * `accountId` is the Meta ads account that owns the pixel (`tagId`); `storeAccountId` is the
  * Shopify account. Stores connected before pixel support must re-approve the Zernio app:
  * the call then answers 409 `reconnect_required` with `details.authUrl` to send the
  * merchant to (the Shopify account id stays the same). Meta only (platform `metaads`);
- * other platforms return 405.
+ * other platforms return 501.
  *
  * **WordPress** (`storeAccountId` is a connected WordPress.com or self-hosted site): Zernio
  * adds a Custom HTML widget with the Meta pixel base code (fbevents.js, `init`, `PageView`)
@@ -13621,14 +13622,16 @@ export const installTrackingTagOnStore = <ThrowOnError extends boolean = false>(
 
 /**
  * Get store install status
- * Whether this pixel is the one the Shopify store fires. `installedTagId` names the pixel
- * the store currently fires, which can be a different tag. Meta only (platform `metaads`).
+ * Whether this tag is the one the Shopify store fires for its platform. `installedTagId`
+ * names the tag of that platform the store currently fires, which can be a different tag,
+ * and `tags` lists every Zernio tag on the store (all platforms).
  *
  * WordPress: whether the Zernio widget for this pixel is live (in an active widget area,
  * script intact), plus a read-only `preflight` with the theme's widget areas and, when an
  * install would be blocked, the `reason` POST would return. The preflight reads
  * capabilities only, so `ready: true` is not a guarantee: `DISALLOW_UNFILTERED_HTML` or a
  * multisite admin who is not a Super Admin still strips the script, which POST detects.
+ * `tags` lists every Zernio widget on the site (all platforms, with `active`).
  *
  */
 export const getTrackingTagStoreInstall = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetTrackingTagStoreInstallData, ThrowOnError>) => {
@@ -13640,9 +13643,10 @@ export const getTrackingTagStoreInstall = <ThrowOnError extends boolean = false>
 
 /**
  * Remove from a Shopify store or WordPress site
- * Removes the pixel from the store. Idempotent: nothing installed returns 200 with
- * `installed: false`. If the store fires a different pixel, nothing is removed and the
- * call answers 409 `invalid_resource_state`. Meta only (platform `metaads`).
+ * Removes the tag from the store. Idempotent: nothing installed returns 200 with
+ * `installed: false`. If the store fires a different tag of the same platform, nothing is
+ * removed and the call answers 409 `invalid_resource_state`. Shopify: other platforms'
+ * tags stay; the web pixel itself is deleted once no tag remains.
  *
  * WordPress: deletes every widget Zernio created for this pixel and reports how many in
  * `removed` (0 when nothing was installed). Pixel code added by hand is left alone.
@@ -13657,10 +13661,10 @@ export const removeTrackingTagFromStore = <ThrowOnError extends boolean = false>
 
 /**
  * Get aggregated event stats
- * Returns aggregated event counts for the pixel (`GET /{pixel_id}/stats`).
- * Rows are passed through from Meta as-is; their shape depends on the
- * `aggregation` requested. Meta only (platform `metaads`); other platforms
- * return 405.
+ * Returns event counts / health for the tag, where the platform exposes
+ * them. Meta: aggregated counts (`GET /{pixel_id}/stats`), rows passed
+ * through as-is; their shape depends on the `aggregation` requested.
+ * Platforms without a stats API answer 501.
  *
  */
 export const getTrackingTagStats = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetTrackingTagStatsData, ThrowOnError>) => {

package/src/generated/types.gen.ts

@@ -8797,9 +8797,20 @@ export type platform10 = 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'link
  */
 export type StorePixelInstall = {
     storeAccountId?: string;
+    /**
+     * The store platform.
+     */
     platform?: 'shopify' | 'wordpress';
     /**
-     * Shopify: this tag is the pixel the store fires. WordPress: the Zernio widget for this tag is in an active widget area with its script intact.
+     * Platform of the tag this install is about (e.g. `metaads`).
+     */
+    tagPlatform?: string;
+    /**
+     * The id the tag carries on the site (see `TrackingTag.siteTagId`).
+     */
+    siteTagId?: string;
+    /**
+     * Shopify: this tag is the one the store fires for its platform. WordPress: the Zernio widget for this tag is in an active widget area with its script intact.
      */
     installed?: boolean;
     /**
@@ -8807,9 +8818,28 @@ export type StorePixelInstall = {
      */
     shopDomain?: string;
     /**
-     * Shopify only: the Meta pixel the store fires now (may be a different tag), or null.
+     * Shopify only: the tag of the same platform the store fires now (may be a different tag), or null.
      */
     installedTagId?: (string) | null;
+    /**
+     * GET only on WordPress, always on Shopify: every Zernio tag on the store, all platforms.
+     */
+    tags?: Array<{
+        platform?: string;
+        siteTagId?: string;
+        /**
+         * WordPress only.
+         */
+        widgetId?: string;
+        /**
+         * WordPress only.
+         */
+        sidebarId?: string;
+        /**
+         * WordPress only: false when the widget sits outside an active widget area.
+         */
+        active?: boolean;
+    }>;
     /**
      * Shopify only: web pixel id, or null when nothing is installed.
      */
@@ -9335,11 +9365,31 @@ export type mediaType2 = 'video' | 'photo';
  */
 export type TrackingTag = {
     /**
-     * Platform-native tag id. Meta: numeric pixel id, as a string.
+     * Platform-native tag id, the `{tagId}` of the per-tag routes. Meta: numeric pixel id, as a string. OpenAI: the pixel resource id.
      */
     id: string;
+    /**
+     * The id the on-site code carries. Equals `id` on Meta; differs on platforms with separate API and site ids (OpenAI `pixel_id`).
+     */
+    siteTagId?: string;
+    /**
+     * Platforms where each conversion is its own object: the tag's conversion events, with the id a site sends for each.
+     */
+    events?: Array<{
+        id: string;
+        name: string;
+        /**
+         * Platform category of the event.
+         */
+        type?: string;
+        /**
+         * The value the site sends to fire this event.
+         */
+        siteEvent?: string;
+        status?: string;
+    }>;
     name: string;
-    platform: 'metaads';
+    platform: 'metaads' | 'openaiads';
     /**
      * Platform-native flavor of the tag (Meta: `pixel`).
      */
@@ -9349,8 +9399,9 @@ export type TrackingTag = {
      */
     status: 'active' | 'inactive';
     /**
-     * The base-code `<script>` snippet to install on the site. Meta only;
-     * populated by `getTrackingTag`, omitted from the list view.
+     * The base-code `<script>` snippet to install on the site, including
+     * the page-view call. Populated by `getTrackingTag`, omitted from the
+     * list view.
      *
      */
     code?: string;
@@ -9385,7 +9436,7 @@ export type TrackingTag = {
     ownerAdAccountId?: string;
 };
 
-export type platform11 = 'metaads';
+export type platform11 = 'metaads' | 'openaiads';
 
 /**
  * Platform-native flavor of the tag (Meta: `pixel`).
@@ -21061,9 +21112,9 @@ export type GrantBusinessPartnerData = {
          */
         businessId: string;
         /**
-         * Tasks granted on the Page. Defaults to ADVERTISE and ANALYZE.
+         * Tasks granted on the Page, Meta's permitted_tasks vocabulary. Defaults to ADVERTISE and ANALYZE. The bare names are what Business Settings shows; the PROFILE_PLUS_ names are the New Pages Experience tasks and the only way to grant FACEBOOK_ACCESS or REVENUE. Granting MANAGE also yields MANAGE_LEADS.
          */
-        permittedTasks?: Array<('MANAGE' | 'CREATE_CONTENT' | 'MODERATE' | 'MESSAGING' | 'ADVERTISE' | 'ANALYZE')>;
+        permittedTasks?: Array<('MANAGE' | 'CREATE_CONTENT' | 'MODERATE' | 'MESSAGING' | 'ADVERTISE' | 'ANALYZE' | 'MODERATE_COMMUNITY' | 'MANAGE_JOBS' | 'PAGES_MESSAGING' | 'PAGES_MESSAGING_SUBSCRIPTIONS' | 'READ_PAGE_MAILBOXES' | 'VIEW_MONETIZATION_INSIGHTS' | 'MANAGE_LEADS' | 'CASHIER_ROLE' | 'GLOBAL_STRUCTURE_MANAGEMENT' | 'PROFILE_PLUS_FULL_CONTROL' | 'PROFILE_PLUS_MANAGE' | 'PROFILE_PLUS_FACEBOOK_ACCESS' | 'PROFILE_PLUS_CREATE_CONTENT' | 'PROFILE_PLUS_MODERATE' | 'PROFILE_PLUS_MODERATE_DELEGATE_COMMUNITY' | 'PROFILE_PLUS_MESSAGING' | 'PROFILE_PLUS_ADVERTISE' | 'PROFILE_PLUS_ANALYZE' | 'PROFILE_PLUS_REVENUE' | 'PROFILE_PLUS_MANAGE_LEADS' | 'PROFILE_PLUS_CREATIVE_MANAGEMENT' | 'PROFILE_PLUS_CREATOR_MANAGEMENT' | 'PROFILE_PLUS_GLOBAL_STRUCTURE_MANAGEMENT')>;
     };
     path: {
         /**
@@ -48883,10 +48934,16 @@ export type GetTrackingTagData = {
     path: {
         accountId: string;
         /**
-         * Pixel id.
+         * Tag id (`TrackingTag.id`).
          */
         tagId: string;
     };
+    query?: {
+        /**
+         * Scopes the lookup on platforms whose tag ids live inside an ad account. Ignored elsewhere.
+         */
+        adAccountId?: string;
+    };
 };
 
 export type GetTrackingTagResponse = ({
@@ -48900,6 +48957,10 @@ export type GetTrackingTagError = (ErrorResponse | {
 
 export type UpdateTrackingTagData = {
     body: {
+        /**
+         * Scopes the lookup on platforms whose tag ids live inside an ad account. Ignored elsewhere.
+         */
+        adAccountId?: string;
         name?: string;
         /**
          * Meta Advanced Matching toggle (`enable_automatic_matching`).
@@ -49006,6 +49067,10 @@ export type InstallTrackingTagOnStoreData = {
          * The connected Shopify (`shopify`) or WordPress (`wordpress`) account id.
          */
         storeAccountId: string;
+        /**
+         * Scopes the tag lookup on platforms whose tag ids live inside an ad account. Ignored elsewhere.
+         */
+        adAccountId?: string;
         /**
          * WordPress only: widget area to use (see `install.preflight.sidebars` from GET). Defaults to a footer area.
          */
@@ -49018,7 +49083,7 @@ export type InstallTrackingTagOnStoreData = {
     path: {
         accountId: string;
         /**
-         * Meta pixel id.
+         * Tag id (`TrackingTag.id`).
          */
         tagId: string;
     };
@@ -49063,11 +49128,15 @@ export type GetTrackingTagStoreInstallData = {
     path: {
         accountId: string;
         /**
-         * Meta pixel id.
+         * Tag id (`TrackingTag.id`).
          */
         tagId: string;
     };
     query: {
+        /**
+         * Scopes the tag lookup on platforms whose tag ids live inside an ad account.
+         */
+        adAccountId?: string;
         /**
          * The connected Shopify or WordPress account id.
          */
@@ -49109,11 +49178,15 @@ export type RemoveTrackingTagFromStoreData = {
     path: {
         accountId: string;
         /**
-         * Meta pixel id.
+         * Tag id (`TrackingTag.id`).
          */
         tagId: string;
     };
     query: {
+        /**
+         * Scopes the tag lookup on platforms whose tag ids live inside an ad account.
+         */
+        adAccountId?: string;
         /**
          * The connected Shopify or WordPress account id.
          */
@@ -49139,13 +49212,17 @@ export type GetTrackingTagStatsData = {
     path: {
         accountId: string;
         /**
-         * Pixel id.
+         * Tag id (`TrackingTag.id`).
          */
         tagId: string;
     };
     query?: {
         /**
-         * Aggregation dimension. Defaults to `event`.
+         * Scopes the lookup on platforms whose tag ids live inside an ad account. Ignored elsewhere.
+         */
+        adAccountId?: string;
+        /**
+         * Meta only (400 on other platforms): aggregation dimension. Defaults to `event`.
          */
         aggregation?: 'event' | 'host' | 'url' | 'url_by_rule' | 'pixel_fire' | 'device_type' | 'device_os' | 'browser_type' | 'had_pii' | 'custom_data_field' | 'match_keys' | 'event_source' | 'event_detection_method' | 'event_processing_results' | 'event_total_counts' | 'event_value_count';
         /**