View a markdown version of this page

Virtual Deliverability Manager settings - Amazon Simple Email Service
SES deliverability settingsGlobal deliverability settings

Virtual Deliverability Manager settings

The Virtual Deliverability Manager Settings page provides controls for both SES deliverability and global deliverability. You can view or change settings at any time using the Amazon SES console or the AWS CLI.

SES deliverability settings

SES deliverability settings control engagement tracking and optimized shared delivery at the account level. You can also define custom settings at the configuration set level to override account-level defaults.

Changing SES deliverability settings using the Amazon SES console

To change SES deliverability settings using the Amazon SES console

  1. Sign in to the AWS Management Console and open the Amazon SES console at https://console.aws.amazon.com/ses/.

  2. In the left navigation pane, choose Settings under Virtual Deliverability Manager.

  3. To change Engagement tracking or Optimized shared delivery settings:

    1. In the Additional settings panel, choose Edit.

    2. Select the corresponding radio button to turn either feature on or off, and then choose Submit settings.

      Note

      Engagement tracking options that you define here or in Virtual Deliverability Manager's configuration set overrides, control whether or not to report opens and clicks in the Virtual Deliverability Manager dashboard; they do not affect event destination configurations that publish open and click events. For example, if you have engagement tracking disabled here, it will not disable the open and click event publishing you have set up in SES event destinations.

  4. (Optional) To define custom settings for how a configuration set uses engagement tracking and optimized shared delivery by overriding how they're defined in Virtual Deliverability Manager, reference Virtual Deliverability Manager options while creating or editing a configuration set.

  5. To disable Virtual Deliverability Manager:

    1. In the Subscription overview panel, choose Disable Virtual Deliverability Manager.

    2. In the Disable Virtual Deliverability Manager? pop-up window, enter Disable in the confirmation field, and then choose Disable Virtual Deliverability Manager.

  6. To reenable Virtual Deliverability Manager, see Getting started with Virtual Deliverability Manager.

Changing SES deliverability settings using the AWS CLI

You can use the PutAccountVdmAttributes and PutConfigurationSetVdmOptions operations in the Amazon SES API v2 to change your SES deliverability settings.

  • Enable or disable engagement tracking, optimized shared delivery, or both using an input file:

    aws --region us-east-1 sesv2 put-account-vdm-attributes --cli-input-json file://attributes.json

    In this example, where engagement tracking is ENABLED and optimized shared delivery is DISABLED, the input file looks similar to this:

    {
    "VdmAttributes": {
        "VdmEnabled": "ENABLED",
        "DashboardAttributes": {
            "EngagementMetrics": "ENABLED"
        },
        "GuardianAttributes": {
            "OptimizedSharedDelivery": "DISABLED"
        }
    }
}

    You can find more information about parameter values and related data types by linking from the VdmAttributes data type in the Amazon SES API v2 reference.

  • Define custom settings for how a configuration set will use engagement tracking and optimized shared delivery by overriding how they've been defined in Virtual Deliverability Manager:

    aws --region us-east-1 sesv2 put-configuration-set-vdm-options --cli-input-json file://config-set.json

    In this example, where a configuration set named example has both engagement tracking and optimized shared delivery enabled, the input file looks similar to this:

    {
    "ConfigurationSetName": "example",
    "VdmOptions": {
        "DashboardOptions": {
            "EngagementMetrics": "ENABLED"
        },
        "GuardianOptions": {
            "OptimizedSharedDelivery": "ENABLED"
        }
    }
}

    For more information about parameter values and related data types, see the VdmOptions data type in the Amazon SES API v2 reference.

  • To verify the outcome:

    aws --region us-east-1 sesv2 get-configuration-set --configuration-set-name example

  • Not specifying DashboardOptions or GuardianOptions options at the configuration set level results in your Virtual Deliverability Manager account-level settings applying to traffic sent through that configuration set.

Global deliverability settings

Global deliverability settings control domain monitoring, IP monitoring, and inbox placement testing. Global deliverability is enabled per region from the Virtual Deliverability Manager Settings page.

To manage global deliverability settings using the Amazon SES console

  1. Sign in to the AWS Management Console and open the Amazon SES console at https://console.aws.amazon.com/ses/.

  2. In the left navigation pane, choose Settings under Virtual Deliverability Manager.

  3. In the Global deliverability panel, you can:

    • Enable or disable global deliverability for the current region.

    • Choose Edit domains to select which of your verified sending domains to monitor.

For detailed instructions on enabling or disabling global deliverability, see Getting started with global deliverability. For more information about global deliverability features, see Global deliverability.