@zernio/node 0.2.779 → 0.2.781

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -32714,7 +32714,7 @@ type CreateAdCampaignData = {
32714
32714
  isSkadnetworkAttribution?: boolean;
32715
32715
  promotedObject?: AdPromotedObject;
32716
32716
  /**
32717
- * Meta only. Defaults to AUCTION and is explicitly sent on new campaigns, including validateOnly. SKAdNetwork app promotion requires AUCTION.
32717
+ * Meta only. OMIT on non-Meta platforms (Google Ads, etc.): any value is rejected with a 400. On Meta the server applies AUCTION when omitted, so it does not need to be sent; RESERVED = Reach & Frequency. SKAdNetwork app promotion requires AUCTION.
32718
32718
  */
32719
32719
  buyingType?: 'AUCTION' | 'RESERVED';
32720
32720
  /**
@@ -37187,6 +37187,27 @@ type BoostPostData = {
37187
37187
  *
37188
37188
  */
37189
37189
  sparkAuthCode?: string;
37190
+ /**
37191
+ * TikTok-only on this endpoint. The pixel a Website Conversion ad group
37192
+ * optimizes toward, so a Spark Ad built from an existing organic post can
37193
+ * optimize for a conversion instead of only engagement or traffic. Required
37194
+ * when `goal` is `conversions`; ignored on every other goal, because only a
37195
+ * WEB_CONVERSIONS ad group accepts these fields.
37196
+ *
37197
+ * Combine freely with `platformPostId` + `sparkAuthCode`: the pixel lives on
37198
+ * the ad group and the Spark item on the creative, so they never conflict.
37199
+ *
37200
+ */
37201
+ promotedObject?: {
37202
+ /**
37203
+ * TikTok Pixel. Either the numeric pixel id or the alphanumeric pixel code from Events Manager, which is resolved for you.
37204
+ */
37205
+ pixelId?: string;
37206
+ /**
37207
+ * Optimization event, as a TikTok optimization_event code (e.g. ON_WEB_ORDER, SHOPPING, FORM) or the exact event name shown in Events Manager, which is resolved to its code. Omit to let TikTok optimize for the ad group default.
37208
+ */
37209
+ customEventType?: string;
37210
+ };
37190
37211
  /**
37191
37212
  * Legal entity that benefits from the ad. Required when targeting EU users
37192
37213
  * (EU DSA, Article 26). Optional if the ad account has a default beneficiary:
package/dist/index.d.ts CHANGED
@@ -32714,7 +32714,7 @@ type CreateAdCampaignData = {
32714
32714
  isSkadnetworkAttribution?: boolean;
32715
32715
  promotedObject?: AdPromotedObject;
32716
32716
  /**
32717
- * Meta only. Defaults to AUCTION and is explicitly sent on new campaigns, including validateOnly. SKAdNetwork app promotion requires AUCTION.
32717
+ * Meta only. OMIT on non-Meta platforms (Google Ads, etc.): any value is rejected with a 400. On Meta the server applies AUCTION when omitted, so it does not need to be sent; RESERVED = Reach & Frequency. SKAdNetwork app promotion requires AUCTION.
32718
32718
  */
32719
32719
  buyingType?: 'AUCTION' | 'RESERVED';
32720
32720
  /**
@@ -37187,6 +37187,27 @@ type BoostPostData = {
37187
37187
  *
37188
37188
  */
37189
37189
  sparkAuthCode?: string;
37190
+ /**
37191
+ * TikTok-only on this endpoint. The pixel a Website Conversion ad group
37192
+ * optimizes toward, so a Spark Ad built from an existing organic post can
37193
+ * optimize for a conversion instead of only engagement or traffic. Required
37194
+ * when `goal` is `conversions`; ignored on every other goal, because only a
37195
+ * WEB_CONVERSIONS ad group accepts these fields.
37196
+ *
37197
+ * Combine freely with `platformPostId` + `sparkAuthCode`: the pixel lives on
37198
+ * the ad group and the Spark item on the creative, so they never conflict.
37199
+ *
37200
+ */
37201
+ promotedObject?: {
37202
+ /**
37203
+ * TikTok Pixel. Either the numeric pixel id or the alphanumeric pixel code from Events Manager, which is resolved for you.
37204
+ */
37205
+ pixelId?: string;
37206
+ /**
37207
+ * Optimization event, as a TikTok optimization_event code (e.g. ON_WEB_ORDER, SHOPPING, FORM) or the exact event name shown in Events Manager, which is resolved to its code. Omit to let TikTok optimize for the ad group default.
37208
+ */
37209
+ customEventType?: string;
37210
+ };
37190
37211
  /**
37191
37212
  * Legal entity that benefits from the ad. Required when targeting EU users
37192
37213
  * (EU DSA, Article 26). Optional if the ad account has a default beneficiary:
package/dist/index.js CHANGED
@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
36
36
  // package.json
37
37
  var package_default = {
38
38
  name: "@zernio/node",
39
- version: "0.2.779",
39
+ version: "0.2.781",
40
40
  description: "The official Node.js library for the Zernio API",
41
41
  main: "dist/index.js",
42
42
  module: "dist/index.mjs",
package/dist/index.mjs CHANGED
@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
5
5
  // package.json
6
6
  var package_default = {
7
7
  name: "@zernio/node",
8
- version: "0.2.779",
8
+ version: "0.2.781",
9
9
  description: "The official Node.js library for the Zernio API",
10
10
  main: "dist/index.js",
11
11
  module: "dist/index.mjs",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zernio/node",
3
- "version": "0.2.779",
3
+ "version": "0.2.781",
4
4
  "description": "The official Node.js library for the Zernio API",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -4227,7 +4227,7 @@ export const replyToInboxPost = <ThrowOnError extends boolean = false>(options:
4227
4227
 
4228
4228
  /**
4229
4229
  * Delete comment
4230
- * Delete a comment on a post. Supported by Facebook, Instagram, Bluesky, Reddit, YouTube, and LinkedIn.
4230
+ * Delete a comment on a post. Supported by Facebook, Instagram, Threads, LinkedIn, Reddit, Bluesky, X (Twitter), YouTube, and TikTok (accounts connected through the TikTok for Business app). Not supported on Google Business (reviews only).
4231
4231
  * Requires accountId and commentId query parameters.
4232
4232
  *
4233
4233
  */
@@ -8856,12 +8856,18 @@ export const getAd = <ThrowOnError extends boolean = false>(options: OptionsLega
8856
8856
  * the campaign's live criteria and sends the removes and the creates in ONE
8857
8857
  * `googleAds:mutate`, so the campaign is never left with a half-applied set; criteria
8858
8858
  * already in the list keep their criterion ID and history. Excluded (negative)
8859
- * locations are left untouched. Two cases are refused rather than applied: an empty
8860
- * location list returns 400 (a Google campaign with no location criteria targets every
8861
- * country, which is never what "remove my locations" means, so omit the field instead),
8862
- * and radius targeting (`customLocations`) returns 422 because it is a separate Google
8863
- * criterion type that this replacement neither creates nor removes. Send either
8864
- * `targeting.locations` or the top-level geo fields, not both: mixing them returns 400.
8859
+ * locations are left untouched. An empty location list returns 400 (a Google campaign
8860
+ * with no location criteria targets every country, which is never what "remove my
8861
+ * locations" means, so omit the field instead). Send either `targeting.locations` or the
8862
+ * top-level geo fields, not both: mixing them returns 400.
8863
+ *
8864
+ * **Google radius targeting:** `customLocations` is editable and is replaced the same
8865
+ * way, but as its OWN set. Google models a place (LOCATION) and a point plus radius
8866
+ * (PROXIMITY) as different criterion types, so the two are independent: sending
8867
+ * `customLocations` replaces every radius and leaves the cities and countries alone,
8868
+ * and sending places replaces those and leaves the radius alone. Send
8869
+ * `customLocations: []` to drop radius targeting entirely. A circle you re-send
8870
+ * unchanged keeps its criterion ID rather than being removed and recreated.
8865
8871
  *
8866
8872
  * **Google keyword replacement:** These edits affect the ad's entire ad group,
8867
8873
  * including sibling ads. Positive (`targeting.keywords`) and negative
@@ -33031,7 +33031,7 @@ export type CreateAdCampaignData = {
33031
33031
  isSkadnetworkAttribution?: boolean;
33032
33032
  promotedObject?: AdPromotedObject;
33033
33033
  /**
33034
- * Meta only. Defaults to AUCTION and is explicitly sent on new campaigns, including validateOnly. SKAdNetwork app promotion requires AUCTION.
33034
+ * Meta only. OMIT on non-Meta platforms (Google Ads, etc.): any value is rejected with a 400. On Meta the server applies AUCTION when omitted, so it does not need to be sent; RESERVED = Reach & Frequency. SKAdNetwork app promotion requires AUCTION.
33035
33035
  */
33036
33036
  buyingType?: 'AUCTION' | 'RESERVED';
33037
33037
  /**
@@ -37810,6 +37810,27 @@ export type BoostPostData = {
37810
37810
  *
37811
37811
  */
37812
37812
  sparkAuthCode?: string;
37813
+ /**
37814
+ * TikTok-only on this endpoint. The pixel a Website Conversion ad group
37815
+ * optimizes toward, so a Spark Ad built from an existing organic post can
37816
+ * optimize for a conversion instead of only engagement or traffic. Required
37817
+ * when `goal` is `conversions`; ignored on every other goal, because only a
37818
+ * WEB_CONVERSIONS ad group accepts these fields.
37819
+ *
37820
+ * Combine freely with `platformPostId` + `sparkAuthCode`: the pixel lives on
37821
+ * the ad group and the Spark item on the creative, so they never conflict.
37822
+ *
37823
+ */
37824
+ promotedObject?: {
37825
+ /**
37826
+ * TikTok Pixel. Either the numeric pixel id or the alphanumeric pixel code from Events Manager, which is resolved for you.
37827
+ */
37828
+ pixelId?: string;
37829
+ /**
37830
+ * Optimization event, as a TikTok optimization_event code (e.g. ON_WEB_ORDER, SHOPPING, FORM) or the exact event name shown in Events Manager, which is resolved to its code. Omit to let TikTok optimize for the ad group default.
37831
+ */
37832
+ customEventType?: string;
37833
+ };
37813
37834
  /**
37814
37835
  * Legal entity that benefits from the ad. Required when targeting EU users
37815
37836
  * (EU DSA, Article 26). Optional if the ad account has a default beneficiary: