Skip to content

Commit

Permalink
Merge branch 'main' into smartling-translation-completed-ztdp0vgtakqu…
Browse files Browse the repository at this point in the history 
…-from-main
  • Loading branch information
@bzavhorodskyi
bzavhorodskyi authored Jan 9, 2025
2 parents ddf5f40 + fc0de92 commit 4a877d9
Show file tree
Hide file tree
Showing 9 changed files with 57 additions and 63 deletions.
14 changes: 7 additions & 7 deletions src/content/docs/ja/api/s2s-api/sessions.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -14,13 +14,13 @@ sidebar-label: S2Sセッション

</Callout>

## 事前準備 {#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分間の間隔がなければなりません。

Expand Down Expand Up @@ -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` |
Expand Down Expand Up @@ -81,7 +81,7 @@ https://s2s.adjust.com/session
| `install_receipt` | App Store、暗号化により署名されたインストールの受領証、iOSのみ。 | `Super long string representation of the receipt` |
| `ip_address` | デバイスのIPアドレス。<br/>`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へのアトリビューションリクエストを受信することに明示的な同意を必要とします。

Expand All @@ -102,15 +102,15 @@ Google 広告を使用している場合は`ad_personalization`パラメータ
| `ad_user_data` | <ul><li>`1`: ユーザーが同意</li><li>`0`: ユーザーが同意しなかった</li></ul> | Googleに、ユーザーが個人データが計測目的で共有されることに同意したかどうかを通知します。<br/>この同意は、Google 広告およびGoogle マーケティング プラットフォームのUIで指定した全てのコアプラットフォームサービスCPSの広告主に適用されます。 |
| `npa` | <ul><li>`1`: ユーザーが同意</li><li>`0`: ユーザーが同意しなかった</li></ul> | アプリのインストール後に、Google マーケティング プラットフォームを介してパーソナライズされた広告を配信することにユーザーが同意したかどうかを通知します。 |

## 例 {#example}
## 例 \{\#example\}

<CodeBlock title="リクエスト">

```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"

```
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/ja/sdk/android/v5/integrations/tradplus.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ TradPlusSdk.setGlobalImpressionListener(new GlobalImpressionManager.GlobalImpres

@Override
public void onImpressionSuccess(TPAdInfo tpAdInfo) {
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("TradPlus");
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("tradplus_sdk");
double ecpm = Double.valueOf(tpAdInfo.ecpm) / 1000;
adjustAdRevenue.setRevenue(ecpm, "USD");
adjustAdRevenue.setAdRevenueNetwork(tpAdInfo.adSourceName);
Expand Down
20 changes: 9 additions & 11 deletions src/content/docs/ja/sdk/ios/v5/features/att.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ redirects:

| ステータス（Status） | コード | 説明 |
| --------------------------------------------------- | ------ | ---------------------------------------------------------------- |
| `ATTrackingManagerAuthorizationStatusNotDetermined` | `0` | ユーザーがアクセスプロンプトに応答していない。 |
| `ATTrackingManagerAuthorizationStatusNotDetermined` | `0` | ユーザーがアクセスプロンプトに応答していない |
| `ATTrackingManagerAuthorizationStatusRestricted` | `1` | アプリ関連データへのアクセスがデバイスレベルでブロックされている |
| `ATTrackingManagerAuthorizationStatusDenied` | `2` | ユーザーがデバイス計測によるアプリ関連データへのアクセスを拒否 |
| `ATTrackingManagerAuthorizationStatusAuthorized` | `3` | ユーザーがデバイス計測によるアプリ関連データへのアクセスを承認 |
Expand Down Expand Up @@ -50,8 +50,7 @@ ATTのテキスト内容を指定する必要があります。これを行う
Adjust SDKは、カスタムプロンプトを使用した場合、同意ステータスも記録します。初期化前にプロンプトを表示した場合、SDKはインストールイベントと共にステータスを送信します。プロンプトを初期化後に表示した場合は、SDKはユーザーが更新した後に、即時にAdjustサーバーにステータスを送信します。

</Callout>
<Tabs>
<Tab title="Swift" sync="swift">
<Tabs> <Tab title="Swift" sync="swift">

```swift
Adjust.requestAppTrackingAuthorization { status in
Expand Down Expand Up @@ -99,7 +98,7 @@ Adjust.requestAppTrackingAuthorization { status in
</Tab>
</Tabs>
## 現在の承認ステータスを取得 {#get-current-authorization-status}
## 現在の承認ステータスを取得する {#get-current-authorization-status}
<CodeBlock title="メソッドシグネチャー">
Expand Down Expand Up @@ -128,7 +127,7 @@ int authorizationStatus = [Adjust appTrackingAuthorizationStatus];
</Tab>
</Tabs>

## プロンプトのタイミングをカスタム設定 {#custom-prompt-timing}
## プロンプトのタイミングをカスタム設定する {#custom-prompt-timing}

<CodeBlock title="プロパティ宣言">

Expand All @@ -138,15 +137,14 @@ int authorizationStatus = [Adjust appTrackingAuthorizationStatus];

</CodeBlock>

アプリにオンボーディングプロセスまたはチュートリアルが含まれる場合、ユーザーがこのプロセスを完了するまで、ユーザーのATT同意ステータスの送信を遅らせたい場合があります。これを行うには、`attConsentWaitingInterval`プロパティを設定して、データの送信を **最大120秒** 遅延させ、ユーザーに最初のオンボーディングを完了する時間を与えることができます。タイムアウトが終了した後、またはユーザーが同意ステータスを設定した後に、SDKはユーザーの同意ステータスと共に遅延中に記録した全ての情報をAdjustのサーバーに送信します。
アプリにオンボーディングプロセスまたはチュートリアルが含まれる場合、ユーザーがこのプロセスを完了するまで、ユーザーのATT同意ステータスの送信を遅らせたい場合があります。これを行うには、`attConsentWaitingInterval`プロパティを設定して、データの送信を **最大360秒** 遅延させ、ユーザーに最初のオンボーディングを完了する時間を与えることができます。タイムアウトが終了した後、またはユーザーが同意ステータスを設定した後に、SDKはユーザーの同意ステータスと共に遅延中に記録した全ての情報をAdjustのサーバーに送信します。

<Callout type="note">

タイムアウトが終了する前、または同意ステータスを選択する前にユーザーがアプリを閉じた場合、アプリを再度開いたときにタイムアウトが再開されます。

</Callout>
<Tabs>
<Tab title="Swift" sync="swift">
<Tabs> <Tab title="Swift" sync="swift">

```swift
let yourAppToken = "{YourAppToken}"
Expand Down Expand Up @@ -175,14 +173,14 @@ Adjust.initSdk(adjustConfig)
</Tab>
</Tabs>
## iOS 17の同意への対応 {#ios-17-consent-handling}
## iOS 17の同意の取り扱い {#ios-17-consent-handling}
iOS 17のリリースに伴い、Appleは開発者がサードパーティに送信するデータに関する新しいルールを導入しました。開発者がAppleのプライバシーガイドラインに準拠していることを証明できるようにするために、Adjust SDKは **同意する** ユーザーと **同意しない** ユーザーに対して2つの個別のエンドポイントを使用します。
デフォルトでは、Adjust SDKは`analytics.adjust.com`エンドポイントを使用して、 **確率的モデリング** 向けに限られたデータセットをAdjustのサーバーに送信します。このエンドポイントは次の情報を受け取り **ません** 。
- `idfa`: The device ID For Advertisers \(IDFA\).
- `started_at`: The device startup time.
- `idfa`: 広告主のデバイスID（IDFA）。
- `started_at`: デバイスの起動時間。
ユーザーが[ATTに同意](#app-tracking-authorization-wrapper)した場合にのみ、Adjust SDKは **確定的アトリビューション** のためのidfaとstart_atの両方のプロパティにアクセスできるようになり、 `consent.adjust.com`に完全なペイロードを送信します。
Expand Down
14 changes: 7 additions & 7 deletions src/content/docs/ko/api/s2s-api/sessions.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -14,13 +14,13 @@ Adjust는 다음의 기능을 활성화해야 합니다. 자세한 정보는 담

</Callout>

## 시작에 앞서 {#before-you-begin}
## 시작에 앞서 \{\#before\-you\-begin\}

### 인증 {#authentication}

[S2S 보안을 설정](/ko/api/s2s-api/security)하여 S2S 세션의 보안을 보장하고, 스푸핑된 요청으로부터 보호할 수 있습니다. 이를 위해서는 수신되는 모든 요청에 Adjust 대시보드에서 생성된 인증 토큰이 포함되어야 합니다. 토큰이 포함되어 있지 않거나 올바르지 않은 토큰을 포함한 요청은 Adjust 서버에서 거부됩니다.

## 세션 기록 {#record-sessions}
## 세션 기록 \{\#record\-sessions\}

Adjust는 리소스를 저장하기 위해 세션을 그룹화합니다. Adjust 서버가 새로운 세션이 트리거된 것으로 간주하려면, 세션 간 최소 30분의 간격이 있어야 합니다.

Expand All @@ -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}

아래의 표에서 파라미터 전체 목록을 확인하시기 바랍니다.

Expand All @@ -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` |
Expand Down Expand Up @@ -81,7 +81,7 @@ https://s2s.adjust.com/session
| `install_receipt` | 앱 스토어의 암호화 서명된 설치 영수증, iOS만 해당 | `Super long string representation of the receipt` |
| `ip_address` | 디바이스의 IP 주소.<br/>`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의 어트리뷰션 요청을 수신하기 위해 명시적인 동의를 받아야 합니다.

Expand All @@ -102,15 +102,15 @@ Google Ads를 사용하는 경우 `ad_personalization` 파라미터를 전송하
| `ad_user_data` | <ul><li>`1`: 사용자가 동의함</li><li>`0`: 사용자가 동의하지 않음</li></ul> | 사용자가 측정 목적의 개인 정보 공유에 동의했는지 여부를 Google에 알려줍니다.<br/>해당 동의 정보는 광고주들이 Google Ads와 Google Marketing Platform UI에서 명시한 모든 Core Platform Services\(CPS\)에 적용됩니다. |
| `npa` | <ul><li>`1`: 사용자가 동의함</li><li>`0`: 사용자가 동의하지 않음</li></ul> | 사용자가 앱을 설치한 후 Google Marketing Platform을 통해 맞춤형 광고를 제공받는 데 동의했는지 여부를 알려줍니다. |

## 예: {#example}
## 예 \{\#example\}

<CodeBlock title="요청">

```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"

```
Expand Down
Loading

0 comments on commit 4a877d9

Please sign in to comment.