Are there several authentication modes possible?

The only way to connect to the API is by using your AT Internet account credentials. When setting up an automatized process, your login:password can be base64 encoded.


How can I know if the data is available?

We recommend that you wait 10 minutes before you request the last given hour of data. Once extracted, you can check your file contains the last row #info:end. If it does, it means your file is complete.


Does Data Flow require specific tagging?

No specific or additional tagging is required to use Data Flow. It is a new feature for retrieving raw data which has already been collected.


Are group of sites available in Data Flow?

No, group of sites are not available in Data Flow.


Is it possible to replace “-” with “0”?

Data Flow retrieves raw data. A “-” character usually indicates a dimension is empty. The behavior cannot be changed in Data Flow, but you can apply this change in your own infrastructure after you have imported the data.


Is it possible to retrieve data history?

Data Flow provides data retention of 96 hours total. Data Flow is meant to work in stream mode and is not meant to retrieve data from the last weeks, months or years.


Is it possible to have “time spent per visit” and “page views per visit” metrics?

Both are available in the dimension format, giving ranges of information for each visit (example: page views per visit = between 2 and 5). However, the exact value in metric is not available, but this information can be calculated on the client side using the event position and the time stamp.


Is it possible to rename the header?

No, headers take the name of the dimensions available in our API. However, it is possible to rename the columns names in your own infrastructure.


What is the difference between “page position” and “event position”?

Page position applies to pages only; it gives you the chronological order in which pages have been loaded. The event position dimension takes into account page views and click events.


How does the timestamp work?

Unix time is a system for describing instants in time, defined as the number of seconds that have elapsed since Jan 1st 1970 midnight. For your convenience, the timestamp in Data Flow is already calculated to return the date based on you site’s server local time instead of UTC.

Example: Website ABC’s server is located in France (GMT+1). Website ABC’s employee calls the data flow event API which returns an event with a timestamp of 1511967867 in unix time. As Data Flow provides timestamps in server local time the event, therefore, happened at Wednesday, 29 November 2017 15:04:27 GMT+1 (Paris) or Wednesday, 29 November 2017 14:04:27 GMT.


How many simultaneous calls can a user make?

Data Flow’s API has a limit of 5 calls per user, thus a user can not submit over 5 calls at the same time. Each call is done one by one, if the 5 calls limit is exceeded, an error message will appear.

Last update: 23/03/2018