Functional Testing for the Mobile Application Measurement

Introduction

You can check the integration of Mobile App Sensors on this web service with your simulator or a real mobile device.

Using mobile Identifier

Log on to the web interface by using the device ID of your test device and the name of your app (<application>).
- in case of IOS, please use the MAC address or Advertising ID
  - iOS 5 or lower: the MAC address
  - iOS 6 or 7: the Apple Advertising ID
- in case of Android, please use the Device-ID (DID) or the Android-ID (AID)

You can read your device ID (MAC address, Advertising ID, DID, AID) with the help of free apps, that can be downloaded from the respective app store.

App Lifecycle Events

The display shows 5 traffic lights, which check whether all required events are available
[STARTED, FOREGROUND, BACKGROUND, CLOSED ( not in case of iOS), Page Requests]

The Mobile App Sensor enables the developers to transmit different actions to the systems (variable ac):

- spring.STARTED → (app was started by a user)
- spring.FOREGROUND → (app is in the foreground)
- spring.BACKGOUND → (app was put in the background)
- spring.CLOSED → (app was closed by the user)
- Page requests/page impressions in apps (example in Mobile App Sensor Documentation)

Test advise

Each app should be tested with at least two devices. One of these devices may be a simulator.

Procedure

Please use a html5-capable browser
Please enable Java Script
We recommend the use of Mozilla Firefox

Using the Tool

Necessary Input into the Fields

Enter on the home page
- in field 1 → your application name (given in variable <app>)
- in field 2 → your device ID. (The test, however, works only if field 2 is filled.)
- in field 3 → Sitename / Client-ID. (provided by TNS)
Select the operating system of your app

KASRL - Public Space > App-Testtool Documentation > Mobile_App_Test.PNG

Please insert the device ID given by the device and NOT the one send within the HTTP-request!

Please insert the MAC address in case of iOS only with upper case letters

Please insert "ssl-[sitename/client-id]" in field 3, if your app is operating on HTTPS

Steps

Click the button "Start test"
Now start on your test device or simulator the app to be tested
Put the app in the foreground and in the background
Close the app
Navigate within your app and send some page requests
Every time an action is properly transferred to the measuring system, the corresponding traffic light turns green
Details of the events can be seen by clicking on the button "View requests"
If all the required events have been transferred correctly, all the traffic lights are green and the button "Submit to spring" will be activated
If this is not the case, adjust your implementation and run the test again
By clicking on the button "Submit to spring" your mail program will open and an email with your test results can be transmitted
Send these results to the preset email address "ka_de_support@kantarmedia.com"
we will examine the results and gives you via email the release for publication into the respective app store.
(This examine can take several days to complete.)

Information

Please inform immediately Kantar TNS by email, when your app is available in the store or market place .

Each app should be tested with at least two devices. One of these devices may be a simulator
Use only the application name (<application>) assigned to you by TNS. The format here is always appname/OS
It is always recommended to use the latest library
Without the release the approval process for the Mobile App Sensor is not completed
The app may not be published into the respective store or market place without the release.

FAQ

If the app testing tool does not work, please try the following:

Refresh the page
Use a html5-capable browser
Enable Java Script
Check that you have entered the correct device ID (e.g. typos)
- Please insert the device ID given by the device and NOT the one send by the library within the HTTP-request!
- Please insert the MAC address in case of iOS only with upper case letters
- Try using the Android ID instead of the DID
Check that you entered the correct application name (supplied by TNS)
Let field 1 (Application Name) empty
To rule out that your own safety regulations will block the requests, browse to the tool via the SIM card instead of wireless or use a different wireless network.
Please ensure that WebSockets is not being blocked by a firewall.
http://en.wikipedia.org/wiki/WebSocket
Please insert "ssl-[sitename/client-id]" in field 3, if your app is operating on HTTPS

In some particular cases (e.g. Android), we know - even when properly implemented - the App Test Tool shows no reaction. In these cases, set the library in debug and send us the log output.

In case of any questions please contact Support.