Skip to main content

Partner Promotions Construct

This OOB blueprint CX construct is an end-to-end customer experience ideal for 3P Partners providing gift/coupon URLs for Prime members to redeem exclusive online offers such as online subscriptions or online transactions, and does not require Prime members to link their Amazon and 3P accounts for offer redemption.

This experience or workflow includes Amazon-owned and 3P Partner-owned pages. Features include Prime member status verification for the 3P offer on Amazon-owned pages and does not allow for verification on 3P-owned pages.

This construct does not involve tech integration from 3P Partner but requires support for gift/coupon URLs management for tracking and reporting.

Onboarding Steps​

As we know Partner Promotions Construct is an API-less integration construct, where clients just need to provide promo codes (aka, claim codes) to Prime team. In this CX, Prime Customers receive a unique 3P provided promotion URL for a Prime member exclusive offer on Amazon landing page and redeem the promo code on 3P domain.

Clients can onboard to Partner Promotions Construct in a single step:

  • Upload Promo Codes

Upload Promo Codes​

We ask 3Ps to upload the promo codes in an AWS S3 Bucket, for which they can follow the below steps:

1. One Time Setup​

Pre-requisite: An AWS account (Please refer to create an AWS account, if you don’t have one created)

  1. Create an IAM Role/User in the AWS account (Please refer to create an IAM Role/ User)

    • Suggested Name: <ClientName>-PromoCodesUpload-Role/User

  2. Add the following permissions to the IAM Role/User (Please refer to add permissions to an IAM Role/ User)

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "s3:ListBucket",
            "Resource": "arn:aws:s3:::ellis-partner-promotions",
            "Condition": {
                "StringLike": {
                    "s3:prefix": [
                        "new-promo-codes/clientname=<ClientName>/marketplace=US/offertype=student-promo-deal/*",
                        "redeemed-promo-codes/clientname=<ClientName>/marketplace=US/offertype=student-promo-deal/*"
                    ]
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": "s3:GetBucketOwnershipControls",
            "Resource": "arn:aws:s3:::ellis-partner-promotions"
        },
        {
            "Effect": "Allow",
            "Action": "s3:PutObject",
            "Resource": [
                "arn:aws:s3:::ellis-partner-promotions/new-promo-codes/clientname=<ClientName>/marketplace=US/offertype=student-promo-deal/*",
                "arn:aws:s3:::ellis-partner-promotions/redeemed-promo-codes/clientname=<ClientName>/marketplace=US/offertype=student-promo-deal/*"
            ]
        }
    ]
}
  1. Provide the IAM Role/User ARN to Amazon Prime team, to allow this Role/User to access the S3 Bucket.

2. Promo Codes File Structure​

  • Separate files for new promo codes and redeemed promo codes
  • File format should be CSV
  • File name
    • For new codes : <ClientName>_new_codes_YYYYMMDD_HHMM.csv
    • For redeemed codes : <ClientName>_redeemed_codes_YYYYMMDD_HHMM.csv
    • Note: Date and Time are in UTC
  • File should contain two columns, one for promo codes and other with status:
    • “new” status for all codes in new promo codes file
    • “redeemed” status for all codes in redeemed promo codes file

Example:

linkedin_new_codes_20220422_1530.csv

New Codes Example

linkedin_redeemed_codes_20220429_1530.csv

Redeemed Codes Example

3. Steps to Upload New Codes​

  1. Sign in to the AWS account with the IAM Role/User created above
  2. To upload new codes
    1. Go to this url - https://s3.console.aws.amazon.com/s3/buckets/ellis-partner-promotions?region=us-east-1&prefix=new-promo-codes/clientname%3Dlinkedin/marketplace%3DUS/offertype%3Dstudent-promo-deal/&showversions=false
    2. Click Upload and Add the CSV file containing new promo codes
    3. Note: These promo codes come under the scope of customer usage as soon as they are uploaded, so please check and verify the CSV file once before uploading.

4. Steps to Upload Redeemed Codes​

  1. Sign in to the AWS account with the IAM Role/User created above
  2. To upload redeemed codes
    1. Go to this url - https://s3.console.aws.amazon.com/s3/buckets/ellis-partner-promotions?region=us-east-1&prefix=redeemed-promo-codes/clientname%3Dlinkedin/marketplace%3DUS/offertype%3Dstudent-promo-deal/&showversions=false
    2. Click Upload and Add the CSV file containing redeemed promo codes

5. Troubleshooting​

In case of any issues while uploading the promo codes,

  • Check if you have signed in to the correct AWS account
  • Check if you have signed in with correct IAM Role/User
  • Check if the IAM Role/User have the required permissions as defined above
  • Reach out to your Amazon Prime POC with details of the error your are facing.