AWS SNS

Use this page to connect Ours Privacy to Amazon SNS. Each event publishes to your SNS topic in real time, so you can fan it out to SQS queues, Lambda functions, and HTTP subscribers and trigger your own downstream processing.

Before you start

• An AWS account with an SNS topic to publish to (standard or FIFO).
• The topic's region and ARN.
• Permission for Ours Privacy to publish to the topic. The setup uses a cross-account IAM role — contact support@oursprivacy.com and we'll share the trust policy to attach.

Setup

1. Open the Destinations page and add a new AWS SNS destination.
2. Enter the following:
   • Region — the AWS region your topic lives in.
   • Topic ARN — the ARN of the topic to publish to. FIFO topics (ARN ending in .fifo) are supported; events are grouped by visitor so ordering is preserved per visitor.
   • Role ARN — the IAM role that grants Ours Privacy permission to publish.
3. Save the destination and publish a new version to start sending events.

Event format

Each event is published as a JSON message with the event, visitor, and user records:

{
  "event": {
    "event": "Order Completed",
    "event_properties": {
      "order_id": "12345",
      "total": 99.99
    }
  },
  "visitor": {
    "visitor_id": "visitor_123",
    "first_seen_at": "2024-01-01T00:00:00Z",
    "email": "example@example.com"
  },
  "user": {
    "external_id": "user_456",
    "email": "example@example.com"
  }
}

Delivery guarantees

Events are delivered with at least once semantics — each event may arrive one or more times due to network retries or transient failures. To process events idempotently, deduplicate on visitor.visitor_id and/or event.distinct_id. These identifiers stay consistent across duplicate deliveries of the same event.

Next steps

• Destination overview — how destinations fit into the event pipeline.
• Data mapping — control which events and properties are sent.
• AWS Lambda destination and AWS Kinesis destination — other real-time AWS destinations.

Need help?

Reach out to support@oursprivacy.com.