/
App-Testtool Documentation

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.







Related pages