Git Product home page Git Product logo

amazon-pinpoint-segment-campaign-automation's Introduction

Amazon Pinpoint Segment Campaign Automation

Publish Version Unit Tests

Introduction

This repository contains a solution for automating the process of capturing your customers’ interests in a product category, so you can tailor your marketing messages. It uses a series of AWS services including Amazon Pinpoint, AWS Step Functions, AWS Lambda, Amazon DynamoDB and Amazon Simple Notification Service (SNS).

An AWS CloudFormation template will deploy an AWS Step Functions with a series of Lambdas, one Amazon DynamoDB table and three SNS topics. For a successful deployment, you will need to provide an existing Amazon Pinpoint project as well as a validated email address from where you can send emails from.

This repository is part of a blog post where you can find step-by-step instructions.

Architecture

This solution uses:

An overview of the architecture is below:

[Architecture Diagram]

Usage

Prerequisites

To deploy the solution, you will require an AWS account. If you don’t already have an AWS account, create one at https://aws.amazon.com by following the on-screen instructions. Your access to the AWS account must have IAM permissions to launch AWS CloudFormation templates that create IAM roles.

Deployment

The application is deployed as an AWS CloudFormation template.

Note You are responsible for the cost of the AWS services used while running this sample deployment. There is no additional cost for using this sample. For full details, see the pricing pages for each AWS service you will be using in this sample. Prices are subject to change.

  1. Deploy the latest CloudFormation template by following the link below for your preferred AWS region:
Region Launch Template
US East (N. Virginia) (us-east-1) Launch CloudFormation Stack
US West (Oregon) (us-west-2) Launch CloudFormation Stack
EU (Ireland) (eu-west-1) Launch CloudFormation Stack
EU (London) (eu-west-2) Launch CloudFormation Stack
EU (Frankfurt) (eu-central-1) Launch CloudFormation Stack
AP (Sydney) (ap-southeast-2) Launch CloudFormation Stack
  1. If prompted, login using your AWS account credentials.
  2. You should see a screen titled "Create Stack" at the "Specify template" step. The fields specifying the CloudFormation template are pre-populated. Click the Next button at the bottom of the page.
  3. On the "Specify stack details" screen you may customize the following parameters of the CloudFormation stack:
Parameter label Default Description
PinpointProjectId required Amazon Pinpoint Project ID.
EmailFromAddress required Type the email that you would like the campaign email to be sent from. This email address needs to be validated first.
ResourceTags MyApp Tag resources, which can help you identify and categorize them.
Environment DEV The type of environment to tag your infrastructure with.

When completed, click Next

  1. Configure stack options if desired, then click Next.

  2. On the review screen, you must check the boxes for:

    • "I acknowledge that AWS CloudFormation might create IAM resources"
    • "I acknowledge that AWS CloudFormation might create IAM resources with custom names"
    • "I acknowledge that AWS CloudFormation might require the following capability: CAPABILITY_AUTO_EXPAND"

    These are required to allow CloudFormation to create a Role to grant access to the resources needed by the stack and name the resources in a dynamic way.

  3. Click Create Stack

  4. Wait for the CloudFormation stack to launch. Completion is indicated when the "Stack status" is "CREATE_COMPLETE".

    • You can monitor the stack creation progress in the "Events" tab.

Clean up

To remove the stack:

  1. Open the AWS CloudFormation Console.
  2. Click the pinpoint-campaign-automation project, right-click and select "Delete Stack".
  3. Your stack will take some time to be deleted. You can track its progress in the "Events" tab.
  4. When it is done, the status will change from "DELETE_IN_PROGRESS" to "DELETE_COMPLETE". It will then disappear from the list.
  5. Locate the S3 bucket and delete it manually.

Local Development

See Local Development guide to get a copy of the project up and running on your local machine for development and testing purposes.

Security

See CONTRIBUTING for more information.

License

This library is licensed under the MIT-0 License. See the LICENSE file.

amazon-pinpoint-segment-campaign-automation's People

Contributors

rezabekf avatar pavlosik avatar amazon-auto avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.