oursprivacy-ingest 1.2.2 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35b733bc75c1fe6c48505b046c1868bbee18d5c90b659d6538d93188bf1c3c31
-  data.tar.gz: 5fd439db5b66ddb995259e685c09ba0c01c9fbf49ceae3da2087e24f1f726255
+  metadata.gz: b75bdf91712101469660844dc377093774d654c1293670bcb70beeec2bc8149c
+  data.tar.gz: 920b96f9003483239ea60323b348273876e75e7208129c8244e083656e09f062
 SHA512:
-  metadata.gz: 660c925247aa3d34cb6519cd3a58813299fa0551d06f06783cc6aebef16906f433328422dc7cc46851db7193aa510be7659ce2b97c4def5c9bf6597eaa29f323
-  data.tar.gz: f51fcdbbe5a917ce29c87aae2cf6ecb1c71f8df2f02c4b1ccf70ab55f32693fb7bab8f43e2b0dca7ca9fc9e4d2bf0e387351dae4f40efd0353e560c6512e8655
+  metadata.gz: f98eca30a4aa22e13bcf2e0443d45e20bb7a9f7f664dfa323f2558402d3d56d2106e1b410b7795f5e14c67671813915c52092752e3a72b02f41c7802a1180bd2
+  data.tar.gz: 60406f3d90cf09f03558b30ce5b2f1057cc45e67ddf7ff049b4cd886c9bef66ceb53026504536924cd37a7a8b91b4eff56741e0184a989ee534e880910051ec5

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 1.3.0 (2026-04-29)
+
+Full Changelog: [v1.2.3...v1.3.0](https://github.com/with-ours/ingest-sdk-ruby/compare/v1.2.3...v1.3.0)
+
+### Features
+
+* **api:** api update ([c4d41a9](https://github.com/with-ours/ingest-sdk-ruby/commit/c4d41a951927262d4dcbb35f03ea6bb126550484))
+* **api:** api update ([888ebc1](https://github.com/with-ours/ingest-sdk-ruby/commit/888ebc1a6528a9f8303e7e6246b3959611672c9e))
+* support setting headers via env ([c8e291b](https://github.com/with-ours/ingest-sdk-ruby/commit/c8e291b6cf982a820551fde0e7e91ac6951ca5bc))
+
+## 1.2.3 (2026-04-23)
+
+Full Changelog: [v1.2.2...v1.2.3](https://github.com/with-ours/ingest-sdk-ruby/compare/v1.2.2...v1.2.3)
+
+### Chores
+
+* **internal:** more robust bootstrap script ([f53feae](https://github.com/with-ours/ingest-sdk-ruby/commit/f53feae2cea3b5cf4deba70ad0e1dd99d208fe44))
+
 ## 1.2.2 (2026-04-09)
 
 Full Changelog: [v1.2.1...v1.2.2](https://github.com/with-ours/ingest-sdk-ruby/compare/v1.2.1...v1.2.2)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "oursprivacy-ingest", "~> 1.2.2"
+gem "oursprivacy-ingest", "~> 1.3.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/oursprivacy_ingest/client.rb

@@ -49,12 +49,26 @@ module OursprivacyIngest
 
       base_url ||= "https://api.oursprivacy.com/api/v1"
 
+      headers = {}
+      custom_headers_env = ENV["OURS_PRIVACY_CUSTOM_HEADERS"]
+      unless custom_headers_env.nil?
+        parsed = {}
+        custom_headers_env.split("\n").each do |line|
+          colon = line.index(":")
+          unless colon.nil?
+            parsed[line[0...colon].strip] = line[(colon + 1)..].strip
+          end
+        end
+        headers = parsed.merge(headers)
+      end
+
       super(
         base_url: base_url,
         timeout: timeout,
         max_retries: max_retries,
         initial_retry_delay: initial_retry_delay,
-        max_retry_delay: max_retry_delay
+        max_retry_delay: max_retry_delay,
+        headers: headers
       )
 
       @track = OursprivacyIngest::Resources::Track.new(client: self)

data/lib/oursprivacy_ingest/models/track_event_params.rb

@@ -138,6 +138,12 @@ module OursprivacyIngest
         #   @return [String, nil]
         optional :ad_id, String, nil?: true
 
+        # @!attribute admitad_uid
+        #   The Admitad (Mitgo) affiliate Click ID. Ex: admitad_uid_abc123
+        #
+        #   @return [String, nil]
+        optional :admitad_uid, String, nil?: true
+
         # @!attribute adset_id
         #   The adset id for detected in the session. This is set by the web sdk
         #   automatically.
@@ -559,7 +565,7 @@ module OursprivacyIngest
         #   @return [Boolean, nil]
         optional :webview, OursprivacyIngest::Internal::Type::Boolean, nil?: true
 
-        # @!method initialize(active_duration: nil, ad_id: nil, adset_id: nil, alart: nil, aleid: nil, axwrt: nil, basis_cid: nil, browser_language: nil, browser_name: nil, browser_version: nil, campaign_id: nil, clickid: nil, clid: nil, cpu_architecture: nil, current_url: nil, dclid: nil, device_model: nil, device_type: nil, device_vendor: nil, duration: nil, encoding: nil, engine_name: nil, engine_version: nil, epik: nil, fbc: nil, fbclid: nil, fbp: nil, fv: nil, gad_source: nil, gbraid: nil, gclid: nil, host: nil, iframe: nil, im_ref: nil, ip: nil, irclickid: nil, is_bot: nil, li_fat_id: nil, msclkid: nil, ndclid: nil, new_s: nil, os_name: nil, os_version: nil, page_hash: nil, pathname: nil, qclid: nil, rdt_cid: nil, received_at: nil, referrer: nil, referring_domain: nil, sacid: nil, sccid: nil, screen_height: nil, screen_width: nil, session_count: nil, sid: nil, sr: nil, title: nil, ttclid: nil, twclid: nil, uafvl: nil, user_agent: nil, utm_campaign: nil, utm_content: nil, utm_medium: nil, utm_name: nil, utm_source: nil, utm_term: nil, version: nil, wbraid: nil, webview: nil)
+        # @!method initialize(active_duration: nil, ad_id: nil, admitad_uid: nil, adset_id: nil, alart: nil, aleid: nil, axwrt: nil, basis_cid: nil, browser_language: nil, browser_name: nil, browser_version: nil, campaign_id: nil, clickid: nil, clid: nil, cpu_architecture: nil, current_url: nil, dclid: nil, device_model: nil, device_type: nil, device_vendor: nil, duration: nil, encoding: nil, engine_name: nil, engine_version: nil, epik: nil, fbc: nil, fbclid: nil, fbp: nil, fv: nil, gad_source: nil, gbraid: nil, gclid: nil, host: nil, iframe: nil, im_ref: nil, ip: nil, irclickid: nil, is_bot: nil, li_fat_id: nil, msclkid: nil, ndclid: nil, new_s: nil, os_name: nil, os_version: nil, page_hash: nil, pathname: nil, qclid: nil, rdt_cid: nil, received_at: nil, referrer: nil, referring_domain: nil, sacid: nil, sccid: nil, screen_height: nil, screen_width: nil, session_count: nil, sid: nil, sr: nil, title: nil, ttclid: nil, twclid: nil, uafvl: nil, user_agent: nil, utm_campaign: nil, utm_content: nil, utm_medium: nil, utm_name: nil, utm_source: nil, utm_term: nil, version: nil, wbraid: nil, webview: nil)
         #   Some parameter documentations has been truncated, see
         #   {OursprivacyIngest::Models::TrackEventParams::DefaultProperties} for more
         #   details.
@@ -571,6 +577,8 @@ module OursprivacyIngest
         #
         #   @param ad_id [String, nil] The ad id for detected in the session. This is set by the web sdk automatically.
         #
+        #   @param admitad_uid [String, nil] The Admitad (Mitgo) affiliate Click ID. Ex: admitad_uid_abc123
+        #
         #   @param adset_id [String, nil] The adset id for detected in the session. This is set by the web sdk automatical
         #
         #   @param alart [String, nil] The AppLovin alart query parameter. Ex: alart123
@@ -739,6 +747,11 @@ module OursprivacyIngest
         #   @return [String, nil]
         optional :ad_id, String, nil?: true
 
+        # @!attribute admitad_uid
+        #
+        #   @return [String, nil]
+        optional :admitad_uid, String, nil?: true
+
         # @!attribute adset_id
         #
         #   @return [String, nil]
@@ -1020,12 +1033,14 @@ module OursprivacyIngest
         #   @return [String, nil]
         optional :zip, String, nil?: true
 
-        # @!method initialize(ad_id: nil, adset_id: nil, alart: nil, aleid: nil, axwrt: nil, basis_cid: nil, campaign_id: nil, city: nil, clickid: nil, clid: nil, company_name: nil, consent: nil, country: nil, custom_properties: nil, date_of_birth: nil, dclid: nil, email: nil, epik: nil, external_id: nil, fbc: nil, fbclid: nil, fbp: nil, first_name: nil, gad_source: nil, gbraid: nil, gclid: nil, gender: nil, im_ref: nil, ip: nil, irclickid: nil, is_bot: nil, job_title: nil, last_name: nil, li_fat_id: nil, msclkid: nil, ndclid: nil, phone_number: nil, qclid: nil, rdt_cid: nil, referrer: nil, referring_domain: nil, sacid: nil, sccid: nil, sid: nil, state: nil, ttclid: nil, twclid: nil, user_agent: nil, user_agent_full_list: nil, utm_campaign: nil, utm_content: nil, utm_medium: nil, utm_name: nil, utm_source: nil, utm_term: nil, wbraid: nil, zip: nil)
+        # @!method initialize(ad_id: nil, admitad_uid: nil, adset_id: nil, alart: nil, aleid: nil, axwrt: nil, basis_cid: nil, campaign_id: nil, city: nil, clickid: nil, clid: nil, company_name: nil, consent: nil, country: nil, custom_properties: nil, date_of_birth: nil, dclid: nil, email: nil, epik: nil, external_id: nil, fbc: nil, fbclid: nil, fbp: nil, first_name: nil, gad_source: nil, gbraid: nil, gclid: nil, gender: nil, im_ref: nil, ip: nil, irclickid: nil, is_bot: nil, job_title: nil, last_name: nil, li_fat_id: nil, msclkid: nil, ndclid: nil, phone_number: nil, qclid: nil, rdt_cid: nil, referrer: nil, referring_domain: nil, sacid: nil, sccid: nil, sid: nil, state: nil, ttclid: nil, twclid: nil, user_agent: nil, user_agent_full_list: nil, utm_campaign: nil, utm_content: nil, utm_medium: nil, utm_name: nil, utm_source: nil, utm_term: nil, wbraid: nil, zip: nil)
         #   Properties to set on the visitor. (optional) You can also update these
         #   properties via the identify endpoint.
         #
         #   @param ad_id [String, nil]
         #
+        #   @param admitad_uid [String, nil]
+        #
         #   @param adset_id [String, nil]
         #
         #   @param alart [String, nil]

data/lib/oursprivacy_ingest/models/visitor_upsert_params.rb

@@ -94,6 +94,11 @@ module OursprivacyIngest
         #   @return [String, nil]
         optional :ad_id, String, nil?: true
 
+        # @!attribute admitad_uid
+        #
+        #   @return [String, nil]
+        optional :admitad_uid, String, nil?: true
+
         # @!attribute adset_id
         #
         #   @return [String, nil]
@@ -375,13 +380,15 @@ module OursprivacyIngest
         #   @return [String, nil]
         optional :zip, String, nil?: true
 
-        # @!method initialize(ad_id: nil, adset_id: nil, alart: nil, aleid: nil, axwrt: nil, basis_cid: nil, campaign_id: nil, city: nil, clickid: nil, clid: nil, company_name: nil, consent: nil, country: nil, custom_properties: nil, date_of_birth: nil, dclid: nil, email: nil, epik: nil, external_id: nil, fbc: nil, fbclid: nil, fbp: nil, first_name: nil, gad_source: nil, gbraid: nil, gclid: nil, gender: nil, im_ref: nil, ip: nil, irclickid: nil, is_bot: nil, job_title: nil, last_name: nil, li_fat_id: nil, msclkid: nil, ndclid: nil, phone_number: nil, qclid: nil, rdt_cid: nil, referrer: nil, referring_domain: nil, sacid: nil, sccid: nil, sid: nil, state: nil, ttclid: nil, twclid: nil, user_agent: nil, user_agent_full_list: nil, utm_campaign: nil, utm_content: nil, utm_medium: nil, utm_name: nil, utm_source: nil, utm_term: nil, wbraid: nil, zip: nil)
+        # @!method initialize(ad_id: nil, admitad_uid: nil, adset_id: nil, alart: nil, aleid: nil, axwrt: nil, basis_cid: nil, campaign_id: nil, city: nil, clickid: nil, clid: nil, company_name: nil, consent: nil, country: nil, custom_properties: nil, date_of_birth: nil, dclid: nil, email: nil, epik: nil, external_id: nil, fbc: nil, fbclid: nil, fbp: nil, first_name: nil, gad_source: nil, gbraid: nil, gclid: nil, gender: nil, im_ref: nil, ip: nil, irclickid: nil, is_bot: nil, job_title: nil, last_name: nil, li_fat_id: nil, msclkid: nil, ndclid: nil, phone_number: nil, qclid: nil, rdt_cid: nil, referrer: nil, referring_domain: nil, sacid: nil, sccid: nil, sid: nil, state: nil, ttclid: nil, twclid: nil, user_agent: nil, user_agent_full_list: nil, utm_campaign: nil, utm_content: nil, utm_medium: nil, utm_name: nil, utm_source: nil, utm_term: nil, wbraid: nil, zip: nil)
         #   User properties to associate with this user. The existing user properties will
         #   be updated. And all future events will have these properties associated with
         #   them.
         #
         #   @param ad_id [String, nil]
         #
+        #   @param admitad_uid [String, nil]
+        #
         #   @param adset_id [String, nil]
         #
         #   @param alart [String, nil]
@@ -508,6 +515,12 @@ module OursprivacyIngest
         #   @return [String, nil]
         optional :ad_id, String, nil?: true
 
+        # @!attribute admitad_uid
+        #   The Admitad (Mitgo) affiliate Click ID. Ex: admitad_uid_abc123
+        #
+        #   @return [String, nil]
+        optional :admitad_uid, String, nil?: true
+
         # @!attribute adset_id
         #   The adset id for detected in the session. This is set by the web sdk
         #   automatically.
@@ -929,7 +942,7 @@ module OursprivacyIngest
         #   @return [Boolean, nil]
         optional :webview, OursprivacyIngest::Internal::Type::Boolean, nil?: true
 
-        # @!method initialize(active_duration: nil, ad_id: nil, adset_id: nil, alart: nil, aleid: nil, axwrt: nil, basis_cid: nil, browser_language: nil, browser_name: nil, browser_version: nil, campaign_id: nil, clickid: nil, clid: nil, cpu_architecture: nil, current_url: nil, dclid: nil, device_model: nil, device_type: nil, device_vendor: nil, duration: nil, encoding: nil, engine_name: nil, engine_version: nil, epik: nil, fbc: nil, fbclid: nil, fbp: nil, fv: nil, gad_source: nil, gbraid: nil, gclid: nil, host: nil, iframe: nil, im_ref: nil, ip: nil, irclickid: nil, is_bot: nil, li_fat_id: nil, msclkid: nil, ndclid: nil, new_s: nil, os_name: nil, os_version: nil, page_hash: nil, pathname: nil, qclid: nil, rdt_cid: nil, received_at: nil, referrer: nil, referring_domain: nil, sacid: nil, sccid: nil, screen_height: nil, screen_width: nil, session_count: nil, sid: nil, sr: nil, title: nil, ttclid: nil, twclid: nil, uafvl: nil, user_agent: nil, utm_campaign: nil, utm_content: nil, utm_medium: nil, utm_name: nil, utm_source: nil, utm_term: nil, version: nil, wbraid: nil, webview: nil)
+        # @!method initialize(active_duration: nil, ad_id: nil, admitad_uid: nil, adset_id: nil, alart: nil, aleid: nil, axwrt: nil, basis_cid: nil, browser_language: nil, browser_name: nil, browser_version: nil, campaign_id: nil, clickid: nil, clid: nil, cpu_architecture: nil, current_url: nil, dclid: nil, device_model: nil, device_type: nil, device_vendor: nil, duration: nil, encoding: nil, engine_name: nil, engine_version: nil, epik: nil, fbc: nil, fbclid: nil, fbp: nil, fv: nil, gad_source: nil, gbraid: nil, gclid: nil, host: nil, iframe: nil, im_ref: nil, ip: nil, irclickid: nil, is_bot: nil, li_fat_id: nil, msclkid: nil, ndclid: nil, new_s: nil, os_name: nil, os_version: nil, page_hash: nil, pathname: nil, qclid: nil, rdt_cid: nil, received_at: nil, referrer: nil, referring_domain: nil, sacid: nil, sccid: nil, screen_height: nil, screen_width: nil, session_count: nil, sid: nil, sr: nil, title: nil, ttclid: nil, twclid: nil, uafvl: nil, user_agent: nil, utm_campaign: nil, utm_content: nil, utm_medium: nil, utm_name: nil, utm_source: nil, utm_term: nil, version: nil, wbraid: nil, webview: nil)
         #   Some parameter documentations has been truncated, see
         #   {OursprivacyIngest::Models::VisitorUpsertParams::DefaultProperties} for more
         #   details.
@@ -941,6 +954,8 @@ module OursprivacyIngest
         #
         #   @param ad_id [String, nil] The ad id for detected in the session. This is set by the web sdk automatically.
         #
+        #   @param admitad_uid [String, nil] The Admitad (Mitgo) affiliate Click ID. Ex: admitad_uid_abc123
+        #
         #   @param adset_id [String, nil] The adset id for detected in the session. This is set by the web sdk automatical
         #
         #   @param alart [String, nil] The AppLovin alart query parameter. Ex: alart123

data/lib/oursprivacy_ingest/resources/track.rb

@@ -8,8 +8,11 @@ module OursprivacyIngest
       #
       # Track events from your server. Please include at least one of: userId,
       # externalId, or email. These properties help us associate events with existing
-      # users. For all fields, null values unset the property and undefined values do
-      # not unset existing properties.
+      # users. For top-level visitor properties: null clears the existing value, while
+      # undefined, omitted fields, and empty strings are ignored. For entries inside
+      # custom_properties: null, undefined, and empty strings are all ignored
+      # (custom_properties use merge semantics). See
+      # https://docs.oursprivacy.com/docs/data-types for details and common pitfalls.
       #
       # @overload event(token:, event:, default_properties: nil, distinct_id: nil, email: nil, event_properties: nil, external_id: nil, identity_context: nil, time: nil, user_id: nil, user_properties: nil, request_options: {})
       #

data/lib/oursprivacy_ingest/resources/visitor.rb

@@ -7,7 +7,12 @@ module OursprivacyIngest
       # {OursprivacyIngest::Models::VisitorUpsertParams} for more details.
       #
       # Define visitor properties on an existing visitor or create a new visitor. This
-      # fires a $identify event, making the call visible in the event stream.
+      # fires a $identify event, making the call visible in the event stream. For
+      # top-level visitor properties: null clears the existing value, while undefined,
+      # omitted fields, and empty strings are ignored. For entries inside
+      # custom_properties: null, undefined, and empty strings are all ignored
+      # (custom_properties use merge semantics). See
+      # https://docs.oursprivacy.com/docs/data-types for details and common pitfalls.
       #
       # @overload upsert(token:, user_properties:, default_properties: nil, email: nil, external_id: nil, identity_context: nil, user_id: nil, request_options: {})
       #

data/lib/oursprivacy_ingest/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OursprivacyIngest
-  VERSION = "1.2.2"
+  VERSION = "1.3.0"
 end

data/rbi/oursprivacy_ingest/models/track_event_params.rbi

@@ -213,6 +213,10 @@ module OursprivacyIngest
         sig { returns(T.nilable(String)) }
         attr_accessor :ad_id
 
+        # The Admitad (Mitgo) affiliate Click ID. Ex: admitad_uid_abc123
+        sig { returns(T.nilable(String)) }
+        attr_accessor :admitad_uid
+
         # The adset id for detected in the session. This is set by the web sdk
         # automatically.
         sig { returns(T.nilable(String)) }
@@ -502,6 +506,7 @@ module OursprivacyIngest
           params(
             active_duration: T.nilable(Float),
             ad_id: T.nilable(String),
+            admitad_uid: T.nilable(String),
             adset_id: T.nilable(String),
             alart: T.nilable(String),
             aleid: T.nilable(String),
@@ -578,6 +583,8 @@ module OursprivacyIngest
           active_duration: nil,
           # The ad id for detected in the session. This is set by the web sdk automatically.
           ad_id: nil,
+          # The Admitad (Mitgo) affiliate Click ID. Ex: admitad_uid_abc123
+          admitad_uid: nil,
           # The adset id for detected in the session. This is set by the web sdk
           # automatically.
           adset_id: nil,
@@ -731,6 +738,7 @@ module OursprivacyIngest
             {
               active_duration: T.nilable(Float),
               ad_id: T.nilable(String),
+              admitad_uid: T.nilable(String),
               adset_id: T.nilable(String),
               alart: T.nilable(String),
               aleid: T.nilable(String),
@@ -853,6 +861,9 @@ module OursprivacyIngest
         sig { returns(T.nilable(String)) }
         attr_accessor :ad_id
 
+        sig { returns(T.nilable(String)) }
+        attr_accessor :admitad_uid
+
         sig { returns(T.nilable(String)) }
         attr_accessor :adset_id
 
@@ -1027,6 +1038,7 @@ module OursprivacyIngest
         sig do
           params(
             ad_id: T.nilable(String),
+            admitad_uid: T.nilable(String),
             adset_id: T.nilable(String),
             alart: T.nilable(String),
             aleid: T.nilable(String),
@@ -1087,6 +1099,7 @@ module OursprivacyIngest
         end
         def self.new(
           ad_id: nil,
+          admitad_uid: nil,
           adset_id: nil,
           alart: nil,
           aleid: nil,
@@ -1151,6 +1164,7 @@ module OursprivacyIngest
           override.returns(
             {
               ad_id: T.nilable(String),
+              admitad_uid: T.nilable(String),
               adset_id: T.nilable(String),
               alart: T.nilable(String),
               aleid: T.nilable(String),

data/rbi/oursprivacy_ingest/models/visitor_upsert_params.rbi

@@ -174,6 +174,9 @@ module OursprivacyIngest
         sig { returns(T.nilable(String)) }
         attr_accessor :ad_id
 
+        sig { returns(T.nilable(String)) }
+        attr_accessor :admitad_uid
+
         sig { returns(T.nilable(String)) }
         attr_accessor :adset_id
 
@@ -349,6 +352,7 @@ module OursprivacyIngest
         sig do
           params(
             ad_id: T.nilable(String),
+            admitad_uid: T.nilable(String),
             adset_id: T.nilable(String),
             alart: T.nilable(String),
             aleid: T.nilable(String),
@@ -409,6 +413,7 @@ module OursprivacyIngest
         end
         def self.new(
           ad_id: nil,
+          admitad_uid: nil,
           adset_id: nil,
           alart: nil,
           aleid: nil,
@@ -473,6 +478,7 @@ module OursprivacyIngest
           override.returns(
             {
               ad_id: T.nilable(String),
+              admitad_uid: T.nilable(String),
               adset_id: T.nilable(String),
               alart: T.nilable(String),
               aleid: T.nilable(String),
@@ -553,6 +559,10 @@ module OursprivacyIngest
         sig { returns(T.nilable(String)) }
         attr_accessor :ad_id
 
+        # The Admitad (Mitgo) affiliate Click ID. Ex: admitad_uid_abc123
+        sig { returns(T.nilable(String)) }
+        attr_accessor :admitad_uid
+
         # The adset id for detected in the session. This is set by the web sdk
         # automatically.
         sig { returns(T.nilable(String)) }
@@ -842,6 +852,7 @@ module OursprivacyIngest
           params(
             active_duration: T.nilable(Float),
             ad_id: T.nilable(String),
+            admitad_uid: T.nilable(String),
             adset_id: T.nilable(String),
             alart: T.nilable(String),
             aleid: T.nilable(String),
@@ -918,6 +929,8 @@ module OursprivacyIngest
           active_duration: nil,
           # The ad id for detected in the session. This is set by the web sdk automatically.
           ad_id: nil,
+          # The Admitad (Mitgo) affiliate Click ID. Ex: admitad_uid_abc123
+          admitad_uid: nil,
           # The adset id for detected in the session. This is set by the web sdk
           # automatically.
           adset_id: nil,
@@ -1071,6 +1084,7 @@ module OursprivacyIngest
             {
               active_duration: T.nilable(Float),
               ad_id: T.nilable(String),
+              admitad_uid: T.nilable(String),
               adset_id: T.nilable(String),
               alart: T.nilable(String),
               aleid: T.nilable(String),

data/rbi/oursprivacy_ingest/resources/track.rbi

@@ -5,8 +5,11 @@ module OursprivacyIngest
     class Track
       # Track events from your server. Please include at least one of: userId,
       # externalId, or email. These properties help us associate events with existing
-      # users. For all fields, null values unset the property and undefined values do
-      # not unset existing properties.
+      # users. For top-level visitor properties: null clears the existing value, while
+      # undefined, omitted fields, and empty strings are ignored. For entries inside
+      # custom_properties: null, undefined, and empty strings are all ignored
+      # (custom_properties use merge semantics). See
+      # https://docs.oursprivacy.com/docs/data-types for details and common pitfalls.
       sig do
         params(
           token: String,

data/rbi/oursprivacy_ingest/resources/visitor.rbi

@@ -4,7 +4,12 @@ module OursprivacyIngest
   module Resources
     class Visitor
       # Define visitor properties on an existing visitor or create a new visitor. This
-      # fires a $identify event, making the call visible in the event stream.
+      # fires a $identify event, making the call visible in the event stream. For
+      # top-level visitor properties: null clears the existing value, while undefined,
+      # omitted fields, and empty strings are ignored. For entries inside
+      # custom_properties: null, undefined, and empty strings are all ignored
+      # (custom_properties use merge semantics). See
+      # https://docs.oursprivacy.com/docs/data-types for details and common pitfalls.
       sig do
         params(
           token: String,

data/sig/oursprivacy_ingest/models/track_event_params.rbs

@@ -76,6 +76,7 @@ module OursprivacyIngest
         {
           active_duration: Float?,
           ad_id: String?,
+          admitad_uid: String?,
           adset_id: String?,
           alart: String?,
           aleid: String?,
@@ -152,6 +153,8 @@ module OursprivacyIngest
 
         attr_accessor ad_id: String?
 
+        attr_accessor admitad_uid: String?
+
         attr_accessor adset_id: String?
 
         attr_accessor alart: String?
@@ -293,6 +296,7 @@ module OursprivacyIngest
         def initialize: (
           ?active_duration: Float?,
           ?ad_id: String?,
+          ?admitad_uid: String?,
           ?adset_id: String?,
           ?alart: String?,
           ?aleid: String?,
@@ -367,6 +371,7 @@ module OursprivacyIngest
         def to_hash: -> {
           active_duration: Float?,
           ad_id: String?,
+          admitad_uid: String?,
           adset_id: String?,
           alart: String?,
           aleid: String?,
@@ -454,6 +459,7 @@ module OursprivacyIngest
       type user_properties =
         {
           ad_id: String?,
+          admitad_uid: String?,
           adset_id: String?,
           alart: String?,
           aleid: String?,
@@ -515,6 +521,8 @@ module OursprivacyIngest
       class UserProperties < OursprivacyIngest::Internal::Type::BaseModel
         attr_accessor ad_id: String?
 
+        attr_accessor admitad_uid: String?
+
         attr_accessor adset_id: String?
 
         attr_accessor alart: String?
@@ -629,6 +637,7 @@ module OursprivacyIngest
 
         def initialize: (
           ?ad_id: String?,
+          ?admitad_uid: String?,
           ?adset_id: String?,
           ?alart: String?,
           ?aleid: String?,
@@ -689,6 +698,7 @@ module OursprivacyIngest
 
         def to_hash: -> {
           ad_id: String?,
+          admitad_uid: String?,
           adset_id: String?,
           alart: String?,
           aleid: String?,

data/sig/oursprivacy_ingest/models/visitor_upsert_params.rbs

@@ -55,6 +55,7 @@ module OursprivacyIngest
       type user_properties =
         {
           ad_id: String?,
+          admitad_uid: String?,
           adset_id: String?,
           alart: String?,
           aleid: String?,
@@ -116,6 +117,8 @@ module OursprivacyIngest
       class UserProperties < OursprivacyIngest::Internal::Type::BaseModel
         attr_accessor ad_id: String?
 
+        attr_accessor admitad_uid: String?
+
         attr_accessor adset_id: String?
 
         attr_accessor alart: String?
@@ -230,6 +233,7 @@ module OursprivacyIngest
 
         def initialize: (
           ?ad_id: String?,
+          ?admitad_uid: String?,
           ?adset_id: String?,
           ?alart: String?,
           ?aleid: String?,
@@ -290,6 +294,7 @@ module OursprivacyIngest
 
         def to_hash: -> {
           ad_id: String?,
+          admitad_uid: String?,
           adset_id: String?,
           alart: String?,
           aleid: String?,
@@ -353,6 +358,7 @@ module OursprivacyIngest
         {
           active_duration: Float?,
           ad_id: String?,
+          admitad_uid: String?,
           adset_id: String?,
           alart: String?,
           aleid: String?,
@@ -429,6 +435,8 @@ module OursprivacyIngest
 
         attr_accessor ad_id: String?
 
+        attr_accessor admitad_uid: String?
+
         attr_accessor adset_id: String?
 
         attr_accessor alart: String?
@@ -570,6 +578,7 @@ module OursprivacyIngest
         def initialize: (
           ?active_duration: Float?,
           ?ad_id: String?,
+          ?admitad_uid: String?,
           ?adset_id: String?,
           ?alart: String?,
           ?aleid: String?,
@@ -644,6 +653,7 @@ module OursprivacyIngest
         def to_hash: -> {
           active_duration: Float?,
           ad_id: String?,
+          admitad_uid: String?,
           adset_id: String?,
           alart: String?,
           aleid: String?,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: oursprivacy-ingest
 version: !ruby/object:Gem::Version
-  version: 1.2.2
+  version: 1.3.0
 platform: ruby
 authors:
 - Ours Privacy
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-13 00:00:00.000000000 Z
+date: 2026-04-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi