kameleoon-client-ruby 3.10.0 → 3.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1831531ee6a40f0fbd32f110f9a9c9c1a33f71569c8b8de842bc01c06250d6d5
-  data.tar.gz: 6e6f8f9d0ee511c2a27fc63ff040e6155b90df66925989d1d08bd473f86c071b
+  metadata.gz: 40923e6f42531b0686515b2ed716e62c1fb99aaeb8a739014bb60b75d661b06d
+  data.tar.gz: 7bcc9f40e5ffce5701d0046250e852ec7330638d2d3ee48ea838b7842054f280
 SHA512:
-  metadata.gz: 6f575eb2b6e12302ffa5cdb067582d994ab890edcab12f174732d396adc4248fc96a9e27935c008db52f59a93b5e0c713530356acab47711727651d2a4d48e3a
-  data.tar.gz: '058e6a5284550663cf20223eca099728a9ca0985aacfcfa829e585070228a83b38b4facda77d38a7f3ae17ae8fad37cc7898e47e2519826364a46b3205b33452'
+  metadata.gz: 760b08574a3dc5d79f6e8f241ec14bae4e31447ec8b39fe047d089edf5d64de2c95de43ed14dc995f32a68a806fb08ff8417f212e570ba5ac905b67908451a5b
+  data.tar.gz: 6d906512cc30caa25506b0b2a26faaaa9c7ad545663b05c155c2a040098448c9e7e3f67a8226feea905e1d70c6d0bbe15bc013341bcdbac0b99cba12bb316606

data/lib/kameleoon/data/conversion.rb

@@ -1,26 +1,31 @@
 # frozen_string_literal: true
 
 require 'json'
+require 'kameleoon/data/custom_data'
 require 'kameleoon/network/uri_helper'
+require 'kameleoon/utils'
 require_relative 'data'
 
 module Kameleoon
   # Conversion class uses for tracking conversion
   class Conversion < DuplicationSafeData
-    attr_reader :goal_id, :revenue, :negative
+    attr_reader :goal_id, :revenue, :negative, :metadata
 
     def to_s
-      "Conversion{goal_id:#{@goal_id},revenue:#{@revenue},negative:#{@negative}}"
+      "Conversion{goal_id:#{@goal_id},revenue:#{@revenue},negative:#{@negative}," \
+      "metadata:#{Utils::Strval.obj_to_s(@metadata)}}"
     end
 
     # @param [Integer] goal_id Id of the goal associated to the conversion
     # @param [Float] revenue Optional field - Revenue associated to the conversion.
     # @param [Boolean] negative Optional field - If the revenue is negative. By default it's positive.
-    def initialize(goal_id, revenue = 0.0, negative = false)
+    # @param [Array] metadata Optional field - Metadata of the conversion. Array of CustomData objects.
+    def initialize(goal_id, revenue = 0.0, negative = false, metadata: nil)
       super(DataType::CONVERSION)
       @goal_id = goal_id
       @revenue = revenue || 0.0
       @negative = negative || false
+      @metadata = metadata
     end
 
     def obtain_full_post_text_line
@@ -31,7 +36,22 @@ module Kameleoon
         negative: @negative,
         nonce: nonce
       }
+      params[:metadata] = encode_metadata if @metadata&.length&.positive?
       Kameleoon::Network::UriHelper.encode_query(params)
     end
+
+    private
+
+    def encode_metadata
+      metadata = {}
+      added_indices = Set[]
+      @metadata&.each do |mcd|
+        next if !mcd.is_a?(CustomData) || added_indices.include?(mcd.id)
+
+        metadata[mcd.id] = mcd.values
+        added_indices.add(mcd.id)
+      end
+      JSON.generate(metadata)
+    end
   end
 end

data/lib/kameleoon/data/custom_data.rb

@@ -38,10 +38,6 @@ module Kameleoon
         @values = args
       end
 
-      if @values.empty?
-        Logging::KameleoonLogger.error('Created a custom data %s with no values. It will not be tracked.', @id)
-      end
-
       return if @id.is_a?(Integer)
 
       Logging::KameleoonLogger.warning("CustomData field 'id' must be of 'Integer' type")
@@ -50,8 +46,6 @@ module Kameleoon
     # rubocop:enable Metrics/MethodLength
 
     def obtain_full_post_text_line
-      return '' if @values.empty?
-
       str_values = JSON.generate(Hash[@values.collect { |k| [k, 1] }])
       params = {
         eventType: 'customData',

data/lib/kameleoon/data/manager/visitor.rb

@@ -8,6 +8,7 @@ require 'kameleoon/data/custom_data'
 require 'kameleoon/data/device'
 require 'kameleoon/data/kcs_heat'
 require 'kameleoon/data/page_view'
+require 'kameleoon/data/personalization'
 require 'kameleoon/data/unique_identifier'
 require 'kameleoon/data/user_agent'
 require 'kameleoon/data/manager/assigned_variation'
@@ -172,6 +173,14 @@ module Kameleoon
         variations
       end
 
+      def personalizations
+        personalizations = @data.personalizations
+        Logging::KameleoonLogger.debug(
+          'CALL/RETURN: Visitor.personalizations -> (personalizations: %s)', personalizations
+        )
+        personalizations
+      end
+
       def get_forced_feature_variation(feature_key)
         Logging::KameleoonLogger.debug("CALL: Visitor.get_forced_feature_variation(feature_key: '%s')", feature_key)
         variation = @data.get_from_map(@data.simulated_variations, feature_key)
@@ -225,6 +234,8 @@ module Kameleoon
               @data.user_agent = data.value
             when AssignedVariation
               @data.add_variation(data, overwrite)
+            when Personalization
+              @data.add_personalization(data, overwrite)
             when ForcedFeatureVariation
               @data.add_forced_feature_variation(data)
             when ForcedExperimentVariation
@@ -348,6 +359,10 @@ module Kameleoon
         DataMapStorage.new(@mutex, @variations)
       end
 
+      def personalizations
+        DataMapStorage.new(@mutex, @personalizations)
+      end
+
       def set_device(device, overwrite)
         @device = device if overwrite || @device.nil?
       end
@@ -359,6 +374,13 @@ module Kameleoon
         end
       end
 
+      def add_personalization(personalization, overwrite)
+        @personalizations ||= {}
+        if overwrite || !@personalizations.include?(personalization.id)
+          @personalizations[personalization.id] = personalization
+        end
+      end
+
       def set_browser(browser, overwrite)
         @browser = browser if overwrite || @browser.nil?
       end

data/lib/kameleoon/data/personalization.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Kameleoon
+  class Personalization
+    attr_reader :id, :variation_id
+
+    def initialize(id, variation_id)
+      @id = id
+      @variation_id = variation_id
+    end
+
+    def to_s
+      "Personalization{id:#{@id},variation_id:#{@variation_id}}"
+    end
+  end
+end

data/lib/kameleoon/kameleoon_client.rb

@@ -186,21 +186,29 @@ module Kameleoon
     # @param [Float] revenue Optional - Revenue of the conversion.
     # @param [Bool] is_unique_identifier(DEPRECATED) Parameter that specifies whether the visitorCode is a unique
     # identifier. This field is optional.
+    # @param [Bool] negative Defines if the revenue is positive or negative.
+    # This field is optional (`false` by default).
+    # @param [Array] metadata Metadata of the conversion. This field is optional.
     #
     # @raise [Kameleoon::Exception::VisitorCodeInvalid] If the visitor code is empty or longer than 255 chars
     #
-    def track_conversion(visitor_code, goal_id, revenue = 0.0, is_unique_identifier: nil)
+    def track_conversion(
+      visitor_code, goal_id, revenue = 0.0,
+      is_unique_identifier: nil, negative: false, metadata: nil
+    )
       Logging::KameleoonLogger.info(
-        "CALL: KameleoonClient.track_conversion(visitor_code: '%s', goal_id: %s, revenue: %s, is_unique_identifier: %s)",
-        visitor_code, goal_id, revenue, is_unique_identifier
+        "CALL: KameleoonClient.track_conversion(visitor_code: '%s', goal_id: %s, revenue: %s, " \
+        'is_unique_identifier: %s, negative: %s, metadata: %s)',
+        visitor_code, goal_id, revenue, is_unique_identifier, negative, metadata
       )
       Utils::VisitorCode.validate(visitor_code)
       set_unique_identifier(visitor_code, is_unique_identifier) unless is_unique_identifier.nil?
-      add_data(visitor_code, Conversion.new(goal_id, revenue))
+      add_data(visitor_code, Conversion.new(goal_id, revenue, negative, metadata: metadata))
       @tracking_manager.add_visitor_code(visitor_code)
       Logging::KameleoonLogger.info(
-        "RETURN: KameleoonClient.track_conversion(visitor_code: '%s', goal_id: %s, revenue: %s, is_unique_identifier: %s)",
-        visitor_code, goal_id, revenue, is_unique_identifier
+        "RETURN: KameleoonClient.track_conversion(visitor_code: '%s', goal_id: %s, revenue: %s, " \
+        'is_unique_identifier: %s, negative: %s, metadata: %s)',
+        visitor_code, goal_id, revenue, is_unique_identifier, negative, metadata
       )
     end
 

data/lib/kameleoon/managers/remote_data/remote_visitor_data.rb

@@ -8,6 +8,7 @@ require 'kameleoon/data/device'
 require 'kameleoon/data/geolocation'
 require 'kameleoon/data/kcs_heat'
 require 'kameleoon/data/page_view'
+require 'kameleoon/data/personalization'
 require 'kameleoon/data/visitor_visits'
 require 'kameleoon/data/manager/page_view_visit'
 require 'kameleoon/data/manager/assigned_variation'
@@ -16,8 +17,8 @@ module Kameleoon
   module Managers
     module RemoteData
       class RemoteVisitorData
-        attr_reader :custom_data_dict, :page_view_visits, :conversions, :experiments, :device, :browser,
-                    :operating_system, :geolocation, :previous_visitor_visits, :kcs_heat, :cbs, :visitor_code
+        attr_reader :custom_data_dict, :page_view_visits, :conversions, :experiments, :personalizations, :device,
+                    :browser, :operating_system, :geolocation, :previous_visitor_visits, :kcs_heat, :cbs, :visitor_code
 
         def initialize(hash)
           current_visit = hash['currentVisit']
@@ -45,6 +46,7 @@ module Kameleoon
           data_to_add.push(@cbs) unless @cbs.nil?
           data_to_add.concat(@page_view_visits.values) unless @page_view_visits.nil?
           data_to_add.concat(@experiments.values) unless @experiments.nil?
+          data_to_add.concat(@personalizations.values) unless @personalizations.nil?
           data_to_add.concat(conversions_single_objects)
         end
 
@@ -85,6 +87,8 @@ module Kameleoon
                                                                   geolocation_events.size.positive?
           static_data_events = hash['staticDataEvent']
           parse_static_data(static_data_events) unless static_data_events.nil?
+          personalization_events = hash['personalizationEvents']
+          parse_personalizations(personalization_events) unless personalization_events.nil?
         end
 
         def parse_custom_data(custom_data_events)
@@ -93,7 +97,9 @@ module Kameleoon
             data = custom_data_event['data']
             id = data['index']
             id = -1 if id.nil?
-            @custom_data_dict[id] = CustomData.new(id, *data['valuesCountMap'].keys) unless @custom_data_dict.include?(id)
+            next if @custom_data_dict.include?(id)
+
+            @custom_data_dict[id] = CustomData.new(id, *data['valuesCountMap'].keys)
           end
         end
 
@@ -115,14 +121,12 @@ module Kameleoon
           @experiments = {} if @experiments.nil?
           experiment_events.reverse_each do |experiment_event|
             id = experiment_event['data']['id']
-            variation = @experiments[id]
-            if variation.nil?
-              variation = DataManager::AssignedVariation.new(
-                id, experiment_event['data']['variationId'],
-                Configuration::RuleType::UNKNOWN, assignment_time: experiment_event['time']
-              )
-              @experiments[id] = variation
-            end
+            next if @experiments.include?(id)
+
+            @experiments[id] = DataManager::AssignedVariation.new(
+              id, experiment_event['data']['variationId'],
+              Configuration::RuleType::UNKNOWN, assignment_time: experiment_event['time']
+            )
           end
         end
 
@@ -141,8 +145,6 @@ module Kameleoon
         end
 
         def parse_static_data(static_data_event)
-          return if @device != nil && @browser != nil && @operating_system != nil
-
           data = static_data_event['data']
           if @device.nil?
             device_type = data['deviceType']
@@ -158,6 +160,16 @@ module Kameleoon
           end
         end
 
+        def parse_personalizations(personalization_events)
+          @personalizations = {} if @personalizations.nil?
+          personalization_events.reverse_each do |personalization_event|
+            id = personalization_event['data']['id']
+            next if @personalizations.include?(id)
+
+            @personalizations[id] = Personalization.new(id, personalization_event['data']['variationId'])
+          end
+        end
+
         def conversions_single_objects
           objects = []
           objects += @conversions unless @conversions.nil?

data/lib/kameleoon/network/url_provider.rb

@@ -76,6 +76,7 @@ module Kameleoon
         params[:experiment] = true if filter.experiments
         params[:page] = true if filter.page_views
         params[:staticData] = true if filter.device || filter.browser || filter.operating_system
+        params[:personalization] = true if filter.personalization
         params[:cbs] = true if filter.cbs
         format(DATA_API_URL_FORMAT, @data_api_domain, VISITOR_DATA_PATH, UriHelper.encode_query(params))
       end

data/lib/kameleoon/targeting/condition.rb

@@ -9,7 +9,10 @@ module Kameleoon
     module ConditionType
       CUSTOM_DATUM = 'CUSTOM_DATUM'
       TARGET_FEATURE_FLAG = 'TARGET_FEATURE_FLAG'
+      TARGET_EXPERIMENT = 'TARGET_EXPERIMENT'
+      TARGET_PERSONALIZATION = 'TARGET_PERSONALIZATION'
       EXCLUSIVE_FEATURE_FLAG = 'EXCLUSIVE_FEATURE_FLAG'
+      EXCLUSIVE_EXPERIMENT = 'EXCLUSIVE_EXPERIMENT'
       PAGE_URL = 'PAGE_URL'
       PAGE_VIEWS = 'PAGE_VIEWS'
       PREVIOUS_PAGE = 'PREVIOUS_PAGE'

data/lib/kameleoon/targeting/condition_factory.rb

@@ -1,5 +1,8 @@
 require_relative 'conditions/custom_datum'
+require_relative 'conditions/target_experiment_condition'
 require_relative 'conditions/target_feature_flag_condition'
+require_relative 'conditions/target_personalization_condition'
+require_relative 'conditions/exclusive_experiment_condition'
 require_relative 'conditions/exclusive_feature_flag_condition'
 require_relative 'conditions/page_title_condition'
 require_relative 'conditions/page_url_condition'
@@ -32,8 +35,14 @@ module Kameleoon
           CustomDatum.new(condition_json)
         when ConditionType::TARGET_FEATURE_FLAG
           TargetFeatureFlagCondition.new(condition_json)
+        when ConditionType::TARGET_EXPERIMENT
+          TargetExperimentCondition.new(condition_json)
+        when ConditionType::TARGET_PERSONALIZATION
+          TargetPersonalizationCondition.new(condition_json)
         when ConditionType::EXCLUSIVE_FEATURE_FLAG
           ExclusiveFeatureFlagCondition.new(condition_json)
+        when ConditionType::EXCLUSIVE_EXPERIMENT
+          ExclusiveExperimentCondition.new(condition_json)
         when ConditionType::PAGE_URL
           PageUrlCondition.new(condition_json)
         when ConditionType::PAGE_VIEWS

data/lib/kameleoon/targeting/conditions/exclusive_experiment_condition.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require 'kameleoon/logging/kameleoon_logger'
+require 'kameleoon/targeting/condition'
+
+module Kameleoon
+  # @api private
+  module Targeting
+    # ExclusiveExperiment represents an instance of Exclusive Experiment condition in user account
+    class ExclusiveExperimentCondition < Condition
+      module CampaignType
+        EXPERIMENT = 'EXPERIMENT'
+        PERSONALIZATION = 'PERSONALIZATION'
+        ANY = 'ANY'
+      end
+
+      def initialize(json_condition)
+        super(json_condition)
+
+        @campaign_type = json_condition['campaignType']
+      end
+
+      def check(data)
+        return false unless data.is_a?(ExclusiveExperimentInfo)
+
+        case @campaign_type
+        when CampaignType::EXPERIMENT
+          return check_experiment(data)
+        when CampaignType::PERSONALIZATION
+          return check_personalization(data)
+        when CampaignType::ANY
+          return check_personalization(data) && check_experiment(data)
+        end
+        Logging::KameleoonLogger.error("Unexpected campaign type for '#{type}' condition: '#{@campaign_type}'")
+        false
+      end
+
+      private
+
+      def check_experiment(data)
+        size = data.variations_storage&.size || 0
+        size.zero? || (size == 1 && !data.variations_storage.get(data.current_experiment_id).nil?)
+      end
+
+      def check_personalization(data)
+        (data.personalizations_storage&.size || 0).zero?
+      end
+    end
+
+    class ExclusiveExperimentInfo
+      attr_reader :current_experiment_id, :variations_storage, :personalizations_storage
+
+      def initialize(current_experiment_id, variations_storage, personalizations_storage)
+        @current_experiment_id = current_experiment_id
+        @variations_storage = variations_storage
+        @personalizations_storage = personalizations_storage
+      end
+    end
+  end
+end

data/lib/kameleoon/targeting/conditions/exclusive_feature_flag_condition.rb

@@ -5,7 +5,7 @@ require 'kameleoon/targeting/condition'
 module Kameleoon
   # @api private
   module Targeting
-    # ExclusiveExperiment represents an instance of Exclusive Experiment condition in user account
+    # ExclusiveFeatureFlag represents an instance of Exclusive FeatureFlag condition in user account
     class ExclusiveFeatureFlagCondition < Condition
       def check(data)
         return false unless data.is_a?(ExclusiveFeatureFlagInfo)

data/lib/kameleoon/targeting/conditions/target_experiment_condition.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require 'kameleoon/logging/kameleoon_logger'
+require 'kameleoon/targeting/condition'
+
+module Kameleoon
+  # @api private
+  module Targeting
+    # TargetExperiment represents an instance of Experiment condition in user account
+    class TargetExperimentCondition < Condition
+      include Kameleoon::Exception
+
+      def initialize(json_condition)
+        super(json_condition)
+
+        @variation_id = json_condition['variationId'] || -1
+        @experiment_id = json_condition['experimentId'] || -1
+        @variation_match_type = json_condition['variationMatchType'] || Operator::UNKNOWN
+      end
+
+      def check(data)
+        return false unless data.is_a?(TargetExperimentInfo)
+
+        variation = data.variations_storage&.get(@experiment_id)
+        case @variation_match_type
+        when Operator::ANY
+          return !variation.nil?
+        when Operator::EXACT
+          return !variation.nil? && (variation.variation_id == @variation_id)
+        end
+        Logging::KameleoonLogger.error(
+          "Unexpected variation match type for '#{type}' condition: '#{@variation_match_type}'"
+        )
+        false
+      end
+    end
+
+    class TargetExperimentInfo
+      attr_reader :variations_storage
+
+      def initialize(variations_storage)
+        @variations_storage = variations_storage
+      end
+    end
+  end
+end

data/lib/kameleoon/targeting/conditions/target_feature_flag_condition.rb

@@ -6,7 +6,7 @@ require 'kameleoon/exceptions'
 module Kameleoon
   # @api private
   module Targeting
-    # TargetExperiment represents an instance of Experiment condition in user account
+    # TargetFeatureFlag represents an instance of FeatureFlag condition in user account
     class TargetFeatureFlagCondition < Condition
       include Kameleoon::Exception
 
@@ -19,13 +19,15 @@ module Kameleoon
       end
 
       def check(data)
-        return false unless data.is_a?(Kameleoon::Targeting::TargetFeatureFlagInfo) && data.variations_storage.size != 0
+        return false unless data.is_a?(TargetFeatureFlagInfo) && data.variations_storage.size.positive?
 
         get_rules(data).any? { |rule| check_rule(data, rule) }
       end
 
-      private def check_rule(data, rule)
-        return false unless rule.is_a?(Kameleoon::Configuration::Rule)
+      private
+
+      def check_rule(data, rule)
+        return false unless rule.is_a?(Configuration::Rule)
         return false if !@condition_rule_id.nil? && (@condition_rule_id != rule.id)
 
         variation = data.variations_storage.get(rule.experiment.id)
@@ -35,7 +37,7 @@ module Kameleoon
 
         variation = data.data_file.variation_by_id[variation.variation_id]
 
-        return false unless variation.is_a?(Kameleoon::Configuration::VariationByExposition)
+        return false unless variation.is_a?(Configuration::VariationByExposition)
 
         variation.variation_key == @condition_variation_key
       end

data/lib/kameleoon/targeting/conditions/target_personalization_condition.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'kameleoon/targeting/condition'
+
+module Kameleoon
+  # @api private
+  module Targeting
+    # TargetPersonalization represents an instance of Personalization condition in user account
+    class TargetPersonalizationCondition < Condition
+      include Kameleoon::Exception
+
+      def initialize(json_condition)
+        super(json_condition)
+
+        @personalization_id = json_condition['personalizationId'] || -1
+      end
+
+      def check(data)
+        return false unless data.is_a?(TargetPersonalizationInfo)
+
+        !data.personalizations_storage&.get(@personalization_id).nil?
+      end
+    end
+
+    class TargetPersonalizationInfo
+      attr_reader :personalizations_storage
+
+      def initialize(personalizations_storage)
+        @personalizations_storage = personalizations_storage
+      end
+    end
+  end
+end

data/lib/kameleoon/targeting/targeting_manager.rb

@@ -1,7 +1,14 @@
 # frozen_string_literal: true
 
 require 'kameleoon/logging/kameleoon_logger'
+require 'kameleoon/targeting/condition'
+require 'kameleoon/targeting/conditions/exclusive_experiment_condition'
+require 'kameleoon/targeting/conditions/exclusive_feature_flag_condition'
+require 'kameleoon/targeting/conditions/sdk_language_condition'
 require 'kameleoon/targeting/conditions/segment_condition'
+require 'kameleoon/targeting/conditions/target_experiment_condition'
+require 'kameleoon/targeting/conditions/target_feature_flag_condition'
+require 'kameleoon/targeting/conditions/target_personalization_condition'
 
 module Kameleoon
   # @api private
@@ -42,47 +49,53 @@ module Kameleoon
         )
         condition_data = nil
         case type
-        when Kameleoon::Targeting::ConditionType::CUSTOM_DATUM
+        when ConditionType::CUSTOM_DATUM
           condition_data = visitor.custom_data unless visitor.nil?
-        when Kameleoon::Targeting::ConditionType::PAGE_VIEWS,
-          Kameleoon::Targeting::ConditionType::PREVIOUS_PAGE,
-          Kameleoon::Targeting::ConditionType::PAGE_TITLE,
-          Kameleoon::Targeting::ConditionType::PAGE_URL
+        when ConditionType::PAGE_VIEWS,
+          ConditionType::PREVIOUS_PAGE,
+          ConditionType::PAGE_TITLE,
+          ConditionType::PAGE_URL
           condition_data = visitor.page_view_visits unless visitor.nil?
-        when Kameleoon::Targeting::ConditionType::DEVICE_TYPE
+        when ConditionType::DEVICE_TYPE
           condition_data = visitor.device unless visitor.nil?
-        when Kameleoon::Targeting::ConditionType::BROWSER
+        when ConditionType::BROWSER
           condition_data = visitor.browser unless visitor.nil?
-        when Kameleoon::Targeting::ConditionType::COOKIE
+        when ConditionType::COOKIE
           condition_data = visitor.cookie unless visitor.nil?
-        when Kameleoon::Targeting::ConditionType::GEOLOCATION
+        when ConditionType::GEOLOCATION
           condition_data = visitor.geolocation unless visitor.nil?
-        when Kameleoon::Targeting::ConditionType::OPERATING_SYSTEM
+        when ConditionType::OPERATING_SYSTEM
           condition_data = visitor.operating_system unless visitor.nil?
-        when Kameleoon::Targeting::ConditionType::SEGMENT
+        when ConditionType::SEGMENT
           condition_data = SegmentInfo.new(
             @data_manager.data_file,
             lambda { |type|
               get_condition_data(type, visitor, visitor_code, campaign_id)
             }
           )
-        when Kameleoon::Targeting::ConditionType::CONVERSIONS
+        when ConditionType::CONVERSIONS
           condition_data = visitor.conversions unless visitor.nil?
-        when Kameleoon::Targeting::ConditionType::SDK_LANGUAGE
-          condition_data = Kameleoon::Targeting::SdkInfo.new(Kameleoon::SDK_NAME, Kameleoon::SDK_VERSION)
-        when Kameleoon::Targeting::ConditionType::VISITOR_CODE
+        when ConditionType::SDK_LANGUAGE
+          condition_data = SdkInfo.new(Kameleoon::SDK_NAME, Kameleoon::SDK_VERSION)
+        when ConditionType::VISITOR_CODE
           condition_data = visitor_code
-        when Kameleoon::Targeting::ConditionType::TARGET_FEATURE_FLAG
+        when ConditionType::TARGET_FEATURE_FLAG
           condition_data = TargetFeatureFlagInfo.new(@data_manager.data_file, visitor.variations) unless visitor.nil?
-        when Kameleoon::Targeting::ConditionType::EXCLUSIVE_FEATURE_FLAG
+        when ConditionType::TARGET_EXPERIMENT
+          condition_data = TargetExperimentInfo.new(visitor&.variations)
+        when ConditionType::TARGET_PERSONALIZATION
+          condition_data = TargetPersonalizationInfo.new(visitor&.personalizations)
+        when ConditionType::EXCLUSIVE_FEATURE_FLAG
           condition_data = ExclusiveFeatureFlagInfo.new(campaign_id, visitor&.variations)
+        when ConditionType::EXCLUSIVE_EXPERIMENT
+          condition_data = ExclusiveExperimentInfo.new(campaign_id, visitor&.variations, visitor&.personalizations)
         when ConditionType::FIRST_VISIT,
           ConditionType::LAST_VISIT,
           ConditionType::VISITS,
           ConditionType::SAME_DAY_VISITS,
           ConditionType::NEW_VISITORS
           condition_data = visitor.visitor_visits unless visitor.nil?
-        when Kameleoon::Targeting::ConditionType::HEAT_SLICE
+        when ConditionType::HEAT_SLICE
           condition_data = visitor&.kcs_heat
         end
         Logging::KameleoonLogger.debug(

data/lib/kameleoon/types/remote_visitor_data_filter.rb

@@ -5,7 +5,7 @@ module Kameleoon
   module Types
     class RemoteVisitorDataFilter
       attr_reader :previous_visit_amount, :current_visit, :custom_data, :page_views, :geolocation, :device, :browser,
-                  :operating_system, :conversions, :experiments, :kcs, :visitor_code, :cbs
+                  :operating_system, :conversions, :experiments, :kcs, :visitor_code, :personalization, :cbs
 
       def to_s
         "RemoteVisitorDataFilter{previous_visit_amount:#{@previous_visit_amount}," \
@@ -20,13 +20,14 @@ module Kameleoon
           "experiments:#{@experiments}," \
           "kcs:#{@kcs}," \
           "visitor_code:#{@visitor_code}}" \
+          "personalization:#{@personalization}}" \
           "cbs:#{@cbs}}"
       end
 
       def initialize(
         previous_visit_amount: 1, current_visit: true, custom_data: true, page_views: false,
         geolocation: false, device: false, browser: false, operating_system: false, conversions: false,
-        experiments: false, kcs: false, visitor_code: true, cbs: false
+        experiments: false, kcs: false, visitor_code: true, personalization: false, cbs: false
       )
         @previous_visit_amount = previous_visit_amount
         @current_visit = current_visit
@@ -40,6 +41,7 @@ module Kameleoon
         @experiments = experiments
         @kcs = kcs
         @visitor_code = visitor_code
+        @personalization = personalization
         @cbs = cbs
       end
     end

data/lib/kameleoon/utils.rb

@@ -50,6 +50,22 @@ module Kameleoon
     end
 
     module Strval
+      def self.obj_to_s(obj)
+        case obj
+        when nil
+          'nil'
+        when String
+          "'#{obj}'"
+        when Array
+          "[#{obj.map { |v| obj_to_s(v) }.join(',')}]"
+        when Hash
+          sb = []
+          obj.each { |k, v| sb.push("#{obj_to_s(k)}:#{obj_to_s(v)}") }
+          "{#{sb.join(',')}}"
+        else
+          obj.to_s
+        end
+      end
 
       def self.secret(secret)
         hid_ch = '*'

data/lib/kameleoon/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Kameleoon
-  SDK_VERSION = '3.10.0'
+  SDK_VERSION = '3.12.0'
   SDK_NAME = 'RUBY'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kameleoon-client-ruby
 version: !ruby/object:Gem::Version
-  version: 3.10.0
+  version: 3.12.0
 platform: ruby
 authors:
 - Kameleoon
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-03-18 00:00:00.000000000 Z
+date: 2025-04-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: em-http-request
@@ -107,6 +107,7 @@ files:
 - lib/kameleoon/data/mapping_identifier.rb
 - lib/kameleoon/data/operating_system.rb
 - lib/kameleoon/data/page_view.rb
+- lib/kameleoon/data/personalization.rb
 - lib/kameleoon/data/unique_identifier.rb
 - lib/kameleoon/data/user_agent.rb
 - lib/kameleoon/data/visitor_visits.rb
@@ -151,6 +152,7 @@ files:
 - lib/kameleoon/targeting/conditions/cookie_condition.rb
 - lib/kameleoon/targeting/conditions/custom_datum.rb
 - lib/kameleoon/targeting/conditions/device_condition.rb
+- lib/kameleoon/targeting/conditions/exclusive_experiment_condition.rb
 - lib/kameleoon/targeting/conditions/exclusive_feature_flag_condition.rb
 - lib/kameleoon/targeting/conditions/geolocation_condition.rb
 - lib/kameleoon/targeting/conditions/kcs_heat_range_condition.rb
@@ -163,7 +165,9 @@ files:
 - lib/kameleoon/targeting/conditions/sdk_language_condition.rb
 - lib/kameleoon/targeting/conditions/segment_condition.rb
 - lib/kameleoon/targeting/conditions/string_value_condition.rb
+- lib/kameleoon/targeting/conditions/target_experiment_condition.rb
 - lib/kameleoon/targeting/conditions/target_feature_flag_condition.rb
+- lib/kameleoon/targeting/conditions/target_personalization_condition.rb
 - lib/kameleoon/targeting/conditions/time_elapsed_since_visit_condition.rb
 - lib/kameleoon/targeting/conditions/unknown_condition.rb
 - lib/kameleoon/targeting/conditions/visit_number_today_condition.rb