@zernio/node 0.2.979 → 0.2.980

package/src/generated/sdk.gen.ts

@@ -13678,6 +13678,14 @@ export const listTrackingTags = <ThrowOnError extends boolean = false>(options:
  * Pinterest's `code` snippet. NOT idempotent and Pinterest has no dry-run and no delete for
  * tags, so never retry blindly: list first.
  *
+ * Google Ads (`googleads`): every Google Ads account has exactly one
+ * Google tag (`AW-...`), so this is idempotent. `adAccountId` is the
+ * 10-digit customer id. When the account already tracks conversions
+ * the existing tag is returned (201) and nothing is created. Otherwise
+ * a first WEBPAGE conversion action named `name` (category DEFAULT) is
+ * created, which is what switches Google's conversion tracking on, and
+ * the tag is returned with it as its first event.
+ *
  */
 export const createTrackingTag = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateTrackingTagData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateTrackingTagResponse, CreateTrackingTagError, ThrowOnError>({
@@ -13731,6 +13739,13 @@ export const getTrackingTag = <ThrowOnError extends boolean = false>(options: Op
  * (`POST`/`PATCH`/`PUT`/`DELETE /v1/conversions/pixels/{id}` answer 405
  * "Invalid method"); rename a pixel in OpenAI Ads Manager.
  *
+ * Google Ads (`googleads`): the only writable tag setting is
+ * `autoTagging` (the account's gclid auto-tagging, without which the
+ * tag cannot attribute conversions to ad clicks). Google rejects every
+ * write to `conversion_tracking_setting` for our developer token
+ * (`SERVICE_ACCESS_DENIED`), so the tag id and cross-account ownership
+ * stay managed in the Google Ads UI.
+ *
  * There is no DELETE: Meta has no API to delete a pixel. To stop using
  * one, unshare it from your ad accounts (`DELETE
  * .../tracking-tags/{tagId}/shared-accounts`) or disable it in Events
@@ -13947,6 +13962,12 @@ export const removeTrackingTagFromStore = <ThrowOnError extends boolean = false>
  * account) and keeps the conversions whose pixel is this one. Archived conversions are
  * included with `status: archived`. `urlContains` and `siteEvent` are parsed from Meta's rule.
  *
+ * Google Ads (`googleads`): the enabled WEBPAGE conversion actions of the account;
+ * `siteEventId` is the conversion label (the part after `AW-.../` in `send_to`), and
+ * value settings, lookback windows, `primary` and `countingType` are returned.
+ * Archived (removed) actions are listed with status `REMOVED`; imported (GA4, upload,
+ * app) actions are not events of the tag.
+ *
  */
 export const listTrackingTagEvents = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListTrackingTagEventsData, ThrowOnError>) => {
     return (options?.client ?? client).get<ListTrackingTagEventsResponse, ListTrackingTagEventsError, ThrowOnError>({
@@ -13994,6 +14015,16 @@ export const listTrackingTagEvents = <ThrowOnError extends boolean = false>(opti
  * name: an active conversion with the same name on this pixel is returned instead of a
  * duplicate. Meta caps custom conversions per ad account; the cap answers 400.
  *
+ * Google Ads (`googleads`): creates a WEBPAGE conversion action. `type` is a
+ * ConversionActionCategory (e.g. `PURCHASE`, `SIGNUP`, `DEFAULT`); `siteEvent` maps
+ * page_view, add_to_cart, initiate_checkout and purchase, while view_content, search and
+ * add_payment_info answer 400 (Google has no category for them). Stored fields: name,
+ * type, defaultValue, currency, alwaysUseDefaultValue, clickWindowDays (1 to 90),
+ * viewWindowDays (1 to 30), primary, countingType, enabled. Actions are created enabled
+ * (`enabled: false` answers 400); Google blocks the HIDDEN status on WEBPAGE actions. Names
+ * are unique per account, so a replay answers 400 (DUPLICATE_NAME) instead of creating a
+ * second one.
+ *
  */
 export const createTrackingTagEvent = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateTrackingTagEventData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateTrackingTagEventResponse, CreateTrackingTagEventError, ThrowOnError>({
@@ -14017,6 +14048,10 @@ export const createTrackingTagEvent = <ThrowOnError extends boolean = false>(opt
  * Meta: only `name` and `defaultValue` can change (Meta's custom conversion update takes
  * nothing else); `type`, `siteEvent` and `urlContains` answer 400, create a new event instead.
  *
+ * Google Ads (`googleads`): same fields as create, on the account's WEBPAGE actions (others
+ * answer 404). `enabled: false` archives the action (same as DELETE) and `enabled: true`
+ * restores an archived one.
+ *
  */
 export const updateTrackingTagEvent = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdateTrackingTagEventData, ThrowOnError>) => {
     return (options?.client ?? client).patch<UpdateTrackingTagEventResponse, UpdateTrackingTagEventError, ThrowOnError>({
@@ -14041,6 +14076,10 @@ export const updateTrackingTagEvent = <ThrowOnError extends boolean = false>(opt
  * Meta: `archived`. Meta's delete archives the custom conversion (it stays readable with
  * `status: archived`) and there is no hard delete; deleting an archived one is a no-op.
  *
+ * Google Ads (`googleads`): removes the conversion action (state `archived`). Google keeps
+ * it with status REMOVED and its history; PATCH with `enabled: true` restores it. Deleting
+ * an already archived action succeeds without a call to Google.
+ *
  */
 export const deleteTrackingTagEvent = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<DeleteTrackingTagEventData, ThrowOnError>) => {
     return (options?.client ?? client).delete<DeleteTrackingTagEventResponse, DeleteTrackingTagEventError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -3131,6 +3131,30 @@ export type ConversionAction = {
      * true = primary (counts toward bidding when its goal is biddable), false = secondary. Change it with PATCH /v1/ads/conversions/actions/{actionId}.
      */
     primaryForGoal?: boolean;
+    /**
+     * Value recorded when the conversion carries none.
+     */
+    defaultValue?: number;
+    /**
+     * ISO 4217 currency of defaultValue.
+     */
+    defaultCurrency?: string;
+    /**
+     * true = defaultValue is used even when the conversion sends its own value.
+     */
+    alwaysUseDefaultValue?: boolean;
+    /**
+     * Google's ConversionActionCountingType: ONE_PER_CLICK or MANY_PER_CLICK.
+     */
+    countingType?: string;
+    /**
+     * Days after an ad click a conversion is still credited (1 to 90).
+     */
+    clickThroughLookbackWindowDays?: number;
+    /**
+     * Days after an ad view a conversion is still credited (1 to 30).
+     */
+    viewThroughLookbackWindowDays?: number;
     /**
      * The code a customer pastes onto their site. Present for types
      * Google generates a snippet for (e.g. WEBPAGE); empty otherwise.
@@ -9698,11 +9722,11 @@ export type mediaType2 = 'video' | 'photo';
  */
 export type TrackingTag = {
     /**
-     * Platform-native tag id, the `{tagId}` of the per-tag routes. Meta: numeric pixel id, as a string. OpenAI: the pixel resource id.
+     * Platform-native tag id, the `{tagId}` of the per-tag routes. Meta: numeric pixel id, as a string. OpenAI: the pixel resource id. Google Ads: the 10-digit customer id (one Google tag per account).
      */
     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`).
+     * The id the on-site code carries. Equals `id` on Meta; differs on platforms with separate API and site ids (OpenAI `pixel_id`, Google `AW-...` conversion id, the manager's under cross-account conversion tracking).
      */
     siteTagId?: string;
     /**
@@ -9755,6 +9779,10 @@ export type TrackingTag = {
      * Ad account id (`act_...`) that owns the tag, when reported.
      */
     ownerAdAccountId?: string;
+    /**
+     * Google Ads: whether gclid auto-tagging is on for the ad account (needed to attribute conversions to clicks).
+     */
+    autoTagging?: boolean;
 };
 
 export type platform11 = 'metaads' | 'openaiads' | 'tiktokads' | 'googleads' | 'xads' | 'linkedinads' | 'pinterestads';
@@ -9782,8 +9810,25 @@ export type TrackingTagDiagnostic = {
      * Where to fix it in the platform UI (Meta: Events Manager).
      */
     actionUrl?: string;
+    /**
+     * Record `defaultValue` even when the conversion sends its own value.
+     */
+    alwaysUseDefaultValue?: boolean;
+    /**
+     * Primary (counts toward bidding) or secondary (observation only).
+     */
+    primary?: boolean;
+    /**
+     * `one` = one conversion per ad interaction, `every` = each conversion.
+     */
+    countingType?: 'one' | 'every';
 };
 
+/**
+ * `one` = one conversion per ad interaction, `every` = each conversion.
+ */
+export type countingType = 'one' | 'every';
+
 /**
  * A conversion event tied to a tracking tag (Google conversion action, LinkedIn conversion rule, X web event tag, OpenAI event setting, TikTok pixel event, Meta custom conversion).
  */
@@ -9814,6 +9859,18 @@ export type TrackingTagEvent = {
      * Fires only on pages whose URL contains this text (case-insensitive).
      */
     urlContains?: string;
+    /**
+     * `defaultValue` is recorded even when the conversion sends its own value.
+     */
+    alwaysUseDefaultValue?: boolean;
+    /**
+     * Primary conversions count toward bidding and the Conversions column; secondary ones are observation only (Google `primary_for_goal`).
+     */
+    primary?: boolean;
+    /**
+     * `one` counts at most one conversion per ad interaction (leads), `every` counts each (purchases).
+     */
+    countingType?: 'one' | 'every';
 };
 
 /**
@@ -49627,6 +49684,10 @@ export type UpdateTrackingTagData = {
         automaticMatchingFields?: Array<('em' | 'ph' | 'fn' | 'ln' | 'ge' | 'db' | 'ct' | 'st' | 'zp' | 'country' | 'external_id')>;
         firstPartyCookieStatus?: 'empty' | 'first_party_cookie_disabled' | 'first_party_cookie_enabled';
         dataUseSetting?: 'advertising_and_analytics' | 'analytics_only' | 'empty';
+        /**
+         * Google Ads: turn gclid auto-tagging on or off for the ad account.
+         */
+        autoTagging?: boolean;
     };
     path: {
         accountId: string;