App-Testtool Documentation
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)
- in case of IOS, please use the MAC address or Advertising ID
- 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
INFORMATION
- 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)
- in field 1 → your application name (given in variable <app>)
- Select the operating system of your app
Indication
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 .
Indication
- 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
FAQ
- 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.