•

OnDevice Facebook User Manual

Contents

1 Overview 2
1.1 Features .......................................................................................................... 2

2 Prerequisites 3
2.1 Facebook Account ........................................................................................... 3
2.1.1 Creating a Facebook Account ......................................................... 3
2.1.2 Granting Permissions to the Facebook Account ............................. 3
2.2 Phone Setup .................................................................................................... 7

3 Activity Configuration 8
3.1.1 Sample Script ................................................................................... 8
3.1.2 Facebook Logon .............................................................................. 8
3.1.3 Facebook ......................................................................................... 8
3.1.4 Facebook Logoff .............................................................................. 9

4 Information Elements & Events 10

4.1 Measurement Trigger ....................................................................................10
4.2 Events............................................................................................................10
4.3 Information Elements ....................................................................................11

5 Highlights 12
5.1 Limitations .....................................................................................................12
5.2 Potential Issues .............................................................................................12

NT16-51389, 0.2, 1/4/2016 1

 •

1 Overview
1.1 Features
Features Description

1 Post Photo Post a photo

2 Post Status Post a status update in the form of plain text

3 Load Feeds Load Facebook feeds

4 Load Friend Lists Load groupings of Facebook friends

NT16-51389, 0.2, 1/4/2016 2

 •

2 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.
 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.

2.1.2 Granting Permissions to the Facebook Account

2.1.2.1 Installing the Facebook Utility App

Instruction Screen shot
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.

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 3

 •

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 4

 •

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

2.1.2.2 Granting Facebook Permissions

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

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 5

 •

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 6

 •

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 7

 •

3 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 8

 •

Property Description

Operation Action to perform as a Facebook user.

 Post Photo
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%.
 Post Status
o Post a status update in the form of plain text. Enter the text
string to post under Status.
 Load Feeds
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 Load groupings of Facebook friends (created by someone or
generated automatically, such as “Close Friends”,
“Acquaintances”, “Family”).

3.1.4 Facebook Logoff

Logs off from a Facebook account.
This activity has no unique properties.

NT16-51389, 0.2, 1/4/2016 9

 •

4 Information Elements & Events

4.1 Measurement Trigger
Trigger Point Abstract Description Technical Description

Tr-1 Send logon request First HTTP request sent to Facebook server.

Logged on to Facebook Received Facebook session opened status with a valid access
Tr-2
token

Send operation request First HTTP request sent to Facebook server on the dedicated
Tr-3
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.

4.2 Events
Events Description Start End
Trigger Trigger

Facebook Logon Start Logon script activity started. - -

Facebook Logon Logon request sent to Facebook server.

Tr-1 -
Attempt

Facebook Logon Logon finished when active session with valid access
Tr-1 Tr-2
Duration token is opened.

Facebook Logon Error Failure to retrieve access token. Tr-1 Tr-2

Facebook Logon End Logon script activity ended. - -

Facebook Operation Script activity started.

- -
Start

Facebook Operation Request sent from OnDevice Facebook Service.

Tr-3 -
Attempt

Facebook Operation Operation successfully completed.

Tr-3 Tr-4
Duration

Facebook Operation Operation failed.

Tr-3 Tr-4
Error

Facebook Operation Script activity ended.

- -
End

Facebook Logoff Start Logoff script activity started. - -

Facebook Logoff Close and clear token information sent from OnDevice
Tr-5 -
Attempt Facebook Service.

Facebook Logoff Logoff finished when Facebook session closed.

Tr-5 Tr-6
Duration

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

 •

5 Highlights
5.1 Limitations
Limitations

1 Parallel Facebook activity is NOT supported.

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

3 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 20–30 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

1 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.

2 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