@zernio/node 0.2.518 → 0.2.519

package/src/generated/types.gen.ts

@@ -1623,6 +1623,15 @@ export type ConversionEvent = {
          * Meta advanced matching (ge). 'f' or 'm'; hashed server-side. Meta only.
          */
         gender?: string;
+        /**
+         * Meta lead ID from a Lead Ad submission, as a string. Required
+         * for Conversion Leads CRM events: send it with
+         * `actionSource: 'crm'` and
+         * `platformData: { event_source: 'crm', lead_event_source: '<CRM name>' }`.
+         * Forwarded unhashed to Meta's `user_data.lead_id`. Meta only.
+         *
+         */
+        leadId?: string;
         /**
          * Platform click identifiers captured from the originating ad click.
          */
@@ -1678,7 +1687,13 @@ export type ConversionEvent = {
      */
     actionSource?: 'web' | 'app' | 'offline' | 'crm' | 'phone_call' | 'system_generated';
     /**
-     * Escape hatch for platform-specific fields we haven't normalized. Forwarded as-is.
+     * Escape hatch for platform-specific fields we haven't normalized.
+     * On Meta, keys are shallow-merged into `custom_data` only: fields
+     * Zernio already builds (`value`, `currency`, `contents`,
+     * `num_items`) always win on collision, and `user_data` (hashed
+     * match keys) is never touched. Use first-class fields (e.g.
+     * `user.leadId`) for anything that must reach `user_data`.
+     *
      */
     platformData?: {
         [key: string]: unknown;