Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Contents on this page

Table of Contents

GET /realtime-data-export

Provides a list of all realtime data exports associated with the authenticated user's account.

GET /realtime-data-export?id=[id]

Provides information about a specific realtime data export.

DELETE /realtime-data-export?id=[id]

Deletes a specific realtime data export.

POST /realtime-data-export

Description

Create a Realtime Data Export stream

Endpoint

/realtime-data-export

Method

POST 

Parameters

NameTypeRequiredDescription
titlestringY 
settingsstringYJSON string. Possible options for this are explained below. This must be url encoded.

...

NameTypeRequiredDescription
outputsarrayYSee details below
rulesarrayYSee details below
fieldsarrayYFor a possible option, check the Column Names in this link: Log Format

  

Outputs

The output is where the data will be exported to. The possible options per output can be found below.

...

NameTypeRequiredDescription
accessKeystringYThe AWS Access Key
accessSecretstringY

The AWS Secret

regionstringYThe AWS region
streamNamestringYTo which Kinesis stream the data should be sent.

PubSub

NameTypeRequiredDescription
projectIdstringY 
topicIdstringYThe PubSub topic
jsonKeystringYGoogle JSON key (string) that has permissions to produce to PubSub

HTTPS

NameTypeRequiredDescription
endpointstringYTo which endpoint the data should be outputted.
secretstringYThe secret of this endpoint.

BigQuery

NameTypeRequiredDescription
projectIdstringY 
datasetNamestringY 
tablePrefixstringY 
jsonKeystringYGoogle JSON key (string) that has permissions to produce to BigQuery, create datasets, etc.

 

Please refer to the section authentication for the auth and csrf tokens.

Rules

NameTypeRequiredDescription
idstring 

Can be either:

  • pixel_id
  • geo_country
  • event_type
  • interaction_type
comparatorstring 

Can be either:

  • equals
  • =
  • notequals
  • !=
  • contains
  • doesnotcontains
  • after
  • >
  • half
  • end
  • >=
  • before
  • <
  • <=
  • between
valuestring Comma separated list of acceptable values
typestring 

Can be either:

  • dimension
  • measure

PubSub

NameTypeRequiredDescription
projectIdstringY 
topicIdstringYThe PubSub topic
jsonKeystringY  

HTTPS

NameTypeRequiredDescription
endpointstringYTo which endpoint the data should be outputted.
secretstringYThe secret of this endpoint.

...

BigQuery

NameTypeRequiredDescription
projectIdstringY 
datasetNamestringY 
tablePrefixstringY 
jsonKeystringY 

Example JSON

Code Block
languagejs
{
	"outputs": {
		"type": "bigquery",
		"settings": {
			"projectid": "test-1234",
			"datasetName": "test",
			"tablePrefix": "test",
			"jsonKey": "{\"a\":\"b\"}"
		}
	},
	"rules": [{
		"id": "pixel_id",
		"type": "dimension",
		"comparator": "=",
		"value": "12345"
	}],
	"fields": ["pixel_id", "uuid"]
}

 

Please refer to the section authentication for the auth and csrf tokens.