Class: Aws::Pinpoint::Types::WriteCampaignRequest

Inherits:

Struct

• Object
• Struct
• Aws::Pinpoint::Types::WriteCampaignRequest

Includes:

Structure

Defined in:

lib/aws-sdk-pinpoint/types.rb

Overview

Specifies the configuration and other settings for a campaign.

See Also:

• AWS API Documentation

Constant Summary

SENSITIVE =

[]

Instance Attribute Summary

• #additional_treatments ⇒ Array<Types::WriteTreatmentResource>

  An array of requests that defines additional treatments for the campaign, in addition to the default treatment for the campaign.

• #custom_delivery_configuration ⇒ Types::CustomDeliveryConfiguration

  The delivery configuration settings for sending the campaign through a custom channel.

• #description ⇒ String

  A custom description of the campaign.

• #holdout_percent ⇒ Integer

  The allocated percentage of users (segment members) who shouldn’t receive messages from the campaign.

• #hook ⇒ Types::CampaignHook

  The settings for the AWS Lambda function to invoke as a code hook for the campaign.

• #is_paused ⇒ Boolean

  Specifies whether to pause the campaign.

• #limits ⇒ Types::CampaignLimits

  The messaging limits for the campaign.

• #message_configuration ⇒ Types::MessageConfiguration

  The message configuration settings for the campaign.

• #name ⇒ String

  A custom name for the campaign.

• #priority ⇒ Integer

  Defines the priority of the campaign, used to decide the order of messages displayed to user if there are multiple messages scheduled to be displayed at the same moment.

• #schedule ⇒ Types::Schedule

  The schedule settings for the campaign.

• #segment_id ⇒ String

  The unique identifier for the segment to associate with the campaign.

• #segment_version ⇒ Integer

  The version of the segment to associate with the campaign.

• #tags ⇒ Hash<String,String>

  <note markdown=“1”>As of 22-05-2023 tags has been deprecated for update operations.

• #template_configuration ⇒ Types::TemplateConfiguration

  The message template to use for the campaign.

• #treatment_description ⇒ String

  A custom description of the default treatment for the campaign.

• #treatment_name ⇒ String

  A custom name of the default treatment for the campaign, if the campaign has multiple treatments.

Instance Attribute Details

#additional_treatments ⇒ Array<Types::WriteTreatmentResource>

An array of requests that defines additional treatments for the campaign, in addition to the default treatment for the campaign.

Returns:

• (Array<Types::WriteTreatmentResource>)

# File 'lib/aws-sdk-pinpoint/types.rb', line 13799

class WriteCampaignRequest < Struct.new(
  :additional_treatments,
  :custom_delivery_configuration,
  :description,
  :holdout_percent,
  :hook,
  :is_paused,
  :limits,
  :message_configuration,
  :name,
  :schedule,
  :segment_id,
  :segment_version,
  :tags,
  :template_configuration,
  :treatment_description,
  :treatment_name,
  :priority)
  SENSITIVE = []
  include Aws::Structure
end

#custom_delivery_configuration ⇒ Types::CustomDeliveryConfiguration

The delivery configuration settings for sending the campaign through a custom channel. This object is required if the MessageConfiguration object for the campaign specifies a CustomMessage object.

Returns:

• (Types::CustomDeliveryConfiguration)

# File 'lib/aws-sdk-pinpoint/types.rb', line 13799

class WriteCampaignRequest < Struct.new(
  :additional_treatments,
  :custom_delivery_configuration,
  :description,
  :holdout_percent,
  :hook,
  :is_paused,
  :limits,
  :message_configuration,
  :name,
  :schedule,
  :segment_id,
  :segment_version,
  :tags,
  :template_configuration,
  :treatment_description,
  :treatment_name,
  :priority)
  SENSITIVE = []
  include Aws::Structure
end

#description ⇒ String

A custom description of the campaign.

Returns:

• (String)

# File 'lib/aws-sdk-pinpoint/types.rb', line 13799

class WriteCampaignRequest < Struct.new(
  :additional_treatments,
  :custom_delivery_configuration,
  :description,
  :holdout_percent,
  :hook,
  :is_paused,
  :limits,
  :message_configuration,
  :name,
  :schedule,
  :segment_id,
  :segment_version,
  :tags,
  :template_configuration,
  :treatment_description,
  :treatment_name,
  :priority)
  SENSITIVE = []
  include Aws::Structure
end

#holdout_percent ⇒ Integer

The allocated percentage of users (segment members) who shouldn’t receive messages from the campaign.

Returns:

• (Integer)

# File 'lib/aws-sdk-pinpoint/types.rb', line 13799

class WriteCampaignRequest < Struct.new(
  :additional_treatments,
  :custom_delivery_configuration,
  :description,
  :holdout_percent,
  :hook,
  :is_paused,
  :limits,
  :message_configuration,
  :name,
  :schedule,
  :segment_id,
  :segment_version,
  :tags,
  :template_configuration,
  :treatment_description,
  :treatment_name,
  :priority)
  SENSITIVE = []
  include Aws::Structure
end

#hook ⇒ Types::CampaignHook

The settings for the AWS Lambda function to invoke as a code hook for the campaign. You can use this hook to customize the segment that’s used by the campaign.

Returns:

• (Types::CampaignHook)

# File 'lib/aws-sdk-pinpoint/types.rb', line 13799

class WriteCampaignRequest < Struct.new(
  :additional_treatments,
  :custom_delivery_configuration,
  :description,
  :holdout_percent,
  :hook,
  :is_paused,
  :limits,
  :message_configuration,
  :name,
  :schedule,
  :segment_id,
  :segment_version,
  :tags,
  :template_configuration,
  :treatment_description,
  :treatment_name,
  :priority)
  SENSITIVE = []
  include Aws::Structure
end

#is_paused ⇒ Boolean

Specifies whether to pause the campaign. A paused campaign doesn’t run unless you resume it by changing this value to false.

Returns:

• (Boolean)

# File 'lib/aws-sdk-pinpoint/types.rb', line 13799

class WriteCampaignRequest < Struct.new(
  :additional_treatments,
  :custom_delivery_configuration,
  :description,
  :holdout_percent,
  :hook,
  :is_paused,
  :limits,
  :message_configuration,
  :name,
  :schedule,
  :segment_id,
  :segment_version,
  :tags,
  :template_configuration,
  :treatment_description,
  :treatment_name,
  :priority)
  SENSITIVE = []
  include Aws::Structure
end

#limits ⇒ Types::CampaignLimits

The messaging limits for the campaign.

Returns:

• (Types::CampaignLimits)

# File 'lib/aws-sdk-pinpoint/types.rb', line 13799

class WriteCampaignRequest < Struct.new(
  :additional_treatments,
  :custom_delivery_configuration,
  :description,
  :holdout_percent,
  :hook,
  :is_paused,
  :limits,
  :message_configuration,
  :name,
  :schedule,
  :segment_id,
  :segment_version,
  :tags,
  :template_configuration,
  :treatment_description,
  :treatment_name,
  :priority)
  SENSITIVE = []
  include Aws::Structure
end

#message_configuration ⇒ Types::MessageConfiguration

The message configuration settings for the campaign.

Returns:

• (Types::MessageConfiguration)

# File 'lib/aws-sdk-pinpoint/types.rb', line 13799

class WriteCampaignRequest < Struct.new(
  :additional_treatments,
  :custom_delivery_configuration,
  :description,
  :holdout_percent,
  :hook,
  :is_paused,
  :limits,
  :message_configuration,
  :name,
  :schedule,
  :segment_id,
  :segment_version,
  :tags,
  :template_configuration,
  :treatment_description,
  :treatment_name,
  :priority)
  SENSITIVE = []
  include Aws::Structure
end

#name ⇒ String

A custom name for the campaign.

Returns:

• (String)

# File 'lib/aws-sdk-pinpoint/types.rb', line 13799

class WriteCampaignRequest < Struct.new(
  :additional_treatments,
  :custom_delivery_configuration,
  :description,
  :holdout_percent,
  :hook,
  :is_paused,
  :limits,
  :message_configuration,
  :name,
  :schedule,
  :segment_id,
  :segment_version,
  :tags,
  :template_configuration,
  :treatment_description,
  :treatment_name,
  :priority)
  SENSITIVE = []
  include Aws::Structure
end

#priority ⇒ Integer

Defines the priority of the campaign, used to decide the order of messages displayed to user if there are multiple messages scheduled to be displayed at the same moment.

Returns:

• (Integer)

# File 'lib/aws-sdk-pinpoint/types.rb', line 13799

class WriteCampaignRequest < Struct.new(
  :additional_treatments,
  :custom_delivery_configuration,
  :description,
  :holdout_percent,
  :hook,
  :is_paused,
  :limits,
  :message_configuration,
  :name,
  :schedule,
  :segment_id,
  :segment_version,
  :tags,
  :template_configuration,
  :treatment_description,
  :treatment_name,
  :priority)
  SENSITIVE = []
  include Aws::Structure
end

#schedule ⇒ Types::Schedule

The schedule settings for the campaign.

Returns:

• (Types::Schedule)

# File 'lib/aws-sdk-pinpoint/types.rb', line 13799

class WriteCampaignRequest < Struct.new(
  :additional_treatments,
  :custom_delivery_configuration,
  :description,
  :holdout_percent,
  :hook,
  :is_paused,
  :limits,
  :message_configuration,
  :name,
  :schedule,
  :segment_id,
  :segment_version,
  :tags,
  :template_configuration,
  :treatment_description,
  :treatment_name,
  :priority)
  SENSITIVE = []
  include Aws::Structure
end

#segment_id ⇒ String

The unique identifier for the segment to associate with the campaign.

Returns:

• (String)

# File 'lib/aws-sdk-pinpoint/types.rb', line 13799

class WriteCampaignRequest < Struct.new(
  :additional_treatments,
  :custom_delivery_configuration,
  :description,
  :holdout_percent,
  :hook,
  :is_paused,
  :limits,
  :message_configuration,
  :name,
  :schedule,
  :segment_id,
  :segment_version,
  :tags,
  :template_configuration,
  :treatment_description,
  :treatment_name,
  :priority)
  SENSITIVE = []
  include Aws::Structure
end

#segment_version ⇒ Integer

The version of the segment to associate with the campaign.

Returns:

• (Integer)

# File 'lib/aws-sdk-pinpoint/types.rb', line 13799

class WriteCampaignRequest < Struct.new(
  :additional_treatments,
  :custom_delivery_configuration,
  :description,
  :holdout_percent,
  :hook,
  :is_paused,
  :limits,
  :message_configuration,
  :name,
  :schedule,
  :segment_id,
  :segment_version,
  :tags,
  :template_configuration,
  :treatment_description,
  :treatment_name,
  :priority)
  SENSITIVE = []
  include Aws::Structure
end

#tags ⇒ Hash<String,String>

<note markdown=“1”>As of 22-05-2023 tags has been deprecated for update operations. After this date any value in tags is not processed and an error code is not returned. To manage tags we recommend using either [Tags] in the *API Reference for Amazon Pinpoint*,

resourcegroupstaggingapi][2

commands in the *AWS Command Line

Interface Documentation* or [resourcegroupstaggingapi] in the *AWS SDK*.

</note>

(Deprecated) A string-to-string map of key-value pairs that defines the tags to associate with the campaign. Each tag consists of a required tag key and an associated tag value.

[1]: docs.aws.amazon.com/pinpoint/latest/apireference/tags-resource-arn.html [2]: docs.aws.amazon.com/cli/latest/reference/resourcegroupstaggingapi/index.html [3]: sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/resourcegroupstaggingapi/package-summary.html

Returns:

• (Hash<String,String>)

# File 'lib/aws-sdk-pinpoint/types.rb', line 13799

class WriteCampaignRequest < Struct.new(
  :additional_treatments,
  :custom_delivery_configuration,
  :description,
  :holdout_percent,
  :hook,
  :is_paused,
  :limits,
  :message_configuration,
  :name,
  :schedule,
  :segment_id,
  :segment_version,
  :tags,
  :template_configuration,
  :treatment_description,
  :treatment_name,
  :priority)
  SENSITIVE = []
  include Aws::Structure
end

#template_configuration ⇒ Types::TemplateConfiguration

The message template to use for the campaign.

Returns:

• (Types::TemplateConfiguration)

# File 'lib/aws-sdk-pinpoint/types.rb', line 13799

class WriteCampaignRequest < Struct.new(
  :additional_treatments,
  :custom_delivery_configuration,
  :description,
  :holdout_percent,
  :hook,
  :is_paused,
  :limits,
  :message_configuration,
  :name,
  :schedule,
  :segment_id,
  :segment_version,
  :tags,
  :template_configuration,
  :treatment_description,
  :treatment_name,
  :priority)
  SENSITIVE = []
  include Aws::Structure
end

#treatment_description ⇒ String

A custom description of the default treatment for the campaign.

Returns:

• (String)

# File 'lib/aws-sdk-pinpoint/types.rb', line 13799

class WriteCampaignRequest < Struct.new(
  :additional_treatments,
  :custom_delivery_configuration,
  :description,
  :holdout_percent,
  :hook,
  :is_paused,
  :limits,
  :message_configuration,
  :name,
  :schedule,
  :segment_id,
  :segment_version,
  :tags,
  :template_configuration,
  :treatment_description,
  :treatment_name,
  :priority)
  SENSITIVE = []
  include Aws::Structure
end

#treatment_name ⇒ String

A custom name of the default treatment for the campaign, if the campaign has multiple treatments. A treatment is a variation of a campaign that’s used for A/B testing.

Returns:

• (String)

# File 'lib/aws-sdk-pinpoint/types.rb', line 13799

class WriteCampaignRequest < Struct.new(
  :additional_treatments,
  :custom_delivery_configuration,
  :description,
  :holdout_percent,
  :hook,
  :is_paused,
  :limits,
  :message_configuration,
  :name,
  :schedule,
  :segment_id,
  :segment_version,
  :tags,
  :template_configuration,
  :treatment_description,
  :treatment_name,
  :priority)
  SENSITIVE = []
  include Aws::Structure
end