Server-Side Connectors

This article describes how to set up the AWS SQS connector in your Customer Data Hub account.

In this article:

Table of Contents Placeholder

Amazon SQS provides fully-managed message queues for micro-services, distributed systems, and server-less applications.

Requirements

Action Name	AudienceStream	EventStream
Send Event Data to Queue	✗	✓
Send Visitor Data to Queue	✓	✗
Send Customized Data to Queue (Advanced)	✓	✓

Go to the Connector Marketplace and add a new connector. Read the Connector Overview article for general instructions on how to add a connector.

After adding the connector, configure the following settings:

Access Key
- Required
- Provide your IAM User's access keyAssociated IAM policy (for either IAM User or Assumed Role)
- Must grant 'sqs:SendMessage' permission.
- For additional information, see Access Control for Amazon SQS.
Secret Key
- Required
- Provide your IAM User's secret key
Region
- Required
- Select region
Assume Role: ARN
- Optional
- Provide Amazon Resource Name (ARN) of role to assume.
  For example: arn:aws:iam::222222222222:role/myrole
- For additional information, see Switching to an IAM Role.
Assume Role: Session Name
- Optional.
- Provide identifier for assumed role session
Assume Role: External ID
- Optional
- Provide external identifier
- For additional information, see How to Use an External ID.

Click Next or go to the Actions tab. This is where you configure connector actions.

The following sections describe how to set up parameters and options for each action.

Parameter	Description
Queue	Required Select queue to send data to If your IAM policy does not grant 'sqs:ListQueues' permission, you will need to manually enter a Custom Value Custom values should be a URL For example: `https://sqs.us-west-2.amazonaws.com/0123456789/queue_name`
MessageGroupId
DelaySeconds
Print Attribute Names	If attribute names are updated, the names in the payload will reflect the update

Parameter	Description
Queue	Required Select queue to send data to If your IAM policy does not grant 'sqs:ListQueues' permission, you will need to manually enter a Custom Value Custom values should be a URL For example: `https://sqs.us-west-2.amazonaws.com/0123456789/queue_name`
MessageGroupId
DelaySeconds
Include Current Visit Data
Print Attribute Names	If attribute names are updated, the names in the payload will reflect the update

Parameter	Description
Queue	Required Select queue to send data to If your IAM policy does not grant 'sqs:ListQueues' permission, you will need to manually enter a Custom Value Custom values should be a URL For example: `https://sqs.us-west-2.amazonaws.com/0123456789/queue_name`
MessageGroupId
DelaySeconds
Custom Message Definition
Message Template Variables	Optional: provide template variables as data input for templates For more information, see the Template Variables Guide Name nested template variables with the dot notation (Example: items.name) Nested template variables are typically built from data layer list attributes
Message Templates	Optional: provide templates to be referenced in either URL, URL Parameter, Header or Body Data (see: Templates Guide) Templates are injected by name with double curly braces into supported fields Example: `{{SomeTemplateName}})`

See Using Amazon SQS Message Attributes