OnDevice Instagram User Manual

Contents
1

Overview
1.1

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

Prerequisites

2.1

Instagram Account .......................................................................................... 3

2.2

Phone Setup .................................................................................................... 3

Activity Configuration

3.1.1

Sample script ................................................................................... 4

3.1.2

Instagram Logon .............................................................................. 4

3.1.3

Instagram ......................................................................................... 4

3.1.4

Instagram Logoff .............................................................................. 5

Information Elements & Events

4.1

Measurement Trigger ...................................................................................... 6

4.2

Events.............................................................................................................. 6

4.3

Information Elements ...................................................................................... 7

Highlights

5.1

Limitations ....................................................................................................... 8

5.2

Potential Issues ............................................................................................... 8

NT16-51392, 0.1, 1/5/2016

Overview

1.1

Features
Features

Description

Load Feeds

Load Instagram feeds.

Search By Hashtag

Search for an Instagram hashtag.

NT16-51392, 0.1, 1/5/2016

Prerequisites

2.1

Instagram Account

In order to perform Instagram testing, you need to create an Instagram account.

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.

No further configuration of the Instagram account or the device is required.

2.2

Phone Setup

No particular setup is required on the device.

NT16-51392, 0.1, 1/5/2016

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 2.1 .
Property

Description

User Name

User name of the Instagram account.

Password

User password of the Instagram account

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

Description

Operation

Action to perform as an Instagram user.

Load Feeds
o

NT16-51392, 0.1, 1/5/2016

Load Instagram feeds.

Search By Hashtag
o

3.1.4

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.

Instagram Logoff

Logs off from an Instagram account.

This activity has no unique properties.

NT16-51392, 0.1, 1/5/2016

Information Elements & Events

4.1

Measurement Trigger

Trigger Point

Abstract Description

Technical Description

Send logon request

First HTTP request sent to Instagram server.

Logged on to Instagram

Received Instagram session opened status with a valid access

token

Send operation request

First HTTP request sent to Instagram 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 Instagram

Received Instagram session closed status.

Tr-1
Tr-2

Tr-3

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.

NT16-51392, 0.1, 1/5/2016

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.

NT16-51392, 0.1, 1/5/2016

Highlights

5.1

Limitations
Limitations

Parallel Instagram activity is NOT supported.

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

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.

5.2

There are also limits on the frequency of posting, as detailed here:

https://instagram.com/developer/limits.

Potential Issues
Potential Issues

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.

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.

NT16-51392, 0.1, 1/5/2016