Skip to content

Commit 993f28d

Browse files
rtrieuclaudegit-thuerk-done
authored
[DOCS-14641] Add guide page for tracking server-side events in Product Analytics (#37625)
* [DOCS-14641] Add guide page for tracking server-side events in Product Analytics Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Simplify sentence on line 34, remove em dashes Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * sent cap * Apply suggestions from code review Co-authored-by: Alicia Thuerk <alicia.thuerk@datadoghq.com> * move to data collected * update page weight --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com> Co-authored-by: Alicia Thuerk <alicia.thuerk@datadoghq.com>
1 parent 9379206 commit 993f28d

5 files changed

Lines changed: 59 additions & 1 deletion

File tree

config/_default/menus/main.en.yaml

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9740,6 +9740,11 @@ menu:
97409740
parent: product_analytics
97419741
identifier: pa_data_collected
97429742
weight: 6
9743+
- name: Server-Side Events
9744+
url: product_analytics/data_collected/server_side_events
9745+
parent: pa_data_collected
9746+
identifier: pa_data_collected_server_side_events
9747+
weight: 601
97439748
- name: Experiments
97449749
url: experiments/
97459750
pre: experiment-wui

content/en/product_analytics/_index.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ To set up your application with a coding assistant, see [Agentic onboarding][17]
5858

5959
### Track server-side events (API)
6060

61-
After you set up client-side collection, you can use the [Product Analytics API][21] to send custom events from your server, such as completed checkouts or processed payments.
61+
After you set up client-side collection, you can use the [Product Analytics API][21] to send custom events from your server, such as completed checkouts or processed payments. For more information, see [Track Server-Side Events][22].
6262

6363
<div class="alert alert-warning">Datadog bills server-side events separately. See the <a href="https://www.datadoghq.com/pricing/?product=product-analytics#products">pricing page</a> for details, and contact your Customer Success Manager with additional questions.</div>
6464

@@ -177,3 +177,4 @@ Use the following features to inform your product change decisions, such as chan
177177
[19]: /real_user_monitoring/guide/understanding-the-rum-event-hierarchy
178178
[20]: https://app.datadoghq.com/rum/sessions?query=%40type%3Aaction
179179
[21]: /api/latest/product-analytics/#send-server-side-events
180+
[22]: /product_analytics/data_collected/server_side_events/

content/en/product_analytics/data_collected.md renamed to content/en/product_analytics/data_collected/_index.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,9 @@ further_reading:
1111
- link: "/real_user_monitoring/application_monitoring/android/data_collected/"
1212
tag: "Documentation"
1313
text: "RUM Android Data Collected"
14+
- link: "/product_analytics/data_collected/server_side_events/"
15+
tag: "Documentation"
16+
text: "Track Server-Side Events"
1417
---
1518

1619
## Overview
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
---
2+
title: Track Server-Side Events
3+
description: Send custom events from your server to supplement client-side data in Product Analytics.
4+
further_reading:
5+
- link: "/api/latest/product-analytics/#send-server-side-events"
6+
tag: "API Reference"
7+
text: "Product Analytics API"
8+
- link: "/product_analytics/"
9+
tag: "Documentation"
10+
text: "Product Analytics"
11+
- link: "/product_analytics/data_collected/"
12+
tag: "Documentation"
13+
text: "Product Analytics Data Collected"
14+
---
15+
16+
## Overview
17+
18+
Server-side events are custom events sent through the [Product Analytics API][1] from your server. Unlike client-side events captured by the RUM SDK, such as pageviews or button clicks, server-side events track actions that occur in your backend, such as a completed checkout or processed payment.
19+
20+
Use server-side events to:
21+
22+
- Capture events at the source of truth on the server, independent of client-side behavior
23+
- Track backend actions with no client-side equivalent, such as a payment confirmation or subscription renewal
24+
- Supplement client-side data with server-side context
25+
26+
<div class="alert alert-warning">Datadog bills server-side events separately. See the <a href="https://www.datadoghq.com/pricing/?product=product-analytics#products">pricing page</a> for details, and contact your Customer Success Manager with additional questions.</div>
27+
28+
## Prerequisites
29+
30+
Before sending server-side events, [set up the Datadog SDK][2] for your application and [enable Product Analytics][3].
31+
32+
## Send server-side events
33+
34+
Use the [Product Analytics API][1] to send events from your server. To associate a server-side event with a client session, include the `session_id` from the client's active RUM session. Including the session ID links server-side events to client-side data for a complete view of the user journey.
35+
36+
For the full API reference, including authentication, required fields, and request parameters, see [Send server-side events][1].
37+
38+
## Analyze server-side events
39+
40+
After you send server-side events, they are available in any Product Analytics chart. In the event picker, select **Server Events** to scope your analysis to server-side data.
41+
42+
## Further reading
43+
44+
{{< partial name="whats-next/whats-next.html" >}}
45+
46+
[1]: /api/latest/product-analytics/#send-server-side-events
47+
[2]: /product_analytics/#track-client-side-events-sdk
48+
[3]: /product_analytics/#enable-product-analytics

content/en/product_analytics/guide/_index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ cascade:
1111

1212
{{< whatsnext desc="General Product Analytics:" >}}
1313
{{< nextlink href="product_analytics/guide/rum_and_product_analytics" >}}Understanding RUM and Product Analytics{{< /nextlink >}}
14+
{{< nextlink href="product_analytics/data_collected/server_side_events" >}}Track server-side events{{< /nextlink >}}
1415
{{< nextlink href="session_replay/guide/diagnose-funnel-drop-offs-with-session-replay" >}}Diagnose funnel drop-offs with Session Replay{{< /nextlink >}}
1516
{{< nextlink href="product_analytics/guide/monitor-utm-campaigns-in-product-analytics" >}}Monitor UTM Campaigns{{< /nextlink >}}
1617

0 commit comments

Comments
 (0)