Amazon AWS SQS Connector Setup Guide

Amazon AWS SQS Connector Setup Guide

by akshata_yerdoor on ‎07-20-2017 07:43 PM - edited a week ago by (761 Views)

This article describes how to set up the AWS SQS connector in your Universal 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

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
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
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
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