# Engagements

### Tracking Engagements

The snippet below shows an example of how to track engagements. Engagement examples include likes, comments, profile views and link clicks.

<Tabs>

```js label="JavaScript"
const engagement = {
  // the label for the engagement, ie click, retweet etc.
  label: "click",
  // the ID of the content that the user clicked
  content: {
    foreign_id: "tweet:34349698",
  },
  // score between 0 and 100 indicating the importance of this event
  // IE. a like is typically a more significant indicator than a click
  score: 2,
  // (optional) the position in a list of activities
  position: 3,
  // (optional) the feed the user is looking at
  feed_id: "user:thierry",
  // (optional) the location in your app. ie email, profile page etc
  location: "profile_page",
};

client.trackEngagement(engagement);
client.trackEngagements([engagement1, engagement2]);
```

```kotlin label="Kotlin"
client.send(new Engagement.EventBuilder()
  .withFeedId("user:thierry")
  .withContent(
    new Content.ContentBuilder()
      .withForeignId("message:34349698")
      .withAttribute("verb", "share")
      .withAttribute("actor", new ContentAttribute("1", "user1"))
      .build()
    )
  .withBoost(2)
  .withLocation("profile_page")
  .withPosition("3")
  .build()
);
```

</Tabs>

### Parameters

| name     | type             | description                                                               | default | optional |
| -------- | ---------------- | ------------------------------------------------------------------------- | ------- | -------- |
| label    | string           | The type of event (i.e. click, share, search, etc.)                       | -       |          |
| content  | string or object | The content the engagement related to, either as an ID or content object. | -       |          |
| score    | string           | A score between 0 and 100 indicating the importance of an event.          | -       |          |
| position | string           | The placement in a list of activities, starting at 0.                     | -       | ✓        |
| feed_id  | string           | The specific feed the user is viewing                                     | -       | ✓        |
| location | string           | The page in your app (i.e. email, homepage, profile page, etc.)           | -       | ✓        |


---

This page was last updated at 2026-05-22T16:31:47.598Z.

For the most recent version of this documentation, visit [https://getstream.io/activity-feeds/docs/javascript/v2/analytics-engagements/](https://getstream.io/activity-feeds/docs/javascript/v2/analytics-engagements/).