Amazon AWS SQS Connector Setup Guide

[#1]

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

• AWS Account
• Required: sqs:SendMessage permission
• Optional: sqs:ListQueues permission
• Queue to send data to

Connector Actions

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

Configure Settings

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.

Action Settings - Parameters and Options

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.

Action - Send Event Data to Queue

Parameters

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

See Using Amazon SQS Message Attributes

Action - Send Visitor Data to Queue

Parameters

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

Action - Send Customized Data to Queue (Advanced)

Parameters

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

Vendor Documentation

• Access Control for Amazon SQS
• Switching to an IAM Role
• How to Use an External ID
• Using Amazon SQS Message Attributes
• How Amazon SQS Queues Work