@getlatedev/node 0.2.1116 → 0.2.1118

package/dist/index.js

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

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.1116",
+  version: "0.2.1118",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getlatedev/node",
-  "version": "0.2.1116",
+  "version": "0.2.1118",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -9778,7 +9778,8 @@ export const getAdCampaignDetails = <ThrowOnError extends boolean = false>(optio
 /**
  * Update a campaign
  * Campaign-level edits. Send at least one of `budget`, `bidStrategy`,
- * `portfolioBidStrategyId`, `name` or `platformSpecificData`. An unsupported
+ * `portfolioBidStrategyId`, `targetImpressionShare`, `manualCpc`, `networkSettings`,
+ * `trackingUrlTemplate`, `finalUrlSuffix`, `name` or `platformSpecificData`. An unsupported
  * field is always an error, never a silent drop.
  *
  * | Body field | Meta | Google | Others |
@@ -9786,6 +9787,10 @@ export const getAdCampaignDetails = <ThrowOnError extends boolean = false>(optio
  * | `bidStrategy` | Yes | Yes | 501 |
  * | `bidAmount`, `roasAverageFloor` | 400 (ad-set level) | Yes | 400 |
  * | `portfolioBidStrategyId` | 400 | Yes | 400 |
+ * | `targetImpressionShare` | 400 | Search only | 400 |
+ * | `manualCpc` | 400 | Search and Display | 400 |
+ * | `networkSettings` | 400 | Search only | 400 |
+ * | `trackingUrlTemplate`, `finalUrlSuffix` | 400 | Yes | 400 |
  * | `budget` (CBO; ABO returns 409) | Yes | Daily only | OpenAI: daily or lifetime; others 501 |
  * | `name` | Yes | 501 | 501 |
  * | `platformSpecificData.spendCap` | Yes | 400 | 400 |
@@ -9799,7 +9804,12 @@ export const getAdCampaignDetails = <ThrowOnError extends boolean = false>(optio
  * `bidAmount` = Target CPA, `LOWEST_COST_WITH_MIN_ROAS` + `roasAverageFloor` =
  * Target ROAS, `LOWEST_COST_WITH_BID_CAP` + `bidAmount` = Maximize Clicks with a
  * CPC ceiling; `portfolioBidStrategyId` attaches a portfolio strategy instead
- * (exclusive with `bidStrategy`). Setting the standard triplet on a campaign that
+ * (exclusive with `bidStrategy`). `targetImpressionShare` switches the campaign to
+ * Target impression share and `manualCpc: { maxCpc }` to Manual CPC (every ad group of the campaign gets `maxCpc` as its bid, in the same mutate); each is exclusive with
+ * every other strategy field. `networkSettings`, `trackingUrlTemplate` and
+ * `finalUrlSuffix` go out in one campaign update, each field sent written on its own
+ * leaf, so an omitted one keeps its current value; an empty string clears a URL field.
+ * Setting the standard triplet on a campaign that
  * is currently on a PORTFOLIO strategy is rejected: detach it in Google Ads
  * first, since it is shared across campaigns.
  *
@@ -11958,7 +11968,14 @@ export const listAdAccounts = <ThrowOnError extends boolean = false>(options: Op
  * covers the common case where the same entity benefits from and pays for the ads.
  * Read the current values back with `GET /v1/ads/dsa-defaults`.
  *
- * Currently supported for Meta accounts only; other platforms return 400.
+ * **Google: account-level URL tracking.** On a Google Ads connection, `adAccountId` is the
+ * customer id and only `trackingUrlTemplate` / `finalUrlSuffix` are accepted (the Meta
+ * fields return 400). They write `customer.tracking_url_template` and
+ * `customer.final_url_suffix`, one update mask leaf per field sent; an empty string clears
+ * the field. The response carries `urlTracking` with the values written. For one campaign,
+ * send the same fields to PUT /v1/ads/campaigns/{campaignId}.
+ *
+ * Other platforms return 400.
  *
  */
 export const updateAdAccount = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdateAdAccountData, ThrowOnError>) => {

package/src/generated/types.gen.ts

@@ -6619,6 +6619,30 @@ export type GoogleListingGroupTree = {
  */
 export type GoogleLocationTargetingType = 'presence' | 'presence_or_interest';
 
+/**
+ * Google Search and Display only. Manual CPC bidding. Enhanced CPC is not offered: Google no longer lets Search and Display campaigns enable it. Exclusive with every other strategy field.
+ */
+export type GoogleManualCpc = {
+    /**
+     * Max CPC of the ad groups, in the account's currency units: set on the ad group created with the campaign, and on every ad group of the campaign when an update switches it to Manual CPC. Google gives an ad group without one a 0.01 bid.
+     */
+    maxCpc: number;
+};
+
+/**
+ * Google Search campaigns only. Which networks the campaign serves on besides Google Search. When omitted at creation, search partners are ON and the Display Network is OFF (the defaults Zernio has always used); on an update only the fields sent change.
+ */
+export type GoogleNetworkSettings = {
+    /**
+     * campaign.network_settings.target_search_network
+     */
+    searchPartners?: boolean;
+    /**
+     * campaign.network_settings.target_content_network (Search with Display expansion)
+     */
+    displayNetwork?: boolean;
+};
+
 export type GooglePmaxAssetGroup = {
     /**
      * Stable Google asset group id. Use it in the asset-group endpoints below.
@@ -6859,6 +6883,23 @@ export type GoogleStructuredSnippet = {
 
 export type header = 'Amenities' | 'Brands' | 'Courses' | 'Degree programs' | 'Destinations' | 'Featured hotels' | 'Insurance coverage' | 'Models' | 'Neighborhoods' | 'Service catalog' | 'Shows' | 'Styles' | 'Types';
 
+/**
+ * Google only. Target impression share bidding (Search campaigns only): Google sets bids so the ads show in `location` for `percent` of eligible impressions.
+ */
+export type GoogleTargetImpressionShare = {
+    location: 'ANYWHERE_ON_PAGE' | 'TOP_OF_PAGE' | 'ABSOLUTE_TOP_OF_PAGE';
+    /**
+     * Target share of impressions, in percent (65 = 65%). Sent to Google as location_fraction_micros (1% = 10,000).
+     */
+    percent: number;
+    /**
+     * Max CPC bid limit, in the account's currency units. Google requires it.
+     */
+    maxCpc: number;
+};
+
+export type location = 'ANYWHERE_ON_PAGE' | 'TOP_OF_PAGE' | 'ABSOLUTE_TOP_OF_PAGE';
+
 export type ImessageAudienceContact = {
     conversationId?: string;
     accountId?: string;
@@ -9150,7 +9191,7 @@ export type PortfolioBidStrategy = {
      */
     id?: string;
     name?: string;
-    type?: 'TARGET_CPA' | 'TARGET_ROAS' | 'MAXIMIZE_CONVERSIONS' | 'MAXIMIZE_CONVERSION_VALUE';
+    type?: 'TARGET_CPA' | 'TARGET_ROAS' | 'MAXIMIZE_CONVERSIONS' | 'MAXIMIZE_CONVERSION_VALUE' | 'TARGET_IMPRESSION_SHARE';
     /**
      * ENABLED or REMOVED.
      */
@@ -9182,9 +9223,13 @@ export type PortfolioBidStrategy = {
      * Current target as a decimal multiplier (2.0 = 2.0x). Null for a CPA-family type (TARGET_CPA, MAXIMIZE_CONVERSIONS), or a Maximize type with no target set.
      */
     targetRoas?: (number) | null;
+    /**
+     * Current target for a TARGET_IMPRESSION_SHARE strategy, null for every other type.
+     */
+    targetImpressionShare?: (GoogleTargetImpressionShare | null);
 };
 
-export type type13 = 'TARGET_CPA' | 'TARGET_ROAS' | 'MAXIMIZE_CONVERSIONS' | 'MAXIMIZE_CONVERSION_VALUE';
+export type type13 = 'TARGET_CPA' | 'TARGET_ROAS' | 'MAXIMIZE_CONVERSIONS' | 'MAXIMIZE_CONVERSION_VALUE' | 'TARGET_IMPRESSION_SHARE';
 
 export type Post = {
     _id?: string;
@@ -39827,7 +39872,7 @@ export type CreateBidStrategyData = {
          */
         customerId?: string;
         name: string;
-        type: 'TARGET_CPA' | 'TARGET_ROAS' | 'MAXIMIZE_CONVERSIONS' | 'MAXIMIZE_CONVERSION_VALUE';
+        type: 'TARGET_CPA' | 'TARGET_ROAS' | 'MAXIMIZE_CONVERSIONS' | 'MAXIMIZE_CONVERSION_VALUE' | 'TARGET_IMPRESSION_SHARE';
         /**
          * Required when type is TARGET_CPA, in the account's currency units.
          */
@@ -39836,6 +39881,10 @@ export type CreateBidStrategyData = {
          * Required when type is TARGET_ROAS; a multiplier (2.0 = 2.0x).
          */
         targetRoas?: number;
+        /**
+         * Required when type is TARGET_IMPRESSION_SHARE, and refused with any other type.
+         */
+        targetImpressionShare?: (GoogleTargetImpressionShare);
     };
 };
 
@@ -39868,9 +39917,13 @@ export type UpdateBidStrategyData = {
          */
         customerId?: string;
         name?: string;
-        type?: 'TARGET_CPA' | 'TARGET_ROAS' | 'MAXIMIZE_CONVERSIONS' | 'MAXIMIZE_CONVERSION_VALUE';
+        type?: 'TARGET_CPA' | 'TARGET_ROAS' | 'MAXIMIZE_CONVERSIONS' | 'MAXIMIZE_CONVERSION_VALUE' | 'TARGET_IMPRESSION_SHARE';
         targetCpa?: number;
         targetRoas?: number;
+        /**
+         * Retargets a TARGET_IMPRESSION_SHARE strategy; location, percent and maxCpc are all written.
+         */
+        targetImpressionShare?: (GoogleTargetImpressionShare);
     };
     path: {
         /**
@@ -40298,6 +40351,12 @@ export type CreateAdCampaignData = {
          * Google only. Attach an existing portfolio bid strategy (numeric id from GET /v1/ads/bid-strategies) to the new campaign instead of a standard one. Exclusive with bidStrategy.
          */
         portfolioBidStrategyId?: string;
+        /**
+         * Google Search only. Target impression share bidding. Exclusive with bidStrategy, portfolioBidStrategyId and manualCpc; bidAmount is refused alongside it (the ceiling is maxCpc).
+         */
+        targetImpressionShare?: (GoogleTargetImpressionShare);
+        manualCpc?: GoogleManualCpc;
+        networkSettings?: GoogleNetworkSettings;
     };
     headers?: {
         /**
@@ -40594,6 +40653,20 @@ export type UpdateAdCampaignData = {
          * Google only. Explicitly allow changing a shared campaign budget, affecting every campaign that uses it. Does not bypass an unknown sharing state.
          */
         allowSharedBudgetUpdate?: boolean;
+        /**
+         * Google Search only. Target impression share bidding. Exclusive with bidStrategy, portfolioBidStrategyId and manualCpc; bidAmount is refused alongside it (the ceiling is maxCpc).
+         */
+        targetImpressionShare?: (GoogleTargetImpressionShare);
+        manualCpc?: GoogleManualCpc;
+        networkSettings?: GoogleNetworkSettings;
+        /**
+         * **Google only.** campaign.tracking_url_template; an empty string clears it.
+         */
+        trackingUrlTemplate?: string;
+        /**
+         * **Google only.** campaign.final_url_suffix; an empty string clears it.
+         */
+        finalUrlSuffix?: string;
         /**
          * Meta CBO, Google daily, or OpenAI Ads daily or lifetime campaign budget, in whole currency units.
          */
@@ -40640,6 +40713,11 @@ export type UpdateAdCampaignResponse = ({
      * Google only. Echoed back, but NOT mirrored onto local Ad documents (no column for it yet).
      */
     portfolioBidStrategyId?: string;
+    targetImpressionShare?: GoogleTargetImpressionShare;
+    manualCpc?: GoogleManualCpc;
+    networkSettings?: GoogleNetworkSettings;
+    trackingUrlTemplate?: string;
+    finalUrlSuffix?: string;
     platformSpecificData?: {
         [key: string]: unknown;
     };
@@ -41155,14 +41233,32 @@ export type ListAdSetsResponse = ({
             endDate?: string;
         } | null;
         /**
-         * The audience this ad set delivers to, as the platform reports it at the last sync.
-         * LinkedIn and Meta; null for every other platform and for ad sets not yet re-synced.
-         *
-         * On Meta it is the ad set's `targeting` verbatim (snake_case: geo_locations,
-         * age_min, custom_audiences, flexible_spec, ...), so it can be read, edited and sent
-         * back as is. On LinkedIn `include` and `exclude` (below) are the campaign's
-         * `targetingCriteria` verbatim, without reconstructing them from our normalized
-         * targeting spec.
+         * The audience this ad set delivers to, as the platform reports it at the last sync,
+         * in the platform's own shape. Every platform; null only for an ad set not re-synced
+         * yet, or when the platform's targeting read failed on every sync so far (a failed read
+         * keeps the last stored value).
+         *
+         * - Meta: the ad set's `targeting` verbatim (snake_case: geo_locations, age_min,
+         * custom_audiences, flexible_spec, ...), so it can be read, edited and sent back as is.
+         * - LinkedIn: `include` and `exclude` (below) are the campaign's `targetingCriteria`
+         * verbatim, without reconstructing them from our normalized targeting spec.
+         * - TikTok: the ad group's targeting fields from adgroup/get, verbatim (placement_type,
+         * placements, location_ids, age_groups, gender, languages, interest_category_ids,
+         * actions, audience_ids, excluded_audience_ids, operating_systems, ...). Only fields
+         * TikTok returned are present.
+         * - Google: `campaignCriteria` (LOCATION, LANGUAGE, PROXIMITY, DEVICE, AGE_RANGE, GENDER,
+         * USER_LIST, INCOME_RANGE, PARENTAL_STATUS) and `adGroupCriteria` (AGE_RANGE, GENDER,
+         * USER_LIST, USER_INTEREST, INCOME_RANGE, PARENTAL_STATUS), each a Google criterion
+         * verbatim (camelCase: resourceName, type, negative, bidModifier and the payload its type sets, for
+         * example `location.geoTargetConstant`). Most Google targeting lives on the campaign,
+         * so every ad group of a campaign carries the same `campaignCriteria`. Keywords are
+         * not included (they have their own endpoints). Synced on Google's slower keyword cycle.
+         * - Pinterest: the ad group's `targeting_spec` verbatim (GEO, AGE_BUCKET, GENDER,
+         * INTEREST, AUDIENCE_INCLUDE, LOCALE, ...).
+         * - X: `targeting_criteria`, the line item's criteria as X lists them (targeting_type,
+         * targeting_value, operator_type, name), the same shape X's batch create takes.
+         * - OpenAI: the campaign's `targeting` (OpenAI targets at the campaign), plus the ad
+         * group's `context_hints` when it has any.
          *
          */
         targeting?: {
@@ -41195,19 +41291,19 @@ export type ListAdSetsResponse = ({
          */
         statusReadAt?: (string) | null;
         /**
-         * The ad set's optimization goal as last synced, in the platform's own enum (Meta `optimization_goal`, for example OFFSITE_CONVERSIONS or LINK_CLICKS). On TikTok with `live=true`, rows read live carry the ad group's `optimization_goal` exactly as TikTok's adgroup/get returns it now (for example ENGAGED_VIEW, ENGAGED_VIEW_FIFTEEN, CLICK, CONVERT).
+         * The ad set's optimization goal as last synced, in the platform's own enum (Meta `optimization_goal`, for example OFFSITE_CONVERSIONS or LINK_CLICKS; TikTok `optimization_goal`; Pinterest the conversion event of `optimization_goal_metadata`, for example CHECKOUT; X the line item `goal`; OpenAI the campaign `bidding_type`). Always null on Google, which has no per-ad-group optimization goal. On TikTok with `live=true`, rows read live carry the ad group's `optimization_goal` exactly as TikTok's adgroup/get returns it now (for example ENGAGED_VIEW, ENGAGED_VIEW_FIFTEEN, CLICK, CONVERT).
          */
         optimizationGoal?: (string) | null;
         /**
-         * The ad set's billing event as last synced, where the platform reports one. On TikTok with `live=true`, rows read live carry the ad group's `billing_event` exactly as TikTok's adgroup/get returns it now (for example CPV, CPC, OCPM).
+         * The ad set's billing event as last synced, in the platform's own enum (Meta `billing_event`, TikTok `billing_event`, Pinterest `billable_event`, X `pay_by`, OpenAI `bidding_config.billing_event_type`). Always null on Google, which reports none per ad group. On TikTok with `live=true`, rows read live carry the ad group's `billing_event` exactly as TikTok's adgroup/get returns it now (for example CPV, CPC, OCPM).
          */
         billingEvent?: (string) | null;
         /**
-         * The bid strategy as last synced, in the platform's own enum (Meta `bid_strategy`, for example LOWEST_COST_WITHOUT_CAP, COST_CAP). On Meta under a campaign budget this is the campaign's strategy.
+         * The bid strategy as last synced, in Meta's vocabulary (LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS) on every platform that has an equivalent. On Meta under a campaign budget this is the campaign's strategy. TikTok maps bid_type / deep_bid_type, Pinterest AUTOMATIC_BID / MAX_BID / TARGET_AVG, X AUTO / MAX / TARGET, OpenAI Maximize Results / a max bid. Google bids at the campaign, so an ad group carries its campaign's strategy; one without a Meta equivalent (MANUAL_CPC, TARGET_IMPRESSION_SHARE, or a portfolio strategy's type such as TARGET_CPA) keeps Google's own name. Null on LinkedIn.
          */
         bidStrategy?: (string) | null;
         /**
-         * Bid cap or cost target in whole units of `currency`, as last synced. Null when the strategy has none.
+         * Bid cap or cost target in whole units of `currency`, as last synced. Null when the strategy has none (automatic bidding, ROAS targets, a Google portfolio strategy). On Google a campaign target CPA, a Maximize clicks ceiling, the ad group's own target CPA override, or its CPC bid under MANUAL_CPC.
          */
         bidAmount?: (number) | null;
         /**
@@ -41247,6 +41343,10 @@ export type CreateAdSetData = {
         campaignId: string;
         name: string;
         status?: 'ACTIVE' | 'PAUSED';
+        /**
+         * Max CPC of the new ad group, in the account's currency units. Send it when the campaign uses Manual CPC: Google gives an ad group without one a 0.01 bid.
+         */
+        maxCpc?: number;
         /**
          * Platform ad account ID (Google customer ID, digits only). Only required when the connection has more than one.
          */
@@ -46088,11 +46188,26 @@ export type UpdateAdAccountData = {
          * Legal entity paying for ads on this ad account. Defaults to defaultDsaBeneficiary when omitted. Requires defaultDsaBeneficiary.
          */
         defaultDsaPayor?: string;
+        /**
+         * **Google only.** Account tracking template (customer.tracking_url_template); an empty string clears it.
+         */
+        trackingUrlTemplate?: string;
+        /**
+         * **Google only.** Account final URL suffix (customer.final_url_suffix); an empty string clears it.
+         */
+        finalUrlSuffix?: string;
     };
 };
 
 export type UpdateAdAccountResponse = ({
     adAccountId?: string;
+    /**
+     * Google only. The URL tracking fields written.
+     */
+    urlTracking?: {
+        trackingUrlTemplate?: string;
+        finalUrlSuffix?: string;
+    };
     /**
      * Present when defaultDsaBeneficiary was passed.
      */
@@ -47882,6 +47997,15 @@ export type CreateStandaloneAdData = {
          * Google Search and Display only. Performance Max rejects portfolio bidding. Attach an existing portfolio bid strategy (numeric id from GET /v1/ads/bid-strategies) to the new campaign instead of a standard one. Exclusive with bidStrategy.
          */
         portfolioBidStrategyId?: string;
+        /**
+         * Google Search only. Target impression share bidding. Exclusive with bidStrategy, portfolioBidStrategyId and manualCpc; bidAmount is refused alongside it (the ceiling is maxCpc).
+         */
+        targetImpressionShare?: (GoogleTargetImpressionShare);
+        manualCpc?: GoogleManualCpc;
+        /**
+         * Google Search only, when the call creates the campaign (400 with existingCampaignId or adSetId).
+         */
+        networkSettings?: (GoogleNetworkSettings);
         /**
          * Meta only (facebook, instagram; other platforms return 400). Value rule set
          * to attach to the new ad set, from `/v1/ads/value-rule-sets`. Attachment is