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.
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.
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.
No, group of sites are not available in Data Flow.
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.
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.
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.
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.
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.
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.
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.