Log File Provision / Log File Provision Advanced¶

Service Description v3.0 | 23.05.2023

Would you like to continuously analyze and optimize your digital offering individually, or evaluate conspicuous features independently in order to optimally improve the content structures of your offering through transparent insight?

You'll receive data privacy-compliant raw log file data with various parameters, such as document referrer, browser type, and INFOnline-typical key figures like code and offer identifier.

In other words: You always have your raw data right in view!

Here, the log lines are expanded to include information on the device used - which means: even more information for you!

Scope of service¶

As part of the Logfile Preparation service, you are provided with raw logfile data that contains information about the measurement pulses that enter the measurement system for your digital offer. The following parameters are made available to you: document referrer, pixel referrer, browser type, resolution, device information, and the INFOnline-typical key figures such as code, offer identifier, comment, and survey invitation (if integrated).

As part of the Log File Provisioning Advanced service, the log files additionally contain information about the device used, i.e. the log file lines are expanded with the help of a Device Database (DDB).

The files are accessed via a web portal from which you can download the log files manually or automatically.

Order¶

The Log File Provisioning and Log File Provisioning Advanced services are ordered via the INFOnline Order Center. The service can be booked for any registered digital offering.

Provision¶

• The raw log data is provided via a web portal.
• In the setup or confirmation e-mail, the client receives the associated URL and the access data.
• A separate login is created for each digital offer.

The service as well as the mail with all necessary information will be provided within 3 working days.

Data availability¶

• For technical reasons, the log files are available with a delay of about 5 minutes.
• The log file data is stored for a maximum of 7 days, after which the data is the data is deleted from the system.
• A separate data backup outside this period does not take place.
• The availability of the log file provision is 99 percent.
• However, there is no entitlement to subsequent delivery of log file data in the event of technical failures.

Term¶

The service term applies from the time of setup until the service is terminated or the metering contract for the corresponding digital offer is terminated.

If the log file provision is set up before the 15th of a month, this month is counted as a full month. If the log file provision is set up after the 15th of a month, the term of the service begins on the 1st of the following month.

Cancellation¶

The notice period is always 4 weeks to the end of the quarter. It is sufficient to send an e-mail with the reason for termination to the following address: service@infonline.de. If you cancel the measurement of the digital offer, the service will automatically expire.

Costs¶

Invoicing takes place quarterly in advance.

The costs consist of a one-time setup fee of 100€ and an annual fee based on the following assessment basis:

The discount regulation is not applicable to the prices of the Logfile Provision and Logfile Provision Advanced services. All prices are exclusive of the statutory value added tax.

Technical information¶

Logfile delivery¶

The logfile data can be accessed at https://log.ioam.de/.

Using HTTP authentication via download, the data transfer is encrypted via SSL.

What do you receive?

• 5-minute time intervals in gzip format [offer identifier][end of log recording for this file as Unix timestamp].gz_.
• To be able to identify individual log files and enable automated processing, directory listing is explicitly allowed on the web server.

Logfile data¶

Data fields in log files of stationary offers, MEWs and apps.

The data fields in a log line are separated by the pipe symbol ("|", for data collected centrally by the measurement system) or ampersand ("&", for data collected by the measurement script "iam.js" or for data supplemented by the measurement system).

In the case of app measurement, additional data is transferred independently by the library (separated by "&") and provided in the log file line in JSON data format ("ae" or "mi").

For detailed information, please refer to chapter JSON Data Formats.

Example: Excerpt from log file for a stationary offer (up to INFOnline Measurement pseudonymous version 4.x)

1
2
3
4

1380279169.3429|193.46.63.0| |de.ioam.de|OK|000605e97501e61fd50f475930001
|st=infonlin&cp=sus&mg=yes&sv=in&co=ein%20Kommentar&pt=CP& ps=lin&er=N22&rf=www.infonline.de&r2=https%3A%2F%2Fwww.infonline.de %2Fde%2Fkunde‑werden%2F&ur=www.infonline.de&xy=1920x1080x24&lo= DE%2FNordrhein‑Westfalen&cb=0007&vr=3&id=qpc1so&lt=1380279168058&ev=&cs=z26cu9& mo=1&la=1380273421|i00=00145b9eb35278f965242b3dc0001%3B5242b4a4%3B53c79048
|Mozilla/5.0 (Windows NT 6.1; WOW64; rv:23.0) Gecko/20100101 Firefox/23.0
|https://www.infonline.de/de/service-support/|015|web|OK|OK

Example: Excerpt from log file for a stationary offer (INFOnline Measurement pseudonymous version 5.0.0 and higher)

1
2
3
4

1656669479.8712|93.239.151.0|  |83603c94.de.ioam.de|OK|0031b4618f3877d7e6257d3e80001
|id=38nnuh&i2=00155c9746b48337262bec4f2&dntt=0&ps=lin&i3=00155c9746b48337262bec4f2%3A1682581526226%3A1656661526226%3A.infonline.de%3A6%3Afoo%3Abar%3Anoevent%3A1656669485665%3Aw8evwq&lt=1656669485664&xy=2560x1440x24&lo=DE%2FNordrhein-Westfalen&vs=1.0.0&st=foo&dc=web&ct=0000810141&cn=de&pt=CP&cp=bar&ur=www.infonline.de&ap=0&ep=28657249&n1=102&cb=0015&fb=0&sc=yes&nt=2&tb=0&vr=5.0.0-beta.5&it=mm&cs=28e1cj&mo=1&la=1656661294&uahint=%22%20Not%20A%3BBrand%22%3Bv%3D%2299%22%2C%20%22Chromium%22%3Bv%3D%22102%22%2C%20%22Google%20Chrome%22%3Bv%3D%22102%22|i00=0031b4618f3877d7e6257d3e80001%3B62bea52e%3B639c56fc
|Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/102.0.0.0 Safari/537.36
|https://www.infonline.de/|049|web|OK|OK

Log file provision Advanced¶

The additional chargeable service "Advanced" extends the single logfile lines with information about the used device using the Device Database (DDB) of 51Degrees.

The enhancement of the log lines by the DDB information is composed as follows:

{"PlatformVersion": "10.0", "PlatformName": "Windows", "Browsername": "InternetExplorer", "DeviceType": "Desktop", "BrowserVersion": "7.0"}|DE/Nordrhein-Westfalen

Example: Excerpt from Logfile Advanced for a stationary offer (up to INFOnline Measurement pseudonymous version 4.x)

1
2
3
4
5
6
7
8
9

1380279169.3429|193.46.63.0| |de.ioam.de|OK|000605e97501e61fd50f475930001
|st=infonlin&cp=sus&mg=yes&sv=in&co=ein%20Kommentar&pt=CP& ps=lin&er=N22&rf=www.infonline.de&r2=https%3A%2F%2Fwww.infonline.de%2Fde%2Fkunde‑werden
%2F&ur=www.infonline.de&xy=1920x1080x24&lo=DE%2FNordrhein‑Westfalen&cb=0007&vr=3
&id=qpc1so&lt=1380279168058&ev=&cs=z26cu9&mo=1&la=1380273421|
i00=00145b9eb35278f965242b3dc0001%3B5242b4a4%3B53c79048
|Mozilla/5.0 (Windows NT 6.1; WOW64; rv:23.0) Gecko/20100101 Firefox/23.0
|https://www.infonline.de/de/service-support/|015|web|OK|OK 
{„PlatformVersion“: „10.0“, „PlatformName“: „Windows“, „Browsername“: „InternetExplorer“, 
„DeviceType“: „Desktop“, „BrowserVersion“: „7.0“}|DE/Nordrhein-Westfalen 

Example: Excerpt from Logfile Advanced for a stationary offer (INFOnline Measurement pseudonymous version 5.0.0 and higher)

1
2
3
4
5
6

1656669479.8712|93.239.151.0|  |83603c94.de.ioam.de|OK|0031b4618f3877d7e6257d3e80001
|id=38nnuh&i2=00155c9746b48337262bec4f2&dntt=0&ps=lin&i3=00155c9746b48337262bec4f2%3A1682581526226%3A1656661526226%3A.infonline.de%3A6%3Afoo%3Abar%3Anoevent%3A1656669485665%3Aw8evwq&lt=1656669485664&xy=2560x1440x24&lo=DE%2FNordrhein-Westfalen&vs=1.0.0&st=foo&dc=web&ct=0000810141&cn=de&pt=CP&cp=bar&ur=www.infonline.de&ap=0&ep=28657249&n1=102&cb=0015&fb=0&sc=yes&nt=2&tb=0&vr=5.0.0-beta.5&it=mm&cs=28e1cj&mo=1&la=1656661294&uahint=%22%20Not%20A%3BBrand%22%3Bv%3D%2299%22%2C%20%22Chromium%22%3Bv%3D%22102%22%2C%20%22Google%20Chrome%22%3Bv%3D%22102%22|i00=0031b4618f3877d7e6257d3e80001%3B62bea52e%3B639c56fc
|Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/102.0.0.0 Safari/537.36
|https://www.infonline.de/|049|web|OK|OK
{„PlatformVersion“: „10.0“, „PlatformName“: „Windows“, „Browsername“: „InternetExplorer“, 
„DeviceType“: „Desktop“, „BrowserVersion“: „7.0“}|DE/Nordrhein-Westfalen 

Explanation of the data fields¶

Additional data fields in log file provision Advanced¶

Explanation of the status code¶

JSON data fields in app log files¶

Example: Excerpt from log file for an app

1
2
3
4
5

1349866706.1954|193.46.63.0| |de.ioam.de|OK E1|57d09c28fa217aefe182752f679c1230000|
ae={"library":{"configVersion":"1.1","libVersion":"1.0.0","debug":true,"offerIdentifier" :"iamtest"},"application":"package":"com.infonline.testapp","versionCode":1,"versionName" :"1.0"},"protocolVersion":1,"client":{"platform":"samsung,Galaxy Nexus,maguro,google, tuna,yakju","screen":{"size":2,"dpi":320,"resolution":"720x1184"},"osVersion":"4.1.1", "osIdentifier":"android","uuids":"androidId":"7c607f21b570e99fe9f8d1c6ef8606d", "installationId":"3e35412c254769ea2d829bf6de29f0ba",
"wifiMac":"543e8f2c6960651119652a45ce44cd24","imei":"57d09c28fa217aefe182752f679c123"},"carrier":"Telekom.de",
"language":"de","network":1,"country":"DE"},"stats":{"overallDroppedEvents":0},"events":{"timestamp":1349866705,"state":"disappeared","ad":0,“comment”:”einKommentar”,"paid":0,"category":"mainscreen","identifier":
"view","network":1}}&ie=57d09c28fa217aefe182752f679c123&st=iamtest&lt=1349866705&ev=view-disappeared&cp=mainscreen&co=einKommentar&xy=720x1184x| |Dalvik/1.6.0 (Linux; U; Android 4.1.1; Galaxy Nexus Build/JRO03C)| |002|app|OK|ERR

Example: Excerpt from Logfile Advanced for an app

1
2

1349866706.1954|193.46.63.0| |de.ioam.de|OK E1|57d09c28fa217aefe182752f679c1230000|
mi={"library":"configVersion":"1.1","libVersion":"1.0.0","debug":true,"offerIdentifier" :"iamtest","customerData":"xyz","debug":true}, "application":{"package":"com.infonline.testapp","versionCode":1,"versionName":"1.0"} ,"protocolVersion":1,"client":{"platform":"samsung,Galaxy Nexus,maguro,google,tuna,yakju" , "screen":{"size":2,"dpi":320,"resolution":"720x1184"},"osVersion":"4.1.1","osIdentifier" :"android","uuids":"androidId":"7c607f21b570e99fe9f8d1c6ef8606d","installationId": "3e35412c254769ea2d829bf6de29f0ba","wifiMac":"543e8f2c6960651119652a45ce44cd24","imei" :"57d09c28fa217aefe182752f679c123"},"carrier":"Telekom.de","language":"de", "network":1,"country":"DE"},“stats”:{"overallDroppedEvents":0},"events":{"timestamp":1349866705,"state":"disappeared","ad":0,“comment”:”einKommentar”,"paid":0, "category":"mainscreen","identifier":"view","network":1}}&ie=57d09c28fa217aefe182752f679c123 &st=iamtest&lt=1349866705&ev=view-disappeared&cp=mainscreen&co=einKommentar&xy=720x1184x | |Dalvik/1.6.0 (Linux; U; Android 4.1.1; Galaxy Nexus Build/JRO03C)| |002|app|OK|ERR| {"PlatformVersion": "4.1.1", "PlatformName": "Android", "BrowserName": "Android", "DeviceType": "SmartPhone", "BrowserVersion": "4.1.1"}| DE/Nordrhein-Westfalen

Example: Value of "ae" for an app on Android (reformatted for better readability).

Example: Value of "mi" for an app on iOS (reformatted for better readability).

Explanation of JSON data¶

Collected by Messlibrary