Getting Started

Setting Up

In order to set up your account, we need a few things:

• Create a user on Redshift. You need to create an account for Ironsource.atom in your Redshift cluster, and send us the details so we will be able to connect: user, password, url, dbname.
• Add our IPs to your security group. We will ask you to add some IP’s to your Redshift Security group and we are good to go.
• Grant us access to an S3 bucket. Provide us with an Access Key and a Secret Access Key with full access permissions to an S3 bucket.
• Create your Ironsource.atom account.

Sending Data to Ironsource.atom via http

We support single and batch events POST or GET requests.

Single Event POST Example

POST to http://track.atom-data.io

{
    "table": "cluster.schema.table_name",
    "data": "{\"name\": \"iron\", \"last_name\": \"source\"}",
    "auth": "THE SHA256 of the data using a pre-shared key"
}

Bulk event POST

The value of ‘data’ should be a stringified array and you should add ‘bulk’: true.

POST to http://track.atom-data.io/bulk

{
    "table": "cluster.schema.table_name",
    "data": "[\"{\"name\": \"iron\", \"last_name\": \"source\"}\"
            ,\"{\"name\": \"iron2\", \"last_name\": \"source2\"}\"]",
    "auth": "THE SHA256 of the data using a pre-shared key",
    "bulk": true
}

Single Event GET

GET track.atom-data.io?data=eyJ0YWJsZSI6Imluc3RhbGxjb3JlI=

where eyJ0YWJsZSI6Imluc3RhbGxjb3JlI= is base64 encoded stringified JSON (or stringified array of jsons).

HTTP Response Codes