CfnCampaignPropsMixin
- class aws_cdk.mixins_preview.aws_pinpoint.mixins.CfnCampaignPropsMixin(props, *, strategy=None)
Bases:
MixinSpecifies the settings for a campaign.
A campaign is a messaging initiative that engages a specific segment of users for an Amazon Pinpoint application.
- See:
http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-pinpoint-campaign.html
- CloudformationResource:
AWS::Pinpoint::Campaign
- Mixin:
true
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview import mixins from aws_cdk.mixins_preview.aws_pinpoint import mixins as pinpoint_mixins # attributes: Any # custom_config: Any # metrics: Any # tags: Any cfn_campaign_props_mixin = pinpoint_mixins.CfnCampaignPropsMixin(pinpoint_mixins.CfnCampaignMixinProps( additional_treatments=[pinpoint_mixins.CfnCampaignPropsMixin.WriteTreatmentResourceProperty( custom_delivery_configuration=pinpoint_mixins.CfnCampaignPropsMixin.CustomDeliveryConfigurationProperty( delivery_uri="deliveryUri", endpoint_types=["endpointTypes"] ), message_configuration=pinpoint_mixins.CfnCampaignPropsMixin.MessageConfigurationProperty( adm_message=pinpoint_mixins.CfnCampaignPropsMixin.MessageProperty( action="action", body="body", image_icon_url="imageIconUrl", image_small_icon_url="imageSmallIconUrl", image_url="imageUrl", json_body="jsonBody", media_url="mediaUrl", raw_content="rawContent", silent_push=False, time_to_live=123, title="title", url="url" ), apns_message=pinpoint_mixins.CfnCampaignPropsMixin.MessageProperty( action="action", body="body", image_icon_url="imageIconUrl", image_small_icon_url="imageSmallIconUrl", image_url="imageUrl", json_body="jsonBody", media_url="mediaUrl", raw_content="rawContent", silent_push=False, time_to_live=123, title="title", url="url" ), baidu_message=pinpoint_mixins.CfnCampaignPropsMixin.MessageProperty( action="action", body="body", image_icon_url="imageIconUrl", image_small_icon_url="imageSmallIconUrl", image_url="imageUrl", json_body="jsonBody", media_url="mediaUrl", raw_content="rawContent", silent_push=False, time_to_live=123, title="title", url="url" ), custom_message=pinpoint_mixins.CfnCampaignPropsMixin.CampaignCustomMessageProperty( data="data" ), default_message=pinpoint_mixins.CfnCampaignPropsMixin.MessageProperty( action="action", body="body", image_icon_url="imageIconUrl", image_small_icon_url="imageSmallIconUrl", image_url="imageUrl", json_body="jsonBody", media_url="mediaUrl", raw_content="rawContent", silent_push=False, time_to_live=123, title="title", url="url" ), email_message=pinpoint_mixins.CfnCampaignPropsMixin.CampaignEmailMessageProperty( body="body", from_address="fromAddress", html_body="htmlBody", title="title" ), gcm_message=pinpoint_mixins.CfnCampaignPropsMixin.MessageProperty( action="action", body="body", image_icon_url="imageIconUrl", image_small_icon_url="imageSmallIconUrl", image_url="imageUrl", json_body="jsonBody", media_url="mediaUrl", raw_content="rawContent", silent_push=False, time_to_live=123, title="title", url="url" ), in_app_message=pinpoint_mixins.CfnCampaignPropsMixin.CampaignInAppMessageProperty( content=[pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageContentProperty( background_color="backgroundColor", body_config=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageBodyConfigProperty( alignment="alignment", body="body", text_color="textColor" ), header_config=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageHeaderConfigProperty( alignment="alignment", header="header", text_color="textColor" ), image_url="imageUrl", primary_btn=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageButtonProperty( android=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), default_config=pinpoint_mixins.CfnCampaignPropsMixin.DefaultButtonConfigurationProperty( background_color="backgroundColor", border_radius=123, button_action="buttonAction", link="link", text="text", text_color="textColor" ), ios=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), web=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ) ), secondary_btn=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageButtonProperty( android=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), default_config=pinpoint_mixins.CfnCampaignPropsMixin.DefaultButtonConfigurationProperty( background_color="backgroundColor", border_radius=123, button_action="buttonAction", link="link", text="text", text_color="textColor" ), ios=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), web=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ) ) )], custom_config=custom_config, layout="layout" ), sms_message=pinpoint_mixins.CfnCampaignPropsMixin.CampaignSmsMessageProperty( body="body", entity_id="entityId", message_type="messageType", origination_number="originationNumber", sender_id="senderId", template_id="templateId" ) ), schedule=pinpoint_mixins.CfnCampaignPropsMixin.ScheduleProperty( end_time="endTime", event_filter=pinpoint_mixins.CfnCampaignPropsMixin.CampaignEventFilterProperty( dimensions=pinpoint_mixins.CfnCampaignPropsMixin.EventDimensionsProperty( attributes=attributes, event_type=pinpoint_mixins.CfnCampaignPropsMixin.SetDimensionProperty( dimension_type="dimensionType", values=["values"] ), metrics=metrics ), filter_type="filterType" ), frequency="frequency", is_local_time=False, quiet_time=pinpoint_mixins.CfnCampaignPropsMixin.QuietTimeProperty( end="end", start="start" ), start_time="startTime", time_zone="timeZone" ), size_percent=123, template_configuration=pinpoint_mixins.CfnCampaignPropsMixin.TemplateConfigurationProperty( email_template=pinpoint_mixins.CfnCampaignPropsMixin.TemplateProperty( name="name", version="version" ), push_template=pinpoint_mixins.CfnCampaignPropsMixin.TemplateProperty( name="name", version="version" ), sms_template=pinpoint_mixins.CfnCampaignPropsMixin.TemplateProperty( name="name", version="version" ), voice_template=pinpoint_mixins.CfnCampaignPropsMixin.TemplateProperty( name="name", version="version" ) ), treatment_description="treatmentDescription", treatment_name="treatmentName" )], application_id="applicationId", campaign_hook=pinpoint_mixins.CfnCampaignPropsMixin.CampaignHookProperty( lambda_function_name="lambdaFunctionName", mode="mode", web_url="webUrl" ), custom_delivery_configuration=pinpoint_mixins.CfnCampaignPropsMixin.CustomDeliveryConfigurationProperty( delivery_uri="deliveryUri", endpoint_types=["endpointTypes"] ), description="description", holdout_percent=123, is_paused=False, limits=pinpoint_mixins.CfnCampaignPropsMixin.LimitsProperty( daily=123, maximum_duration=123, messages_per_second=123, session=123, total=123 ), message_configuration=pinpoint_mixins.CfnCampaignPropsMixin.MessageConfigurationProperty( adm_message=pinpoint_mixins.CfnCampaignPropsMixin.MessageProperty( action="action", body="body", image_icon_url="imageIconUrl", image_small_icon_url="imageSmallIconUrl", image_url="imageUrl", json_body="jsonBody", media_url="mediaUrl", raw_content="rawContent", silent_push=False, time_to_live=123, title="title", url="url" ), apns_message=pinpoint_mixins.CfnCampaignPropsMixin.MessageProperty( action="action", body="body", image_icon_url="imageIconUrl", image_small_icon_url="imageSmallIconUrl", image_url="imageUrl", json_body="jsonBody", media_url="mediaUrl", raw_content="rawContent", silent_push=False, time_to_live=123, title="title", url="url" ), baidu_message=pinpoint_mixins.CfnCampaignPropsMixin.MessageProperty( action="action", body="body", image_icon_url="imageIconUrl", image_small_icon_url="imageSmallIconUrl", image_url="imageUrl", json_body="jsonBody", media_url="mediaUrl", raw_content="rawContent", silent_push=False, time_to_live=123, title="title", url="url" ), custom_message=pinpoint_mixins.CfnCampaignPropsMixin.CampaignCustomMessageProperty( data="data" ), default_message=pinpoint_mixins.CfnCampaignPropsMixin.MessageProperty( action="action", body="body", image_icon_url="imageIconUrl", image_small_icon_url="imageSmallIconUrl", image_url="imageUrl", json_body="jsonBody", media_url="mediaUrl", raw_content="rawContent", silent_push=False, time_to_live=123, title="title", url="url" ), email_message=pinpoint_mixins.CfnCampaignPropsMixin.CampaignEmailMessageProperty( body="body", from_address="fromAddress", html_body="htmlBody", title="title" ), gcm_message=pinpoint_mixins.CfnCampaignPropsMixin.MessageProperty( action="action", body="body", image_icon_url="imageIconUrl", image_small_icon_url="imageSmallIconUrl", image_url="imageUrl", json_body="jsonBody", media_url="mediaUrl", raw_content="rawContent", silent_push=False, time_to_live=123, title="title", url="url" ), in_app_message=pinpoint_mixins.CfnCampaignPropsMixin.CampaignInAppMessageProperty( content=[pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageContentProperty( background_color="backgroundColor", body_config=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageBodyConfigProperty( alignment="alignment", body="body", text_color="textColor" ), header_config=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageHeaderConfigProperty( alignment="alignment", header="header", text_color="textColor" ), image_url="imageUrl", primary_btn=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageButtonProperty( android=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), default_config=pinpoint_mixins.CfnCampaignPropsMixin.DefaultButtonConfigurationProperty( background_color="backgroundColor", border_radius=123, button_action="buttonAction", link="link", text="text", text_color="textColor" ), ios=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), web=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ) ), secondary_btn=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageButtonProperty( android=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), default_config=pinpoint_mixins.CfnCampaignPropsMixin.DefaultButtonConfigurationProperty( background_color="backgroundColor", border_radius=123, button_action="buttonAction", link="link", text="text", text_color="textColor" ), ios=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), web=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ) ) )], custom_config=custom_config, layout="layout" ), sms_message=pinpoint_mixins.CfnCampaignPropsMixin.CampaignSmsMessageProperty( body="body", entity_id="entityId", message_type="messageType", origination_number="originationNumber", sender_id="senderId", template_id="templateId" ) ), name="name", priority=123, schedule=pinpoint_mixins.CfnCampaignPropsMixin.ScheduleProperty( end_time="endTime", event_filter=pinpoint_mixins.CfnCampaignPropsMixin.CampaignEventFilterProperty( dimensions=pinpoint_mixins.CfnCampaignPropsMixin.EventDimensionsProperty( attributes=attributes, event_type=pinpoint_mixins.CfnCampaignPropsMixin.SetDimensionProperty( dimension_type="dimensionType", values=["values"] ), metrics=metrics ), filter_type="filterType" ), frequency="frequency", is_local_time=False, quiet_time=pinpoint_mixins.CfnCampaignPropsMixin.QuietTimeProperty( end="end", start="start" ), start_time="startTime", time_zone="timeZone" ), segment_id="segmentId", segment_version=123, tags=tags, template_configuration=pinpoint_mixins.CfnCampaignPropsMixin.TemplateConfigurationProperty( email_template=pinpoint_mixins.CfnCampaignPropsMixin.TemplateProperty( name="name", version="version" ), push_template=pinpoint_mixins.CfnCampaignPropsMixin.TemplateProperty( name="name", version="version" ), sms_template=pinpoint_mixins.CfnCampaignPropsMixin.TemplateProperty( name="name", version="version" ), voice_template=pinpoint_mixins.CfnCampaignPropsMixin.TemplateProperty( name="name", version="version" ) ), treatment_description="treatmentDescription", treatment_name="treatmentName" ), strategy=mixins.PropertyMergeStrategy.OVERRIDE )
Create a mixin to apply properties to
AWS::Pinpoint::Campaign.- Parameters:
props (
Union[CfnCampaignMixinProps,Dict[str,Any]]) – L1 properties to apply.strategy (
Optional[PropertyMergeStrategy]) – (experimental) Strategy for merging nested properties. Default: - PropertyMergeStrategy.MERGE
Methods
- apply_to(construct)
Apply the mixin properties to the construct.
- Parameters:
construct (
IConstruct)- Return type:
- supports(construct)
Check if this mixin supports the given construct.
- Parameters:
construct (
IConstruct)- Return type:
bool
Attributes
- CFN_PROPERTY_KEYS = ['additionalTreatments', 'applicationId', 'campaignHook', 'customDeliveryConfiguration', 'description', 'holdoutPercent', 'isPaused', 'limits', 'messageConfiguration', 'name', 'priority', 'schedule', 'segmentId', 'segmentVersion', 'tags', 'templateConfiguration', 'treatmentDescription', 'treatmentName']
Static Methods
- classmethod is_mixin(x)
(experimental) Checks if
xis a Mixin.- Parameters:
x (
Any) – Any object.- Return type:
bool- Returns:
true if
xis an object created from a class which extendsMixin.- Stability:
experimental
CampaignCustomMessageProperty
- class CfnCampaignPropsMixin.CampaignCustomMessageProperty(*, data=None)
Bases:
objectSpecifies the contents of a message that’s sent through a custom channel to recipients of a campaign.
- Parameters:
data (
Optional[str]) – The raw, JSON-formatted string to use as the payload for the message. The maximum size is 5 KB.- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_pinpoint import mixins as pinpoint_mixins campaign_custom_message_property = pinpoint_mixins.CfnCampaignPropsMixin.CampaignCustomMessageProperty( data="data" )
Attributes
- data
The raw, JSON-formatted string to use as the payload for the message.
The maximum size is 5 KB.
CampaignEmailMessageProperty
- class CfnCampaignPropsMixin.CampaignEmailMessageProperty(*, body=None, from_address=None, html_body=None, title=None)
Bases:
objectSpecifies the content and “From” address for an email message that’s sent to recipients of a campaign.
- Parameters:
body (
Optional[str]) – The body of the email for recipients whose email clients don’t render HTML content.from_address (
Optional[str]) – The verified email address to send the email from. The default address is theFromAddressspecified for the email channel for the application.html_body (
Optional[str]) – The body of the email, in HTML format, for recipients whose email clients render HTML content.title (
Optional[str]) – The subject line, or title, of the email.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_pinpoint import mixins as pinpoint_mixins campaign_email_message_property = pinpoint_mixins.CfnCampaignPropsMixin.CampaignEmailMessageProperty( body="body", from_address="fromAddress", html_body="htmlBody", title="title" )
Attributes
- body
The body of the email for recipients whose email clients don’t render HTML content.
- from_address
The verified email address to send the email from.
The default address is the
FromAddressspecified for the email channel for the application.
- html_body
The body of the email, in HTML format, for recipients whose email clients render HTML content.
- title
The subject line, or title, of the email.
CampaignEventFilterProperty
- class CfnCampaignPropsMixin.CampaignEventFilterProperty(*, dimensions=None, filter_type=None)
Bases:
objectSpecifies the settings for events that cause a campaign to be sent.
- Parameters:
dimensions (
Union[IResolvable,EventDimensionsProperty,Dict[str,Any],None]) – The dimension settings of the event filter for the campaign.filter_type (
Optional[str]) – The type of event that causes the campaign to be sent. Valid values are:SYSTEM, sends the campaign when a system event occurs; and,ENDPOINT, sends the campaign when an endpoint event (Events resource) occurs.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_pinpoint import mixins as pinpoint_mixins # attributes: Any # metrics: Any campaign_event_filter_property = pinpoint_mixins.CfnCampaignPropsMixin.CampaignEventFilterProperty( dimensions=pinpoint_mixins.CfnCampaignPropsMixin.EventDimensionsProperty( attributes=attributes, event_type=pinpoint_mixins.CfnCampaignPropsMixin.SetDimensionProperty( dimension_type="dimensionType", values=["values"] ), metrics=metrics ), filter_type="filterType" )
Attributes
- dimensions
The dimension settings of the event filter for the campaign.
- filter_type
The type of event that causes the campaign to be sent.
Valid values are:
SYSTEM, sends the campaign when a system event occurs; and,ENDPOINT, sends the campaign when an endpoint event (Events resource) occurs.
CampaignHookProperty
- class CfnCampaignPropsMixin.CampaignHookProperty(*, lambda_function_name=None, mode=None, web_url=None)
Bases:
objectSpecifies settings for invoking an Lambda function that customizes a segment for a campaign.
- Parameters:
lambda_function_name (
Optional[str]) – The name or Amazon Resource Name (ARN) of the Lambda function that Amazon Pinpoint invokes to customize a segment for a campaign.mode (
Optional[str]) – The mode that Amazon Pinpoint uses to invoke the Lambda function. Possible values are:. -FILTER- Invoke the function to customize the segment that’s used by a campaign. -DELIVERY- (Deprecated) Previously, invoked the function to send a campaign through a custom channel. This functionality is not supported anymore. To send a campaign through a custom channel, use theCustomDeliveryConfigurationandCampaignCustomMessageobjects of the campaign.web_url (
Optional[str]) – The web URL that Amazon Pinpoint calls to invoke the Lambda function over HTTPS.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_pinpoint import mixins as pinpoint_mixins campaign_hook_property = pinpoint_mixins.CfnCampaignPropsMixin.CampaignHookProperty( lambda_function_name="lambdaFunctionName", mode="mode", web_url="webUrl" )
Attributes
- lambda_function_name
The name or Amazon Resource Name (ARN) of the Lambda function that Amazon Pinpoint invokes to customize a segment for a campaign.
- mode
.
FILTER- Invoke the function to customize the segment that’s used by a campaign.DELIVERY- (Deprecated) Previously, invoked the function to send a campaign through a custom channel. This functionality is not supported anymore. To send a campaign through a custom channel, use theCustomDeliveryConfigurationandCampaignCustomMessageobjects of the campaign.
- See:
- Type:
The mode that Amazon Pinpoint uses to invoke the Lambda function. Possible values are
- web_url
The web URL that Amazon Pinpoint calls to invoke the Lambda function over HTTPS.
CampaignInAppMessageProperty
- class CfnCampaignPropsMixin.CampaignInAppMessageProperty(*, content=None, custom_config=None, layout=None)
Bases:
objectSpecifies the appearance of an in-app message, including the message type, the title and body text, text and background colors, and the configurations of buttons that appear in the message.
- Parameters:
content (
Union[IResolvable,Sequence[Union[IResolvable,InAppMessageContentProperty,Dict[str,Any]]],None]) – An array that contains configurtion information about the in-app message for the campaign, including title and body text, text colors, background colors, image URLs, and button configurations.custom_config (
Any) – Custom data, in the form of key-value pairs, that is included in an in-app messaging payload.layout (
Optional[str]) – A string that describes how the in-app message will appear. You can specify one of the following:. -BOTTOM_BANNER– a message that appears as a banner at the bottom of the page. -TOP_BANNER– a message that appears as a banner at the top of the page. -OVERLAYS– a message that covers entire screen. -MOBILE_FEED– a message that appears in a window in front of the page. -MIDDLE_BANNER– a message that appears as a banner in the middle of the page. -CAROUSEL– a scrollable layout of up to five unique messages.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_pinpoint import mixins as pinpoint_mixins # custom_config: Any campaign_in_app_message_property = pinpoint_mixins.CfnCampaignPropsMixin.CampaignInAppMessageProperty( content=[pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageContentProperty( background_color="backgroundColor", body_config=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageBodyConfigProperty( alignment="alignment", body="body", text_color="textColor" ), header_config=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageHeaderConfigProperty( alignment="alignment", header="header", text_color="textColor" ), image_url="imageUrl", primary_btn=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageButtonProperty( android=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), default_config=pinpoint_mixins.CfnCampaignPropsMixin.DefaultButtonConfigurationProperty( background_color="backgroundColor", border_radius=123, button_action="buttonAction", link="link", text="text", text_color="textColor" ), ios=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), web=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ) ), secondary_btn=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageButtonProperty( android=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), default_config=pinpoint_mixins.CfnCampaignPropsMixin.DefaultButtonConfigurationProperty( background_color="backgroundColor", border_radius=123, button_action="buttonAction", link="link", text="text", text_color="textColor" ), ios=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), web=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ) ) )], custom_config=custom_config, layout="layout" )
Attributes
- content
An array that contains configurtion information about the in-app message for the campaign, including title and body text, text colors, background colors, image URLs, and button configurations.
- custom_config
Custom data, in the form of key-value pairs, that is included in an in-app messaging payload.
- layout
.
BOTTOM_BANNER– a message that appears as a banner at the bottom of the page.TOP_BANNER– a message that appears as a banner at the top of the page.OVERLAYS– a message that covers entire screen.MOBILE_FEED– a message that appears in a window in front of the page.MIDDLE_BANNER– a message that appears as a banner in the middle of the page.CAROUSEL– a scrollable layout of up to five unique messages.
- See:
- Type:
A string that describes how the in-app message will appear. You can specify one of the following
CampaignSmsMessageProperty
- class CfnCampaignPropsMixin.CampaignSmsMessageProperty(*, body=None, entity_id=None, message_type=None, origination_number=None, sender_id=None, template_id=None)
Bases:
objectSpecifies the content and settings for an SMS message that’s sent to recipients of a campaign.
- Parameters:
body (
Optional[str]) – The body of the SMS message.entity_id (
Optional[str]) – The entity ID or Principal Entity (PE) id received from the regulatory body for sending SMS in your country.message_type (
Optional[str]) – The SMS message type. Valid values areTRANSACTIONAL(for messages that are critical or time-sensitive, such as a one-time passwords) andPROMOTIONAL(for messsages that aren’t critical or time-sensitive, such as marketing messages).origination_number (
Optional[str]) – The long code to send the SMS message from. This value should be one of the dedicated long codes that’s assigned to your AWS account. Although it isn’t required, we recommend that you specify the long code using an E.164 format to ensure prompt and accurate delivery of the message. For example, +12065550100.sender_id (
Optional[str]) – The alphabetic Sender ID to display as the sender of the message on a recipient’s device. Support for sender IDs varies by country or region. To specify a phone number as the sender, omit this parameter and useOriginationNumberinstead. For more information about support for Sender ID by country, see the Amazon Pinpoint User Guide .template_id (
Optional[str]) – The template ID received from the regulatory body for sending SMS in your country.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_pinpoint import mixins as pinpoint_mixins campaign_sms_message_property = pinpoint_mixins.CfnCampaignPropsMixin.CampaignSmsMessageProperty( body="body", entity_id="entityId", message_type="messageType", origination_number="originationNumber", sender_id="senderId", template_id="templateId" )
Attributes
- body
The body of the SMS message.
- entity_id
The entity ID or Principal Entity (PE) id received from the regulatory body for sending SMS in your country.
- message_type
The SMS message type.
Valid values are
TRANSACTIONAL(for messages that are critical or time-sensitive, such as a one-time passwords) andPROMOTIONAL(for messsages that aren’t critical or time-sensitive, such as marketing messages).
- origination_number
The long code to send the SMS message from.
This value should be one of the dedicated long codes that’s assigned to your AWS account. Although it isn’t required, we recommend that you specify the long code using an E.164 format to ensure prompt and accurate delivery of the message. For example, +12065550100.
- sender_id
The alphabetic Sender ID to display as the sender of the message on a recipient’s device.
Support for sender IDs varies by country or region. To specify a phone number as the sender, omit this parameter and use
OriginationNumberinstead. For more information about support for Sender ID by country, see the Amazon Pinpoint User Guide .
- template_id
The template ID received from the regulatory body for sending SMS in your country.
CustomDeliveryConfigurationProperty
- class CfnCampaignPropsMixin.CustomDeliveryConfigurationProperty(*, delivery_uri=None, endpoint_types=None)
Bases:
objectSpecifies the delivery configuration settings for sending a campaign or campaign treatment through a custom channel.
This object is required if you use the
CampaignCustomMessageobject to define the message to send for the campaign or campaign treatment.- Parameters:
delivery_uri (
Optional[str]) – The destination to send the campaign or treatment to. This value can be one of the following:. - The name or Amazon Resource Name (ARN) of an AWS Lambda function to invoke to handle delivery of the campaign or treatment. - The URL for a web application or service that supports HTTPS and can receive the message. The URL has to be a full URL, including the HTTPS protocol.endpoint_types (
Optional[Sequence[str]]) – The types of endpoints to send the campaign or treatment to. Each valid value maps to a type of channel that you can associate with an endpoint by using theChannelTypeproperty of an endpoint.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_pinpoint import mixins as pinpoint_mixins custom_delivery_configuration_property = pinpoint_mixins.CfnCampaignPropsMixin.CustomDeliveryConfigurationProperty( delivery_uri="deliveryUri", endpoint_types=["endpointTypes"] )
Attributes
- delivery_uri
.
The name or Amazon Resource Name (ARN) of an AWS Lambda function to invoke to handle delivery of the campaign or treatment.
The URL for a web application or service that supports HTTPS and can receive the message. The URL has to be a full URL, including the HTTPS protocol.
- See:
- Type:
The destination to send the campaign or treatment to. This value can be one of the following
- endpoint_types
The types of endpoints to send the campaign or treatment to.
Each valid value maps to a type of channel that you can associate with an endpoint by using the
ChannelTypeproperty of an endpoint.
EventDimensionsProperty
- class CfnCampaignPropsMixin.EventDimensionsProperty(*, attributes=None, event_type=None, metrics=None)
Bases:
objectSpecifies the dimensions for an event filter that determines when a campaign is sent or a journey activity is performed.
- Parameters:
attributes (
Any) – One or more custom attributes that your application reports to Amazon Pinpoint. You can use these attributes as selection criteria when you create an event filter.event_type (
Union[IResolvable,SetDimensionProperty,Dict[str,Any],None]) – The name of the event that causes the campaign to be sent or the journey activity to be performed. This can be a standard event that Amazon Pinpoint generates, such as_email.deliveredor_custom.delivered. For campaigns, this can also be a custom event that’s specific to your application. For information about standard events, see Streaming Amazon Pinpoint Events in the Amazon Pinpoint Developer Guide .metrics (
Any) – One or more custom metrics that your application reports to Amazon Pinpoint . You can use these metrics as selection criteria when you create an event filter.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_pinpoint import mixins as pinpoint_mixins # attributes: Any # metrics: Any event_dimensions_property = pinpoint_mixins.CfnCampaignPropsMixin.EventDimensionsProperty( attributes=attributes, event_type=pinpoint_mixins.CfnCampaignPropsMixin.SetDimensionProperty( dimension_type="dimensionType", values=["values"] ), metrics=metrics )
Attributes
- attributes
One or more custom attributes that your application reports to Amazon Pinpoint.
You can use these attributes as selection criteria when you create an event filter.
- event_type
The name of the event that causes the campaign to be sent or the journey activity to be performed.
This can be a standard event that Amazon Pinpoint generates, such as
_email.deliveredor_custom.delivered. For campaigns, this can also be a custom event that’s specific to your application. For information about standard events, see Streaming Amazon Pinpoint Events in the Amazon Pinpoint Developer Guide .
- metrics
One or more custom metrics that your application reports to Amazon Pinpoint .
You can use these metrics as selection criteria when you create an event filter.
InAppMessageBodyConfigProperty
- class CfnCampaignPropsMixin.InAppMessageBodyConfigProperty(*, alignment=None, body=None, text_color=None)
Bases:
objectSpecifies the configuration of main body text of the in-app message.
- Parameters:
alignment (
Optional[str]) – The text alignment of the main body text of the message. Acceptable values:LEFT,CENTER,RIGHT.body (
Optional[str]) – The main body text of the message.text_color (
Optional[str]) – The color of the body text, expressed as a string consisting of a hex color code (such as “#000000” for black).
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_pinpoint import mixins as pinpoint_mixins in_app_message_body_config_property = pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageBodyConfigProperty( alignment="alignment", body="body", text_color="textColor" )
Attributes
- alignment
The text alignment of the main body text of the message.
Acceptable values:
LEFT,CENTER,RIGHT.
- body
The main body text of the message.
- text_color
The color of the body text, expressed as a string consisting of a hex color code (such as “#000000” for black).
InAppMessageContentProperty
- class CfnCampaignPropsMixin.InAppMessageContentProperty(*, background_color=None, body_config=None, header_config=None, image_url=None, primary_btn=None, secondary_btn=None)
Bases:
objectSpecifies the configuration and contents of an in-app message.
- Parameters:
background_color (
Optional[str]) – The background color for an in-app message banner, expressed as a hex color code (such as #000000 for black).body_config (
Union[IResolvable,InAppMessageBodyConfigProperty,Dict[str,Any],None]) – Specifies the configuration of main body text in an in-app message template.header_config (
Union[IResolvable,InAppMessageHeaderConfigProperty,Dict[str,Any],None]) – Specifies the configuration and content of the header or title text of the in-app message.image_url (
Optional[str]) – The URL of the image that appears on an in-app message banner.primary_btn (
Union[IResolvable,InAppMessageButtonProperty,Dict[str,Any],None]) – An object that contains configuration information about the primary button in an in-app message.secondary_btn (
Union[IResolvable,InAppMessageButtonProperty,Dict[str,Any],None]) – An object that contains configuration information about the secondary button in an in-app message.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_pinpoint import mixins as pinpoint_mixins in_app_message_content_property = pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageContentProperty( background_color="backgroundColor", body_config=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageBodyConfigProperty( alignment="alignment", body="body", text_color="textColor" ), header_config=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageHeaderConfigProperty( alignment="alignment", header="header", text_color="textColor" ), image_url="imageUrl", primary_btn=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageButtonProperty( android=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), default_config=pinpoint_mixins.CfnCampaignPropsMixin.DefaultButtonConfigurationProperty( background_color="backgroundColor", border_radius=123, button_action="buttonAction", link="link", text="text", text_color="textColor" ), ios=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), web=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ) ), secondary_btn=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageButtonProperty( android=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), default_config=pinpoint_mixins.CfnCampaignPropsMixin.DefaultButtonConfigurationProperty( background_color="backgroundColor", border_radius=123, button_action="buttonAction", link="link", text="text", text_color="textColor" ), ios=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), web=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ) ) )
Attributes
- background_color
The background color for an in-app message banner, expressed as a hex color code (such as #000000 for black).
- body_config
Specifies the configuration of main body text in an in-app message template.
- header_config
Specifies the configuration and content of the header or title text of the in-app message.
- image_url
The URL of the image that appears on an in-app message banner.
- primary_btn
An object that contains configuration information about the primary button in an in-app message.
- secondary_btn
An object that contains configuration information about the secondary button in an in-app message.
InAppMessageHeaderConfigProperty
- class CfnCampaignPropsMixin.InAppMessageHeaderConfigProperty(*, alignment=None, header=None, text_color=None)
Bases:
objectSpecifies the configuration and content of the header or title text of the in-app message.
- Parameters:
alignment (
Optional[str]) – The text alignment of the title of the message. Acceptable values:LEFT,CENTER,RIGHT.header (
Optional[str]) – The header or title text of the in-app message.text_color (
Optional[str]) – The color of the body text, expressed as a string consisting of a hex color code (such as “#000000” for black).
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_pinpoint import mixins as pinpoint_mixins in_app_message_header_config_property = pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageHeaderConfigProperty( alignment="alignment", header="header", text_color="textColor" )
Attributes
- alignment
The text alignment of the title of the message.
Acceptable values:
LEFT,CENTER,RIGHT.
- header
The header or title text of the in-app message.
- text_color
The color of the body text, expressed as a string consisting of a hex color code (such as “#000000” for black).
LimitsProperty
- class CfnCampaignPropsMixin.LimitsProperty(*, daily=None, maximum_duration=None, messages_per_second=None, session=None, total=None)
Bases:
objectSpecifies the limits on the messages that a campaign can send.
- Parameters:
daily (
Union[int,float,None]) – The maximum number of messages that a campaign can send to a single endpoint during a 24-hour period. The maximum value is 100.maximum_duration (
Union[int,float,None]) – The maximum amount of time, in seconds, that a campaign can attempt to deliver a message after the scheduled start time for the campaign. The minimum value is 60 seconds.messages_per_second (
Union[int,float,None]) – The maximum number of messages that a campaign can send each second. The minimum value is 1. The maximum value is 20,000.session (
Union[int,float,None]) – The maximum number of messages that the campaign can send per user session.total (
Union[int,float,None]) – The maximum number of messages that a campaign can send to a single endpoint during the course of the campaign. The maximum value is 100.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_pinpoint import mixins as pinpoint_mixins limits_property = pinpoint_mixins.CfnCampaignPropsMixin.LimitsProperty( daily=123, maximum_duration=123, messages_per_second=123, session=123, total=123 )
Attributes
- daily
The maximum number of messages that a campaign can send to a single endpoint during a 24-hour period.
The maximum value is 100.
- maximum_duration
The maximum amount of time, in seconds, that a campaign can attempt to deliver a message after the scheduled start time for the campaign.
The minimum value is 60 seconds.
- messages_per_second
The maximum number of messages that a campaign can send each second.
The minimum value is 1. The maximum value is 20,000.
- session
The maximum number of messages that the campaign can send per user session.
- total
The maximum number of messages that a campaign can send to a single endpoint during the course of the campaign.
The maximum value is 100.
MessageConfigurationProperty
- class CfnCampaignPropsMixin.MessageConfigurationProperty(*, adm_message=None, apns_message=None, baidu_message=None, custom_message=None, default_message=None, email_message=None, gcm_message=None, in_app_message=None, sms_message=None)
Bases:
objectSpecifies the message configuration settings for a campaign.
- Parameters:
adm_message (
Union[IResolvable,MessageProperty,Dict[str,Any],None]) – The message that the campaign sends through the ADM (Amazon Device Messaging) channel. If specified, this message overrides the default message.apns_message (
Union[IResolvable,MessageProperty,Dict[str,Any],None]) – The message that the campaign sends through the APNs (Apple Push Notification service) channel. If specified, this message overrides the default message.baidu_message (
Union[IResolvable,MessageProperty,Dict[str,Any],None]) – The message that the campaign sends through the Baidu (Baidu Cloud Push) channel. If specified, this message overrides the default message.custom_message (
Union[IResolvable,CampaignCustomMessageProperty,Dict[str,Any],None]) – The message that the campaign sends through a custom channel, as specified by the delivery configuration (CustomDeliveryConfiguration) settings for the campaign. If specified, this message overrides the default message.default_message (
Union[IResolvable,MessageProperty,Dict[str,Any],None]) – The default message that the campaign sends through all the channels that are configured for the campaign.email_message (
Union[IResolvable,CampaignEmailMessageProperty,Dict[str,Any],None]) – The message that the campaign sends through the email channel. If specified, this message overrides the default message. .. epigraph:: The maximum email message size is 200 KB. You can use email templates to send larger email messages.gcm_message (
Union[IResolvable,MessageProperty,Dict[str,Any],None]) – The message that the campaign sends through the GCM channel, which enables Amazon Pinpoint to send push notifications through the Firebase Cloud Messaging (FCM), formerly Google Cloud Messaging (GCM), service. If specified, this message overrides the default message.in_app_message (
Union[IResolvable,CampaignInAppMessageProperty,Dict[str,Any],None]) – The default message for the in-app messaging channel. This message overrides the default message (DefaultMessage).sms_message (
Union[IResolvable,CampaignSmsMessageProperty,Dict[str,Any],None]) – The message that the campaign sends through the SMS channel. If specified, this message overrides the default message.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_pinpoint import mixins as pinpoint_mixins # custom_config: Any message_configuration_property = pinpoint_mixins.CfnCampaignPropsMixin.MessageConfigurationProperty( adm_message=pinpoint_mixins.CfnCampaignPropsMixin.MessageProperty( action="action", body="body", image_icon_url="imageIconUrl", image_small_icon_url="imageSmallIconUrl", image_url="imageUrl", json_body="jsonBody", media_url="mediaUrl", raw_content="rawContent", silent_push=False, time_to_live=123, title="title", url="url" ), apns_message=pinpoint_mixins.CfnCampaignPropsMixin.MessageProperty( action="action", body="body", image_icon_url="imageIconUrl", image_small_icon_url="imageSmallIconUrl", image_url="imageUrl", json_body="jsonBody", media_url="mediaUrl", raw_content="rawContent", silent_push=False, time_to_live=123, title="title", url="url" ), baidu_message=pinpoint_mixins.CfnCampaignPropsMixin.MessageProperty( action="action", body="body", image_icon_url="imageIconUrl", image_small_icon_url="imageSmallIconUrl", image_url="imageUrl", json_body="jsonBody", media_url="mediaUrl", raw_content="rawContent", silent_push=False, time_to_live=123, title="title", url="url" ), custom_message=pinpoint_mixins.CfnCampaignPropsMixin.CampaignCustomMessageProperty( data="data" ), default_message=pinpoint_mixins.CfnCampaignPropsMixin.MessageProperty( action="action", body="body", image_icon_url="imageIconUrl", image_small_icon_url="imageSmallIconUrl", image_url="imageUrl", json_body="jsonBody", media_url="mediaUrl", raw_content="rawContent", silent_push=False, time_to_live=123, title="title", url="url" ), email_message=pinpoint_mixins.CfnCampaignPropsMixin.CampaignEmailMessageProperty( body="body", from_address="fromAddress", html_body="htmlBody", title="title" ), gcm_message=pinpoint_mixins.CfnCampaignPropsMixin.MessageProperty( action="action", body="body", image_icon_url="imageIconUrl", image_small_icon_url="imageSmallIconUrl", image_url="imageUrl", json_body="jsonBody", media_url="mediaUrl", raw_content="rawContent", silent_push=False, time_to_live=123, title="title", url="url" ), in_app_message=pinpoint_mixins.CfnCampaignPropsMixin.CampaignInAppMessageProperty( content=[pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageContentProperty( background_color="backgroundColor", body_config=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageBodyConfigProperty( alignment="alignment", body="body", text_color="textColor" ), header_config=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageHeaderConfigProperty( alignment="alignment", header="header", text_color="textColor" ), image_url="imageUrl", primary_btn=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageButtonProperty( android=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), default_config=pinpoint_mixins.CfnCampaignPropsMixin.DefaultButtonConfigurationProperty( background_color="backgroundColor", border_radius=123, button_action="buttonAction", link="link", text="text", text_color="textColor" ), ios=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), web=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ) ), secondary_btn=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageButtonProperty( android=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), default_config=pinpoint_mixins.CfnCampaignPropsMixin.DefaultButtonConfigurationProperty( background_color="backgroundColor", border_radius=123, button_action="buttonAction", link="link", text="text", text_color="textColor" ), ios=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), web=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ) ) )], custom_config=custom_config, layout="layout" ), sms_message=pinpoint_mixins.CfnCampaignPropsMixin.CampaignSmsMessageProperty( body="body", entity_id="entityId", message_type="messageType", origination_number="originationNumber", sender_id="senderId", template_id="templateId" ) )
Attributes
- adm_message
The message that the campaign sends through the ADM (Amazon Device Messaging) channel.
If specified, this message overrides the default message.
- apns_message
The message that the campaign sends through the APNs (Apple Push Notification service) channel.
If specified, this message overrides the default message.
- baidu_message
The message that the campaign sends through the Baidu (Baidu Cloud Push) channel.
If specified, this message overrides the default message.
- custom_message
The message that the campaign sends through a custom channel, as specified by the delivery configuration (
CustomDeliveryConfiguration) settings for the campaign.If specified, this message overrides the default message.
- default_message
The default message that the campaign sends through all the channels that are configured for the campaign.
- email_message
The message that the campaign sends through the email channel. If specified, this message overrides the default message.
The maximum email message size is 200 KB. You can use email templates to send larger email messages.
- gcm_message
The message that the campaign sends through the GCM channel, which enables Amazon Pinpoint to send push notifications through the Firebase Cloud Messaging (FCM), formerly Google Cloud Messaging (GCM), service.
If specified, this message overrides the default message.
- in_app_message
The default message for the in-app messaging channel.
This message overrides the default message (
DefaultMessage).
- sms_message
The message that the campaign sends through the SMS channel.
If specified, this message overrides the default message.
MessageProperty
- class CfnCampaignPropsMixin.MessageProperty(*, action=None, body=None, image_icon_url=None, image_small_icon_url=None, image_url=None, json_body=None, media_url=None, raw_content=None, silent_push=None, time_to_live=None, title=None, url=None)
Bases:
objectSpecifies the content and settings for a push notification that’s sent to recipients of a campaign.
- Parameters:
action (
Optional[str]) – The action to occur if a recipient taps the push notification. Valid values are:. -OPEN_APP– Your app opens or it becomes the foreground app if it was sent to the background. This is the default action. -DEEP_LINK– Your app opens and displays a designated user interface in the app. This setting uses the deep-linking features of iOS and Android. -URL– The default mobile browser on the recipient’s device opens and loads the web page at a URL that you specify.body (
Optional[str]) – The body of the notification message. The maximum number of characters is 200.image_icon_url (
Optional[str]) – The URL of the image to display as the push notification icon, such as the icon for the app.image_small_icon_url (
Optional[str]) – The URL of the image to display as the small, push notification icon, such as a small version of the icon for the app.image_url (
Optional[str]) – The URL of an image to display in the push notification.json_body (
Optional[str]) – The JSON payload to use for a silent push notification.media_url (
Optional[str]) – The URL of the image or video to display in the push notification.raw_content (
Optional[str]) – The raw, JSON-formatted string to use as the payload for the notification message. If specified, this value overrides all other content for the message.silent_push (
Union[bool,IResolvable,None]) – Specifies whether the notification is a silent push notification, which is a push notification that doesn’t display on a recipient’s device. Silent push notifications can be used for cases such as updating an app’s configuration, displaying messages in an in-app message center, or supporting phone home functionality.time_to_live (
Union[int,float,None]) – The number of seconds that the push notification service should keep the message, if the service is unable to deliver the notification the first time. This value is converted to an expiration value when it’s sent to a push notification service. If this value is0, the service treats the notification as if it expires immediately and the service doesn’t store or try to deliver the notification again. This value doesn’t apply to messages that are sent through the Amazon Device Messaging (ADM) service.title (
Optional[str]) – The title to display above the notification message on a recipient’s device.url (
Optional[str]) – The URL to open in a recipient’s default mobile browser, if a recipient taps the push notification and the value of theActionproperty isURL.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_pinpoint import mixins as pinpoint_mixins message_property = pinpoint_mixins.CfnCampaignPropsMixin.MessageProperty( action="action", body="body", image_icon_url="imageIconUrl", image_small_icon_url="imageSmallIconUrl", image_url="imageUrl", json_body="jsonBody", media_url="mediaUrl", raw_content="rawContent", silent_push=False, time_to_live=123, title="title", url="url" )
Attributes
- action
.
OPEN_APP– Your app opens or it becomes the foreground app if it was sent to the background. This is the default action.DEEP_LINK– Your app opens and displays a designated user interface in the app. This setting uses the deep-linking features of iOS and Android.URL– The default mobile browser on the recipient’s device opens and loads the web page at a URL that you specify.
- See:
- Type:
The action to occur if a recipient taps the push notification. Valid values are
- body
The body of the notification message.
The maximum number of characters is 200.
- image_icon_url
The URL of the image to display as the push notification icon, such as the icon for the app.
- image_small_icon_url
The URL of the image to display as the small, push notification icon, such as a small version of the icon for the app.
- image_url
The URL of an image to display in the push notification.
- json_body
The JSON payload to use for a silent push notification.
- media_url
The URL of the image or video to display in the push notification.
- raw_content
The raw, JSON-formatted string to use as the payload for the notification message.
If specified, this value overrides all other content for the message.
- silent_push
Specifies whether the notification is a silent push notification, which is a push notification that doesn’t display on a recipient’s device.
Silent push notifications can be used for cases such as updating an app’s configuration, displaying messages in an in-app message center, or supporting phone home functionality.
- time_to_live
The number of seconds that the push notification service should keep the message, if the service is unable to deliver the notification the first time.
This value is converted to an expiration value when it’s sent to a push notification service. If this value is
0, the service treats the notification as if it expires immediately and the service doesn’t store or try to deliver the notification again.This value doesn’t apply to messages that are sent through the Amazon Device Messaging (ADM) service.
- title
The title to display above the notification message on a recipient’s device.
- url
The URL to open in a recipient’s default mobile browser, if a recipient taps the push notification and the value of the
Actionproperty isURL.
QuietTimeProperty
- class CfnCampaignPropsMixin.QuietTimeProperty(*, end=None, start=None)
Bases:
objectSpecifies the start and end times that define a time range when messages aren’t sent to endpoints.
- Parameters:
end (
Optional[str]) – The specific time when quiet time ends. This value has to use 24-hour notation and be in HH:MM format, where HH is the hour (with a leading zero, if applicable) and MM is the minutes. For example, use02:30to represent 2:30 AM, or14:30to represent 2:30 PM.start (
Optional[str]) – The specific time when quiet time begins. This value has to use 24-hour notation and be in HH:MM format, where HH is the hour (with a leading zero, if applicable) and MM is the minutes. For example, use02:30to represent 2:30 AM, or14:30to represent 2:30 PM.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_pinpoint import mixins as pinpoint_mixins quiet_time_property = pinpoint_mixins.CfnCampaignPropsMixin.QuietTimeProperty( end="end", start="start" )
Attributes
- end
The specific time when quiet time ends.
This value has to use 24-hour notation and be in HH:MM format, where HH is the hour (with a leading zero, if applicable) and MM is the minutes. For example, use
02:30to represent 2:30 AM, or14:30to represent 2:30 PM.
- start
The specific time when quiet time begins.
This value has to use 24-hour notation and be in HH:MM format, where HH is the hour (with a leading zero, if applicable) and MM is the minutes. For example, use
02:30to represent 2:30 AM, or14:30to represent 2:30 PM.
ScheduleProperty
- class CfnCampaignPropsMixin.ScheduleProperty(*, end_time=None, event_filter=None, frequency=None, is_local_time=None, quiet_time=None, start_time=None, time_zone=None)
Bases:
objectSpecifies the schedule settings for a campaign.
- Parameters:
end_time (
Optional[str]) – The scheduled time, in ISO 8601 format, when the campaign ended or will end.event_filter (
Union[IResolvable,CampaignEventFilterProperty,Dict[str,Any],None]) – The type of event that causes the campaign to be sent, if the value of theFrequencyproperty isEVENT.frequency (
Optional[str]) – Specifies how often the campaign is sent or whether the campaign is sent in response to a specific event.is_local_time (
Union[bool,IResolvable,None]) – Specifies whether the start and end times for the campaign schedule use each recipient’s local time. To base the schedule on each recipient’s local time, set this value totrue.quiet_time (
Union[IResolvable,QuietTimeProperty,Dict[str,Any],None]) – The default quiet time for the campaign. Quiet time is a specific time range when a campaign doesn’t send messages to endpoints, if all the following conditions are met: - TheEndpointDemographic.Timezoneproperty of the endpoint is set to a valid value. - The current time in the endpoint’s time zone is later than or equal to the time specified by theQuietTime.Startproperty for the campaign. - The current time in the endpoint’s time zone is earlier than or equal to the time specified by theQuietTime.Endproperty for the campaign. If any of the preceding conditions isn’t met, the endpoint will receive messages from the campaign, even if quiet time is enabled.start_time (
Optional[str]) – The scheduled time when the campaign began or will begin. Valid values are:IMMEDIATE, to start the campaign immediately; or, a specific time in ISO 8601 format.time_zone (
Optional[str]) – The starting UTC offset for the campaign schedule, if the value of theIsLocalTimeproperty istrue. Valid values are:UTC, UTC+01, UTC+02, UTC+03, UTC+03:30, UTC+04, UTC+04:30, UTC+05, UTC+05:30, UTC+05:45, UTC+06, UTC+06:30, UTC+07, UTC+08, UTC+09, UTC+09:30, UTC+10, UTC+10:30, UTC+11, UTC+12, UTC+13, UTC-02, UTC-03, UTC-04, UTC-05, UTC-06, UTC-07, UTC-08, UTC-09, UTC-10,andUTC-11.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_pinpoint import mixins as pinpoint_mixins # attributes: Any # metrics: Any schedule_property = pinpoint_mixins.CfnCampaignPropsMixin.ScheduleProperty( end_time="endTime", event_filter=pinpoint_mixins.CfnCampaignPropsMixin.CampaignEventFilterProperty( dimensions=pinpoint_mixins.CfnCampaignPropsMixin.EventDimensionsProperty( attributes=attributes, event_type=pinpoint_mixins.CfnCampaignPropsMixin.SetDimensionProperty( dimension_type="dimensionType", values=["values"] ), metrics=metrics ), filter_type="filterType" ), frequency="frequency", is_local_time=False, quiet_time=pinpoint_mixins.CfnCampaignPropsMixin.QuietTimeProperty( end="end", start="start" ), start_time="startTime", time_zone="timeZone" )
Attributes
- end_time
The scheduled time, in ISO 8601 format, when the campaign ended or will end.
- event_filter
The type of event that causes the campaign to be sent, if the value of the
Frequencyproperty isEVENT.
- frequency
Specifies how often the campaign is sent or whether the campaign is sent in response to a specific event.
- is_local_time
Specifies whether the start and end times for the campaign schedule use each recipient’s local time.
To base the schedule on each recipient’s local time, set this value to
true.
- quiet_time
The default quiet time for the campaign.
Quiet time is a specific time range when a campaign doesn’t send messages to endpoints, if all the following conditions are met:
The
EndpointDemographic.Timezoneproperty of the endpoint is set to a valid value.The current time in the endpoint’s time zone is later than or equal to the time specified by the
QuietTime.Startproperty for the campaign.The current time in the endpoint’s time zone is earlier than or equal to the time specified by the
QuietTime.Endproperty for the campaign.
If any of the preceding conditions isn’t met, the endpoint will receive messages from the campaign, even if quiet time is enabled.
- start_time
The scheduled time when the campaign began or will begin.
Valid values are:
IMMEDIATE, to start the campaign immediately; or, a specific time in ISO 8601 format.
- time_zone
The starting UTC offset for the campaign schedule, if the value of the
IsLocalTimeproperty istrue.Valid values are:
UTC, UTC+01, UTC+02, UTC+03, UTC+03:30, UTC+04, UTC+04:30, UTC+05, UTC+05:30, UTC+05:45, UTC+06, UTC+06:30, UTC+07, UTC+08, UTC+09, UTC+09:30, UTC+10, UTC+10:30, UTC+11, UTC+12, UTC+13, UTC-02, UTC-03, UTC-04, UTC-05, UTC-06, UTC-07, UTC-08, UTC-09, UTC-10,andUTC-11.
SetDimensionProperty
- class CfnCampaignPropsMixin.SetDimensionProperty(*, dimension_type=None, values=None)
Bases:
objectSpecifies the dimension type and values for a segment dimension.
- Parameters:
dimension_type (
Optional[str]) – The type of segment dimension to use. Valid values are:INCLUSIVE, endpoints that match the criteria are included in the segment; and,EXCLUSIVE, endpoints that match the criteria are excluded from the segment.values (
Optional[Sequence[str]]) – The criteria values to use for the segment dimension. Depending on the value of theDimensionTypeproperty, endpoints are included or excluded from the segment if their values match the criteria values.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_pinpoint import mixins as pinpoint_mixins set_dimension_property = pinpoint_mixins.CfnCampaignPropsMixin.SetDimensionProperty( dimension_type="dimensionType", values=["values"] )
Attributes
- dimension_type
The type of segment dimension to use.
Valid values are:
INCLUSIVE, endpoints that match the criteria are included in the segment; and,EXCLUSIVE, endpoints that match the criteria are excluded from the segment.
- values
The criteria values to use for the segment dimension.
Depending on the value of the
DimensionTypeproperty, endpoints are included or excluded from the segment if their values match the criteria values.
TemplateConfigurationProperty
- class CfnCampaignPropsMixin.TemplateConfigurationProperty(*, email_template=None, push_template=None, sms_template=None, voice_template=None)
Bases:
objectSpecifies the message template to use for the message, for each type of channel.
- Parameters:
email_template (
Union[IResolvable,TemplateProperty,Dict[str,Any],None]) – The email template to use for the message.push_template (
Union[IResolvable,TemplateProperty,Dict[str,Any],None]) – The push notification template to use for the message.sms_template (
Union[IResolvable,TemplateProperty,Dict[str,Any],None]) – The SMS template to use for the message.voice_template (
Union[IResolvable,TemplateProperty,Dict[str,Any],None]) – The voice template to use for the message. This object isn’t supported for campaigns.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_pinpoint import mixins as pinpoint_mixins template_configuration_property = pinpoint_mixins.CfnCampaignPropsMixin.TemplateConfigurationProperty( email_template=pinpoint_mixins.CfnCampaignPropsMixin.TemplateProperty( name="name", version="version" ), push_template=pinpoint_mixins.CfnCampaignPropsMixin.TemplateProperty( name="name", version="version" ), sms_template=pinpoint_mixins.CfnCampaignPropsMixin.TemplateProperty( name="name", version="version" ), voice_template=pinpoint_mixins.CfnCampaignPropsMixin.TemplateProperty( name="name", version="version" ) )
Attributes
- email_template
The email template to use for the message.
- push_template
The push notification template to use for the message.
- sms_template
The SMS template to use for the message.
- voice_template
The voice template to use for the message.
This object isn’t supported for campaigns.
TemplateProperty
- class CfnCampaignPropsMixin.TemplateProperty(*, name=None, version=None)
Bases:
objectSpecifies the name and version of the message template to use for the message.
- Parameters:
name (
Optional[str]) – The name of the message template to use for the message. If specified, this value must match the name of an existing message template.version (
Optional[str]) – The unique identifier for the version of the message template to use for the message. If specified, this value must match the identifier for an existing template version. To retrieve a list of versions and version identifiers for a template, use the Template Versions resource. If you don’t specify a value for this property, Amazon Pinpoint uses the active version of the template. The active version is typically the version of a template that’s been most recently reviewed and approved for use, depending on your workflow. It isn’t necessarily the latest version of a template.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_pinpoint import mixins as pinpoint_mixins template_property = pinpoint_mixins.CfnCampaignPropsMixin.TemplateProperty( name="name", version="version" )
Attributes
- name
The name of the message template to use for the message.
If specified, this value must match the name of an existing message template.
- version
The unique identifier for the version of the message template to use for the message.
If specified, this value must match the identifier for an existing template version. To retrieve a list of versions and version identifiers for a template, use the Template Versions resource.
If you don’t specify a value for this property, Amazon Pinpoint uses the active version of the template. The active version is typically the version of a template that’s been most recently reviewed and approved for use, depending on your workflow. It isn’t necessarily the latest version of a template.
WriteTreatmentResourceProperty
- class CfnCampaignPropsMixin.WriteTreatmentResourceProperty(*, custom_delivery_configuration=None, message_configuration=None, schedule=None, size_percent=None, template_configuration=None, treatment_description=None, treatment_name=None)
Bases:
objectSpecifies the settings for a campaign treatment.
A treatment is a variation of a campaign that’s used for A/B testing of a campaign.
- Parameters:
custom_delivery_configuration (
Union[IResolvable,CustomDeliveryConfigurationProperty,Dict[str,Any],None]) – The delivery configuration settings for sending the treatment through a custom channel. This object is required if theMessageConfigurationobject for the treatment specifies aCustomMessageobject.message_configuration (
Union[IResolvable,MessageConfigurationProperty,Dict[str,Any],None]) – The message configuration settings for the treatment.schedule (
Union[IResolvable,ScheduleProperty,Dict[str,Any],None]) – The schedule settings for the treatment.size_percent (
Union[int,float,None]) – The allocated percentage of users (segment members) to send the treatment to.template_configuration (
Union[IResolvable,TemplateConfigurationProperty,Dict[str,Any],None]) – The message template to use for the treatment.treatment_description (
Optional[str]) – A custom description of the treatment.treatment_name (
Optional[str]) – A custom name for the treatment.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_pinpoint import mixins as pinpoint_mixins # attributes: Any # custom_config: Any # metrics: Any write_treatment_resource_property = pinpoint_mixins.CfnCampaignPropsMixin.WriteTreatmentResourceProperty( custom_delivery_configuration=pinpoint_mixins.CfnCampaignPropsMixin.CustomDeliveryConfigurationProperty( delivery_uri="deliveryUri", endpoint_types=["endpointTypes"] ), message_configuration=pinpoint_mixins.CfnCampaignPropsMixin.MessageConfigurationProperty( adm_message=pinpoint_mixins.CfnCampaignPropsMixin.MessageProperty( action="action", body="body", image_icon_url="imageIconUrl", image_small_icon_url="imageSmallIconUrl", image_url="imageUrl", json_body="jsonBody", media_url="mediaUrl", raw_content="rawContent", silent_push=False, time_to_live=123, title="title", url="url" ), apns_message=pinpoint_mixins.CfnCampaignPropsMixin.MessageProperty( action="action", body="body", image_icon_url="imageIconUrl", image_small_icon_url="imageSmallIconUrl", image_url="imageUrl", json_body="jsonBody", media_url="mediaUrl", raw_content="rawContent", silent_push=False, time_to_live=123, title="title", url="url" ), baidu_message=pinpoint_mixins.CfnCampaignPropsMixin.MessageProperty( action="action", body="body", image_icon_url="imageIconUrl", image_small_icon_url="imageSmallIconUrl", image_url="imageUrl", json_body="jsonBody", media_url="mediaUrl", raw_content="rawContent", silent_push=False, time_to_live=123, title="title", url="url" ), custom_message=pinpoint_mixins.CfnCampaignPropsMixin.CampaignCustomMessageProperty( data="data" ), default_message=pinpoint_mixins.CfnCampaignPropsMixin.MessageProperty( action="action", body="body", image_icon_url="imageIconUrl", image_small_icon_url="imageSmallIconUrl", image_url="imageUrl", json_body="jsonBody", media_url="mediaUrl", raw_content="rawContent", silent_push=False, time_to_live=123, title="title", url="url" ), email_message=pinpoint_mixins.CfnCampaignPropsMixin.CampaignEmailMessageProperty( body="body", from_address="fromAddress", html_body="htmlBody", title="title" ), gcm_message=pinpoint_mixins.CfnCampaignPropsMixin.MessageProperty( action="action", body="body", image_icon_url="imageIconUrl", image_small_icon_url="imageSmallIconUrl", image_url="imageUrl", json_body="jsonBody", media_url="mediaUrl", raw_content="rawContent", silent_push=False, time_to_live=123, title="title", url="url" ), in_app_message=pinpoint_mixins.CfnCampaignPropsMixin.CampaignInAppMessageProperty( content=[pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageContentProperty( background_color="backgroundColor", body_config=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageBodyConfigProperty( alignment="alignment", body="body", text_color="textColor" ), header_config=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageHeaderConfigProperty( alignment="alignment", header="header", text_color="textColor" ), image_url="imageUrl", primary_btn=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageButtonProperty( android=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), default_config=pinpoint_mixins.CfnCampaignPropsMixin.DefaultButtonConfigurationProperty( background_color="backgroundColor", border_radius=123, button_action="buttonAction", link="link", text="text", text_color="textColor" ), ios=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), web=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ) ), secondary_btn=pinpoint_mixins.CfnCampaignPropsMixin.InAppMessageButtonProperty( android=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), default_config=pinpoint_mixins.CfnCampaignPropsMixin.DefaultButtonConfigurationProperty( background_color="backgroundColor", border_radius=123, button_action="buttonAction", link="link", text="text", text_color="textColor" ), ios=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ), web=pinpoint_mixins.CfnCampaignPropsMixin.OverrideButtonConfigurationProperty( button_action="buttonAction", link="link" ) ) )], custom_config=custom_config, layout="layout" ), sms_message=pinpoint_mixins.CfnCampaignPropsMixin.CampaignSmsMessageProperty( body="body", entity_id="entityId", message_type="messageType", origination_number="originationNumber", sender_id="senderId", template_id="templateId" ) ), schedule=pinpoint_mixins.CfnCampaignPropsMixin.ScheduleProperty( end_time="endTime", event_filter=pinpoint_mixins.CfnCampaignPropsMixin.CampaignEventFilterProperty( dimensions=pinpoint_mixins.CfnCampaignPropsMixin.EventDimensionsProperty( attributes=attributes, event_type=pinpoint_mixins.CfnCampaignPropsMixin.SetDimensionProperty( dimension_type="dimensionType", values=["values"] ), metrics=metrics ), filter_type="filterType" ), frequency="frequency", is_local_time=False, quiet_time=pinpoint_mixins.CfnCampaignPropsMixin.QuietTimeProperty( end="end", start="start" ), start_time="startTime", time_zone="timeZone" ), size_percent=123, template_configuration=pinpoint_mixins.CfnCampaignPropsMixin.TemplateConfigurationProperty( email_template=pinpoint_mixins.CfnCampaignPropsMixin.TemplateProperty( name="name", version="version" ), push_template=pinpoint_mixins.CfnCampaignPropsMixin.TemplateProperty( name="name", version="version" ), sms_template=pinpoint_mixins.CfnCampaignPropsMixin.TemplateProperty( name="name", version="version" ), voice_template=pinpoint_mixins.CfnCampaignPropsMixin.TemplateProperty( name="name", version="version" ) ), treatment_description="treatmentDescription", treatment_name="treatmentName" )
Attributes
- custom_delivery_configuration
The delivery configuration settings for sending the treatment through a custom channel.
This object is required if the
MessageConfigurationobject for the treatment specifies aCustomMessageobject.
- message_configuration
The message configuration settings for the treatment.
- schedule
The schedule settings for the treatment.
- size_percent
The allocated percentage of users (segment members) to send the treatment to.
- template_configuration
The message template to use for the treatment.
- treatment_description
A custom description of the treatment.
- treatment_name
A custom name for the treatment.