Class: Aws::Pinpoint::Types::WriteJourneyRequest

Inherits:
Struct
  • Object
show all
Includes:
Structure
Defined in:
lib/aws-sdk-pinpoint/types.rb

Overview

Note:

When making an API call, you may pass WriteJourneyRequest data as a hash:

{
  activities: {
    "__string" => {
      conditional_split: {
        condition: {
          conditions: [
            {
              event_condition: {
                dimensions: { # required
                  attributes: {
                    "__string" => {
                      attribute_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                      values: ["__string"], # required
                    },
                  },
                  event_type: {
                    dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                    values: ["__string"], # required
                  },
                  metrics: {
                    "__string" => {
                      comparison_operator: "__string", # required
                      value: 1.0, # required
                    },
                  },
                },
                message_activity: "__string",
              },
              segment_condition: {
                segment_id: "__string", # required
              },
              segment_dimensions: {
                attributes: {
                  "__string" => {
                    attribute_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                    values: ["__string"], # required
                  },
                },
                behavior: {
                  recency: {
                    duration: "HR_24", # required, accepts HR_24, DAY_7, DAY_14, DAY_30
                    recency_type: "ACTIVE", # required, accepts ACTIVE, INACTIVE
                  },
                },
                demographic: {
                  app_version: {
                    dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                    values: ["__string"], # required
                  },
                  channel: {
                    dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                    values: ["__string"], # required
                  },
                  device_type: {
                    dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                    values: ["__string"], # required
                  },
                  make: {
                    dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                    values: ["__string"], # required
                  },
                  model: {
                    dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                    values: ["__string"], # required
                  },
                  platform: {
                    dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                    values: ["__string"], # required
                  },
                },
                location: {
                  country: {
                    dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                    values: ["__string"], # required
                  },
                  gps_point: {
                    coordinates: { # required
                      latitude: 1.0, # required
                      longitude: 1.0, # required
                    },
                    range_in_kilometers: 1.0,
                  },
                },
                metrics: {
                  "__string" => {
                    comparison_operator: "__string", # required
                    value: 1.0, # required
                  },
                },
                user_attributes: {
                  "__string" => {
                    attribute_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                    values: ["__string"], # required
                  },
                },
              },
            },
          ],
          operator: "ALL", # accepts ALL, ANY
        },
        evaluation_wait_time: {
          wait_for: "__string",
          wait_until: "__string",
        },
        false_activity: "__string",
        true_activity: "__string",
      },
      description: "__string",
      email: {
        message_config: {
          from_address: "__string",
        },
        next_activity: "__string",
        template_name: "__string",
        template_version: "__string",
      },
      holdout: {
        next_activity: "__string",
        percentage: 1, # required
      },
      multi_condition: {
        branches: [
          {
            condition: {
              event_condition: {
                dimensions: { # required
                  attributes: {
                    "__string" => {
                      attribute_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                      values: ["__string"], # required
                    },
                  },
                  event_type: {
                    dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                    values: ["__string"], # required
                  },
                  metrics: {
                    "__string" => {
                      comparison_operator: "__string", # required
                      value: 1.0, # required
                    },
                  },
                },
                message_activity: "__string",
              },
              segment_condition: {
                segment_id: "__string", # required
              },
              segment_dimensions: {
                attributes: {
                  "__string" => {
                    attribute_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                    values: ["__string"], # required
                  },
                },
                behavior: {
                  recency: {
                    duration: "HR_24", # required, accepts HR_24, DAY_7, DAY_14, DAY_30
                    recency_type: "ACTIVE", # required, accepts ACTIVE, INACTIVE
                  },
                },
                demographic: {
                  app_version: {
                    dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                    values: ["__string"], # required
                  },
                  channel: {
                    dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                    values: ["__string"], # required
                  },
                  device_type: {
                    dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                    values: ["__string"], # required
                  },
                  make: {
                    dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                    values: ["__string"], # required
                  },
                  model: {
                    dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                    values: ["__string"], # required
                  },
                  platform: {
                    dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                    values: ["__string"], # required
                  },
                },
                location: {
                  country: {
                    dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                    values: ["__string"], # required
                  },
                  gps_point: {
                    coordinates: { # required
                      latitude: 1.0, # required
                      longitude: 1.0, # required
                    },
                    range_in_kilometers: 1.0,
                  },
                },
                metrics: {
                  "__string" => {
                    comparison_operator: "__string", # required
                    value: 1.0, # required
                  },
                },
                user_attributes: {
                  "__string" => {
                    attribute_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
                    values: ["__string"], # required
                  },
                },
              },
            },
            next_activity: "__string",
          },
        ],
        default_activity: "__string",
        evaluation_wait_time: {
          wait_for: "__string",
          wait_until: "__string",
        },
      },
      random_split: {
        branches: [
          {
            next_activity: "__string",
            percentage: 1,
          },
        ],
      },
      wait: {
        next_activity: "__string",
        wait_time: {
          wait_for: "__string",
          wait_until: "__string",
        },
      },
    },
  },
  creation_date: "__string",
  last_modified_date: "__string",
  limits: {
    daily_cap: 1,
    endpoint_reentry_cap: 1,
    messages_per_second: 1,
  },
  local_time: false,
  name: "__string", # required
  quiet_time: {
    end: "__string",
    start: "__string",
  },
  refresh_frequency: "__string",
  schedule: {
    end_time: Time.now,
    start_time: Time.now,
    timezone: "__string",
  },
  start_activity: "__string",
  start_condition: {
    description: "__string",
    segment_start_condition: {
      segment_id: "__string", # required
    },
  },
  state: "DRAFT", # accepts DRAFT, ACTIVE, COMPLETED, CANCELLED, CLOSED
}

Specifies the configuration and other settings for a journey.

See Also:

Instance Attribute Summary collapse

Instance Attribute Details

#activities ⇒ Hash<String,Types::Activity>

A map that contains a set of Activity objects, one object for each activity in the journey. For each Activity object, the key is the unique identifier (string) for an activity and the value is the settings for the activity. An activity identifier can contain a maximum of 100 characters. The characters must be alphanumeric characters.

Returns:



18356
18357
18358
18359
18360
18361
18362
18363
18364
18365
18366
18367
18368
18369
18370
 
# File 'lib/aws-sdk-pinpoint/types.rb', line 18356

class WriteJourneyRequest < Struct.new(
  :activities,
  :creation_date,
  :last_modified_date,
  :limits,
  :local_time,
  :name,
  :quiet_time,
  :refresh_frequency,
  :schedule,
  :start_activity,
  :start_condition,
  :state)
  include Aws::Structure
end

#creation_date ⇒ String

The date, in ISO 8601 format, when the journey was created.

Returns:

  • (String) 


18356
18357
18358
18359
18360
18361
18362
18363
18364
18365
18366
18367
18368
18369
18370
 
# File 'lib/aws-sdk-pinpoint/types.rb', line 18356

class WriteJourneyRequest < Struct.new(
  :activities,
  :creation_date,
  :last_modified_date,
  :limits,
  :local_time,
  :name,
  :quiet_time,
  :refresh_frequency,
  :schedule,
  :start_activity,
  :start_condition,
  :state)
  include Aws::Structure
end

#last_modified_date ⇒ String

The date, in ISO 8601 format, when the journey was last modified.

Returns:

  • (String) 


18356
18357
18358
18359
18360
18361
18362
18363
18364
18365
18366
18367
18368
18369
18370
 
# File 'lib/aws-sdk-pinpoint/types.rb', line 18356

class WriteJourneyRequest < Struct.new(
  :activities,
  :creation_date,
  :last_modified_date,
  :limits,
  :local_time,
  :name,
  :quiet_time,
  :refresh_frequency,
  :schedule,
  :start_activity,
  :start_condition,
  :state)
  include Aws::Structure
end

#limits ⇒ Types::JourneyLimits

The messaging and entry limits for the journey.

Returns:



18356
18357
18358
18359
18360
18361
18362
18363
18364
18365
18366
18367
18368
18369
18370
 
# File 'lib/aws-sdk-pinpoint/types.rb', line 18356

class WriteJourneyRequest < Struct.new(
  :activities,
  :creation_date,
  :last_modified_date,
  :limits,
  :local_time,
  :name,
  :quiet_time,
  :refresh_frequency,
  :schedule,
  :start_activity,
  :start_condition,
  :state)
  include Aws::Structure
end

#local_time ⇒ Boolean

Specifies whether the journey’s scheduled start and end times use each participant’s local time. To base the schedule on each participant’s local time, set this value to true.

Returns:

  • (Boolean) 


18356
18357
18358
18359
18360
18361
18362
18363
18364
18365
18366
18367
18368
18369
18370
 
# File 'lib/aws-sdk-pinpoint/types.rb', line 18356

class WriteJourneyRequest < Struct.new(
  :activities,
  :creation_date,
  :last_modified_date,
  :limits,
  :local_time,
  :name,
  :quiet_time,
  :refresh_frequency,
  :schedule,
  :start_activity,
  :start_condition,
  :state)
  include Aws::Structure
end

#name ⇒ String

The name of the journey. A journey name can contain a maximum of 150 characters. The characters can be alphanumeric characters or symbols, such as underscores (_) or hyphens (-). A journey name can’t contain any spaces.

Returns:

  • (String) 


18356
18357
18358
18359
18360
18361
18362
18363
18364
18365
18366
18367
18368
18369
18370
 
# File 'lib/aws-sdk-pinpoint/types.rb', line 18356

class WriteJourneyRequest < Struct.new(
  :activities,
  :creation_date,
  :last_modified_date,
  :limits,
  :local_time,
  :name,
  :quiet_time,
  :refresh_frequency,
  :schedule,
  :start_activity,
  :start_condition,
  :state)
  include Aws::Structure
end

#quiet_time ⇒ Types::QuietTime

The quiet time settings for the journey. Quiet time is a specific time range when a journey doesn’t send messages to participants, if all the following conditions are met:

  • The EndpointDemographic.Timezone property of the endpoint for the participant is set to a valid value.

  • The current time in the participant’s time zone is later than or equal to the time specified by the QuietTime.Start property for the journey.

  • The current time in the participant’s time zone is earlier than or equal to the time specified by the QuietTime.End property for the journey.

If any of the preceding conditions isn’t met, the participant will receive messages from the journey, even if quiet time is enabled.

Returns:



18356
18357
18358
18359
18360
18361
18362
18363
18364
18365
18366
18367
18368
18369
18370
 
# File 'lib/aws-sdk-pinpoint/types.rb', line 18356

class WriteJourneyRequest < Struct.new(
  :activities,
  :creation_date,
  :last_modified_date,
  :limits,
  :local_time,
  :name,
  :quiet_time,
  :refresh_frequency,
  :schedule,
  :start_activity,
  :start_condition,
  :state)
  include Aws::Structure
end

#refresh_frequency ⇒ String

The frequency with which Amazon Pinpoint evaluates segment and event data for the journey, as a duration in ISO 8601 format.

Returns:

  • (String) 


18356
18357
18358
18359
18360
18361
18362
18363
18364
18365
18366
18367
18368
18369
18370
 
# File 'lib/aws-sdk-pinpoint/types.rb', line 18356

class WriteJourneyRequest < Struct.new(
  :activities,
  :creation_date,
  :last_modified_date,
  :limits,
  :local_time,
  :name,
  :quiet_time,
  :refresh_frequency,
  :schedule,
  :start_activity,
  :start_condition,
  :state)
  include Aws::Structure
end

#schedule ⇒ Types::JourneySchedule

The schedule settings for the journey.

Returns:



18356
18357
18358
18359
18360
18361
18362
18363
18364
18365
18366
18367
18368
18369
18370
 
# File 'lib/aws-sdk-pinpoint/types.rb', line 18356

class WriteJourneyRequest < Struct.new(
  :activities,
  :creation_date,
  :last_modified_date,
  :limits,
  :local_time,
  :name,
  :quiet_time,
  :refresh_frequency,
  :schedule,
  :start_activity,
  :start_condition,
  :state)
  include Aws::Structure
end

#start_activity ⇒ String

The unique identifier for the first activity in the journey. The identifier for this activity can contain a maximum of 128 characters. The characters must be alphanumeric characters.

Returns:

  • (String) 


18356
18357
18358
18359
18360
18361
18362
18363
18364
18365
18366
18367
18368
18369
18370
 
# File 'lib/aws-sdk-pinpoint/types.rb', line 18356

class WriteJourneyRequest < Struct.new(
  :activities,
  :creation_date,
  :last_modified_date,
  :limits,
  :local_time,
  :name,
  :quiet_time,
  :refresh_frequency,
  :schedule,
  :start_activity,
  :start_condition,
  :state)
  include Aws::Structure
end

#start_condition ⇒ Types::StartCondition

The segment that defines which users are participants in the journey.

Returns:



18356
18357
18358
18359
18360
18361
18362
18363
18364
18365
18366
18367
18368
18369
18370
 
# File 'lib/aws-sdk-pinpoint/types.rb', line 18356

class WriteJourneyRequest < Struct.new(
  :activities,
  :creation_date,
  :last_modified_date,
  :limits,
  :local_time,
  :name,
  :quiet_time,
  :refresh_frequency,
  :schedule,
  :start_activity,
  :start_condition,
  :state)
  include Aws::Structure
end

#state ⇒ String

The status of the journey. Valid values are:

  • DRAFT - Saves the journey and doesn’t publish it.

  • ACTIVE - Saves and publishes the journey. Depending on the journey’s schedule, the journey starts running immediately or at the scheduled start time. If a journey’s status is ACTIVE, you can’t add, change, or remove activities from it.

The CANCELLED, COMPLETED, and CLOSED values are not supported in requests to create or update a journey. To cancel a journey, use the <link linkend=“apps-application-id-journeys-journey-id-state” />

Journey State</link> resource.

Returns:

  • (String) 


18356
18357
18358
18359
18360
18361
18362
18363
18364
18365
18366
18367
18368
18369
18370
 
# File 'lib/aws-sdk-pinpoint/types.rb', line 18356

class WriteJourneyRequest < Struct.new(
  :activities,
  :creation_date,
  :last_modified_date,
  :limits,
  :local_time,
  :name,
  :quiet_time,
  :refresh_frequency,
  :schedule,
  :start_activity,
  :start_condition,
  :state)
  include Aws::Structure
end