The Collector is a stateless Docker image that can be deployed on any infrastructure that supports Docker.

You can scale it horizontally by deploying multiple instances of the collector.

It also acts as a 1st party tracking server, that rewrites the cookies server-side to prevent tracking blockers.

For that reason, if your website is hosted at www.example.com, you should deploy the collector on a sub-domain like go.example.com.

An URL shortener will be added very soon to handle your digital marketing campaigns redirections (i.e: click from a newsletter…). So choose your sub-domain wisely.

​
Deployment

The Docker image is available on Docker Hub and can be pulled with the following command:

docker pull rimdian/collector:latest

​
Env variables

All the following environment variables are required to run the data Collector.

PropertyDescriptionExample
ENVThe environment the collector is running in.development or test or production
COLLECTOR_PORTThe port the collector will listen on.8080
API_ENDPOINTThe hostname of the exposed API server.rimdian.mybusiness.com
SECRET_KEYThe secret key for signing data.my-very-complex-secret-key
GCLOUD_PROJECTThe Google Cloud project ID, that the Task Queue is associated with.my-project
GCLOUD_JSON_CREDENTIALSThe JSON credentials for the Google Cloud project.{ "type": "service_account", "project_id": "my-project"... }
TASK_QUEUE_LOCATIONThe location of the Task Queue for data imports.europe-west1
OverviewServer