From 70618da69176eac3e3a0a2e4612998713bace371 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Mon, 2 Dec 2024 09:15:54 +0000 Subject: [PATCH 1/3] File src/content/docs/en/api/s2s-api/sessions.mdx was translated to ko-KR locale --- src/content/docs/ko/api/s2s-api/sessions.mdx | 148 +++++++++---------- 1 file changed, 73 insertions(+), 75 deletions(-) diff --git a/src/content/docs/ko/api/s2s-api/sessions.mdx b/src/content/docs/ko/api/s2s-api/sessions.mdx index 9868d9394..61c22a106 100644 --- a/src/content/docs/ko/api/s2s-api/sessions.mdx +++ b/src/content/docs/ko/api/s2s-api/sessions.mdx @@ -1,122 +1,119 @@ --- -title: S2S(Server-to-server) 세션 -description: 서버 간(S2S) 세션 API는 Adjust가 HTTP 요청을 통해서 세션을 기록할 수 있도록 합니다. -slug: ko/api/s2s-api/sessions +title: "S2S(Server-to-server) 세션" +description: "서버 간(S2S) 세션 API는 Adjust가 HTTP 요청을 통해서 세션을 기록할 수 있도록 합니다." +slug: "en/api/s2s-api/sessions" sidebar-position: 4 -sidebar-label: S2S 세션 +sidebar-label: "S2S 세션" --- - 세션은 Adjust에서의 모든 어트리뷰션과 측정의 기반입니다. 세션은 사용자가 백그라운드에서 앱의 사용을 재개하거나 앱을 실행할 때 발생합니다. 앱 내의 개별 사용자 세션 기록을 위해 S2S 세션 API를 사용하시기 바랍니다. - - + Adjust는 다음의 기능을 활성화해야 합니다. 자세한 정보는 담당 TAM\(테크니컬 어카운트 매니저\)나 [support@adjust.com](mailto:support@adjust.com)으로 문의하시기 바랍니다. + - +시작에 앞서 \{\#before\-you\-begin\} +------------------------------------ -## 시작에 앞서 {#before-you-begin} +### 인증 \{\#authentication\} -### 인증 {#authentication} +[S2S 보안을 설정](/en/api/s2s-api/security)하여 S2S 세션의 보안을 보장하고, 스푸핑된 요청으로부터 보호할 수 있습니다. 이를 위해서는 수신되는 모든 요청에 Adjust 대시보드에서 생성된 인증 토큰이 포함되어야 합니다. 토큰이 포함되어 있지 않거나 올바르지 않은 토큰을 포함한 요청은 Adjust 서버에서 거부됩니다. -[S2S 보안을 설정](/ko/api/s2s-api/security)하여 S2S 세션의 보안을 보장하고, 스푸핑된 요청으로부터 보호할 수 있습니다. 이를 위해서는 수신되는 모든 요청에 Adjust 대시보드에서 생성된 인증 토큰이 포함되어야 합니다. 토큰이 포함되어 있지 않거나 올바르지 않은 토큰을 포함한 요청은 Adjust 서버에서 거부됩니다. - -## 세션 기록 {#record-sessions} +세션 기록 \{\#record\-sessions\} +-------------------------------- Adjust는 리소스를 저장하기 위해 세션을 그룹화합니다. Adjust 서버가 새로운 세션이 트리거된 것으로 간주하려면, 세션 간 최소 30분의 간격이 있어야 합니다. - - + ```text https://s2s.adjust.com/session ``` - + -### 헤더 {#headers} +### 헤더 \{\#headers\} -| 파라미터 | 설명 | 예시 | -| ------------------------ | --------------------------------- | ----------------------------------- | -| `Content-Type` | 하드코드된 POST 페이로드의 유형. | `application/x-www-form-urlencoded` | +| 파라미터 | 설명 | 예시 | +|--------------------------|----------------------------|-------------------------------------| +| `Content-Type` | 하드코드된 POST 페이로드의 유형. | `application/x-www-form-urlencoded` | | `X-Adjust-Forwarded-For` | 디바이스의 IP 주소 | `180.220.253.39` | | `Authorization` | `Bearer` 토큰인 Adjust 인증 토큰. | `Bearer authentication_token` | -### 페이로드 {#payload} +### 페이로드\{\#payload\} 아래의 표에서 파라미터 전체 목록을 확인하시기 바랍니다. -| 파라미터 | 설명 | 예시 | -| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- | -| `s2s`\* | 서버간 파라미터: Adjust 서버가 서버 측 활동을 인식하도록 허용.
항상 `1`이어야 함. | `1` | -| `app_token` | 앱의 고유한 인증 토큰 | `pezwd5bre2xb` | -| `vida` | Vizio 광고 ID, Vizio에만 해당 | `dca2365e-0d78-47c6-aaac-9567846c6c9e` | -| `rida` | Roku 광고 ID, Roku만 해당 | | -| `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` | -| `oaid` | 공개 광고\(익명\) ID | `ed799bac-2537-6122-377a-edebce5db5a5` | -| `imei` | 국제 모바일 기기 식별코드\(IMEI\) | `490154203237518` | -| `android_id` | Android ID, `gps_adid`가 없는 경우에만 전송. Android에만 해당. | `e11a8c233efb29f3` | -| `persistent_ios_uuid` | ios_uuid와 동일하나 Keychain에 저장되어 재설치된 앱이 동일한 값을 갖게 됨. iOS에만 해당. | `3b35fcfb-6115-4cff-830f-e32a248c487d` | -| `app_version` | 본 파라미터는 iOS에서의 빌드 번호, Android에서의 실제 앱 버전을 나타냅니다. | `1.0` | -| `app_version_short` | iOS에서의 실제 앱 버전 번호를 나타냅니다. iOS만 해당 | `1.0` | -| `session_count` | 현재 세션을 포함한 기록된 세션의 숫자. | `1` | +| 파라미터 | 설명 | 예시 | +|-----------------------|---------------------------------------------------------------------------------------------------|---------------------------------------------------| +| `s2s`\* | 서버간 파라미터: Adjust 서버가 서버 측 활동을 인식하도록 허용.
항상 `1`이어야 함. | `1` | +| `app_token` | 앱의 고유한 인증 토큰 | `pezwd5bre2xb` | +| `vida` | Vizio 광고 ID, Vizio에만 해당 | `dca2365e-0d78-47c6-aaac-9567846c6c9e` | +| `rida` | Roku 광고 ID, Roku만 해당 | | +| `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 광고 식별자. 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` | +| `persistent_ios_uuid` | ios\_uuid와 동일하나 Keychain에 저장되어 재설치된 앱이 동일한 값을 갖게 됨. iOS에만 해당. | `3b35fcfb-6115-4cff-830f-e32a248c487d` | +| `app_version` | 본 파라미터는 iOS에서의 빌드 번호, Android에서의 실제 앱 버전을 나타냅니다. | `1.0` | +| `app_version_short` | iOS에서의 실제 앱 버전 번호를 나타냅니다. iOS만 해당 | `1.0` | +| `session_count` | 현재 세션을 포함한 기록된 세션의 숫자. | `1` | | `subsession_count` | 기록된 하위 세션의 숫자. 최초로 기록된 세션\(설치\)은 본 파라미터를 포함하지 않습니다.
이후의 모든 세션은 이전 세션에 대한 하위 세션의 숫자를 포함합니다. | `1` | -| `session_length` | 초 단위 세션 길이. 최초로 기록된 세션\(설치\)은 본 파라미터를 포함하지 않습니다.
이후의 모든 세션은 기존 세션의 길이를 포함합니다. | `123` | -| `time_spent` | 이전 세션에서 활성 상태였던 시간. | `123` | -| `tracking_enabled` | 사용자의 광고 추적 제한\(LAT\) 활성화 여부 표시 | `1` | -| `bundle_id` | 번들 ID. iOS에만 해당. | `com.adjust.example` | -| `package_name` | 패키지 이름. Android에만 해당. | `com.adjust.example` | -| `environment` | `sandbox` \(테스트용\) 또는 `production`\(라이브 트래픽용\) | `sandbox` | -| `country` | 현지 국가 코드 | `de` | -| `language` | 현지 언어 코드 | `en` | -| `os_name` | `ios` 또는 `android` | `ios` | -| `os_version` | 운영체제의 현재 버전. | `11.0` | -| `cpu_type` | CPU의 프로세서 패밀리 | `arm64-v8a` | -| `created_at` | 로컬 기기의 타임스탬프. 시간대를 포함하는 패키지 생성. | `2024-03-23T09:46:47.288Z-0400` | -| `sent_at` | 로컬 기기의 타임스탬프. 시간대를 포함하는 패키지 전송. | `2024-03-23T09:47:47.288Z-0400` | -| `device_type` | 기기 모델 | `Phone (android), iphone` | -| `device_name` | URL 인코딩된 모델 ID | `Moto G (5) Plus, iPhone10,5` | -| `hardware_name` | 디바이스 보드 설정 | `N66AP` | -| `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} - -[EU의 디지털 시장법\(DMA\)](https://help.adjust.com/ko/article/google-compliancy-with-the-dma)에 따라 Google Ads와 Google Marketing Platform은 API에 대한 Adjust의 어트리뷰션 요청을 수신하기 위해 명시적인 동의를 받아야 합니다. - - +| `session_length` | 초 단위 세션 길이. 최초로 기록된 세션\(설치\)은 본 파라미터를 포함하지 않습니다.
이후의 모든 세션은 기존 세션의 길이를 포함합니다. | `123` | +| `time_spent` | 이전 세션에서 활성 상태였던 시간. | `123` | +| `tracking_enabled` | 사용자의 광고 추적 제한\(LAT\) 활성화 여부 표시 | `1` | +| `bundle_id` | 번들 ID. iOS에만 해당. | `com.adjust.example` | +| `package_name` | 패키지 이름. Android에만 해당. | `com.adjust.example` | +| `environment` | `sandbox` \(테스트용\) 또는 `production`\(라이브 트래픽용\) | `sandbox` | +| `country` | 현지 국가 코드 | `de` | +| `language` | 현지 언어 코드 | `en` | +| `os_name` | `ios` 또는 `android` | `ios` | +| `os_version` | 운영체제의 현재 버전. | `11.0` | +| `cpu_type` | CPU의 프로세서 패밀리 | `arm64-v8a` | +| `created_at` | 로컬 기기의 타임스탬프. 시간대를 포함하는 패키지 생성. | `2024-03-23T09:46:47.288Z-0400` | +| `sent_at` | 로컬 기기의 타임스탬프. 시간대를 포함하는 패키지 전송. | `2024-03-23T09:47:47.288Z-0400` | +| `device_type` | 기기 모델 | `Phone (android), iphone` | +| `device_name` | URL 인코딩된 모델 ID | `Moto G (5) Plus, iPhone10,5` | +| `hardware_name` | 디바이스 보드 설정 | `N66AP` | +| `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\} +------------------------------------------------------------------------------------------------------------------------ + +[EU의 디지털 시장법\(DMA\)](https://help.adjust.com/en/article/google-compliancy-with-the-dma)에 따라 Google Ads와 Google Marketing Platform은 API에 대한 Adjust의 어트리뷰션 요청을 수신하기 위해 명시적인 동의를 받아야 합니다. + 귀하가 Google Ads 또는 Google 마케팅 플랫폼을 사용하고 사용자가 EEA\(European Economic Area,유럽 경제 지역\)에 위치한 경우 이러한 옵션을 전달해야 합니다. - - + Adjust는 S2S 세션 및 설치 요청에 대해 다음과 같은 Google DMA 파라미터를 지원합니다. Adjust는 요청 양식에 이러한 파라미터가 있을 것으로 예상합니다. Google Ads를 사용하는 경우 `ad_personalization` 파라미터를 전송하고, Google Marketing Platform을 사용하는 경우 `npa` 파라미터를 전송해야 합니다. -| Key | 값 | 설명 | -| -------------------- | --------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `eea` | | 사용자가 EEA\(유럽경제지역\) 거주자인지 여부와 이에 따라 DMA\(디지털마케팅법\)를 포함한 EU 규정이 해당 사용자와 전환에 적용되는지 여부를 Google에 알려줍니다. | -| `ad_personalization` | | 사용자가 앱을 설치한 후 Google Ads를 통해 맞춤형 광고를 제공받는 데 동의했는지 여부를 알려줍니다. | -| `ad_user_data` | | 사용자가 측정 목적의 개인 정보 공유에 동의했는지 여부를 Google에 알려줍니다.
해당 동의 정보는 광고주들이 Google Ads와 Google Marketing Platform UI에서 명시한 모든 Core Platform Services\(CPS\)에 적용됩니다. | -| `npa` | | 사용자가 앱을 설치한 후 Google Marketing Platform을 통해 맞춤형 광고를 제공받는 데 동의했는지 여부를 알려줍니다. | +| Key | 값 | 설명 | +|----------------------|----------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `eea` | | 사용자가 EEA\(유럽경제지역\) 거주자인지 여부와 이에 따라 DMA\(디지털마케팅법\)를 포함한 EU 규정이 해당 사용자와 전환에 적용되는지 여부를 Google에 알려줍니다. | +| `ad_personalization` | | 사용자가 앱을 설치한 후 Google Ads를 통해 맞춤형 광고를 제공받는 데 동의했는지 여부를 알려줍니다. | +| `ad_user_data` | | 사용자가 측정 목적의 개인 정보 공유에 동의했는지 여부를 Google에 알려줍니다.
해당 동의 정보는 광고주들이 Google Ads와 Google Marketing Platform UI에서 명시한 모든 Core Platform Services\(CPS\)에 적용됩니다. | +| `npa` | | 사용자가 앱을 설치한 후 Google Marketing Platform을 통해 맞춤형 광고를 제공받는 데 동의했는지 여부를 알려줍니다. | -## 예: {#example} +예 \{\#example\} +------------------ - + ```sh 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" ``` - - + ```json { @@ -145,3 +142,4 @@ curl -X "POST" \ ``` + From 8b56edd1ae832b44e2a48ec5670ddb87cab7e51d Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Mon, 2 Dec 2024 09:15:57 +0000 Subject: [PATCH 2/3] File src/content/docs/en/api/s2s-api/sessions.mdx was translated to zh-CN locale --- src/content/docs/zh/api/s2s-api/sessions.mdx | 154 +++++++++---------- 1 file changed, 76 insertions(+), 78 deletions(-) diff --git a/src/content/docs/zh/api/s2s-api/sessions.mdx b/src/content/docs/zh/api/s2s-api/sessions.mdx index 012dca707..a73beea88 100644 --- a/src/content/docs/zh/api/s2s-api/sessions.mdx +++ b/src/content/docs/zh/api/s2s-api/sessions.mdx @@ -1,122 +1,119 @@ --- -title: 服务器到服务器 (S2S) 会话 -description: 服务器到服务器 (S2S) 会话 API 使 Adjust 可以通过 HTTP 请求记录您的会话。 -slug: zh/api/s2s-api/sessions +title: "服务器到服务器 (S2S) 会话" +description: "服务器到服务器 (S2S) 会话 API 使 Adjust 可以通过 HTTP 请求记录您的会话。" +slug: "en/api/s2s-api/sessions" sidebar-position: 4 -sidebar-label: S2S 会话 +sidebar-label: "S2S 会话" --- - 在 Adjust 中，会话是所有归因和监测的基础。当用户打开应用或从后台恢复使用应用时，就会触发会话。您可以通过 S2S 会话 API 记录应用中的每一次会话。 + - - -Adjust 需要为您启用该功能。请联系您的技术客户经理或发送邮件至 support@adjust.com 来完成此步骤。 +Adjust 需要为您启用该功能。请联系您的技术客户经理或发送邮件至 [support@adjust.com](mailto:support@adjust.com) 来完成此步骤。 + - +操作前须知 \{\#before\-you\-begin\} +----------------------------------- -## 操作前须知 {#before-you-begin} +### 认证\{\#authentication\} -### 认证{#authentication} +[设置 S2S 安全](/en/api/s2s-api/security)来保护 S2S 会话的安全，抵御欺诈请求的侵害。设置认证后，每个传入的请求都必须带有您在 Adjust 控制面板中生成的认证识别码。缺失识别码或识别码不正确的请求会被 Adjust 服务器拒绝。 -[设置 S2S 安全](/zh/api/s2s-api/security)来保护 S2S 会话的安全，抵御欺诈请求的侵害。设置认证后，每个传入的请求都必须带有您在 Adjust 控制面板中生成的认证识别码。缺失识别码或识别码不正确的请求会被 Adjust 服务器拒绝。 - -## 记录会话{#record-sessions} +记录会话\{\#record\-sessions\} +------------------------------ Adjust 将会话归为组，以节省资源。也就是说，在一次会话后，必须有至少 30 分钟的间隔，Adjust 服务器才会将下一次触发的会话计为新会话。 - - + ```text https://s2s.adjust.com/session ``` - + -### 标头{#headers} +### 标头\{\#headers\} -| 参数 | 描述 | 示例 | -| ------------------------ | -------------------------------------------- | ----------------------------------- | -| `Content-Type` | 硬编码 POST payload 格式 | `application/x-www-form-urlencoded` | -| `X-Adjust-Forwarded-For` | 设备 IP 地址 | `180.220.253.39` | +| 参数 | 描述 | 示例 | +|--------------------------|--------------------------------|-------------------------------------| +| `Content-Type` | 硬编码 POST payload 格式 | `application/x-www-form-urlencoded` | +| `X-Adjust-Forwarded-For` | 设备 IP 地址 | `180.220.253.39` | | `Authorization` | 您的 Adjust 验证识别码，作为`Bearer`识别码。 | `Bearer authentication_token` | -### Payload {#payload} +### Payload \{\#payload\} 请在下方查看完整参数列表。 -| 参数 | 描述 | 示例 | -| --------------------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- | -| `s2s`\* | 服务器到服务器的参数：允许 Adjust 服务器识别服务器端的活动。 必须始终未`1`。 | `1` | -| `app_token` | 应用的唯一认证识别码 | `pezwd5bre2xb` | -| `vida` | Vizio 广告标识符，仅限 Vizio | `dca2365e-0d78-47c6-aaac-9567846c6c9e` | -| `rida` | Roku 广告标识符，仅限 Roku 设备 | | -| `tifa` | Tizen 操作系统广告标识符，仅限 Samsung | | -| `idfa` | iOS 广告标识符，仅限 iOS 设备 | `29DDE430-CE81-4F00-A50C-689595AAD142` | -| `idfv` | iOS 供应商标识符，仅限 iOS 设备 | `59E27F41-A86B-4560-B585-63161F871C4B` | -| `gps_adid` | Google Play 广告标识符，仅在已添加 Google Play 服务库时发送。仅限安卓设备 | `6cf94580-46c2-490c-b882-2f6ae269b579` | -| `oaid` | 匿名设备标识符 | `ed799bac-2537-6122-377a-edebce5db5a5` | -| `imei` | 国际移动设备识别码 \(IMEI\) | `490154203237518` | -| `android_id` | 安卓标识符，仅在缺失 `gps_adid` 的情况下发送。仅限安卓设备 | `e11a8c233efb29f3` | -| `persistent_ios_uuid` | 与 ios_uuid 相同，但存储在 Keychain 中，以便重装的应用拥有相同的值，仅限 iOS 设备 | `3b35fcfb-6115-4cff-830f-e32a248c487d` | -| `app_version` | 该参数代表 iOS 中的版本号码和安卓中的实际应用版本。 | `1.0` | -| `app_version_short` | 代表 iOS 中的实际应用版本号。仅限 iOS | `1.0` | -| `session_count` | 包括当前会话的已记录会话总数。 | `1` | -| `subsession_count` | 已记录的子会话数量。记录到的首次会话 \(即安装\) 不包含该参数。
其后的所有会话都包含前一次会话的子会话数量。 | `1` | -| `session_length` | 会话时长 \(以秒计\)。跟踪到的首次会话 \(即安装\) 不包含该参数。
其后的所有会话都包含前一次会话的时长。 | `123` | -| `time_spent` | 前次会话中活跃状态时长 | `123` | -| `tracking_enabled` | 说明用户是否启用了限制广告跟踪 \(LAT\) | `1` | -| `bundle_id` | Bundle ID，仅限 iOS 设备。 | `com.adjust.example` | -| `package_name` | 包名，仅限安卓设备。 | `com.adjust.example` | -| `environment` | `sandbox` 用于测试，`production`用于真实流量 | `sandbox` | -| `country` | 国家/地区代码 | `de` | -| `language` | 本地语言代码 | `en` | -| `os_name` | `ios` 或 `android` | `ios` | -| `os_version` | 当前操作系统版本 | `11.0` | -| `cpu_type` | CPU 处理器系列 | `arm64-v8a` | -| `created_at` | 本地设备创建包的时间戳 \(带时区\)。 | `2024-03-23T09:46:47.288Z-0400` | -| `sent_at` | 本地设备发送包的时间戳 \(带时区\)。 | `2024-03-23T09:47:47.288Z-0400` | -| `device_type` | 设备型号 | `Phone (android), iphone` | -| `device_name` | URL 编码模型识别码 | `Moto G (5) Plus, iPhone10,5` | -| `hardware_name` | 设备主板配置 | `N66AP` | -| `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} - -要[符合欧盟的《数字市场法案》\(Digital Markets Act，简称 DMA\)](https://help.adjust.com/zh/article/google-compliancy-with-the-dma)，Google Ads 和 Google Marketing Platform 需要获得明确的用户许可，才能接收 Adjust 向其 API 发送的归因请求。 - - +| 参数 | 描述 | 示例 | +|-----------------------|-------------------------------------------------------------------|---------------------------------------------------| +| `s2s`\* | 服务器到服务器的参数：允许 Adjust 服务器识别服务器端的活动。 必须始终未`1`。 | `1` | +| `app_token` | 应用的唯一认证识别码 | `pezwd5bre2xb` | +| `vida` | Vizio 广告标识符，仅限 Vizio | `dca2365e-0d78-47c6-aaac-9567846c6c9e` | +| `rida` | Roku 广告标识符，仅限 Roku 设备 | | +| `tifa` | Tizen 操作系统广告标识符，仅限 Samsung | | +| `idfa` | iOS 广告标识符，仅限 iOS 设备 | `29DDE430-CE81-4F00-A50C-689595AAD142` | +| `idfv` | iOS 供应商标识符，仅限 iOS 设备 | `59E27F41-A86B-4560-B585-63161F871C4B` | +| `gps_adid` | Google Play 广告标识符，仅在已添加 Google Play 服务库时发送。仅限安卓设备 | `6cf94580-46c2-490c-b882-2f6ae269b579` | +| `oaid` | 匿名设备标识符 | `ed799bac-2537-6122-377a-edebce5db5a5` | +| `imei` | 国际移动设备识别码 \(IMEI\) | `490154203237518` | +| `android_id` | 安卓标识符，仅在缺失 `gps_adid` 的情况下发送。仅限安卓设备 | `e11a8c233efb29f3` | +| `persistent_ios_uuid` | 与 ios\_uuid 相同，但存储在 Keychain 中，以便重装的应用拥有相同的值，仅限 iOS 设备 | `3b35fcfb-6115-4cff-830f-e32a248c487d` | +| `app_version` | 该参数代表 iOS 中的版本号码和安卓中的实际应用版本。 | `1.0` | +| `app_version_short` | 代表 iOS 中的实际应用版本号。仅限 iOS | `1.0` | +| `session_count` | 包括当前会话的已记录会话总数。 | `1` | +| `subsession_count` | 已记录的子会话数量。记录到的首次会话 \(即安装\) 不包含该参数。
其后的所有会话都包含前一次会话的子会话数量。 | `1` | +| `session_length` | 会话时长 \(以秒计\)。记录到的首次会话 \(即安装\) 不包含该参数。
其后的所有会话都包含前一次会话的时长。 | `123` | +| `time_spent` | 前次会话中活跃状态时长 | `123` | +| `tracking_enabled` | 说明用户是否启用了限制广告跟踪 \(LAT\) | `1` | +| `bundle_id` | Bundle ID，仅限 iOS 设备。 | `com.adjust.example` | +| `package_name` | 包名，仅限安卓设备。 | `com.adjust.example` | +| `environment` | `sandbox` 用于测试，`production`用于真实流量 | `sandbox` | +| `country` | 国家/地区代码 | `de` | +| `language` | 本地语言代码 | `en` | +| `os_name` | `ios` 或 `android` | `ios` | +| `os_version` | 当前操作系统版本 | `11.0` | +| `cpu_type` | CPU 处理器系列 | `arm64-v8a` | +| `created_at` | 本地设备创建包的时间戳 \(带时区\)。 | `2024-03-23T09:46:47.288Z-0400` | +| `sent_at` | 本地设备发送包的时间戳 \(带时区\)。 | `2024-03-23T09:47:47.288Z-0400` | +| `device_type` | 设备型号 | `Phone (android), iphone` | +| `device_name` | URL 编码模型识别码 | `Moto G (5) Plus, iPhone10,5` | +| `hardware_name` | 设备主板配置 | `N66AP` | +| `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\} +---------------------------------------------------------------------------------------------------------------------- + +要[符合欧盟的《数字市场法案》\(Digital Markets Act，简称 DMA\)](https://help.adjust.com/en/article/google-compliancy-with-the-dma)，Google Ads 和 Google Marketing Platform 需要获得明确的用户许可，才能接收 Adjust 向其 API 发送的归因请求。 + 如果您使用 Google Ads 或 Google Marketing Platform，且拥有位于欧洲经济区 \(EEA\) 内的用户，则必须发送这些选项。 - - + 对于 S2S 会话和安装请求，Adjust 支持下列 DMA 参数。请将参数添加至请求表格中。 请注意，如果您正在使用 Google Ads，则需要发送`ad_personalization`参数；如果您正在使用 Google Marketing Platform，则需要发送`npa`参数。 -| 密钥 | 值 | 描述 | -| -------------------- | ----------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `eea` | | 告知 Google 用户是否位于 EEA，即包含 DMA 在内的欧洲法律法规是否适用于该用户和转化， | -| `ad_personalization` | | 表明用户是否同意在安装应用后通过 Google Ads 被投放个性化广告。 | -| `ad_user_data` | | 告知 Google 用户是否同意分享个人数据用于监测目的。该许可适用于广告主在 Google Ads 和 Google Marketing Platform 用户界面中指定的所有核心平台服务 \(CPS\)。 | -| `npa` | | 表明用户是否同意在安装应用后通过 Google Marketing Platform 被投放个性化广告。 | +| 密钥 | 值 | 描述 | +|----------------------|---------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------| +| `eea` | | 告知 Google 用户是否位于 EEA，即包含 DMA 在内的欧洲法律法规是否适用于该用户和转化， | +| `ad_personalization` | | 表明用户是否同意在安装应用后通过 Google Ads 被投放个性化广告。 | +| `ad_user_data` | | 告知 Google 用户是否同意分享个人数据用于监测目的。该许可适用于广告主在 Google Ads 和 Google Marketing Platform 用户界面中指定的所有核心平台服务 \(CPS\)。 | +| `npa` | | 表明用户是否同意在安装应用后通过 Google Marketing Platform 被投放个性化广告。 | -## 示例 {#example} +示例 \{\#example\} +------------------- - + ```sh 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" ``` - - + ```json { @@ -145,3 +142,4 @@ curl -X "POST" \ ``` + From f46f814d22e452ddc200a77229c613f3c94e2331 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Mon, 2 Dec 2024 09:16:00 +0000 Subject: [PATCH 3/3] File src/content/docs/en/api/s2s-api/sessions.mdx was translated to ja-JP locale --- src/content/docs/ja/api/s2s-api/sessions.mdx | 150 +++++++++---------- 1 file changed, 74 insertions(+), 76 deletions(-) diff --git a/src/content/docs/ja/api/s2s-api/sessions.mdx b/src/content/docs/ja/api/s2s-api/sessions.mdx index 010d44a3d..ae47eba23 100644 --- a/src/content/docs/ja/api/s2s-api/sessions.mdx +++ b/src/content/docs/ja/api/s2s-api/sessions.mdx @@ -1,122 +1,119 @@ --- -title: サーバー間（S2S）セッション -description: サーバー間（S2S）セッションAPIを使用すると、AdjustはHTTPリクエストを介してセッションを記録します。 -slug: ja/api/s2s-api/sessions +title: "サーバー間（S2S）セッション" +description: "サーバー間（S2S）セッションAPIを使用すると、AdjustはHTTPリクエストを介してセッションを記録します。" +slug: "en/api/s2s-api/sessions" sidebar-position: 4 -sidebar-label: S2Sセッション +sidebar-label: "S2Sセッション" --- - セッションは、Adjustの全てのアトリビューションと計測の基となるものです。ユーザーがバックグラウンドからアプリの利用を再開した時、またはアプリを起動した時にセッションがトリガーされます。サーバー間（S2S）セッションAPIを使用して、アプリ内の各ユーザーセッションを記録してください。 - - + この機能をご利用いただくには、まずはじめにAdjustが機能を有効化する必要があります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 + - +事前準備 \{\#before\-you\-begin\} +---------------------------------- -## 事前準備 {#before-you-begin} +### 認証 \{\#authentication\} -### 認証 {#authentication} +[サーバー間（S2S）セキュリティを設定](/en/api/s2s-api/security)して、サーバー間 \(S2S\) セッションの計測を不正から守ります。そのためには、受信するリクエストごとに、Adjust管理画面で生成されたトークンが付与されている必要があります。トークンが付与されていないリクエスト、または不正なトークンが付与されたリクエストは、Adjustのサーバーによって拒否されます。 -[サーバー間（S2S）セキュリティを設定](/ja/api/s2s-api/security)して、S2Sセッションの計測を不正から守ります。そのためには、受信するリクエストごとに、Adjustダッシュボードで生成されたトークンが付与されている必要があります。トークンが付与されていないリクエスト、または不正なトークンが付与されたリクエストは、Adjustのサーバーによって拒否されます。 - -## セッションを記録する {#record-sessions} +セッションを記録する \{\#record\-sessions\} +------------------------------------- Adjustはセッションをグループ化することでリソースを節約します。つまり、Adjustサーバーが新しいセッションをトリガーされたものとして受け取る前に、1つのセッション後に最低30分間の間隔がなければなりません。 - - + ```text https://s2s.adjust.com/session ``` - + -### ヘッダー {#headers} +### ヘッダー \{\#headers\} -| パラメーター | 説明 | 例 | -| ------------------------ | ---------------------------------------------------- | ----------------------------------- | -| `Content-Type` | ハードコーディングされたPOSTペイロードのフォーマット | `application/x-www-form-urlencoded` | -| `X-Adjust-Forwarded-For` | デバイスのIPアドレス | `180.220.253.39` | +| パラメーター | 説明 | 例 | +|--------------------------|-----------------------------------|-------------------------------------| +| `Content-Type` | ハードコーディングされたPOSTペイロードのフォーマット | `application/x-www-form-urlencoded` | +| `X-Adjust-Forwarded-For` | デバイスのIPアドレス | `180.220.253.39` | | `Authorization` | Adjust認証トークンを`Bearer`トークンとして取得する。 | `Bearer authentication_token` | -### ペイロード {#payload} +### ペイロード \{\#payload\} パラメーターの一覧は、以下の表をご参照ください。 -| パラメーター | 説明 | 例 | -| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- | -| `s2s`\* | サーバー間パラメーター：Adjustサーバーがサーバー側のアクティビティの認識を有効化。 常に`1`である必要があります。 | `1` | -| `app_token` | アプリ固有の認証トークン。 | `pezwd5bre2xb` | -| `vida` | Vizio広告ID、Vizioのみ | `dca2365e-0d78-47c6-aaac-9567846c6c9e` | -| `rida` | Rokuの広告ID、Rokuのみ | | -| `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` | -| `oaid` | Open Advertising（匿名）ID | `ed799bac-2537-6122-377a-edebce5db5a5` | -| `imei` | 国際移動体装置識別番号 | `490154203237518` | -| `android_id` | Android ID、 `gps_adid`がない場合にのみ送信される。Androidのみ | `e11a8c233efb29f3` | -| `persistent_ios_uuid` | ios_uuidと同様ですが、Keychainに保存されるため、再インストールされたアプリは同じ値を持ちます。iOSのみ | `3b35fcfb-6115-4cff-830f-e32a248c487d` | -| `app_version` | このパラメーターはiOSのビルド番号、Androidの実際のアプリバージョンを表します。 | `1.0` | -| `app_version_short` | iOSの実際のアプリバージョン番号を表します。iOSのみ | `1.0` | -| `session_count` | 現在のセッションを含む記録されたセッションの数。 | `1` | +| パラメーター | 説明 | 例 | +|-----------------------|----------------------------------------------------------------------------------------------|---------------------------------------------------| +| `s2s`\* | サーバー間パラメーター：Adjustサーバーがサーバー側のアクティビティの認識を有効化。 常に`1`である必要があります。 | `1` | +| `app_token` | アプリ固有の認証トークン。 | `pezwd5bre2xb` | +| `vida` | Vizio広告ID、Vizioのみ | `dca2365e-0d78-47c6-aaac-9567846c6c9e` | +| `rida` | Rokuの広告ID、Rokuのみ | | +| `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広告識別子、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` | +| `persistent_ios_uuid` | ios\_uuidと同様ですが、Keychainに保存されるため、再インストールされたアプリは同じ値を持ちます。iOSのみ | `3b35fcfb-6115-4cff-830f-e32a248c487d` | +| `app_version` | このパラメーターはiOSのビルド番号、Androidの実際のアプリバージョンを表します。 | `1.0` | +| `app_version_short` | iOSの実際のアプリバージョン番号を表します。iOSのみ | `1.0` | +| `session_count` | 現在のセッションを含む記録されたセッションの数。 | `1` | | `subsession_count` | 記録されたサブセッションの数。初めて記録されたセッションインストールはこのパラメーターを含みません。
その後の全てのセッションは前回のセッションのサブセッションの数を含みます。 | `1` | -| `session_length` | セッションの長さ（秒単位）。初めて記録されたセッションインストールはこのパラメーターを含みません。
その後の全てのセッションは前回のセッションの長さを含みます。 | `123` | -| `time_spent` | 前回のセッション中のアプリ内でのアクティブな経過時間。 | `123` | -| `tracking_enabled` | ユーザーが追跡型広告制限を有効化しているかどうかを示す。 | `1` | -| `bundle_id` | バンドルID、iOSのみ。 | `com.adjust.example` | -| `package_name` | パッケージ名、Androidのみ。 | `com.adjust.example` | -| `environment` | `sandbox` テストまたは`production`ライブトラフィック。 | `sandbox` | -| `country` | 現地の国名コード。 | `de` | -| `language` | 現地の言語コード。 | `en` | -| `os_name` | `ios` または `android` | `ios` | -| `os_version` | OSの現在のバージョン。 | `11.0` | -| `cpu_type` | CPUのプロセッサーファミリー。 | `arm64-v8a` | -| `created_at` | タイムゾーンを含むパッケージが作成された時点のローカルデバイスのタイムスタンプ。 | `2024-03-23T09:46:47.288Z-0400` | -| `sent_at` | タイムゾーンを含むパッケージが送信された時点のローカルデバイスのタイムスタンプ。 | `2024-03-23T09:47:47.288Z-0400` | -| `device_type` | デバイスのモデル。 | `Phone (android), iphone` | -| `device_name` | URLエンコードされたモデルID。 | `Moto G (5) Plus, iPhone10,5` | -| `hardware_name` | デバイスボードの構成。 | `N66AP` | -| `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} - -[EUのデジタル市場法（DMA）に準拠するため、](https://help.adjust.com/ja/article/google-compliancy-with-the-dma)Google 広告およびGoogle マーケティング プラットフォームは、AdjustからAPIへのアトリビューションリクエストを受信することに明示的な同意を必要とします。 - - +| `session_length` | セッションの長さ（秒単位）。初めて記録されたセッションインストールはこのパラメーターを含みません。
その後の全てのセッションは前回のセッションの長さを含みます。 | `123` | +| `time_spent` | 前回のセッション中のアプリ内でのアクティブな経過時間。 | `123` | +| `tracking_enabled` | ユーザーが追跡型広告制限を有効化しているかどうかを示す。 | `1` | +| `bundle_id` | バンドルID、iOSのみ。 | `com.adjust.example` | +| `package_name` | パッケージ名、Androidのみ。 | `com.adjust.example` | +| `environment` | `sandbox` テストまたは`production`ライブトラフィック。 | `sandbox` | +| `country` | 現地の国名コード。 | `de` | +| `language` | 現地の言語コード。 | `en` | +| `os_name` | `ios` または `android` | `ios` | +| `os_version` | OSの現在のバージョン。 | `11.0` | +| `cpu_type` | CPUのプロセッサーファミリー。 | `arm64-v8a` | +| `created_at` | タイムゾーンを含むパッケージが作成された時点のローカルデバイスのタイムスタンプ。 | `2024-03-23T09:46:47.288Z-0400` | +| `sent_at` | タイムゾーンを含むパッケージが送信された時点のローカルデバイスのタイムスタンプ。 | `2024-03-23T09:47:47.288Z-0400` | +| `device_type` | デバイスのモデル。 | `Phone (android), iphone` | +| `device_name` | URLエンコードされたモデルID。 | `Moto G (5) Plus, iPhone10,5` | +| `hardware_name` | デバイスボードの構成。 | `N66AP` | +| `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\} +--------------------------------------------------------------------------------------------------------------------------- + +[EUのデジタル市場法（DMA）に準拠するため、](https://help.adjust.com/en/article/google-compliancy-with-the-dma)Google 広告およびGoogle マーケティング プラットフォームは、AdjustからAPIへのアトリビューションリクエストを受信することに明示的な同意を必要とします。 + Google 広告またはGoogle マーケティング プラットフォームを使用し、ユーザーの所在地が欧州経済領域（EEA）である場合は、これらの情報をパスする必要があります。 - - + Adjustは、S2Sセッションとインストールリクエスト向けに、以下のGoogle DMAをサポートしています。Adjustは、パラメーターがリクエストフォームにあることを要件とします。 Google 広告を使用している場合は`ad_personalization`パラメーターを、Google マーケティング プラットフォームを使用している場合は`npa`パラメーターを送信する必要があります。 -| キー | 値 | 説明 | -| -------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `eea` | | Googleに、ユーザーの所在地がEEAであるかどうか、つまり、DMAを含む欧州の規制がこのユーザーとコンバージョンに適用されるかどうかを通知します。 | -| `ad_personalization` | | アプリのインストール後、Google 広告でパーソナライズされた広告を配信することにユーザーが同意したかどうかを通知します。 | -| `ad_user_data` | | Googleに、ユーザーが個人データが計測目的で共有されることに同意したかどうかを通知します。
この同意は、Google 広告およびGoogle マーケティング プラットフォームのUIで指定した全てのコアプラットフォームサービスCPSの広告主に適用されます。 | -| `npa` | | アプリのインストール後に、Google マーケティング プラットフォームを介してパーソナライズされた広告を配信することにユーザーが同意したかどうかを通知します。 | +| キー | 値 | 説明 | +|----------------------|-----------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------| +| `eea` | | Googleに、ユーザーの所在地がEEAであるかどうか、つまり、DMAを含む欧州の規制がこのユーザーとコンバージョンに適用されるかどうかを通知します。 | +| `ad_personalization` | | アプリのインストール後、Google 広告でパーソナライズされた広告を配信することにユーザーが同意したかどうかを通知します。 | +| `ad_user_data` | | Googleに、ユーザーが個人データが計測目的で共有されることに同意したかどうかを通知します。
この同意は、Google 広告およびGoogle マーケティング プラットフォームのUIで指定した全てのコアプラットフォームサービスCPSの広告主に適用されます。 | +| `npa` | | アプリのインストール後に、Google マーケティング プラットフォームを介してパーソナライズされた広告を配信することにユーザーが同意したかどうかを通知します。 | -## 例 {#example} +例 \{\#example\} +------------------ - + ```sh 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" ``` - - + ```json { @@ -145,3 +142,4 @@ curl -X "POST" \ ``` +