Skip to content
This repository has been archived by the owner on Sep 22, 2023. It is now read-only.

DDI-317 Adding Client-side vs Server-side doc #486

Merged
merged 6 commits into from Jan 9, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
10 changes: 8 additions & 2 deletions docs/data/sdks/index.md
Expand Up @@ -5,9 +5,15 @@ description: Use Amplitude SDKs to send event data from your apps into Amplitude

Use Amplitude SDKs to send event data from your apps into Amplitude.

## Data SDKs
## Analytics SDKs

--8<-- "includes/data-sources-sdks.md"
### Analytics client-side SDKs

--8<-- "includes/data-sources-sdks-client-side.md"

### Analytics server-side SDKs

--8<-- "includes/data-sources-sdks-server-side.md"

## Experiment SDKs

Expand Down
8 changes: 7 additions & 1 deletion docs/data/sources.md
Expand Up @@ -28,7 +28,13 @@ For detailed instructions, see the documentation for the source you want to add.

<!-- This content is used in several places. Make changes to includes/data-sources-sdks.md -->

--8<-- "includes/data-sources-sdks.md"
#### Client-side

--8<-- "includes/data-sources-sdks-client-side.md"

#### Server-side

--8<-- "includes/data-sources-sdks-server-side.md"

### Cloud storage

Expand Down
46 changes: 46 additions & 0 deletions docs/data/sources/client-side-vs-server-side.md
@@ -0,0 +1,46 @@
---
title: Client-side vs Server-side Sources
description: Learn the difference between Amplitude's client-side and server-side sources.
status: new
---

Client-side and server-side are terms that describe where an app's code runs: either on the user's device (client-side), or on a server (server-side). Amplitude has several types of sources to cover each of your needs. This doc primarily describes the differences between client-side and server-side sources, and gives a brief overview of third-party sources.

## Client-side sources

Use client-side sources in apps that your users run on their own devices, like mobile, web browser, and desktop apps. In these types of sources, code runs on the user's device.

Amplitude's client-side sources include these SDKs:

- Web: Browser, Marketing Analytics Browser, React Native
- Mobile: Android, iOS, Unity Plugin, Flutter, React Native

See the [Analytics client-side SDKs](/data/sdks/#data-client-side-sdks) and the [Experiment client-side SDKs](/data/sdks/#experiment-client-side-sdks)

## Server-side sources

Use server-side sources in secure, multi-user environments like web servers and services that you run on your own servers. In these types of sources, code runs on the server.

Amplitude's server-side sources include these SDKs and APIs:

- Node.js SDK
- Go SDK
- Python SDK
- Java SDK
- HTTP V2 API
liuyang1520 marked this conversation as resolved.
Show resolved Hide resolved
- Batch Event Upload API

See the [Analytics server-side SDKs](/data/sdks/#data-server-side-sdks) and the [Experiment server-side SDKs](/data/sdks/#experiment-server-side-sdks)

## Third-party sources

Third-party is another kind of source. These sources let you import data from other platforms into Amplitude. These sources all require that you have an account with the third-party sources, and each have different setup requirements. You can see all third-party sources in the [Source catalog](/data/sources).

## How to choose

Choosing the kinds of sources you need to use can be daunting, so here's a basic guide to help you make a decision.

- **Client-side**: Choose client-side sources for the simplest initial instrumentation.
- **Server-side**: Choose server-side sources if you want track server-side events and leverage existing user data tracking workflows.
- **Hybrid**: Choose a hybrid approach that includes both client-side and server-side sources to get the benefits of simpler implementation and ability to track server-side events.
- **Third party**: Choose these sources if you already have a third-party data layer such as ad networks or marketing automation tools.
14 changes: 14 additions & 0 deletions includes/data-sources-sdks-client-side.md
@@ -0,0 +1,14 @@
<!-- To add an entry, first add an SVG logo in overrides/.icons, then add a new line item in the table. Wrap the icon filename in colons to reference it. -->

<div class="grid cards" markdown>

- :android: [Android](../../data/sdks/android-kotlin/)
- :typescript: [Browser](../../data/sdks/typescript-browser/)
- :typescript: [Marketing Analytics Browser](../../data/sdks/marketing-analytics-browser/)
- :material-apple-ios: [iOS Swift (Beta)](../../data/sdks/ios-swift/)
- :material-apple-ios: [iOS](../../data/sdks/ios/)
- :flutter: [Flutter](../..data/sdks/flutter)
- :react: [React Native](../../data/sdks/typescript-react-native/)
- :unity: [Unity](../../data/sdks/unity/)
- :unreal: [Unreal](../../data/sdks/unreal/)
</div>
10 changes: 10 additions & 0 deletions includes/data-sources-sdks-server-side.md
@@ -0,0 +1,10 @@
<!-- To add an entry, first add an SVG logo in overrides/.icons, then add a new line item in the table. Wrap the icon filename in colons to reference it. -->

<div class="grid cards" markdown>

- :java: [Java](../../data/sdks/java/)
- :node: [Node.js](../../data/sdks/typescript-node/)
- :python: [Python](../../data/sdks/python/)
- :go: [Go (Beta)](../../data/sdks/go/index)

</div>
3 changes: 2 additions & 1 deletion mkdocs.yml
Expand Up @@ -160,10 +160,11 @@ nav:
- Use AMP with Amplitude: analytics/use-amp-pages.md
- Data:
- data/index.md
- Overview: data/index.md
- Overview: data/index.md
- Getting Started: "getting-started.md"
- Sources:
- Overview: data/sources.md
- Client-side vs Server-side: data/sources/client-side-vs-server-side.md
- Ampli:
- data/ampli/index.md
- data/ampli/cli.md
Expand Down