Versions Compared

Version Old Version 7 New Version 8
Changes made by

Sharath Prasad

Anil Gupta

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Intent

Need to create an unified deep linking interface for enabling Access to Content on Sunbird across different apps like Read Along,Games etc.

Note: Assumption of this specification is based on the apps being able to support these deep links as part of their implementation.

Approaches

Approach 1 : (Deeper Integration)


Deep Link provides basic information such as content do_id, telemetry context information.

Targeted Application need to fetch the data from platform. Understand the Content Metadata and play the content.

Targeted Application need to respond back with Summary Data

Pros:

It can enable bazaar apps to index the content in their own environment.

It could open up the Sunbird APIs for most of the bazaar players.

Cons

Tighter coupling for bazaar apps to be reliant on Sunbird APIs.

Necessary for bazaar apps to understand the content metadata. Could mean a development effort for these players

Any service disruptions,outage could spell trouble for these apps and also could potentially ending these apps taking a hit in terms of ratings.

Approach 2 : (Lighter Integration)

Deep Link provides basic information such as content do_id, telemetry context information & artifactUrl and mimeType.

Bazaar Apps can launch the artifactUrl directly based on mimeType.

Pros :
Least Effort in integrating the deep link for bazaar apps.

Need to develop a secure mechanism to serve only sun bird specific resources.

Sample Deep Linking Uri:
cpi://play?resourceId=<param-value>&referrerPackageId=<param-value>…..

Params

Description

Data type

resourceId

identifier of the resource to be served in bazaar apps

String

collectionId

CollectionID of textbook,course

String

referrerPackageId

package details of referrer app

String

batchId

BatchId if it is trackable collection

String

mimeType

Content MimeType

String

vendorCode

Vendor ID to validate the referrer

String

contentCategory

contentCategory

String

SUMMARY Event

Code Block
languagejs
{
  "edata": {
    "type": "", // Required. Type of summary. Free text. "session", "app", "tool" etc
    "mode": "", // Optional.
    "starttime": Long, // Required. Epoch Timestamp of app start. Retrieved from first event.
    "endtime": Long, // Required. Epoch Timestamp of app end. Retrieved from last event.
    "timespent": Double, // Required. Total time spent by visitor on app in seconds excluding idle time.
    "pageviews": Long, // Required. Total page views per session(count of CP_IMPRESSION)
    "interactions": Long, // Required. Count of interact events
    "envsummary": [{ // Optional
        "env": String, // High level env within the app (content, domain, resources, community)
        "timespent": Double, // Time spent per env
        "visits": Long // count of times the environment has been visited
    }],
    "eventssummary": [{ // Optional
        "id": String, // event id such as CE_START, CE_END, CP_INTERACT etc.
        "count": Long // Count of events.
    }],
    "pagesummary": [{ // Optional
        "id": String, // Page id
        "type": String, // type of page - view/edit
        "env": String, // env of page
        "timespent": Double, // Time taken per page
        "visits": Long // Number of times each page was visited
    }]
  }
}