Orchestrating Network Performance

OnDevice Instagram User Manual

Contents

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

2 Prerequisites 3
2.1 Application Registration................................................................................... 3
2.2 Creating Sandbox Users ................................................................................. 8
2.3 Phone Setup ..................................................................................................10

3 Activity Configuration 11
3.1.1 Sample script .................................................................................11
3.1.2 Instagram Logon ............................................................................11
3.1.3 Instagram .......................................................................................11
3.1.4 Instagram Logoff ............................................................................12

4 Information Elements & Events 13

4.1 Measurement Trigger ....................................................................................13
4.2 Events............................................................................................................13
4.3 Information Elements ....................................................................................14

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

TEMS™ – now part of InfoVista www.infovista.com | www.tems.com | 1

OnDevice Instagram User Manual, Version 1.1
 Orchestrating Network Performance

1 Overview
1.1 Features
Features Description

1 Logon Logon with an Instagram account. The operation is considered

success if the access token is successfully retrieved.

2 Load Feeds Load the Instagram feeds of the account logged on with. The
operation is considered success if any feeds is successfully
retrieved. Any photos related to the feeds will be downloaded.

3 Search By Hashtag Search for recently tagged media based on the hashtag
provided. The operation is considered success if any feeds
related to the hashtag is successfully retrieved. Any photos
related to the feeds will be downloaded.

4 Logoff Logoff from previously logged on Instagram account. The

operation is considered success if the access token is
successfully discarded.

TEMS™ – now part of InfoVista www.infovista.com | www.tems.com | 2

OnDevice Instagram User Manual, Version 1.1
 Orchestrating Network Performance

2 Prerequisites
2.1 Application Registration
In order to perform Instagram testing, first you need to register your app with Instagram
to get the app/client id.
First, make sure a valid email account is available. Create one if necessary.
Then register an Instagram account using the Instagram app on your Android device
and a valid email address.

Once you have a valid Instagram account, browse to the Instagram developer website
and logon at https://www.instagram.com/accounts/login/?next=%2Fdeveloper%2F.

TEMS™ – now part of InfoVista www.infovista.com | www.tems.com | 3

OnDevice Instagram User Manual, Version 1.1
 Orchestrating Network Performance

After logging on, at the Instagram developer website, click on the ‘Register Your
Application’ button.

TEMS™ – now part of InfoVista www.infovista.com | www.tems.com | 4

OnDevice Instagram User Manual, Version 1.1
 Orchestrating Network Performance

You will be asked to sign up as a developer if this is the first time you are trying to register
an app. Input your/company website, your phone number and a brief description on the
purpose of the developer registration. For example, you may input ‘Android app with
Instagram integration’ as the registration purpose.

At the ‘Manage Clients’ page, click on the ‘Register a New Client’ button.

TEMS™ – now part of InfoVista www.infovista.com | www.tems.com | 5

OnDevice Instagram User Manual, Version 1.1
 Orchestrating Network Performance

At the ‘Register new Client ID’ page, in the ‘Details’ tab, fill in the form. The application
name can be anything as long as it does not contain the word ‘Instagram’, ‘IG’, ‘Insta’ or
‘gram’. You may input ‘Android app with Instagram integration’ as the registration
purpose.
You may skip the ‘Company Name’, ‘Privacy Policy URL’ and ‘Contact Email’ fields.
Make sure the redirect URI is a valid public URI that is accessible through the
internet as this will be used during the logon operation.

TEMS™ – now part of InfoVista www.infovista.com | www.tems.com | 6

OnDevice Instagram User Manual, Version 1.1
 Orchestrating Network Performance

In the ‘Security’ tab, untick the ‘Disable implicit OAuth’ checkbox. Finish registration by
clicking on the ‘Register’ button.

TEMS™ – now part of InfoVista www.infovista.com | www.tems.com | 7

OnDevice Instagram User Manual, Version 1.1
 Orchestrating Network Performance

Upon successful app/client registration, click on the ‘Manage Clients’ menu. Here it will
show the details of the created app/client. The client id and redirect uri will be used
during the logon operation.

2.2 Creating Sandbox Users

After successful app/client registration, additional sandbox users can be created if you
need more than one account for doing Instagram testing.
A sandbox user is an account that has been granted access to interact with the
registered app/client. Only sandbox users will be able to use the Instagram service.
By default, the account that was used to register the app/client is a sandbox account.
You are only allowed to have up to 10 sandbox users per app/client.
Click on the ‘Manage Clients’ menu to see your registered app/client.

Click on the ‘Edit’ button and then the ‘Sandbox’ tab to start adding sandbox users.

TEMS™ – now part of InfoVista www.infovista.com | www.tems.com | 8

OnDevice Instagram User Manual, Version 1.1
 Orchestrating Network Performance

Input an account that you want to add as a sandbox user and click the ‘Save Changes’
button. The account’s sandbox user status will be in ‘pending’ status until the user
accepted the invitation to become a sandbox user for the app/client.

TEMS™ – now part of InfoVista www.infovista.com | www.tems.com | 9

OnDevice Instagram User Manual, Version 1.1
 Orchestrating Network Performance

Logon using the account that the invitation to be added as sandbox user was sent to. At
the Instagram developer page, click on the ‘Sandbox Invites’ menu. Fill in the form to be
registered as a developer. For example, you may input ‘Integration testing with sandbox
account’ for the registration purpose.

Finally, click on the ‘Accept’ button to accept the sandbox invite. Now, the account is
ready to be used with Instagram service.

2.3 Phone Setup

No particular setup is required on the device.

TEMS™ – now part of InfoVista www.infovista.com | www.tems.com | 10

OnDevice Instagram User Manual, Version 1.1
 Orchestrating Network Performance

3 Activity Configuration
3.1.1 Sample script
Test script Sample screen shot

Instagram.tsc

3.1.2 Instagram Logon

Logs on to an Instagram account. This account must have been set up in advance; refer
to the Device Configuration Guide, section Error! Reference source not found. .
Property Description

User Name User name of the Instagram account.

Password User password of the Instagram account

Client Id App/client id of the registered app

Redirect URL Redirect URL of the app with the client id being used. It must be a
valid public URL that is accessible through the internet.

Network Access Timeout Maximum wait time for the device data connection up.

3.1.3 Instagram
Performs a user action while logged on to an Instagram account.
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 Instagram activities concurrently using a Parallel
construct.

TEMS™ – now part of InfoVista www.infovista.com | www.tems.com | 11

OnDevice Instagram User Manual, Version 1.1
 Orchestrating Network Performance

Property Description

Operation Action to perform as an Instagram user.

 Load Feeds
o Load Instagram feeds.
o In order to get load feeds operation to return
results from the Instagram server, make sure to
post some images/status from the Instagram app
with the sandbox account.
 Search By Hashtag
o Search for an Instagram hashtag that you enter
in the Hashtag field, for example, #lte. Following
the hash sign, only alphanumeric characters and
underscore (*_*) can be used; other special
characters cannot be part of a hashtag, nor can
spaces.
o In order to get search by hashtag operation to
return results from the Instagram server, make
sure to post some hashtag from the Instagram
app with the sandbox account.

Network Access Timeout Maximum wait time for the device data connection up.

3.1.4 Instagram Logoff

Logs off from an Instagram account.
This activity has no unique properties.

TEMS™ – now part of InfoVista www.infovista.com | www.tems.com | 12

OnDevice Instagram User Manual, Version 1.1
 Orchestrating Network Performance

4 Information Elements & Events

4.1 Measurement Trigger
Trigger Point Abstract Description Technical Description

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

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

Send operation request First HTTP request sent to Instagram 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 Instagram Received Instagram session closed status.

4.2 Events
Events Description

Instagram Logon Start Logon script activity started.

Instagram Logon Attempt Logon request sent to Instagram server.

Instagram Logon Duration Logon finished when active session with valid access token is opened.

Instagram Logon Error Failure to retrieve access token.

Instagram Logon End Logon script activity ended.

Instagram Operation Start Script activity started.

Instagram Operation Attempt Request sent from OnDevice Instagram Service.

Instagram Operation Duration Operation successfully completed.

Instagram Operation Error Operation failed.

Instagram Operation End Script activity ended.

Instagram Logoff Start Logoff script activity started.

Instagram Logoff Attempt Close and clear token information sent from OnDevice Instagram Service.

Instagram Logoff Duration Logoff finished when Instagram session closed.

Instagram Logoff Error Logoff failed.

Instagram Logoff End Logon script activity ended.

TEMS™ – now part of InfoVista www.infovista.com | www.tems.com | 13

OnDevice Instagram User Manual, Version 1.1
 Orchestrating Network Performance

4.3 Information Elements

Information Elements Description

Instagram Logon Success Ratio Success rate for Instagram Logon.

Instagram Operation Success Ratio Success rate for Instagram Operations (all types of user actions taken
together).

Instagram Logoff Success Ratio Success rate for Instagram Logoff.

TEMS™ – now part of InfoVista www.infovista.com | www.tems.com | 14

OnDevice Instagram User Manual, Version 1.1
 Orchestrating Network Performance

5 Highlights
5.1 Limitations
Limitations

1 Parallel Instagram activity is NOT supported.

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

3 A limit is imposed on the logon frequency. After logging off from Instagram, you must wait least
30 seconds before logging on again, otherwise the logon will fail. In case of failure, wait at least
10 minutes before retrying.
 There are also limits on the frequency of posting, as detailed here:
https://instagram.com/developer/limits.

4 A sandbox account is only allowed to make 500 API calls per hour.

5 A sandbox account can only retrieve data from other sandbox users that are tied to the same
app/client id.

5.2 Potential Issues

Potential Issues

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

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

hacking) by Instagram. When this happens, the Instagram account might be banned or locked by
Instagram. Instagram may ask for verification of the account.

TEMS™ – now part of InfoVista www.infovista.com | www.tems.com | 15

OnDevice Instagram User Manual, Version 1.1