Deploy the solution

This solution uses AWS CloudFormation templates and stacks to automate its deployment. The CloudFormation template describes the AWS resources included in this solution and their properties. The CloudFormation stack provisions the resources that are described in the template.

Prerequisites

AMC workflow executions

To execute AMC workflows, you must meet the following prerequisites before launching the stack.

1. An active Amazon Marketing Cloud (AMC) instance. You can create and manage your instance either through the AMC console or through the AMC APIs.

2. Sign in to Amazon Ads to access the AMC console. From the AMC console, record the following parameters for each AMC instance. You will use these throughout the solution. You can find the Instance ID on the account landing page, while the rest are located on the Instance Info page.

   • Instance ID

   • Data upload AWS account ID

   • Amazon S3 bucket name

3. For each AMC account, keep note of the following parameters found on the AMC console and Developer API Documentation. You can find the Advertiser ID by selecting your account in the upper-right corner of the AMC console (listed as ID), or by looking at the console URL for the value prefixed with ENTITY (example: link:https://advertising.amazon.com/marketing-cloud?entityId=ENTITYX9XX99XX)

   • Advertiser ID

   • Marketplace ID

   • Client ID and Secret ID associated with your Amazon Ads developer account.

Amazon Ads reporting

To retrieve reports for sponsored ads and Amazon DSP campaigns, you must meet the following prerequisites.

• Client ID and Secret ID associated with your Amazon Ads developer account.

• Profile ID associated with an advertising account in a specific marketplace. See the Sagemaker notebook code example to retrieve profile IDs. If you do not have an active one, contact your Amazon Account Team or Amazon Ads API support.

Selling Partner reporting

Before requesting reports using Selling Partner API, follow the Authorization to Selling Partner APIAuthorization to Selling Partner API instructions to meet the following prerequisites.

• Client ID and Client Secret

• Refresh token

Deployment process overview

Follow the step-by-step instructions in this section to configure and deploy the solution into your account.

Before you launch the solution, review the cost, architecture, network security, and other considerations discussed earlier in this guide.

Note

If you have previously deployed this solution, see Update the solution for update instructions.

Time to deploy: Approximately 10 minutes

Step 1: Choose your deployment option

• Single account deployment

• Multi account deployment

Step 2: Launch the stack

Step 3: Set AWS Lake Formation permissions

Important

This solution includes an option to send anonymized operational metrics to AWS. We use this data to better understand how customers use this solution and related services and products. AWS owns the data gathered though this survey. Data collection is subject to the AWS Privacy Notice.

To opt out of this feature, download the template, modify the AWS CloudFormation mapping section, and then use the AWS CloudFormation console to upload your updated template and deploy the solution. For more information, see the Anonymized data collection section of this guide.