optimizely-sdk 3.2.0 → 3.3.0

data/lib/optimizely/event/event_factory.rb

@@ -0,0 +1,154 @@
+# frozen_string_literal: true
+
+#
+#    Copyright 2019, Optimizely and contributors
+#
+#    Licensed under the Apache License, Version 2.0 (the "License");
+#    you may not use this file except in compliance with the License.
+#    You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS,
+#    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#    See the License for the specific language governing permissions and
+#    limitations under the License.
+#
+require_relative 'entity/event_batch'
+require_relative 'entity/conversion_event'
+require_relative 'entity/decision'
+require_relative 'entity/impression_event'
+require_relative 'entity/snapshot'
+require_relative 'entity/snapshot_event'
+require_relative 'entity/visitor'
+require 'optimizely/helpers/validator'
+module Optimizely
+  class EventFactory
+    # EventFactory builds LogEvent objects from a given user_event.
+    class << self
+      CUSTOM_ATTRIBUTE_FEATURE_TYPE = 'custom'
+      ENDPOINT = 'https://logx.optimizely.com/v1/events'
+      POST_HEADERS = {'Content-Type' => 'application/json'}.freeze
+      ACTIVATE_EVENT_KEY = 'campaign_activated'
+
+      def create_log_event(user_events, logger)
+        @logger = logger
+        builder = Optimizely::EventBatch::Builder.new
+
+        user_events = [user_events] unless user_events.is_a? Array
+
+        visitors = []
+        user_context = nil
+        user_events.each do |user_event|
+          if user_event.is_a? Optimizely::ImpressionEvent
+            visitor = create_impression_event_visitor(user_event)
+            visitors.push(visitor)
+          elsif user_event.is_a? Optimizely::ConversionEvent
+            visitor = create_conversion_event_visitor(user_event)
+            visitors.push(visitor)
+          else
+            @logger.log(Logger::WARN, 'invalid UserEvent added in a list.')
+            next
+          end
+          user_context = user_event.event_context
+        end
+
+        return nil if visitors.empty?
+
+        builder.with_account_id(user_context[:account_id])
+        builder.with_project_id(user_context[:project_id])
+        builder.with_client_version(user_context[:client_version])
+        builder.with_revision(user_context[:revision])
+        builder.with_client_name(user_context[:client_name])
+        builder.with_anonymize_ip(user_context[:anonymize_ip])
+        builder.with_enrich_decisions(true)
+
+        builder.with_visitors(visitors)
+        event_batch = builder.build
+        Event.new(:post, ENDPOINT, event_batch.as_json, POST_HEADERS)
+      end
+
+      def build_attribute_list(user_attributes, project_config)
+        visitor_attributes = []
+        user_attributes&.keys&.each do |attribute_key|
+          # Omit attribute values that are not supported by the log endpoint.
+          attribute_value = user_attributes[attribute_key]
+          next unless Helpers::Validator.attribute_valid?(attribute_key, attribute_value)
+
+          attribute_id = project_config.get_attribute_id attribute_key
+          next if attribute_id.nil?
+
+          visitor_attributes.push(
+            entity_id: attribute_id,
+            key: attribute_key,
+            type: CUSTOM_ATTRIBUTE_FEATURE_TYPE,
+            value: attribute_value
+          )
+        end
+
+        return visitor_attributes unless Helpers::Validator.boolean? project_config.bot_filtering
+
+        # Append Bot Filtering Attribute
+        visitor_attributes.push(
+          entity_id: Optimizely::Helpers::Constants::CONTROL_ATTRIBUTES['BOT_FILTERING'],
+          key: Optimizely::Helpers::Constants::CONTROL_ATTRIBUTES['BOT_FILTERING'],
+          type: CUSTOM_ATTRIBUTE_FEATURE_TYPE,
+          value: project_config.bot_filtering
+        )
+      end
+
+      private
+
+      def create_impression_event_visitor(impression_event)
+        decision = Optimizely::Decision.new(
+          campaign_id: impression_event.experiment_layer_id,
+          experiment_id: impression_event.experiment_id,
+          variation_id: impression_event.variation_id
+        )
+
+        snapshot_event = Optimizely::SnapshotEvent.new(
+          entity_id: impression_event.experiment_layer_id,
+          timestamp: impression_event.timestamp,
+          uuid: impression_event.uuid,
+          key: ACTIVATE_EVENT_KEY
+        )
+
+        snapshot = Optimizely::Snapshot.new(
+          events: [snapshot_event.as_json],
+          decisions: [decision.as_json]
+        )
+
+        visitor = Optimizely::Visitor.new(
+          snapshots: [snapshot.as_json],
+          visitor_id: impression_event.user_id,
+          attributes: impression_event.visitor_attributes
+        )
+        visitor.as_json
+      end
+
+      def create_conversion_event_visitor(conversion_event)
+        revenue_value = Helpers::EventTagUtils.get_revenue_value(conversion_event.tags, @logger)
+        numeric_value = Helpers::EventTagUtils.get_numeric_value(conversion_event.tags, @logger)
+        snapshot_event = Optimizely::SnapshotEvent.new(
+          entity_id: conversion_event.event['id'],
+          timestamp: conversion_event.timestamp,
+          uuid: conversion_event.uuid,
+          key: conversion_event.event['key'],
+          revenue: revenue_value,
+          value: numeric_value,
+          tags: conversion_event.tags
+        )
+
+        snapshot = Optimizely::Snapshot.new(events: [snapshot_event.as_json])
+
+        visitor = Optimizely::Visitor.new(
+          snapshots: [snapshot.as_json],
+          visitor_id: conversion_event.user_id,
+          attributes: conversion_event.visitor_attributes
+        )
+        visitor.as_json
+      end
+    end
+  end
+end

data/lib/optimizely/event/event_processor.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+#
+#    Copyright 2019, Optimizely and contributors
+#
+#    Licensed under the Apache License, Version 2.0 (the "License");
+#    you may not use this file except in compliance with the License.
+#    You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS,
+#    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#    See the License for the specific language governing permissions and
+#    limitations under the License.
+#
+module Optimizely
+  class EventProcessor
+    # EventProcessor interface is used to provide an intermediary processing stage within
+    # event production. It's assumed that the EventProcessor dispatches events via a provided
+    # EventDispatcher.
+    def process(user_event); end
+  end
+end

data/lib/optimizely/event/forwarding_event_processor.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+#
+#    Copyright 2019, Optimizely and contributors
+#
+#    Licensed under the Apache License, Version 2.0 (the "License");
+#    you may not use this file except in compliance with the License.
+#    You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS,
+#    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#    See the License for the specific language governing permissions and
+#    limitations under the License.
+#
+require_relative 'event_processor'
+module Optimizely
+  class ForwardingEventProcessor < EventProcessor
+    # ForwardingEventProcessor is a basic transformation stage for converting
+    # the event batch into a LogEvent to be dispatched.
+    def initialize(event_dispatcher, logger = nil, notification_center = nil)
+      @event_dispatcher = event_dispatcher
+      @logger = logger || NoOpLogger.new
+      @notification_center = notification_center
+    end
+
+    def process(user_event)
+      log_event = Optimizely::EventFactory.create_log_event(user_event, @logger)
+
+      begin
+        @event_dispatcher.dispatch_event(log_event)
+        @notification_center&.send_notifications(
+          NotificationCenter::NOTIFICATION_TYPES[:LOG_EVENT],
+          log_event
+        )
+      rescue StandardError => e
+        @logger.log(Logger::ERROR, "Error dispatching event: #{log_event} #{e.message}.")
+      end
+    end
+  end
+end

data/lib/optimizely/event/user_event_factory.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+#
+#    Copyright 2019, Optimizely and contributors
+#
+#    Licensed under the Apache License, Version 2.0 (the "License");
+#    you may not use this file except in compliance with the License.
+#    You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS,
+#    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#    See the License for the specific language governing permissions and
+#    limitations under the License.
+#
+require_relative 'entity/conversion_event'
+require_relative 'entity/impression_event'
+require_relative 'entity/event_context'
+require_relative 'event_factory'
+module Optimizely
+  class UserEventFactory
+    # UserEventFactory builds ImpressionEvent and ConversionEvent objects from a given user_event.
+    def self.create_impression_event(project_config, experiment, variation_id, user_id, user_attributes)
+      # Create impression Event to be sent to the logging endpoint.
+      #
+      # project_config - Instance of ProjectConfig
+      # experiment -   Instance Experiment for which impression needs to be recorded.
+      # variation_id - String ID for variation which would be presented to user.
+      # user_id -      String ID for user.
+      # attributes -   Hash Representing user attributes and values which need to be recorded.
+      #
+      # Returns Event encapsulating the impression event.
+      event_context = Optimizely::EventContext.new(
+        account_id: project_config.account_id,
+        project_id: project_config.project_id,
+        anonymize_ip: project_config.anonymize_ip,
+        revision: project_config.revision,
+        client_name: CLIENT_ENGINE,
+        client_version: VERSION
+      ).as_json
+
+      visitor_attributes = Optimizely::EventFactory.build_attribute_list(user_attributes, project_config)
+      experiment_layer_id = project_config.experiment_key_map[experiment['key']]['layerId']
+      Optimizely::ImpressionEvent.new(
+        event_context: event_context,
+        user_id: user_id,
+        experiment_layer_id: experiment_layer_id,
+        experiment_id: experiment['id'],
+        variation_id: variation_id,
+        visitor_attributes: visitor_attributes,
+        bot_filtering: project_config.bot_filtering
+      )
+    end
+
+    def self.create_conversion_event(project_config, event, user_id, user_attributes, event_tags)
+      # Create conversion Event to be sent to the logging endpoint.
+      #
+      # project_config - Instance of ProjectConfig
+      # event - Event which needs to be recorded.
+      # user_id - String ID for user.
+      # attributes - Hash Representing user attributes and values which need to be recorded.
+      # event_tags - Hash representing metadata associated with the event.
+      #
+      # Returns Event encapsulating the conversion event.
+
+      event_context = Optimizely::EventContext.new(
+        account_id: project_config.account_id,
+        project_id: project_config.project_id,
+        anonymize_ip: project_config.anonymize_ip,
+        revision: project_config.revision,
+        client_name: CLIENT_ENGINE,
+        client_version: VERSION
+      ).as_json
+
+      Optimizely::ConversionEvent.new(
+        event_context: event_context,
+        event: event,
+        user_id: user_id,
+        visitor_attributes: Optimizely::EventFactory.build_attribute_list(user_attributes, project_config),
+        tags: event_tags,
+        bot_filtering: project_config.bot_filtering
+      )
+    end
+  end
+end

data/lib/optimizely/helpers/constants.rb

@@ -362,7 +362,7 @@ module Optimizely
 
       CONFIG_MANAGER = {
         'DATAFILE_URL_TEMPLATE' => 'https://cdn.optimizely.com/datafiles/%s.json',
-        # Default time in seconds to block the get_config call until config has been initialized.
+        # Default time in seconds to block the 'config' method call until 'config' instance has been initialized.
         'DEFAULT_BLOCKING_TIMEOUT' => 15,
         # Default config update interval of 5 minutes
         'DEFAULT_UPDATE_INTERVAL' => 5 * 60,

data/lib/optimizely/helpers/date_time_utils.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+#
+#    Copyright 2019, Optimizely and contributors
+#
+#    Licensed under the Apache License, Version 2.0 (the "License");
+#    you may not use this file except in compliance with the License.
+#    You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS,
+#    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#    See the License for the specific language governing permissions and
+#    limitations under the License.
+#
+module Optimizely
+  module Helpers
+    module DateTimeUtils
+      module_function
+
+      def create_timestamp
+        # Returns Integer current UTC timestamp
+        utc = Time.now.getutc
+        (utc.to_f * 1000).to_i
+      end
+    end
+  end
+end

data/lib/optimizely/helpers/validator.rb

@@ -132,6 +132,15 @@ module Optimizely
           variables.delete :user_id
         end
 
+        if variables.include? :variable_type
+          # Empty variable_type is a valid user ID.
+          unless variables[:variable_type].is_a?(String) || !variables[:variable_type]
+            is_valid = false
+            logger.log(level, "#{Constants::INPUT_VARIABLES['VARIABLE_TYPE']} is invalid")
+          end
+          variables.delete :variable_type
+        end
+
         variables.each do |key, value|
           next if value.is_a?(String) && !value.empty?
 

data/lib/optimizely/notification_center.rb

@@ -24,6 +24,7 @@ module Optimizely
       # DEPRECATED: ACTIVATE notification type is deprecated since relase 3.1.0.
       ACTIVATE: 'ACTIVATE: experiment, user_id, attributes, variation, event',
       DECISION: 'DECISION: type, user_id, attributes, decision_info',
+      LOG_EVENT: 'LOG_EVENT: type, log_event',
       OPTIMIZELY_CONFIG_UPDATE: 'optimizely_config_update',
       TRACK: 'TRACK: event_key, user_id, attributes, event_tags, event'
     }.freeze
@@ -137,6 +138,10 @@ module Optimizely
       end
     end
 
+    def notification_count(notification_type)
+      @notifications.include?(notification_type) ? @notifications[notification_type].count : 0
+    end
+
     private
 
     def notification_type_valid?(notification_type)

data/lib/optimizely/optimizely_factory.rb

@@ -17,8 +17,56 @@
 #
 
 require 'optimizely'
+require 'optimizely/event_dispatcher'
+require 'optimizely/event/batch_event_processor'
 module Optimizely
   class OptimizelyFactory
+    attr_reader :max_event_batch_size, :max_event_flush_interval
+
+    # Convenience method for setting the maximum number of events contained within a batch.
+    # @param batch_size Integer - Sets size of EventQueue.
+    # @param logger - Optional LoggerInterface Provides a log method to log messages.
+    def self.max_event_batch_size(batch_size, logger)
+      unless batch_size.is_a? Integer
+        logger.log(
+          Logger::ERROR,
+          "Batch size is invalid, setting to default batch size #{BatchEventProcessor::DEFAULT_BATCH_SIZE}."
+        )
+        return
+      end
+
+      unless batch_size.positive?
+        logger.log(
+          Logger::ERROR,
+          "Batch size is negative, setting to default batch size #{BatchEventProcessor::DEFAULT_BATCH_SIZE}."
+        )
+        return
+      end
+      @max_event_batch_size = batch_size
+    end
+
+    # Convenience method for setting the maximum time interval in milliseconds between event dispatches.
+    # @param flush_interval Numeric - Time interval between event dispatches.
+    # @param logger - Optional LoggerInterface Provides a log method to log messages.
+    def self.max_event_flush_interval(flush_interval, logger)
+      unless flush_interval.is_a? Numeric
+        logger.log(
+          Logger::ERROR,
+          "Flush interval is invalid, setting to default flush interval #{BatchEventProcessor::DEFAULT_BATCH_INTERVAL}."
+        )
+        return
+      end
+
+      unless flush_interval.positive?
+        logger.log(
+          Logger::ERROR,
+          "Flush interval is negative, setting to default flush interval #{BatchEventProcessor::DEFAULT_BATCH_INTERVAL}."
+        )
+        return
+      end
+      @max_event_flush_interval = flush_interval
+    end
+
     # Returns a new optimizely instance.
     #
     # @params sdk_key - Required String uniquely identifying the fallback datafile corresponding to project.
@@ -29,7 +77,7 @@ module Optimizely
 
     # Returns a new optimizely instance.
     #
-    # @param config_manager - Required ConfigManagerInterface Responds to get_config.
+    # @param config_manager - Required ConfigManagerInterface Responds to 'config' method.
     def self.default_instance_with_config_manager(config_manager)
       Optimizely::Project.new(nil, nil, nil, nil, nil, nil, nil, config_manager)
     end
@@ -44,8 +92,11 @@ module Optimizely
     #                 By default all exceptions will be suppressed.
     # @param skip_json_validation - Optional Boolean param to skip JSON schema validation of the provided datafile.
     # @param user_profile_service - Optional UserProfileServiceInterface Provides methods to store and retreive user profiles.
-    # @param config_manager - Optional ConfigManagerInterface Responds to get_config.
+    # @param config_manager - Optional ConfigManagerInterface Responds to 'config' method.
     # @param notification_center - Optional Instance of NotificationCenter.
+    #
+    # if @max_event_batch_size and @max_event_flush_interval are nil then default batchsize and flush_interval
+    # will be used to setup batchEventProcessor.
     def self.custom_instance(
       sdk_key,
       datafile = nil,
@@ -57,6 +108,13 @@ module Optimizely
       config_manager = nil,
       notification_center = nil
     )
+      event_processor = BatchEventProcessor.new(
+        event_dispatcher: event_dispatcher || EventDispatcher.new,
+        batch_size: @max_event_batch_size,
+        flush_interval: @max_event_flush_interval,
+        notification_center: notification_center
+      )
+
       Optimizely::Project.new(
         datafile,
         event_dispatcher,
@@ -66,7 +124,8 @@ module Optimizely
         user_profile_service,
         sdk_key,
         config_manager,
-        notification_center
+        notification_center,
+        event_processor
       )
     end
   end