# Engagement

The Engagement product offering sits on top of Sentiance's Insights and can used to build coaching modules to increase user engagement and retention in your applications.

{% hint style="info" %}
In the Engagement section of documentation, 'trip' and 'transport' both refer to a journey someone takes, whether it's by walking, driving, or biking. We use these terms interchangeably to keep the language consistent and adaptable to different modes of travel
{% endhint %}

## Available features

The Engagement platform contains the following features. All features can be implemented separately, or together with any of the other features.

Select a feature to discover more details and learn how to integrate it.

* [User Adaptive Score](https://docs.sentiance.com/sentiance-insights/engagement/user-adaptive-score): Adapts to individual user behavior to provide scores.
* [Streaks](https://docs.sentiance.com/sentiance-insights/engagement/streaks): Encourages better driving habits by rewarding users for consistent safe driving behaviors
* [Challenges](https://docs.sentiance.com/sentiance-insights/engagement/challenges): Engages users with driving-related challenges, designed to promote safer driving practices and improve overall driving behavior through engaging and goal-oriented tasks
* [Reward System](https://docs.sentiance.com/sentiance-insights/engagement/reward-system): Awards users with visual tokens of achievement for completing specific milestones or activities.
* [Communication Campaigns](https://docs.sentiance.com/sentiance-insights/engagement/communication-campaign): Engages users with targeted messages and notifications, enhancing interaction and retention.
* [Social Groups](https://docs.sentiance.com/sentiance-insights/engagement/social-groups): Enables users to connect with others by sharing live locations, managing points of interest, and participating in behaviour comparison within private, invitation-only groups
* Transport Scores: Offers detailed insights based on transportation behavior, including adaptive scores, focused scores, etc., aimed at enhancing understanding and improvement of driving and transportation habits.
* Event Logs (Engagement): Allows users to submit logs, with some logs carrying special meanings related to the operation of the other engagement features,

## Querying the platform

Just like the rest of the cloud platform, the engagement features can be accessed and queried through our GraphQL (GQL) API. All engagement features can be queried through our GraphQL (GQL) API, specifically through the subquery at path `user.engagement`

```graphql
query User($user_id: String) {
  user(user_id: $user_id) {
    engagement {
      // Specify the engagement feature and details you wish to query
    }
  }
}
```

## Sample Wireframe

<figure><img src="https://3097961207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB9ZHBaHKglgKmgIlyHT0%2Fuploads%2Fgit-blob-83df45c25192e121d1fb408cdfae0d4f6ad75226%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

***

Additional helpful links

* [Accessing via the Cloud API](https://docs.sentiance.com/sentiance-insights/accessing-sentiance-insights/via-cloud-api)
* [Sentiance Graphql V4](https://graphqldocs.sentiance.com/)
* [Sentiance Graphql V4 > Engagement](https://graphqldocs.sentiance.com/#definition-Engagement)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sentiance.com/sentiance-insights/engagement.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.