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
      • (warning) iOS 5 or lower: the MAC address
      • (warning) 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 ((warning) 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)
  • 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

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)
    • (warning) Please insert the device ID given by the device and NOT the one send by the library within the HTTP-request!
    • (warning) Please insert the MAC address in case of iOS only with upper case letters
    • (warning) 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
  • (warning) 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.