Automatum

Buy with AWS Integration Guide ​

Complete guide to setting up and managing Buy with AWS integration for your AWS Marketplace listings.

Overview ​

Buy with AWS is an AWS Marketplace program that allows you to embed purchase buttons and forms directly on your website, enabling customers to purchase your products without leaving your site. Automatum provides a step-by-step wizard to configure and generate embed codes for your listings.

What is Buy with AWS? ​

Buy with AWS enables you to:

  • Embed purchase buttons on your website that link directly to AWS Marketplace
  • Collect private offer requests through embedded forms
  • Request product demos from potential customers
  • Track analytics on button clicks and conversions
  • Provide seamless purchasing experience for your customers

Prerequisites ​

Before setting up Buy with AWS integration, ensure you have:

  • ✅ An active AWS Marketplace seller account
  • ✅ At least one published product in AWS Marketplace
  • ✅ AWS Seller ID configured in your Automatum organization
  • ✅ Product synced to Automatum from AWS Marketplace

Quick Start ​

Step 1: Configure AWS Seller ID ​

Your AWS Seller ID is required for Buy with AWS integration. If you haven't added it yet:

  1. Find Your AWS Seller ID:

    • Log in to AWS Marketplace Management Portal
    • Navigate to Settings > Account Setup
    • Your Seller ID is displayed in the Account Information section
    • It typically looks like: b8acac52-72f1-4eab-8b91-9b41e6b915f4 (UUID format)

  2. Add Seller ID to Automatum:

    • Go to Settings > Organization > Cloud Accounts
    • Find your AWS account connection
    • Click Edit or Configure
    • Enter your AWS Seller ID in the seller ID field
    • Click Save

Seller ID Format

Your AWS Seller ID is a UUID (e.g., b8acac52-72f1-4eab-8b91-9b41e6b915f4). Some systems may display it with a leading slash (/b8acac52-...), but you should enter it without the slash in Automatum.

Step 2: Access Buy with AWS Wizard ​

  1. Navigate to Listings in Automatum
  2. Select an AWS Marketplace listing
  3. Click Buy with AWS button or action
  4. The Buy with AWS Setup Wizard will open

Wizard Overview ​

The Buy with AWS wizard guides you through 6 steps:

  1. Buy Button - Configure "Buy with AWS" button for public offers
  2. Try Free Button - Configure "Try free with AWS" button for free trials
  3. Private Offer Form - Set up form to collect private offer requests
  4. Demo Form - Configure demo request form
  5. Review - Review configuration and generate final embed code
  6. Branding Review - Instructions for AWS Marketplace approval

Step-by-Step Configuration ​

Step 1: Configure Buy with AWS Button ​

The "Buy with AWS" button directs customers to your product's AWS Marketplace page.

Configuration Options:

  • Offer Type: Select public offer or specific offer ID
  • Public Offer ID (optional): Pre-select a specific public offer
  • Source URL (optional): URL to return customers after purchase
  • Button Text: Customize button text (default: "Buy with AWS")
  • Enable/Disable: Toggle button on/off

To Generate Link:

  1. Select offer type
  2. Optionally enter public offer ID
  3. Optionally enter source URL
  4. Click Generate Link
  5. Review the generated URL
  6. Click Next to proceed

Source URL

The source URL is where customers will be redirected after completing their purchase on AWS Marketplace. This helps track conversions and provides a seamless return experience.

Step 2: Configure Try Free with AWS Button ​

The "Try free with AWS" button leads customers to free trial offers or the product detail page.

Configuration Options:

  • Offer Type: Auto-detect free trial or specify offer ID
  • Free Trial Offer ID (optional): Specific free trial offer
  • Source URL (optional): Return URL after trial signup
  • Button Text: Customize button text (default: "Try free with AWS")
  • Enable/Disable: Toggle button on/off

To Generate Link:

  1. Select offer type (auto-detect or manual)
  2. Optionally enter free trial offer ID
  3. Optionally enter source URL
  4. Click Generate Link
  5. Review the generated URL
  6. Click Next to proceed

Free Trial Detection

If you have a free trial offer in AWS Marketplace, Automatum can automatically detect it. Otherwise, you can manually enter the free trial offer ID.

Step 3: Configure Private Offer Form ​

The private offer form collects buyer information for custom pricing requests.

Configuration Options:

  • Form Fields: Configure which fields to collect
    • AWS Account ID (required)
    • Email Address (required)
    • Name (optional)
    • Company (optional)
    • Phone (optional)
    • Additional Notes (optional)
  • Button Text: Customize button text (default: "Request private offer")
  • Notification Settings: Configure email recipients
  • Enable/Disable: Toggle form on/off

To Configure:

  1. Enable the form
  2. Configure form fields as needed
  3. Set up email notifications
  4. Customize button text
  5. Click Next to proceed

Form ID

A unique form ID is automatically generated when you enable the form. This ID is used in the embed code to connect the button to your form configuration.

Step 4: Configure Demo Request Form ​

The demo request form collects information from customers interested in a product demo.

Configuration Options:

  • Form Fields: Similar to private offer form
  • Button Text: Customize button text (default: "Request demo")
  • Notification Settings: Configure email recipients
  • Enable/Disable: Toggle form on/off

To Configure:

  1. Enable the form
  2. Configure form fields
  3. Set up email notifications
  4. Customize button text
  5. Click Next to proceed

Step 5: Review & Generate Final Code ​

Review all your configurations and generate the final embed code.

Review Summary:

  • ✅ Buy with AWS button configuration
  • ✅ Try free with AWS button configuration
  • ✅ Private offer form configuration
  • ✅ Demo request form configuration
  • ✅ Analytics script (enable/disable)

To Generate Final Code:

  1. Review all configurations
  2. Toggle analytics script if needed
  3. Click Generate Final Embed Code
  4. Copy the generated code
  5. Click Next: Branding Review

Analytics Script

The AWS Marketplace analytics script tracks button clicks and conversions. Enable it to get insights in AWS Marketplace Management Portal.

Step 6: Submit Branding Review ​

Before launching your Buy with AWS integration, AWS Marketplace requires a branding review and approval.

What You Need:

  • ✅ Final embed code (from Step 5)
  • ✅ Seller ID
  • ✅ Product ID
  • ✅ Integration URL (where you'll place the code)
  • ✅ Test/staging URL (optional)

How to Submit:

  1. Go to AWS Marketplace Management Portal

    • Log in to your seller account
    • Navigate to Support > Create Support Case

  2. Select Category

    • Choose: Commercial Marketplace → Buy with AWS → Branding Review

  3. Provide Required Information

    • Seller ID: Copy from Step 6 (or find in AWS Marketplace Management Portal > Settings > Account Setup)
    • Product ID: Your AWS Marketplace product ID
    • Integration URL: The URL where you'll implement the buttons
    • Test/Staging URL: If you have a staging environment
    • Embed Code: Paste your final embed code from Step 5

  4. Submit and Wait

    • AWS typically reviews within 5-7 business days
    • You'll receive email notification when approved or if changes are needed

After Approval:

  • Deploy embed code to your production website
  • Monitor analytics in AWS Marketplace Management Portal
  • Handle private offer and demo requests as they come in

Using the Embed Code ​

Where to Place the Code ​

Add the embed code to any page where you want Buy with AWS buttons to appear:

  • Product landing pages
  • Pricing pages
  • Feature pages
  • Documentation pages

Code Placement ​

  1. Analytics Script: Place in the <head> section of your HTML
  2. Form Embed Scripts: Place in the <head> section (loads automatically)
  3. Buttons: Place anywhere in the <body> where you want buttons to appear

Example HTML Structure ​

html
<!DOCTYPE html>
<html>
<head>
  <!-- Analytics Script -->
  <script type="text/javascript" src="https://bwa.marketplace.awsstatic.com/assets/partner.js"></script>
  
  <!-- Form Embed Script -->
  <script>
    (function() {
      const formId = 'your-form-id';
      const script = document.createElement('script');
      script.src = 'https://api.automatum.com/api/v1/buy-with-aws/form-embed.js?data-form-id=' + formId;
      script.setAttribute('data-form-id', formId);
      script.async = true;
      document.head.appendChild(script);
    })();
  </script>
</head>
<body>
  <!-- Your page content -->
  
  <!-- Buy with AWS Button -->
  <button
    data-awsmp-bwa-cta="BuyWithAws"
    data-awsmp-bwa-seller-id="your-seller-id"
    data-awsmp-bwa-product-id="your-product-id"
    onclick="window.open('your-buy-link', '_blank')"
    style="background-color: #FF9900; color: white; border: none; padding: 12px 24px; font-size: 16px; font-weight: 600; border-radius: 4px; cursor: pointer;">
    Buy with AWS
  </button>
  
  <!-- Request Private Offer Button -->
  <button
    data-awsmp-bwa-cta="RequestAPrivateOffer"
    data-awsmp-bwa-seller-id="your-seller-id"
    data-awsmp-bwa-product-id="your-product-id"
    data-automatum-form-id="your-form-id"
    style="background-color: white; color: #232F3E; border: 2px solid #232F3E; padding: 12px 24px; font-size: 16px; font-weight: 600; border-radius: 4px; cursor: pointer;">
    Request private offer
  </button>
</body>
</html>

Managing Your Integration ​

Updating Configuration ​

To update your Buy with AWS configuration:

  1. Go to Listings > Select listing > Buy with AWS
  2. Navigate to the step you want to update
  3. Make changes
  4. Click Next through all steps
  5. Regenerate final embed code in Step 5
  6. Update embed code on your website

Requesting Changes ​

If you need to make changes to your Buy with AWS integration after AWS approval:

  1. Minor Changes (button text, styling):

    • Update in Automatum wizard
    • Regenerate embed code
    • Update code on your website
    • No new AWS approval needed

  2. Major Changes (new button types, form changes):

    • Update in Automatum wizard
    • Regenerate embed code
    • Submit new branding review to AWS Marketplace
    • Wait for approval before deploying

Viewing Analytics ​

After deployment, view analytics in AWS Marketplace Management Portal:

  1. Log in to AWS Marketplace Management Portal
  2. Navigate to Insights > Marketing > Buy with AWS
  3. View metrics:
    • Button clicks
    • Page views
    • Conversions
    • Form submissions

Troubleshooting ​

Seller ID Not Found ​

Error: "AWS seller ID not found. Please configure AWS cloud account in organization settings."

Solution:

  1. Find your AWS Seller ID in AWS Marketplace Management Portal
  2. Go to Settings > Organization > Cloud Accounts
  3. Edit your AWS account
  4. Add Seller ID and save

Form Not Loading ​

Issue: Form modal doesn't open when clicking button

Solutions:

  • Verify form embed script is in <head> section
  • Check browser console for JavaScript errors
  • Ensure form ID matches between button and script
  • Verify API endpoint is accessible

Button Not Styled Correctly ​

Issue: Button doesn't match AWS branding guidelines

Solutions:

  • Use the exact styling from generated embed code
  • Don't modify button styles (they're AWS-compliant)
  • Ensure CSS isn't overriding button styles

Analytics Not Tracking ​

Issue: No data in AWS Marketplace analytics dashboard

Solutions:

  • Verify analytics script is included in <head>
  • Check that script loads (Network tab in browser)
  • Ensure data attributes are present on buttons
  • Wait 24-48 hours for data to appear

Best Practices ​

  1. Test Before Launch

    • Test embed code on staging environment
    • Verify all buttons work correctly
    • Test form submissions
    • Check analytics script loads

  2. Monitor Performance

    • Review analytics regularly
    • Track conversion rates
    • Monitor form submission rates
    • Respond to private offer requests promptly

  3. Keep Updated

    • Sync products regularly from AWS Marketplace
    • Update embed code when product changes
    • Review and update form configurations as needed

  4. Follow AWS Guidelines

    • Use approved button text only
    • Maintain AWS branding compliance
    • Don't modify required data attributes
    • Keep copy blocks in forms

Need Help? ​

FAQ ​

Do I need AWS approval for every change? ​

No, minor changes like button text or styling don't require new approval. Major changes (new button types, form structure changes) may require re-submission.

Can I use multiple buttons on the same page? ​

Yes, you can include multiple Buy with AWS buttons on the same page. Each button should have the appropriate data attributes.

How long does AWS branding review take? ​

Typically 5-7 business days. You'll receive email notification when complete.

Can I customize button styles? ​

Button styles are pre-configured to match AWS branding guidelines. Minor customizations are allowed, but major style changes may require AWS approval.

What happens to form submissions? ​

Form submissions are sent to the email addresses you configured in the wizard. You can also set up webhooks for programmatic handling.

Do I need to regenerate embed code after product updates? ​

If your product ID or seller ID changes, yes. Otherwise, the embed code remains valid.

Automatum GTM Platform

Copyright © 2026 Automatum