Amazon AWS SQS Connector Setup Guide

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

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

Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article.

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

Action settings - parameters and ptions

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. For example, {{SomeTemplateName}}).

See Using Amazon SQS Message Attributes

Vendor Documentation

Was this page helpful?

This page was last updated: January 23, 2020