diff --git a/src/content/docs/ja/api/s2s-api/sessions.mdx b/src/content/docs/ja/api/s2s-api/sessions.mdx index 010d44a3d6..4b1bb34b2e 100644 --- a/src/content/docs/ja/api/s2s-api/sessions.mdx +++ b/src/content/docs/ja/api/s2s-api/sessions.mdx @@ -14,13 +14,13 @@ sidebar-label: S2Sセッション -## 事前準備 {#before-you-begin} +## 事前準備 \{\#before\-you\-begin\} ### 認証 {#authentication} -[サーバー間（S2S）セキュリティを設定](/ja/api/s2s-api/security)して、S2Sセッションの計測を不正から守ります。そのためには、受信するリクエストごとに、Adjustダッシュボードで生成されたトークンが付与されている必要があります。トークンが付与されていないリクエスト、または不正なトークンが付与されたリクエストは、Adjustのサーバーによって拒否されます。 +[サーバー間（S2S）セキュリティを設定](/ja/api/s2s-api/security)して、サーバー間 \(S2S\) セッションの計測を不正から守ります。そのためには、受信するリクエストごとに、Adjust管理画面で生成されたトークンが付与されている必要があります。トークンが付与されていないリクエスト、または不正なトークンが付与されたリクエストは、Adjustのサーバーによって拒否されます。 -## セッションを記録する {#record-sessions} +## セッションを記録する \{\#record\-sessions\} Adjustはセッションをグループ化することでリソースを節約します。つまり、Adjustサーバーが新しいセッションをトリガーされたものとして受け取る前に、1つのセッション後に最低30分間の間隔がなければなりません。 @@ -53,7 +53,7 @@ https://s2s.adjust.com/session | `tifa` | Tizen OS 広告ID、Samsungのみ | | | `idfa` | iOS広告ID、iOSのみ | `29DDE430-CE81-4F00-A50C-689595AAD142` | | `idfv` | iOSベンダーID、iOSのみ | `59E27F41-A86B-4560-B585-63161F871C4B` | -| `gps_adid` | Google Play広告ID、Google Play 開発者サービスライブラリが追加された場合にのみ送信される。Androidのみ | `6cf94580-46c2-490c-b882-2f6ae269b579` | +| `gps_adid` | Google Play広告識別子、Google Play 開発者サービスライブラリが追加された場合にのみ送信されます。Androidのみ | `6cf94580-46c2-490c-b882-2f6ae269b579` | | `oaid` | Open Advertising（匿名）ID | `ed799bac-2537-6122-377a-edebce5db5a5` | | `imei` | 国際移動体装置識別番号 | `490154203237518` | | `android_id` | Android ID、 `gps_adid`がない場合にのみ送信される。Androidのみ | `e11a8c233efb29f3` | @@ -81,7 +81,7 @@ https://s2s.adjust.com/session | `install_receipt` | App Store、暗号化により署名されたインストールの受領証、iOSのみ。 | `Super long string representation of the receipt` | | `ip_address` | デバイスのIPアドレス。
`ip_address`パラメーターではIPv4アドレスのみを受け付けます。IPv6は現在サポートされていません。 | `ip_address=192.0.0.1` | -## Googleに同意データを提供する（デジタル市情法へのコンプライアンス） {#provide-consent-data-to-google-digital-markets-act-compliance} +## Googleに同意データを提供する（デジタル市情法へのコンプライアンス） \{\#provide\-consent\-data\-to\-google\-digital\-markets\-act\-compliance\} [EUのデジタル市場法（DMA）に準拠するため、](https://help.adjust.com/ja/article/google-compliancy-with-the-dma)Google 広告およびGoogle マーケティング プラットフォームは、AdjustからAPIへのアトリビューションリクエストを受信することに明示的な同意を必要とします。 @@ -102,7 +102,7 @@ Google 広告を使用している場合は`ad_personalization`パラメータ | `ad_user_data` | | Googleに、ユーザーが個人データが計測目的で共有されることに同意したかどうかを通知します。
この同意は、Google 広告およびGoogle マーケティング プラットフォームのUIで指定した全てのコアプラットフォームサービスCPSの広告主に適用されます。 | | `npa` | | アプリのインストール後に、Google マーケティング プラットフォームを介してパーソナライズされた広告を配信することにユーザーが同意したかどうかを通知します。 | -## 例 {#example} +## 例 \{\#example\} @@ -110,7 +110,7 @@ Google 広告を使用している場合は`ad_personalization`パラメータ curl -X "POST" \ -H 'Authorization: Bearer ADD_YOUR_AUTH_TOKEN_HERE' \ -H 'User-Agent: Adjust Streaming Job (akka-http)' \ --d "app_token=a1234b2x3a4o&app_version=Roku%2FDVP-10.5+%2810.5.0.0010%29&created_at_unix=1543915806015&environment=production&os_name=android&rida=099aa0bc-d123-4567-8999-a1b7c50767b1&s2s=1" \ +-d "app_token=a1234b2x3a4o&app_version=Roku%2FDVP-10.5+%2810.5.0.0010%29&created_at_unix=1543915806015&environment=production&os_name=roku-os&rida=099aa0bc-d123-4567-8999-a1b7c50767b1&s2s=1" \ "https://s2s.adjust.com/session" ``` diff --git a/src/content/docs/ko/api/s2s-api/sessions.mdx b/src/content/docs/ko/api/s2s-api/sessions.mdx index 9868d93945..1ab672a34d 100644 --- a/src/content/docs/ko/api/s2s-api/sessions.mdx +++ b/src/content/docs/ko/api/s2s-api/sessions.mdx @@ -14,13 +14,13 @@ Adjust는 다음의 기능을 활성화해야 합니다. 자세한 정보는 담 -## 시작에 앞서 {#before-you-begin} +## 시작에 앞서 \{\#before\-you\-begin\} ### 인증 {#authentication} [S2S 보안을 설정](/ko/api/s2s-api/security)하여 S2S 세션의 보안을 보장하고, 스푸핑된 요청으로부터 보호할 수 있습니다. 이를 위해서는 수신되는 모든 요청에 Adjust 대시보드에서 생성된 인증 토큰이 포함되어야 합니다. 토큰이 포함되어 있지 않거나 올바르지 않은 토큰을 포함한 요청은 Adjust 서버에서 거부됩니다. -## 세션 기록 {#record-sessions} +## 세션 기록 \{\#record\-sessions\} Adjust는 리소스를 저장하기 위해 세션을 그룹화합니다. Adjust 서버가 새로운 세션이 트리거된 것으로 간주하려면, 세션 간 최소 30분의 간격이 있어야 합니다. @@ -40,7 +40,7 @@ https://s2s.adjust.com/session | `X-Adjust-Forwarded-For` | 디바이스의 IP 주소 | `180.220.253.39` | | `Authorization` | `Bearer` 토큰인 Adjust 인증 토큰. | `Bearer authentication_token` | -### 페이로드 {#payload} +### 페이로드{#payload} 아래의 표에서 파라미터 전체 목록을 확인하시기 바랍니다. @@ -53,7 +53,7 @@ https://s2s.adjust.com/session | `tifa` | Tizen OS 광고 ID, Samsung만 해당 | | | `idfa` | iOS 광고 ID, iOS에만 해당 | `29DDE430-CE81-4F00-A50C-689595AAD142` | | `idfv` | Roku 벤더 ID, iOS에만 해당 | `59E27F41-A86B-4560-B585-63161F871C4B` | -| `gps_adid` | Google Play 광고 ID. Goole Play Service 라이브러리가 추가된 경우에만 전송. Android에만 해당. | `6cf94580-46c2-490c-b882-2f6ae269b579` | +| `gps_adid` | Google Play 광고 식별자. Goole Play Service 라이브러리가 추가된 경우에만 전송. Android에만 해당. | `6cf94580-46c2-490c-b882-2f6ae269b579` | | `oaid` | 공개 광고\(익명\) ID | `ed799bac-2537-6122-377a-edebce5db5a5` | | `imei` | 국제 모바일 기기 식별코드\(IMEI\) | `490154203237518` | | `android_id` | Android ID, `gps_adid`가 없는 경우에만 전송. Android에만 해당. | `e11a8c233efb29f3` | @@ -81,7 +81,7 @@ https://s2s.adjust.com/session | `install_receipt` | 앱 스토어의 암호화 서명된 설치 영수증, iOS만 해당 | `Super long string representation of the receipt` | | `ip_address` | 디바이스의 IP 주소.
`ip_address` 파라미터는 IPv4 주소만 허용하며, IPv6은 현재 지원되지 않습니다. | `ip_address=192.0.0.1` | -## Google에 동의 데이터 제공\(디지털 시장법 준수\) {#provide-consent-data-to-google-digital-markets-act-compliance} +## Google에 동의 데이터 제공\(디지털 시장법 준수\) \{\#provide\-consent\-data\-to\-google\-digital\-markets\-act\-compliance\} [EU의 디지털 시장법\(DMA\)](https://help.adjust.com/ko/article/google-compliancy-with-the-dma)에 따라 Google Ads와 Google Marketing Platform은 API에 대한 Adjust의 어트리뷰션 요청을 수신하기 위해 명시적인 동의를 받아야 합니다. @@ -102,7 +102,7 @@ Google Ads를 사용하는 경우 `ad_personalization` 파라미터를 전송하 | `ad_user_data` | | 사용자가 측정 목적의 개인 정보 공유에 동의했는지 여부를 Google에 알려줍니다.
해당 동의 정보는 광고주들이 Google Ads와 Google Marketing Platform UI에서 명시한 모든 Core Platform Services\(CPS\)에 적용됩니다. | | `npa` | | 사용자가 앱을 설치한 후 Google Marketing Platform을 통해 맞춤형 광고를 제공받는 데 동의했는지 여부를 알려줍니다. | -## 예: {#example} +## 예 \{\#example\} @@ -110,7 +110,7 @@ Google Ads를 사용하는 경우 `ad_personalization` 파라미터를 전송하 curl -X "POST" \ -H 'Authorization: Bearer ADD_YOUR_AUTH_TOKEN_HERE' \ -H 'User-Agent: Adjust Streaming Job (akka-http)' \ --d "app_token=a1234b2x3a4o&app_version=Roku%2FDVP-10.5+%2810.5.0.0010%29&created_at_unix=1543915806015&environment=production&os_name=android&rida=099aa0bc-d123-4567-8999-a1b7c50767b1&s2s=1" \ +-d "app_token=a1234b2x3a4o&app_version=Roku%2FDVP-10.5+%2810.5.0.0010%29&created_at_unix=1543915806015&environment=production&os_name=roku-os&rida=099aa0bc-d123-4567-8999-a1b7c50767b1&s2s=1" \ "https://s2s.adjust.com/session" ``` diff --git a/src/content/docs/zh/api/s2s-api/sessions.mdx b/src/content/docs/zh/api/s2s-api/sessions.mdx index 012dca7075..abb35ccd9f 100644 --- a/src/content/docs/zh/api/s2s-api/sessions.mdx +++ b/src/content/docs/zh/api/s2s-api/sessions.mdx @@ -10,17 +10,17 @@ sidebar-label: S2S 会话 -Adjust 需要为您启用该功能。请联系您的技术客户经理或发送邮件至 support@adjust.com 来完成此步骤。 +Adjust 需要为您启用该功能。请联系您的技术客户经理或发送邮件至 [support@adjust.com](mailto:support@adjust.com) 来完成此步骤。 -## 操作前须知 {#before-you-begin} +## 操作前须知 \{\#before\-you\-begin\} ### 认证{#authentication} [设置 S2S 安全](/zh/api/s2s-api/security)来保护 S2S 会话的安全，抵御欺诈请求的侵害。设置认证后，每个传入的请求都必须带有您在 Adjust 控制面板中生成的认证识别码。缺失识别码或识别码不正确的请求会被 Adjust 服务器拒绝。 -## 记录会话{#record-sessions} +## 记录会话\{\#record\-sessions\} Adjust 将会话归为组，以节省资源。也就是说，在一次会话后，必须有至少 30 分钟的间隔，Adjust 服务器才会将下一次触发的会话计为新会话。 @@ -62,7 +62,7 @@ https://s2s.adjust.com/session | `app_version_short` | 代表 iOS 中的实际应用版本号。仅限 iOS | `1.0` | | `session_count` | 包括当前会话的已记录会话总数。 | `1` | | `subsession_count` | 已记录的子会话数量。记录到的首次会话 \(即安装\) 不包含该参数。
其后的所有会话都包含前一次会话的子会话数量。 | `1` | -| `session_length` | 会话时长 \(以秒计\)。跟踪到的首次会话 \(即安装\) 不包含该参数。
其后的所有会话都包含前一次会话的时长。 | `123` | +| `session_length` | 会话时长 \(以秒计\)。记录到的首次会话 \(即安装\) 不包含该参数。
其后的所有会话都包含前一次会话的时长。 | `123` | | `time_spent` | 前次会话中活跃状态时长 | `123` | | `tracking_enabled` | 说明用户是否启用了限制广告跟踪 \(LAT\) | `1` | | `bundle_id` | Bundle ID，仅限 iOS 设备。 | `com.adjust.example` | @@ -81,7 +81,7 @@ https://s2s.adjust.com/session | `install_receipt` | 来自 App Store 的加密签名安装收据，仅限 iOS | `Super long string representation of the receipt` | | `ip_address` | 设备 IP 地址`ip_address`参数仅接受 IPv4 地址。当前不支持 IPv6。 | `ip_address=192.0.0.1` | -## 向 Google 提供许可数据 \(《数字市场法案》合规\){#provide-consent-data-to-google-digital-markets-act-compliance} +## 向 Google 提供许可数据 \(《数字市场法案》合规\)\{\#provide\-consent\-data\-to\-google\-digital\-markets\-act\-compliance\} 要[符合欧盟的《数字市场法案》\(Digital Markets Act，简称 DMA\)](https://help.adjust.com/zh/article/google-compliancy-with-the-dma)，Google Ads 和 Google Marketing Platform 需要获得明确的用户许可，才能接收 Adjust 向其 API 发送的归因请求。 @@ -102,7 +102,7 @@ https://s2s.adjust.com/session | `ad_user_data` | | 告知 Google 用户是否同意分享个人数据用于监测目的。该许可适用于广告主在 Google Ads 和 Google Marketing Platform 用户界面中指定的所有核心平台服务 \(CPS\)。 | | `npa` | | 表明用户是否同意在安装应用后通过 Google Marketing Platform 被投放个性化广告。 | -## 示例 {#example} +## 示例 \{\#example\} @@ -110,7 +110,7 @@ https://s2s.adjust.com/session curl -X "POST" \ -H 'Authorization: Bearer ADD_YOUR_AUTH_TOKEN_HERE' \ -H 'User-Agent: Adjust Streaming Job (akka-http)' \ --d "app_token=a1234b2x3a4o&app_version=Roku%2FDVP-10.5+%2810.5.0.0010%29&created_at_unix=1543915806015&environment=production&os_name=android&rida=099aa0bc-d123-4567-8999-a1b7c50767b1&s2s=1" \ +-d "app_token=a1234b2x3a4o&app_version=Roku%2FDVP-10.5+%2810.5.0.0010%29&created_at_unix=1543915806015&environment=production&os_name=roku-os&rida=099aa0bc-d123-4567-8999-a1b7c50767b1&s2s=1" \ "https://s2s.adjust.com/session" ```