Amazon Pinpoint FAQs
Getting started
How can I try Amazon Pinpoint?
Amazon Pinpoint is self-service so you can try before you buy, without talking to sales, completing RFPs, or hiring for consultants or professional services. Simply log in to the Amazon Pinpoint console using your AWS account and set up an Amazon Pinpoint project. To learn how to set up Amazon Pinpoint, see the Getting Started tutorial.
What is an activity in a journey?
Journeys automate multi-step campaigns. Each activity in a journey is either an action (such as sending an email), a time-based wait, splitting the journey segment based on customer action (such as opening an email vs not opening the email) or enforcing a holdout.
To learn more about these activities, see Journeys in the Amazon Pinpoint User Guide.
SMS
What is an activity in a journey?
Journeys automate multi-step campaigns. Each activity in a journey is either an action (such as sending an email), a time-based wait, splitting the journey segment based on customer action (such as opening an email vs not opening the email) or enforcing a holdout.
To learn more about these activities, see Journeys in the Amazon Pinpoint User Guide.
Can I schedule my journeys?
You can configure each journey to start and end at a specific time. Each journey can run continuously for up to 18 months.
You can also schedule how often new participants enter the journey. When you create a journey, you specify a segment of customers that participate in it. You can set up your journey so that this segment is updated on a regular basis—hourly, daily, monthly, quarterly, annually, or not at all.
What can I do if I make a mistake in my journey?
Journeys includes a built-in review process that checks for show-stopping errors, while also providing recommendations and best practices. You have to complete this review process before you launch each journey.
Journeys also includes a test feature, which makes it easy to send a group of test participants through your journey. By testing your journey, you can ensure that it behaves the way that you expect it to behave.
If you encounter issues with your journey while it's running, you can stop it at any time. When you stop a journey, participants halt on the activity they're currently on, and never proceed to the next activity.
Marketing messages
How can I use Amazon Pinpoint to run and manage my campaigns?
Amazon Pinpoint makes it easy to run targeted campaigns and drive customer communications across different channels: email, SMS, push notifications, in-app messaging, or custom channels. Amazon Pinpoint campaigns enables you define which users to target, determine which messages to send, schedule the best time to deliver the messages, and then track the results of your campaign.
Amazon Pinpoint is built to scale, enabling you to collect and process billions of events per day, and send billions of targeted messages to your users.
How will marketers benefit from Amazon Pinpoint?
The console provides marketers with campaign management tools to create, run, and manage multi-channel campaigns across their applications, user-base and devices. Campaigns can be scheduled or triggered on user changes and actions. For marketers that want to run multi-step campaigns across multiple channels, they can design journeys to orchestrate an end-to-end experience. Marketers can also leverage the templating support to personalize end-user messaging. Marketers can also measure messaging effectiveness using Pinpoint analytics to understand the impact on user behavior.
What's a standard campaign?
Standard campaigns include a targeted segment (either static or dynamic), a message, and a schedule for sending the message. You can also reuse previously defined segments or define a new segment when you create a campaign. For every scheduled campaign, Amazon Pinpoint recalculates the current audience size based on the criteria associated with the segment.
What's an A/B test campaign?
A/B campaigns are campaigns with more than one treatment. Each treatment differs from the other based on the message or the sending schedule. You can compare the response rates for each treatment to determine which one had a bigger impact on your customers.
What are my scheduling options for campaigns?
During campaign set up in Amazon Pinpoint, you can choose when the campaign should be sent. You have two options, you can send the campaign at a specific time, or you can send it when an event occurs. Time-based campaigns can be scheduled to run one time immediately, or at a time you designate in the future. They can also be scheduled with multiple runs—hourly, daily, weekly, or monthly. To define your recurring campaigns, choose a start date and an end date, and specify whether or not to deliver messages based on each recipient's local time zone.
You can also use Amazon Pinpoint to create campaigns that send messages, such as text messages, push notifications, in-app messaging, and emails, to your customers when they take specific actions within your apps. For example, sending a welcome email when a customer creates a profile. You can create event-based campaigns by using the Amazon Pinpoint console, or by using the Amazon Pinpoint API. Event-based campaigns are an effective way to implement both transactional and targeted campaign use cases. Rather than define a time to send your message to customers, you select specific events, attributes, and metric values that you want to use to trigger your campaigns. For more information about event-based campaigns, see our blog post.
If I use another campaign management service, how does Amazon Pinpoint help me?
Amazon Pinpoint's architecture is modular. Companies can choose which services to use and integrate with their existing systems and processes. Amazon Pinpoint's core services include: engagement analytics, communication channels, deliverability metrics, audience management and segmentation, template management, and campaign management.
The platform also supports data integration services to extend Amazon Pinpoint analytics and segmentation data from external data sources such as S3, as well as data exports to feed external marketing systems through Kinesis Event Streams.
How do campaign limits work?
On the General Settings page of the Amazon Pinpoint console or in the campaign settings, you can configure the maximum number of messages an endpoint can receive for a campaign. This feature is useful when you want to place strict limits on the number of messages that an endpoint can receive at a specific moment in time. For example, if you create a campaign that's automatically sent to all new customers, you can set the limit to 1. This setting ensures that new customers only receive the message once.
It's important to note that this feature is based on the number of messages that target an endpoint, as opposed to the number of messages that are actually delivered to an endpoint. If a campaign is configured to automatically send a message when a customer creates a new account, but the endpoint isn't able to receive the message for some reason (for example, if the quiet time setting for your campaign applies to the endpoint), then the endpoint is still counted as having been targeted. In this situation, the endpoint is removed from subsequent runs of the campaign until they are outside the limit period.
Can I schedule my journeys?
You can configure each journey to start and end at a specific time. Each journey can run continuously for up to 18 months.
You can also schedule how often new participants enter the journey. When you create a journey, you specify a segment of customers that participate in it. You can set up your journey so that this segment is updated on a regular basis—hourly, daily, monthly, quarterly, annually, or not at all.
What can I do if I make a mistake in my journey?
Journeys includes a built-in review process that checks for show-stopping errors, while also providing recommendations and best practices. You have to complete this review process before you launch each journey.
Journeys also includes a test feature, which makes it easy to send a group of test participants through your journey. By testing your journey, you can ensure that it behaves the way that you expect it to behave.
If you encounter issues with your journey while it's running, you can stop it at any time. When you stop a journey, participants halt on the activity they're currently on, and never proceed to the next activity.
Pinpoint for developers
How can developers use Amazon Pinpoint?
Amazon Pinpoint offers developers a single API layer, CLI support, and client-side SDK support to be able to extend the communication channels through which their applications engage users. These channels include: email, SMS text messaging, and push notifications, voice messages, and custom channels. Amazon Pinpoint also provides developers with an analytics system that tracks app user behavior and user engagement. With this service, developers can learn how each user prefers to engage and can personalize their end-user's experience to increase the value of the developer's applications.
Amazon Pinpoint also helps developers address multiple messaging use cases such direct or transactional messaging, targeted, or campaign messaging and event-based messaging.
What are event-based campaigns?
Event-based campaigns send messages, such as text messages, push notifications, in-app messaging, and emails, to your customers when they take specific actions within your applications, such as making purchases or watching a video. For example, you can set up a campaign to send a message when a customer creates a new account or when they add an item to their cart but don't purchase it. You can create event-based campaigns by using the Amazon Pinpoint console, or by using the Amazon Pinpoint API. Event-based campaigns are an effective way to implement both transactional use cases, such as one-time-password and order confirmation messages, and targeted uses cases, such as marketing promotions. Rather than define a time to send your message to customers, you select specific events, attributes, and metric values that you want to use to trigger your campaigns. For more information about event-based campaigns, please view this blog post.
How do I get started with event-based campaigns?
The first step in setting up an event-based campaign is to create a new campaign. On step 4 of the campaign creation process, you choose when the campaign should be sent. You can choose to send the campaign at a specific time, or you can send it when an event occurs. Choose "When an event occurs", and then choose the events, attributes, and metrics that trigger your campaign.
What are custom events?
Custom events are event metrics that you define. They help track user actions specific to your application or game. The Amazon Pinpoint event charts provide a view of how often custom events occur. Custom events can be filtered based on attributes and their associated values.
You create custom events by naming them, such as "Item Bought" or "Button Pressed," and then adding context by specifying attributes (for qualitative measures) and metrics (for quantitative measures). For example, if your business goal is to track purchases of items from within the app, you can use "Item Bought" as a custom event, "Item XYZ" as an attribute, and "Item Price" as the metric. The custom events report enables you to search and filter for each attribute or metric. For example, you can find how often "Item XYZ" was purchased or how often "Item Price" was $1.99. You can also review the weighted average of metric values (per session) and track minimum, maximum, or average metric values. As a best practice, we recommend that custom event names be broad and attribute names be specific.
What are the benefits of using custom events?
Custom events help you understand the actions that users take when using your app. For example, a game developer might want to understand both how often a level is completed and how much health each player has left at the end of a level. With custom events, you can create an event called "level_complete", with "add_level" as an attribute, and "health" as an attribute value. Each time a level is completed, you can record a "level_complete" event with the name of the level and the player's health. By reviewing the events charts, you might discover that a level is too easy because players always finish with maximum health. Using this data, you can adjust the level's difficulty to better challenge and engage players, which might improve retention.
You can also use custom events to create event-based campaigns that are sent when your customers take specific actions within your applications. For example, you can set up a campaign to send a message when a customer creates a new account, when they spend a certain dollar amount, or when they add an item to their cart but don't purchase it.
Event-based campaigns help you send messages that are timely, personalized, and relevant to your customers, which ultimately increases their trust in your brand and gives them a reason to return. You can create event-based campaigns by using the Amazon Pinpoint console, or by using the Amazon Pinpoint API.
Can Amazon Pinpoint tell if a single user uses the same app on more than one device (for example, on their phone and on a tablet device)?
Amazon Pinpoint distinguishes between endpoints and users. An endpoint is a destination that you can send messages to—such as a user's mobile device, email address, or phone number. A user is an individual who has a unique user ID. This ID can be associated with up to 10 endpoints.
Some of the Amazon Pinpoint analytics charts report on endpoints, and some report on users. To learn more about the individual charts, see Chart Reference for Amazon Pinpoint Analytics in the Amazon Pinpoint User Guide.
How is a "session" defined?
A session begins when an app is launched (or brought to the foreground), and ends when the app is terminated (or goes to the background). To accommodate for brief interruptions, like a text message, an inactivity period of up to 5 seconds is not counted as a new session. Total daily sessions shows the number of sessions your app has each day. Average sessions per daily active user shows the mean number of sessions per user per day.
Analytics
What metrics does Amazon Pinpoint track for standard campaigns?
For standard campaigns, you can track messages sent, messages delivered, delivery rate, open rate, and campaign sessions by time of day.
Where can I access analytics data?
You can view analytics data on the Amazon Pinpoint console. For each of your projects, the console provides detailed charts and metrics that provide insight into areas such as customer demographics, application usage, purchase activity, and delivery and engagement rates for campaigns. You can also access a subset of these metrics programmatically by using the Amazon Pinpoint API.
What types of analytics does Amazon Pinpoint provide on my mobile and web applications?
Amazon Pinpoint offers several types of standard analytics that provide insight into how your application is performing. Standard analytics include metrics for active users, user activities and demographics, sessions, user retention, campaign efficacy, and transactional messages. Using these metrics in combination with the analytics tools on the console, you can perform in-depth analysis by filtering on certain segments, custom attributes, and more.
How are daily and weekly retention defined?
Daily retention is measured by determining the number of users that first used your app on a specific day, came back and used your app in the next 7 days (7-day retention), fourteen days (14-day retention), and thirty days (30-day retention).
What is "sticky factor," and how is it calculated?
The sticky factor represents the number of monthly users who used the app on a particular day.
Sticky factor is calculated by dividing daily active users (DAU) by monthly active users (MAU). For example, if an app has 100,000 DAU and 300,000 MAU, its sticky factor is .33. A high sticky factor can indicate strong engagement, appeal, and opportunities for monetization.
What are demographics in Amazon Pinpoint?
The demographics charts provide information about the device attributes for your app users. You can also see custom attributes that you define.
How long does Amazon Pinpoint store analytics data?
Amazon Pinpoint automatically stores your analytics data for 90 days. You can see your data on the console or you can query a subset of data programmatically using the Amazon Pinpoint API. To keep the data for a longer period of time, you can export data from the console to comma-separated values (.csv) files or configure Amazon Pinpoint to stream event data to Amazon Kinesis. Kinesis is an AWS service that can collect, process, and analyze data from other AWS services in real-time. Amazon Pinpoint can send event data to Kinesis Data Firehose, which streams data to AWS data stores such as Amazon S3 or Amazon Redshift. Amazon Pinpoint can also stream data to Kinesis Data Streams, which ingests and stores multiple data streams for processing in analytics applications.
10DLC
What is 10DLC?
10DLC is a new standard for sending messages from applications such as Amazon Pinpoint to individual recipients. This type of sending is known as Application-to-Person or A2P messaging. You can use 10DLC phone numbers to send text messages to your customers with high throughput and high rates of message delivery.
To use 10DLC numbers, carriers require that you register information related to your company as well as your use case (also called your 10DLC campaign). You complete these registration processes directly in the Amazon Pinpoint console. After your company and 10DLC campaign are approved, you can purchase a phone number and associate it with your campaign.
Will I still be able to purchase US long codes after June 1, 2021?
After June 1, 2021, unregistered US long codes will only be available for use with the voice channel. You won’t be able to use unregistered US long codes to send SMS messages.
To send SMS messages to recipients in the US, you must use either a short code, a 10DLC phone number, or a toll-free number.
Should I delete the existing unregistered long code(s) for US that I have in my AWS account?
If you don’t do anything, unregistered long codes will remain in your account. You’ll continue to pay $1 per month for each unregistered long code. However, you won’t be able to use unregistered US long codes to send text messages.
You can keep your unregistered long codes if you plan to use them to send voice messages to your customers. You can also convert unregistered long codes to 10DLC phone numbers if you want to continue to use them to send text messages.
If you don’t want to keep your unregistered long codes, you can delete them in the Amazon Pinpoint console.
If I convert my unregistered long codes to 10DLC numbers, will I experience any downtime?
If you complete the 10DLC conversion process before June 1st, 2021, you won’t experience any downtime. If you begin the conversion process after this date, you may experience several days of downtime.
What is a 10DLC campaign? What information do I need to provide to create one?
It’s important to note that 10DLC campaigns are completely separate from and unrelated to Amazon Pinpoint campaigns.
A 10DLC campaign is a description of your use case. During the 10DLC campaign registration process, you must describe the use case and provide the message templates that you plan to use. For more information, see Registering a 10DLC Campaign in the Amazon Pinpoint User Guide.
If I have just one 10DLC phone number in my account, will every SMS message I send to US recipients be sent using this phone number?
Yes. If you only have one US phone number in your account—whether it’s a 10DLC number, a short code, or toll-free number—all of the messages that you send to recipients in the US will be sent through that number.
If you have multiple numbers in your Amazon Pinpoint account, you can specify your Origination Number in your call to the Amazon Pinpoint API. If you don’t specify an originating number, Amazon Pinpoint looks for the best number to use to send your message. If you have a short code in your account, Amazon Pinpoint will send using that number. If you don’t have a short code, it looks for a 10DLC phone number, and attempts to send using that number. If you don’t have a 10DLC number, it looks for a toll-free number, and attempts to send using that number.
Can I use multiple 10DLC numbers for one campaign?
You can associate multiple phone numbers with a 10DLC campaign. However, you can’t associate a single phone number with more than one 10DLC campaign. Using multiple phone numbers for the same campaign doesn’t provide any added benefit in terms of throughput.
I registered my 10DLC company and campaign successfully, but the status of the 10DLC number I associated with the 10DLC campaign is ‘Pending.’ Why is this happening?
It takes up to 14 business days to associate a new phone number with a 10DLC campaign. When the association process is complete, the status changes to ‘Ready.’
Can I use AWS APIs to purchase 10DLC phone numbers instead of using the AWS Pinpoint console?
No. Currently it’s only possible to purchase phone numbers through the Amazon Pinpoint console.
How can I use 10DLC for different AWS Regions in my AWS account?
The 10DLC company and campaign registration processes are connected to your AWS account, and is not tied to a specific AWS Region. You can have multiple 10DLC numbers that unique to a specific AWS Region. These phone numbers can all be associated with the same 10DLC campaign.
Can I get a 10DLC phone number with a specific area code?
No, we don’t currently provide the option of specifying an area code when you purchase a phone number.
Can I use 10DLC numbers as originating identities for sending texts to recipients outside the US?
No, 10DLC is a concept that only applies to messages sent to recipients in the US who have US phone numbers.
Can I use 10DLC phone numbers to send voice messages?
Yes. When you purchase a phone number to use with a 10DLC campaign, you can specify whether you want to use the number to send SMS messages, voice messages, or both. As long as you enable the voice capability when you purchase a number, you can use that number to send voice messages.
How can I enter the variable content to my sample messages while creating a 10DLC campaign?
You can use placeholders for variables in your sample messages to indicate variable content. For example, for the below sample message: “Hi John, your OTP is 1234” can be written as “Hi {#var}, your OTP is {#var}.”
Is there a way to capture metrics for each 10DLC campaign?
The analytics dashboards in Amazon Pinpoint provide overall metrics for the current project. However, they don’t provide metrics for specific 10DLC campaigns. You can enable event streaming to capture delivery and response metrics for your messages.
How long does it take to migrate 10DLC registrations from one AWS account to another?
While it is possible to migrate 10DLC registrations between AWS accounts, it may take several weeks to complete the transfer process. For this reason, we recommend that you complete the 10DLC registration process in your primary production account. You can then use cross-account access to share your 10DLC phone numbers with other AWS accounts, such as your test or development accounts.
I registered my company directly via the Campaign Registry portal. Can the same registration be used for my AWS account?
No. In this situation, you would have to register again through the Amazon Pinpoint console.
Is it possible to share 10DLC phone numbers across AWS Regions?
10DLC company and campaign registrations apply to your entire AWS account, but individual phone numbers are specific to each AWS Region. You can register your 10DLC company and campaign in one Region, and then use cross-account access to share phone numbers across Regions.
If I publish at a higher rate than my 10DLC campaign supports, will I receive a throttling error?
By default, Amazon Pinpoint limits the number of SMS messages that you can send to 20 per second. If you exceed this account-level limit, you will receive throttling errors. However, you can request an increase to this limit.
With 10DLC, the mobile carriers calculate a trust score for each sender during the company and campaign registration processes. This trust score determines how many messages each carrier will accept from you. If you exceed the limits for your campaign for a particular carrier, that carrier will begin rejecting your messages. We highly recommend that you enable event streaming in order to track these events.
Is two-way messaging supported with 10DLC numbers?
Yes, 10DLC phone numbers support two-way messaging.
How can I register my company in two different AWS accounts?
10DLC company and campaign registrations are managed through a third-party organization called the Campaign Registry. Currently, the Campaign Registry only allows a company to be registered once for each sending application (such as Amazon Pinpoint). However, you can use cross-account access to allow multiple AWS accounts to send SMS messages using the same 10DLC phone number.
Can I use URL shorteners for 10DLC messages?
The mobile carriers don’t allow senders to use links that have been shortened using services such as bit.ly or TinyURL. We recommend that you use the full domain of your URLs when you include links in your messages. Alternatively, there are commercial URL shortening services that let you use dedication domains. You can even build a URL shortener using AWS services. If you use a custom URL shortening domain, the domain name should be obviously related to your brand. During the 10DLC campaign registration process, you should provide examples of your shortened URLs when you provide your message templates.
I only use Amazon SNS to send text messages. Should I still use Amazon Pinpoint to register my 10DLC campaign?
Yes. The Amazon SNS console currently doesn’t include a way to register 10DLC companies and campaigns. However, you can use the 10DLC phone numbers that you configured in the Amazon Pinpoint console to send messages using Amazon SNS.
Other AWS services
I already use Amazon SNS or Amazon Simple Email Service (SES). What do I gain by switching to Amazon Pinpoint?
In typical Amazon SNS and Amazon SES use cases, you have to set up your application to manage each message's audience, content, and delivery schedule. With Amazon Pinpoint, you can create message templates, delivery schedules, highly-targeted segments, and full campaigns.
How does Amazon Pinpoint voice channel differ from Amazon Connect?
With Amazon Pinpoint voice, you can engage with your customers by delivering voice messages over the phone. Pinpoint voice gives customers a great way to deliver transactional messages—such as one-time passwords, appointment reminders, order confirmations, and more. With Pinpoint voice capabilities, you can convert a text script to lifelike speech, and then deliver the personalized voice message to your customer. Call metrics—such as number of calls completed and number of calls failed—help you to optimize future voice engagements. With both Pinpoint voice and SMS channels available to you, you can send SMS messages to customers who prefer text and deliver voice messages to those who are either unable to receive SMS messages. With the addition of the voice channel, you can now use Amazon Pinpoint to seamlessly engage your customers with timely, relevant content through push notifications, email, SMS, and voice calls.
Amazon Connect is an easy-to-use omnichannel cloud contact center that helps companies provide superior customer service at a lower cost. Over 10 years ago, Amazon’s retail business needed a contact center that would give our customers personal, dynamic, and natural experiences. We couldn’t find one that met our needs, so we built it. We've now made this available for all businesses, and today thousands of companies ranging from 10 to tens of thousands of agents use. To learn more, see Amazon Connect.
Data privacy
Does Amazon Pinpoint store my customer data?
Yes. Amazon Pinpoint stores user, endpoint, and event data. We have to retain this data so that you can create segments, send messages to recipients, and capture application and campaign engagement data.
Do I own my content that is processed and stored by Amazon Pinpoint?
You always retain ownership of your content. We only use your content with your consent.
How do I delete the data that Amazon Pinpoint stores?
You can selectively delete the data stored in your Amazon Pinpoint account or you can close your entire AWS account. After the post-closure period, AWS permanently closes your AWS account, and you can no longer reopen it. Any content that you didn't delete is permanently deleted, and any AWS services that you didn't stop are stopped. For more information, see deleting data from Amazon Pinpoint in the Amazon Pinpoint Developer Guide or on our Account Closure page.
Pricing
What are carrier fees?
Mobile carriers in the US will assess a fee each time an Application-to-Person (A2P) SMS is sent over their networks. The AWS carrier fees cover these charges and are subject to change when mobile carriers change their fees.
Do I incur charges for undelivered SMS messages?
Charges apply to all deliveries when messages leave AWS and reach downstream infrastructure, regardless of delivery success.
Contact us
I received spam or other unsolicited email messages from an Amazon Pinpoint user. How do I report these messages?
You can report email abuse by sending an email to email-abuse@amazon.com.
To help us handle the issue as quickly and effectively as possible, please include the full headers of the original email. For procedures for obtaining email headers for several common email clients, see “How to Get Email Headers” on the MxToolbox.com website.
How can I submit feature requests or send other product feedback about Amazon Pinpoint?
Your AWS Account Manager can send your feature requests and feedback directly to the appropriate team. If you don't currently have an AWS Account Manager, you can also provide your feedback on the Amazon Pinpoint forum.
How can I get technical support for Amazon Pinpoint?
If you have an AWS Support plan, you can create a new support case directly from the web-based AWS management console. AWS Support plans begin at $29 per month. For more information about AWS Support plans, visit https://aws.amazon.com/premiumsupport/.
To open a new technical support case:
- In the console, on the Support menu, choose Support Center.
- Choose Create case.
- On the Create case page, choose Technical support.
- Provide information about the issue you're experiencing, and then submit the ticket.
If you don't have an AWS Support plan, you can also ask questions and get answers on the Amazon Pinpoint forum.