@zernio/node 0.2.977 → 0.2.978

package/dist/index.d.mts

@@ -11163,7 +11163,7 @@ type TrackingTag = {
      */
     events?: Array<TrackingTagEvent>;
     name: string;
-    platform: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads';
+    platform: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads' | 'pinterestads';
     /**
      * Platform-native flavor of the tag (Meta: `pixel`).
      */
@@ -11209,7 +11209,7 @@ type TrackingTag = {
      */
     ownerAdAccountId?: string;
 };
-type platform11 = 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads';
+type platform11 = 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads' | 'pinterestads';
 /**
  * Platform-native flavor of the tag (Meta: `pixel`).
  */
@@ -48400,7 +48400,7 @@ type ListTrackingTagsData = {
     };
 };
 type ListTrackingTagsResponse = ({
-    platform?: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads';
+    platform?: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads' | 'pinterestads';
     tags?: Array<TrackingTag>;
 });
 type ListTrackingTagsError = (unknown | {
@@ -48426,7 +48426,7 @@ type CreateTrackingTagData = {
     };
 };
 type CreateTrackingTagResponse = ({
-    platform?: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads';
+    platform?: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads' | 'pinterestads';
     tag?: TrackingTag;
 });
 type CreateTrackingTagError = (unknown | {
@@ -48448,7 +48448,7 @@ type GetTrackingTagData = {
     };
 };
 type GetTrackingTagResponse = ({
-    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads';
+    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
     tag?: TrackingTag;
 });
 type GetTrackingTagError = (ErrorResponse | {
@@ -48485,7 +48485,7 @@ type UpdateTrackingTagData = {
     };
 };
 type UpdateTrackingTagResponse = ({
-    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads';
+    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
     tag?: TrackingTag;
 });
 type UpdateTrackingTagError = (unknown | {
@@ -48576,7 +48576,7 @@ type InstallTrackingTagOnStoreData = {
     };
 };
 type InstallTrackingTagOnStoreResponse = ({
-    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads';
+    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
     install?: (StorePixelInstall & {
         /**
          * Shopify only: the pixel this install replaced on the store, if any.
@@ -48628,7 +48628,7 @@ type GetTrackingTagStoreInstallData = {
     };
 };
 type GetTrackingTagStoreInstallResponse = ({
-    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads';
+    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
     install?: (StorePixelInstall & {
         /**
          * WordPress only.
@@ -48675,7 +48675,7 @@ type RemoveTrackingTagFromStoreData = {
     };
 };
 type RemoveTrackingTagFromStoreResponse = ({
-    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads';
+    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
     install?: (StorePixelInstall & {
         /**
          * WordPress only: number of Zernio widgets deleted.
@@ -48813,7 +48813,7 @@ type GetTrackingTagStatsData = {
     };
 };
 type GetTrackingTagStatsResponse = ({
-    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads';
+    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
     stats?: {
         aggregation?: string;
         startTime?: number;

package/dist/index.d.ts

@@ -11163,7 +11163,7 @@ type TrackingTag = {
      */
     events?: Array<TrackingTagEvent>;
     name: string;
-    platform: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads';
+    platform: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads' | 'pinterestads';
     /**
      * Platform-native flavor of the tag (Meta: `pixel`).
      */
@@ -11209,7 +11209,7 @@ type TrackingTag = {
      */
     ownerAdAccountId?: string;
 };
-type platform11 = 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads';
+type platform11 = 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads' | 'pinterestads';
 /**
  * Platform-native flavor of the tag (Meta: `pixel`).
  */
@@ -48400,7 +48400,7 @@ type ListTrackingTagsData = {
     };
 };
 type ListTrackingTagsResponse = ({
-    platform?: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads';
+    platform?: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads' | 'pinterestads';
     tags?: Array<TrackingTag>;
 });
 type ListTrackingTagsError = (unknown | {
@@ -48426,7 +48426,7 @@ type CreateTrackingTagData = {
     };
 };
 type CreateTrackingTagResponse = ({
-    platform?: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads';
+    platform?: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads' | 'pinterestads';
     tag?: TrackingTag;
 });
 type CreateTrackingTagError = (unknown | {
@@ -48448,7 +48448,7 @@ type GetTrackingTagData = {
     };
 };
 type GetTrackingTagResponse = ({
-    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads';
+    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
     tag?: TrackingTag;
 });
 type GetTrackingTagError = (ErrorResponse | {
@@ -48485,7 +48485,7 @@ type UpdateTrackingTagData = {
     };
 };
 type UpdateTrackingTagResponse = ({
-    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads';
+    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
     tag?: TrackingTag;
 });
 type UpdateTrackingTagError = (unknown | {
@@ -48576,7 +48576,7 @@ type InstallTrackingTagOnStoreData = {
     };
 };
 type InstallTrackingTagOnStoreResponse = ({
-    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads';
+    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
     install?: (StorePixelInstall & {
         /**
          * Shopify only: the pixel this install replaced on the store, if any.
@@ -48628,7 +48628,7 @@ type GetTrackingTagStoreInstallData = {
     };
 };
 type GetTrackingTagStoreInstallResponse = ({
-    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads';
+    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
     install?: (StorePixelInstall & {
         /**
          * WordPress only.
@@ -48675,7 +48675,7 @@ type RemoveTrackingTagFromStoreData = {
     };
 };
 type RemoveTrackingTagFromStoreResponse = ({
-    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads';
+    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
     install?: (StorePixelInstall & {
         /**
          * WordPress only: number of Zernio widgets deleted.
@@ -48813,7 +48813,7 @@ type GetTrackingTagStatsData = {
     };
 };
 type GetTrackingTagStatsResponse = ({
-    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads';
+    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
     stats?: {
         aggregation?: string;
         startTime?: number;

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -13624,6 +13624,11 @@ export const startBusinessAgentEvalRun = <ThrowOnError extends boolean = false>(
  * account the connection can see. The tag `id` IS the partner id the site embeds, so
  * `siteTagId` equals `id`. LinkedIn tags have no name; it is shown as `Insight Tag {id}`.
  *
+ * Pinterest (platform `pinterestads`): lists Pinterest tags (conversion tags). `adAccountId`
+ * is the numeric Pinterest ad account id (no prefix); omit it to walk every ad account the
+ * connection can read (an ad account the user has no Business Access role on is skipped).
+ * `id` equals `siteTagId`, the id the site loads with `pintrk('load', id)`.
+ *
  */
 export const listTrackingTags = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListTrackingTagsData, ThrowOnError>) => {
     return (options?.client ?? client).get<ListTrackingTagsResponse, ListTrackingTagsError, ThrowOnError>({
@@ -13668,6 +13673,11 @@ export const listTrackingTags = <ThrowOnError extends boolean = false>(options:
  * tag is returned and nothing is created. `name` is ignored (LinkedIn tags have no name) and
  * there is no API to delete an Insight Tag.
  *
+ * Pinterest (platform `pinterestads`): creates a Pinterest tag on the numeric ad account
+ * `adAccountId` (`POST /v5/ad_accounts/{id}/conversion_tags`). Returns the tag with
+ * Pinterest's `code` snippet. NOT idempotent and Pinterest has no dry-run and no delete for
+ * tags, so never retry blindly: list first.
+ *
  */
 export const createTrackingTag = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateTrackingTagData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateTrackingTagResponse, CreateTrackingTagError, ThrowOnError>({
@@ -13697,6 +13707,10 @@ export const createTrackingTag = <ThrowOnError extends boolean = false>(options:
  * rules, no URL match rules). `adAccountId` picks which ad account's rules to read; it
  * defaults to the account that created the tag.
  *
+ * Pinterest (platform `pinterestads`): returns the tag with Pinterest's own `code` snippet
+ * and `lastFiredTime`. Without `adAccountId` Zernio finds the ad account that owns the tag
+ * (404 when no readable ad account holds it).
+ *
  */
 export const getTrackingTag = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetTrackingTagData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetTrackingTagResponse, GetTrackingTagError, ThrowOnError>({
@@ -13726,6 +13740,10 @@ export const getTrackingTag = <ThrowOnError extends boolean = false>(options: Op
  * `first_party_cookie_disabled`), which sets the tag's first-party tracking. It applies to
  * every ad account using the tag. `empty` answers 400: LinkedIn has no unset state.
  *
+ * Pinterest (platform `pinterestads`): 501. Pinterest API v5 only creates, lists and reads
+ * tags (no update endpoint); rename a tag or change its enhanced match settings in Pinterest
+ * Ads Manager.
+ *
  */
 export const updateTrackingTag = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdateTrackingTagData, ThrowOnError>) => {
     return (options?.client ?? client).patch<UpdateTrackingTagResponse, UpdateTrackingTagError, ThrowOnError>({
@@ -13851,6 +13869,14 @@ export const removeTrackingTagSharedAccount = <ThrowOnError extends boolean = fa
  * first-party cookie for 30 days. WordPress gets LinkedIn's base code, which records page
  * views.
  *
+ * **Pinterest (platform `pinterestads`)**: Shopify sends `pagevisit`, `viewcontent`,
+ * `addtocart`, `search`, `initiatecheckout`, `addpaymentinfo` and `checkout` to the tag,
+ * each with `event_id` (Purchase: `shopify_order_{orderId}`, for dedup with the Pinterest
+ * Conversions API), value, currency, order quantity and line items, plus the `epik` click id
+ * kept in the `_epik` cookie. WordPress gets Pinterest's base code (core.js, `load`, `page`)
+ * with a `pagevisit` event; the manual fallback is the official Pinterest for WooCommerce
+ * plugin (WooCommerce stores).
+ *
  */
 export const installTrackingTagOnStore = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<InstallTrackingTagOnStoreData, ThrowOnError>) => {
     return (options?.client ?? client).post<InstallTrackingTagOnStoreResponse, InstallTrackingTagOnStoreError, ThrowOnError>({
@@ -14059,6 +14085,14 @@ export const getTrackingTagDiagnostics = <ThrowOnError extends boolean = false>(
  * conversion_rule`, `id`, `name`, `type`, `conversionMethod`, `status`, `lastFiredTime`).
  * Times are unix seconds; `startTime`/`endTime` are ignored.
  *
+ * Pinterest (platform `pinterestads`): rows typed by `type`: one `tag` row (`lastFiredTime`,
+ * `status`, `enhancedMatchStatus`), `event` rows for the conversion events Pinterest has
+ * seen on the tag (`source` is `page_visit` or `ocpm_eligible`, the latter meaning the event
+ * can be optimized for, with the neutral `siteEvent` where one maps), and `event_quality`
+ * rows with the ad account's Event Quality Score for tag events over the last `1d` and `14d`
+ * (ad-account level, not per tag; an account Pinterest cannot score yet carries `error`
+ * instead). Pinterest has no time-bounded counts, so `startTime`/`endTime` answer 400.
+ *
  */
 export const getTrackingTagStats = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetTrackingTagStatsData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetTrackingTagStatsResponse, GetTrackingTagStatsError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -9710,7 +9710,7 @@ export type TrackingTag = {
      */
     events?: Array<TrackingTagEvent>;
     name: string;
-    platform: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads';
+    platform: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads' | 'pinterestads';
     /**
      * Platform-native flavor of the tag (Meta: `pixel`).
      */
@@ -9757,7 +9757,7 @@ export type TrackingTag = {
     ownerAdAccountId?: string;
 };
 
-export type platform11 = 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads';
+export type platform11 = 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads' | 'pinterestads';
 
 /**
  * Platform-native flavor of the tag (Meta: `pixel`).
@@ -49544,7 +49544,7 @@ export type ListTrackingTagsData = {
 };
 
 export type ListTrackingTagsResponse = ({
-    platform?: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads';
+    platform?: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads' | 'pinterestads';
     tags?: Array<TrackingTag>;
 });
 
@@ -49573,7 +49573,7 @@ export type CreateTrackingTagData = {
 };
 
 export type CreateTrackingTagResponse = ({
-    platform?: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads';
+    platform?: 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads' | 'pinterestads';
     tag?: TrackingTag;
 });
 
@@ -49598,7 +49598,7 @@ export type GetTrackingTagData = {
 };
 
 export type GetTrackingTagResponse = ({
-    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads';
+    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
     tag?: TrackingTag;
 });
 
@@ -49638,7 +49638,7 @@ export type UpdateTrackingTagData = {
 };
 
 export type UpdateTrackingTagResponse = ({
-    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads';
+    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
     tag?: TrackingTag;
 });
 
@@ -49741,7 +49741,7 @@ export type InstallTrackingTagOnStoreData = {
 };
 
 export type InstallTrackingTagOnStoreResponse = ({
-    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads';
+    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
     install?: (StorePixelInstall & {
     /**
      * Shopify only: the pixel this install replaced on the store, if any.
@@ -49796,7 +49796,7 @@ export type GetTrackingTagStoreInstallData = {
 };
 
 export type GetTrackingTagStoreInstallResponse = ({
-    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads';
+    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
     install?: (StorePixelInstall & {
     /**
      * WordPress only.
@@ -49846,7 +49846,7 @@ export type RemoveTrackingTagFromStoreData = {
 };
 
 export type RemoveTrackingTagFromStoreResponse = ({
-    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads';
+    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
     install?: (StorePixelInstall & {
     /**
      * WordPress only: number of Zernio widgets deleted.
@@ -50002,7 +50002,7 @@ export type GetTrackingTagStatsData = {
 };
 
 export type GetTrackingTagStatsResponse = ({
-    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads';
+    platform?: 'metaads' | 'tiktokads' | 'googleads' | 'xads' | 'openaiads' | 'linkedinads' | 'pinterestads';
     stats?: {
         aggregation?: string;
         startTime?: number;