OnDevice Facebook User Manual

Contents
1

Overview
1.1

2.2

Features .......................................................................................................... 2

Prerequisites
2.1

Facebook Account ........................................................................................... 3

2.1.1

Creating a Facebook Account ......................................................... 3

2.1.2

Granting Permissions to the Facebook Account ............................. 3

Phone Setup .................................................................................................... 7

Activity Configuration

3.1.1

Sample Script ................................................................................... 8

3.1.2

Facebook Logon .............................................................................. 8

3.1.3

Facebook ......................................................................................... 8

3.1.4

Facebook Logoff .............................................................................. 9

Information Elements & Events

10

4.1

Measurement Trigger ....................................................................................10

4.2

Events............................................................................................................10

4.3

Information Elements ....................................................................................11

Highlights

12

5.1

Limitations .....................................................................................................12

5.2

Potential Issues .............................................................................................12

NT16-51389, 0.2, 1/4/2016

Overview

1.1

Features
Features

Description

Post Photo

Post a photo

Post Status

Post a status update in the form of plain text

Load Feeds

Load Facebook feeds

Load Friend Lists

Load groupings of Facebook friends

NT16-51389, 0.2, 1/4/2016

Prerequisites

2.1

Facebook Account

In order to perform Facebook testing, you need to:

Create a Facebook account.

Install and run a special Ascom app from which you grant the on-device
Facebook service permission to perform the operations to be tested (post status,
post photo, etc.)

2.1.1

Creating a Facebook Account

1.

First create an email account. Gmail (mail.google.com) or Outlook

(www.outlook.com, www.live.com) is recommended.

2.

Then register a Facebook account using the email just created.

2.1.2
2.1.2.1

For Gmail, you must complete the whole sign-up process, confirming
the email address by clicking the Confirm Now button on the top bar,
as shown in the screenshot below. On the screen that follows, click
Accept. Then log out from Facebook.

For Outlook, the above is not needed. Just log out from Facebook
once registered.

For other email services, different behavior might occur.

Granting Permissions to the Facebook Account

Installing the Facebook Utility App

Instruction
Step 1:
Download the apk from
https://www.dropbox.com/s/ae7e7frzy
9v0m2i/OnDeviceFacebookUtility.apk
or browse to the OnDevice folder on
the external storage of your Android
device, and click the file
OnDeviceFacebookUtility.apk.

Screen shot

If the message below appears, click

the Settings button and proceed with
the next step. Otherwise, skip to step
4.

NT16-51389, 0.2, 1/4/2016


Step 2:
Under Security, check the Unknown
sources option.

Step 3:
On the next screen, click OK.

Step 4:
Now click the Install button, and the
installation will start.

NT16-51389, 0.2, 1/4/2016


Step 5:
Upon successful installation, you
should see this screen. Click Done to
finish.

2.1.2.2

Granting Facebook Permissions

Instruction
Step 1:
Locate and click the icon for the
OnDeviceFacebookUtility app.

Screen shot

Step 2:
Click the Logon button.

Step 3:
Enter your Facebook account logon
detail and click on Submit button.
Wait for few seconds (depending on
your network condition) until you see
screen shown in next step.
Remarks:
If you see a pop up saying Logon
failed. Please verify your account at
www.facebook.com, you might have
encountered Facebook security
check, identity verification, etc. Please
manually logon to your account from
Facebook website and clear all the
verification until you can logon
successfully without any blockage.
Then, retry Step 3 again.

NT16-51389, 0.2, 1/4/2016


Step 4:
Enter your Facebook account logon
detail again to logon to Facebook.

Step 5:
Click the OK button to accept it.

Step 6:
Click the OK button to accept it.

NT16-51389, 0.2, 1/4/2016


Step 7:
Log out from your Facebook account
by clicking the Logout button.

Step 8 (Optional):
If you wish to uninstall the app, locate
this app as shown here in the
Application Manager and uninstall it.

2.2

Phone Setup

No particular setup is required on the device.

NT16-51389, 0.2, 1/4/2016

Activity Configuration

3.1.1

Sample Script

Sample Script

Sample Script Screenshot

Facebook.tsc

3.1.2

Facebook Logon

Logs on to a Facebook account. This account must have been set up in advance and
registered as a test account so that it can allow the on-device service to perform the
actions done with the Facebook activity. Regarding this registration, see the Device
Configuration Guide, section 2.1.
Property

Description

User Name

User name of the Facebook account.

Password

User password of the Facebook account

3.1.3

Facebook

Performs a user action while logged on to a Facebook test account (compare the
Facebook Logon activity).
Be aware that the data fetched by the load operations is not saved and cannot be
inspected in TEMS Investigation.
It is not possible to run multiple Facebook activities concurrently using a Parallel
construct.

NT16-51389, 0.2, 1/4/2016

Property

Description

Operation

Action to perform as a Facebook user.

Post Photo
o

Post Status
o

Load Facebook feeds. Under Feed Type, Default means

all feed types: Links, Posts, Statuses, and Tagged.
Alternatively, you can choose to load only one type of feed.

Load Friend Lists

o

3.1.4

Post a status update in the form of plain text. Enter the text
string to post under Status.

Load Feeds
o

Post a photo. Photo Source is one of the following

predefined images: Big Image (3840 3840 pixel, original
size about 7 MB), Medium Image (1920 1920 pixel,
original size about 2.6 MB), or Small Image (960 960
pixel, original size about 0.7 MB). Be aware that Facebook
will compress uploaded images by up to 80%.

Load groupings of Facebook friends (created by someone or

generated automatically, such as Close Friends,
Acquaintances, Family).

Facebook Logoff

Logs off from a Facebook account.

This activity has no unique properties.

NT16-51389, 0.2, 1/4/2016

Information Elements & Events

4.1

Measurement Trigger

Trigger Point

Abstract Description

Technical Description

Send logon request

First HTTP request sent to Facebook server.

Logged on to Facebook

Received Facebook session opened status with a valid access

token

Send operation request

First HTTP request sent to Facebook server on the dedicated

endpoint.

Tr-4

Operation completed

Received success response.

Tr-5

Send logoff request

Clear session token.

Tr-6

Logged off from Facebook

Received Facebook session closed status.

Tr-1
Tr-2

Tr-3

4.2

Events

Events

Description

Facebook Logon Start

Logon script activity started.

Facebook Logon
Attempt

Logon request sent to Facebook server.

Facebook Logon
Duration

Start
Trigger

End
Trigger

Tr-1

Logon finished when active session with valid access

token is opened.

Tr-1

Tr-2

Facebook Logon Error

Failure to retrieve access token.

Tr-1

Tr-2

Facebook Logon End

Logon script activity ended.

Facebook Operation
Start

Script activity started.

Facebook Operation
Attempt

Request sent from OnDevice Facebook Service.

Tr-3

Facebook Operation
Duration

Operation successfully completed.

Tr-3

Tr-4

Facebook Operation
Error

Operation failed.

Tr-3

Tr-4

Facebook Operation
End

Script activity ended.

Facebook Logoff Start

Logoff script activity started.

Facebook Logoff
Attempt

Close and clear token information sent from OnDevice

Facebook Service.

Tr-5

Facebook Logoff
Duration

Logoff finished when Facebook session closed.

Tr-5

Tr-6

Facebook Logoff Error

Logoff failed.

Tr-5

Tr-6

Facebook Logoff End

Logon script activity ended.

NT16-51389, 0.2, 1/4/2016

10

4.3

Information Elements

Information Elements

Description

Facebook Logon Success Ratio

Success rate for Facebook Logon.

Facebook Operation Success Ratio

Success rate for Facebook Operations (all types of user actions taken
together).

Facebook Logoff Success Ratio

Success rate for Facebook Logoff.

NT16-51389, 0.2, 1/4/2016

11

Highlights

5.1

Limitations
Limitations

Parallel Facebook activity is NOT supported.

NOT support to run in parallel with any activity that uses HTTP protocol.

For a regular Facebook account, a limit is imposed on the frequency of posting. This limit is not
constant but adapts to the pattern of user activity; the account will typically be blocked if more
than 2030 posts are made within a short period of time.
To escape this limitation, it is necessary to register the Facebook account as a test user. For
assistance in this task, please contact Ascom technical support.

5.2

Potential Issues
Potential Issues

Facebook Logon operation is tightly coupled with the Facebook Logon request flow. Any
changes made on the flow or request parameters will break the Facebook Logon functionality.

Frequent logon/logoff/posting might be deemed as suspicious illegal activities (i.e. spamming or

hacking) by Facebook. When this happens, the Facebook account might be banned or locked
by Facebook.

NT16-51389, 0.2, 1/4/2016

12