From c038d2afde18542f44a6c852ddb09f03e30ac1da Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:09:04 +0000 Subject: [PATCH 01/42] File src/content/docs/en/sdk/web/features/attribution.mdx was translated to ko-KR locale --- .../docs/ko/sdk/web/features/attribution.mdx | 87 +++++++++---------- 1 file changed, 41 insertions(+), 46 deletions(-) diff --git a/src/content/docs/ko/sdk/web/features/attribution.mdx b/src/content/docs/ko/sdk/web/features/attribution.mdx index 173c1c3a94..c82851c9f5 100644 --- a/src/content/docs/ko/sdk/web/features/attribution.mdx +++ b/src/content/docs/ko/sdk/web/features/attribution.mdx @@ -1,14 +1,12 @@ --- -title: 어트리뷰션 정보 확인 -description: Adjust SDK를 사용하여 어트리뷰션 변경 사항 수신 -slug: ko/sdk/web/features/attribution +title: "Get attribution information" +description: "Listen for attribution changes using the Adjust SDK" +slug: "en/sdk/web/features/attribution" --- +When a user interacts with an Adjust link, their attribution information updates. This can happen if the user interacts with a [deep link](https://help.adjust.com/en/article/deep-links). Information about a user's attribution is represented in an Attribution object. -사용자가 Adjust 링크와 상호작용하면 어트리뷰션 정보가 업데이트됩니다. 이는 사용자가 [딥링크](https://help.adjust.com/ko/article/deep-links)와 상호작용하는 경우에 발생할 수 있습니다. 사용자의 어트리뷰션 관련 정보는 어트리뷰션 객체에 나타납니다. - -어트리뷰션 객체에는 다음 정보가 포함됩니다. - - +The Attribution object contains the following information: + ```js export type AttributionMapT = $ReadOnly<{| @@ -24,31 +22,32 @@ export type AttributionMapT = $ReadOnly<{| |}>; ``` - + -| 값 | 데이터 유형 | 설명 | -| --------------- | ----------- | ----------------------------------------------------------------------------------- | -| `adid` | `string` | 기기의 고유한 Adjust 식별자. | -| `tracker_token` | `string` | 어트리뷰션과 관련된 링크 토큰. | -| `tracker_name` | `string` | 캠페인 링크의 이름. | -| `network` | `string` | 캠페인과 관련된 네트워크. | -| `campaign` | `string` | 어트리뷰션과 관련된 캠페인의 이름. | -| `adgroup` | `string` | 어트리뷰션과 관련된 광고그룹. | -| `creative` | `string` | 어트리뷰션과 관련된 크리에이티브. | -| `click_label` | `string` | 어트리뷰션과 관련된 [클릭 레이블](https://help.adjust.com/ko/article/user-rewards). | -| `state` | `string` | 어트리뷰션의 현재 상태. `installed` 또는 `reattributed` | +| Values | Data type | Description | +|-----------------|-----------|-----------------------------------------------------------------------------------------------------| +| `adid` | `string` | The device's unique Adjust identifier. | +| `tracker_token` | `string` | The link token associated with the attribution. | +| `tracker_name` | `string` | The name of the campaign link. | +| `network` | `string` | The network associate with the campaign. | +| `campaign` | `string` | The name of the campaign associated with the attribution. | +| `adgroup` | `string` | The adgroup associated with the attribution. | +| `creative` | `string` | The creative associated with the attribution. | +| `click_label` | `string` | The [click label](https://help.adjust.com/en/article/user-rewards) associated with the attribution. | +| `state` | `string` | The current state of the attribution. Either `installed` or `reattributed` | -## 어트리뷰션 변경 시 콜백 트리거 {#trigger-a-callback-when-attribution-changes} +Trigger a callback when attribution changes \{\#trigger\-a\-callback\-when\-attribution\-changes\} +---------------------------------------------------------------------------------------------------------- - + ```js attributionCallback: (string, Object) => mixed; ``` - + -SDK는 어트리뷰션 변경 사항을 받고 업데이트가 감지되면 함수를 호출합니다. `initSdk` 메서드의 `attributionCallback` 함수 특정으로 어트리뷰션 콜백 메서드를 설정할 수 있습니다. 함수 내에서 사용자의 어트리뷰션 정보에 액세스할 수 있습니다. +The SDK can listen for attribution changes and call a function when it detects an update. You can set an attribution callback method by specifying an `attributionCallback` function in the `initSdk` method. Within your function, you have access to the user's attribution information. ```js Adjust.initSdk({ @@ -68,46 +67,42 @@ Adjust.initSdk({ }); ``` -## 현재 어트리뷰션 정보 확인 {#get-current-attribution-information} - - - -```js -function getAttribution(): Attribution | undefined; -``` +Get current attribution information \{\#get\-current\-attribution\-information\} +-------------------------------------------------------------------------------------- - + -사용자가 앱을 설치하면 Adjust는 해당 설치를 캠페인에 어트리뷰션합니다. Adjust SDK를 사용하면 설치 캠페인 어트리뷰션 정보에 액세스할 수 있습니다. 이 정보를 반환하려면 `getAttribution` 메서드를 호출하시기 바랍니다. +사용자가 앱을 설치하면 Adjust는 해당 설치를 캠페인에 어트리뷰션합니다. Adjust SDK를 사용하면 설치 캠페인 어트리뷰션 정보에 액세스할 수 있습니다. `waitForAttribution` 메서드는 SDK가 서버에서 어트리뷰션 데이터를 성공적으로 수신했을 때 `promise` 를 반환합니다. ```js -const attribution = Adjust.getAttribution(); +Adjust.waitForAttribution().then((attr) => + console.log(JSON.stringify(attr, undefined, 2)), +); ``` -## 리퍼러 설정 {#set-a-referrer} +Set a referrer \{\#set\-a\-referrer\} +------------------------------------------ - + ```js function setReferrer(referrer: string): void; ``` - - -SDK가 시작될 때 커스텀 클릭 ID로 SDK 클릭을 트리거하는 리퍼러를 설정할 수 있습니다. SDK는 어트리뷰션 목적으로 커스텀 클릭 ID를 Adjust 서버로 전송합니다. + - +You can set a referrer to trigger an SDK click with a custom click ID when the SDK starts. The SDK sends your custom click ID to Adjust's servers for attribution purposes. + -리퍼러가 어트리뷰션에 사용될 수 있도록 최대한 SDK 초기화에 가깝게 이 메서드를 호출하시기 바랍니다. +Call this method as close to initializing the SDK as possible to ensure your referrer is used for attribution. + - - -리퍼러를 설정하려면 `setReferrer` 메서드를 호출하고 리퍼러를 URL 암호화된 `string` 인수로 전달합니다. - - +To set your referrer, call the `setReferrer` method and pass your referrer as a URL\-encoded `string` argument. + ```js Adjust.setReferrer("adjust_external_click_id%3DEXTERNAL_CLICK_ID"); ``` + From 3df1487f7a314bae8d035d5462afa53042200fce Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:09:07 +0000 Subject: [PATCH 02/42] File src/content/docs/en/sdk/web/features/attribution.mdx was translated to zh-CN locale --- .../docs/zh/sdk/web/features/attribution.mdx | 87 +++++++++---------- 1 file changed, 41 insertions(+), 46 deletions(-) diff --git a/src/content/docs/zh/sdk/web/features/attribution.mdx b/src/content/docs/zh/sdk/web/features/attribution.mdx index 27abd34787..09f05a8dab 100644 --- a/src/content/docs/zh/sdk/web/features/attribution.mdx +++ b/src/content/docs/zh/sdk/web/features/attribution.mdx @@ -1,14 +1,12 @@ --- -title: 获取归因信息 -description: 使用 Adjust SDK 监听归因变化 -slug: zh/sdk/web/features/attribution +title: "Get attribution information" +description: "Listen for attribution changes using the Adjust SDK" +slug: "en/sdk/web/features/attribution" --- +When a user interacts with an Adjust link, their attribution information updates. This can happen if the user interacts with a [deep link](https://help.adjust.com/en/article/deep-links). Information about a user's attribution is represented in an Attribution object. -用户与 Adjust 链接交互时，其归因信息会发生更新。用户与[深度链接](https://help.adjust.com/zh/article/deep-links)交互时可能会发生这种情况。用户归因相关信息会在归因对象中展现。 - -归因对象包含下列信息： - - +The Attribution object contains the following information: + ```js export type AttributionMapT = $ReadOnly<{| @@ -24,31 +22,32 @@ export type AttributionMapT = $ReadOnly<{| |}>; ``` - + -| 值 | 数据类型 | 描述 | -| --------------- | -------- | ----------------------------------------------------------------------------- | -| `adid` | `string` | 设备的唯一 Adjust 标识符。 | -| `tracker_token` | `string` | 与归因关联的链接识别码。 | -| `tracker_name` | `string` | 推广活动链接名称 | -| `network` | `string` | 与推广活动关联的渠道。 | -| `campaign` | `string` | 与归因关联的推广活动名称。 | -| `adgroup` | `string` | 与归因关联的广告组。 | -| `creative` | `string` | 与归因关联的素材。 | -| `click_label` | `string` | 与归因关联的 [click label](https://help.adjust.com/zh/article/user-rewards)。 | -| `state` | `string` | 当前归因状态。`installed` 或 `reattributed` | +| Values | Data type | Description | +|-----------------|-----------|-----------------------------------------------------------------------------------------------------| +| `adid` | `string` | The device's unique Adjust identifier. | +| `tracker_token` | `string` | The link token associated with the attribution. | +| `tracker_name` | `string` | The name of the campaign link. | +| `network` | `string` | The network associate with the campaign. | +| `campaign` | `string` | The name of the campaign associated with the attribution. | +| `adgroup` | `string` | The adgroup associated with the attribution. | +| `creative` | `string` | The creative associated with the attribution. | +| `click_label` | `string` | The [click label](https://help.adjust.com/en/article/user-rewards) associated with the attribution. | +| `state` | `string` | The current state of the attribution. Either `installed` or `reattributed` | -## 发生归因变化时触发回传{#trigger-a-callback-when-attribution-changes} +Trigger a callback when attribution changes \{\#trigger\-a\-callback\-when\-attribution\-changes\} +---------------------------------------------------------------------------------------------------------- - + ```js attributionCallback: (string, Object) => mixed; ``` - + -SDK 可监听归因变更并在发现更新时调用一个函数。您可以在 `initSdk` 方法中指定一个 `attributionCallback` 函数，来设置归因回传方法。在函数内，您可以访问用户归因信息。 +The SDK can listen for attribution changes and call a function when it detects an update. You can set an attribution callback method by specifying an `attributionCallback` function in the `initSdk` method. Within your function, you have access to the user's attribution information. ```js Adjust.initSdk({ @@ -68,46 +67,42 @@ Adjust.initSdk({ }); ``` -## 获取当前归因信息{#get-current-attribution-information} - - - -```js -function getAttribution(): Attribution | undefined; -``` +Get current attribution information \{\#get\-current\-attribution\-information\} +-------------------------------------------------------------------------------------- - + -用户安装您的应用时，Adjust 会将该安装归因至一个推广活动。Adjust SDK 可提供赢得安装归因的推广活动细节。要返回此信息，请调用 `getAttribution` 方法。 +用户安装您的应用时，Adjust 会将该安装归因至一个推广活动。Adjust SDK 可提供赢得安装归因的推广活动细节。`waitForAttribution`方法会返回一个`promise`，当 SDK 成功从服务器接收到归因数据时，该 promise 会被完成。 ```js -const attribution = Adjust.getAttribution(); +Adjust.waitForAttribution().then((attr) => + console.log(JSON.stringify(attr, undefined, 2)), +); ``` -## 设置 referrer {#set-a-referrer} +Set a referrer \{\#set\-a\-referrer\} +------------------------------------------ - + ```js function setReferrer(referrer: string): void; ``` - - -您可以创建一个 referrer，来在 SDK 启动后触发带有自定义点击 ID 的 SDK 点击。SDK 会将您的自定义点击 ID 发送到 Adjust 服务器用于归因。 + - +You can set a referrer to trigger an SDK click with a custom click ID when the SDK starts. The SDK sends your custom click ID to Adjust's servers for attribution purposes. + -在尽可能靠近 SDK 初始化的节点调用此方法，确保您的 referrer 被用于归因。 +Call this method as close to initializing the SDK as possible to ensure your referrer is used for attribution. + - - -要设置 referrer，请调用 `setReferrer` 方法并以 URL 编码 `string` 参数的形式传递 referrer。 - - +To set your referrer, call the `setReferrer` method and pass your referrer as a URL\-encoded `string` argument. + ```js Adjust.setReferrer("adjust_external_click_id%3DEXTERNAL_CLICK_ID"); ``` + From 54b63cc66cb2a1f496a30d881ff5c7cadcfd0ea8 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:09:09 +0000 Subject: [PATCH 03/42] File src/content/docs/en/sdk/web/features/attribution.mdx was translated to ja-JP locale --- .../docs/ja/sdk/web/features/attribution.mdx | 87 +++++++++---------- 1 file changed, 41 insertions(+), 46 deletions(-) diff --git a/src/content/docs/ja/sdk/web/features/attribution.mdx b/src/content/docs/ja/sdk/web/features/attribution.mdx index 71ef8cdbe6..012e963838 100644 --- a/src/content/docs/ja/sdk/web/features/attribution.mdx +++ b/src/content/docs/ja/sdk/web/features/attribution.mdx @@ -1,14 +1,12 @@ --- -title: アトリビューション情報の取得 -description: Adjust SDKを使ってアトリビューションの変更を受信します。 -slug: ja/sdk/web/features/attribution +title: "Get attribution information" +description: "Listen for attribution changes using the Adjust SDK" +slug: "en/sdk/web/features/attribution" --- +When a user interacts with an Adjust link, their attribution information updates. This can happen if the user interacts with a [deep link](https://help.adjust.com/en/article/deep-links). Information about a user's attribution is represented in an Attribution object. -ユーザーがAdjustリンクをクリックすると、そのアトリビューション情報が更新されます。これは、ユーザーが[ディープリンク](https://help.adjust.com/ja/article/deep-links)をクリックした場合に発生します。ユーザーのアトリビューションについての情報は、アトリビューションオブジェクトに表示されます。 - -アトリビューションオブジェクトは以下の情報を含んでいます。 - - +The Attribution object contains the following information: + ```js export type AttributionMapT = $ReadOnly<{| @@ -24,31 +22,32 @@ export type AttributionMapT = $ReadOnly<{| |}>; ``` - + -| 値 | データタイプ | 説明 | -| --------------- | ------------ | ------------------------------------------------------------------------------------------------------- | -| `adid` | `string` | デバイス固有のAdjust識別子 | -| `tracker_token` | `string` | アトリビューションに関連付けられているリンクトークン | -| `tracker_name` | `string` | キャンペーンリンクの名前 | -| `network` | `string` | キャンペーンに関連付けられているネットワーク | -| `campaign` | `string` | アトリビューションに関連付けられているキャンペーンの名前 | -| `adgroup` | `string` | アトリビューションに関連付けられているアドグループ | -| `creative` | `string` | アトリビューションに関連付けられているクリエイティブ | -| `click_label` | `string` | アトリビューションに関連付けられている[クリックラベル](https://help.adjust.com/ja/article/user-rewards) | -| `state` | `string` | アトリビューションの現在のステータス。`installed`または `reattributed` | +| Values | Data type | Description | +|-----------------|-----------|-----------------------------------------------------------------------------------------------------| +| `adid` | `string` | The device's unique Adjust identifier. | +| `tracker_token` | `string` | The link token associated with the attribution. | +| `tracker_name` | `string` | The name of the campaign link. | +| `network` | `string` | The network associate with the campaign. | +| `campaign` | `string` | The name of the campaign associated with the attribution. | +| `adgroup` | `string` | The adgroup associated with the attribution. | +| `creative` | `string` | The creative associated with the attribution. | +| `click_label` | `string` | The [click label](https://help.adjust.com/en/article/user-rewards) associated with the attribution. | +| `state` | `string` | The current state of the attribution. Either `installed` or `reattributed` | -## アトリビューションの変更時にコールバックをトリガーする {#trigger-a-callback-when-attribution-changes} +Trigger a callback when attribution changes \{\#trigger\-a\-callback\-when\-attribution\-changes\} +---------------------------------------------------------------------------------------------------------- - + ```js attributionCallback: (string, Object) => mixed; ``` - + -SDKはアトリビューションの変更を受信し、更新を検出したときに関数を呼び出すことができます。アトリビューションコールバックメソッドを設定するには、`initSdk`メソッドで`attributionCallback`関数を指定します。関数内で、ユーザーのアトリビューション情報にアクセスすることができます。 +The SDK can listen for attribution changes and call a function when it detects an update. You can set an attribution callback method by specifying an `attributionCallback` function in the `initSdk` method. Within your function, you have access to the user's attribution information. ```js Adjust.initSdk({ @@ -68,46 +67,42 @@ Adjust.initSdk({ }); ``` -## 現在のアトリビューション情報を取得する {#get-current-attribution-information} - - - -```js -function getAttribution(): Attribution | undefined; -``` +Get current attribution information \{\#get\-current\-attribution\-information\} +-------------------------------------------------------------------------------------- - + -ユーザーがアプリをインストールすると、Adjustはそのインストールをキャンペーンにアトリビュートします。Adjust SDKでは、インストールのキャンペーンアトリビューションの詳細にアクセスすることができます。この情報を返すには、`getAttribution`メソッドを呼び出します。 +ユーザーがアプリをインストールすると、Adjustはそのインストールをキャンペーンにアトリビュートします。Adjust SDKを実装することで、インストールのキャンペーンアトリビューションの詳細にアクセスすることが可能です。`waitForAttribution`メソッドは、SDKがサーバーからアトリビューションデータを正常に受信すると解析される`promise`を返します。 ```js -const attribution = Adjust.getAttribution(); +Adjust.waitForAttribution().then((attr) => + console.log(JSON.stringify(attr, undefined, 2)), +); ``` -## リファラーを設定する {#set-a-referrer} +Set a referrer \{\#set\-a\-referrer\} +------------------------------------------ - + ```js function setReferrer(referrer: string): void; ``` - - -SDKの開始時にカスタムクリックIDでSDKクリックのトリガーとなるリファラーを設定することができます。SDKは、アトリビューションの目的でカスタムクリックIDをAdjustのサーバーに送信します。 + - +You can set a referrer to trigger an SDK click with a custom click ID when the SDK starts. The SDK sends your custom click ID to Adjust's servers for attribution purposes. + -アトリビューションにリファラーが使用されるように、SDKの初期化時にできる限り近い時点でこのメソッドを呼び出してください。 +Call this method as close to initializing the SDK as possible to ensure your referrer is used for attribution. + - - -リファラーを設定するには、`setReferrer`メソッドを呼び出し、URLエンコードされた`string`引数としてリファラーをパスします。 - - +To set your referrer, call the `setReferrer` method and pass your referrer as a URL\-encoded `string` argument. + ```js Adjust.setReferrer("adjust_external_click_id%3DEXTERNAL_CLICK_ID"); ``` + From dd65ba85638f01c37bc02e91bf4305a5b8b4e141 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:09:13 +0000 Subject: [PATCH 04/42] File src/content/docs/en/sdk/web/features/device-info.mdx was translated to ko-KR locale --- .../docs/ko/sdk/web/features/device-info.mdx | 27 +++++++++---------- 1 file changed, 12 insertions(+), 15 deletions(-) diff --git a/src/content/docs/ko/sdk/web/features/device-info.mdx b/src/content/docs/ko/sdk/web/features/device-info.mdx index 628fad253d..d9ba4116c4 100644 --- a/src/content/docs/ko/sdk/web/features/device-info.mdx +++ b/src/content/docs/ko/sdk/web/features/device-info.mdx @@ -1,25 +1,22 @@ --- -title: 디바이스 정보 확인 -description: 해당 메서드를 사용하여 콜백에 세부 정보를 추가하고 리포트를 보완하시기 바랍니다. -slug: ko/sdk/web/features/device-info +title: "Get device information" +description: "Use these methods to add details to your callbacks and improve your reporting." +slug: "en/sdk/web/features/device-info" --- +The Adjust SDK contains helper methods that return device information. Use these methods to add details to your callbacks and improve your reporting. -Adjust SDK는 디바이스 정보를 반환하는 헬프 메서드가 포함되어 있습니다. 해당 메서드를 사용하여 콜백에 세부 정보를 추가하고 리포트를 보완하시기 바랍니다. +Web UUID \{\#web\-uuid\} +---------------------------- -## 웹 UUID {#web-uuid} + - +웹 SDK는 Adjust에서 웹 사용자를 식별하기 위해 첫 세션 전송 시 고유한 `web_uuid` 식별자를 생성합니다. 이 ID는 UUID\(Universally Unique Identifier\) 형식을 따릅니다. -```js -function getWebUUID(): string | undefined; -``` - - +`waitForWebUUID` 메서드는 `web_uuid` 가 생성되거나 브라우저 저장소\(`IndexedDB` 또는 사용 가능한 경우 `LocalStorage`\)에서 가져온 경우에 `promise` 를 반환합니다. -웹 SDK는 Adjust에서 웹 사용자를 식별하기 위해 첫 세션 전송 시 고유한 `web_uuid`를 생성합니다. 이 ID는 하위 도메인 및 브라우저 별로 생성됩니다. 이 ID는 UUID\(Universally Unique Identifier\) 형식을 따릅니다. - -`getWebUUID` 메서드를 호출하면 이 정보가 `string`로 반한됩니다. +Call the `waitForWebUUID` method to return this information as a `string`. ```js -const webUUID = Adjust.getWebUUID(); +Adjust.waitForWebUUID().then((webUuid) => console.log(webUuid)); ``` + From e11e3d4761bc1c3e0a80594731175cc2df478509 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:09:16 +0000 Subject: [PATCH 05/42] File src/content/docs/en/sdk/web/features/device-info.mdx was translated to zh-CN locale --- .../docs/zh/sdk/web/features/device-info.mdx | 27 +++++++++---------- 1 file changed, 12 insertions(+), 15 deletions(-) diff --git a/src/content/docs/zh/sdk/web/features/device-info.mdx b/src/content/docs/zh/sdk/web/features/device-info.mdx index 2806aae7b5..3cb56a3ccb 100644 --- a/src/content/docs/zh/sdk/web/features/device-info.mdx +++ b/src/content/docs/zh/sdk/web/features/device-info.mdx @@ -1,25 +1,22 @@ --- -title: 获取设备信息 -description: 用这些方法来向回传添加细节信息，优化报告。 -slug: zh/sdk/web/features/device-info +title: "Get device information" +description: "Use these methods to add details to your callbacks and improve your reporting." +slug: "en/sdk/web/features/device-info" --- +The Adjust SDK contains helper methods that return device information. Use these methods to add details to your callbacks and improve your reporting. -Adjust SDK 包含能够返回设备信息的辅助方法。用这些方法来向回传添加细节信息，优化报告。 +Web UUID \{\#web\-uuid\} +---------------------------- -## Web UUID {#web-uuid} + - +为在 Adjust 中识别网页用户，Adjust Web SDK 会在发送第一次会话时生成唯一的 `web_uuid` 标识符。该标识符采用通用唯一标识符 \(UUID\) 格式。 -```js -function getWebUUID(): string | undefined; -``` - - +`waitForWebUUID`方法会返回一个`promise` 。该 promise 会在生成或从浏览器存储\(`IndexedDB`或`LocalStorage`）中调取到`web_uuid`时完成。 -为在 Adjust 中识别网页用户，Adjust Web SDK 会在发送第一次会话时生成唯一的 `web_uuid`。该 ID 是基于每个子域和每个浏览器生成的，该 ID 采用通用唯一标识符 \(UUID\) 格式。 - -调用 `getWebUUID` 方法来通过 `string` 的形式返回此信息。 +Call the `waitForWebUUID` method to return this information as a `string`. ```js -const webUUID = Adjust.getWebUUID(); +Adjust.waitForWebUUID().then((webUuid) => console.log(webUuid)); ``` + From c5ab72b38d346d5a3fb9c6cae3d6d0a0c5e7997f Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:09:18 +0000 Subject: [PATCH 06/42] File src/content/docs/en/sdk/web/features/device-info.mdx was translated to ja-JP locale --- .../docs/ja/sdk/web/features/device-info.mdx | 27 +++++++++---------- 1 file changed, 12 insertions(+), 15 deletions(-) diff --git a/src/content/docs/ja/sdk/web/features/device-info.mdx b/src/content/docs/ja/sdk/web/features/device-info.mdx index d2d1118177..39584b9965 100644 --- a/src/content/docs/ja/sdk/web/features/device-info.mdx +++ b/src/content/docs/ja/sdk/web/features/device-info.mdx @@ -1,25 +1,22 @@ --- -title: デバイス情報の取得 -description: これらのメソッドを使用することでコールバックに詳細を追加し、レポートを改善させましょう。 -slug: ja/sdk/web/features/device-info +title: "Get device information" +description: "Use these methods to add details to your callbacks and improve your reporting." +slug: "en/sdk/web/features/device-info" --- +The Adjust SDK contains helper methods that return device information. Use these methods to add details to your callbacks and improve your reporting. -Adjust SDKには、デバイス情報を返すヘルパーメソッドが含まれています。これらのメソッドを使用することでコールバックに詳細を追加し、レポートを改善させましょう。 +Web UUID \{\#web\-uuid\} +---------------------------- -## Web UUID {#web-uuid} + - +AdjustがWebユーザーを識別するために、Web SDKはセッションを送信する際に一意の`web_uuid`を生成します。IDはUniversally Unique Identifier（UUID）のフォーマットです。 -```js -function getWebUUID(): string | undefined; -``` - - +`waitForWebUUID`メソッドは、`web_uuid`が生成されるかブラウザのストレージから取得されると解決される`promise`を返します（可用性に応じて`IndexedDB`または`LocalStorage`）。 -AdjustがWebユーザーを識別するために、Web SDKはセッションを送信する際に一意の`web_uuid`を生成します。IDはサブドメインごとおよびブラウザーごとに作成されます。IDはUniversally Unique Identifier（UUID）のフォーマットです。 - -`getWebUUID`メソッドを呼び出して、この情報を`string`として返します。 +Call the `waitForWebUUID` method to return this information as a `string`. ```js -const webUUID = Adjust.getWebUUID(); +Adjust.waitForWebUUID().then((webUuid) => console.log(webUuid)); ``` + From a1fbb1f035f818707581b3378e013e523d2f830f Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:09:21 +0000 Subject: [PATCH 07/42] File src/content/docs/en/sdk/web/features/privacy.mdx was translated to ko-KR locale --- .../docs/ko/sdk/web/features/privacy.mdx | 188 ++++++++++++------ 1 file changed, 131 insertions(+), 57 deletions(-) diff --git a/src/content/docs/ko/sdk/web/features/privacy.mdx b/src/content/docs/ko/sdk/web/features/privacy.mdx index cee924e393..6475cce626 100644 --- a/src/content/docs/ko/sdk/web/features/privacy.mdx +++ b/src/content/docs/ko/sdk/web/features/privacy.mdx @@ -1,119 +1,193 @@ --- -title: 프라이버시 기능 설정 -description: 앱에서 사용자 프라이버시를 관리할 수 있는 기능을 구성합니다. -slug: ko/sdk/web/features/privacy +title: "Set up privacy features" +description: "Configure features that you can use to handle user privacy in your app." +slug: "en/sdk/web/features/privacy" --- +The Adjust SDK contains features that you can use to handle user privacy in your app. -Adjust SDK에는 앱에서 사용자 프라이버시를 관리할 수 있는 기능이 포함되어 있습니다. +Send erasure request \{\#send\-erasure\-request\} +------------------------------------------------------ -## 삭제 요청 전송 {#send-erasure-request} - - + ```js function gdprForgetMe(): void; ``` - + -EU의 개인정보 보호 규정\(GDPR\) 및 유사한 전 세계 개인정보 보호법\(CCPA, LGPD 등\)은 데이터 주체에게 개인 데이터 처리와 관련하여 포괄적인 권리를 부여합니다. 이러한 권리에는 삭제 권리\( [GDPR 17조](https://gdpr.eu/article-17-right-to-be-forgotten/) 참조\)\([1](https://help.adjust.com/ko/article/gdpr#ref-1)\)가 포함됩니다. 데이터 처리자로서 Adjust는 귀하의 \(앱\) 사용자의 이러한 요청을 처리하는 데 있어 귀하\(데이터 컨트롤러\)를 지원할 의무가 있습니다. +The EU’s General Data Protection Regulation \(GDPR\) and similar privacy laws worldwide \(CCPA, LGPD, etc.\) grant data subjects comprehensive rights when it comes to the processing of their personal data. These rights include, among others, the right to erasure \(see [Art. 17 GDPR](https://gdpr.eu/article-17-right-to-be-forgotten/)\)\([1](https://help.adjust.com/en/article/gdpr#ref-1)\). As a data processor, Adjust is obliged to support you \(the data controller\) in the processing of such requests from your \(app\) users. -`gdprForgetMe` 메서드를 호출하여 사용자의 삭제 요청을 Adjust로 전송할 수 있습니다. Adjust가 알림을 받은 경우: +You can send the user's erasure request to Adjust by calling the `gdprForgetMe` method. Once Adjust has been notified: -- Adjust는 내부 시스템과 데이터베이스에서 해당 사용자의 모든 과거 개인 정보를 영구적으로 삭제합니다. -- Adjust는 더 이상 Adjust SDK를 통해 해당 사용자/기기로부터 데이터를 수신하지 않습니다.\([2](https://help.adjust.com/ko/article/gdpr#ref-2)\) +* Adjust will permanently delete all of the user’s historical personal data from its internal systems and database. +* Adjust will no longer receive data from this user/device via the Adjust SDK.\([2](https://help.adjust.com/en/article/gdpr#ref-2)\) ```js Adjust.gdprForgetMe(); ``` -## 서드파티 공유 비활성화 {#disable-third-party-sharing} +특정 사용자에 대한 서드파티 공유 \{\#third\-party\-sharing\-for\-specific\-users\} +---------------------------------------------------------------------------- - + -```js -function disableThirdPartySharing(): void; +Adjust SDK를 사용하여 사용자의 서드파티 공유 설정 변경 내용을 기록할 수 있습니다. 이러한 설정은 `ThirdPartySharing` 클래스를 사용하여 구성됩니다. + +### AdjustThirdPartySharing 객체 인스턴스화 \{\#instantiate\-an\-adjustthirdpartysharing\-object\} + + + +```ts +class ThirdPartySharing { + constructor(isEnabled: boolean) {} + // ... +} ``` - + -모든 사용자의 서드파티 공유를 비활성화하려면 `disableThirdPartySharing` 메서드를 호출합니다. Adjust 서버가 이 정보를 수신하면 Adjust는 해당 사용자의 데이터를 서드파티와 공유하는 것을 중단합니다. Adjust SDK의 작동에는 문제가 없습니다. +Adjust SDK와의 서드파트 공유를 활성화 또는 비활성화하려면 `ThirdPartySharing` 객체를 인스턴스화합니다. 이 객체에 Adjust의 서드파티 공유 처리 방식을 제어하는 변수가 포함됩니다. -```js -Adjust.disableThirdPartySharing(); +이를 인스턴스화하려면 새로운 `ThirdPartySharing` 인스턴스를 생성하고 다음 파라미터를 전달합니다. + +* `isEnabled` \(`boolean`\):`true` 전달로 서드파티 공유를 활성화하거나 `false` 전달로 서드파티 공유를 비활성화합니다. + +```ts +const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); ``` -## 데이터 레지던시 {#data-residency} +`false`로 설정하면 Adjust는 사용자의 데이터를 서드파티와 공유하는 것을 중단합니다. Adjust SDK의 작동에는 문제가 없습니다. - +Adjust로 정보를 전송하려면 `ThirdPartySharing` 인스턴스를 인수로 사용하여 `Adjust.trackThirdPartySharing` 메서드를 호출합니다. -```js -dataResidency: "EU" | "TR" | "US"; +```ts +const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); +Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` - +### 서드파티 공유 비활성화\(지원 중단\) \{\#disable\-third\-party\-sharing\} -데이터 레지던시를 사용하면 Adjust가 데이터를 저장할 국가를 선택할 수 있습니다. 본 기능은 프라이버시 요건이 엄격한 나라에서 앱을 운영하는 경우에 유용합니다. 데이터 레지던시를 설정하면 Adjust는 선택한 지역의 데이터 센터에 고객의 데이터를 저장합니다. + -데이터 레지던시 국가를 설정하려면 `initSdk` 메서드의 `dataResidency` 속성 내 선호하는 국가의 지역 코드를 전송하십시오. +이전 버전의 SDK에서 서드파티 공유를 비활성화하려면 `disableThirdPartySharing` 메서드를 호출합니다. 이 메서드는 지원 중단되었습니다. 계속 사용할 경우 기본 메서드를 직접 호출하게 됩니다. -| 지역 | 코드 | -| --------- | ---- | -| 유럽 연합 | `EU` | -| 터키 | `TR` | -| 미국 | `US` | +```ts +const adjustThirdPartySharing = new Adjust.ThirdPartySharing(false); +Adjust.trackThirdPartySharing(adjustThirdPartySharing); +``` -```js -Adjust.initSdk({ - appToken: "YOUR_APP_TOKEN", - environment: "production", - logLevel: "verbose", - dataResidency: "EU", -}); +### 세분화된 정보 전송 \{\#send\-granular\-information\} + + + +```ts +public addGranularOption(partnerName: string, + key: string, + value: string) ``` -## URL 전략 {#url-strategy} + - +서드파티 공유 설정 변경 시 세부 정보를 추가할 수 있습니다. 이를 통해 사용자의 결정에 대한 더욱 자세한 정보를 전달할 수 있습니다. -```js -urlStrategy: "india" | "china"; +다음 파라미터와 함께 `addGranularOption` 메서드를 호출합니다. + +* `partnerName` \(`string`\): 세분화 옵션을 적용할 파트너의 이름 +* `key` \(`string`\): 옵션 키 +* `value` \(`string`\): 옵션 값 + +```ts +const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); +options.addGranularOption("PartnerA", "foo", "bar"); +Adjust.trackThirdPartySharing(options); ``` - +URL strategy \{\#url\-strategy\} +------------------------------------ + + + +URL 전략 기능을 사용하여 다음을 설정할 수 있습니다. + +* Adjust가 귀하의 데이터를 저장하는 국가\(데이터 레지던시\). +* Adjust SDK가 트래픽을 전송하는 엔드포인트\(맞춤 URL\). + +본 기능은 프라이버시 요건이 엄격한 나라에서 앱을 운영하는 경우에 유용합니다. URL 전략을 설정하면 Adjust가 선택된 데이터 레지던시 지역에 데이터를 저장하거나 선택된 도메인으로 트래픽을 전송합니다. -URL 전략을 설정하면 Adjust SDK에서 데이터를 보낼 지역별 엔드포인트의 우선 순위를 지정할 수 있습니다. 이 작업을 위해서는 `initSdk` 메서드의 `urlStrategy` 속성 내에 선호하는 국가 코드 지역을 전송하십시오. +URL 전략을 구성하려면 `Adjust.initSdk` 인스턴스에 `urlStrategy` 의 다음 속성을 설정합니다. -| 지역 | 코드 | -| ---- | ------- | -| 중국 | `china` | -| 인도 | `india` | +* `domains` \(`Array`\): SDK 트래픽을 전송할 데이터 레지던스 국가 또는 엔드포인트. 기본 설정에 따라 Adjust SDK는 모든 데이터를 Adjust의 엔드포인트로 전송합니다. 커스텀 엔드포인트를 설정하려면 `urlStrategy`의 `domains` 속성에 엔드포인트를 전달합니다. +* `useSubdomains` \(`boolean`\): 도메인을 Adjust 도메인으로 취급할지 여부. + * `true`인 경우 SDK는 도메인의 접두사로 Adjust에 특화된 하위 도메인을 사용합니다. + * `false`인 경우 SDK는 접두사 없이 제공된 도메인을 그대로 사용합니다. + +* `isDataResidency` \(`boolean`\): 선택 사항으로, 도메인을 데이터 레지던시에 사용해야 하는지 여부입니다. + +다음 표는 구성 목록을 보여줍니다. + +| URL 전략 | 기본 도메인 및 커스텀 도메인 | 하위 도메인 사용 | 데이터 레지던시 | +|-------------|-------------------------------|-----------|----------| +| EU 데이터 레지던시 | `"eu.adjust.com"` | `true` | `true` | +| 중국 URL 전략 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | +| 맞춤 URL 전략 | `"my.custom.domain"` | `false` | `false` | ```js Adjust.initSdk({ appToken: "YOUR_APP_TOKEN", environment: "production", logLevel: "verbose", - urlStrategy: "china", + urlStrategy: { + domains: ["adjust.cn", "adjust.com"], + useSubdomains: true, + isDataResidency: false, + }, }); ``` -## 커스텀 엔드포인트 설정 {#set-custom-endpoint} +### 커스텀 엔드포인트 설정\(지원 중단\) \{\#set\-custom\-endpoint\} - + + +이전 버전의 SDK는 지원 중단된 `customUrl` 속성을 사용하여 엔드포인트를 전달했습니다. 대신 `urlStrategy` 구성을 사용하시기 바랍니다. + ```js -customUrl: string; +Adjust.initSdk({ + appToken: "YOUR_APP_TOKEN", + environment: "production", + logLevel: "verbose", + customUrl: "my.custom.domain.com", + urlStrategy: { + domains: ["my.custom.domain"], + useSubdomains: false, + isDataResidency: false, + }, +}); ``` - + + +### 데이터 레지던시\(지원 중단\) \{\#data\-residency\} + + -기본 설정에 따라 Adjust SDK는 모든 데이터를 Adjust의 엔드포인트로 전송합니다. 커스텀 엔드포인트를 지정하고 싶으시다면 `initSdk` 메서드의 `customUrl` 속성의 엔드포인트를 전송하십시오. +이전 버전의 SDK는 지원 중단된 `dataResidency` 속성을 사용했습니다. 대신 `urlStrategy` 구성을 사용하시기 바랍니다. + ```js Adjust.initSdk({ appToken: "YOUR_APP_TOKEN", - environment: "sandbox", - customUrl: "https://my-custom-url.com/", + environment: "production", + logLevel: "verbose", + dataResidency: "EU", + urlStrategy: { + domains: ["eu.adjust.com"], + useSubdomains: true, + isDataResidency: true, + }, }); ``` + + + From 21b03e2141786bc1e31957d9fe9c4dfe5f3a88d0 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:09:23 +0000 Subject: [PATCH 08/42] File src/content/docs/en/sdk/web/features/privacy.mdx was translated to zh-CN locale --- .../docs/zh/sdk/web/features/privacy.mdx | 188 ++++++++++++------ 1 file changed, 131 insertions(+), 57 deletions(-) diff --git a/src/content/docs/zh/sdk/web/features/privacy.mdx b/src/content/docs/zh/sdk/web/features/privacy.mdx index c508336f07..4ac91e7cdb 100644 --- a/src/content/docs/zh/sdk/web/features/privacy.mdx +++ b/src/content/docs/zh/sdk/web/features/privacy.mdx @@ -1,119 +1,193 @@ --- -title: 设置隐私功能 -description: 配置处理应用用户隐私的功能。 -slug: zh/sdk/web/features/privacy +title: "Set up privacy features" +description: "Configure features that you can use to handle user privacy in your app." +slug: "en/sdk/web/features/privacy" --- +The Adjust SDK contains features that you can use to handle user privacy in your app. -Adjust SDK 包含处理应用用户隐私的功能。 +Send erasure request \{\#send\-erasure\-request\} +------------------------------------------------------ -## 发送删除请求{#send-erasure-request} - - + ```js function gdprForgetMe(): void; ``` - + -在处理个人数据方面，欧盟的《通用数据保护条例》\(GDPR\) 和全球类似的隐私法律 \(CCPA、LGPD 等\) 授予数据主体完全权利，其中包括删除权 \([参见 GDPR 第 17](https://gdpr.eu/article-17-right-to-be-forgotten/)条\)\( [1](https://help.adjust.com/zh/article/gdpr#ref-1) \)。作为数据处理方，Adjust 有义务支持您 \(数据控制方\) 处理来自应用用户的此类请求。 +The EU’s General Data Protection Regulation \(GDPR\) and similar privacy laws worldwide \(CCPA, LGPD, etc.\) grant data subjects comprehensive rights when it comes to the processing of their personal data. These rights include, among others, the right to erasure \(see [Art. 17 GDPR](https://gdpr.eu/article-17-right-to-be-forgotten/)\)\([1](https://help.adjust.com/en/article/gdpr#ref-1)\). As a data processor, Adjust is obliged to support you \(the data controller\) in the processing of such requests from your \(app\) users. -您可以通过调用 `gdprForgetMe` 方法来将用户的删除请求发送至 Adjust 服务器。Adjust 在收到通知后： +You can send the user's erasure request to Adjust by calling the `gdprForgetMe` method. Once Adjust has been notified: -- 我们将从内部系统和数据库中永久删除用户的所有历史个人数据； -- 此外，Adjust 将不再通过 Adjust SDK 接收来自该用户/设备的数据。 \( [2](https://help.adjust.com/zh/article/gdpr#ref-2) \) +* Adjust will permanently delete all of the user’s historical personal data from its internal systems and database. +* Adjust will no longer receive data from this user/device via the Adjust SDK.\([2](https://help.adjust.com/en/article/gdpr#ref-2)\) ```js Adjust.gdprForgetMe(); ``` -## 禁用第三方分享 {#disable-third-party-sharing} +针对特定用户的第三方分享\{\#third\-party\-sharing\-for\-specific\-users\} +--------------------------------------------------------------------- - + -```js -function disableThirdPartySharing(): void; +您可以使用 Adjust SDK 来记录用户对第三方数据分享设置的变更。请使用 `ThirdPartySharing` 类配置第三方数据分享。 + +### 实例化 AdjustThirdPartySharing 对象\{\#instantiate\-an\-adjustthirdpartysharing\-object\} + + + +```ts +class ThirdPartySharing { + constructor(isEnabled: boolean) {} + // ... +} ``` - + -要为所有用户禁用第三方数据分享，请调用 `disableThirdPartySharing` 方法。Adjust 服务器收到此信息后，会停止向第三方分享该用户的数据，而 Adjust SDK 将会继续如常运行。 +要启用或禁用 Adjust SDK 第三方数据分享，请实例化 `ThirdPartySharing` 对象。该对象包含控制 Adjust 如何处理第三方分享的变量。 -```js -Adjust.disableThirdPartySharing(); +要进行实例化，请创建新的 `ThirdPartySharing` 实例，并传递下列参数： + +* `isEnabled` \( `boolean` \): 传递`true`来启用第三方分享或传递`false`来禁用第三方分享。 + +```ts +const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); ``` -## 数据驻留{#data-residency} +设置为`false`时，Adjust 会停止与第三方分享用户数据。Adjust SDK 将会继续如常运行。 - +要向 Adjust 发送信息，请使用`ThirdPartySharing`实例作为参数调用`Adjust.trackThirdPartySharing`方法。 -```js -dataResidency: "EU" | "TR" | "US"; +```ts +const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); +Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` - +### 禁用第三方分享 \(已弃用\) \{\#disable\-third\-party\-sharing\} -通过数据驻留 \(data residency\) 功能，您可以选择 Adjust 将您的数据存储在哪个国家。当应用运营的国家拥有严格的隐私规定时，此功能会非常有用。设置数据驻留后，Adjust 会将您的数据存储在所选地区的数据中心。 + -要设置数据驻留国家，请在 `initSdk` 方法 `dataResidency` 属性中传送选定国家/地区的代码。 +如需在之前版本的 SDK 中禁用第三方数据分享，请调用`disableThirdPartySharing`方法。此方法已被弃用。如果您仍在使用，请注意它会直接调用基础方法。 -| 地区 | 代码 | -| ------ | ---- | -| 欧盟 | `EU` | -| 土耳其 | `TR` | -| 美国 | `US` | +```ts +const adjustThirdPartySharing = new Adjust.ThirdPartySharing(false); +Adjust.trackThirdPartySharing(adjustThirdPartySharing); +``` -```js -Adjust.initSdk({ - appToken: "YOUR_APP_TOKEN", - environment: "production", - logLevel: "verbose", - dataResidency: "EU", -}); +### 发送精细信息\{\#send\-granular\-information\} + + + +```ts +public addGranularOption(partnerName: string, + key: string, + value: string) ``` -## URL 策略{#url-strategy} + - +当用户更新第三方数据分享设置时，您可以附加较精细的信息，以此发送用户决定的更多细节。 -```js -urlStrategy: "india" | "china"; +使用下列参数调用`addGranularOption`方法： + +* `partnerName` \(`string`\)：使用精细设置的合作伙伴的名称。 +* `key` \(`string`\)：选项 key。 +* `value` \(`string`\)：选项值。 + +```ts +const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); +options.addGranularOption("PartnerA", "foo", "bar"); +Adjust.trackThirdPartySharing(options); ``` - +URL strategy \{\#url\-strategy\} +------------------------------------ + + + +通过 URL 策略功能，您可以进行下列设置： + +* Adjust 储存您数据的国家/地区 \(即数据驻留\)。 +* 接收 Adjust SDK 所发送流量的终端 \(自定义 URL \)。 + +当应用运营的国家拥有严格的隐私规定时，此功能会非常有用。在您设置 URL 策略时，Adjust 会将数据储存在指定数据驻留地区，或将流量发送至选定域名。 -您可以设置 URL 策略来优先将 Adjust SDK 的数据发送到某些地区终端。为此，请在 `initSdk` 方法 `urlStrategy` 属性中传送选定国家/地区的代码。 +要配置 URL 策略，请在`Adjust.initSdk`实例中设置`urlStrategy`的以下属性： -| 地区 | 代码 | -| ---- | ------- | -| 中国 | `china` | -| 印度 | `india` | +* `domains` \(`Array`\)：接收您所发送 SDK 流量的数据驻留国家/地区或终端。默认情况下，Adjust SDK 会将所有数据都发送至 Adjust 终端。如果您想设置自定义终端，请在`urlStrategy`的`domains`属性中传递。 +* `useSubdomains` \(`boolean`\): 域名是否应被视为 Adjust 域名。 + * 如果为`true`，则 SDK 会在域名中添加 Adjust 特定子域作为前缀。 + * 如果为`false`，SDK 会按原样使用所提供的域名，不包含前缀。 + +* `isDataResidency` \( `boolean` \)：可选。域名是否应被用于数据驻留。 + +下表展示了一系列配置。 + +| URL 策略 | 默认和自定义域名 | 使用子域名 | 数据驻留 | +|------------|-------------------------------|---------|---------| +| 欧盟数据驻留 | `"eu.adjust.com"` | `true` | `true` | +| 中国 URL 策略 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | +| 自定义 URL 策略 | `"my.custom.domain"` | `false` | `false` | ```js Adjust.initSdk({ appToken: "YOUR_APP_TOKEN", environment: "production", logLevel: "verbose", - urlStrategy: "china", + urlStrategy: { + domains: ["adjust.cn", "adjust.com"], + useSubdomains: true, + isDataResidency: false, + }, }); ``` -## 设置自定义终端{#set-custom-endpoint} +### 设置自定义终端 \(已弃用\) \{\#set\-custom\-endpoint\} - + + +之前版本的 SDK 使用`customUrl`属性传递终端，该属性已被弃用。请改用`urlStrategy`配置。 + ```js -customUrl: string; +Adjust.initSdk({ + appToken: "YOUR_APP_TOKEN", + environment: "production", + logLevel: "verbose", + customUrl: "my.custom.domain.com", + urlStrategy: { + domains: ["my.custom.domain"], + useSubdomains: false, + isDataResidency: false, + }, +}); ``` - + + +### 数据驻留 \(已弃用\) \{\#data\-residency\} + + -默认情况下，Adjust SDK 会将所有数据都发送至 Adjust 终端。要指定自定义终端，请在 `initSdk` 方法 `customUrl` 函数中传送该终端。 +之前版本的 SDK 使用的是`dataResidency`属性，该属性已被弃用。请改用`urlStrategy`配置。 + ```js Adjust.initSdk({ appToken: "YOUR_APP_TOKEN", - environment: "sandbox", - customUrl: "https://my-custom-url.com/", + environment: "production", + logLevel: "verbose", + dataResidency: "EU", + urlStrategy: { + domains: ["eu.adjust.com"], + useSubdomains: true, + isDataResidency: true, + }, }); ``` + + + From 9f18ef4c11591f660d651d536ea705d5d585c358 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:09:26 +0000 Subject: [PATCH 09/42] File src/content/docs/en/sdk/web/features/privacy.mdx was translated to ja-JP locale --- .../docs/ja/sdk/web/features/privacy.mdx | 188 ++++++++++++------ 1 file changed, 131 insertions(+), 57 deletions(-) diff --git a/src/content/docs/ja/sdk/web/features/privacy.mdx b/src/content/docs/ja/sdk/web/features/privacy.mdx index 716fee5c07..006b480336 100644 --- a/src/content/docs/ja/sdk/web/features/privacy.mdx +++ b/src/content/docs/ja/sdk/web/features/privacy.mdx @@ -1,119 +1,193 @@ --- -title: プライバシー機能の設定 -description: アプリ内でユーザーのプライバシーを処理するために使用できる機能を設定します。 -slug: ja/sdk/web/features/privacy +title: "Set up privacy features" +description: "Configure features that you can use to handle user privacy in your app." +slug: "en/sdk/web/features/privacy" --- +The Adjust SDK contains features that you can use to handle user privacy in your app. -Adjust SDKには、アプリ内でのユーザープライバシーの処理に使用できる機能が含まれています。 +Send erasure request \{\#send\-erasure\-request\} +------------------------------------------------------ -## 消去リクエストを送信する {#send-erasure-request} - - + ```js function gdprForgetMe(): void; ``` - + -EUの一般データ保護規則（GDPR）および類似する世界的なプライバシー法（CCPA、LGPDなど）は、個人データの処理に関する包括的な権利をデータ主体に付与しています。これらの権利には、消去権（[GDPR第17条](https://gdpr.eu/article-17-right-to-be-forgotten/)を参照）（[1](https://help.adjust.com/ja/article/gdpr#ref-1)）が含まれます。データ処理者として、Adjustは、（アプリ）ユーザー（データ管理者）からのそのようなリクエストの処理をサポートする義務があります。 +The EU’s General Data Protection Regulation \(GDPR\) and similar privacy laws worldwide \(CCPA, LGPD, etc.\) grant data subjects comprehensive rights when it comes to the processing of their personal data. These rights include, among others, the right to erasure \(see [Art. 17 GDPR](https://gdpr.eu/article-17-right-to-be-forgotten/)\)\([1](https://help.adjust.com/en/article/gdpr#ref-1)\). As a data processor, Adjust is obliged to support you \(the data controller\) in the processing of such requests from your \(app\) users. -`gdprForgetMe`メソッドを呼び出すことで、ユーザーの消去リクエストをAdjustに送信することができます。Adjustが通知を受けると、以下の対応をいたします。 +You can send the user's erasure request to Adjust by calling the `gdprForgetMe` method. Once Adjust has been notified: -- Adjustはその内部システムおよびデータベースから、履歴として保管されているユーザーの全ての個人データを完全に削除します。 -- Adjustは、Adjust SDKを介して、このユーザー/デバイスからデータを受信しなくなります。（[2](https://help.adjust.com/ja/article/gdpr#ref-2)） +* Adjust will permanently delete all of the user’s historical personal data from its internal systems and database. +* Adjust will no longer receive data from this user/device via the Adjust SDK.\([2](https://help.adjust.com/en/article/gdpr#ref-2)\) ```js Adjust.gdprForgetMe(); ``` -## サードパーティとの共有を無効にする {#disable-third-party-sharing} +特定のユーザーの情報をサードパーティと共有する \{\#third\-party\-sharing\-for\-specific\-users\} +--------------------------------------------------------------------------------- - + -```js -function disableThirdPartySharing(): void; +Adjust SDKを使用して、ユーザーがサードパーティとの共有設定を変更した時にそれを記録することができます。これらの設定は、`ThirdPartySharing`クラスを使用して行われます。 + +### AdjustThirdPartySharingオブジェクトをインスタンス化する \{\#instantiate\-an\-adjustthirdpartysharing\-object\} + + + +```ts +class ThirdPartySharing { + constructor(isEnabled: boolean) {} + // ... +} ``` - + -全てのユーザーに対してサードパーティとのデータ共有を無効化するには、`disableThirdPartySharing`メソッドを呼び出します。Adjustサーバーがこの情報を受信すると、サードパーティとのデータ共有を停止します。Adjust SDKは引き続き通常通り動作します。 +Adjust SDKでサードパーティ共有を有効化または無効化するには、`ThirdPartySharing`オブジェクトをインスタンス化する必要があります。このオブジェクトには、Adjustがサードパーティとの共有をどのように扱うかを制御する変数が含まれます。 -```js -Adjust.disableThirdPartySharing(); +これをインスタンス化するには、新しい`ThirdPartySharing`インスタンスを作成して、以下のパラメーターをパスしてください： + +* `isEnabled` \( `boolean` \) ：`true`をパスしてサードパーティ共有を有効化するか、 `false`をパスして無効化します。 + +```ts +const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); ``` -## データレジデンシー {#data-residency} +`false`に設定すると、 Adjustはユーザーのデータのサードパーティとの共有を停止します。Adjust SDKは引き続き通常通り動作します。 - +Adjustに情報を送信するには、 `ThirdPartySharing`インスタンスを引数として`Adjust.trackThirdPartySharing`メソッドを呼び出してください。 -```js -dataResidency: "EU" | "TR" | "US"; +```ts +const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); +Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` - +### サードパーティ共有を無効にする（廃止）\{\#disable\-third\-party\-sharing\} -データレジデンシーにより、Adjustがデータを保管する国を選択できます。プライバシー要件の厳しい国で運営されている場合に便利な機能です。データレジデンシーを設定すると、Adjustは選択された地域のデータセンターにお客様のデータを保管します。 + -データレジデンシーの国を設定するには、`initSdk`メソッドの`dataResidency`プロパティに希望する国の地域コードをパスします。 +以前のバージョンのSDKでサードパーティとの共有を無効にするには、 `disableThirdPartySharing`メソッドを呼び出します。このメソッドは廃止されました。それでも使用する場合は、基礎となるメソッドを直接呼び出していることに注意してください。 -| 地域 | コード | -| -------------- | ------ | -| 欧州連合 | `EU` | -| トルコ | `TR` | -| アメリカ合衆国 | `US` | +```ts +const adjustThirdPartySharing = new Adjust.ThirdPartySharing(false); +Adjust.trackThirdPartySharing(adjustThirdPartySharing); +``` -```js -Adjust.initSdk({ - appToken: "YOUR_APP_TOKEN", - environment: "production", - logLevel: "verbose", - dataResidency: "EU", -}); +### 粒度の高い情報を送信する \{\#send\-granular\-information\} + + + +```ts +public addGranularOption(partnerName: string, + key: string, + value: string) ``` -## URL戦略 {#url-strategy} + - +ユーザーがサードパーティの共有設定を更新すると、詳細な情報を付与できます。この情報を使用して、ユーザー行動についてより詳しく伝えることができます。 -```js -urlStrategy: "india" | "china"; +これを行うには、以下のパラメーターを使用して`addGranularOption`メソッドを呼び出します： + +* `partnerName` （`string`）：granular optionが適用されるパートナーの名前 +* `key` （`string`）：オプションのキー +* `value` （`string`）：オプションの値 + +```ts +const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); +options.addGranularOption("PartnerA", "foo", "bar"); +Adjust.trackThirdPartySharing(options); ``` - +URL strategy \{\#url\-strategy\} +------------------------------------ + + + +URL戦略機能では、以下のいずれかを設定することができます： + +* Adjustがお客様のデータを保管する国（データレジデンシー）。 +* Adjust SDKがトラフィックを送信するエンドポイント（カスタムURL）。 + +これは、プライバシー要件が厳しい国で事業を展開している場合に便利です。URL戦略を設定すると、Adjustは選択したデータレジデンシー地域にデータを保管したり、選択したドメインにトラフィックを送信したりします。 -Adjust SDKからエンドポイントにデータを送信する際に、地域のエンドポイントを優先するようURL戦略を設定することができます。これを行うには、`initSdk`メソッドの`urlStrategy`プロパティに希望する国コードの地域をパスします。 +URL戦略を設定するには、 `Adjust.initSdk`インスタンスの`urlStrategy`の以下のプロパティを設定します。 -| 地域 | コード | -| ------ | ------- | -| 中国 | `china` | -| インド | `india` | +* `domains` （`Array`）：SDKトラフィックを送信する国、データの所在国、またはエンドポイント。デフォルトでは、Adjust SDKは全てのデータをAdjustのエンドポイントに送信します。カスタムエンドポイントを設定する場合は、 `urlStrategy`の`domains`プロパティでパスします。 +* `useSubdomains` （`boolean`）：ドメインをAdjustドメインとして扱うかどうか。 + * `true`の場合、SDKはドメインの前にAdjust固有のサブドメインを付けます。 + * `false`の場合、SDKは指定されたドメインをプレフィックスなしでそのまま使用します。 + +* `isDataResidency` （`boolean`）：オプション。ドメインをデータレジデンシーに使用するかどうか。 + +以下の設定リストをご覧ください。 + +| urlStrategy | デフォルトドメインとカスタムドメイン | サブドメインの使用 | データレジデンシー | +|--------------|-------------------------------|-----------|-----------| +| EU データレジデンシー | `"eu.adjust.com"` | `true` | `true` | +| 中国 URL戦略 | `"adjust.cn"`。 `"adjust.com"` | `true` | `false` | +| カスタムURL戦略 | `"my.custom.domain"` | `false` | `false` | ```js Adjust.initSdk({ appToken: "YOUR_APP_TOKEN", environment: "production", logLevel: "verbose", - urlStrategy: "china", + urlStrategy: { + domains: ["adjust.cn", "adjust.com"], + useSubdomains: true, + isDataResidency: false, + }, }); ``` -## カスタムエンドポイントを設定する {#set-custom-endpoint} +### カスタムエンドポイントの設定（廃止済み）\{\#set\-custom\-endpoint\} - + + +以前のバージョンのSDKでは、廃止された`customUrl`プロパティを使用してエンドポイントをパスしていました。今後は`urlStrategy`設定を使用してください。 + ```js -customUrl: string; +Adjust.initSdk({ + appToken: "YOUR_APP_TOKEN", + environment: "production", + logLevel: "verbose", + customUrl: "my.custom.domain.com", + urlStrategy: { + domains: ["my.custom.domain"], + useSubdomains: false, + isDataResidency: false, + }, +}); ``` - + + +### データレジデンシー（廃止済み）\{\#data\-residency\} + + -デフォルトでは、Adjust SDKは全てのデータをAdjustのエンドポイントに送信します。カスタムエンドポイントを指定したい場合は、`initSdk`メソッドの`customUrl`プロパティにエンドポイントをパスします。 +以前のバージョンのSDKでは、廃止された`dataResidency`プロパティを使用していました。今後は`urlStrategy`設定を使用してください。 + ```js Adjust.initSdk({ appToken: "YOUR_APP_TOKEN", - environment: "sandbox", - customUrl: "https://my-custom-url.com/", + environment: "production", + logLevel: "verbose", + dataResidency: "EU", + urlStrategy: { + domains: ["eu.adjust.com"], + useSubdomains: true, + isDataResidency: true, + }, }); ``` + + + From f716f3a1a2f50ba38f6cfb4be302a2950ca9aa56 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:09:29 +0000 Subject: [PATCH 10/42] File src/content/docs/en/sdk/web/index.mdx was translated to ko-KR locale --- src/content/docs/ko/sdk/web/index.mdx | 184 +++++++------------------- 1 file changed, 47 insertions(+), 137 deletions(-) diff --git a/src/content/docs/ko/sdk/web/index.mdx b/src/content/docs/ko/sdk/web/index.mdx index 80cff71833..fe0e06df44 100644 --- a/src/content/docs/ko/sdk/web/index.mdx +++ b/src/content/docs/ko/sdk/web/index.mdx @@ -1,181 +1,91 @@ --- -title: Web SDK 연동 가이드 -description: 웹 SDK를 사용해 웹앱의 Adjust 기능에 액세스합니다. -category-title: "웹 SDK " -slug: ko/sdk/web +title: "Web SDK integration guide" +description: "Use the Web SDK to access Adjust's features in your web apps" +category-title: "Web SDK" +slug: "en/sdk/web" sidebar-position: 8 --- +Adjust 웹 SDK를 사용하면 웹 앱에서 어트리뷰션, 이벤트 및 기타 데이터를 기록할 수 있습니다. 이 가이드에서는 SDK를 앱과 연동하는 방법을 설명합니다. + -Adjust 웹 SDK를 사용하면 웹 앱에서 어트리뷰션, 이벤트 등을 기록할 수 있습니다. 이 가이드에서는 Adjust SDK를 앱과 연동하는 방법이 다루어집니다. +웹 SDK를 사용하려면 Adjust 대시보드에서 지원 중단된 웹 앱을 생성하고 그 둘을 연결해야 합니다. 웹 SDK를 모바일 앱 SDK가 이미 포함된 모바일 앱과 연동해서는 안 됩니다. + -## 1\. 프로젝트에 SDK 추가 {#add-the-sdk-to-your-project} +1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} +------------------------------------------------------------------------------- -시작하려면 웹 앱에 SDK를 추가해야 합니다. Adjust SDK는 CommonJS와 AMD\(비동기 모듈 정의\) 환경에서 모두 작동하고 CDN\(콘텐츠 전송 네트워크\)을 통해 로딩될 때 글로벌 `Adjust` 네임스페이스를 통해 액세스할 수 있습니다. +시작하려면 웹 앱에 SDK를 추가합니다. Adjust SDK는 CommonJS와 AMD\(비동기 모듈 정의\) 환경에서 모두 작동합니다. CDN\(콘텐츠 전송 네트워크\)을 통해 로딩될 때 글로벌 `Adjust` 네임스페이스를 통해 액세스할 수 있습니다. -### CDN 사용 {#using-a-cdn} +### Using a CDN \{\#using\-a\-cdn\} -CDN을 통해 SDK를 로딩할 때 프로덕션 빌드에 간소화된 버전을 사용해야 합니다. 버전을 다음과 같이 `https://cdn.adjust.com/adjust-5.6.0.min.js` 대상에 추가하여 버전을 지정할 수 있습니다. 다음과 같이 `adjust-latest` 패키지를 대상으로 지정하여 최신 버전을 확인할 수 있습니다: `https://cdn.adjust.com/adjust-latest.min.js`. 이 패키지는 자동으로 업데이트되므로 대상 파일을 변경할 필요가 없습니다. +CDN을 통해 SDK를 로딩할 때 프로덕션 빌드에 간소화된 버전을 사용해야 합니다. - +* 다음과 같이 CDN 대상에 추가하여 특정 버전을 로드할 수 있습니다. `https://cdn.adjust.com/adjust-5.7.0.min.js` +* 최신 버전을 로드하려면 다음과 같이 `adjust-latest` 패키지를 사용합니다. `https://cdn.adjust.com/adjust-latest.min.js` 이 패키지는 자동으로 업데이트되므로 대상 파일을 변경할 필요가 없습니다. -SDK 파일은 캐시되어 빠른 서비스가 가능합니다. 이 캐시는 30분마다 업데이트됩니다. SDK 파일을 최신 버전으로 강제로 업데이트하려면 헤더에서 특정 버전을 대상으로 지정하시기 바랍니다. + - +The SDK files are cached to enable fast service. This cache updates every 30 minutes. If you want to force an update to the latest version, target a specific version in your header. + + +CDN을 통해 SDK를 로드하려면 웹 앱의 `` 요소 안에 다음 스니펫을 추가합니다. -CDN을 통해 SDK를 로드하려면 웹 앱의 `` 태그 사이에 다음 스니펫을 추가합니다. +\{/\* prettier\-ignore \*/\} ```html - ``` -Adjust SDK는 각 페이지에서 로드되며 페이지 로드 시 한 번 초기화됩니다. +The Adjust SDK loads on each page and initiates once per page load. + +#### Subresource Integrity \{\#subresource\-integrity\} -#### 하위 리소스 무결성 {#subresource-integrity} +[하위 리소스 무결성](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) 검사를 사용하여 XSS\(사이트 간 스크립팅\) 공격을 완화할 수 있습니다. 패키지를 실행하기 전에 검증하려면 다음 콜\(추가 `crossOrigin`, `integrity`, 인코딩된 해시 확인\)을 사용합니다. -[하위 리소스 무결성](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) 검사를 사용하여 XSS\(사이트 간 스크립팅\) 공격을 완화하려는 경우, 다음의 콜을 통해 패키지를 실행하기 전에 검증할 수 있습니다. +\{/\* prettier\-ignore \*/\} ```html - ``` -### npm 사용 {#using-npm} +### Using npm \{\#using\-npm\} -Adjust SDK는 [npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk)에서도 사용이 가능합니다. 프로젝트에 패키지를 추가하려면 선호하는 패키지 매니저를 사용하시기 바랍니다. - - - +The Adjust SDK is also available on [npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk). To add the package to your project, use your preferred package manager: + ```console $ npm install @adjustcom/adjust-web-sdk --save ``` - - + ```console $ yarn add @adjustcom/adjust-web-sdk ``` - - + ```console $ pnpm add @adjustcom/adjust-web-sdk ``` - - + -## 2\. SDK 초기화 {#initialize-the-sdk} +2\. Initialize the SDK \{\#initialize\-the\-sdk\} +------------------------------------------------------- -SDK를 설치한 후에는 초기화해야 합니다. 해당 기능 사용을 원하는 경우 `initSdk` 메서드를 호출합니다. 이 메서드는 앱에서 SDK가 작동하는 방식을 사용자 지정하는 여러 인수를 사용합니다. +SDK를 설치한 후에는 초기화해야 합니다. 해당 기능 사용을 원하는 경우 `initSdk` 메서드를 호출합니다. 이 메서드는 앱에서 SDK가 작동하는 방식을 사용자 지정하는 데 사용할 수 있는 인수를 제공합니다. -SDK를 초기화하려면 `initSdk` 콜에 다음 인수를 추가해야 합니다. +SDK를 시작하려면 다음 인수를 `initSdk` 호출에 추가해야 합니다. -- `appToken` `string`: [Adjust 앱 토큰](https://help.adjust.com/ko/article/app-token-and-reporting-currency#view-your-app-details)입니다. -- `environment` \(`string`\): SDK를 실행할 환경입니다. 테스트를 위해 샌드박스 모드에서 SDK를 실행하려면 `sandbox`를 전달합니다. 릴리즈를 위해 프로덕션 모드에서 SDK를 실행하려면 `production`을 전달합니다. +* `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/en/article/app-token-and-reporting-currency#view-your-app-details). +* `environment` \(`string`\): SDK를 실행할 환경입니다. + * 테스트 모드에서 SDK를 실행하려면 `sandbox` 를 전달합니다. + * 릴리즈를 위해 프로덕션 모드에서 SDK를 실행하려면 `production` 을 전달합니다. ```js Adjust.initSdk({ @@ -184,8 +94,8 @@ Adjust.initSdk({ }); ``` - - -Adjust SDK 설정을 사용자 지정하려면 [구성 안내](/ko/sdk/web/configuration)를 확인하세요. + +[구성 가이드](/en/sdk/web/configuration)에서 Adjust 웹 SDK의 전체 인수 및 속성 목록을 확인하실 수 있습니다. + From b36771203d612bc623446efc16ffcfa765fc2524 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:09:31 +0000 Subject: [PATCH 11/42] File src/content/docs/en/sdk/web/index.mdx was translated to zh-CN locale --- src/content/docs/zh/sdk/web/index.mdx | 184 +++++++------------------- 1 file changed, 47 insertions(+), 137 deletions(-) diff --git a/src/content/docs/zh/sdk/web/index.mdx b/src/content/docs/zh/sdk/web/index.mdx index 2099d97d69..087e6f0c5f 100644 --- a/src/content/docs/zh/sdk/web/index.mdx +++ b/src/content/docs/zh/sdk/web/index.mdx @@ -1,181 +1,91 @@ --- -title: Web SDK 集成指南 -description: 使用 Web SDK 在您的 web 应用中使用 Adjust 功能 -category-title: Web SDK -slug: zh/sdk/web +title: "Web SDK integration guide" +description: "Use the Web SDK to access Adjust's features in your web apps" +category-title: "Web SDK" +slug: "en/sdk/web" sidebar-position: 8 --- +通过 Adjust Web SDK，您可以在网页应用中记录归因、事件以及更多数据。该指南展示了如何将该 SDK 集成至应用。 + -通过 Adjust Web SDK，您可以在网页应用中记录归因、事件以及更多信息。该指南展示了如何将 Adjust SDK 集成至应用。 +要使用 Web SDK，您必须在 Adjust 控制面板中创建专用的网页应用并将两者关联起来。请勿将 Web SDK 集成到已经包含移动应用 SDK 的移动应用中。 + -## 1\. 添加 SDK 至您的项目{#add-the-sdk-to-your-project} +1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} +------------------------------------------------------------------------------- -要开始使用，您需要将 SDK 添加至应用。Adjust SDK 可在 CommonJS 和 AMD \(Asynchronous Module Definition\) 环境中运行。当通过 CDN \(Content Delivery Network\) 加载时可通过全局`Adjust`命名空间访问。 +要开始设置，请将 SDK 添加至网页应用。Adjust SDK 可在 CommonJS 和 AMD \(Asynchronous Module Definition\) 环境中运行。通过 CDN \(内容分发网络\) 加载时，您可以通过全局`Adjust`命名空间对其进行访问。 -### 使用 CDN {#using-a-cdn} +### Using a CDN \{\#using\-a\-cdn\} -通过 CDN 加载 SDK 时，您应该使用缩小的生产版本。您可以通过添加一个版本至 CDN 目标来指定版本，如下所示：`https://cdn.adjust.com/adjust-5.6.0.min.js`。您可以通过定向`adjust-latest`包来获取最新版本，如下所示：`https://cdn.adjust.com/adjust-latest.min.js`。该包会自动更新，您无需更改目标文件。 +通过 CDN 加载 SDK 时，您应该在生产环境中使用压缩版本。 - +* 您可以通过添加一个版本至 CDN 目标来加载指定版本，如下所示：`https://cdn.adjust.com/adjust-5.7.0.min.js`。 +* 要加载最新版本，请使用`adjust-latest`包，如下所示：`https://cdn.adjust.com/adjust-latest.min.js`。该包会自动更新，您无需更改目标文件。 -SDK 文件会被缓存，确保服务速度。缓存每 30 分钟更新。如果您想强制更新当前版本，请在标头中定向特定版本。 + - +The SDK files are cached to enable fast service. This cache updates every 30 minutes. If you want to force an update to the latest version, target a specific version in your header. + + +要通过 CDN 加载 SDK，请将以下代码片段加入网页应用的``元素中： -要通过 CDN 加载 SDK，请将以下代码片段加入网页应用``标签中间： +\{/\* prettier\-ignore \*/\} ```html - ``` -Adjust SDK 会在每个页面上加载并初始化。 +The Adjust SDK loads on each page and initiates once per page load. + +#### Subresource Integrity \{\#subresource\-integrity\} -#### 子资源完整性{#subresource-integrity} +请使用[子资源完整性](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity)检查来抵御 XSS \(跨站脚本\) 攻击。要在运行包之前对其进行验证，请使用以下调用 \(请注意额外的`crossOrigin` 、 `integrity`和经过编码的哈希值\): -如果您想使用[子资源完整性](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity)检查来抵御 XSS \(跨站脚本\) 攻击，可以使用以下调用在运行包之前对其进行验证： +\{/\* prettier\-ignore \*/\} ```html - ``` -### 使用 npm {#using-npm} +### Using npm \{\#using\-npm\} -Adjust SDK 还可用于 [npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk)。要将包加入您的项目，请使用您常用的包管理器： - - - +The Adjust SDK is also available on [npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk). To add the package to your project, use your preferred package manager: + ```console $ npm install @adjustcom/adjust-web-sdk --save ``` - - + ```console $ yarn add @adjustcom/adjust-web-sdk ``` - - + ```console $ pnpm add @adjustcom/adjust-web-sdk ``` - - + -## 2\. 初始化 SDK{#initialize-the-sdk} +2\. Initialize the SDK \{\#initialize\-the\-sdk\} +------------------------------------------------------- -安装 SDK 后，需要进行初始化。为此，请调用 `initSdk` 方法。该方法带有多个参数，可自定义 SDK 在应用内如何工作。 +安装 SDK 后，需要进行初始化。为此，请调用`initSdk`方法。您可以使用该方法中的参数来自定义 SDK 在应用中的工作方式。 -您必须将以下参数添加至`initSdk`调用来初始化 SDK： +要初始化 SDK，您必须将以下参数添加至`initSdk`调用： -- `appToken` \(`string`\)：您的 [Adjust 应用识别码](https://help.adjust.com/zh/article/app-token-and-reporting-currency#view-your-app-details)。 -- `environment` \(`string`\)：SDK 运行的环境。传送 `sandbox`，可在 sandbox 模式下运行 SDK，方便进行测试；传送 `production`，可在生产模式下运行 SDK，方便发布。 +* `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/en/article/app-token-and-reporting-currency#view-your-app-details). +* `environment` \(`string`\)：SDK 运行的环境。 + * 传递`sandbox`来在测试模式下运行 SDK。 + * 传递 `production`来在生产模式下运行 SDK，方便发布。 ```js Adjust.initSdk({ @@ -184,8 +94,8 @@ Adjust.initSdk({ }); ``` - - -要自定义 Adjust SDK 设置，请查看[配置指南](/zh/sdk/web/configuration)。 + +您可以在[配置指南](/en/sdk/web/configuration)中找到 Adjust Web SDK 参数和属性的完整列表。 + From aa471ec4e882f0dc066b06700332b218a3dd13a5 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:09:34 +0000 Subject: [PATCH 12/42] File src/content/docs/en/sdk/web/index.mdx was translated to ja-JP locale --- src/content/docs/ja/sdk/web/index.mdx | 184 +++++++------------------- 1 file changed, 47 insertions(+), 137 deletions(-) diff --git a/src/content/docs/ja/sdk/web/index.mdx b/src/content/docs/ja/sdk/web/index.mdx index a16d57877f..90dd9cc3ef 100644 --- a/src/content/docs/ja/sdk/web/index.mdx +++ b/src/content/docs/ja/sdk/web/index.mdx @@ -1,181 +1,91 @@ --- -title: Web SDK 連携ガイド -description: Web SDKを使用して、WebアプリでAdjustの機能にアクセスしましょう。 -category-title: Web SDK -slug: ja/sdk/web +title: "Web SDK integration guide" +description: "Use the Web SDK to access Adjust's features in your web apps" +category-title: "Web SDK" +slug: "en/sdk/web" sidebar-position: 8 --- - Adjust Web SDKを実装することで、アトリビューションやイベントなどのさまざまなデータをWebアプリで記録できます。このガイドでは、Adjust SDKをアプリに実装する方法をご紹介します。 + -## 1\. プロジェクトにSDKを追加する {#add-the-sdk-to-your-project} +Web SDKを使用するには、Adjustダッシュボードで専用のWebアプリを作成し、その2つを連携する必要があります。モバイルアプリSDKが既に実装されているモバイルアプリには、Web SDKを実装しないでください。 + -まずは、WebアプリにSDKを追加します。Adjust SDKは、CommonJSとAMD（Asynchronous Module Definition）の両方の環境で動作します。CDN（Content Delivery Network）を利用して読み込むと、グローバルの`Adjust`名前空間を通じてアクセスできます。 +1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} +------------------------------------------------------------------------------- -### CDNを使用する {#using-a-cdn} +まずは、WebアプリにSDKを追加します。Adjust SDKは、CommonJSとAMD（Asynchronous Module Definition）の両方の環境で動作します。CDN（Content Delivery Network）を利用して読み込むと、グローバルの`Adjust`名前空間を介してアクセスできます。 -CDNを利用してSDKを読み込むときは、本番用ビルドには縮小バージョンを使用する必要があります。バージョンを指定するには、`https://cdn.adjust.com/adjust-5.6.0.min.js`のようにCDNターゲットに追加します。`https://cdn.adjust.com/adjust-latest.min.js`のように、`adjust-latest`パッケージをターゲットにすることで、最新版を入手することができます。このパッケージは自動的にアップデートされるため、ターゲットファイルを変更する必要はありません。 +### Using a CDN \{\#using\-a\-cdn\} - +CDNを利用してSDKを読み込むときは、本番用ビルドには縮小バージョンを使用する必要があります。 -SDKのファイルは、迅速なサービスを実現するためにキャッシュされます。このキャッシュは30分ごとに更新されます。強制的に最新バージョンに更新する場合は、ヘッダーで特定のバージョンをターゲットにしてください。 +* バージョンを指定するには、`https://cdn.adjust.com/adjust-5.7.0.min.js`のようにCDNターゲットに追加します。 +* 最新バージョンを読み込むには、次のように`adjust-latest`パッケージを使用してください：`https://cdn.adjust.com/adjust-latest.min.js` 。このパッケージは自動的にアップデートされるため、ターゲットファイルを変更する必要はありません。 - + + +The SDK files are cached to enable fast service. This cache updates every 30 minutes. If you want to force an update to the latest version, target a specific version in your header. + + +CDNを利用してSDKを読み込むには、Webアプリの``タグ間に次のスニペットを追加します。 -CDNを利用してSDKを読み込むには、Webアプリの``タグ間に次のスニペットを追加します。 +\{/\* prettier\-ignore \*/\} ```html - ``` -Adjust SDKはページごとに読み込まれ、ページの読み込みごとに1回起動されます。 +The Adjust SDK loads on each page and initiates once per page load. -#### サブリソース完全性 {#subresource-integrity} +#### Subresource Integrity \{\#subresource\-integrity\} -XSS（クロスサイトスクリプティング）攻撃を緩和するために[サブリソース完全性](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity)チェックを使用する場合、次の呼び出しを使用すると、パッケージが実行される前に検証することができます。 +XSS（クロスサイトスクリプティング）攻撃を緩和するために、[サブリソース完全性](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity)チェックを使用します。実行前にパッケージを検証するには、次のコールを使用します（追加の`crossOrigin`、 `integrity`、およびエンコードされたハッシュにご留意ください）。 + +\{/\* prettier\-ignore \*/\} ```html - ``` -### npmを使用する {#using-npm} - -Adjust SDKは[npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk)でも提供されています。パッケージをプロジェクトに追加するには、好みのパッケージマネージャーを使用します。 +### Using npm \{\#using\-npm\} - - +The Adjust SDK is also available on [npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk). To add the package to your project, use your preferred package manager: + ```console $ npm install @adjustcom/adjust-web-sdk --save ``` - - + ```console $ yarn add @adjustcom/adjust-web-sdk ``` - - + ```console $ pnpm add @adjustcom/adjust-web-sdk ``` - - + -## 2\. SDKを初期化する {#initialize-the-sdk} +2\. Initialize the SDK \{\#initialize\-the\-sdk\} +------------------------------------------------------- -SDKをインストールしたら、初期化する必要があります。これを行うには、`initSdk`メソッドを呼び出します。このメソッドは、アプリでのSDKの動作をカスタマイズするいくつかの引数を取ります。 +SDKをインストールしたら初期化する必要があります。これを行うには、`initSdk`メソッドを呼び出してください。このメソッドには、アプリでのSDKの動作をカスタマイズするために使用できる引数があります。 -SDKを初期化するには、`initSdk`呼び出しに次の引数を追加する必要があります。 +SDKを初期化するには、 `initSdk`の呼び出しに次の引数を追加する必要があります。 -- `appToken` （`string`）：お客様の[Adjustアプリトークン](https://help.adjust.com/ja/article/app-token-and-reporting-currency#view-your-app-details)。 -- `environment` （`string`）：SDKを実行したい環境。テスト用のサンドボックスモードでSDKを実行するには`sandbox`をパスします。リリース用の本番モードでSDKを実行するには`production`をパスします。 +* `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/en/article/app-token-and-reporting-currency#view-your-app-details). +* `environment` （`string`）：SDKを実行したい環境。 + * SDKをテストモードで実行するには、 `sandbox`をパスします。 + * リリースの本番用モードでSDKを実行するには、 `production`をパスします。 ```js Adjust.initSdk({ @@ -184,8 +94,8 @@ Adjust.initSdk({ }); ``` - - -Adjust SDKの設定をカスタマイズするには、[設定ガイド](/ja/sdk/web/configuration)をご覧ください。 + +AdjustのWeb SDKの引数とプロパティの全リストは、[設定ガイド](/en/sdk/web/configuration)をご覧ください。 + From b6fc356ef7382dee40c2875c83ee22735590cd28 Mon Sep 17 00:00:00 2001 From: github-actions <41898282+github-actions[bot]@users.noreply.github.com> Date: Wed, 8 Jan 2025 09:35:15 +0000 Subject: [PATCH 13/42] Fix translated and formatted files --- .../docs/ja/sdk/web/features/attribution.mdx | 52 ++-- .../docs/ja/sdk/web/features/device-info.mdx | 16 +- .../docs/ja/sdk/web/features/privacy.mdx | 111 ++++---- src/content/docs/ja/sdk/web/index.mdx | 246 +++++++++++++++--- .../docs/ko/sdk/web/features/attribution.mdx | 52 ++-- .../docs/ko/sdk/web/features/device-info.mdx | 16 +- .../docs/ko/sdk/web/features/privacy.mdx | 111 ++++---- src/content/docs/ko/sdk/web/index.mdx | 246 +++++++++++++++--- .../docs/zh/sdk/web/features/attribution.mdx | 52 ++-- .../docs/zh/sdk/web/features/device-info.mdx | 16 +- .../docs/zh/sdk/web/features/privacy.mdx | 111 ++++---- src/content/docs/zh/sdk/web/index.mdx | 246 +++++++++++++++--- 12 files changed, 939 insertions(+), 336 deletions(-) diff --git a/src/content/docs/ja/sdk/web/features/attribution.mdx b/src/content/docs/ja/sdk/web/features/attribution.mdx index 012e963838..0706fcfbba 100644 --- a/src/content/docs/ja/sdk/web/features/attribution.mdx +++ b/src/content/docs/ja/sdk/web/features/attribution.mdx @@ -1,12 +1,14 @@ --- -title: "Get attribution information" -description: "Listen for attribution changes using the Adjust SDK" -slug: "en/sdk/web/features/attribution" +title: Get attribution information +description: Listen for attribution changes using the Adjust SDK +slug: ja/sdk/web/features/attribution --- -When a user interacts with an Adjust link, their attribution information updates. This can happen if the user interacts with a [deep link](https://help.adjust.com/en/article/deep-links). Information about a user's attribution is represented in an Attribution object. + +When a user interacts with an Adjust link, their attribution information updates. This can happen if the user interacts with a [deep link](https://help.adjust.com/ja/article/deep-links). Information about a user's attribution is represented in an Attribution object. The Attribution object contains the following information: - + + ```js export type AttributionMapT = $ReadOnly<{| @@ -22,10 +24,10 @@ export type AttributionMapT = $ReadOnly<{| |}>; ``` - + -| Values | Data type | Description | -|-----------------|-----------|-----------------------------------------------------------------------------------------------------| +| Values | Data type | Description | +| --------------- | --------- | --------------------------------------------------------------------------------------------------- | | `adid` | `string` | The device's unique Adjust identifier. | | `tracker_token` | `string` | The link token associated with the attribution. | | `tracker_name` | `string` | The name of the campaign link. | @@ -33,19 +35,18 @@ export type AttributionMapT = $ReadOnly<{| | `campaign` | `string` | The name of the campaign associated with the attribution. | | `adgroup` | `string` | The adgroup associated with the attribution. | | `creative` | `string` | The creative associated with the attribution. | -| `click_label` | `string` | The [click label](https://help.adjust.com/en/article/user-rewards) associated with the attribution. | +| `click_label` | `string` | The [click label](https://help.adjust.com/ja/article/user-rewards) associated with the attribution. | | `state` | `string` | The current state of the attribution. Either `installed` or `reattributed` | -Trigger a callback when attribution changes \{\#trigger\-a\-callback\-when\-attribution\-changes\} ----------------------------------------------------------------------------------------------------------- +## Trigger a callback when attribution changes \{\#trigger\-a\-callback\-when\-attribution\-changes\} - + ```js attributionCallback: (string, Object) => mixed; ``` - + The SDK can listen for attribution changes and call a function when it detects an update. You can set an attribution callback method by specifying an `attributionCallback` function in the `initSdk` method. Within your function, you have access to the user's attribution information. @@ -67,10 +68,12 @@ Adjust.initSdk({ }); ``` -Get current attribution information \{\#get\-current\-attribution\-information\} --------------------------------------------------------------------------------------- +## Get current attribution information \{\#get\-current\-attribution\-information\} - +{" "} ユーザーがアプリをインストールすると、Adjustはそのインストールをキャンペーンにアトリビュートします。Adjust SDKを実装することで、インストールのキャンペーンアトリビューションの詳細にアクセスすることが可能です。`waitForAttribution`メソッドは、SDKがサーバーからアトリビューションデータを正常に受信すると解析される`promise`を返します。 @@ -80,29 +83,30 @@ Adjust.waitForAttribution().then((attr) => ); ``` -Set a referrer \{\#set\-a\-referrer\} ------------------------------------------- +## Set a referrer \{\#set\-a\-referrer\} - + ```js function setReferrer(referrer: string): void; ``` - + You can set a referrer to trigger an SDK click with a custom click ID when the SDK starts. The SDK sends your custom click ID to Adjust's servers for attribution purposes. - + + Call this method as close to initializing the SDK as possible to ensure your referrer is used for attribution. - + + To set your referrer, call the `setReferrer` method and pass your referrer as a URL\-encoded `string` argument. - + + ```js Adjust.setReferrer("adjust_external_click_id%3DEXTERNAL_CLICK_ID"); ``` - diff --git a/src/content/docs/ja/sdk/web/features/device-info.mdx b/src/content/docs/ja/sdk/web/features/device-info.mdx index 39584b9965..32e51d4438 100644 --- a/src/content/docs/ja/sdk/web/features/device-info.mdx +++ b/src/content/docs/ja/sdk/web/features/device-info.mdx @@ -1,14 +1,17 @@ --- -title: "Get device information" -description: "Use these methods to add details to your callbacks and improve your reporting." -slug: "en/sdk/web/features/device-info" +title: Get device information +description: Use these methods to add details to your callbacks and improve your reporting. +slug: ja/sdk/web/features/device-info --- + The Adjust SDK contains helper methods that return device information. Use these methods to add details to your callbacks and improve your reporting. -Web UUID \{\#web\-uuid\} ----------------------------- +## Web UUID \{\#web\-uuid\} - +{" "} AdjustがWebユーザーを識別するために、Web SDKはセッションを送信する際に一意の`web_uuid`を生成します。IDはUniversally Unique Identifier（UUID）のフォーマットです。 @@ -19,4 +22,3 @@ Call the `waitForWebUUID` method to return this information as a `string`. ```js Adjust.waitForWebUUID().then((webUuid) => console.log(webUuid)); ``` - diff --git a/src/content/docs/ja/sdk/web/features/privacy.mdx b/src/content/docs/ja/sdk/web/features/privacy.mdx index 006b480336..ea8012d188 100644 --- a/src/content/docs/ja/sdk/web/features/privacy.mdx +++ b/src/content/docs/ja/sdk/web/features/privacy.mdx @@ -1,42 +1,44 @@ --- -title: "Set up privacy features" -description: "Configure features that you can use to handle user privacy in your app." -slug: "en/sdk/web/features/privacy" +title: Set up privacy features +description: Configure features that you can use to handle user privacy in your app. +slug: ja/sdk/web/features/privacy --- + The Adjust SDK contains features that you can use to handle user privacy in your app. -Send erasure request \{\#send\-erasure\-request\} ------------------------------------------------------- +## Send erasure request \{\#send\-erasure\-request\} - + ```js function gdprForgetMe(): void; ``` - + -The EU’s General Data Protection Regulation \(GDPR\) and similar privacy laws worldwide \(CCPA, LGPD, etc.\) grant data subjects comprehensive rights when it comes to the processing of their personal data. These rights include, among others, the right to erasure \(see [Art. 17 GDPR](https://gdpr.eu/article-17-right-to-be-forgotten/)\)\([1](https://help.adjust.com/en/article/gdpr#ref-1)\). As a data processor, Adjust is obliged to support you \(the data controller\) in the processing of such requests from your \(app\) users. +The EU’s General Data Protection Regulation \(GDPR\) and similar privacy laws worldwide \(CCPA, LGPD, etc.\) grant data subjects comprehensive rights when it comes to the processing of their personal data. These rights include, among others, the right to erasure \(see [Art. 17 GDPR](https://gdpr.eu/article-17-right-to-be-forgotten/)\)\([1](https://help.adjust.com/ja/article/gdpr#ref-1)\). As a data processor, Adjust is obliged to support you \(the data controller\) in the processing of such requests from your \(app\) users. You can send the user's erasure request to Adjust by calling the `gdprForgetMe` method. Once Adjust has been notified: -* Adjust will permanently delete all of the user’s historical personal data from its internal systems and database. -* Adjust will no longer receive data from this user/device via the Adjust SDK.\([2](https://help.adjust.com/en/article/gdpr#ref-2)\) +- Adjust will permanently delete all of the user’s historical personal data from its internal systems and database. +- Adjust will no longer receive data from this user/device via the Adjust SDK.\([2](https://help.adjust.com/ja/article/gdpr#ref-2)\) ```js Adjust.gdprForgetMe(); ``` -特定のユーザーの情報をサードパーティと共有する \{\#third\-party\-sharing\-for\-specific\-users\} ---------------------------------------------------------------------------------- +## 特定のユーザーの情報をサードパーティと共有する \{\#third\-party\-sharing\-for\-specific\-users\} - +{" "} Adjust SDKを使用して、ユーザーがサードパーティとの共有設定を変更した時にそれを記録することができます。これらの設定は、`ThirdPartySharing`クラスを使用して行われます。 -### AdjustThirdPartySharingオブジェクトをインスタンス化する \{\#instantiate\-an\-adjustthirdpartysharing\-object\} +### AdjustThirdPartySharingオブジェクトをインスタンス化する {#instantiate-an-adjustthirdpartysharing-object} - + ```ts class ThirdPartySharing { @@ -45,13 +47,13 @@ class ThirdPartySharing { } ``` - + Adjust SDKでサードパーティ共有を有効化または無効化するには、`ThirdPartySharing`オブジェクトをインスタンス化する必要があります。このオブジェクトには、Adjustがサードパーティとの共有をどのように扱うかを制御する変数が含まれます。 これをインスタンス化するには、新しい`ThirdPartySharing`インスタンスを作成して、以下のパラメーターをパスしてください： -* `isEnabled` \( `boolean` \) ：`true`をパスしてサードパーティ共有を有効化するか、 `false`をパスして無効化します。 +- `isEnabled` \( `boolean` \) ：`true`をパスしてサードパーティ共有を有効化するか、 `false`をパスして無効化します。 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -66,9 +68,12 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### サードパーティ共有を無効にする（廃止）\{\#disable\-third\-party\-sharing\} +### サードパーティ共有を無効にする（廃止）{#disable-third-party-sharing} - +{" "} 以前のバージョンのSDKでサードパーティとの共有を無効にするには、 `disableThirdPartySharing`メソッドを呼び出します。このメソッドは廃止されました。それでも使用する場合は、基礎となるメソッドを直接呼び出していることに注意してください。 @@ -77,9 +82,9 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(false); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 粒度の高い情報を送信する \{\#send\-granular\-information\} +### 粒度の高い情報を送信する {#send-granular-information} - + ```ts public addGranularOption(partnerName: string, @@ -87,15 +92,15 @@ public addGranularOption(partnerName: string, value: string) ``` - + ユーザーがサードパーティの共有設定を更新すると、詳細な情報を付与できます。この情報を使用して、ユーザー行動についてより詳しく伝えることができます。 これを行うには、以下のパラメーターを使用して`addGranularOption`メソッドを呼び出します： -* `partnerName` （`string`）：granular optionが適用されるパートナーの名前 -* `key` （`string`）：オプションのキー -* `value` （`string`）：オプションの値 +- `partnerName` （`string`）：granular optionが適用されるパートナーの名前 +- `key` （`string`）：オプションのキー +- `value` （`string`）：オプションの値 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -103,34 +108,37 @@ options.addGranularOption("PartnerA", "foo", "bar"); Adjust.trackThirdPartySharing(options); ``` -URL strategy \{\#url\-strategy\} ------------------------------------- +## URL strategy \{\#url\-strategy\} - +{" "} URL戦略機能では、以下のいずれかを設定することができます： -* Adjustがお客様のデータを保管する国（データレジデンシー）。 -* Adjust SDKがトラフィックを送信するエンドポイント（カスタムURL）。 +- Adjustがお客様のデータを保管する国（データレジデンシー）。 +- Adjust SDKがトラフィックを送信するエンドポイント（カスタムURL）。 これは、プライバシー要件が厳しい国で事業を展開している場合に便利です。URL戦略を設定すると、Adjustは選択したデータレジデンシー地域にデータを保管したり、選択したドメインにトラフィックを送信したりします。 URL戦略を設定するには、 `Adjust.initSdk`インスタンスの`urlStrategy`の以下のプロパティを設定します。 -* `domains` （`Array`）：SDKトラフィックを送信する国、データの所在国、またはエンドポイント。デフォルトでは、Adjust SDKは全てのデータをAdjustのエンドポイントに送信します。カスタムエンドポイントを設定する場合は、 `urlStrategy`の`domains`プロパティでパスします。 -* `useSubdomains` （`boolean`）：ドメインをAdjustドメインとして扱うかどうか。 - * `true`の場合、SDKはドメインの前にAdjust固有のサブドメインを付けます。 - * `false`の場合、SDKは指定されたドメインをプレフィックスなしでそのまま使用します。 +- `domains` （`Array`）：SDKトラフィックを送信する国、データの所在国、またはエンドポイント。デフォルトでは、Adjust SDKは全てのデータをAdjustのエンドポイントに送信します。カスタムエンドポイントを設定する場合は、 `urlStrategy`の`domains`プロパティでパスします。 +- `useSubdomains` （`boolean`）：ドメインをAdjustドメインとして扱うかどうか。 + + - `true`の場合、SDKはドメインの前にAdjust固有のサブドメインを付けます。 + - `false`の場合、SDKは指定されたドメインをプレフィックスなしでそのまま使用します。 -* `isDataResidency` （`boolean`）：オプション。ドメインをデータレジデンシーに使用するかどうか。 +- `isDataResidency` （`boolean`）：オプション。ドメインをデータレジデンシーに使用するかどうか。 以下の設定リストをご覧ください。 -| urlStrategy | デフォルトドメインとカスタムドメイン | サブドメインの使用 | データレジデンシー | -|--------------|-------------------------------|-----------|-----------| -| EU データレジデンシー | `"eu.adjust.com"` | `true` | `true` | -| 中国 URL戦略 | `"adjust.cn"`。 `"adjust.com"` | `true` | `false` | -| カスタムURL戦略 | `"my.custom.domain"` | `false` | `false` | +| urlStrategy | デフォルトドメインとカスタムドメイン | サブドメインの使用 | データレジデンシー | +| --------------------- | ------------------------------------ | ------------------ | ------------------ | +| EU データレジデンシー | `"eu.adjust.com"` | `true` | `true` | +| 中国 URL戦略 | `"adjust.cn"`。 `"adjust.com"` | `true` | `false` | +| カスタムURL戦略 | `"my.custom.domain"` | `false` | `false` | ```js Adjust.initSdk({ @@ -145,12 +153,16 @@ Adjust.initSdk({ }); ``` -### カスタムエンドポイントの設定（廃止済み）\{\#set\-custom\-endpoint\} +### カスタムエンドポイントの設定（廃止済み）{#set-custom-endpoint} - +{" "} 以前のバージョンのSDKでは、廃止された`customUrl`プロパティを使用してエンドポイントをパスしていました。今後は`urlStrategy`設定を使用してください。 - + + ```js Adjust.initSdk({ @@ -166,14 +178,18 @@ Adjust.initSdk({ }); ``` - + -### データレジデンシー（廃止済み）\{\#data\-residency\} +### データレジデンシー（廃止済み）{#data-residency} - +{" "} 以前のバージョンのSDKでは、廃止された`dataResidency`プロパティを使用していました。今後は`urlStrategy`設定を使用してください。 - + + ```js Adjust.initSdk({ @@ -190,4 +206,3 @@ Adjust.initSdk({ ``` - diff --git a/src/content/docs/ja/sdk/web/index.mdx b/src/content/docs/ja/sdk/web/index.mdx index 90dd9cc3ef..51f008f106 100644 --- a/src/content/docs/ja/sdk/web/index.mdx +++ b/src/content/docs/ja/sdk/web/index.mdx @@ -1,91 +1,271 @@ --- -title: "Web SDK integration guide" -description: "Use the Web SDK to access Adjust's features in your web apps" -category-title: "Web SDK" -slug: "en/sdk/web" +title: Web SDK integration guide +description: Use the Web SDK to access Adjust's features in your web apps +category-title: Web SDK +slug: ja/sdk/web sidebar-position: 8 --- + Adjust Web SDKを実装することで、アトリビューションやイベントなどのさまざまなデータをWebアプリで記録できます。このガイドでは、Adjust SDKをアプリに実装する方法をご紹介します。 - + + Web SDKを使用するには、Adjustダッシュボードで専用のWebアプリを作成し、その2つを連携する必要があります。モバイルアプリSDKが既に実装されているモバイルアプリには、Web SDKを実装しないでください。 - -1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} -------------------------------------------------------------------------------- + + +## 1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} まずは、WebアプリにSDKを追加します。Adjust SDKは、CommonJSとAMD（Asynchronous Module Definition）の両方の環境で動作します。CDN（Content Delivery Network）を利用して読み込むと、グローバルの`Adjust`名前空間を介してアクセスできます。 -### Using a CDN \{\#using\-a\-cdn\} +### Using a CDN {#using-a-cdn} CDNを利用してSDKを読み込むときは、本番用ビルドには縮小バージョンを使用する必要があります。 -* バージョンを指定するには、`https://cdn.adjust.com/adjust-5.7.0.min.js`のようにCDNターゲットに追加します。 -* 最新バージョンを読み込むには、次のように`adjust-latest`パッケージを使用してください：`https://cdn.adjust.com/adjust-latest.min.js` 。このパッケージは自動的にアップデートされるため、ターゲットファイルを変更する必要はありません。 +- バージョンを指定するには、`https://cdn.adjust.com/adjust-5.7.0.min.js`のようにCDNターゲットに追加します。 +- 最新バージョンを読み込むには、次のように`adjust-latest`パッケージを使用してください：`https://cdn.adjust.com/adjust-latest.min.js` 。このパッケージは自動的にアップデートされるため、ターゲットファイルを変更する必要はありません。 - + The SDK files are cached to enable fast service. This cache updates every 30 minutes. If you want to force an update to the latest version, target a specific version in your header. - -CDNを利用してSDKを読み込むには、Webアプリの``タグ間に次のスニペットを追加します。 + + +CDNを利用してSDKを読み込むには、Webアプリの``タグ間に次のスニペットを追加します。 \{/\* prettier\-ignore \*/\} ```html - ``` The Adjust SDK loads on each page and initiates once per page load. -#### Subresource Integrity \{\#subresource\-integrity\} +#### Subresource Integrity {#subresource-integrity} XSS（クロスサイトスクリプティング）攻撃を緩和するために、[サブリソース完全性](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity)チェックを使用します。実行前にパッケージを検証するには、次のコールを使用します（追加の`crossOrigin`、 `integrity`、およびエンコードされたハッシュにご留意ください）。 \{/\* prettier\-ignore \*/\} ```html - ``` -### Using npm \{\#using\-npm\} +### Using npm {#using-npm} The Adjust SDK is also available on [npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk). To add the package to your project, use your preferred package manager: - + + + ```console $ npm install @adjustcom/adjust-web-sdk --save ``` - + + ```console $ yarn add @adjustcom/adjust-web-sdk ``` - + + ```console $ pnpm add @adjustcom/adjust-web-sdk ``` - + + -2\. Initialize the SDK \{\#initialize\-the\-sdk\} -------------------------------------------------------- +## 2\. Initialize the SDK \{\#initialize\-the\-sdk\} SDKをインストールしたら初期化する必要があります。これを行うには、`initSdk`メソッドを呼び出してください。このメソッドには、アプリでのSDKの動作をカスタマイズするために使用できる引数があります。 SDKを初期化するには、 `initSdk`の呼び出しに次の引数を追加する必要があります。 -* `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/en/article/app-token-and-reporting-currency#view-your-app-details). -* `environment` （`string`）：SDKを実行したい環境。 - * SDKをテストモードで実行するには、 `sandbox`をパスします。 - * リリースの本番用モードでSDKを実行するには、 `production`をパスします。 +- `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/ja/article/app-token-and-reporting-currency#view-your-app-details). +- `environment` （`string`）：SDKを実行したい環境。 + - SDKをテストモードで実行するには、 `sandbox`をパスします。 + - リリースの本番用モードでSDKを実行するには、 `production`をパスします。 ```js Adjust.initSdk({ @@ -94,8 +274,8 @@ Adjust.initSdk({ }); ``` - + -AdjustのWeb SDKの引数とプロパティの全リストは、[設定ガイド](/en/sdk/web/configuration)をご覧ください。 - +AdjustのWeb SDKの引数とプロパティの全リストは、[設定ガイド](/ja/sdk/web/configuration)をご覧ください。 + diff --git a/src/content/docs/ko/sdk/web/features/attribution.mdx b/src/content/docs/ko/sdk/web/features/attribution.mdx index c82851c9f5..5f0e11b842 100644 --- a/src/content/docs/ko/sdk/web/features/attribution.mdx +++ b/src/content/docs/ko/sdk/web/features/attribution.mdx @@ -1,12 +1,14 @@ --- -title: "Get attribution information" -description: "Listen for attribution changes using the Adjust SDK" -slug: "en/sdk/web/features/attribution" +title: Get attribution information +description: Listen for attribution changes using the Adjust SDK +slug: ko/sdk/web/features/attribution --- -When a user interacts with an Adjust link, their attribution information updates. This can happen if the user interacts with a [deep link](https://help.adjust.com/en/article/deep-links). Information about a user's attribution is represented in an Attribution object. + +When a user interacts with an Adjust link, their attribution information updates. This can happen if the user interacts with a [deep link](https://help.adjust.com/ko/article/deep-links). Information about a user's attribution is represented in an Attribution object. The Attribution object contains the following information: - + + ```js export type AttributionMapT = $ReadOnly<{| @@ -22,10 +24,10 @@ export type AttributionMapT = $ReadOnly<{| |}>; ``` - + -| Values | Data type | Description | -|-----------------|-----------|-----------------------------------------------------------------------------------------------------| +| Values | Data type | Description | +| --------------- | --------- | --------------------------------------------------------------------------------------------------- | | `adid` | `string` | The device's unique Adjust identifier. | | `tracker_token` | `string` | The link token associated with the attribution. | | `tracker_name` | `string` | The name of the campaign link. | @@ -33,19 +35,18 @@ export type AttributionMapT = $ReadOnly<{| | `campaign` | `string` | The name of the campaign associated with the attribution. | | `adgroup` | `string` | The adgroup associated with the attribution. | | `creative` | `string` | The creative associated with the attribution. | -| `click_label` | `string` | The [click label](https://help.adjust.com/en/article/user-rewards) associated with the attribution. | +| `click_label` | `string` | The [click label](https://help.adjust.com/ko/article/user-rewards) associated with the attribution. | | `state` | `string` | The current state of the attribution. Either `installed` or `reattributed` | -Trigger a callback when attribution changes \{\#trigger\-a\-callback\-when\-attribution\-changes\} ----------------------------------------------------------------------------------------------------------- +## Trigger a callback when attribution changes \{\#trigger\-a\-callback\-when\-attribution\-changes\} - + ```js attributionCallback: (string, Object) => mixed; ``` - + The SDK can listen for attribution changes and call a function when it detects an update. You can set an attribution callback method by specifying an `attributionCallback` function in the `initSdk` method. Within your function, you have access to the user's attribution information. @@ -67,10 +68,12 @@ Adjust.initSdk({ }); ``` -Get current attribution information \{\#get\-current\-attribution\-information\} --------------------------------------------------------------------------------------- +## Get current attribution information \{\#get\-current\-attribution\-information\} - +{" "} 사용자가 앱을 설치하면 Adjust는 해당 설치를 캠페인에 어트리뷰션합니다. Adjust SDK를 사용하면 설치 캠페인 어트리뷰션 정보에 액세스할 수 있습니다. `waitForAttribution` 메서드는 SDK가 서버에서 어트리뷰션 데이터를 성공적으로 수신했을 때 `promise` 를 반환합니다. @@ -80,29 +83,30 @@ Adjust.waitForAttribution().then((attr) => ); ``` -Set a referrer \{\#set\-a\-referrer\} ------------------------------------------- +## Set a referrer \{\#set\-a\-referrer\} - + ```js function setReferrer(referrer: string): void; ``` - + You can set a referrer to trigger an SDK click with a custom click ID when the SDK starts. The SDK sends your custom click ID to Adjust's servers for attribution purposes. - + + Call this method as close to initializing the SDK as possible to ensure your referrer is used for attribution. - + + To set your referrer, call the `setReferrer` method and pass your referrer as a URL\-encoded `string` argument. - + + ```js Adjust.setReferrer("adjust_external_click_id%3DEXTERNAL_CLICK_ID"); ``` - diff --git a/src/content/docs/ko/sdk/web/features/device-info.mdx b/src/content/docs/ko/sdk/web/features/device-info.mdx index d9ba4116c4..112b123c00 100644 --- a/src/content/docs/ko/sdk/web/features/device-info.mdx +++ b/src/content/docs/ko/sdk/web/features/device-info.mdx @@ -1,14 +1,17 @@ --- -title: "Get device information" -description: "Use these methods to add details to your callbacks and improve your reporting." -slug: "en/sdk/web/features/device-info" +title: Get device information +description: Use these methods to add details to your callbacks and improve your reporting. +slug: ko/sdk/web/features/device-info --- + The Adjust SDK contains helper methods that return device information. Use these methods to add details to your callbacks and improve your reporting. -Web UUID \{\#web\-uuid\} ----------------------------- +## Web UUID \{\#web\-uuid\} - +{" "} 웹 SDK는 Adjust에서 웹 사용자를 식별하기 위해 첫 세션 전송 시 고유한 `web_uuid` 식별자를 생성합니다. 이 ID는 UUID\(Universally Unique Identifier\) 형식을 따릅니다. @@ -19,4 +22,3 @@ Call the `waitForWebUUID` method to return this information as a `string`. ```js Adjust.waitForWebUUID().then((webUuid) => console.log(webUuid)); ``` - diff --git a/src/content/docs/ko/sdk/web/features/privacy.mdx b/src/content/docs/ko/sdk/web/features/privacy.mdx index 6475cce626..6eff055dd8 100644 --- a/src/content/docs/ko/sdk/web/features/privacy.mdx +++ b/src/content/docs/ko/sdk/web/features/privacy.mdx @@ -1,42 +1,44 @@ --- -title: "Set up privacy features" -description: "Configure features that you can use to handle user privacy in your app." -slug: "en/sdk/web/features/privacy" +title: Set up privacy features +description: Configure features that you can use to handle user privacy in your app. +slug: ko/sdk/web/features/privacy --- + The Adjust SDK contains features that you can use to handle user privacy in your app. -Send erasure request \{\#send\-erasure\-request\} ------------------------------------------------------- +## Send erasure request \{\#send\-erasure\-request\} - + ```js function gdprForgetMe(): void; ``` - + -The EU’s General Data Protection Regulation \(GDPR\) and similar privacy laws worldwide \(CCPA, LGPD, etc.\) grant data subjects comprehensive rights when it comes to the processing of their personal data. These rights include, among others, the right to erasure \(see [Art. 17 GDPR](https://gdpr.eu/article-17-right-to-be-forgotten/)\)\([1](https://help.adjust.com/en/article/gdpr#ref-1)\). As a data processor, Adjust is obliged to support you \(the data controller\) in the processing of such requests from your \(app\) users. +The EU’s General Data Protection Regulation \(GDPR\) and similar privacy laws worldwide \(CCPA, LGPD, etc.\) grant data subjects comprehensive rights when it comes to the processing of their personal data. These rights include, among others, the right to erasure \(see [Art. 17 GDPR](https://gdpr.eu/article-17-right-to-be-forgotten/)\)\([1](https://help.adjust.com/ko/article/gdpr#ref-1)\). As a data processor, Adjust is obliged to support you \(the data controller\) in the processing of such requests from your \(app\) users. You can send the user's erasure request to Adjust by calling the `gdprForgetMe` method. Once Adjust has been notified: -* Adjust will permanently delete all of the user’s historical personal data from its internal systems and database. -* Adjust will no longer receive data from this user/device via the Adjust SDK.\([2](https://help.adjust.com/en/article/gdpr#ref-2)\) +- Adjust will permanently delete all of the user’s historical personal data from its internal systems and database. +- Adjust will no longer receive data from this user/device via the Adjust SDK.\([2](https://help.adjust.com/ko/article/gdpr#ref-2)\) ```js Adjust.gdprForgetMe(); ``` -특정 사용자에 대한 서드파티 공유 \{\#third\-party\-sharing\-for\-specific\-users\} ----------------------------------------------------------------------------- +## 특정 사용자에 대한 서드파티 공유 \{\#third\-party\-sharing\-for\-specific\-users\} - +{" "} Adjust SDK를 사용하여 사용자의 서드파티 공유 설정 변경 내용을 기록할 수 있습니다. 이러한 설정은 `ThirdPartySharing` 클래스를 사용하여 구성됩니다. -### AdjustThirdPartySharing 객체 인스턴스화 \{\#instantiate\-an\-adjustthirdpartysharing\-object\} +### AdjustThirdPartySharing 객체 인스턴스화 {#instantiate-an-adjustthirdpartysharing-object} - + ```ts class ThirdPartySharing { @@ -45,13 +47,13 @@ class ThirdPartySharing { } ``` - + Adjust SDK와의 서드파트 공유를 활성화 또는 비활성화하려면 `ThirdPartySharing` 객체를 인스턴스화합니다. 이 객체에 Adjust의 서드파티 공유 처리 방식을 제어하는 변수가 포함됩니다. 이를 인스턴스화하려면 새로운 `ThirdPartySharing` 인스턴스를 생성하고 다음 파라미터를 전달합니다. -* `isEnabled` \(`boolean`\):`true` 전달로 서드파티 공유를 활성화하거나 `false` 전달로 서드파티 공유를 비활성화합니다. +- `isEnabled` \(`boolean`\):`true` 전달로 서드파티 공유를 활성화하거나 `false` 전달로 서드파티 공유를 비활성화합니다. ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -66,9 +68,12 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 서드파티 공유 비활성화\(지원 중단\) \{\#disable\-third\-party\-sharing\} +### 서드파티 공유 비활성화\(지원 중단\) {#disable-third-party-sharing} - +{" "} 이전 버전의 SDK에서 서드파티 공유를 비활성화하려면 `disableThirdPartySharing` 메서드를 호출합니다. 이 메서드는 지원 중단되었습니다. 계속 사용할 경우 기본 메서드를 직접 호출하게 됩니다. @@ -77,9 +82,9 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(false); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 세분화된 정보 전송 \{\#send\-granular\-information\} +### 세분화된 정보 전송 {#send-granular-information} - + ```ts public addGranularOption(partnerName: string, @@ -87,15 +92,15 @@ public addGranularOption(partnerName: string, value: string) ``` - + 서드파티 공유 설정 변경 시 세부 정보를 추가할 수 있습니다. 이를 통해 사용자의 결정에 대한 더욱 자세한 정보를 전달할 수 있습니다. 다음 파라미터와 함께 `addGranularOption` 메서드를 호출합니다. -* `partnerName` \(`string`\): 세분화 옵션을 적용할 파트너의 이름 -* `key` \(`string`\): 옵션 키 -* `value` \(`string`\): 옵션 값 +- `partnerName` \(`string`\): 세분화 옵션을 적용할 파트너의 이름 +- `key` \(`string`\): 옵션 키 +- `value` \(`string`\): 옵션 값 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -103,34 +108,37 @@ options.addGranularOption("PartnerA", "foo", "bar"); Adjust.trackThirdPartySharing(options); ``` -URL strategy \{\#url\-strategy\} ------------------------------------- +## URL strategy \{\#url\-strategy\} - +{" "} URL 전략 기능을 사용하여 다음을 설정할 수 있습니다. -* Adjust가 귀하의 데이터를 저장하는 국가\(데이터 레지던시\). -* Adjust SDK가 트래픽을 전송하는 엔드포인트\(맞춤 URL\). +- Adjust가 귀하의 데이터를 저장하는 국가\(데이터 레지던시\). +- Adjust SDK가 트래픽을 전송하는 엔드포인트\(맞춤 URL\). 본 기능은 프라이버시 요건이 엄격한 나라에서 앱을 운영하는 경우에 유용합니다. URL 전략을 설정하면 Adjust가 선택된 데이터 레지던시 지역에 데이터를 저장하거나 선택된 도메인으로 트래픽을 전송합니다. URL 전략을 구성하려면 `Adjust.initSdk` 인스턴스에 `urlStrategy` 의 다음 속성을 설정합니다. -* `domains` \(`Array`\): SDK 트래픽을 전송할 데이터 레지던스 국가 또는 엔드포인트. 기본 설정에 따라 Adjust SDK는 모든 데이터를 Adjust의 엔드포인트로 전송합니다. 커스텀 엔드포인트를 설정하려면 `urlStrategy`의 `domains` 속성에 엔드포인트를 전달합니다. -* `useSubdomains` \(`boolean`\): 도메인을 Adjust 도메인으로 취급할지 여부. - * `true`인 경우 SDK는 도메인의 접두사로 Adjust에 특화된 하위 도메인을 사용합니다. - * `false`인 경우 SDK는 접두사 없이 제공된 도메인을 그대로 사용합니다. +- `domains` \(`Array`\): SDK 트래픽을 전송할 데이터 레지던스 국가 또는 엔드포인트. 기본 설정에 따라 Adjust SDK는 모든 데이터를 Adjust의 엔드포인트로 전송합니다. 커스텀 엔드포인트를 설정하려면 `urlStrategy`의 `domains` 속성에 엔드포인트를 전달합니다. +- `useSubdomains` \(`boolean`\): 도메인을 Adjust 도메인으로 취급할지 여부. + + - `true`인 경우 SDK는 도메인의 접두사로 Adjust에 특화된 하위 도메인을 사용합니다. + - `false`인 경우 SDK는 접두사 없이 제공된 도메인을 그대로 사용합니다. -* `isDataResidency` \(`boolean`\): 선택 사항으로, 도메인을 데이터 레지던시에 사용해야 하는지 여부입니다. +- `isDataResidency` \(`boolean`\): 선택 사항으로, 도메인을 데이터 레지던시에 사용해야 하는지 여부입니다. 다음 표는 구성 목록을 보여줍니다. -| URL 전략 | 기본 도메인 및 커스텀 도메인 | 하위 도메인 사용 | 데이터 레지던시 | -|-------------|-------------------------------|-----------|----------| -| EU 데이터 레지던시 | `"eu.adjust.com"` | `true` | `true` | -| 중국 URL 전략 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | -| 맞춤 URL 전략 | `"my.custom.domain"` | `false` | `false` | +| URL 전략 | 기본 도메인 및 커스텀 도메인 | 하위 도메인 사용 | 데이터 레지던시 | +| ------------------ | ----------------------------- | ---------------- | --------------- | +| EU 데이터 레지던시 | `"eu.adjust.com"` | `true` | `true` | +| 중국 URL 전략 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | +| 맞춤 URL 전략 | `"my.custom.domain"` | `false` | `false` | ```js Adjust.initSdk({ @@ -145,12 +153,16 @@ Adjust.initSdk({ }); ``` -### 커스텀 엔드포인트 설정\(지원 중단\) \{\#set\-custom\-endpoint\} +### 커스텀 엔드포인트 설정\(지원 중단\) {#set-custom-endpoint} - +{" "} 이전 버전의 SDK는 지원 중단된 `customUrl` 속성을 사용하여 엔드포인트를 전달했습니다. 대신 `urlStrategy` 구성을 사용하시기 바랍니다. - + + ```js Adjust.initSdk({ @@ -166,14 +178,18 @@ Adjust.initSdk({ }); ``` - + -### 데이터 레지던시\(지원 중단\) \{\#data\-residency\} +### 데이터 레지던시\(지원 중단\) {#data-residency} - +{" "} 이전 버전의 SDK는 지원 중단된 `dataResidency` 속성을 사용했습니다. 대신 `urlStrategy` 구성을 사용하시기 바랍니다. - + + ```js Adjust.initSdk({ @@ -190,4 +206,3 @@ Adjust.initSdk({ ``` - diff --git a/src/content/docs/ko/sdk/web/index.mdx b/src/content/docs/ko/sdk/web/index.mdx index fe0e06df44..0e2a313b23 100644 --- a/src/content/docs/ko/sdk/web/index.mdx +++ b/src/content/docs/ko/sdk/web/index.mdx @@ -1,91 +1,271 @@ --- -title: "Web SDK integration guide" -description: "Use the Web SDK to access Adjust's features in your web apps" -category-title: "Web SDK" -slug: "en/sdk/web" +title: Web SDK integration guide +description: Use the Web SDK to access Adjust's features in your web apps +category-title: Web SDK +slug: ko/sdk/web sidebar-position: 8 --- + Adjust 웹 SDK를 사용하면 웹 앱에서 어트리뷰션, 이벤트 및 기타 데이터를 기록할 수 있습니다. 이 가이드에서는 SDK를 앱과 연동하는 방법을 설명합니다. - + + 웹 SDK를 사용하려면 Adjust 대시보드에서 지원 중단된 웹 앱을 생성하고 그 둘을 연결해야 합니다. 웹 SDK를 모바일 앱 SDK가 이미 포함된 모바일 앱과 연동해서는 안 됩니다. - -1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} -------------------------------------------------------------------------------- + + +## 1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} 시작하려면 웹 앱에 SDK를 추가합니다. Adjust SDK는 CommonJS와 AMD\(비동기 모듈 정의\) 환경에서 모두 작동합니다. CDN\(콘텐츠 전송 네트워크\)을 통해 로딩될 때 글로벌 `Adjust` 네임스페이스를 통해 액세스할 수 있습니다. -### Using a CDN \{\#using\-a\-cdn\} +### Using a CDN {#using-a-cdn} CDN을 통해 SDK를 로딩할 때 프로덕션 빌드에 간소화된 버전을 사용해야 합니다. -* 다음과 같이 CDN 대상에 추가하여 특정 버전을 로드할 수 있습니다. `https://cdn.adjust.com/adjust-5.7.0.min.js` -* 최신 버전을 로드하려면 다음과 같이 `adjust-latest` 패키지를 사용합니다. `https://cdn.adjust.com/adjust-latest.min.js` 이 패키지는 자동으로 업데이트되므로 대상 파일을 변경할 필요가 없습니다. +- 다음과 같이 CDN 대상에 추가하여 특정 버전을 로드할 수 있습니다. `https://cdn.adjust.com/adjust-5.7.0.min.js` +- 최신 버전을 로드하려면 다음과 같이 `adjust-latest` 패키지를 사용합니다. `https://cdn.adjust.com/adjust-latest.min.js` 이 패키지는 자동으로 업데이트되므로 대상 파일을 변경할 필요가 없습니다. - + The SDK files are cached to enable fast service. This cache updates every 30 minutes. If you want to force an update to the latest version, target a specific version in your header. - -CDN을 통해 SDK를 로드하려면 웹 앱의 `` 요소 안에 다음 스니펫을 추가합니다. + + +CDN을 통해 SDK를 로드하려면 웹 앱의 `` 요소 안에 다음 스니펫을 추가합니다. \{/\* prettier\-ignore \*/\} ```html - ``` The Adjust SDK loads on each page and initiates once per page load. -#### Subresource Integrity \{\#subresource\-integrity\} +#### Subresource Integrity {#subresource-integrity} [하위 리소스 무결성](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) 검사를 사용하여 XSS\(사이트 간 스크립팅\) 공격을 완화할 수 있습니다. 패키지를 실행하기 전에 검증하려면 다음 콜\(추가 `crossOrigin`, `integrity`, 인코딩된 해시 확인\)을 사용합니다. \{/\* prettier\-ignore \*/\} ```html - ``` -### Using npm \{\#using\-npm\} +### Using npm {#using-npm} The Adjust SDK is also available on [npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk). To add the package to your project, use your preferred package manager: - + + + ```console $ npm install @adjustcom/adjust-web-sdk --save ``` - + + ```console $ yarn add @adjustcom/adjust-web-sdk ``` - + + ```console $ pnpm add @adjustcom/adjust-web-sdk ``` - + + -2\. Initialize the SDK \{\#initialize\-the\-sdk\} -------------------------------------------------------- +## 2\. Initialize the SDK \{\#initialize\-the\-sdk\} SDK를 설치한 후에는 초기화해야 합니다. 해당 기능 사용을 원하는 경우 `initSdk` 메서드를 호출합니다. 이 메서드는 앱에서 SDK가 작동하는 방식을 사용자 지정하는 데 사용할 수 있는 인수를 제공합니다. SDK를 시작하려면 다음 인수를 `initSdk` 호출에 추가해야 합니다. -* `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/en/article/app-token-and-reporting-currency#view-your-app-details). -* `environment` \(`string`\): SDK를 실행할 환경입니다. - * 테스트 모드에서 SDK를 실행하려면 `sandbox` 를 전달합니다. - * 릴리즈를 위해 프로덕션 모드에서 SDK를 실행하려면 `production` 을 전달합니다. +- `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/ko/article/app-token-and-reporting-currency#view-your-app-details). +- `environment` \(`string`\): SDK를 실행할 환경입니다. + - 테스트 모드에서 SDK를 실행하려면 `sandbox` 를 전달합니다. + - 릴리즈를 위해 프로덕션 모드에서 SDK를 실행하려면 `production` 을 전달합니다. ```js Adjust.initSdk({ @@ -94,8 +274,8 @@ Adjust.initSdk({ }); ``` - + -[구성 가이드](/en/sdk/web/configuration)에서 Adjust 웹 SDK의 전체 인수 및 속성 목록을 확인하실 수 있습니다. - +[구성 가이드](/ko/sdk/web/configuration)에서 Adjust 웹 SDK의 전체 인수 및 속성 목록을 확인하실 수 있습니다. + diff --git a/src/content/docs/zh/sdk/web/features/attribution.mdx b/src/content/docs/zh/sdk/web/features/attribution.mdx index 09f05a8dab..e4025e0051 100644 --- a/src/content/docs/zh/sdk/web/features/attribution.mdx +++ b/src/content/docs/zh/sdk/web/features/attribution.mdx @@ -1,12 +1,14 @@ --- -title: "Get attribution information" -description: "Listen for attribution changes using the Adjust SDK" -slug: "en/sdk/web/features/attribution" +title: Get attribution information +description: Listen for attribution changes using the Adjust SDK +slug: zh/sdk/web/features/attribution --- -When a user interacts with an Adjust link, their attribution information updates. This can happen if the user interacts with a [deep link](https://help.adjust.com/en/article/deep-links). Information about a user's attribution is represented in an Attribution object. + +When a user interacts with an Adjust link, their attribution information updates. This can happen if the user interacts with a [deep link](https://help.adjust.com/zh/article/deep-links). Information about a user's attribution is represented in an Attribution object. The Attribution object contains the following information: - + + ```js export type AttributionMapT = $ReadOnly<{| @@ -22,10 +24,10 @@ export type AttributionMapT = $ReadOnly<{| |}>; ``` - + -| Values | Data type | Description | -|-----------------|-----------|-----------------------------------------------------------------------------------------------------| +| Values | Data type | Description | +| --------------- | --------- | --------------------------------------------------------------------------------------------------- | | `adid` | `string` | The device's unique Adjust identifier. | | `tracker_token` | `string` | The link token associated with the attribution. | | `tracker_name` | `string` | The name of the campaign link. | @@ -33,19 +35,18 @@ export type AttributionMapT = $ReadOnly<{| | `campaign` | `string` | The name of the campaign associated with the attribution. | | `adgroup` | `string` | The adgroup associated with the attribution. | | `creative` | `string` | The creative associated with the attribution. | -| `click_label` | `string` | The [click label](https://help.adjust.com/en/article/user-rewards) associated with the attribution. | +| `click_label` | `string` | The [click label](https://help.adjust.com/zh/article/user-rewards) associated with the attribution. | | `state` | `string` | The current state of the attribution. Either `installed` or `reattributed` | -Trigger a callback when attribution changes \{\#trigger\-a\-callback\-when\-attribution\-changes\} ----------------------------------------------------------------------------------------------------------- +## Trigger a callback when attribution changes \{\#trigger\-a\-callback\-when\-attribution\-changes\} - + ```js attributionCallback: (string, Object) => mixed; ``` - + The SDK can listen for attribution changes and call a function when it detects an update. You can set an attribution callback method by specifying an `attributionCallback` function in the `initSdk` method. Within your function, you have access to the user's attribution information. @@ -67,10 +68,12 @@ Adjust.initSdk({ }); ``` -Get current attribution information \{\#get\-current\-attribution\-information\} --------------------------------------------------------------------------------------- +## Get current attribution information \{\#get\-current\-attribution\-information\} - +{" "} 用户安装您的应用时，Adjust 会将该安装归因至一个推广活动。Adjust SDK 可提供赢得安装归因的推广活动细节。`waitForAttribution`方法会返回一个`promise`，当 SDK 成功从服务器接收到归因数据时，该 promise 会被完成。 @@ -80,29 +83,30 @@ Adjust.waitForAttribution().then((attr) => ); ``` -Set a referrer \{\#set\-a\-referrer\} ------------------------------------------- +## Set a referrer \{\#set\-a\-referrer\} - + ```js function setReferrer(referrer: string): void; ``` - + You can set a referrer to trigger an SDK click with a custom click ID when the SDK starts. The SDK sends your custom click ID to Adjust's servers for attribution purposes. - + + Call this method as close to initializing the SDK as possible to ensure your referrer is used for attribution. - + + To set your referrer, call the `setReferrer` method and pass your referrer as a URL\-encoded `string` argument. - + + ```js Adjust.setReferrer("adjust_external_click_id%3DEXTERNAL_CLICK_ID"); ``` - diff --git a/src/content/docs/zh/sdk/web/features/device-info.mdx b/src/content/docs/zh/sdk/web/features/device-info.mdx index 3cb56a3ccb..e1ca9709ac 100644 --- a/src/content/docs/zh/sdk/web/features/device-info.mdx +++ b/src/content/docs/zh/sdk/web/features/device-info.mdx @@ -1,14 +1,17 @@ --- -title: "Get device information" -description: "Use these methods to add details to your callbacks and improve your reporting." -slug: "en/sdk/web/features/device-info" +title: Get device information +description: Use these methods to add details to your callbacks and improve your reporting. +slug: zh/sdk/web/features/device-info --- + The Adjust SDK contains helper methods that return device information. Use these methods to add details to your callbacks and improve your reporting. -Web UUID \{\#web\-uuid\} ----------------------------- +## Web UUID \{\#web\-uuid\} - +{" "} 为在 Adjust 中识别网页用户，Adjust Web SDK 会在发送第一次会话时生成唯一的 `web_uuid` 标识符。该标识符采用通用唯一标识符 \(UUID\) 格式。 @@ -19,4 +22,3 @@ Call the `waitForWebUUID` method to return this information as a `string`. ```js Adjust.waitForWebUUID().then((webUuid) => console.log(webUuid)); ``` - diff --git a/src/content/docs/zh/sdk/web/features/privacy.mdx b/src/content/docs/zh/sdk/web/features/privacy.mdx index 4ac91e7cdb..67ff3bd8a3 100644 --- a/src/content/docs/zh/sdk/web/features/privacy.mdx +++ b/src/content/docs/zh/sdk/web/features/privacy.mdx @@ -1,42 +1,44 @@ --- -title: "Set up privacy features" -description: "Configure features that you can use to handle user privacy in your app." -slug: "en/sdk/web/features/privacy" +title: Set up privacy features +description: Configure features that you can use to handle user privacy in your app. +slug: zh/sdk/web/features/privacy --- + The Adjust SDK contains features that you can use to handle user privacy in your app. -Send erasure request \{\#send\-erasure\-request\} ------------------------------------------------------- +## Send erasure request \{\#send\-erasure\-request\} - + ```js function gdprForgetMe(): void; ``` - + -The EU’s General Data Protection Regulation \(GDPR\) and similar privacy laws worldwide \(CCPA, LGPD, etc.\) grant data subjects comprehensive rights when it comes to the processing of their personal data. These rights include, among others, the right to erasure \(see [Art. 17 GDPR](https://gdpr.eu/article-17-right-to-be-forgotten/)\)\([1](https://help.adjust.com/en/article/gdpr#ref-1)\). As a data processor, Adjust is obliged to support you \(the data controller\) in the processing of such requests from your \(app\) users. +The EU’s General Data Protection Regulation \(GDPR\) and similar privacy laws worldwide \(CCPA, LGPD, etc.\) grant data subjects comprehensive rights when it comes to the processing of their personal data. These rights include, among others, the right to erasure \(see [Art. 17 GDPR](https://gdpr.eu/article-17-right-to-be-forgotten/)\)\([1](https://help.adjust.com/zh/article/gdpr#ref-1)\). As a data processor, Adjust is obliged to support you \(the data controller\) in the processing of such requests from your \(app\) users. You can send the user's erasure request to Adjust by calling the `gdprForgetMe` method. Once Adjust has been notified: -* Adjust will permanently delete all of the user’s historical personal data from its internal systems and database. -* Adjust will no longer receive data from this user/device via the Adjust SDK.\([2](https://help.adjust.com/en/article/gdpr#ref-2)\) +- Adjust will permanently delete all of the user’s historical personal data from its internal systems and database. +- Adjust will no longer receive data from this user/device via the Adjust SDK.\([2](https://help.adjust.com/zh/article/gdpr#ref-2)\) ```js Adjust.gdprForgetMe(); ``` -针对特定用户的第三方分享\{\#third\-party\-sharing\-for\-specific\-users\} ---------------------------------------------------------------------- +## 针对特定用户的第三方分享\{\#third\-party\-sharing\-for\-specific\-users\} - +{" "} 您可以使用 Adjust SDK 来记录用户对第三方数据分享设置的变更。请使用 `ThirdPartySharing` 类配置第三方数据分享。 -### 实例化 AdjustThirdPartySharing 对象\{\#instantiate\-an\-adjustthirdpartysharing\-object\} +### 实例化 AdjustThirdPartySharing 对象{#instantiate-an-adjustthirdpartysharing-object} - + ```ts class ThirdPartySharing { @@ -45,13 +47,13 @@ class ThirdPartySharing { } ``` - + 要启用或禁用 Adjust SDK 第三方数据分享，请实例化 `ThirdPartySharing` 对象。该对象包含控制 Adjust 如何处理第三方分享的变量。 要进行实例化，请创建新的 `ThirdPartySharing` 实例，并传递下列参数： -* `isEnabled` \( `boolean` \): 传递`true`来启用第三方分享或传递`false`来禁用第三方分享。 +- `isEnabled` \( `boolean` \): 传递`true`来启用第三方分享或传递`false`来禁用第三方分享。 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -66,9 +68,12 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 禁用第三方分享 \(已弃用\) \{\#disable\-third\-party\-sharing\} +### 禁用第三方分享 \(已弃用\) {#disable-third-party-sharing} - +{" "} 如需在之前版本的 SDK 中禁用第三方数据分享，请调用`disableThirdPartySharing`方法。此方法已被弃用。如果您仍在使用，请注意它会直接调用基础方法。 @@ -77,9 +82,9 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(false); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 发送精细信息\{\#send\-granular\-information\} +### 发送精细信息{#send-granular-information} - + ```ts public addGranularOption(partnerName: string, @@ -87,15 +92,15 @@ public addGranularOption(partnerName: string, value: string) ``` - + 当用户更新第三方数据分享设置时，您可以附加较精细的信息，以此发送用户决定的更多细节。 使用下列参数调用`addGranularOption`方法： -* `partnerName` \(`string`\)：使用精细设置的合作伙伴的名称。 -* `key` \(`string`\)：选项 key。 -* `value` \(`string`\)：选项值。 +- `partnerName` \(`string`\)：使用精细设置的合作伙伴的名称。 +- `key` \(`string`\)：选项 key。 +- `value` \(`string`\)：选项值。 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -103,34 +108,37 @@ options.addGranularOption("PartnerA", "foo", "bar"); Adjust.trackThirdPartySharing(options); ``` -URL strategy \{\#url\-strategy\} ------------------------------------- +## URL strategy \{\#url\-strategy\} - +{" "} 通过 URL 策略功能，您可以进行下列设置： -* Adjust 储存您数据的国家/地区 \(即数据驻留\)。 -* 接收 Adjust SDK 所发送流量的终端 \(自定义 URL \)。 +- Adjust 储存您数据的国家/地区 \(即数据驻留\)。 +- 接收 Adjust SDK 所发送流量的终端 \(自定义 URL \)。 当应用运营的国家拥有严格的隐私规定时，此功能会非常有用。在您设置 URL 策略时，Adjust 会将数据储存在指定数据驻留地区，或将流量发送至选定域名。 要配置 URL 策略，请在`Adjust.initSdk`实例中设置`urlStrategy`的以下属性： -* `domains` \(`Array`\)：接收您所发送 SDK 流量的数据驻留国家/地区或终端。默认情况下，Adjust SDK 会将所有数据都发送至 Adjust 终端。如果您想设置自定义终端，请在`urlStrategy`的`domains`属性中传递。 -* `useSubdomains` \(`boolean`\): 域名是否应被视为 Adjust 域名。 - * 如果为`true`，则 SDK 会在域名中添加 Adjust 特定子域作为前缀。 - * 如果为`false`，SDK 会按原样使用所提供的域名，不包含前缀。 +- `domains` \(`Array`\)：接收您所发送 SDK 流量的数据驻留国家/地区或终端。默认情况下，Adjust SDK 会将所有数据都发送至 Adjust 终端。如果您想设置自定义终端，请在`urlStrategy`的`domains`属性中传递。 +- `useSubdomains` \(`boolean`\): 域名是否应被视为 Adjust 域名。 + + - 如果为`true`，则 SDK 会在域名中添加 Adjust 特定子域作为前缀。 + - 如果为`false`，SDK 会按原样使用所提供的域名，不包含前缀。 -* `isDataResidency` \( `boolean` \)：可选。域名是否应被用于数据驻留。 +- `isDataResidency` \( `boolean` \)：可选。域名是否应被用于数据驻留。 下表展示了一系列配置。 -| URL 策略 | 默认和自定义域名 | 使用子域名 | 数据驻留 | -|------------|-------------------------------|---------|---------| -| 欧盟数据驻留 | `"eu.adjust.com"` | `true` | `true` | -| 中国 URL 策略 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | -| 自定义 URL 策略 | `"my.custom.domain"` | `false` | `false` | +| URL 策略 | 默认和自定义域名 | 使用子域名 | 数据驻留 | +| --------------- | ----------------------------- | ---------- | -------- | +| 欧盟数据驻留 | `"eu.adjust.com"` | `true` | `true` | +| 中国 URL 策略 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | +| 自定义 URL 策略 | `"my.custom.domain"` | `false` | `false` | ```js Adjust.initSdk({ @@ -145,12 +153,16 @@ Adjust.initSdk({ }); ``` -### 设置自定义终端 \(已弃用\) \{\#set\-custom\-endpoint\} +### 设置自定义终端 \(已弃用\) {#set-custom-endpoint} - +{" "} 之前版本的 SDK 使用`customUrl`属性传递终端，该属性已被弃用。请改用`urlStrategy`配置。 - + + ```js Adjust.initSdk({ @@ -166,14 +178,18 @@ Adjust.initSdk({ }); ``` - + -### 数据驻留 \(已弃用\) \{\#data\-residency\} +### 数据驻留 \(已弃用\) {#data-residency} - +{" "} 之前版本的 SDK 使用的是`dataResidency`属性，该属性已被弃用。请改用`urlStrategy`配置。 - + + ```js Adjust.initSdk({ @@ -190,4 +206,3 @@ Adjust.initSdk({ ``` - diff --git a/src/content/docs/zh/sdk/web/index.mdx b/src/content/docs/zh/sdk/web/index.mdx index 087e6f0c5f..13af544db8 100644 --- a/src/content/docs/zh/sdk/web/index.mdx +++ b/src/content/docs/zh/sdk/web/index.mdx @@ -1,91 +1,271 @@ --- -title: "Web SDK integration guide" -description: "Use the Web SDK to access Adjust's features in your web apps" -category-title: "Web SDK" -slug: "en/sdk/web" +title: Web SDK integration guide +description: Use the Web SDK to access Adjust's features in your web apps +category-title: Web SDK +slug: zh/sdk/web sidebar-position: 8 --- + 通过 Adjust Web SDK，您可以在网页应用中记录归因、事件以及更多数据。该指南展示了如何将该 SDK 集成至应用。 - + + 要使用 Web SDK，您必须在 Adjust 控制面板中创建专用的网页应用并将两者关联起来。请勿将 Web SDK 集成到已经包含移动应用 SDK 的移动应用中。 - -1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} -------------------------------------------------------------------------------- + + +## 1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} 要开始设置，请将 SDK 添加至网页应用。Adjust SDK 可在 CommonJS 和 AMD \(Asynchronous Module Definition\) 环境中运行。通过 CDN \(内容分发网络\) 加载时，您可以通过全局`Adjust`命名空间对其进行访问。 -### Using a CDN \{\#using\-a\-cdn\} +### Using a CDN {#using-a-cdn} 通过 CDN 加载 SDK 时，您应该在生产环境中使用压缩版本。 -* 您可以通过添加一个版本至 CDN 目标来加载指定版本，如下所示：`https://cdn.adjust.com/adjust-5.7.0.min.js`。 -* 要加载最新版本，请使用`adjust-latest`包，如下所示：`https://cdn.adjust.com/adjust-latest.min.js`。该包会自动更新，您无需更改目标文件。 +- 您可以通过添加一个版本至 CDN 目标来加载指定版本，如下所示：`https://cdn.adjust.com/adjust-5.7.0.min.js`。 +- 要加载最新版本，请使用`adjust-latest`包，如下所示：`https://cdn.adjust.com/adjust-latest.min.js`。该包会自动更新，您无需更改目标文件。 - + The SDK files are cached to enable fast service. This cache updates every 30 minutes. If you want to force an update to the latest version, target a specific version in your header. - -要通过 CDN 加载 SDK，请将以下代码片段加入网页应用的``元素中： + + +要通过 CDN 加载 SDK，请将以下代码片段加入网页应用的``元素中： \{/\* prettier\-ignore \*/\} ```html - ``` The Adjust SDK loads on each page and initiates once per page load. -#### Subresource Integrity \{\#subresource\-integrity\} +#### Subresource Integrity {#subresource-integrity} 请使用[子资源完整性](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity)检查来抵御 XSS \(跨站脚本\) 攻击。要在运行包之前对其进行验证，请使用以下调用 \(请注意额外的`crossOrigin` 、 `integrity`和经过编码的哈希值\): \{/\* prettier\-ignore \*/\} ```html - ``` -### Using npm \{\#using\-npm\} +### Using npm {#using-npm} The Adjust SDK is also available on [npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk). To add the package to your project, use your preferred package manager: - + + + ```console $ npm install @adjustcom/adjust-web-sdk --save ``` - + + ```console $ yarn add @adjustcom/adjust-web-sdk ``` - + + ```console $ pnpm add @adjustcom/adjust-web-sdk ``` - + + -2\. Initialize the SDK \{\#initialize\-the\-sdk\} -------------------------------------------------------- +## 2\. Initialize the SDK \{\#initialize\-the\-sdk\} 安装 SDK 后，需要进行初始化。为此，请调用`initSdk`方法。您可以使用该方法中的参数来自定义 SDK 在应用中的工作方式。 要初始化 SDK，您必须将以下参数添加至`initSdk`调用： -* `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/en/article/app-token-and-reporting-currency#view-your-app-details). -* `environment` \(`string`\)：SDK 运行的环境。 - * 传递`sandbox`来在测试模式下运行 SDK。 - * 传递 `production`来在生产模式下运行 SDK，方便发布。 +- `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/zh/article/app-token-and-reporting-currency#view-your-app-details). +- `environment` \(`string`\)：SDK 运行的环境。 + - 传递`sandbox`来在测试模式下运行 SDK。 + - 传递 `production`来在生产模式下运行 SDK，方便发布。 ```js Adjust.initSdk({ @@ -94,8 +274,8 @@ Adjust.initSdk({ }); ``` - + -您可以在[配置指南](/en/sdk/web/configuration)中找到 Adjust Web SDK 参数和属性的完整列表。 - +您可以在[配置指南](/zh/sdk/web/configuration)中找到 Adjust Web SDK 参数和属性的完整列表。 + From 8886e53d64a7f22556836c7f7725d7e639f613c8 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 9 Jan 2025 12:53:56 +0000 Subject: [PATCH 14/42] File src/content/docs/en/sdk/web/features/attribution.mdx was translated to ko-KR locale --- .../docs/ko/sdk/web/features/attribution.mdx | 78 +++++++++---------- 1 file changed, 37 insertions(+), 41 deletions(-) diff --git a/src/content/docs/ko/sdk/web/features/attribution.mdx b/src/content/docs/ko/sdk/web/features/attribution.mdx index 5f0e11b842..65e715eabc 100644 --- a/src/content/docs/ko/sdk/web/features/attribution.mdx +++ b/src/content/docs/ko/sdk/web/features/attribution.mdx @@ -1,14 +1,12 @@ --- -title: Get attribution information -description: Listen for attribution changes using the Adjust SDK -slug: ko/sdk/web/features/attribution +title: "어트리뷰션 정보 확인" +description: "Adjust SDK를 사용하여 어트리뷰션 변경 사항 수신" +slug: "en/sdk/web/features/attribution" --- +사용자가 Adjust 링크와 상호작용하면 어트리뷰션 정보가 업데이트됩니다. 이는 사용자가 [딥링크](https://help.adjust.com/en/article/deep-links)와 상호작용하는 경우에 발생할 수 있습니다. 사용자의 어트리뷰션 관련 정보는 어트리뷰션 객체에 나타납니다. -When a user interacts with an Adjust link, their attribution information updates. This can happen if the user interacts with a [deep link](https://help.adjust.com/ko/article/deep-links). Information about a user's attribution is represented in an Attribution object. - -The Attribution object contains the following information: - - +어트리뷰션 객체에는 다음 정보가 포함됩니다. + ```js export type AttributionMapT = $ReadOnly<{| @@ -24,31 +22,32 @@ export type AttributionMapT = $ReadOnly<{| |}>; ``` - + -| Values | Data type | Description | -| --------------- | --------- | --------------------------------------------------------------------------------------------------- | -| `adid` | `string` | The device's unique Adjust identifier. | -| `tracker_token` | `string` | The link token associated with the attribution. | -| `tracker_name` | `string` | The name of the campaign link. | -| `network` | `string` | The network associate with the campaign. | -| `campaign` | `string` | The name of the campaign associated with the attribution. | -| `adgroup` | `string` | The adgroup associated with the attribution. | -| `creative` | `string` | The creative associated with the attribution. | -| `click_label` | `string` | The [click label](https://help.adjust.com/ko/article/user-rewards) associated with the attribution. | -| `state` | `string` | The current state of the attribution. Either `installed` or `reattributed` | +| 값 | 데이터 유형 | 설명 | +|-----------------|----------|-----------------------------------------------------------------------| +| `adid` | `string` | 기기의 고유한 Adjust 식별자. | +| `tracker_token` | `string` | 어트리뷰션과 관련된 링크 토큰. | +| `tracker_name` | `string` | 캠페인 링크의 이름. | +| `network` | `string` | 캠페인과 관련된 네트워크. | +| `campaign` | `string` | 어트리뷰션과 관련된 캠페인의 이름. | +| `adgroup` | `string` | 어트리뷰션과 관련된 광고그룹. | +| `creative` | `string` | 어트리뷰션과 관련된 크리에이티브. | +| `click_label` | `string` | 어트리뷰션과 관련된 [클릭 레이블](https://help.adjust.com/en/article/user-rewards). | +| `state` | `string` | 어트리뷰션의 현재 상태. `installed` 또는 `reattributed` | -## Trigger a callback when attribution changes \{\#trigger\-a\-callback\-when\-attribution\-changes\} +어트리뷰션 변경 시 콜백 트리거 \{\#trigger\-a\-callback\-when\-attribution\-changes\} +-------------------------------------------------------------------------------- - + ```js attributionCallback: (string, Object) => mixed; ``` - + -The SDK can listen for attribution changes and call a function when it detects an update. You can set an attribution callback method by specifying an `attributionCallback` function in the `initSdk` method. Within your function, you have access to the user's attribution information. +SDK는 어트리뷰션 변경 사항을 받고 업데이트가 감지되면 함수를 호출합니다. `initSdk` 메서드의 `attributionCallback` 함수 특정으로 어트리뷰션 콜백 메서드를 설정할 수 있습니다. 함수 내에서 사용자의 어트리뷰션 정보에 액세스할 수 있습니다. ```js Adjust.initSdk({ @@ -68,12 +67,10 @@ Adjust.initSdk({ }); ``` -## Get current attribution information \{\#get\-current\-attribution\-information\} +현재 어트리뷰션 정보 확인 \{\#get\-current\-attribution\-information\} +----------------------------------------------------------------- -{" "} + 사용자가 앱을 설치하면 Adjust는 해당 설치를 캠페인에 어트리뷰션합니다. Adjust SDK를 사용하면 설치 캠페인 어트리뷰션 정보에 액세스할 수 있습니다. `waitForAttribution` 메서드는 SDK가 서버에서 어트리뷰션 데이터를 성공적으로 수신했을 때 `promise` 를 반환합니다. @@ -83,30 +80,29 @@ Adjust.waitForAttribution().then((attr) => ); ``` -## Set a referrer \{\#set\-a\-referrer\} +리퍼러 설정 \{\#set\-a\-referrer\} +---------------------------------- - + ```js function setReferrer(referrer: string): void; ``` - + -You can set a referrer to trigger an SDK click with a custom click ID when the SDK starts. The SDK sends your custom click ID to Adjust's servers for attribution purposes. +SDK가 시작될 때 커스텀 클릭 ID로 SDK 클릭을 트리거하는 리퍼러를 설정할 수 있습니다. SDK는 어트리뷰션 목적으로 커스텀 클릭 ID를 Adjust 서버로 전송합니다. + - +리퍼러가 어트리뷰션에 사용될 수 있도록 최대한 SDK 초기화에 가깝게 이 메서드를 호출하시기 바랍니다. + -Call this method as close to initializing the SDK as possible to ensure your referrer is used for attribution. - - - -To set your referrer, call the `setReferrer` method and pass your referrer as a URL\-encoded `string` argument. - - +리퍼러를 설정하려면 `setReferrer` 메서드를 호출하고 리퍼러를 URL 암호화된 `string` 인수로 전달합니다. + ```js Adjust.setReferrer("adjust_external_click_id%3DEXTERNAL_CLICK_ID"); ``` + From 8f1d6ace0766ac8ca61bd3e718da2a1e25964148 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 9 Jan 2025 12:53:58 +0000 Subject: [PATCH 15/42] File src/content/docs/en/sdk/web/features/attribution.mdx was translated to zh-CN locale --- .../docs/zh/sdk/web/features/attribution.mdx | 78 +++++++++---------- 1 file changed, 37 insertions(+), 41 deletions(-) diff --git a/src/content/docs/zh/sdk/web/features/attribution.mdx b/src/content/docs/zh/sdk/web/features/attribution.mdx index e4025e0051..26db7c7244 100644 --- a/src/content/docs/zh/sdk/web/features/attribution.mdx +++ b/src/content/docs/zh/sdk/web/features/attribution.mdx @@ -1,14 +1,12 @@ --- -title: Get attribution information -description: Listen for attribution changes using the Adjust SDK -slug: zh/sdk/web/features/attribution +title: "获取归因信息" +description: "使用 Adjust SDK 监听归因变化" +slug: "en/sdk/web/features/attribution" --- +用户与 Adjust 链接交互时，其归因信息会发生更新。用户与[深度链接](https://help.adjust.com/en/article/deep-links)交互时可能会发生这种情况。用户归因相关信息会在归因对象中展现。 -When a user interacts with an Adjust link, their attribution information updates. This can happen if the user interacts with a [deep link](https://help.adjust.com/zh/article/deep-links). Information about a user's attribution is represented in an Attribution object. - -The Attribution object contains the following information: - - +归因对象包含下列信息： + ```js export type AttributionMapT = $ReadOnly<{| @@ -24,31 +22,32 @@ export type AttributionMapT = $ReadOnly<{| |}>; ``` - + -| Values | Data type | Description | -| --------------- | --------- | --------------------------------------------------------------------------------------------------- | -| `adid` | `string` | The device's unique Adjust identifier. | -| `tracker_token` | `string` | The link token associated with the attribution. | -| `tracker_name` | `string` | The name of the campaign link. | -| `network` | `string` | The network associate with the campaign. | -| `campaign` | `string` | The name of the campaign associated with the attribution. | -| `adgroup` | `string` | The adgroup associated with the attribution. | -| `creative` | `string` | The creative associated with the attribution. | -| `click_label` | `string` | The [click label](https://help.adjust.com/zh/article/user-rewards) associated with the attribution. | -| `state` | `string` | The current state of the attribution. Either `installed` or `reattributed` | +| 值 | 数据类型 | 描述 | +|-----------------|----------|------------------------------------------------------------------------| +| `adid` | `string` | 设备的唯一 Adjust 标识符。 | +| `tracker_token` | `string` | 与归因关联的链接识别码。 | +| `tracker_name` | `string` | 推广活动链接名称 | +| `network` | `string` | 与推广活动关联的渠道。 | +| `campaign` | `string` | 与归因关联的推广活动名称。 | +| `adgroup` | `string` | 与归因关联的广告组。 | +| `creative` | `string` | 与归因关联的素材。 | +| `click_label` | `string` | 与归因关联的 [click label](https://help.adjust.com/en/article/user-rewards)。 | +| `state` | `string` | 当前归因状态。`installed` 或 `reattributed` | -## Trigger a callback when attribution changes \{\#trigger\-a\-callback\-when\-attribution\-changes\} +发生归因变化时触发回传\{\#trigger\-a\-callback\-when\-attribution\-changes\} +------------------------------------------------------------------------- - + ```js attributionCallback: (string, Object) => mixed; ``` - + -The SDK can listen for attribution changes and call a function when it detects an update. You can set an attribution callback method by specifying an `attributionCallback` function in the `initSdk` method. Within your function, you have access to the user's attribution information. +SDK 可监听归因变更并在发现更新时调用一个函数。您可以在 `initSdk` 方法中指定一个 `attributionCallback` 函数，来设置归因回传方法。在函数内，您可以访问用户归因信息。 ```js Adjust.initSdk({ @@ -68,12 +67,10 @@ Adjust.initSdk({ }); ``` -## Get current attribution information \{\#get\-current\-attribution\-information\} +获取当前归因信息\{\#get\-current\-attribution\-information\} +---------------------------------------------------------- -{" "} + 用户安装您的应用时，Adjust 会将该安装归因至一个推广活动。Adjust SDK 可提供赢得安装归因的推广活动细节。`waitForAttribution`方法会返回一个`promise`，当 SDK 成功从服务器接收到归因数据时，该 promise 会被完成。 @@ -83,30 +80,29 @@ Adjust.waitForAttribution().then((attr) => ); ``` -## Set a referrer \{\#set\-a\-referrer\} +设置 referrer \{\#set\-a\-referrer\} +--------------------------------------- - + ```js function setReferrer(referrer: string): void; ``` - + -You can set a referrer to trigger an SDK click with a custom click ID when the SDK starts. The SDK sends your custom click ID to Adjust's servers for attribution purposes. +您可以创建一个 referrer，来在 SDK 启动后触发带有自定义点击 ID 的 SDK 点击。SDK 会将您的自定义点击 ID 发送到 Adjust 服务器用于归因。 + - +在尽可能靠近 SDK 初始化的节点调用此方法，确保您的 referrer 被用于归因。 + -Call this method as close to initializing the SDK as possible to ensure your referrer is used for attribution. - - - -To set your referrer, call the `setReferrer` method and pass your referrer as a URL\-encoded `string` argument. - - +要设置 referrer，请调用 `setReferrer` 方法并以 URL 编码 `string` 参数的形式传递 referrer。 + ```js Adjust.setReferrer("adjust_external_click_id%3DEXTERNAL_CLICK_ID"); ``` + From 09c798d09a8ca35b96e331357e44ed922a918f11 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 9 Jan 2025 12:54:00 +0000 Subject: [PATCH 16/42] File src/content/docs/en/sdk/web/features/attribution.mdx was translated to ja-JP locale --- .../docs/ja/sdk/web/features/attribution.mdx | 78 +++++++++---------- 1 file changed, 37 insertions(+), 41 deletions(-) diff --git a/src/content/docs/ja/sdk/web/features/attribution.mdx b/src/content/docs/ja/sdk/web/features/attribution.mdx index 0706fcfbba..978dd09c60 100644 --- a/src/content/docs/ja/sdk/web/features/attribution.mdx +++ b/src/content/docs/ja/sdk/web/features/attribution.mdx @@ -1,14 +1,12 @@ --- -title: Get attribution information -description: Listen for attribution changes using the Adjust SDK -slug: ja/sdk/web/features/attribution +title: "アトリビューション情報の取得" +description: "Adjust SDKを使ってアトリビューションの変更を受信します。" +slug: "en/sdk/web/features/attribution" --- +ユーザーがAdjustリンクをクリックすると、そのアトリビューション情報が更新されます。これは、ユーザーが[ディープリンク](https://help.adjust.com/en/article/deep-links)をクリックした場合に発生します。ユーザーのアトリビューションについての情報は、アトリビューションオブジェクトに表示されます。 -When a user interacts with an Adjust link, their attribution information updates. This can happen if the user interacts with a [deep link](https://help.adjust.com/ja/article/deep-links). Information about a user's attribution is represented in an Attribution object. - -The Attribution object contains the following information: - - +アトリビューションオブジェクトは以下の情報を含んでいます。 + ```js export type AttributionMapT = $ReadOnly<{| @@ -24,31 +22,32 @@ export type AttributionMapT = $ReadOnly<{| |}>; ``` - + -| Values | Data type | Description | -| --------------- | --------- | --------------------------------------------------------------------------------------------------- | -| `adid` | `string` | The device's unique Adjust identifier. | -| `tracker_token` | `string` | The link token associated with the attribution. | -| `tracker_name` | `string` | The name of the campaign link. | -| `network` | `string` | The network associate with the campaign. | -| `campaign` | `string` | The name of the campaign associated with the attribution. | -| `adgroup` | `string` | The adgroup associated with the attribution. | -| `creative` | `string` | The creative associated with the attribution. | -| `click_label` | `string` | The [click label](https://help.adjust.com/ja/article/user-rewards) associated with the attribution. | -| `state` | `string` | The current state of the attribution. Either `installed` or `reattributed` | +| 値 | データタイプ | 説明 | +|-----------------|----------|-------------------------------------------------------------------------------| +| `adid` | `string` | デバイス固有のAdjust識別子 | +| `tracker_token` | `string` | アトリビューションに関連付けられているリンクトークン | +| `tracker_name` | `string` | キャンペーンリンクの名前 | +| `network` | `string` | キャンペーンに関連付けられているネットワーク | +| `campaign` | `string` | アトリビューションに関連付けられているキャンペーンの名前 | +| `adgroup` | `string` | アトリビューションに関連付けられているアドグループ | +| `creative` | `string` | アトリビューションに関連付けられているクリエイティブ | +| `click_label` | `string` | アトリビューションに関連付けられている[クリックラベル](https://help.adjust.com/en/article/user-rewards) | +| `state` | `string` | アトリビューションの現在のステータス。`installed`または `reattributed` | -## Trigger a callback when attribution changes \{\#trigger\-a\-callback\-when\-attribution\-changes\} +アトリビューションの変更時にコールバックをトリガーする \{\#trigger\-a\-callback\-when\-attribution\-changes\} +------------------------------------------------------------------------------------------ - + ```js attributionCallback: (string, Object) => mixed; ``` - + -The SDK can listen for attribution changes and call a function when it detects an update. You can set an attribution callback method by specifying an `attributionCallback` function in the `initSdk` method. Within your function, you have access to the user's attribution information. +SDKはアトリビューションの変更を受信し、更新を検出したときに関数を呼び出すことができます。アトリビューションコールバックメソッドを設定するには、`initSdk`メソッドで`attributionCallback`関数を指定します。関数内で、ユーザーのアトリビューション情報にアクセスすることができます。 ```js Adjust.initSdk({ @@ -68,12 +67,10 @@ Adjust.initSdk({ }); ``` -## Get current attribution information \{\#get\-current\-attribution\-information\} +現在のアトリビューション情報を取得する \{\#get\-current\-attribution\-information\} +---------------------------------------------------------------------- -{" "} + ユーザーがアプリをインストールすると、Adjustはそのインストールをキャンペーンにアトリビュートします。Adjust SDKを実装することで、インストールのキャンペーンアトリビューションの詳細にアクセスすることが可能です。`waitForAttribution`メソッドは、SDKがサーバーからアトリビューションデータを正常に受信すると解析される`promise`を返します。 @@ -83,30 +80,29 @@ Adjust.waitForAttribution().then((attr) => ); ``` -## Set a referrer \{\#set\-a\-referrer\} +リファラーを設定する \{\#set\-a\-referrer\} +-------------------------------------- - + ```js function setReferrer(referrer: string): void; ``` - + -You can set a referrer to trigger an SDK click with a custom click ID when the SDK starts. The SDK sends your custom click ID to Adjust's servers for attribution purposes. +SDKの開始時にカスタムクリックIDでSDKクリックのトリガーとなるリファラーを設定することができます。SDKは、アトリビューションの目的でカスタムクリックIDをAdjustのサーバーに送信します。 + - +アトリビューションにリファラーが使用されるように、SDKの初期化時にできる限り近い時点でこのメソッドを呼び出してください。 + -Call this method as close to initializing the SDK as possible to ensure your referrer is used for attribution. - - - -To set your referrer, call the `setReferrer` method and pass your referrer as a URL\-encoded `string` argument. - - +リファラーを設定するには、`setReferrer`メソッドを呼び出し、URLエンコードされた`string`引数としてリファラーをパスします。 + ```js Adjust.setReferrer("adjust_external_click_id%3DEXTERNAL_CLICK_ID"); ``` + From be82f02fafb21eb62017869934603c5f15c7ab95 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 9 Jan 2025 12:54:01 +0000 Subject: [PATCH 17/42] File src/content/docs/en/sdk/web/features/device-info.mdx was translated to ko-KR locale --- .../docs/ko/sdk/web/features/device-info.mdx | 20 +++++++++---------- 1 file changed, 9 insertions(+), 11 deletions(-) diff --git a/src/content/docs/ko/sdk/web/features/device-info.mdx b/src/content/docs/ko/sdk/web/features/device-info.mdx index 112b123c00..5b5ff1e94d 100644 --- a/src/content/docs/ko/sdk/web/features/device-info.mdx +++ b/src/content/docs/ko/sdk/web/features/device-info.mdx @@ -1,24 +1,22 @@ --- -title: Get device information -description: Use these methods to add details to your callbacks and improve your reporting. -slug: ko/sdk/web/features/device-info +title: "디바이스 정보 확인" +description: "해당 메서드를 사용하여 콜백에 세부 정보를 추가하고 리포트를 보완하시기 바랍니다." +slug: "en/sdk/web/features/device-info" --- +Adjust SDK는 디바이스 정보를 반환하는 헬프 메서드가 포함되어 있습니다. 해당 메서드를 사용하여 콜백에 세부 정보를 추가하고 리포트를 보완하시기 바랍니다. -The Adjust SDK contains helper methods that return device information. Use these methods to add details to your callbacks and improve your reporting. +Web UUID \{\#web\-uuid\} +---------------------------- -## Web UUID \{\#web\-uuid\} - -{" "} + 웹 SDK는 Adjust에서 웹 사용자를 식별하기 위해 첫 세션 전송 시 고유한 `web_uuid` 식별자를 생성합니다. 이 ID는 UUID\(Universally Unique Identifier\) 형식을 따릅니다. `waitForWebUUID` 메서드는 `web_uuid` 가 생성되거나 브라우저 저장소\(`IndexedDB` 또는 사용 가능한 경우 `LocalStorage`\)에서 가져온 경우에 `promise` 를 반환합니다. -Call the `waitForWebUUID` method to return this information as a `string`. +`waitForWebUUID` 메서드를 호출하면 이 정보가 `string`로 반한됩니다. ```js Adjust.waitForWebUUID().then((webUuid) => console.log(webUuid)); ``` + From 48524ffbf2e4670f2b9fffda9c8e8ad7ff48b405 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 9 Jan 2025 12:54:03 +0000 Subject: [PATCH 18/42] File src/content/docs/en/sdk/web/features/device-info.mdx was translated to zh-CN locale --- .../docs/zh/sdk/web/features/device-info.mdx | 20 +++++++++---------- 1 file changed, 9 insertions(+), 11 deletions(-) diff --git a/src/content/docs/zh/sdk/web/features/device-info.mdx b/src/content/docs/zh/sdk/web/features/device-info.mdx index e1ca9709ac..96ceefac89 100644 --- a/src/content/docs/zh/sdk/web/features/device-info.mdx +++ b/src/content/docs/zh/sdk/web/features/device-info.mdx @@ -1,24 +1,22 @@ --- -title: Get device information -description: Use these methods to add details to your callbacks and improve your reporting. -slug: zh/sdk/web/features/device-info +title: "获取设备信息" +description: "用这些方法来向回传添加细节信息，优化报告。" +slug: "en/sdk/web/features/device-info" --- +Adjust SDK 包含能够返回设备信息的辅助方法。用这些方法来向回传添加细节信息，优化报告。 -The Adjust SDK contains helper methods that return device information. Use these methods to add details to your callbacks and improve your reporting. +Web UUID \{\#web\-uuid\} +---------------------------- -## Web UUID \{\#web\-uuid\} - -{" "} + 为在 Adjust 中识别网页用户，Adjust Web SDK 会在发送第一次会话时生成唯一的 `web_uuid` 标识符。该标识符采用通用唯一标识符 \(UUID\) 格式。 `waitForWebUUID`方法会返回一个`promise` 。该 promise 会在生成或从浏览器存储\(`IndexedDB`或`LocalStorage`）中调取到`web_uuid`时完成。 -Call the `waitForWebUUID` method to return this information as a `string`. +调用 `waitForWebUUID` 方法来通过 `string` 的形式返回此信息。 ```js Adjust.waitForWebUUID().then((webUuid) => console.log(webUuid)); ``` + From 3b7d62b3e7967771a814c648e4a409f21519134c Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 9 Jan 2025 12:54:05 +0000 Subject: [PATCH 19/42] File src/content/docs/en/sdk/web/features/device-info.mdx was translated to ja-JP locale --- .../docs/ja/sdk/web/features/device-info.mdx | 20 +++++++++---------- 1 file changed, 9 insertions(+), 11 deletions(-) diff --git a/src/content/docs/ja/sdk/web/features/device-info.mdx b/src/content/docs/ja/sdk/web/features/device-info.mdx index 32e51d4438..4c5badf3c1 100644 --- a/src/content/docs/ja/sdk/web/features/device-info.mdx +++ b/src/content/docs/ja/sdk/web/features/device-info.mdx @@ -1,24 +1,22 @@ --- -title: Get device information -description: Use these methods to add details to your callbacks and improve your reporting. -slug: ja/sdk/web/features/device-info +title: "デバイス情報を取得" +description: "これらのメソッドを使用することでコールバックに詳細を追加し、レポートを改善させましょう。" +slug: "en/sdk/web/features/device-info" --- +Adjust SDKには、デバイス情報を返すヘルパーメソッドが含まれています。これらのメソッドを使用することでコールバックに詳細を追加し、レポートを改善させましょう。 -The Adjust SDK contains helper methods that return device information. Use these methods to add details to your callbacks and improve your reporting. +Web UUID \{\#web\-uuid\} +---------------------------- -## Web UUID \{\#web\-uuid\} - -{" "} + AdjustがWebユーザーを識別するために、Web SDKはセッションを送信する際に一意の`web_uuid`を生成します。IDはUniversally Unique Identifier（UUID）のフォーマットです。 `waitForWebUUID`メソッドは、`web_uuid`が生成されるかブラウザのストレージから取得されると解決される`promise`を返します（可用性に応じて`IndexedDB`または`LocalStorage`）。 -Call the `waitForWebUUID` method to return this information as a `string`. +`waitForWebUUID`メソッドを呼び出して、この情報を`string`として返します。 ```js Adjust.waitForWebUUID().then((webUuid) => console.log(webUuid)); ``` + From ef9cda5b5bf50f4d8009459ecec3a17cc49295aa Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 9 Jan 2025 12:54:08 +0000 Subject: [PATCH 20/42] File src/content/docs/en/sdk/web/features/privacy.mdx was translated to ko-KR locale --- .../docs/ko/sdk/web/features/privacy.mdx | 115 ++++++++---------- 1 file changed, 50 insertions(+), 65 deletions(-) diff --git a/src/content/docs/ko/sdk/web/features/privacy.mdx b/src/content/docs/ko/sdk/web/features/privacy.mdx index 6eff055dd8..2ee8c7acee 100644 --- a/src/content/docs/ko/sdk/web/features/privacy.mdx +++ b/src/content/docs/ko/sdk/web/features/privacy.mdx @@ -1,44 +1,42 @@ --- -title: Set up privacy features -description: Configure features that you can use to handle user privacy in your app. -slug: ko/sdk/web/features/privacy +title: "프라이버시 기능 설정" +description: "앱에서 사용자 프라이버시를 관리할 수 있는 기능을 구성합니다." +slug: "en/sdk/web/features/privacy" --- +Adjust SDK에는 앱에서 사용자 프라이버시를 관리할 수 있는 기능이 포함되어 있습니다. -The Adjust SDK contains features that you can use to handle user privacy in your app. +삭제 요청 전송 \{\#send\-erasure\-request\} +------------------------------------------ -## Send erasure request \{\#send\-erasure\-request\} - - + ```js function gdprForgetMe(): void; ``` - + -The EU’s General Data Protection Regulation \(GDPR\) and similar privacy laws worldwide \(CCPA, LGPD, etc.\) grant data subjects comprehensive rights when it comes to the processing of their personal data. These rights include, among others, the right to erasure \(see [Art. 17 GDPR](https://gdpr.eu/article-17-right-to-be-forgotten/)\)\([1](https://help.adjust.com/ko/article/gdpr#ref-1)\). As a data processor, Adjust is obliged to support you \(the data controller\) in the processing of such requests from your \(app\) users. +EU의 개인정보 보호 규정\(GDPR\) 및 기타 개인정보 보호법\(CCPA, LGPD 등\)은 데이터 주체에게 개인 데이터 처리와 관련하여 포괄적인 권리를 부여합니다. 이러한 권리에는 삭제 권리\([GDPR 17조](https://gdpr.eu/article-17-right-to-be-forgotten/)\)\([1](https://help.adjust.com/en/article/gdpr#ref-1)\)가 포함됩니다. 데이터 처리자로서 Adjust는 귀하의 \(앱\) 사용자의 이러한 요청을 처리하는 데 있어 귀하\(데이터 컨트롤러\)를 지원할 의무가 있습니다. -You can send the user's erasure request to Adjust by calling the `gdprForgetMe` method. Once Adjust has been notified: +`gdprForgetMe` 메서드를 호출하여 사용자의 삭제 요청을 Adjust로 전송할 수 있습니다. 삭제 요청 수신 시 Adjust는 다음의 조치를 취합니다: -- Adjust will permanently delete all of the user’s historical personal data from its internal systems and database. -- Adjust will no longer receive data from this user/device via the Adjust SDK.\([2](https://help.adjust.com/ko/article/gdpr#ref-2)\) +* Adjust 내부 시스템과 데이터베이스에서 해당 사용자의 모든 개인 정보 기록을 영구적으로 삭제합니다. +* Adjust는 더 이상 Adjust SDK를 통해 해당 사용자/기기로부터 데이터를 수신하지 않습니다.\([2](https://help.adjust.com/en/article/gdpr#ref-2)\) ```js Adjust.gdprForgetMe(); ``` -## 특정 사용자에 대한 서드파티 공유 \{\#third\-party\-sharing\-for\-specific\-users\} +특정 사용자에 대한 서드파티 공유 \{\#third\-party\-sharing\-for\-specific\-users\} +---------------------------------------------------------------------------- -{" "} + Adjust SDK를 사용하여 사용자의 서드파티 공유 설정 변경 내용을 기록할 수 있습니다. 이러한 설정은 `ThirdPartySharing` 클래스를 사용하여 구성됩니다. -### AdjustThirdPartySharing 객체 인스턴스화 {#instantiate-an-adjustthirdpartysharing-object} +### AdjustThirdPartySharing 객체 인스턴스화 \{\#instantiate\-an\-adjustthirdpartysharing\-object\} - + ```ts class ThirdPartySharing { @@ -47,13 +45,13 @@ class ThirdPartySharing { } ``` - + Adjust SDK와의 서드파트 공유를 활성화 또는 비활성화하려면 `ThirdPartySharing` 객체를 인스턴스화합니다. 이 객체에 Adjust의 서드파티 공유 처리 방식을 제어하는 변수가 포함됩니다. 이를 인스턴스화하려면 새로운 `ThirdPartySharing` 인스턴스를 생성하고 다음 파라미터를 전달합니다. -- `isEnabled` \(`boolean`\):`true` 전달로 서드파티 공유를 활성화하거나 `false` 전달로 서드파티 공유를 비활성화합니다. +* `isEnabled` \(`boolean`\):`true` 전달로 서드파티 공유를 활성화하거나 `false` 전달로 서드파티 공유를 비활성화합니다. ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -68,12 +66,9 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 서드파티 공유 비활성화\(지원 중단\) {#disable-third-party-sharing} +### 서드파티 공유 비활성화\(지원 중단\) \{\#disable\-third\-party\-sharing\} -{" "} + 이전 버전의 SDK에서 서드파티 공유를 비활성화하려면 `disableThirdPartySharing` 메서드를 호출합니다. 이 메서드는 지원 중단되었습니다. 계속 사용할 경우 기본 메서드를 직접 호출하게 됩니다. @@ -82,9 +77,9 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(false); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 세분화된 정보 전송 {#send-granular-information} +### 세분화된 정보 전송 \{\#send\-granular\-information\} - + ```ts public addGranularOption(partnerName: string, @@ -92,15 +87,15 @@ public addGranularOption(partnerName: string, value: string) ``` - + 서드파티 공유 설정 변경 시 세부 정보를 추가할 수 있습니다. 이를 통해 사용자의 결정에 대한 더욱 자세한 정보를 전달할 수 있습니다. 다음 파라미터와 함께 `addGranularOption` 메서드를 호출합니다. -- `partnerName` \(`string`\): 세분화 옵션을 적용할 파트너의 이름 -- `key` \(`string`\): 옵션 키 -- `value` \(`string`\): 옵션 값 +* `partnerName` \(`string`\): 세분화 옵션을 적용할 파트너의 이름 +* `key` \(`string`\): 옵션 키 +* `value` \(`string`\): 옵션 값 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -108,37 +103,34 @@ options.addGranularOption("PartnerA", "foo", "bar"); Adjust.trackThirdPartySharing(options); ``` -## URL strategy \{\#url\-strategy\} +URL 전략 \{\#url\-strategy\} +------------------------------ -{" "} + URL 전략 기능을 사용하여 다음을 설정할 수 있습니다. -- Adjust가 귀하의 데이터를 저장하는 국가\(데이터 레지던시\). -- Adjust SDK가 트래픽을 전송하는 엔드포인트\(맞춤 URL\). +* Adjust가 귀하의 데이터를 저장하는 국가\(데이터 레지던시\). +* Adjust SDK가 트래픽을 전송하는 엔드포인트\(맞춤 URL\). 본 기능은 프라이버시 요건이 엄격한 나라에서 앱을 운영하는 경우에 유용합니다. URL 전략을 설정하면 Adjust가 선택된 데이터 레지던시 지역에 데이터를 저장하거나 선택된 도메인으로 트래픽을 전송합니다. URL 전략을 구성하려면 `Adjust.initSdk` 인스턴스에 `urlStrategy` 의 다음 속성을 설정합니다. -- `domains` \(`Array`\): SDK 트래픽을 전송할 데이터 레지던스 국가 또는 엔드포인트. 기본 설정에 따라 Adjust SDK는 모든 데이터를 Adjust의 엔드포인트로 전송합니다. 커스텀 엔드포인트를 설정하려면 `urlStrategy`의 `domains` 속성에 엔드포인트를 전달합니다. -- `useSubdomains` \(`boolean`\): 도메인을 Adjust 도메인으로 취급할지 여부. - - - `true`인 경우 SDK는 도메인의 접두사로 Adjust에 특화된 하위 도메인을 사용합니다. - - `false`인 경우 SDK는 접두사 없이 제공된 도메인을 그대로 사용합니다. +* `domains` \(`Array`\): SDK 트래픽을 전송할 데이터 레지던스 국가 또는 엔드포인트. 기본 설정에 따라 Adjust SDK는 모든 데이터를 Adjust의 엔드포인트로 전송합니다. 커스텀 엔드포인트를 설정하려면 `urlStrategy`의 `domains` 속성에 엔드포인트를 전달합니다. +* `useSubdomains` \(`boolean`\): 도메인을 Adjust 도메인으로 취급할지 여부. + * `true`인 경우 SDK는 도메인의 접두사로 Adjust에 특화된 하위 도메인을 사용합니다. + * `false`인 경우 SDK는 접두사 없이 제공된 도메인을 그대로 사용합니다. -- `isDataResidency` \(`boolean`\): 선택 사항으로, 도메인을 데이터 레지던시에 사용해야 하는지 여부입니다. +* `isDataResidency` \(`boolean`\): 선택 사항으로, 도메인을 데이터 레지던시에 사용해야 하는지 여부입니다. 다음 표는 구성 목록을 보여줍니다. -| URL 전략 | 기본 도메인 및 커스텀 도메인 | 하위 도메인 사용 | 데이터 레지던시 | -| ------------------ | ----------------------------- | ---------------- | --------------- | -| EU 데이터 레지던시 | `"eu.adjust.com"` | `true` | `true` | -| 중국 URL 전략 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | -| 맞춤 URL 전략 | `"my.custom.domain"` | `false` | `false` | +| URL 전략 | 기본 도메인 및 커스텀 도메인 | 하위 도메인 사용 | 데이터 레지던시 | +|-------------|-------------------------------|-----------|----------| +| EU 데이터 레지던시 | `"eu.adjust.com"` | `true` | `true` | +| 중국 URL 전략 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | +| 맞춤 URL 전략 | `"my.custom.domain"` | `false` | `false` | ```js Adjust.initSdk({ @@ -153,16 +145,12 @@ Adjust.initSdk({ }); ``` -### 커스텀 엔드포인트 설정\(지원 중단\) {#set-custom-endpoint} +### 커스텀 엔드포인트 설정\(지원 중단\) \{\#set\-custom\-endpoint\} -{" "} + 이전 버전의 SDK는 지원 중단된 `customUrl` 속성을 사용하여 엔드포인트를 전달했습니다. 대신 `urlStrategy` 구성을 사용하시기 바랍니다. - - + ```js Adjust.initSdk({ @@ -178,18 +166,14 @@ Adjust.initSdk({ }); ``` - + -### 데이터 레지던시\(지원 중단\) {#data-residency} +### 데이터 레지던시\(지원 중단\) \{\#data\-residency\} -{" "} + 이전 버전의 SDK는 지원 중단된 `dataResidency` 속성을 사용했습니다. 대신 `urlStrategy` 구성을 사용하시기 바랍니다. - - + ```js Adjust.initSdk({ @@ -206,3 +190,4 @@ Adjust.initSdk({ ``` + From 9bcd4fe5d8f23f1f254db8958db11b7ea4a13b3d Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 9 Jan 2025 12:54:10 +0000 Subject: [PATCH 21/42] File src/content/docs/en/sdk/web/features/privacy.mdx was translated to zh-CN locale --- .../docs/zh/sdk/web/features/privacy.mdx | 115 ++++++++---------- 1 file changed, 50 insertions(+), 65 deletions(-) diff --git a/src/content/docs/zh/sdk/web/features/privacy.mdx b/src/content/docs/zh/sdk/web/features/privacy.mdx index 67ff3bd8a3..8979273d83 100644 --- a/src/content/docs/zh/sdk/web/features/privacy.mdx +++ b/src/content/docs/zh/sdk/web/features/privacy.mdx @@ -1,44 +1,42 @@ --- -title: Set up privacy features -description: Configure features that you can use to handle user privacy in your app. -slug: zh/sdk/web/features/privacy +title: "设置隐私功能" +description: "配置处理应用用户隐私的功能。" +slug: "en/sdk/web/features/privacy" --- +Adjust SDK 包含处理应用用户隐私的功能。 -The Adjust SDK contains features that you can use to handle user privacy in your app. +发送删除请求\{\#send\-erasure\-request\} +--------------------------------------- -## Send erasure request \{\#send\-erasure\-request\} - - + ```js function gdprForgetMe(): void; ``` - + -The EU’s General Data Protection Regulation \(GDPR\) and similar privacy laws worldwide \(CCPA, LGPD, etc.\) grant data subjects comprehensive rights when it comes to the processing of their personal data. These rights include, among others, the right to erasure \(see [Art. 17 GDPR](https://gdpr.eu/article-17-right-to-be-forgotten/)\)\([1](https://help.adjust.com/zh/article/gdpr#ref-1)\). As a data processor, Adjust is obliged to support you \(the data controller\) in the processing of such requests from your \(app\) users. +在处理个人数据方面，欧盟的《通用数据保护条例》\(GDPR\) 和全球类似的隐私法律 \(CCPA、LGPD 等\) 授予数据主体完全权利，其中包括删除权 \([参见 GDPR 第 17](https://gdpr.eu/article-17-right-to-be-forgotten/)条\)\( [1](https://help.adjust.com/en/article/gdpr#ref-1) \)。作为数据处理方，Adjust 有义务支持您 \(数据控制方\) 处理来自应用用户的此类请求。 -You can send the user's erasure request to Adjust by calling the `gdprForgetMe` method. Once Adjust has been notified: +您可以通过调用 `gdprForgetMe` 方法来将用户的删除请求发送至 Adjust 服务器。收到通知后： -- Adjust will permanently delete all of the user’s historical personal data from its internal systems and database. -- Adjust will no longer receive data from this user/device via the Adjust SDK.\([2](https://help.adjust.com/zh/article/gdpr#ref-2)\) +* 我们将从内部系统和数据库中永久删除用户的所有历史个人数据； +* 此外，Adjust 将不再通过 Adjust SDK 接收来自该用户/设备的数据。 \( [2](https://help.adjust.com/en/article/gdpr#ref-2) \) ```js Adjust.gdprForgetMe(); ``` -## 针对特定用户的第三方分享\{\#third\-party\-sharing\-for\-specific\-users\} +针对特定用户的第三方分享\{\#third\-party\-sharing\-for\-specific\-users\} +--------------------------------------------------------------------- -{" "} + 您可以使用 Adjust SDK 来记录用户对第三方数据分享设置的变更。请使用 `ThirdPartySharing` 类配置第三方数据分享。 -### 实例化 AdjustThirdPartySharing 对象{#instantiate-an-adjustthirdpartysharing-object} +### 实例化 AdjustThirdPartySharing 对象\{\#instantiate\-an\-adjustthirdpartysharing\-object\} - + ```ts class ThirdPartySharing { @@ -47,13 +45,13 @@ class ThirdPartySharing { } ``` - + 要启用或禁用 Adjust SDK 第三方数据分享，请实例化 `ThirdPartySharing` 对象。该对象包含控制 Adjust 如何处理第三方分享的变量。 要进行实例化，请创建新的 `ThirdPartySharing` 实例，并传递下列参数： -- `isEnabled` \( `boolean` \): 传递`true`来启用第三方分享或传递`false`来禁用第三方分享。 +* `isEnabled` \( `boolean` \): 传递`true`来启用第三方分享或传递`false`来禁用第三方分享。 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -68,12 +66,9 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 禁用第三方分享 \(已弃用\) {#disable-third-party-sharing} +### 禁用第三方分享 \(已弃用\) \{\#disable\-third\-party\-sharing\} -{" "} + 如需在之前版本的 SDK 中禁用第三方数据分享，请调用`disableThirdPartySharing`方法。此方法已被弃用。如果您仍在使用，请注意它会直接调用基础方法。 @@ -82,9 +77,9 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(false); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 发送精细信息{#send-granular-information} +### 发送精细信息\{\#send\-granular\-information\} - + ```ts public addGranularOption(partnerName: string, @@ -92,15 +87,15 @@ public addGranularOption(partnerName: string, value: string) ``` - + 当用户更新第三方数据分享设置时，您可以附加较精细的信息，以此发送用户决定的更多细节。 使用下列参数调用`addGranularOption`方法： -- `partnerName` \(`string`\)：使用精细设置的合作伙伴的名称。 -- `key` \(`string`\)：选项 key。 -- `value` \(`string`\)：选项值。 +* `partnerName` \(`string`\)：使用精细设置的合作伙伴的名称。 +* `key` \(`string`\)：选项 key。 +* `value` \(`string`\)：选项值。 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -108,37 +103,34 @@ options.addGranularOption("PartnerA", "foo", "bar"); Adjust.trackThirdPartySharing(options); ``` -## URL strategy \{\#url\-strategy\} +URL 策略\{\#url\-strategy\} +----------------------------- -{" "} + 通过 URL 策略功能，您可以进行下列设置： -- Adjust 储存您数据的国家/地区 \(即数据驻留\)。 -- 接收 Adjust SDK 所发送流量的终端 \(自定义 URL \)。 +* Adjust 储存您数据的国家/地区 \(即数据驻留\)。 +* 接收 Adjust SDK 所发送流量的终端 \(自定义 URL \)。 当应用运营的国家拥有严格的隐私规定时，此功能会非常有用。在您设置 URL 策略时，Adjust 会将数据储存在指定数据驻留地区，或将流量发送至选定域名。 要配置 URL 策略，请在`Adjust.initSdk`实例中设置`urlStrategy`的以下属性： -- `domains` \(`Array`\)：接收您所发送 SDK 流量的数据驻留国家/地区或终端。默认情况下，Adjust SDK 会将所有数据都发送至 Adjust 终端。如果您想设置自定义终端，请在`urlStrategy`的`domains`属性中传递。 -- `useSubdomains` \(`boolean`\): 域名是否应被视为 Adjust 域名。 - - - 如果为`true`，则 SDK 会在域名中添加 Adjust 特定子域作为前缀。 - - 如果为`false`，SDK 会按原样使用所提供的域名，不包含前缀。 +* `domains` \(`Array`\)：接收您所发送 SDK 流量的数据驻留国家/地区或终端。默认情况下，Adjust SDK 会将所有数据都发送至 Adjust 终端。如果您想设置自定义终端，请在`urlStrategy`的`domains`属性中传递。 +* `useSubdomains` \(`boolean`\): 域名是否应被视为 Adjust 域名。 + * 如果为`true`，则 SDK 会在域名中添加 Adjust 特定子域作为前缀。 + * 如果为`false`，SDK 会按原样使用所提供的域名，不包含前缀。 -- `isDataResidency` \( `boolean` \)：可选。域名是否应被用于数据驻留。 +* `isDataResidency` \( `boolean` \)：可选。域名是否应被用于数据驻留。 下表展示了一系列配置。 -| URL 策略 | 默认和自定义域名 | 使用子域名 | 数据驻留 | -| --------------- | ----------------------------- | ---------- | -------- | -| 欧盟数据驻留 | `"eu.adjust.com"` | `true` | `true` | -| 中国 URL 策略 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | -| 自定义 URL 策略 | `"my.custom.domain"` | `false` | `false` | +| URL 策略 | 默认和自定义域名 | 使用子域名 | 数据驻留 | +|------------|-------------------------------|---------|---------| +| 欧盟数据驻留 | `"eu.adjust.com"` | `true` | `true` | +| 中国 URL 策略 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | +| 自定义 URL 策略 | `"my.custom.domain"` | `false` | `false` | ```js Adjust.initSdk({ @@ -153,16 +145,12 @@ Adjust.initSdk({ }); ``` -### 设置自定义终端 \(已弃用\) {#set-custom-endpoint} +### 设置自定义终端 \(已弃用\) \{\#set\-custom\-endpoint\} -{" "} + 之前版本的 SDK 使用`customUrl`属性传递终端，该属性已被弃用。请改用`urlStrategy`配置。 - - + ```js Adjust.initSdk({ @@ -178,18 +166,14 @@ Adjust.initSdk({ }); ``` - + -### 数据驻留 \(已弃用\) {#data-residency} +### 数据驻留 \(已弃用\) \{\#data\-residency\} -{" "} + 之前版本的 SDK 使用的是`dataResidency`属性，该属性已被弃用。请改用`urlStrategy`配置。 - - + ```js Adjust.initSdk({ @@ -206,3 +190,4 @@ Adjust.initSdk({ ``` + From 483e30f539d6dec5954ef12d8ff2d819b7b8a338 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 9 Jan 2025 12:54:12 +0000 Subject: [PATCH 22/42] File src/content/docs/en/sdk/web/features/privacy.mdx was translated to ja-JP locale --- .../docs/ja/sdk/web/features/privacy.mdx | 115 ++++++++---------- 1 file changed, 50 insertions(+), 65 deletions(-) diff --git a/src/content/docs/ja/sdk/web/features/privacy.mdx b/src/content/docs/ja/sdk/web/features/privacy.mdx index ea8012d188..2b44505c76 100644 --- a/src/content/docs/ja/sdk/web/features/privacy.mdx +++ b/src/content/docs/ja/sdk/web/features/privacy.mdx @@ -1,44 +1,42 @@ --- -title: Set up privacy features -description: Configure features that you can use to handle user privacy in your app. -slug: ja/sdk/web/features/privacy +title: "プライバシー機能の設定" +description: "アプリ内でユーザーのプライバシーを処理するために使用できる機能を設定します。" +slug: "en/sdk/web/features/privacy" --- +Adjust SDKには、アプリ内でのユーザープライバシーの処理に使用できる機能が含まれています。 -The Adjust SDK contains features that you can use to handle user privacy in your app. +消去リクエストを送信する \{\#send\-erasure\-request\} +---------------------------------------------- -## Send erasure request \{\#send\-erasure\-request\} - - + ```js function gdprForgetMe(): void; ``` - + -The EU’s General Data Protection Regulation \(GDPR\) and similar privacy laws worldwide \(CCPA, LGPD, etc.\) grant data subjects comprehensive rights when it comes to the processing of their personal data. These rights include, among others, the right to erasure \(see [Art. 17 GDPR](https://gdpr.eu/article-17-right-to-be-forgotten/)\)\([1](https://help.adjust.com/ja/article/gdpr#ref-1)\). As a data processor, Adjust is obliged to support you \(the data controller\) in the processing of such requests from your \(app\) users. +EUの一般データ保護規則（GDPR）および類似する世界的なプライバシー法（CCPA、LGPDなど）は、個人データの処理に関する包括的な権利をデータ主体に付与しています。これらの権利には、消去権（[GDPR第17条](https://gdpr.eu/article-17-right-to-be-forgotten/)を参照）（[1](https://help.adjust.com/en/article/gdpr#ref-1)）が含まれます。データ処理者として、Adjustは、（アプリ）ユーザー（データ管理者）からのそのようなリクエストの処理をサポートする義務があります。 -You can send the user's erasure request to Adjust by calling the `gdprForgetMe` method. Once Adjust has been notified: +`gdprForgetMe`メソッドを呼び出すことで、ユーザーの消去リクエストをAdjustに送信することができます。Adjustが通知を受けると、以下の対応をします。 -- Adjust will permanently delete all of the user’s historical personal data from its internal systems and database. -- Adjust will no longer receive data from this user/device via the Adjust SDK.\([2](https://help.adjust.com/ja/article/gdpr#ref-2)\) +* Adjustはその内部システムおよびデータベースから、履歴として保管されているユーザーの全ての個人データを完全に削除します。 +* Adjustは、Adjust SDKを介して、このユーザー/デバイスからデータを受信しなくなります。（[2](https://help.adjust.com/en/article/gdpr#ref-2)） ```js Adjust.gdprForgetMe(); ``` -## 特定のユーザーの情報をサードパーティと共有する \{\#third\-party\-sharing\-for\-specific\-users\} +特定のユーザーの情報をサードパーティと共有する \{\#third\-party\-sharing\-for\-specific\-users\} +--------------------------------------------------------------------------------- -{" "} + Adjust SDKを使用して、ユーザーがサードパーティとの共有設定を変更した時にそれを記録することができます。これらの設定は、`ThirdPartySharing`クラスを使用して行われます。 -### AdjustThirdPartySharingオブジェクトをインスタンス化する {#instantiate-an-adjustthirdpartysharing-object} +### AdjustThirdPartySharingオブジェクトをインスタンス化する \{\#instantiate\-an\-adjustthirdpartysharing\-object\} - + ```ts class ThirdPartySharing { @@ -47,13 +45,13 @@ class ThirdPartySharing { } ``` - + Adjust SDKでサードパーティ共有を有効化または無効化するには、`ThirdPartySharing`オブジェクトをインスタンス化する必要があります。このオブジェクトには、Adjustがサードパーティとの共有をどのように扱うかを制御する変数が含まれます。 これをインスタンス化するには、新しい`ThirdPartySharing`インスタンスを作成して、以下のパラメーターをパスしてください： -- `isEnabled` \( `boolean` \) ：`true`をパスしてサードパーティ共有を有効化するか、 `false`をパスして無効化します。 +* `isEnabled` \( `boolean` \) ：`true`をパスしてサードパーティ共有を有効化するか、 `false`をパスして無効化します。 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -68,12 +66,9 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### サードパーティ共有を無効にする（廃止）{#disable-third-party-sharing} +### サードパーティ共有を無効にする（廃止）\{\#disable\-third\-party\-sharing\} -{" "} + 以前のバージョンのSDKでサードパーティとの共有を無効にするには、 `disableThirdPartySharing`メソッドを呼び出します。このメソッドは廃止されました。それでも使用する場合は、基礎となるメソッドを直接呼び出していることに注意してください。 @@ -82,9 +77,9 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(false); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 粒度の高い情報を送信する {#send-granular-information} +### 粒度の高い情報を送信する \{\#send\-granular\-information\} - + ```ts public addGranularOption(partnerName: string, @@ -92,15 +87,15 @@ public addGranularOption(partnerName: string, value: string) ``` - + ユーザーがサードパーティの共有設定を更新すると、詳細な情報を付与できます。この情報を使用して、ユーザー行動についてより詳しく伝えることができます。 これを行うには、以下のパラメーターを使用して`addGranularOption`メソッドを呼び出します： -- `partnerName` （`string`）：granular optionが適用されるパートナーの名前 -- `key` （`string`）：オプションのキー -- `value` （`string`）：オプションの値 +* `partnerName` （`string`）：granular optionが適用されるパートナーの名前 +* `key` （`string`）：オプションのキー +* `value` （`string`）：オプションの値 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -108,37 +103,34 @@ options.addGranularOption("PartnerA", "foo", "bar"); Adjust.trackThirdPartySharing(options); ``` -## URL strategy \{\#url\-strategy\} +URL戦略 \{\#url\-strategy\} +----------------------------- -{" "} + URL戦略機能では、以下のいずれかを設定することができます： -- Adjustがお客様のデータを保管する国（データレジデンシー）。 -- Adjust SDKがトラフィックを送信するエンドポイント（カスタムURL）。 +* Adjustがお客様のデータを保管する国（データレジデンシー）。 +* Adjust SDKがトラフィックを送信するエンドポイント（カスタムURL）。 これは、プライバシー要件が厳しい国で事業を展開している場合に便利です。URL戦略を設定すると、Adjustは選択したデータレジデンシー地域にデータを保管したり、選択したドメインにトラフィックを送信したりします。 URL戦略を設定するには、 `Adjust.initSdk`インスタンスの`urlStrategy`の以下のプロパティを設定します。 -- `domains` （`Array`）：SDKトラフィックを送信する国、データの所在国、またはエンドポイント。デフォルトでは、Adjust SDKは全てのデータをAdjustのエンドポイントに送信します。カスタムエンドポイントを設定する場合は、 `urlStrategy`の`domains`プロパティでパスします。 -- `useSubdomains` （`boolean`）：ドメインをAdjustドメインとして扱うかどうか。 - - - `true`の場合、SDKはドメインの前にAdjust固有のサブドメインを付けます。 - - `false`の場合、SDKは指定されたドメインをプレフィックスなしでそのまま使用します。 +* `domains` （`Array`）：SDKトラフィックを送信する国、データの所在国、またはエンドポイント。デフォルトでは、Adjust SDKは全てのデータをAdjustのエンドポイントに送信します。カスタムエンドポイントを設定する場合は、 `urlStrategy`の`domains`プロパティでパスします。 +* `useSubdomains` （`boolean`）：ドメインをAdjustドメインとして扱うかどうか。 + * `true`の場合、SDKはドメインの前にAdjust固有のサブドメインを付けます。 + * `false`の場合、SDKは指定されたドメインをプレフィックスなしでそのまま使用します。 -- `isDataResidency` （`boolean`）：オプション。ドメインをデータレジデンシーに使用するかどうか。 +* `isDataResidency` （`boolean`）：オプション。ドメインをデータレジデンシーに使用するかどうか。 以下の設定リストをご覧ください。 -| urlStrategy | デフォルトドメインとカスタムドメイン | サブドメインの使用 | データレジデンシー | -| --------------------- | ------------------------------------ | ------------------ | ------------------ | -| EU データレジデンシー | `"eu.adjust.com"` | `true` | `true` | -| 中国 URL戦略 | `"adjust.cn"`。 `"adjust.com"` | `true` | `false` | -| カスタムURL戦略 | `"my.custom.domain"` | `false` | `false` | +| urlStrategy | デフォルトドメインとカスタムドメイン | サブドメインの使用 | データレジデンシー | +|--------------|-------------------------------|-----------|-----------| +| EU データレジデンシー | `"eu.adjust.com"` | `true` | `true` | +| 中国 URL戦略 | `"adjust.cn"`。 `"adjust.com"` | `true` | `false` | +| カスタムURL戦略 | `"my.custom.domain"` | `false` | `false` | ```js Adjust.initSdk({ @@ -153,16 +145,12 @@ Adjust.initSdk({ }); ``` -### カスタムエンドポイントの設定（廃止済み）{#set-custom-endpoint} +### カスタムエンドポイントの設定（廃止済み）\{\#set\-custom\-endpoint\} -{" "} + 以前のバージョンのSDKでは、廃止された`customUrl`プロパティを使用してエンドポイントをパスしていました。今後は`urlStrategy`設定を使用してください。 - - + ```js Adjust.initSdk({ @@ -178,18 +166,14 @@ Adjust.initSdk({ }); ``` - + -### データレジデンシー（廃止済み）{#data-residency} +### データレジデンシー（廃止済み）\{\#data\-residency\} -{" "} + 以前のバージョンのSDKでは、廃止された`dataResidency`プロパティを使用していました。今後は`urlStrategy`設定を使用してください。 - - + ```js Adjust.initSdk({ @@ -206,3 +190,4 @@ Adjust.initSdk({ ``` + From 66d10eb2f0630dbbfb7f282630517f1bc9c3bdef Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 9 Jan 2025 12:54:13 +0000 Subject: [PATCH 23/42] File src/content/docs/en/sdk/web/index.mdx was translated to ko-KR locale --- src/content/docs/ko/sdk/web/index.mdx | 246 ++++---------------------- 1 file changed, 33 insertions(+), 213 deletions(-) diff --git a/src/content/docs/ko/sdk/web/index.mdx b/src/content/docs/ko/sdk/web/index.mdx index 0e2a313b23..fe0e06df44 100644 --- a/src/content/docs/ko/sdk/web/index.mdx +++ b/src/content/docs/ko/sdk/web/index.mdx @@ -1,271 +1,91 @@ --- -title: Web SDK integration guide -description: Use the Web SDK to access Adjust's features in your web apps -category-title: Web SDK -slug: ko/sdk/web +title: "Web SDK integration guide" +description: "Use the Web SDK to access Adjust's features in your web apps" +category-title: "Web SDK" +slug: "en/sdk/web" sidebar-position: 8 --- - Adjust 웹 SDK를 사용하면 웹 앱에서 어트리뷰션, 이벤트 및 기타 데이터를 기록할 수 있습니다. 이 가이드에서는 SDK를 앱과 연동하는 방법을 설명합니다. - - + 웹 SDK를 사용하려면 Adjust 대시보드에서 지원 중단된 웹 앱을 생성하고 그 둘을 연결해야 합니다. 웹 SDK를 모바일 앱 SDK가 이미 포함된 모바일 앱과 연동해서는 안 됩니다. + - - -## 1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} +1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} +------------------------------------------------------------------------------- 시작하려면 웹 앱에 SDK를 추가합니다. Adjust SDK는 CommonJS와 AMD\(비동기 모듈 정의\) 환경에서 모두 작동합니다. CDN\(콘텐츠 전송 네트워크\)을 통해 로딩될 때 글로벌 `Adjust` 네임스페이스를 통해 액세스할 수 있습니다. -### Using a CDN {#using-a-cdn} +### Using a CDN \{\#using\-a\-cdn\} CDN을 통해 SDK를 로딩할 때 프로덕션 빌드에 간소화된 버전을 사용해야 합니다. -- 다음과 같이 CDN 대상에 추가하여 특정 버전을 로드할 수 있습니다. `https://cdn.adjust.com/adjust-5.7.0.min.js` -- 최신 버전을 로드하려면 다음과 같이 `adjust-latest` 패키지를 사용합니다. `https://cdn.adjust.com/adjust-latest.min.js` 이 패키지는 자동으로 업데이트되므로 대상 파일을 변경할 필요가 없습니다. +* 다음과 같이 CDN 대상에 추가하여 특정 버전을 로드할 수 있습니다. `https://cdn.adjust.com/adjust-5.7.0.min.js` +* 최신 버전을 로드하려면 다음과 같이 `adjust-latest` 패키지를 사용합니다. `https://cdn.adjust.com/adjust-latest.min.js` 이 패키지는 자동으로 업데이트되므로 대상 파일을 변경할 필요가 없습니다. - + The SDK files are cached to enable fast service. This cache updates every 30 minutes. If you want to force an update to the latest version, target a specific version in your header. + - - -CDN을 통해 SDK를 로드하려면 웹 앱의 `` 요소 안에 다음 스니펫을 추가합니다. +CDN을 통해 SDK를 로드하려면 웹 앱의 `` 요소 안에 다음 스니펫을 추가합니다. \{/\* prettier\-ignore \*/\} ```html - ``` The Adjust SDK loads on each page and initiates once per page load. -#### Subresource Integrity {#subresource-integrity} +#### Subresource Integrity \{\#subresource\-integrity\} [하위 리소스 무결성](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) 검사를 사용하여 XSS\(사이트 간 스크립팅\) 공격을 완화할 수 있습니다. 패키지를 실행하기 전에 검증하려면 다음 콜\(추가 `crossOrigin`, `integrity`, 인코딩된 해시 확인\)을 사용합니다. \{/\* prettier\-ignore \*/\} ```html - ``` -### Using npm {#using-npm} +### Using npm \{\#using\-npm\} The Adjust SDK is also available on [npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk). To add the package to your project, use your preferred package manager: - - - + ```console $ npm install @adjustcom/adjust-web-sdk --save ``` - - + ```console $ yarn add @adjustcom/adjust-web-sdk ``` - - + ```console $ pnpm add @adjustcom/adjust-web-sdk ``` - - + -## 2\. Initialize the SDK \{\#initialize\-the\-sdk\} +2\. Initialize the SDK \{\#initialize\-the\-sdk\} +------------------------------------------------------- SDK를 설치한 후에는 초기화해야 합니다. 해당 기능 사용을 원하는 경우 `initSdk` 메서드를 호출합니다. 이 메서드는 앱에서 SDK가 작동하는 방식을 사용자 지정하는 데 사용할 수 있는 인수를 제공합니다. SDK를 시작하려면 다음 인수를 `initSdk` 호출에 추가해야 합니다. -- `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/ko/article/app-token-and-reporting-currency#view-your-app-details). -- `environment` \(`string`\): SDK를 실행할 환경입니다. - - 테스트 모드에서 SDK를 실행하려면 `sandbox` 를 전달합니다. - - 릴리즈를 위해 프로덕션 모드에서 SDK를 실행하려면 `production` 을 전달합니다. +* `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/en/article/app-token-and-reporting-currency#view-your-app-details). +* `environment` \(`string`\): SDK를 실행할 환경입니다. + * 테스트 모드에서 SDK를 실행하려면 `sandbox` 를 전달합니다. + * 릴리즈를 위해 프로덕션 모드에서 SDK를 실행하려면 `production` 을 전달합니다. ```js Adjust.initSdk({ @@ -274,8 +94,8 @@ Adjust.initSdk({ }); ``` - - -[구성 가이드](/ko/sdk/web/configuration)에서 Adjust 웹 SDK의 전체 인수 및 속성 목록을 확인하실 수 있습니다. + +[구성 가이드](/en/sdk/web/configuration)에서 Adjust 웹 SDK의 전체 인수 및 속성 목록을 확인하실 수 있습니다. + From 96a46c9ceffee0b168ebdf6281da754c189f1d6d Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 9 Jan 2025 12:54:16 +0000 Subject: [PATCH 24/42] File src/content/docs/en/sdk/web/index.mdx was translated to zh-CN locale --- src/content/docs/zh/sdk/web/index.mdx | 246 ++++---------------------- 1 file changed, 33 insertions(+), 213 deletions(-) diff --git a/src/content/docs/zh/sdk/web/index.mdx b/src/content/docs/zh/sdk/web/index.mdx index 13af544db8..087e6f0c5f 100644 --- a/src/content/docs/zh/sdk/web/index.mdx +++ b/src/content/docs/zh/sdk/web/index.mdx @@ -1,271 +1,91 @@ --- -title: Web SDK integration guide -description: Use the Web SDK to access Adjust's features in your web apps -category-title: Web SDK -slug: zh/sdk/web +title: "Web SDK integration guide" +description: "Use the Web SDK to access Adjust's features in your web apps" +category-title: "Web SDK" +slug: "en/sdk/web" sidebar-position: 8 --- - 通过 Adjust Web SDK，您可以在网页应用中记录归因、事件以及更多数据。该指南展示了如何将该 SDK 集成至应用。 - - + 要使用 Web SDK，您必须在 Adjust 控制面板中创建专用的网页应用并将两者关联起来。请勿将 Web SDK 集成到已经包含移动应用 SDK 的移动应用中。 + - - -## 1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} +1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} +------------------------------------------------------------------------------- 要开始设置，请将 SDK 添加至网页应用。Adjust SDK 可在 CommonJS 和 AMD \(Asynchronous Module Definition\) 环境中运行。通过 CDN \(内容分发网络\) 加载时，您可以通过全局`Adjust`命名空间对其进行访问。 -### Using a CDN {#using-a-cdn} +### Using a CDN \{\#using\-a\-cdn\} 通过 CDN 加载 SDK 时，您应该在生产环境中使用压缩版本。 -- 您可以通过添加一个版本至 CDN 目标来加载指定版本，如下所示：`https://cdn.adjust.com/adjust-5.7.0.min.js`。 -- 要加载最新版本，请使用`adjust-latest`包，如下所示：`https://cdn.adjust.com/adjust-latest.min.js`。该包会自动更新，您无需更改目标文件。 +* 您可以通过添加一个版本至 CDN 目标来加载指定版本，如下所示：`https://cdn.adjust.com/adjust-5.7.0.min.js`。 +* 要加载最新版本，请使用`adjust-latest`包，如下所示：`https://cdn.adjust.com/adjust-latest.min.js`。该包会自动更新，您无需更改目标文件。 - + The SDK files are cached to enable fast service. This cache updates every 30 minutes. If you want to force an update to the latest version, target a specific version in your header. + - - -要通过 CDN 加载 SDK，请将以下代码片段加入网页应用的``元素中： +要通过 CDN 加载 SDK，请将以下代码片段加入网页应用的``元素中： \{/\* prettier\-ignore \*/\} ```html - ``` The Adjust SDK loads on each page and initiates once per page load. -#### Subresource Integrity {#subresource-integrity} +#### Subresource Integrity \{\#subresource\-integrity\} 请使用[子资源完整性](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity)检查来抵御 XSS \(跨站脚本\) 攻击。要在运行包之前对其进行验证，请使用以下调用 \(请注意额外的`crossOrigin` 、 `integrity`和经过编码的哈希值\): \{/\* prettier\-ignore \*/\} ```html - ``` -### Using npm {#using-npm} +### Using npm \{\#using\-npm\} The Adjust SDK is also available on [npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk). To add the package to your project, use your preferred package manager: - - - + ```console $ npm install @adjustcom/adjust-web-sdk --save ``` - - + ```console $ yarn add @adjustcom/adjust-web-sdk ``` - - + ```console $ pnpm add @adjustcom/adjust-web-sdk ``` - - + -## 2\. Initialize the SDK \{\#initialize\-the\-sdk\} +2\. Initialize the SDK \{\#initialize\-the\-sdk\} +------------------------------------------------------- 安装 SDK 后，需要进行初始化。为此，请调用`initSdk`方法。您可以使用该方法中的参数来自定义 SDK 在应用中的工作方式。 要初始化 SDK，您必须将以下参数添加至`initSdk`调用： -- `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/zh/article/app-token-and-reporting-currency#view-your-app-details). -- `environment` \(`string`\)：SDK 运行的环境。 - - 传递`sandbox`来在测试模式下运行 SDK。 - - 传递 `production`来在生产模式下运行 SDK，方便发布。 +* `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/en/article/app-token-and-reporting-currency#view-your-app-details). +* `environment` \(`string`\)：SDK 运行的环境。 + * 传递`sandbox`来在测试模式下运行 SDK。 + * 传递 `production`来在生产模式下运行 SDK，方便发布。 ```js Adjust.initSdk({ @@ -274,8 +94,8 @@ Adjust.initSdk({ }); ``` - - -您可以在[配置指南](/zh/sdk/web/configuration)中找到 Adjust Web SDK 参数和属性的完整列表。 + +您可以在[配置指南](/en/sdk/web/configuration)中找到 Adjust Web SDK 参数和属性的完整列表。 + From bc02630fd9bf01da1e4ed33b306457b3853f4f14 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 9 Jan 2025 12:54:18 +0000 Subject: [PATCH 25/42] File src/content/docs/en/sdk/web/index.mdx was translated to ja-JP locale --- src/content/docs/ja/sdk/web/index.mdx | 246 ++++---------------------- 1 file changed, 33 insertions(+), 213 deletions(-) diff --git a/src/content/docs/ja/sdk/web/index.mdx b/src/content/docs/ja/sdk/web/index.mdx index 51f008f106..90dd9cc3ef 100644 --- a/src/content/docs/ja/sdk/web/index.mdx +++ b/src/content/docs/ja/sdk/web/index.mdx @@ -1,271 +1,91 @@ --- -title: Web SDK integration guide -description: Use the Web SDK to access Adjust's features in your web apps -category-title: Web SDK -slug: ja/sdk/web +title: "Web SDK integration guide" +description: "Use the Web SDK to access Adjust's features in your web apps" +category-title: "Web SDK" +slug: "en/sdk/web" sidebar-position: 8 --- - Adjust Web SDKを実装することで、アトリビューションやイベントなどのさまざまなデータをWebアプリで記録できます。このガイドでは、Adjust SDKをアプリに実装する方法をご紹介します。 - - + Web SDKを使用するには、Adjustダッシュボードで専用のWebアプリを作成し、その2つを連携する必要があります。モバイルアプリSDKが既に実装されているモバイルアプリには、Web SDKを実装しないでください。 + - - -## 1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} +1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} +------------------------------------------------------------------------------- まずは、WebアプリにSDKを追加します。Adjust SDKは、CommonJSとAMD（Asynchronous Module Definition）の両方の環境で動作します。CDN（Content Delivery Network）を利用して読み込むと、グローバルの`Adjust`名前空間を介してアクセスできます。 -### Using a CDN {#using-a-cdn} +### Using a CDN \{\#using\-a\-cdn\} CDNを利用してSDKを読み込むときは、本番用ビルドには縮小バージョンを使用する必要があります。 -- バージョンを指定するには、`https://cdn.adjust.com/adjust-5.7.0.min.js`のようにCDNターゲットに追加します。 -- 最新バージョンを読み込むには、次のように`adjust-latest`パッケージを使用してください：`https://cdn.adjust.com/adjust-latest.min.js` 。このパッケージは自動的にアップデートされるため、ターゲットファイルを変更する必要はありません。 +* バージョンを指定するには、`https://cdn.adjust.com/adjust-5.7.0.min.js`のようにCDNターゲットに追加します。 +* 最新バージョンを読み込むには、次のように`adjust-latest`パッケージを使用してください：`https://cdn.adjust.com/adjust-latest.min.js` 。このパッケージは自動的にアップデートされるため、ターゲットファイルを変更する必要はありません。 - + The SDK files are cached to enable fast service. This cache updates every 30 minutes. If you want to force an update to the latest version, target a specific version in your header. + - - -CDNを利用してSDKを読み込むには、Webアプリの``タグ間に次のスニペットを追加します。 +CDNを利用してSDKを読み込むには、Webアプリの``タグ間に次のスニペットを追加します。 \{/\* prettier\-ignore \*/\} ```html - ``` The Adjust SDK loads on each page and initiates once per page load. -#### Subresource Integrity {#subresource-integrity} +#### Subresource Integrity \{\#subresource\-integrity\} XSS（クロスサイトスクリプティング）攻撃を緩和するために、[サブリソース完全性](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity)チェックを使用します。実行前にパッケージを検証するには、次のコールを使用します（追加の`crossOrigin`、 `integrity`、およびエンコードされたハッシュにご留意ください）。 \{/\* prettier\-ignore \*/\} ```html - ``` -### Using npm {#using-npm} +### Using npm \{\#using\-npm\} The Adjust SDK is also available on [npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk). To add the package to your project, use your preferred package manager: - - - + ```console $ npm install @adjustcom/adjust-web-sdk --save ``` - - + ```console $ yarn add @adjustcom/adjust-web-sdk ``` - - + ```console $ pnpm add @adjustcom/adjust-web-sdk ``` - - + -## 2\. Initialize the SDK \{\#initialize\-the\-sdk\} +2\. Initialize the SDK \{\#initialize\-the\-sdk\} +------------------------------------------------------- SDKをインストールしたら初期化する必要があります。これを行うには、`initSdk`メソッドを呼び出してください。このメソッドには、アプリでのSDKの動作をカスタマイズするために使用できる引数があります。 SDKを初期化するには、 `initSdk`の呼び出しに次の引数を追加する必要があります。 -- `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/ja/article/app-token-and-reporting-currency#view-your-app-details). -- `environment` （`string`）：SDKを実行したい環境。 - - SDKをテストモードで実行するには、 `sandbox`をパスします。 - - リリースの本番用モードでSDKを実行するには、 `production`をパスします。 +* `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/en/article/app-token-and-reporting-currency#view-your-app-details). +* `environment` （`string`）：SDKを実行したい環境。 + * SDKをテストモードで実行するには、 `sandbox`をパスします。 + * リリースの本番用モードでSDKを実行するには、 `production`をパスします。 ```js Adjust.initSdk({ @@ -274,8 +94,8 @@ Adjust.initSdk({ }); ``` - - -AdjustのWeb SDKの引数とプロパティの全リストは、[設定ガイド](/ja/sdk/web/configuration)をご覧ください。 + +AdjustのWeb SDKの引数とプロパティの全リストは、[設定ガイド](/en/sdk/web/configuration)をご覧ください。 + From 65f3462415543dc2d9129018f389614bfacdb337 Mon Sep 17 00:00:00 2001 From: github-actions <41898282+github-actions[bot]@users.noreply.github.com> Date: Thu, 9 Jan 2025 12:54:53 +0000 Subject: [PATCH 26/42] Fix translated and formatted files --- .../docs/ja/sdk/web/features/attribution.mdx | 68 ++--- .../docs/ja/sdk/web/features/device-info.mdx | 16 +- .../docs/ja/sdk/web/features/privacy.mdx | 111 ++++---- src/content/docs/ja/sdk/web/index.mdx | 246 +++++++++++++++--- .../docs/ko/sdk/web/features/attribution.mdx | 70 ++--- .../docs/ko/sdk/web/features/device-info.mdx | 16 +- .../docs/ko/sdk/web/features/privacy.mdx | 111 ++++---- src/content/docs/ko/sdk/web/index.mdx | 246 +++++++++++++++--- .../docs/zh/sdk/web/features/attribution.mdx | 68 ++--- .../docs/zh/sdk/web/features/device-info.mdx | 16 +- .../docs/zh/sdk/web/features/privacy.mdx | 111 ++++---- src/content/docs/zh/sdk/web/index.mdx | 246 +++++++++++++++--- 12 files changed, 964 insertions(+), 361 deletions(-) diff --git a/src/content/docs/ja/sdk/web/features/attribution.mdx b/src/content/docs/ja/sdk/web/features/attribution.mdx index 978dd09c60..bda772281b 100644 --- a/src/content/docs/ja/sdk/web/features/attribution.mdx +++ b/src/content/docs/ja/sdk/web/features/attribution.mdx @@ -1,12 +1,14 @@ --- -title: "アトリビューション情報の取得" -description: "Adjust SDKを使ってアトリビューションの変更を受信します。" -slug: "en/sdk/web/features/attribution" +title: アトリビューション情報の取得 +description: Adjust SDKを使ってアトリビューションの変更を受信します。 +slug: ja/sdk/web/features/attribution --- -ユーザーがAdjustリンクをクリックすると、そのアトリビューション情報が更新されます。これは、ユーザーが[ディープリンク](https://help.adjust.com/en/article/deep-links)をクリックした場合に発生します。ユーザーのアトリビューションについての情報は、アトリビューションオブジェクトに表示されます。 + +ユーザーがAdjustリンクをクリックすると、そのアトリビューション情報が更新されます。これは、ユーザーが[ディープリンク](https://help.adjust.com/ja/article/deep-links)をクリックした場合に発生します。ユーザーのアトリビューションについての情報は、アトリビューションオブジェクトに表示されます。 アトリビューションオブジェクトは以下の情報を含んでいます。 - + + ```js export type AttributionMapT = $ReadOnly<{| @@ -22,30 +24,29 @@ export type AttributionMapT = $ReadOnly<{| |}>; ``` - + -| 値 | データタイプ | 説明 | -|-----------------|----------|-------------------------------------------------------------------------------| -| `adid` | `string` | デバイス固有のAdjust識別子 | -| `tracker_token` | `string` | アトリビューションに関連付けられているリンクトークン | -| `tracker_name` | `string` | キャンペーンリンクの名前 | -| `network` | `string` | キャンペーンに関連付けられているネットワーク | -| `campaign` | `string` | アトリビューションに関連付けられているキャンペーンの名前 | -| `adgroup` | `string` | アトリビューションに関連付けられているアドグループ | -| `creative` | `string` | アトリビューションに関連付けられているクリエイティブ | -| `click_label` | `string` | アトリビューションに関連付けられている[クリックラベル](https://help.adjust.com/en/article/user-rewards) | -| `state` | `string` | アトリビューションの現在のステータス。`installed`または `reattributed` | +| 値 | データタイプ | 説明 | +| --------------- | ------------ | ------------------------------------------------------------------------------------------------------- | +| `adid` | `string` | デバイス固有のAdjust識別子 | +| `tracker_token` | `string` | アトリビューションに関連付けられているリンクトークン | +| `tracker_name` | `string` | キャンペーンリンクの名前 | +| `network` | `string` | キャンペーンに関連付けられているネットワーク | +| `campaign` | `string` | アトリビューションに関連付けられているキャンペーンの名前 | +| `adgroup` | `string` | アトリビューションに関連付けられているアドグループ | +| `creative` | `string` | アトリビューションに関連付けられているクリエイティブ | +| `click_label` | `string` | アトリビューションに関連付けられている[クリックラベル](https://help.adjust.com/ja/article/user-rewards) | +| `state` | `string` | アトリビューションの現在のステータス。`installed`または `reattributed` | -アトリビューションの変更時にコールバックをトリガーする \{\#trigger\-a\-callback\-when\-attribution\-changes\} ------------------------------------------------------------------------------------------- +## アトリビューションの変更時にコールバックをトリガーする \{\#trigger\-a\-callback\-when\-attribution\-changes\} - + ```js attributionCallback: (string, Object) => mixed; ``` - + SDKはアトリビューションの変更を受信し、更新を検出したときに関数を呼び出すことができます。アトリビューションコールバックメソッドを設定するには、`initSdk`メソッドで`attributionCallback`関数を指定します。関数内で、ユーザーのアトリビューション情報にアクセスすることができます。 @@ -67,10 +68,12 @@ Adjust.initSdk({ }); ``` -現在のアトリビューション情報を取得する \{\#get\-current\-attribution\-information\} ----------------------------------------------------------------------- +## 現在のアトリビューション情報を取得する \{\#get\-current\-attribution\-information\} - +{" "} ユーザーがアプリをインストールすると、Adjustはそのインストールをキャンペーンにアトリビュートします。Adjust SDKを実装することで、インストールのキャンペーンアトリビューションの詳細にアクセスすることが可能です。`waitForAttribution`メソッドは、SDKがサーバーからアトリビューションデータを正常に受信すると解析される`promise`を返します。 @@ -80,29 +83,30 @@ Adjust.waitForAttribution().then((attr) => ); ``` -リファラーを設定する \{\#set\-a\-referrer\} --------------------------------------- +## リファラーを設定する \{\#set\-a\-referrer\} - + ```js function setReferrer(referrer: string): void; ``` - + SDKの開始時にカスタムクリックIDでSDKクリックのトリガーとなるリファラーを設定することができます。SDKは、アトリビューションの目的でカスタムクリックIDをAdjustのサーバーに送信します。 - + + アトリビューションにリファラーが使用されるように、SDKの初期化時にできる限り近い時点でこのメソッドを呼び出してください。 - + + リファラーを設定するには、`setReferrer`メソッドを呼び出し、URLエンコードされた`string`引数としてリファラーをパスします。 - + + ```js Adjust.setReferrer("adjust_external_click_id%3DEXTERNAL_CLICK_ID"); ``` - diff --git a/src/content/docs/ja/sdk/web/features/device-info.mdx b/src/content/docs/ja/sdk/web/features/device-info.mdx index 4c5badf3c1..90fe7f040b 100644 --- a/src/content/docs/ja/sdk/web/features/device-info.mdx +++ b/src/content/docs/ja/sdk/web/features/device-info.mdx @@ -1,14 +1,17 @@ --- -title: "デバイス情報を取得" -description: "これらのメソッドを使用することでコールバックに詳細を追加し、レポートを改善させましょう。" -slug: "en/sdk/web/features/device-info" +title: デバイス情報を取得 +description: これらのメソッドを使用することでコールバックに詳細を追加し、レポートを改善させましょう。 +slug: ja/sdk/web/features/device-info --- + Adjust SDKには、デバイス情報を返すヘルパーメソッドが含まれています。これらのメソッドを使用することでコールバックに詳細を追加し、レポートを改善させましょう。 -Web UUID \{\#web\-uuid\} ----------------------------- +## Web UUID \{\#web\-uuid\} - +{" "} AdjustがWebユーザーを識別するために、Web SDKはセッションを送信する際に一意の`web_uuid`を生成します。IDはUniversally Unique Identifier（UUID）のフォーマットです。 @@ -19,4 +22,3 @@ AdjustがWebユーザーを識別するために、Web SDKはセッションを ```js Adjust.waitForWebUUID().then((webUuid) => console.log(webUuid)); ``` - diff --git a/src/content/docs/ja/sdk/web/features/privacy.mdx b/src/content/docs/ja/sdk/web/features/privacy.mdx index 2b44505c76..3e90874118 100644 --- a/src/content/docs/ja/sdk/web/features/privacy.mdx +++ b/src/content/docs/ja/sdk/web/features/privacy.mdx @@ -1,42 +1,44 @@ --- -title: "プライバシー機能の設定" -description: "アプリ内でユーザーのプライバシーを処理するために使用できる機能を設定します。" -slug: "en/sdk/web/features/privacy" +title: プライバシー機能の設定 +description: アプリ内でユーザーのプライバシーを処理するために使用できる機能を設定します。 +slug: ja/sdk/web/features/privacy --- + Adjust SDKには、アプリ内でのユーザープライバシーの処理に使用できる機能が含まれています。 -消去リクエストを送信する \{\#send\-erasure\-request\} ----------------------------------------------- +## 消去リクエストを送信する \{\#send\-erasure\-request\} - + ```js function gdprForgetMe(): void; ``` - + -EUの一般データ保護規則（GDPR）および類似する世界的なプライバシー法（CCPA、LGPDなど）は、個人データの処理に関する包括的な権利をデータ主体に付与しています。これらの権利には、消去権（[GDPR第17条](https://gdpr.eu/article-17-right-to-be-forgotten/)を参照）（[1](https://help.adjust.com/en/article/gdpr#ref-1)）が含まれます。データ処理者として、Adjustは、（アプリ）ユーザー（データ管理者）からのそのようなリクエストの処理をサポートする義務があります。 +EUの一般データ保護規則（GDPR）および類似する世界的なプライバシー法（CCPA、LGPDなど）は、個人データの処理に関する包括的な権利をデータ主体に付与しています。これらの権利には、消去権（[GDPR第17条](https://gdpr.eu/article-17-right-to-be-forgotten/)を参照）（[1](https://help.adjust.com/ja/article/gdpr#ref-1)）が含まれます。データ処理者として、Adjustは、（アプリ）ユーザー（データ管理者）からのそのようなリクエストの処理をサポートする義務があります。 `gdprForgetMe`メソッドを呼び出すことで、ユーザーの消去リクエストをAdjustに送信することができます。Adjustが通知を受けると、以下の対応をします。 -* Adjustはその内部システムおよびデータベースから、履歴として保管されているユーザーの全ての個人データを完全に削除します。 -* Adjustは、Adjust SDKを介して、このユーザー/デバイスからデータを受信しなくなります。（[2](https://help.adjust.com/en/article/gdpr#ref-2)） +- Adjustはその内部システムおよびデータベースから、履歴として保管されているユーザーの全ての個人データを完全に削除します。 +- Adjustは、Adjust SDKを介して、このユーザー/デバイスからデータを受信しなくなります。（[2](https://help.adjust.com/ja/article/gdpr#ref-2)） ```js Adjust.gdprForgetMe(); ``` -特定のユーザーの情報をサードパーティと共有する \{\#third\-party\-sharing\-for\-specific\-users\} ---------------------------------------------------------------------------------- +## 特定のユーザーの情報をサードパーティと共有する \{\#third\-party\-sharing\-for\-specific\-users\} - +{" "} Adjust SDKを使用して、ユーザーがサードパーティとの共有設定を変更した時にそれを記録することができます。これらの設定は、`ThirdPartySharing`クラスを使用して行われます。 -### AdjustThirdPartySharingオブジェクトをインスタンス化する \{\#instantiate\-an\-adjustthirdpartysharing\-object\} +### AdjustThirdPartySharingオブジェクトをインスタンス化する {#instantiate-an-adjustthirdpartysharing-object} - + ```ts class ThirdPartySharing { @@ -45,13 +47,13 @@ class ThirdPartySharing { } ``` - + Adjust SDKでサードパーティ共有を有効化または無効化するには、`ThirdPartySharing`オブジェクトをインスタンス化する必要があります。このオブジェクトには、Adjustがサードパーティとの共有をどのように扱うかを制御する変数が含まれます。 これをインスタンス化するには、新しい`ThirdPartySharing`インスタンスを作成して、以下のパラメーターをパスしてください： -* `isEnabled` \( `boolean` \) ：`true`をパスしてサードパーティ共有を有効化するか、 `false`をパスして無効化します。 +- `isEnabled` \( `boolean` \) ：`true`をパスしてサードパーティ共有を有効化するか、 `false`をパスして無効化します。 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -66,9 +68,12 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### サードパーティ共有を無効にする（廃止）\{\#disable\-third\-party\-sharing\} +### サードパーティ共有を無効にする（廃止）{#disable-third-party-sharing} - +{" "} 以前のバージョンのSDKでサードパーティとの共有を無効にするには、 `disableThirdPartySharing`メソッドを呼び出します。このメソッドは廃止されました。それでも使用する場合は、基礎となるメソッドを直接呼び出していることに注意してください。 @@ -77,9 +82,9 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(false); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 粒度の高い情報を送信する \{\#send\-granular\-information\} +### 粒度の高い情報を送信する {#send-granular-information} - + ```ts public addGranularOption(partnerName: string, @@ -87,15 +92,15 @@ public addGranularOption(partnerName: string, value: string) ``` - + ユーザーがサードパーティの共有設定を更新すると、詳細な情報を付与できます。この情報を使用して、ユーザー行動についてより詳しく伝えることができます。 これを行うには、以下のパラメーターを使用して`addGranularOption`メソッドを呼び出します： -* `partnerName` （`string`）：granular optionが適用されるパートナーの名前 -* `key` （`string`）：オプションのキー -* `value` （`string`）：オプションの値 +- `partnerName` （`string`）：granular optionが適用されるパートナーの名前 +- `key` （`string`）：オプションのキー +- `value` （`string`）：オプションの値 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -103,34 +108,37 @@ options.addGranularOption("PartnerA", "foo", "bar"); Adjust.trackThirdPartySharing(options); ``` -URL戦略 \{\#url\-strategy\} ------------------------------ +## URL戦略 \{\#url\-strategy\} - +{" "} URL戦略機能では、以下のいずれかを設定することができます： -* Adjustがお客様のデータを保管する国（データレジデンシー）。 -* Adjust SDKがトラフィックを送信するエンドポイント（カスタムURL）。 +- Adjustがお客様のデータを保管する国（データレジデンシー）。 +- Adjust SDKがトラフィックを送信するエンドポイント（カスタムURL）。 これは、プライバシー要件が厳しい国で事業を展開している場合に便利です。URL戦略を設定すると、Adjustは選択したデータレジデンシー地域にデータを保管したり、選択したドメインにトラフィックを送信したりします。 URL戦略を設定するには、 `Adjust.initSdk`インスタンスの`urlStrategy`の以下のプロパティを設定します。 -* `domains` （`Array`）：SDKトラフィックを送信する国、データの所在国、またはエンドポイント。デフォルトでは、Adjust SDKは全てのデータをAdjustのエンドポイントに送信します。カスタムエンドポイントを設定する場合は、 `urlStrategy`の`domains`プロパティでパスします。 -* `useSubdomains` （`boolean`）：ドメインをAdjustドメインとして扱うかどうか。 - * `true`の場合、SDKはドメインの前にAdjust固有のサブドメインを付けます。 - * `false`の場合、SDKは指定されたドメインをプレフィックスなしでそのまま使用します。 +- `domains` （`Array`）：SDKトラフィックを送信する国、データの所在国、またはエンドポイント。デフォルトでは、Adjust SDKは全てのデータをAdjustのエンドポイントに送信します。カスタムエンドポイントを設定する場合は、 `urlStrategy`の`domains`プロパティでパスします。 +- `useSubdomains` （`boolean`）：ドメインをAdjustドメインとして扱うかどうか。 + + - `true`の場合、SDKはドメインの前にAdjust固有のサブドメインを付けます。 + - `false`の場合、SDKは指定されたドメインをプレフィックスなしでそのまま使用します。 -* `isDataResidency` （`boolean`）：オプション。ドメインをデータレジデンシーに使用するかどうか。 +- `isDataResidency` （`boolean`）：オプション。ドメインをデータレジデンシーに使用するかどうか。 以下の設定リストをご覧ください。 -| urlStrategy | デフォルトドメインとカスタムドメイン | サブドメインの使用 | データレジデンシー | -|--------------|-------------------------------|-----------|-----------| -| EU データレジデンシー | `"eu.adjust.com"` | `true` | `true` | -| 中国 URL戦略 | `"adjust.cn"`。 `"adjust.com"` | `true` | `false` | -| カスタムURL戦略 | `"my.custom.domain"` | `false` | `false` | +| urlStrategy | デフォルトドメインとカスタムドメイン | サブドメインの使用 | データレジデンシー | +| --------------------- | ------------------------------------ | ------------------ | ------------------ | +| EU データレジデンシー | `"eu.adjust.com"` | `true` | `true` | +| 中国 URL戦略 | `"adjust.cn"`。 `"adjust.com"` | `true` | `false` | +| カスタムURL戦略 | `"my.custom.domain"` | `false` | `false` | ```js Adjust.initSdk({ @@ -145,12 +153,16 @@ Adjust.initSdk({ }); ``` -### カスタムエンドポイントの設定（廃止済み）\{\#set\-custom\-endpoint\} +### カスタムエンドポイントの設定（廃止済み）{#set-custom-endpoint} - +{" "} 以前のバージョンのSDKでは、廃止された`customUrl`プロパティを使用してエンドポイントをパスしていました。今後は`urlStrategy`設定を使用してください。 - + + ```js Adjust.initSdk({ @@ -166,14 +178,18 @@ Adjust.initSdk({ }); ``` - + -### データレジデンシー（廃止済み）\{\#data\-residency\} +### データレジデンシー（廃止済み）{#data-residency} - +{" "} 以前のバージョンのSDKでは、廃止された`dataResidency`プロパティを使用していました。今後は`urlStrategy`設定を使用してください。 - + + ```js Adjust.initSdk({ @@ -190,4 +206,3 @@ Adjust.initSdk({ ``` - diff --git a/src/content/docs/ja/sdk/web/index.mdx b/src/content/docs/ja/sdk/web/index.mdx index 90dd9cc3ef..51f008f106 100644 --- a/src/content/docs/ja/sdk/web/index.mdx +++ b/src/content/docs/ja/sdk/web/index.mdx @@ -1,91 +1,271 @@ --- -title: "Web SDK integration guide" -description: "Use the Web SDK to access Adjust's features in your web apps" -category-title: "Web SDK" -slug: "en/sdk/web" +title: Web SDK integration guide +description: Use the Web SDK to access Adjust's features in your web apps +category-title: Web SDK +slug: ja/sdk/web sidebar-position: 8 --- + Adjust Web SDKを実装することで、アトリビューションやイベントなどのさまざまなデータをWebアプリで記録できます。このガイドでは、Adjust SDKをアプリに実装する方法をご紹介します。 - + + Web SDKを使用するには、Adjustダッシュボードで専用のWebアプリを作成し、その2つを連携する必要があります。モバイルアプリSDKが既に実装されているモバイルアプリには、Web SDKを実装しないでください。 - -1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} -------------------------------------------------------------------------------- + + +## 1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} まずは、WebアプリにSDKを追加します。Adjust SDKは、CommonJSとAMD（Asynchronous Module Definition）の両方の環境で動作します。CDN（Content Delivery Network）を利用して読み込むと、グローバルの`Adjust`名前空間を介してアクセスできます。 -### Using a CDN \{\#using\-a\-cdn\} +### Using a CDN {#using-a-cdn} CDNを利用してSDKを読み込むときは、本番用ビルドには縮小バージョンを使用する必要があります。 -* バージョンを指定するには、`https://cdn.adjust.com/adjust-5.7.0.min.js`のようにCDNターゲットに追加します。 -* 最新バージョンを読み込むには、次のように`adjust-latest`パッケージを使用してください：`https://cdn.adjust.com/adjust-latest.min.js` 。このパッケージは自動的にアップデートされるため、ターゲットファイルを変更する必要はありません。 +- バージョンを指定するには、`https://cdn.adjust.com/adjust-5.7.0.min.js`のようにCDNターゲットに追加します。 +- 最新バージョンを読み込むには、次のように`adjust-latest`パッケージを使用してください：`https://cdn.adjust.com/adjust-latest.min.js` 。このパッケージは自動的にアップデートされるため、ターゲットファイルを変更する必要はありません。 - + The SDK files are cached to enable fast service. This cache updates every 30 minutes. If you want to force an update to the latest version, target a specific version in your header. - -CDNを利用してSDKを読み込むには、Webアプリの``タグ間に次のスニペットを追加します。 + + +CDNを利用してSDKを読み込むには、Webアプリの``タグ間に次のスニペットを追加します。 \{/\* prettier\-ignore \*/\} ```html - ``` The Adjust SDK loads on each page and initiates once per page load. -#### Subresource Integrity \{\#subresource\-integrity\} +#### Subresource Integrity {#subresource-integrity} XSS（クロスサイトスクリプティング）攻撃を緩和するために、[サブリソース完全性](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity)チェックを使用します。実行前にパッケージを検証するには、次のコールを使用します（追加の`crossOrigin`、 `integrity`、およびエンコードされたハッシュにご留意ください）。 \{/\* prettier\-ignore \*/\} ```html - ``` -### Using npm \{\#using\-npm\} +### Using npm {#using-npm} The Adjust SDK is also available on [npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk). To add the package to your project, use your preferred package manager: - + + + ```console $ npm install @adjustcom/adjust-web-sdk --save ``` - + + ```console $ yarn add @adjustcom/adjust-web-sdk ``` - + + ```console $ pnpm add @adjustcom/adjust-web-sdk ``` - + + -2\. Initialize the SDK \{\#initialize\-the\-sdk\} -------------------------------------------------------- +## 2\. Initialize the SDK \{\#initialize\-the\-sdk\} SDKをインストールしたら初期化する必要があります。これを行うには、`initSdk`メソッドを呼び出してください。このメソッドには、アプリでのSDKの動作をカスタマイズするために使用できる引数があります。 SDKを初期化するには、 `initSdk`の呼び出しに次の引数を追加する必要があります。 -* `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/en/article/app-token-and-reporting-currency#view-your-app-details). -* `environment` （`string`）：SDKを実行したい環境。 - * SDKをテストモードで実行するには、 `sandbox`をパスします。 - * リリースの本番用モードでSDKを実行するには、 `production`をパスします。 +- `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/ja/article/app-token-and-reporting-currency#view-your-app-details). +- `environment` （`string`）：SDKを実行したい環境。 + - SDKをテストモードで実行するには、 `sandbox`をパスします。 + - リリースの本番用モードでSDKを実行するには、 `production`をパスします。 ```js Adjust.initSdk({ @@ -94,8 +274,8 @@ Adjust.initSdk({ }); ``` - + -AdjustのWeb SDKの引数とプロパティの全リストは、[設定ガイド](/en/sdk/web/configuration)をご覧ください。 - +AdjustのWeb SDKの引数とプロパティの全リストは、[設定ガイド](/ja/sdk/web/configuration)をご覧ください。 + diff --git a/src/content/docs/ko/sdk/web/features/attribution.mdx b/src/content/docs/ko/sdk/web/features/attribution.mdx index 65e715eabc..1bf5764cf4 100644 --- a/src/content/docs/ko/sdk/web/features/attribution.mdx +++ b/src/content/docs/ko/sdk/web/features/attribution.mdx @@ -1,12 +1,14 @@ --- -title: "어트리뷰션 정보 확인" -description: "Adjust SDK를 사용하여 어트리뷰션 변경 사항 수신" -slug: "en/sdk/web/features/attribution" +title: 어트리뷰션 정보 확인 +description: Adjust SDK를 사용하여 어트리뷰션 변경 사항 수신 +slug: ko/sdk/web/features/attribution --- -사용자가 Adjust 링크와 상호작용하면 어트리뷰션 정보가 업데이트됩니다. 이는 사용자가 [딥링크](https://help.adjust.com/en/article/deep-links)와 상호작용하는 경우에 발생할 수 있습니다. 사용자의 어트리뷰션 관련 정보는 어트리뷰션 객체에 나타납니다. + +사용자가 Adjust 링크와 상호작용하면 어트리뷰션 정보가 업데이트됩니다. 이는 사용자가 [딥링크](https://help.adjust.com/ko/article/deep-links)와 상호작용하는 경우에 발생할 수 있습니다. 사용자의 어트리뷰션 관련 정보는 어트리뷰션 객체에 나타납니다. 어트리뷰션 객체에는 다음 정보가 포함됩니다. - + + ```js export type AttributionMapT = $ReadOnly<{| @@ -22,32 +24,31 @@ export type AttributionMapT = $ReadOnly<{| |}>; ``` - + -| 값 | 데이터 유형 | 설명 | -|-----------------|----------|-----------------------------------------------------------------------| -| `adid` | `string` | 기기의 고유한 Adjust 식별자. | -| `tracker_token` | `string` | 어트리뷰션과 관련된 링크 토큰. | -| `tracker_name` | `string` | 캠페인 링크의 이름. | -| `network` | `string` | 캠페인과 관련된 네트워크. | -| `campaign` | `string` | 어트리뷰션과 관련된 캠페인의 이름. | -| `adgroup` | `string` | 어트리뷰션과 관련된 광고그룹. | -| `creative` | `string` | 어트리뷰션과 관련된 크리에이티브. | -| `click_label` | `string` | 어트리뷰션과 관련된 [클릭 레이블](https://help.adjust.com/en/article/user-rewards). | -| `state` | `string` | 어트리뷰션의 현재 상태. `installed` 또는 `reattributed` | +| 값 | 데이터 유형 | 설명 | +| --------------- | ----------- | ----------------------------------------------------------------------------------- | +| `adid` | `string` | 기기의 고유한 Adjust 식별자. | +| `tracker_token` | `string` | 어트리뷰션과 관련된 링크 토큰. | +| `tracker_name` | `string` | 캠페인 링크의 이름. | +| `network` | `string` | 캠페인과 관련된 네트워크. | +| `campaign` | `string` | 어트리뷰션과 관련된 캠페인의 이름. | +| `adgroup` | `string` | 어트리뷰션과 관련된 광고그룹. | +| `creative` | `string` | 어트리뷰션과 관련된 크리에이티브. | +| `click_label` | `string` | 어트리뷰션과 관련된 [클릭 레이블](https://help.adjust.com/ko/article/user-rewards). | +| `state` | `string` | 어트리뷰션의 현재 상태. `installed` 또는 `reattributed` | -어트리뷰션 변경 시 콜백 트리거 \{\#trigger\-a\-callback\-when\-attribution\-changes\} --------------------------------------------------------------------------------- +## 어트리뷰션 변경 시 콜백 트리거 \{\#trigger\-a\-callback\-when\-attribution\-changes\} - + ```js attributionCallback: (string, Object) => mixed; ``` - + -SDK는 어트리뷰션 변경 사항을 받고 업데이트가 감지되면 함수를 호출합니다. `initSdk` 메서드의 `attributionCallback` 함수 특정으로 어트리뷰션 콜백 메서드를 설정할 수 있습니다. 함수 내에서 사용자의 어트리뷰션 정보에 액세스할 수 있습니다. +SDK는 어트리뷰션 변경 사항을 받고 업데이트가 감지되면 함수를 호출합니다. `initSdk` 메서드의 `attributionCallback` 함수 특정으로 어트리뷰션 콜백 메서드를 설정할 수 있습니다. 함수 내에서 사용자의 어트리뷰션 정보에 액세스할 수 있습니다. ```js Adjust.initSdk({ @@ -67,10 +68,12 @@ Adjust.initSdk({ }); ``` -현재 어트리뷰션 정보 확인 \{\#get\-current\-attribution\-information\} ------------------------------------------------------------------ +## 현재 어트리뷰션 정보 확인 \{\#get\-current\-attribution\-information\} - +{" "} 사용자가 앱을 설치하면 Adjust는 해당 설치를 캠페인에 어트리뷰션합니다. Adjust SDK를 사용하면 설치 캠페인 어트리뷰션 정보에 액세스할 수 있습니다. `waitForAttribution` 메서드는 SDK가 서버에서 어트리뷰션 데이터를 성공적으로 수신했을 때 `promise` 를 반환합니다. @@ -80,29 +83,30 @@ Adjust.waitForAttribution().then((attr) => ); ``` -리퍼러 설정 \{\#set\-a\-referrer\} ----------------------------------- +## 리퍼러 설정 \{\#set\-a\-referrer\} - + ```js function setReferrer(referrer: string): void; ``` - + SDK가 시작될 때 커스텀 클릭 ID로 SDK 클릭을 트리거하는 리퍼러를 설정할 수 있습니다. SDK는 어트리뷰션 목적으로 커스텀 클릭 ID를 Adjust 서버로 전송합니다. - + + 리퍼러가 어트리뷰션에 사용될 수 있도록 최대한 SDK 초기화에 가깝게 이 메서드를 호출하시기 바랍니다. - + + 리퍼러를 설정하려면 `setReferrer` 메서드를 호출하고 리퍼러를 URL 암호화된 `string` 인수로 전달합니다. - + + ```js Adjust.setReferrer("adjust_external_click_id%3DEXTERNAL_CLICK_ID"); ``` - diff --git a/src/content/docs/ko/sdk/web/features/device-info.mdx b/src/content/docs/ko/sdk/web/features/device-info.mdx index 5b5ff1e94d..a9c803a888 100644 --- a/src/content/docs/ko/sdk/web/features/device-info.mdx +++ b/src/content/docs/ko/sdk/web/features/device-info.mdx @@ -1,14 +1,17 @@ --- -title: "디바이스 정보 확인" -description: "해당 메서드를 사용하여 콜백에 세부 정보를 추가하고 리포트를 보완하시기 바랍니다." -slug: "en/sdk/web/features/device-info" +title: 디바이스 정보 확인 +description: 해당 메서드를 사용하여 콜백에 세부 정보를 추가하고 리포트를 보완하시기 바랍니다. +slug: ko/sdk/web/features/device-info --- + Adjust SDK는 디바이스 정보를 반환하는 헬프 메서드가 포함되어 있습니다. 해당 메서드를 사용하여 콜백에 세부 정보를 추가하고 리포트를 보완하시기 바랍니다. -Web UUID \{\#web\-uuid\} ----------------------------- +## Web UUID \{\#web\-uuid\} - +{" "} 웹 SDK는 Adjust에서 웹 사용자를 식별하기 위해 첫 세션 전송 시 고유한 `web_uuid` 식별자를 생성합니다. 이 ID는 UUID\(Universally Unique Identifier\) 형식을 따릅니다. @@ -19,4 +22,3 @@ Web UUID \{\#web\-uuid\} ```js Adjust.waitForWebUUID().then((webUuid) => console.log(webUuid)); ``` - diff --git a/src/content/docs/ko/sdk/web/features/privacy.mdx b/src/content/docs/ko/sdk/web/features/privacy.mdx index 2ee8c7acee..5f19a2b666 100644 --- a/src/content/docs/ko/sdk/web/features/privacy.mdx +++ b/src/content/docs/ko/sdk/web/features/privacy.mdx @@ -1,42 +1,44 @@ --- -title: "프라이버시 기능 설정" -description: "앱에서 사용자 프라이버시를 관리할 수 있는 기능을 구성합니다." -slug: "en/sdk/web/features/privacy" +title: 프라이버시 기능 설정 +description: 앱에서 사용자 프라이버시를 관리할 수 있는 기능을 구성합니다. +slug: ko/sdk/web/features/privacy --- + Adjust SDK에는 앱에서 사용자 프라이버시를 관리할 수 있는 기능이 포함되어 있습니다. -삭제 요청 전송 \{\#send\-erasure\-request\} ------------------------------------------- +## 삭제 요청 전송 \{\#send\-erasure\-request\} - + ```js function gdprForgetMe(): void; ``` - + -EU의 개인정보 보호 규정\(GDPR\) 및 기타 개인정보 보호법\(CCPA, LGPD 등\)은 데이터 주체에게 개인 데이터 처리와 관련하여 포괄적인 권리를 부여합니다. 이러한 권리에는 삭제 권리\([GDPR 17조](https://gdpr.eu/article-17-right-to-be-forgotten/)\)\([1](https://help.adjust.com/en/article/gdpr#ref-1)\)가 포함됩니다. 데이터 처리자로서 Adjust는 귀하의 \(앱\) 사용자의 이러한 요청을 처리하는 데 있어 귀하\(데이터 컨트롤러\)를 지원할 의무가 있습니다. +EU의 개인정보 보호 규정\(GDPR\) 및 기타 개인정보 보호법\(CCPA, LGPD 등\)은 데이터 주체에게 개인 데이터 처리와 관련하여 포괄적인 권리를 부여합니다. 이러한 권리에는 삭제 권리\([GDPR 17조](https://gdpr.eu/article-17-right-to-be-forgotten/)\)\([1](https://help.adjust.com/ko/article/gdpr#ref-1)\)가 포함됩니다. 데이터 처리자로서 Adjust는 귀하의 \(앱\) 사용자의 이러한 요청을 처리하는 데 있어 귀하\(데이터 컨트롤러\)를 지원할 의무가 있습니다. `gdprForgetMe` 메서드를 호출하여 사용자의 삭제 요청을 Adjust로 전송할 수 있습니다. 삭제 요청 수신 시 Adjust는 다음의 조치를 취합니다: -* Adjust 내부 시스템과 데이터베이스에서 해당 사용자의 모든 개인 정보 기록을 영구적으로 삭제합니다. -* Adjust는 더 이상 Adjust SDK를 통해 해당 사용자/기기로부터 데이터를 수신하지 않습니다.\([2](https://help.adjust.com/en/article/gdpr#ref-2)\) +- Adjust 내부 시스템과 데이터베이스에서 해당 사용자의 모든 개인 정보 기록을 영구적으로 삭제합니다. +- Adjust는 더 이상 Adjust SDK를 통해 해당 사용자/기기로부터 데이터를 수신하지 않습니다.\([2](https://help.adjust.com/ko/article/gdpr#ref-2)\) ```js Adjust.gdprForgetMe(); ``` -특정 사용자에 대한 서드파티 공유 \{\#third\-party\-sharing\-for\-specific\-users\} ----------------------------------------------------------------------------- +## 특정 사용자에 대한 서드파티 공유 \{\#third\-party\-sharing\-for\-specific\-users\} - +{" "} Adjust SDK를 사용하여 사용자의 서드파티 공유 설정 변경 내용을 기록할 수 있습니다. 이러한 설정은 `ThirdPartySharing` 클래스를 사용하여 구성됩니다. -### AdjustThirdPartySharing 객체 인스턴스화 \{\#instantiate\-an\-adjustthirdpartysharing\-object\} +### AdjustThirdPartySharing 객체 인스턴스화 {#instantiate-an-adjustthirdpartysharing-object} - + ```ts class ThirdPartySharing { @@ -45,13 +47,13 @@ class ThirdPartySharing { } ``` - + Adjust SDK와의 서드파트 공유를 활성화 또는 비활성화하려면 `ThirdPartySharing` 객체를 인스턴스화합니다. 이 객체에 Adjust의 서드파티 공유 처리 방식을 제어하는 변수가 포함됩니다. 이를 인스턴스화하려면 새로운 `ThirdPartySharing` 인스턴스를 생성하고 다음 파라미터를 전달합니다. -* `isEnabled` \(`boolean`\):`true` 전달로 서드파티 공유를 활성화하거나 `false` 전달로 서드파티 공유를 비활성화합니다. +- `isEnabled` \(`boolean`\):`true` 전달로 서드파티 공유를 활성화하거나 `false` 전달로 서드파티 공유를 비활성화합니다. ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -66,9 +68,12 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 서드파티 공유 비활성화\(지원 중단\) \{\#disable\-third\-party\-sharing\} +### 서드파티 공유 비활성화\(지원 중단\) {#disable-third-party-sharing} - +{" "} 이전 버전의 SDK에서 서드파티 공유를 비활성화하려면 `disableThirdPartySharing` 메서드를 호출합니다. 이 메서드는 지원 중단되었습니다. 계속 사용할 경우 기본 메서드를 직접 호출하게 됩니다. @@ -77,9 +82,9 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(false); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 세분화된 정보 전송 \{\#send\-granular\-information\} +### 세분화된 정보 전송 {#send-granular-information} - + ```ts public addGranularOption(partnerName: string, @@ -87,15 +92,15 @@ public addGranularOption(partnerName: string, value: string) ``` - + 서드파티 공유 설정 변경 시 세부 정보를 추가할 수 있습니다. 이를 통해 사용자의 결정에 대한 더욱 자세한 정보를 전달할 수 있습니다. 다음 파라미터와 함께 `addGranularOption` 메서드를 호출합니다. -* `partnerName` \(`string`\): 세분화 옵션을 적용할 파트너의 이름 -* `key` \(`string`\): 옵션 키 -* `value` \(`string`\): 옵션 값 +- `partnerName` \(`string`\): 세분화 옵션을 적용할 파트너의 이름 +- `key` \(`string`\): 옵션 키 +- `value` \(`string`\): 옵션 값 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -103,34 +108,37 @@ options.addGranularOption("PartnerA", "foo", "bar"); Adjust.trackThirdPartySharing(options); ``` -URL 전략 \{\#url\-strategy\} ------------------------------- +## URL 전략 \{\#url\-strategy\} - +{" "} URL 전략 기능을 사용하여 다음을 설정할 수 있습니다. -* Adjust가 귀하의 데이터를 저장하는 국가\(데이터 레지던시\). -* Adjust SDK가 트래픽을 전송하는 엔드포인트\(맞춤 URL\). +- Adjust가 귀하의 데이터를 저장하는 국가\(데이터 레지던시\). +- Adjust SDK가 트래픽을 전송하는 엔드포인트\(맞춤 URL\). 본 기능은 프라이버시 요건이 엄격한 나라에서 앱을 운영하는 경우에 유용합니다. URL 전략을 설정하면 Adjust가 선택된 데이터 레지던시 지역에 데이터를 저장하거나 선택된 도메인으로 트래픽을 전송합니다. URL 전략을 구성하려면 `Adjust.initSdk` 인스턴스에 `urlStrategy` 의 다음 속성을 설정합니다. -* `domains` \(`Array`\): SDK 트래픽을 전송할 데이터 레지던스 국가 또는 엔드포인트. 기본 설정에 따라 Adjust SDK는 모든 데이터를 Adjust의 엔드포인트로 전송합니다. 커스텀 엔드포인트를 설정하려면 `urlStrategy`의 `domains` 속성에 엔드포인트를 전달합니다. -* `useSubdomains` \(`boolean`\): 도메인을 Adjust 도메인으로 취급할지 여부. - * `true`인 경우 SDK는 도메인의 접두사로 Adjust에 특화된 하위 도메인을 사용합니다. - * `false`인 경우 SDK는 접두사 없이 제공된 도메인을 그대로 사용합니다. +- `domains` \(`Array`\): SDK 트래픽을 전송할 데이터 레지던스 국가 또는 엔드포인트. 기본 설정에 따라 Adjust SDK는 모든 데이터를 Adjust의 엔드포인트로 전송합니다. 커스텀 엔드포인트를 설정하려면 `urlStrategy`의 `domains` 속성에 엔드포인트를 전달합니다. +- `useSubdomains` \(`boolean`\): 도메인을 Adjust 도메인으로 취급할지 여부. + + - `true`인 경우 SDK는 도메인의 접두사로 Adjust에 특화된 하위 도메인을 사용합니다. + - `false`인 경우 SDK는 접두사 없이 제공된 도메인을 그대로 사용합니다. -* `isDataResidency` \(`boolean`\): 선택 사항으로, 도메인을 데이터 레지던시에 사용해야 하는지 여부입니다. +- `isDataResidency` \(`boolean`\): 선택 사항으로, 도메인을 데이터 레지던시에 사용해야 하는지 여부입니다. 다음 표는 구성 목록을 보여줍니다. -| URL 전략 | 기본 도메인 및 커스텀 도메인 | 하위 도메인 사용 | 데이터 레지던시 | -|-------------|-------------------------------|-----------|----------| -| EU 데이터 레지던시 | `"eu.adjust.com"` | `true` | `true` | -| 중국 URL 전략 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | -| 맞춤 URL 전략 | `"my.custom.domain"` | `false` | `false` | +| URL 전략 | 기본 도메인 및 커스텀 도메인 | 하위 도메인 사용 | 데이터 레지던시 | +| ------------------ | ----------------------------- | ---------------- | --------------- | +| EU 데이터 레지던시 | `"eu.adjust.com"` | `true` | `true` | +| 중국 URL 전략 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | +| 맞춤 URL 전략 | `"my.custom.domain"` | `false` | `false` | ```js Adjust.initSdk({ @@ -145,12 +153,16 @@ Adjust.initSdk({ }); ``` -### 커스텀 엔드포인트 설정\(지원 중단\) \{\#set\-custom\-endpoint\} +### 커스텀 엔드포인트 설정\(지원 중단\) {#set-custom-endpoint} - +{" "} 이전 버전의 SDK는 지원 중단된 `customUrl` 속성을 사용하여 엔드포인트를 전달했습니다. 대신 `urlStrategy` 구성을 사용하시기 바랍니다. - + + ```js Adjust.initSdk({ @@ -166,14 +178,18 @@ Adjust.initSdk({ }); ``` - + -### 데이터 레지던시\(지원 중단\) \{\#data\-residency\} +### 데이터 레지던시\(지원 중단\) {#data-residency} - +{" "} 이전 버전의 SDK는 지원 중단된 `dataResidency` 속성을 사용했습니다. 대신 `urlStrategy` 구성을 사용하시기 바랍니다. - + + ```js Adjust.initSdk({ @@ -190,4 +206,3 @@ Adjust.initSdk({ ``` - diff --git a/src/content/docs/ko/sdk/web/index.mdx b/src/content/docs/ko/sdk/web/index.mdx index fe0e06df44..0e2a313b23 100644 --- a/src/content/docs/ko/sdk/web/index.mdx +++ b/src/content/docs/ko/sdk/web/index.mdx @@ -1,91 +1,271 @@ --- -title: "Web SDK integration guide" -description: "Use the Web SDK to access Adjust's features in your web apps" -category-title: "Web SDK" -slug: "en/sdk/web" +title: Web SDK integration guide +description: Use the Web SDK to access Adjust's features in your web apps +category-title: Web SDK +slug: ko/sdk/web sidebar-position: 8 --- + Adjust 웹 SDK를 사용하면 웹 앱에서 어트리뷰션, 이벤트 및 기타 데이터를 기록할 수 있습니다. 이 가이드에서는 SDK를 앱과 연동하는 방법을 설명합니다. - + + 웹 SDK를 사용하려면 Adjust 대시보드에서 지원 중단된 웹 앱을 생성하고 그 둘을 연결해야 합니다. 웹 SDK를 모바일 앱 SDK가 이미 포함된 모바일 앱과 연동해서는 안 됩니다. - -1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} -------------------------------------------------------------------------------- + + +## 1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} 시작하려면 웹 앱에 SDK를 추가합니다. Adjust SDK는 CommonJS와 AMD\(비동기 모듈 정의\) 환경에서 모두 작동합니다. CDN\(콘텐츠 전송 네트워크\)을 통해 로딩될 때 글로벌 `Adjust` 네임스페이스를 통해 액세스할 수 있습니다. -### Using a CDN \{\#using\-a\-cdn\} +### Using a CDN {#using-a-cdn} CDN을 통해 SDK를 로딩할 때 프로덕션 빌드에 간소화된 버전을 사용해야 합니다. -* 다음과 같이 CDN 대상에 추가하여 특정 버전을 로드할 수 있습니다. `https://cdn.adjust.com/adjust-5.7.0.min.js` -* 최신 버전을 로드하려면 다음과 같이 `adjust-latest` 패키지를 사용합니다. `https://cdn.adjust.com/adjust-latest.min.js` 이 패키지는 자동으로 업데이트되므로 대상 파일을 변경할 필요가 없습니다. +- 다음과 같이 CDN 대상에 추가하여 특정 버전을 로드할 수 있습니다. `https://cdn.adjust.com/adjust-5.7.0.min.js` +- 최신 버전을 로드하려면 다음과 같이 `adjust-latest` 패키지를 사용합니다. `https://cdn.adjust.com/adjust-latest.min.js` 이 패키지는 자동으로 업데이트되므로 대상 파일을 변경할 필요가 없습니다. - + The SDK files are cached to enable fast service. This cache updates every 30 minutes. If you want to force an update to the latest version, target a specific version in your header. - -CDN을 통해 SDK를 로드하려면 웹 앱의 `` 요소 안에 다음 스니펫을 추가합니다. + + +CDN을 통해 SDK를 로드하려면 웹 앱의 `` 요소 안에 다음 스니펫을 추가합니다. \{/\* prettier\-ignore \*/\} ```html - ``` The Adjust SDK loads on each page and initiates once per page load. -#### Subresource Integrity \{\#subresource\-integrity\} +#### Subresource Integrity {#subresource-integrity} [하위 리소스 무결성](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) 검사를 사용하여 XSS\(사이트 간 스크립팅\) 공격을 완화할 수 있습니다. 패키지를 실행하기 전에 검증하려면 다음 콜\(추가 `crossOrigin`, `integrity`, 인코딩된 해시 확인\)을 사용합니다. \{/\* prettier\-ignore \*/\} ```html - ``` -### Using npm \{\#using\-npm\} +### Using npm {#using-npm} The Adjust SDK is also available on [npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk). To add the package to your project, use your preferred package manager: - + + + ```console $ npm install @adjustcom/adjust-web-sdk --save ``` - + + ```console $ yarn add @adjustcom/adjust-web-sdk ``` - + + ```console $ pnpm add @adjustcom/adjust-web-sdk ``` - + + -2\. Initialize the SDK \{\#initialize\-the\-sdk\} -------------------------------------------------------- +## 2\. Initialize the SDK \{\#initialize\-the\-sdk\} SDK를 설치한 후에는 초기화해야 합니다. 해당 기능 사용을 원하는 경우 `initSdk` 메서드를 호출합니다. 이 메서드는 앱에서 SDK가 작동하는 방식을 사용자 지정하는 데 사용할 수 있는 인수를 제공합니다. SDK를 시작하려면 다음 인수를 `initSdk` 호출에 추가해야 합니다. -* `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/en/article/app-token-and-reporting-currency#view-your-app-details). -* `environment` \(`string`\): SDK를 실행할 환경입니다. - * 테스트 모드에서 SDK를 실행하려면 `sandbox` 를 전달합니다. - * 릴리즈를 위해 프로덕션 모드에서 SDK를 실행하려면 `production` 을 전달합니다. +- `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/ko/article/app-token-and-reporting-currency#view-your-app-details). +- `environment` \(`string`\): SDK를 실행할 환경입니다. + - 테스트 모드에서 SDK를 실행하려면 `sandbox` 를 전달합니다. + - 릴리즈를 위해 프로덕션 모드에서 SDK를 실행하려면 `production` 을 전달합니다. ```js Adjust.initSdk({ @@ -94,8 +274,8 @@ Adjust.initSdk({ }); ``` - + -[구성 가이드](/en/sdk/web/configuration)에서 Adjust 웹 SDK의 전체 인수 및 속성 목록을 확인하실 수 있습니다. - +[구성 가이드](/ko/sdk/web/configuration)에서 Adjust 웹 SDK의 전체 인수 및 속성 목록을 확인하실 수 있습니다. + diff --git a/src/content/docs/zh/sdk/web/features/attribution.mdx b/src/content/docs/zh/sdk/web/features/attribution.mdx index 26db7c7244..4fedcc3602 100644 --- a/src/content/docs/zh/sdk/web/features/attribution.mdx +++ b/src/content/docs/zh/sdk/web/features/attribution.mdx @@ -1,12 +1,14 @@ --- -title: "获取归因信息" -description: "使用 Adjust SDK 监听归因变化" -slug: "en/sdk/web/features/attribution" +title: 获取归因信息 +description: 使用 Adjust SDK 监听归因变化 +slug: zh/sdk/web/features/attribution --- -用户与 Adjust 链接交互时，其归因信息会发生更新。用户与[深度链接](https://help.adjust.com/en/article/deep-links)交互时可能会发生这种情况。用户归因相关信息会在归因对象中展现。 + +用户与 Adjust 链接交互时，其归因信息会发生更新。用户与[深度链接](https://help.adjust.com/zh/article/deep-links)交互时可能会发生这种情况。用户归因相关信息会在归因对象中展现。 归因对象包含下列信息： - + + ```js export type AttributionMapT = $ReadOnly<{| @@ -22,30 +24,29 @@ export type AttributionMapT = $ReadOnly<{| |}>; ``` - + -| 值 | 数据类型 | 描述 | -|-----------------|----------|------------------------------------------------------------------------| -| `adid` | `string` | 设备的唯一 Adjust 标识符。 | -| `tracker_token` | `string` | 与归因关联的链接识别码。 | -| `tracker_name` | `string` | 推广活动链接名称 | -| `network` | `string` | 与推广活动关联的渠道。 | -| `campaign` | `string` | 与归因关联的推广活动名称。 | -| `adgroup` | `string` | 与归因关联的广告组。 | -| `creative` | `string` | 与归因关联的素材。 | -| `click_label` | `string` | 与归因关联的 [click label](https://help.adjust.com/en/article/user-rewards)。 | -| `state` | `string` | 当前归因状态。`installed` 或 `reattributed` | +| 值 | 数据类型 | 描述 | +| --------------- | -------- | ----------------------------------------------------------------------------- | +| `adid` | `string` | 设备的唯一 Adjust 标识符。 | +| `tracker_token` | `string` | 与归因关联的链接识别码。 | +| `tracker_name` | `string` | 推广活动链接名称 | +| `network` | `string` | 与推广活动关联的渠道。 | +| `campaign` | `string` | 与归因关联的推广活动名称。 | +| `adgroup` | `string` | 与归因关联的广告组。 | +| `creative` | `string` | 与归因关联的素材。 | +| `click_label` | `string` | 与归因关联的 [click label](https://help.adjust.com/zh/article/user-rewards)。 | +| `state` | `string` | 当前归因状态。`installed` 或 `reattributed` | -发生归因变化时触发回传\{\#trigger\-a\-callback\-when\-attribution\-changes\} -------------------------------------------------------------------------- +## 发生归因变化时触发回传\{\#trigger\-a\-callback\-when\-attribution\-changes\} - + ```js attributionCallback: (string, Object) => mixed; ``` - + SDK 可监听归因变更并在发现更新时调用一个函数。您可以在 `initSdk` 方法中指定一个 `attributionCallback` 函数，来设置归因回传方法。在函数内，您可以访问用户归因信息。 @@ -67,10 +68,12 @@ Adjust.initSdk({ }); ``` -获取当前归因信息\{\#get\-current\-attribution\-information\} ----------------------------------------------------------- +## 获取当前归因信息\{\#get\-current\-attribution\-information\} - +{" "} 用户安装您的应用时，Adjust 会将该安装归因至一个推广活动。Adjust SDK 可提供赢得安装归因的推广活动细节。`waitForAttribution`方法会返回一个`promise`，当 SDK 成功从服务器接收到归因数据时，该 promise 会被完成。 @@ -80,29 +83,30 @@ Adjust.waitForAttribution().then((attr) => ); ``` -设置 referrer \{\#set\-a\-referrer\} ---------------------------------------- +## 设置 referrer \{\#set\-a\-referrer\} - + ```js function setReferrer(referrer: string): void; ``` - + 您可以创建一个 referrer，来在 SDK 启动后触发带有自定义点击 ID 的 SDK 点击。SDK 会将您的自定义点击 ID 发送到 Adjust 服务器用于归因。 - + + 在尽可能靠近 SDK 初始化的节点调用此方法，确保您的 referrer 被用于归因。 - + + 要设置 referrer，请调用 `setReferrer` 方法并以 URL 编码 `string` 参数的形式传递 referrer。 - + + ```js Adjust.setReferrer("adjust_external_click_id%3DEXTERNAL_CLICK_ID"); ``` - diff --git a/src/content/docs/zh/sdk/web/features/device-info.mdx b/src/content/docs/zh/sdk/web/features/device-info.mdx index 96ceefac89..9740d2ca9d 100644 --- a/src/content/docs/zh/sdk/web/features/device-info.mdx +++ b/src/content/docs/zh/sdk/web/features/device-info.mdx @@ -1,14 +1,17 @@ --- -title: "获取设备信息" -description: "用这些方法来向回传添加细节信息，优化报告。" -slug: "en/sdk/web/features/device-info" +title: 获取设备信息 +description: 用这些方法来向回传添加细节信息，优化报告。 +slug: zh/sdk/web/features/device-info --- + Adjust SDK 包含能够返回设备信息的辅助方法。用这些方法来向回传添加细节信息，优化报告。 -Web UUID \{\#web\-uuid\} ----------------------------- +## Web UUID \{\#web\-uuid\} - +{" "} 为在 Adjust 中识别网页用户，Adjust Web SDK 会在发送第一次会话时生成唯一的 `web_uuid` 标识符。该标识符采用通用唯一标识符 \(UUID\) 格式。 @@ -19,4 +22,3 @@ Web UUID \{\#web\-uuid\} ```js Adjust.waitForWebUUID().then((webUuid) => console.log(webUuid)); ``` - diff --git a/src/content/docs/zh/sdk/web/features/privacy.mdx b/src/content/docs/zh/sdk/web/features/privacy.mdx index 8979273d83..4a61eb625e 100644 --- a/src/content/docs/zh/sdk/web/features/privacy.mdx +++ b/src/content/docs/zh/sdk/web/features/privacy.mdx @@ -1,42 +1,44 @@ --- -title: "设置隐私功能" -description: "配置处理应用用户隐私的功能。" -slug: "en/sdk/web/features/privacy" +title: 设置隐私功能 +description: 配置处理应用用户隐私的功能。 +slug: zh/sdk/web/features/privacy --- + Adjust SDK 包含处理应用用户隐私的功能。 -发送删除请求\{\#send\-erasure\-request\} ---------------------------------------- +## 发送删除请求\{\#send\-erasure\-request\} - + ```js function gdprForgetMe(): void; ``` - + -在处理个人数据方面，欧盟的《通用数据保护条例》\(GDPR\) 和全球类似的隐私法律 \(CCPA、LGPD 等\) 授予数据主体完全权利，其中包括删除权 \([参见 GDPR 第 17](https://gdpr.eu/article-17-right-to-be-forgotten/)条\)\( [1](https://help.adjust.com/en/article/gdpr#ref-1) \)。作为数据处理方，Adjust 有义务支持您 \(数据控制方\) 处理来自应用用户的此类请求。 +在处理个人数据方面，欧盟的《通用数据保护条例》\(GDPR\) 和全球类似的隐私法律 \(CCPA、LGPD 等\) 授予数据主体完全权利，其中包括删除权 \([参见 GDPR 第 17](https://gdpr.eu/article-17-right-to-be-forgotten/)条\)\( [1](https://help.adjust.com/zh/article/gdpr#ref-1) \)。作为数据处理方，Adjust 有义务支持您 \(数据控制方\) 处理来自应用用户的此类请求。 您可以通过调用 `gdprForgetMe` 方法来将用户的删除请求发送至 Adjust 服务器。收到通知后： -* 我们将从内部系统和数据库中永久删除用户的所有历史个人数据； -* 此外，Adjust 将不再通过 Adjust SDK 接收来自该用户/设备的数据。 \( [2](https://help.adjust.com/en/article/gdpr#ref-2) \) +- 我们将从内部系统和数据库中永久删除用户的所有历史个人数据； +- 此外，Adjust 将不再通过 Adjust SDK 接收来自该用户/设备的数据。 \( [2](https://help.adjust.com/zh/article/gdpr#ref-2) \) ```js Adjust.gdprForgetMe(); ``` -针对特定用户的第三方分享\{\#third\-party\-sharing\-for\-specific\-users\} ---------------------------------------------------------------------- +## 针对特定用户的第三方分享\{\#third\-party\-sharing\-for\-specific\-users\} - +{" "} 您可以使用 Adjust SDK 来记录用户对第三方数据分享设置的变更。请使用 `ThirdPartySharing` 类配置第三方数据分享。 -### 实例化 AdjustThirdPartySharing 对象\{\#instantiate\-an\-adjustthirdpartysharing\-object\} +### 实例化 AdjustThirdPartySharing 对象{#instantiate-an-adjustthirdpartysharing-object} - + ```ts class ThirdPartySharing { @@ -45,13 +47,13 @@ class ThirdPartySharing { } ``` - + 要启用或禁用 Adjust SDK 第三方数据分享，请实例化 `ThirdPartySharing` 对象。该对象包含控制 Adjust 如何处理第三方分享的变量。 要进行实例化，请创建新的 `ThirdPartySharing` 实例，并传递下列参数： -* `isEnabled` \( `boolean` \): 传递`true`来启用第三方分享或传递`false`来禁用第三方分享。 +- `isEnabled` \( `boolean` \): 传递`true`来启用第三方分享或传递`false`来禁用第三方分享。 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -66,9 +68,12 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 禁用第三方分享 \(已弃用\) \{\#disable\-third\-party\-sharing\} +### 禁用第三方分享 \(已弃用\) {#disable-third-party-sharing} - +{" "} 如需在之前版本的 SDK 中禁用第三方数据分享，请调用`disableThirdPartySharing`方法。此方法已被弃用。如果您仍在使用，请注意它会直接调用基础方法。 @@ -77,9 +82,9 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(false); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 发送精细信息\{\#send\-granular\-information\} +### 发送精细信息{#send-granular-information} - + ```ts public addGranularOption(partnerName: string, @@ -87,15 +92,15 @@ public addGranularOption(partnerName: string, value: string) ``` - + 当用户更新第三方数据分享设置时，您可以附加较精细的信息，以此发送用户决定的更多细节。 使用下列参数调用`addGranularOption`方法： -* `partnerName` \(`string`\)：使用精细设置的合作伙伴的名称。 -* `key` \(`string`\)：选项 key。 -* `value` \(`string`\)：选项值。 +- `partnerName` \(`string`\)：使用精细设置的合作伙伴的名称。 +- `key` \(`string`\)：选项 key。 +- `value` \(`string`\)：选项值。 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -103,34 +108,37 @@ options.addGranularOption("PartnerA", "foo", "bar"); Adjust.trackThirdPartySharing(options); ``` -URL 策略\{\#url\-strategy\} ------------------------------ +## URL 策略\{\#url\-strategy\} - +{" "} 通过 URL 策略功能，您可以进行下列设置： -* Adjust 储存您数据的国家/地区 \(即数据驻留\)。 -* 接收 Adjust SDK 所发送流量的终端 \(自定义 URL \)。 +- Adjust 储存您数据的国家/地区 \(即数据驻留\)。 +- 接收 Adjust SDK 所发送流量的终端 \(自定义 URL \)。 当应用运营的国家拥有严格的隐私规定时，此功能会非常有用。在您设置 URL 策略时，Adjust 会将数据储存在指定数据驻留地区，或将流量发送至选定域名。 要配置 URL 策略，请在`Adjust.initSdk`实例中设置`urlStrategy`的以下属性： -* `domains` \(`Array`\)：接收您所发送 SDK 流量的数据驻留国家/地区或终端。默认情况下，Adjust SDK 会将所有数据都发送至 Adjust 终端。如果您想设置自定义终端，请在`urlStrategy`的`domains`属性中传递。 -* `useSubdomains` \(`boolean`\): 域名是否应被视为 Adjust 域名。 - * 如果为`true`，则 SDK 会在域名中添加 Adjust 特定子域作为前缀。 - * 如果为`false`，SDK 会按原样使用所提供的域名，不包含前缀。 +- `domains` \(`Array`\)：接收您所发送 SDK 流量的数据驻留国家/地区或终端。默认情况下，Adjust SDK 会将所有数据都发送至 Adjust 终端。如果您想设置自定义终端，请在`urlStrategy`的`domains`属性中传递。 +- `useSubdomains` \(`boolean`\): 域名是否应被视为 Adjust 域名。 + + - 如果为`true`，则 SDK 会在域名中添加 Adjust 特定子域作为前缀。 + - 如果为`false`，SDK 会按原样使用所提供的域名，不包含前缀。 -* `isDataResidency` \( `boolean` \)：可选。域名是否应被用于数据驻留。 +- `isDataResidency` \( `boolean` \)：可选。域名是否应被用于数据驻留。 下表展示了一系列配置。 -| URL 策略 | 默认和自定义域名 | 使用子域名 | 数据驻留 | -|------------|-------------------------------|---------|---------| -| 欧盟数据驻留 | `"eu.adjust.com"` | `true` | `true` | -| 中国 URL 策略 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | -| 自定义 URL 策略 | `"my.custom.domain"` | `false` | `false` | +| URL 策略 | 默认和自定义域名 | 使用子域名 | 数据驻留 | +| --------------- | ----------------------------- | ---------- | -------- | +| 欧盟数据驻留 | `"eu.adjust.com"` | `true` | `true` | +| 中国 URL 策略 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | +| 自定义 URL 策略 | `"my.custom.domain"` | `false` | `false` | ```js Adjust.initSdk({ @@ -145,12 +153,16 @@ Adjust.initSdk({ }); ``` -### 设置自定义终端 \(已弃用\) \{\#set\-custom\-endpoint\} +### 设置自定义终端 \(已弃用\) {#set-custom-endpoint} - +{" "} 之前版本的 SDK 使用`customUrl`属性传递终端，该属性已被弃用。请改用`urlStrategy`配置。 - + + ```js Adjust.initSdk({ @@ -166,14 +178,18 @@ Adjust.initSdk({ }); ``` - + -### 数据驻留 \(已弃用\) \{\#data\-residency\} +### 数据驻留 \(已弃用\) {#data-residency} - +{" "} 之前版本的 SDK 使用的是`dataResidency`属性，该属性已被弃用。请改用`urlStrategy`配置。 - + + ```js Adjust.initSdk({ @@ -190,4 +206,3 @@ Adjust.initSdk({ ``` - diff --git a/src/content/docs/zh/sdk/web/index.mdx b/src/content/docs/zh/sdk/web/index.mdx index 087e6f0c5f..13af544db8 100644 --- a/src/content/docs/zh/sdk/web/index.mdx +++ b/src/content/docs/zh/sdk/web/index.mdx @@ -1,91 +1,271 @@ --- -title: "Web SDK integration guide" -description: "Use the Web SDK to access Adjust's features in your web apps" -category-title: "Web SDK" -slug: "en/sdk/web" +title: Web SDK integration guide +description: Use the Web SDK to access Adjust's features in your web apps +category-title: Web SDK +slug: zh/sdk/web sidebar-position: 8 --- + 通过 Adjust Web SDK，您可以在网页应用中记录归因、事件以及更多数据。该指南展示了如何将该 SDK 集成至应用。 - + + 要使用 Web SDK，您必须在 Adjust 控制面板中创建专用的网页应用并将两者关联起来。请勿将 Web SDK 集成到已经包含移动应用 SDK 的移动应用中。 - -1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} -------------------------------------------------------------------------------- + + +## 1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} 要开始设置，请将 SDK 添加至网页应用。Adjust SDK 可在 CommonJS 和 AMD \(Asynchronous Module Definition\) 环境中运行。通过 CDN \(内容分发网络\) 加载时，您可以通过全局`Adjust`命名空间对其进行访问。 -### Using a CDN \{\#using\-a\-cdn\} +### Using a CDN {#using-a-cdn} 通过 CDN 加载 SDK 时，您应该在生产环境中使用压缩版本。 -* 您可以通过添加一个版本至 CDN 目标来加载指定版本，如下所示：`https://cdn.adjust.com/adjust-5.7.0.min.js`。 -* 要加载最新版本，请使用`adjust-latest`包，如下所示：`https://cdn.adjust.com/adjust-latest.min.js`。该包会自动更新，您无需更改目标文件。 +- 您可以通过添加一个版本至 CDN 目标来加载指定版本，如下所示：`https://cdn.adjust.com/adjust-5.7.0.min.js`。 +- 要加载最新版本，请使用`adjust-latest`包，如下所示：`https://cdn.adjust.com/adjust-latest.min.js`。该包会自动更新，您无需更改目标文件。 - + The SDK files are cached to enable fast service. This cache updates every 30 minutes. If you want to force an update to the latest version, target a specific version in your header. - -要通过 CDN 加载 SDK，请将以下代码片段加入网页应用的``元素中： + + +要通过 CDN 加载 SDK，请将以下代码片段加入网页应用的``元素中： \{/\* prettier\-ignore \*/\} ```html - ``` The Adjust SDK loads on each page and initiates once per page load. -#### Subresource Integrity \{\#subresource\-integrity\} +#### Subresource Integrity {#subresource-integrity} 请使用[子资源完整性](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity)检查来抵御 XSS \(跨站脚本\) 攻击。要在运行包之前对其进行验证，请使用以下调用 \(请注意额外的`crossOrigin` 、 `integrity`和经过编码的哈希值\): \{/\* prettier\-ignore \*/\} ```html - ``` -### Using npm \{\#using\-npm\} +### Using npm {#using-npm} The Adjust SDK is also available on [npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk). To add the package to your project, use your preferred package manager: - + + + ```console $ npm install @adjustcom/adjust-web-sdk --save ``` - + + ```console $ yarn add @adjustcom/adjust-web-sdk ``` - + + ```console $ pnpm add @adjustcom/adjust-web-sdk ``` - + + -2\. Initialize the SDK \{\#initialize\-the\-sdk\} -------------------------------------------------------- +## 2\. Initialize the SDK \{\#initialize\-the\-sdk\} 安装 SDK 后，需要进行初始化。为此，请调用`initSdk`方法。您可以使用该方法中的参数来自定义 SDK 在应用中的工作方式。 要初始化 SDK，您必须将以下参数添加至`initSdk`调用： -* `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/en/article/app-token-and-reporting-currency#view-your-app-details). -* `environment` \(`string`\)：SDK 运行的环境。 - * 传递`sandbox`来在测试模式下运行 SDK。 - * 传递 `production`来在生产模式下运行 SDK，方便发布。 +- `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/zh/article/app-token-and-reporting-currency#view-your-app-details). +- `environment` \(`string`\)：SDK 运行的环境。 + - 传递`sandbox`来在测试模式下运行 SDK。 + - 传递 `production`来在生产模式下运行 SDK，方便发布。 ```js Adjust.initSdk({ @@ -94,8 +274,8 @@ Adjust.initSdk({ }); ``` - + -您可以在[配置指南](/en/sdk/web/configuration)中找到 Adjust Web SDK 参数和属性的完整列表。 - +您可以在[配置指南](/zh/sdk/web/configuration)中找到 Adjust Web SDK 参数和属性的完整列表。 + From 31963d26501b7abd6a54acc265714da9ef54bded Mon Sep 17 00:00:00 2001 From: github-actions <41898282+github-actions[bot]@users.noreply.github.com> Date: Thu, 9 Jan 2025 12:55:39 +0000 Subject: [PATCH 27/42] Fix translated and formatted files --- src/content/docs/ja/sdk/web/features/attribution.mdx | 6 +++--- src/content/docs/ja/sdk/web/features/device-info.mdx | 2 +- src/content/docs/ja/sdk/web/features/privacy.mdx | 6 +++--- src/content/docs/ja/sdk/web/index.mdx | 4 ++-- src/content/docs/ko/sdk/web/features/attribution.mdx | 6 +++--- src/content/docs/ko/sdk/web/features/device-info.mdx | 2 +- src/content/docs/ko/sdk/web/features/privacy.mdx | 6 +++--- src/content/docs/ko/sdk/web/index.mdx | 4 ++-- src/content/docs/zh/sdk/web/features/attribution.mdx | 6 +++--- src/content/docs/zh/sdk/web/features/device-info.mdx | 2 +- src/content/docs/zh/sdk/web/features/privacy.mdx | 6 +++--- src/content/docs/zh/sdk/web/index.mdx | 4 ++-- 12 files changed, 27 insertions(+), 27 deletions(-) diff --git a/src/content/docs/ja/sdk/web/features/attribution.mdx b/src/content/docs/ja/sdk/web/features/attribution.mdx index bda772281b..383955a17d 100644 --- a/src/content/docs/ja/sdk/web/features/attribution.mdx +++ b/src/content/docs/ja/sdk/web/features/attribution.mdx @@ -38,7 +38,7 @@ export type AttributionMapT = $ReadOnly<{| | `click_label` | `string` | アトリビューションに関連付けられている[クリックラベル](https://help.adjust.com/ja/article/user-rewards) | | `state` | `string` | アトリビューションの現在のステータス。`installed`または `reattributed` | -## アトリビューションの変更時にコールバックをトリガーする \{\#trigger\-a\-callback\-when\-attribution\-changes\} +## アトリビューションの変更時にコールバックをトリガーする {#trigger-a-callback-when-attribution-changes} @@ -68,7 +68,7 @@ Adjust.initSdk({ }); ``` -## 現在のアトリビューション情報を取得する \{\#get\-current\-attribution\-information\} +## 現在のアトリビューション情報を取得する {#get-current-attribution-information} ); ``` -## リファラーを設定する \{\#set\-a\-referrer\} +## リファラーを設定する {#set-a-referrer} diff --git a/src/content/docs/ja/sdk/web/features/device-info.mdx b/src/content/docs/ja/sdk/web/features/device-info.mdx index 90fe7f040b..d44b28783e 100644 --- a/src/content/docs/ja/sdk/web/features/device-info.mdx +++ b/src/content/docs/ja/sdk/web/features/device-info.mdx @@ -6,7 +6,7 @@ slug: ja/sdk/web/features/device-info Adjust SDKには、デバイス情報を返すヘルパーメソッドが含まれています。これらのメソッドを使用することでコールバックに詳細を追加し、レポートを改善させましょう。 -## Web UUID \{\#web\-uuid\} +## Web UUID {#web-uuid} @@ -27,7 +27,7 @@ EUの一般データ保護規則（GDPR）および類似する世界的なプ Adjust.gdprForgetMe(); ``` -## 特定のユーザーの情報をサードパーティと共有する \{\#third\-party\-sharing\-for\-specific\-users\} +## 特定のユーザーの情報をサードパーティと共有する {#third-party-sharing-for-specific-users} -## 1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} +## 1\. Add the SDK to your project {#add-the-sdk-to-your-project} まずは、WebアプリにSDKを追加します。Adjust SDKは、CommonJSとAMD（Asynchronous Module Definition）の両方の環境で動作します。CDN（Content Delivery Network）を利用して読み込むと、グローバルの`Adjust`名前空間を介してアクセスできます。 @@ -256,7 +256,7 @@ $ pnpm add @adjustcom/adjust-web-sdk -## 2\. Initialize the SDK \{\#initialize\-the\-sdk\} +## 2\. Initialize the SDK {#initialize-the-sdk} SDKをインストールしたら初期化する必要があります。これを行うには、`initSdk`メソッドを呼び出してください。このメソッドには、アプリでのSDKの動作をカスタマイズするために使用できる引数があります。 diff --git a/src/content/docs/ko/sdk/web/features/attribution.mdx b/src/content/docs/ko/sdk/web/features/attribution.mdx index 1bf5764cf4..4961b6879e 100644 --- a/src/content/docs/ko/sdk/web/features/attribution.mdx +++ b/src/content/docs/ko/sdk/web/features/attribution.mdx @@ -38,7 +38,7 @@ export type AttributionMapT = $ReadOnly<{| | `click_label` | `string` | 어트리뷰션과 관련된 [클릭 레이블](https://help.adjust.com/ko/article/user-rewards). | | `state` | `string` | 어트리뷰션의 현재 상태. `installed` 또는 `reattributed` | -## 어트리뷰션 변경 시 콜백 트리거 \{\#trigger\-a\-callback\-when\-attribution\-changes\} +## 어트리뷰션 변경 시 콜백 트리거 {#trigger-a-callback-when-attribution-changes} @@ -68,7 +68,7 @@ Adjust.initSdk({ }); ``` -## 현재 어트리뷰션 정보 확인 \{\#get\-current\-attribution\-information\} +## 현재 어트리뷰션 정보 확인 {#get-current-attribution-information} ); ``` -## 리퍼러 설정 \{\#set\-a\-referrer\} +## 리퍼러 설정 {#set-a-referrer} diff --git a/src/content/docs/ko/sdk/web/features/device-info.mdx b/src/content/docs/ko/sdk/web/features/device-info.mdx index a9c803a888..332eeedd0d 100644 --- a/src/content/docs/ko/sdk/web/features/device-info.mdx +++ b/src/content/docs/ko/sdk/web/features/device-info.mdx @@ -6,7 +6,7 @@ slug: ko/sdk/web/features/device-info Adjust SDK는 디바이스 정보를 반환하는 헬프 메서드가 포함되어 있습니다. 해당 메서드를 사용하여 콜백에 세부 정보를 추가하고 리포트를 보완하시기 바랍니다. -## Web UUID \{\#web\-uuid\} +## Web UUID {#web-uuid} @@ -27,7 +27,7 @@ EU의 개인정보 보호 규정\(GDPR\) 및 기타 개인정보 보호법\(CCPA Adjust.gdprForgetMe(); ``` -## 특정 사용자에 대한 서드파티 공유 \{\#third\-party\-sharing\-for\-specific\-users\} +## 특정 사용자에 대한 서드파티 공유 {#third-party-sharing-for-specific-users} -## 1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} +## 1\. Add the SDK to your project {#add-the-sdk-to-your-project} 시작하려면 웹 앱에 SDK를 추가합니다. Adjust SDK는 CommonJS와 AMD\(비동기 모듈 정의\) 환경에서 모두 작동합니다. CDN\(콘텐츠 전송 네트워크\)을 통해 로딩될 때 글로벌 `Adjust` 네임스페이스를 통해 액세스할 수 있습니다. @@ -256,7 +256,7 @@ $ pnpm add @adjustcom/adjust-web-sdk -## 2\. Initialize the SDK \{\#initialize\-the\-sdk\} +## 2\. Initialize the SDK {#initialize-the-sdk} SDK를 설치한 후에는 초기화해야 합니다. 해당 기능 사용을 원하는 경우 `initSdk` 메서드를 호출합니다. 이 메서드는 앱에서 SDK가 작동하는 방식을 사용자 지정하는 데 사용할 수 있는 인수를 제공합니다. diff --git a/src/content/docs/zh/sdk/web/features/attribution.mdx b/src/content/docs/zh/sdk/web/features/attribution.mdx index 4fedcc3602..b23d387dda 100644 --- a/src/content/docs/zh/sdk/web/features/attribution.mdx +++ b/src/content/docs/zh/sdk/web/features/attribution.mdx @@ -38,7 +38,7 @@ export type AttributionMapT = $ReadOnly<{| | `click_label` | `string` | 与归因关联的 [click label](https://help.adjust.com/zh/article/user-rewards)。 | | `state` | `string` | 当前归因状态。`installed` 或 `reattributed` | -## 发生归因变化时触发回传\{\#trigger\-a\-callback\-when\-attribution\-changes\} +## 发生归因变化时触发回传{#trigger-a-callback-when-attribution-changes} @@ -68,7 +68,7 @@ Adjust.initSdk({ }); ``` -## 获取当前归因信息\{\#get\-current\-attribution\-information\} +## 获取当前归因信息{#get-current-attribution-information} ); ``` -## 设置 referrer \{\#set\-a\-referrer\} +## 设置 referrer {#set-a-referrer} diff --git a/src/content/docs/zh/sdk/web/features/device-info.mdx b/src/content/docs/zh/sdk/web/features/device-info.mdx index 9740d2ca9d..aa543990ee 100644 --- a/src/content/docs/zh/sdk/web/features/device-info.mdx +++ b/src/content/docs/zh/sdk/web/features/device-info.mdx @@ -6,7 +6,7 @@ slug: zh/sdk/web/features/device-info Adjust SDK 包含能够返回设备信息的辅助方法。用这些方法来向回传添加细节信息，优化报告。 -## Web UUID \{\#web\-uuid\} +## Web UUID {#web-uuid} @@ -27,7 +27,7 @@ function gdprForgetMe(): void; Adjust.gdprForgetMe(); ``` -## 针对特定用户的第三方分享\{\#third\-party\-sharing\-for\-specific\-users\} +## 针对特定用户的第三方分享{#third-party-sharing-for-specific-users} -## 1\. Add the SDK to your project \{\#add\-the\-sdk\-to\-your\-project\} +## 1\. Add the SDK to your project {#add-the-sdk-to-your-project} 要开始设置，请将 SDK 添加至网页应用。Adjust SDK 可在 CommonJS 和 AMD \(Asynchronous Module Definition\) 环境中运行。通过 CDN \(内容分发网络\) 加载时，您可以通过全局`Adjust`命名空间对其进行访问。 @@ -256,7 +256,7 @@ $ pnpm add @adjustcom/adjust-web-sdk -## 2\. Initialize the SDK \{\#initialize\-the\-sdk\} +## 2\. Initialize the SDK {#initialize-the-sdk} 安装 SDK 后，需要进行初始化。为此，请调用`initSdk`方法。您可以使用该方法中的参数来自定义 SDK 在应用中的工作方式。 From 7676118be8e8d46bea6074d25ae6b7b2e9984704 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 16 Jan 2025 12:37:21 +0000 Subject: [PATCH 28/42] File src/content/docs/en/sdk/web/features/attribution.mdx was translated to ko-KR locale --- .../docs/ko/sdk/web/features/attribution.mdx | 70 +++++++++---------- 1 file changed, 33 insertions(+), 37 deletions(-) diff --git a/src/content/docs/ko/sdk/web/features/attribution.mdx b/src/content/docs/ko/sdk/web/features/attribution.mdx index 4961b6879e..65e715eabc 100644 --- a/src/content/docs/ko/sdk/web/features/attribution.mdx +++ b/src/content/docs/ko/sdk/web/features/attribution.mdx @@ -1,14 +1,12 @@ --- -title: 어트리뷰션 정보 확인 -description: Adjust SDK를 사용하여 어트리뷰션 변경 사항 수신 -slug: ko/sdk/web/features/attribution +title: "어트리뷰션 정보 확인" +description: "Adjust SDK를 사용하여 어트리뷰션 변경 사항 수신" +slug: "en/sdk/web/features/attribution" --- - -사용자가 Adjust 링크와 상호작용하면 어트리뷰션 정보가 업데이트됩니다. 이는 사용자가 [딥링크](https://help.adjust.com/ko/article/deep-links)와 상호작용하는 경우에 발생할 수 있습니다. 사용자의 어트리뷰션 관련 정보는 어트리뷰션 객체에 나타납니다. +사용자가 Adjust 링크와 상호작용하면 어트리뷰션 정보가 업데이트됩니다. 이는 사용자가 [딥링크](https://help.adjust.com/en/article/deep-links)와 상호작용하는 경우에 발생할 수 있습니다. 사용자의 어트리뷰션 관련 정보는 어트리뷰션 객체에 나타납니다. 어트리뷰션 객체에는 다음 정보가 포함됩니다. - - + ```js export type AttributionMapT = $ReadOnly<{| @@ -24,31 +22,32 @@ export type AttributionMapT = $ReadOnly<{| |}>; ``` - + -| 값 | 데이터 유형 | 설명 | -| --------------- | ----------- | ----------------------------------------------------------------------------------- | -| `adid` | `string` | 기기의 고유한 Adjust 식별자. | -| `tracker_token` | `string` | 어트리뷰션과 관련된 링크 토큰. | -| `tracker_name` | `string` | 캠페인 링크의 이름. | -| `network` | `string` | 캠페인과 관련된 네트워크. | -| `campaign` | `string` | 어트리뷰션과 관련된 캠페인의 이름. | -| `adgroup` | `string` | 어트리뷰션과 관련된 광고그룹. | -| `creative` | `string` | 어트리뷰션과 관련된 크리에이티브. | -| `click_label` | `string` | 어트리뷰션과 관련된 [클릭 레이블](https://help.adjust.com/ko/article/user-rewards). | -| `state` | `string` | 어트리뷰션의 현재 상태. `installed` 또는 `reattributed` | +| 값 | 데이터 유형 | 설명 | +|-----------------|----------|-----------------------------------------------------------------------| +| `adid` | `string` | 기기의 고유한 Adjust 식별자. | +| `tracker_token` | `string` | 어트리뷰션과 관련된 링크 토큰. | +| `tracker_name` | `string` | 캠페인 링크의 이름. | +| `network` | `string` | 캠페인과 관련된 네트워크. | +| `campaign` | `string` | 어트리뷰션과 관련된 캠페인의 이름. | +| `adgroup` | `string` | 어트리뷰션과 관련된 광고그룹. | +| `creative` | `string` | 어트리뷰션과 관련된 크리에이티브. | +| `click_label` | `string` | 어트리뷰션과 관련된 [클릭 레이블](https://help.adjust.com/en/article/user-rewards). | +| `state` | `string` | 어트리뷰션의 현재 상태. `installed` 또는 `reattributed` | -## 어트리뷰션 변경 시 콜백 트리거 {#trigger-a-callback-when-attribution-changes} +어트리뷰션 변경 시 콜백 트리거 \{\#trigger\-a\-callback\-when\-attribution\-changes\} +-------------------------------------------------------------------------------- - + ```js attributionCallback: (string, Object) => mixed; ``` - + -SDK는 어트리뷰션 변경 사항을 받고 업데이트가 감지되면 함수를 호출합니다. `initSdk` 메서드의 `attributionCallback` 함수 특정으로 어트리뷰션 콜백 메서드를 설정할 수 있습니다. 함수 내에서 사용자의 어트리뷰션 정보에 액세스할 수 있습니다. +SDK는 어트리뷰션 변경 사항을 받고 업데이트가 감지되면 함수를 호출합니다. `initSdk` 메서드의 `attributionCallback` 함수 특정으로 어트리뷰션 콜백 메서드를 설정할 수 있습니다. 함수 내에서 사용자의 어트리뷰션 정보에 액세스할 수 있습니다. ```js Adjust.initSdk({ @@ -68,12 +67,10 @@ Adjust.initSdk({ }); ``` -## 현재 어트리뷰션 정보 확인 {#get-current-attribution-information} +현재 어트리뷰션 정보 확인 \{\#get\-current\-attribution\-information\} +----------------------------------------------------------------- -{" "} + 사용자가 앱을 설치하면 Adjust는 해당 설치를 캠페인에 어트리뷰션합니다. Adjust SDK를 사용하면 설치 캠페인 어트리뷰션 정보에 액세스할 수 있습니다. `waitForAttribution` 메서드는 SDK가 서버에서 어트리뷰션 데이터를 성공적으로 수신했을 때 `promise` 를 반환합니다. @@ -83,30 +80,29 @@ Adjust.waitForAttribution().then((attr) => ); ``` -## 리퍼러 설정 {#set-a-referrer} +리퍼러 설정 \{\#set\-a\-referrer\} +---------------------------------- - + ```js function setReferrer(referrer: string): void; ``` - + SDK가 시작될 때 커스텀 클릭 ID로 SDK 클릭을 트리거하는 리퍼러를 설정할 수 있습니다. SDK는 어트리뷰션 목적으로 커스텀 클릭 ID를 Adjust 서버로 전송합니다. - - + 리퍼러가 어트리뷰션에 사용될 수 있도록 최대한 SDK 초기화에 가깝게 이 메서드를 호출하시기 바랍니다. - - + 리퍼러를 설정하려면 `setReferrer` 메서드를 호출하고 리퍼러를 URL 암호화된 `string` 인수로 전달합니다. - - + ```js Adjust.setReferrer("adjust_external_click_id%3DEXTERNAL_CLICK_ID"); ``` + From 0339735d8ea65fc879a5050abd0fd4bb9b3c47e7 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 16 Jan 2025 12:37:23 +0000 Subject: [PATCH 29/42] File src/content/docs/en/sdk/web/features/attribution.mdx was translated to zh-CN locale --- .../docs/zh/sdk/web/features/attribution.mdx | 68 +++++++++---------- 1 file changed, 32 insertions(+), 36 deletions(-) diff --git a/src/content/docs/zh/sdk/web/features/attribution.mdx b/src/content/docs/zh/sdk/web/features/attribution.mdx index b23d387dda..26db7c7244 100644 --- a/src/content/docs/zh/sdk/web/features/attribution.mdx +++ b/src/content/docs/zh/sdk/web/features/attribution.mdx @@ -1,14 +1,12 @@ --- -title: 获取归因信息 -description: 使用 Adjust SDK 监听归因变化 -slug: zh/sdk/web/features/attribution +title: "获取归因信息" +description: "使用 Adjust SDK 监听归因变化" +slug: "en/sdk/web/features/attribution" --- - -用户与 Adjust 链接交互时，其归因信息会发生更新。用户与[深度链接](https://help.adjust.com/zh/article/deep-links)交互时可能会发生这种情况。用户归因相关信息会在归因对象中展现。 +用户与 Adjust 链接交互时，其归因信息会发生更新。用户与[深度链接](https://help.adjust.com/en/article/deep-links)交互时可能会发生这种情况。用户归因相关信息会在归因对象中展现。 归因对象包含下列信息： - - + ```js export type AttributionMapT = $ReadOnly<{| @@ -24,29 +22,30 @@ export type AttributionMapT = $ReadOnly<{| |}>; ``` - + -| 值 | 数据类型 | 描述 | -| --------------- | -------- | ----------------------------------------------------------------------------- | -| `adid` | `string` | 设备的唯一 Adjust 标识符。 | -| `tracker_token` | `string` | 与归因关联的链接识别码。 | -| `tracker_name` | `string` | 推广活动链接名称 | -| `network` | `string` | 与推广活动关联的渠道。 | -| `campaign` | `string` | 与归因关联的推广活动名称。 | -| `adgroup` | `string` | 与归因关联的广告组。 | -| `creative` | `string` | 与归因关联的素材。 | -| `click_label` | `string` | 与归因关联的 [click label](https://help.adjust.com/zh/article/user-rewards)。 | -| `state` | `string` | 当前归因状态。`installed` 或 `reattributed` | +| 值 | 数据类型 | 描述 | +|-----------------|----------|------------------------------------------------------------------------| +| `adid` | `string` | 设备的唯一 Adjust 标识符。 | +| `tracker_token` | `string` | 与归因关联的链接识别码。 | +| `tracker_name` | `string` | 推广活动链接名称 | +| `network` | `string` | 与推广活动关联的渠道。 | +| `campaign` | `string` | 与归因关联的推广活动名称。 | +| `adgroup` | `string` | 与归因关联的广告组。 | +| `creative` | `string` | 与归因关联的素材。 | +| `click_label` | `string` | 与归因关联的 [click label](https://help.adjust.com/en/article/user-rewards)。 | +| `state` | `string` | 当前归因状态。`installed` 或 `reattributed` | -## 发生归因变化时触发回传{#trigger-a-callback-when-attribution-changes} +发生归因变化时触发回传\{\#trigger\-a\-callback\-when\-attribution\-changes\} +------------------------------------------------------------------------- - + ```js attributionCallback: (string, Object) => mixed; ``` - + SDK 可监听归因变更并在发现更新时调用一个函数。您可以在 `initSdk` 方法中指定一个 `attributionCallback` 函数，来设置归因回传方法。在函数内，您可以访问用户归因信息。 @@ -68,12 +67,10 @@ Adjust.initSdk({ }); ``` -## 获取当前归因信息{#get-current-attribution-information} +获取当前归因信息\{\#get\-current\-attribution\-information\} +---------------------------------------------------------- -{" "} + 用户安装您的应用时，Adjust 会将该安装归因至一个推广活动。Adjust SDK 可提供赢得安装归因的推广活动细节。`waitForAttribution`方法会返回一个`promise`，当 SDK 成功从服务器接收到归因数据时，该 promise 会被完成。 @@ -83,30 +80,29 @@ Adjust.waitForAttribution().then((attr) => ); ``` -## 设置 referrer {#set-a-referrer} +设置 referrer \{\#set\-a\-referrer\} +--------------------------------------- - + ```js function setReferrer(referrer: string): void; ``` - + 您可以创建一个 referrer，来在 SDK 启动后触发带有自定义点击 ID 的 SDK 点击。SDK 会将您的自定义点击 ID 发送到 Adjust 服务器用于归因。 - - + 在尽可能靠近 SDK 初始化的节点调用此方法，确保您的 referrer 被用于归因。 - - + 要设置 referrer，请调用 `setReferrer` 方法并以 URL 编码 `string` 参数的形式传递 referrer。 - - + ```js Adjust.setReferrer("adjust_external_click_id%3DEXTERNAL_CLICK_ID"); ``` + From ff4ec8aabe6bda2e5f45ffe62ade196d9d06cfa8 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 16 Jan 2025 12:37:25 +0000 Subject: [PATCH 30/42] File src/content/docs/en/sdk/web/features/attribution.mdx was translated to ja-JP locale --- .../docs/ja/sdk/web/features/attribution.mdx | 68 +++++++++---------- 1 file changed, 32 insertions(+), 36 deletions(-) diff --git a/src/content/docs/ja/sdk/web/features/attribution.mdx b/src/content/docs/ja/sdk/web/features/attribution.mdx index 383955a17d..978dd09c60 100644 --- a/src/content/docs/ja/sdk/web/features/attribution.mdx +++ b/src/content/docs/ja/sdk/web/features/attribution.mdx @@ -1,14 +1,12 @@ --- -title: アトリビューション情報の取得 -description: Adjust SDKを使ってアトリビューションの変更を受信します。 -slug: ja/sdk/web/features/attribution +title: "アトリビューション情報の取得" +description: "Adjust SDKを使ってアトリビューションの変更を受信します。" +slug: "en/sdk/web/features/attribution" --- - -ユーザーがAdjustリンクをクリックすると、そのアトリビューション情報が更新されます。これは、ユーザーが[ディープリンク](https://help.adjust.com/ja/article/deep-links)をクリックした場合に発生します。ユーザーのアトリビューションについての情報は、アトリビューションオブジェクトに表示されます。 +ユーザーがAdjustリンクをクリックすると、そのアトリビューション情報が更新されます。これは、ユーザーが[ディープリンク](https://help.adjust.com/en/article/deep-links)をクリックした場合に発生します。ユーザーのアトリビューションについての情報は、アトリビューションオブジェクトに表示されます。 アトリビューションオブジェクトは以下の情報を含んでいます。 - - + ```js export type AttributionMapT = $ReadOnly<{| @@ -24,29 +22,30 @@ export type AttributionMapT = $ReadOnly<{| |}>; ``` - + -| 値 | データタイプ | 説明 | -| --------------- | ------------ | ------------------------------------------------------------------------------------------------------- | -| `adid` | `string` | デバイス固有のAdjust識別子 | -| `tracker_token` | `string` | アトリビューションに関連付けられているリンクトークン | -| `tracker_name` | `string` | キャンペーンリンクの名前 | -| `network` | `string` | キャンペーンに関連付けられているネットワーク | -| `campaign` | `string` | アトリビューションに関連付けられているキャンペーンの名前 | -| `adgroup` | `string` | アトリビューションに関連付けられているアドグループ | -| `creative` | `string` | アトリビューションに関連付けられているクリエイティブ | -| `click_label` | `string` | アトリビューションに関連付けられている[クリックラベル](https://help.adjust.com/ja/article/user-rewards) | -| `state` | `string` | アトリビューションの現在のステータス。`installed`または `reattributed` | +| 値 | データタイプ | 説明 | +|-----------------|----------|-------------------------------------------------------------------------------| +| `adid` | `string` | デバイス固有のAdjust識別子 | +| `tracker_token` | `string` | アトリビューションに関連付けられているリンクトークン | +| `tracker_name` | `string` | キャンペーンリンクの名前 | +| `network` | `string` | キャンペーンに関連付けられているネットワーク | +| `campaign` | `string` | アトリビューションに関連付けられているキャンペーンの名前 | +| `adgroup` | `string` | アトリビューションに関連付けられているアドグループ | +| `creative` | `string` | アトリビューションに関連付けられているクリエイティブ | +| `click_label` | `string` | アトリビューションに関連付けられている[クリックラベル](https://help.adjust.com/en/article/user-rewards) | +| `state` | `string` | アトリビューションの現在のステータス。`installed`または `reattributed` | -## アトリビューションの変更時にコールバックをトリガーする {#trigger-a-callback-when-attribution-changes} +アトリビューションの変更時にコールバックをトリガーする \{\#trigger\-a\-callback\-when\-attribution\-changes\} +------------------------------------------------------------------------------------------ - + ```js attributionCallback: (string, Object) => mixed; ``` - + SDKはアトリビューションの変更を受信し、更新を検出したときに関数を呼び出すことができます。アトリビューションコールバックメソッドを設定するには、`initSdk`メソッドで`attributionCallback`関数を指定します。関数内で、ユーザーのアトリビューション情報にアクセスすることができます。 @@ -68,12 +67,10 @@ Adjust.initSdk({ }); ``` -## 現在のアトリビューション情報を取得する {#get-current-attribution-information} +現在のアトリビューション情報を取得する \{\#get\-current\-attribution\-information\} +---------------------------------------------------------------------- -{" "} + ユーザーがアプリをインストールすると、Adjustはそのインストールをキャンペーンにアトリビュートします。Adjust SDKを実装することで、インストールのキャンペーンアトリビューションの詳細にアクセスすることが可能です。`waitForAttribution`メソッドは、SDKがサーバーからアトリビューションデータを正常に受信すると解析される`promise`を返します。 @@ -83,30 +80,29 @@ Adjust.waitForAttribution().then((attr) => ); ``` -## リファラーを設定する {#set-a-referrer} +リファラーを設定する \{\#set\-a\-referrer\} +-------------------------------------- - + ```js function setReferrer(referrer: string): void; ``` - + SDKの開始時にカスタムクリックIDでSDKクリックのトリガーとなるリファラーを設定することができます。SDKは、アトリビューションの目的でカスタムクリックIDをAdjustのサーバーに送信します。 - - + アトリビューションにリファラーが使用されるように、SDKの初期化時にできる限り近い時点でこのメソッドを呼び出してください。 - - + リファラーを設定するには、`setReferrer`メソッドを呼び出し、URLエンコードされた`string`引数としてリファラーをパスします。 - - + ```js Adjust.setReferrer("adjust_external_click_id%3DEXTERNAL_CLICK_ID"); ``` + From d0a13d90661a7be34f841f973a56681b20b9d800 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 16 Jan 2025 12:37:26 +0000 Subject: [PATCH 31/42] File src/content/docs/en/sdk/web/features/device-info.mdx was translated to ko-KR locale --- .../docs/ko/sdk/web/features/device-info.mdx | 16 +++++++--------- 1 file changed, 7 insertions(+), 9 deletions(-) diff --git a/src/content/docs/ko/sdk/web/features/device-info.mdx b/src/content/docs/ko/sdk/web/features/device-info.mdx index 332eeedd0d..5b5ff1e94d 100644 --- a/src/content/docs/ko/sdk/web/features/device-info.mdx +++ b/src/content/docs/ko/sdk/web/features/device-info.mdx @@ -1,17 +1,14 @@ --- -title: 디바이스 정보 확인 -description: 해당 메서드를 사용하여 콜백에 세부 정보를 추가하고 리포트를 보완하시기 바랍니다. -slug: ko/sdk/web/features/device-info +title: "디바이스 정보 확인" +description: "해당 메서드를 사용하여 콜백에 세부 정보를 추가하고 리포트를 보완하시기 바랍니다." +slug: "en/sdk/web/features/device-info" --- - Adjust SDK는 디바이스 정보를 반환하는 헬프 메서드가 포함되어 있습니다. 해당 메서드를 사용하여 콜백에 세부 정보를 추가하고 리포트를 보완하시기 바랍니다. -## Web UUID {#web-uuid} +Web UUID \{\#web\-uuid\} +---------------------------- -{" "} + 웹 SDK는 Adjust에서 웹 사용자를 식별하기 위해 첫 세션 전송 시 고유한 `web_uuid` 식별자를 생성합니다. 이 ID는 UUID\(Universally Unique Identifier\) 형식을 따릅니다. @@ -22,3 +19,4 @@ Adjust SDK는 디바이스 정보를 반환하는 헬프 메서드가 포함되 ```js Adjust.waitForWebUUID().then((webUuid) => console.log(webUuid)); ``` + From 435127e116607da66c89c77320370a848e5e0fe5 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 16 Jan 2025 12:37:28 +0000 Subject: [PATCH 32/42] File src/content/docs/en/sdk/web/features/device-info.mdx was translated to zh-CN locale --- .../docs/zh/sdk/web/features/device-info.mdx | 16 +++++++--------- 1 file changed, 7 insertions(+), 9 deletions(-) diff --git a/src/content/docs/zh/sdk/web/features/device-info.mdx b/src/content/docs/zh/sdk/web/features/device-info.mdx index aa543990ee..96ceefac89 100644 --- a/src/content/docs/zh/sdk/web/features/device-info.mdx +++ b/src/content/docs/zh/sdk/web/features/device-info.mdx @@ -1,17 +1,14 @@ --- -title: 获取设备信息 -description: 用这些方法来向回传添加细节信息，优化报告。 -slug: zh/sdk/web/features/device-info +title: "获取设备信息" +description: "用这些方法来向回传添加细节信息，优化报告。" +slug: "en/sdk/web/features/device-info" --- - Adjust SDK 包含能够返回设备信息的辅助方法。用这些方法来向回传添加细节信息，优化报告。 -## Web UUID {#web-uuid} +Web UUID \{\#web\-uuid\} +---------------------------- -{" "} + 为在 Adjust 中识别网页用户，Adjust Web SDK 会在发送第一次会话时生成唯一的 `web_uuid` 标识符。该标识符采用通用唯一标识符 \(UUID\) 格式。 @@ -22,3 +19,4 @@ Adjust SDK 包含能够返回设备信息的辅助方法。用这些方法来向 ```js Adjust.waitForWebUUID().then((webUuid) => console.log(webUuid)); ``` + From 894c8e7d8eebed56021e01fce58316d3177804d4 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 16 Jan 2025 12:37:30 +0000 Subject: [PATCH 33/42] File src/content/docs/en/sdk/web/features/device-info.mdx was translated to ja-JP locale --- .../docs/ja/sdk/web/features/device-info.mdx | 16 +++++++--------- 1 file changed, 7 insertions(+), 9 deletions(-) diff --git a/src/content/docs/ja/sdk/web/features/device-info.mdx b/src/content/docs/ja/sdk/web/features/device-info.mdx index d44b28783e..4c5badf3c1 100644 --- a/src/content/docs/ja/sdk/web/features/device-info.mdx +++ b/src/content/docs/ja/sdk/web/features/device-info.mdx @@ -1,17 +1,14 @@ --- -title: デバイス情報を取得 -description: これらのメソッドを使用することでコールバックに詳細を追加し、レポートを改善させましょう。 -slug: ja/sdk/web/features/device-info +title: "デバイス情報を取得" +description: "これらのメソッドを使用することでコールバックに詳細を追加し、レポートを改善させましょう。" +slug: "en/sdk/web/features/device-info" --- - Adjust SDKには、デバイス情報を返すヘルパーメソッドが含まれています。これらのメソッドを使用することでコールバックに詳細を追加し、レポートを改善させましょう。 -## Web UUID {#web-uuid} +Web UUID \{\#web\-uuid\} +---------------------------- -{" "} + AdjustがWebユーザーを識別するために、Web SDKはセッションを送信する際に一意の`web_uuid`を生成します。IDはUniversally Unique Identifier（UUID）のフォーマットです。 @@ -22,3 +19,4 @@ AdjustがWebユーザーを識別するために、Web SDKはセッションを ```js Adjust.waitForWebUUID().then((webUuid) => console.log(webUuid)); ``` + From 485fdca5cb7a0b7c0d7e44ca754caf4c1a94c490 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 16 Jan 2025 12:37:32 +0000 Subject: [PATCH 34/42] File src/content/docs/en/sdk/web/features/privacy.mdx was translated to ko-KR locale --- .../docs/ko/sdk/web/features/privacy.mdx | 111 ++++++++---------- 1 file changed, 48 insertions(+), 63 deletions(-) diff --git a/src/content/docs/ko/sdk/web/features/privacy.mdx b/src/content/docs/ko/sdk/web/features/privacy.mdx index db475c0f10..2ee8c7acee 100644 --- a/src/content/docs/ko/sdk/web/features/privacy.mdx +++ b/src/content/docs/ko/sdk/web/features/privacy.mdx @@ -1,44 +1,42 @@ --- -title: 프라이버시 기능 설정 -description: 앱에서 사용자 프라이버시를 관리할 수 있는 기능을 구성합니다. -slug: ko/sdk/web/features/privacy +title: "프라이버시 기능 설정" +description: "앱에서 사용자 프라이버시를 관리할 수 있는 기능을 구성합니다." +slug: "en/sdk/web/features/privacy" --- - Adjust SDK에는 앱에서 사용자 프라이버시를 관리할 수 있는 기능이 포함되어 있습니다. -## 삭제 요청 전송 {#send-erasure-request} +삭제 요청 전송 \{\#send\-erasure\-request\} +------------------------------------------ - + ```js function gdprForgetMe(): void; ``` - + -EU의 개인정보 보호 규정\(GDPR\) 및 기타 개인정보 보호법\(CCPA, LGPD 등\)은 데이터 주체에게 개인 데이터 처리와 관련하여 포괄적인 권리를 부여합니다. 이러한 권리에는 삭제 권리\([GDPR 17조](https://gdpr.eu/article-17-right-to-be-forgotten/)\)\([1](https://help.adjust.com/ko/article/gdpr#ref-1)\)가 포함됩니다. 데이터 처리자로서 Adjust는 귀하의 \(앱\) 사용자의 이러한 요청을 처리하는 데 있어 귀하\(데이터 컨트롤러\)를 지원할 의무가 있습니다. +EU의 개인정보 보호 규정\(GDPR\) 및 기타 개인정보 보호법\(CCPA, LGPD 등\)은 데이터 주체에게 개인 데이터 처리와 관련하여 포괄적인 권리를 부여합니다. 이러한 권리에는 삭제 권리\([GDPR 17조](https://gdpr.eu/article-17-right-to-be-forgotten/)\)\([1](https://help.adjust.com/en/article/gdpr#ref-1)\)가 포함됩니다. 데이터 처리자로서 Adjust는 귀하의 \(앱\) 사용자의 이러한 요청을 처리하는 데 있어 귀하\(데이터 컨트롤러\)를 지원할 의무가 있습니다. `gdprForgetMe` 메서드를 호출하여 사용자의 삭제 요청을 Adjust로 전송할 수 있습니다. 삭제 요청 수신 시 Adjust는 다음의 조치를 취합니다: -- Adjust 내부 시스템과 데이터베이스에서 해당 사용자의 모든 개인 정보 기록을 영구적으로 삭제합니다. -- Adjust는 더 이상 Adjust SDK를 통해 해당 사용자/기기로부터 데이터를 수신하지 않습니다.\([2](https://help.adjust.com/ko/article/gdpr#ref-2)\) +* Adjust 내부 시스템과 데이터베이스에서 해당 사용자의 모든 개인 정보 기록을 영구적으로 삭제합니다. +* Adjust는 더 이상 Adjust SDK를 통해 해당 사용자/기기로부터 데이터를 수신하지 않습니다.\([2](https://help.adjust.com/en/article/gdpr#ref-2)\) ```js Adjust.gdprForgetMe(); ``` -## 특정 사용자에 대한 서드파티 공유 {#third-party-sharing-for-specific-users} +특정 사용자에 대한 서드파티 공유 \{\#third\-party\-sharing\-for\-specific\-users\} +---------------------------------------------------------------------------- -{" "} + Adjust SDK를 사용하여 사용자의 서드파티 공유 설정 변경 내용을 기록할 수 있습니다. 이러한 설정은 `ThirdPartySharing` 클래스를 사용하여 구성됩니다. -### AdjustThirdPartySharing 객체 인스턴스화 {#instantiate-an-adjustthirdpartysharing-object} +### AdjustThirdPartySharing 객체 인스턴스화 \{\#instantiate\-an\-adjustthirdpartysharing\-object\} - + ```ts class ThirdPartySharing { @@ -47,13 +45,13 @@ class ThirdPartySharing { } ``` - + Adjust SDK와의 서드파트 공유를 활성화 또는 비활성화하려면 `ThirdPartySharing` 객체를 인스턴스화합니다. 이 객체에 Adjust의 서드파티 공유 처리 방식을 제어하는 변수가 포함됩니다. 이를 인스턴스화하려면 새로운 `ThirdPartySharing` 인스턴스를 생성하고 다음 파라미터를 전달합니다. -- `isEnabled` \(`boolean`\):`true` 전달로 서드파티 공유를 활성화하거나 `false` 전달로 서드파티 공유를 비활성화합니다. +* `isEnabled` \(`boolean`\):`true` 전달로 서드파티 공유를 활성화하거나 `false` 전달로 서드파티 공유를 비활성화합니다. ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -68,12 +66,9 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 서드파티 공유 비활성화\(지원 중단\) {#disable-third-party-sharing} +### 서드파티 공유 비활성화\(지원 중단\) \{\#disable\-third\-party\-sharing\} -{" "} + 이전 버전의 SDK에서 서드파티 공유를 비활성화하려면 `disableThirdPartySharing` 메서드를 호출합니다. 이 메서드는 지원 중단되었습니다. 계속 사용할 경우 기본 메서드를 직접 호출하게 됩니다. @@ -82,9 +77,9 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(false); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 세분화된 정보 전송 {#send-granular-information} +### 세분화된 정보 전송 \{\#send\-granular\-information\} - + ```ts public addGranularOption(partnerName: string, @@ -92,15 +87,15 @@ public addGranularOption(partnerName: string, value: string) ``` - + 서드파티 공유 설정 변경 시 세부 정보를 추가할 수 있습니다. 이를 통해 사용자의 결정에 대한 더욱 자세한 정보를 전달할 수 있습니다. 다음 파라미터와 함께 `addGranularOption` 메서드를 호출합니다. -- `partnerName` \(`string`\): 세분화 옵션을 적용할 파트너의 이름 -- `key` \(`string`\): 옵션 키 -- `value` \(`string`\): 옵션 값 +* `partnerName` \(`string`\): 세분화 옵션을 적용할 파트너의 이름 +* `key` \(`string`\): 옵션 키 +* `value` \(`string`\): 옵션 값 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -108,37 +103,34 @@ options.addGranularOption("PartnerA", "foo", "bar"); Adjust.trackThirdPartySharing(options); ``` -## URL 전략 {#url-strategy} +URL 전략 \{\#url\-strategy\} +------------------------------ -{" "} + URL 전략 기능을 사용하여 다음을 설정할 수 있습니다. -- Adjust가 귀하의 데이터를 저장하는 국가\(데이터 레지던시\). -- Adjust SDK가 트래픽을 전송하는 엔드포인트\(맞춤 URL\). +* Adjust가 귀하의 데이터를 저장하는 국가\(데이터 레지던시\). +* Adjust SDK가 트래픽을 전송하는 엔드포인트\(맞춤 URL\). 본 기능은 프라이버시 요건이 엄격한 나라에서 앱을 운영하는 경우에 유용합니다. URL 전략을 설정하면 Adjust가 선택된 데이터 레지던시 지역에 데이터를 저장하거나 선택된 도메인으로 트래픽을 전송합니다. URL 전략을 구성하려면 `Adjust.initSdk` 인스턴스에 `urlStrategy` 의 다음 속성을 설정합니다. -- `domains` \(`Array`\): SDK 트래픽을 전송할 데이터 레지던스 국가 또는 엔드포인트. 기본 설정에 따라 Adjust SDK는 모든 데이터를 Adjust의 엔드포인트로 전송합니다. 커스텀 엔드포인트를 설정하려면 `urlStrategy`의 `domains` 속성에 엔드포인트를 전달합니다. -- `useSubdomains` \(`boolean`\): 도메인을 Adjust 도메인으로 취급할지 여부. - - - `true`인 경우 SDK는 도메인의 접두사로 Adjust에 특화된 하위 도메인을 사용합니다. - - `false`인 경우 SDK는 접두사 없이 제공된 도메인을 그대로 사용합니다. +* `domains` \(`Array`\): SDK 트래픽을 전송할 데이터 레지던스 국가 또는 엔드포인트. 기본 설정에 따라 Adjust SDK는 모든 데이터를 Adjust의 엔드포인트로 전송합니다. 커스텀 엔드포인트를 설정하려면 `urlStrategy`의 `domains` 속성에 엔드포인트를 전달합니다. +* `useSubdomains` \(`boolean`\): 도메인을 Adjust 도메인으로 취급할지 여부. + * `true`인 경우 SDK는 도메인의 접두사로 Adjust에 특화된 하위 도메인을 사용합니다. + * `false`인 경우 SDK는 접두사 없이 제공된 도메인을 그대로 사용합니다. -- `isDataResidency` \(`boolean`\): 선택 사항으로, 도메인을 데이터 레지던시에 사용해야 하는지 여부입니다. +* `isDataResidency` \(`boolean`\): 선택 사항으로, 도메인을 데이터 레지던시에 사용해야 하는지 여부입니다. 다음 표는 구성 목록을 보여줍니다. -| URL 전략 | 기본 도메인 및 커스텀 도메인 | 하위 도메인 사용 | 데이터 레지던시 | -| ------------------ | ----------------------------- | ---------------- | --------------- | -| EU 데이터 레지던시 | `"eu.adjust.com"` | `true` | `true` | -| 중국 URL 전략 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | -| 맞춤 URL 전략 | `"my.custom.domain"` | `false` | `false` | +| URL 전략 | 기본 도메인 및 커스텀 도메인 | 하위 도메인 사용 | 데이터 레지던시 | +|-------------|-------------------------------|-----------|----------| +| EU 데이터 레지던시 | `"eu.adjust.com"` | `true` | `true` | +| 중국 URL 전략 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | +| 맞춤 URL 전략 | `"my.custom.domain"` | `false` | `false` | ```js Adjust.initSdk({ @@ -153,16 +145,12 @@ Adjust.initSdk({ }); ``` -### 커스텀 엔드포인트 설정\(지원 중단\) {#set-custom-endpoint} +### 커스텀 엔드포인트 설정\(지원 중단\) \{\#set\-custom\-endpoint\} -{" "} + 이전 버전의 SDK는 지원 중단된 `customUrl` 속성을 사용하여 엔드포인트를 전달했습니다. 대신 `urlStrategy` 구성을 사용하시기 바랍니다. - - + ```js Adjust.initSdk({ @@ -178,18 +166,14 @@ Adjust.initSdk({ }); ``` - + -### 데이터 레지던시\(지원 중단\) {#data-residency} +### 데이터 레지던시\(지원 중단\) \{\#data\-residency\} -{" "} + 이전 버전의 SDK는 지원 중단된 `dataResidency` 속성을 사용했습니다. 대신 `urlStrategy` 구성을 사용하시기 바랍니다. - - + ```js Adjust.initSdk({ @@ -206,3 +190,4 @@ Adjust.initSdk({ ``` + From 8d14f5eb72871bac2a8b3a3d2815792e4c60aa23 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 16 Jan 2025 12:37:33 +0000 Subject: [PATCH 35/42] File src/content/docs/en/sdk/web/features/privacy.mdx was translated to zh-CN locale --- .../docs/zh/sdk/web/features/privacy.mdx | 111 ++++++++---------- 1 file changed, 48 insertions(+), 63 deletions(-) diff --git a/src/content/docs/zh/sdk/web/features/privacy.mdx b/src/content/docs/zh/sdk/web/features/privacy.mdx index 901abde92f..8979273d83 100644 --- a/src/content/docs/zh/sdk/web/features/privacy.mdx +++ b/src/content/docs/zh/sdk/web/features/privacy.mdx @@ -1,44 +1,42 @@ --- -title: 设置隐私功能 -description: 配置处理应用用户隐私的功能。 -slug: zh/sdk/web/features/privacy +title: "设置隐私功能" +description: "配置处理应用用户隐私的功能。" +slug: "en/sdk/web/features/privacy" --- - Adjust SDK 包含处理应用用户隐私的功能。 -## 发送删除请求{#send-erasure-request} +发送删除请求\{\#send\-erasure\-request\} +--------------------------------------- - + ```js function gdprForgetMe(): void; ``` - + -在处理个人数据方面，欧盟的《通用数据保护条例》\(GDPR\) 和全球类似的隐私法律 \(CCPA、LGPD 等\) 授予数据主体完全权利，其中包括删除权 \([参见 GDPR 第 17](https://gdpr.eu/article-17-right-to-be-forgotten/)条\)\( [1](https://help.adjust.com/zh/article/gdpr#ref-1) \)。作为数据处理方，Adjust 有义务支持您 \(数据控制方\) 处理来自应用用户的此类请求。 +在处理个人数据方面，欧盟的《通用数据保护条例》\(GDPR\) 和全球类似的隐私法律 \(CCPA、LGPD 等\) 授予数据主体完全权利，其中包括删除权 \([参见 GDPR 第 17](https://gdpr.eu/article-17-right-to-be-forgotten/)条\)\( [1](https://help.adjust.com/en/article/gdpr#ref-1) \)。作为数据处理方，Adjust 有义务支持您 \(数据控制方\) 处理来自应用用户的此类请求。 您可以通过调用 `gdprForgetMe` 方法来将用户的删除请求发送至 Adjust 服务器。收到通知后： -- 我们将从内部系统和数据库中永久删除用户的所有历史个人数据； -- 此外，Adjust 将不再通过 Adjust SDK 接收来自该用户/设备的数据。 \( [2](https://help.adjust.com/zh/article/gdpr#ref-2) \) +* 我们将从内部系统和数据库中永久删除用户的所有历史个人数据； +* 此外，Adjust 将不再通过 Adjust SDK 接收来自该用户/设备的数据。 \( [2](https://help.adjust.com/en/article/gdpr#ref-2) \) ```js Adjust.gdprForgetMe(); ``` -## 针对特定用户的第三方分享{#third-party-sharing-for-specific-users} +针对特定用户的第三方分享\{\#third\-party\-sharing\-for\-specific\-users\} +--------------------------------------------------------------------- -{" "} + 您可以使用 Adjust SDK 来记录用户对第三方数据分享设置的变更。请使用 `ThirdPartySharing` 类配置第三方数据分享。 -### 实例化 AdjustThirdPartySharing 对象{#instantiate-an-adjustthirdpartysharing-object} +### 实例化 AdjustThirdPartySharing 对象\{\#instantiate\-an\-adjustthirdpartysharing\-object\} - + ```ts class ThirdPartySharing { @@ -47,13 +45,13 @@ class ThirdPartySharing { } ``` - + 要启用或禁用 Adjust SDK 第三方数据分享，请实例化 `ThirdPartySharing` 对象。该对象包含控制 Adjust 如何处理第三方分享的变量。 要进行实例化，请创建新的 `ThirdPartySharing` 实例，并传递下列参数： -- `isEnabled` \( `boolean` \): 传递`true`来启用第三方分享或传递`false`来禁用第三方分享。 +* `isEnabled` \( `boolean` \): 传递`true`来启用第三方分享或传递`false`来禁用第三方分享。 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -68,12 +66,9 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 禁用第三方分享 \(已弃用\) {#disable-third-party-sharing} +### 禁用第三方分享 \(已弃用\) \{\#disable\-third\-party\-sharing\} -{" "} + 如需在之前版本的 SDK 中禁用第三方数据分享，请调用`disableThirdPartySharing`方法。此方法已被弃用。如果您仍在使用，请注意它会直接调用基础方法。 @@ -82,9 +77,9 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(false); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 发送精细信息{#send-granular-information} +### 发送精细信息\{\#send\-granular\-information\} - + ```ts public addGranularOption(partnerName: string, @@ -92,15 +87,15 @@ public addGranularOption(partnerName: string, value: string) ``` - + 当用户更新第三方数据分享设置时，您可以附加较精细的信息，以此发送用户决定的更多细节。 使用下列参数调用`addGranularOption`方法： -- `partnerName` \(`string`\)：使用精细设置的合作伙伴的名称。 -- `key` \(`string`\)：选项 key。 -- `value` \(`string`\)：选项值。 +* `partnerName` \(`string`\)：使用精细设置的合作伙伴的名称。 +* `key` \(`string`\)：选项 key。 +* `value` \(`string`\)：选项值。 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -108,37 +103,34 @@ options.addGranularOption("PartnerA", "foo", "bar"); Adjust.trackThirdPartySharing(options); ``` -## URL 策略{#url-strategy} +URL 策略\{\#url\-strategy\} +----------------------------- -{" "} + 通过 URL 策略功能，您可以进行下列设置： -- Adjust 储存您数据的国家/地区 \(即数据驻留\)。 -- 接收 Adjust SDK 所发送流量的终端 \(自定义 URL \)。 +* Adjust 储存您数据的国家/地区 \(即数据驻留\)。 +* 接收 Adjust SDK 所发送流量的终端 \(自定义 URL \)。 当应用运营的国家拥有严格的隐私规定时，此功能会非常有用。在您设置 URL 策略时，Adjust 会将数据储存在指定数据驻留地区，或将流量发送至选定域名。 要配置 URL 策略，请在`Adjust.initSdk`实例中设置`urlStrategy`的以下属性： -- `domains` \(`Array`\)：接收您所发送 SDK 流量的数据驻留国家/地区或终端。默认情况下，Adjust SDK 会将所有数据都发送至 Adjust 终端。如果您想设置自定义终端，请在`urlStrategy`的`domains`属性中传递。 -- `useSubdomains` \(`boolean`\): 域名是否应被视为 Adjust 域名。 - - - 如果为`true`，则 SDK 会在域名中添加 Adjust 特定子域作为前缀。 - - 如果为`false`，SDK 会按原样使用所提供的域名，不包含前缀。 +* `domains` \(`Array`\)：接收您所发送 SDK 流量的数据驻留国家/地区或终端。默认情况下，Adjust SDK 会将所有数据都发送至 Adjust 终端。如果您想设置自定义终端，请在`urlStrategy`的`domains`属性中传递。 +* `useSubdomains` \(`boolean`\): 域名是否应被视为 Adjust 域名。 + * 如果为`true`，则 SDK 会在域名中添加 Adjust 特定子域作为前缀。 + * 如果为`false`，SDK 会按原样使用所提供的域名，不包含前缀。 -- `isDataResidency` \( `boolean` \)：可选。域名是否应被用于数据驻留。 +* `isDataResidency` \( `boolean` \)：可选。域名是否应被用于数据驻留。 下表展示了一系列配置。 -| URL 策略 | 默认和自定义域名 | 使用子域名 | 数据驻留 | -| --------------- | ----------------------------- | ---------- | -------- | -| 欧盟数据驻留 | `"eu.adjust.com"` | `true` | `true` | -| 中国 URL 策略 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | -| 自定义 URL 策略 | `"my.custom.domain"` | `false` | `false` | +| URL 策略 | 默认和自定义域名 | 使用子域名 | 数据驻留 | +|------------|-------------------------------|---------|---------| +| 欧盟数据驻留 | `"eu.adjust.com"` | `true` | `true` | +| 中国 URL 策略 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | +| 自定义 URL 策略 | `"my.custom.domain"` | `false` | `false` | ```js Adjust.initSdk({ @@ -153,16 +145,12 @@ Adjust.initSdk({ }); ``` -### 设置自定义终端 \(已弃用\) {#set-custom-endpoint} +### 设置自定义终端 \(已弃用\) \{\#set\-custom\-endpoint\} -{" "} + 之前版本的 SDK 使用`customUrl`属性传递终端，该属性已被弃用。请改用`urlStrategy`配置。 - - + ```js Adjust.initSdk({ @@ -178,18 +166,14 @@ Adjust.initSdk({ }); ``` - + -### 数据驻留 \(已弃用\) {#data-residency} +### 数据驻留 \(已弃用\) \{\#data\-residency\} -{" "} + 之前版本的 SDK 使用的是`dataResidency`属性，该属性已被弃用。请改用`urlStrategy`配置。 - - + ```js Adjust.initSdk({ @@ -206,3 +190,4 @@ Adjust.initSdk({ ``` + From 6f2be8b0a29d631371d2bfbfbd70e067124b4cc0 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 16 Jan 2025 12:37:35 +0000 Subject: [PATCH 36/42] File src/content/docs/en/sdk/web/features/privacy.mdx was translated to ja-JP locale --- .../docs/ja/sdk/web/features/privacy.mdx | 111 ++++++++---------- 1 file changed, 48 insertions(+), 63 deletions(-) diff --git a/src/content/docs/ja/sdk/web/features/privacy.mdx b/src/content/docs/ja/sdk/web/features/privacy.mdx index 6eaf45ab28..2b44505c76 100644 --- a/src/content/docs/ja/sdk/web/features/privacy.mdx +++ b/src/content/docs/ja/sdk/web/features/privacy.mdx @@ -1,44 +1,42 @@ --- -title: プライバシー機能の設定 -description: アプリ内でユーザーのプライバシーを処理するために使用できる機能を設定します。 -slug: ja/sdk/web/features/privacy +title: "プライバシー機能の設定" +description: "アプリ内でユーザーのプライバシーを処理するために使用できる機能を設定します。" +slug: "en/sdk/web/features/privacy" --- - Adjust SDKには、アプリ内でのユーザープライバシーの処理に使用できる機能が含まれています。 -## 消去リクエストを送信する {#send-erasure-request} +消去リクエストを送信する \{\#send\-erasure\-request\} +---------------------------------------------- - + ```js function gdprForgetMe(): void; ``` - + -EUの一般データ保護規則（GDPR）および類似する世界的なプライバシー法（CCPA、LGPDなど）は、個人データの処理に関する包括的な権利をデータ主体に付与しています。これらの権利には、消去権（[GDPR第17条](https://gdpr.eu/article-17-right-to-be-forgotten/)を参照）（[1](https://help.adjust.com/ja/article/gdpr#ref-1)）が含まれます。データ処理者として、Adjustは、（アプリ）ユーザー（データ管理者）からのそのようなリクエストの処理をサポートする義務があります。 +EUの一般データ保護規則（GDPR）および類似する世界的なプライバシー法（CCPA、LGPDなど）は、個人データの処理に関する包括的な権利をデータ主体に付与しています。これらの権利には、消去権（[GDPR第17条](https://gdpr.eu/article-17-right-to-be-forgotten/)を参照）（[1](https://help.adjust.com/en/article/gdpr#ref-1)）が含まれます。データ処理者として、Adjustは、（アプリ）ユーザー（データ管理者）からのそのようなリクエストの処理をサポートする義務があります。 `gdprForgetMe`メソッドを呼び出すことで、ユーザーの消去リクエストをAdjustに送信することができます。Adjustが通知を受けると、以下の対応をします。 -- Adjustはその内部システムおよびデータベースから、履歴として保管されているユーザーの全ての個人データを完全に削除します。 -- Adjustは、Adjust SDKを介して、このユーザー/デバイスからデータを受信しなくなります。（[2](https://help.adjust.com/ja/article/gdpr#ref-2)） +* Adjustはその内部システムおよびデータベースから、履歴として保管されているユーザーの全ての個人データを完全に削除します。 +* Adjustは、Adjust SDKを介して、このユーザー/デバイスからデータを受信しなくなります。（[2](https://help.adjust.com/en/article/gdpr#ref-2)） ```js Adjust.gdprForgetMe(); ``` -## 特定のユーザーの情報をサードパーティと共有する {#third-party-sharing-for-specific-users} +特定のユーザーの情報をサードパーティと共有する \{\#third\-party\-sharing\-for\-specific\-users\} +--------------------------------------------------------------------------------- -{" "} + Adjust SDKを使用して、ユーザーがサードパーティとの共有設定を変更した時にそれを記録することができます。これらの設定は、`ThirdPartySharing`クラスを使用して行われます。 -### AdjustThirdPartySharingオブジェクトをインスタンス化する {#instantiate-an-adjustthirdpartysharing-object} +### AdjustThirdPartySharingオブジェクトをインスタンス化する \{\#instantiate\-an\-adjustthirdpartysharing\-object\} - + ```ts class ThirdPartySharing { @@ -47,13 +45,13 @@ class ThirdPartySharing { } ``` - + Adjust SDKでサードパーティ共有を有効化または無効化するには、`ThirdPartySharing`オブジェクトをインスタンス化する必要があります。このオブジェクトには、Adjustがサードパーティとの共有をどのように扱うかを制御する変数が含まれます。 これをインスタンス化するには、新しい`ThirdPartySharing`インスタンスを作成して、以下のパラメーターをパスしてください： -- `isEnabled` \( `boolean` \) ：`true`をパスしてサードパーティ共有を有効化するか、 `false`をパスして無効化します。 +* `isEnabled` \( `boolean` \) ：`true`をパスしてサードパーティ共有を有効化するか、 `false`をパスして無効化します。 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -68,12 +66,9 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### サードパーティ共有を無効にする（廃止）{#disable-third-party-sharing} +### サードパーティ共有を無効にする（廃止）\{\#disable\-third\-party\-sharing\} -{" "} + 以前のバージョンのSDKでサードパーティとの共有を無効にするには、 `disableThirdPartySharing`メソッドを呼び出します。このメソッドは廃止されました。それでも使用する場合は、基礎となるメソッドを直接呼び出していることに注意してください。 @@ -82,9 +77,9 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(false); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 粒度の高い情報を送信する {#send-granular-information} +### 粒度の高い情報を送信する \{\#send\-granular\-information\} - + ```ts public addGranularOption(partnerName: string, @@ -92,15 +87,15 @@ public addGranularOption(partnerName: string, value: string) ``` - + ユーザーがサードパーティの共有設定を更新すると、詳細な情報を付与できます。この情報を使用して、ユーザー行動についてより詳しく伝えることができます。 これを行うには、以下のパラメーターを使用して`addGranularOption`メソッドを呼び出します： -- `partnerName` （`string`）：granular optionが適用されるパートナーの名前 -- `key` （`string`）：オプションのキー -- `value` （`string`）：オプションの値 +* `partnerName` （`string`）：granular optionが適用されるパートナーの名前 +* `key` （`string`）：オプションのキー +* `value` （`string`）：オプションの値 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -108,37 +103,34 @@ options.addGranularOption("PartnerA", "foo", "bar"); Adjust.trackThirdPartySharing(options); ``` -## URL戦略 {#url-strategy} +URL戦略 \{\#url\-strategy\} +----------------------------- -{" "} + URL戦略機能では、以下のいずれかを設定することができます： -- Adjustがお客様のデータを保管する国（データレジデンシー）。 -- Adjust SDKがトラフィックを送信するエンドポイント（カスタムURL）。 +* Adjustがお客様のデータを保管する国（データレジデンシー）。 +* Adjust SDKがトラフィックを送信するエンドポイント（カスタムURL）。 これは、プライバシー要件が厳しい国で事業を展開している場合に便利です。URL戦略を設定すると、Adjustは選択したデータレジデンシー地域にデータを保管したり、選択したドメインにトラフィックを送信したりします。 URL戦略を設定するには、 `Adjust.initSdk`インスタンスの`urlStrategy`の以下のプロパティを設定します。 -- `domains` （`Array`）：SDKトラフィックを送信する国、データの所在国、またはエンドポイント。デフォルトでは、Adjust SDKは全てのデータをAdjustのエンドポイントに送信します。カスタムエンドポイントを設定する場合は、 `urlStrategy`の`domains`プロパティでパスします。 -- `useSubdomains` （`boolean`）：ドメインをAdjustドメインとして扱うかどうか。 - - - `true`の場合、SDKはドメインの前にAdjust固有のサブドメインを付けます。 - - `false`の場合、SDKは指定されたドメインをプレフィックスなしでそのまま使用します。 +* `domains` （`Array`）：SDKトラフィックを送信する国、データの所在国、またはエンドポイント。デフォルトでは、Adjust SDKは全てのデータをAdjustのエンドポイントに送信します。カスタムエンドポイントを設定する場合は、 `urlStrategy`の`domains`プロパティでパスします。 +* `useSubdomains` （`boolean`）：ドメインをAdjustドメインとして扱うかどうか。 + * `true`の場合、SDKはドメインの前にAdjust固有のサブドメインを付けます。 + * `false`の場合、SDKは指定されたドメインをプレフィックスなしでそのまま使用します。 -- `isDataResidency` （`boolean`）：オプション。ドメインをデータレジデンシーに使用するかどうか。 +* `isDataResidency` （`boolean`）：オプション。ドメインをデータレジデンシーに使用するかどうか。 以下の設定リストをご覧ください。 -| urlStrategy | デフォルトドメインとカスタムドメイン | サブドメインの使用 | データレジデンシー | -| --------------------- | ------------------------------------ | ------------------ | ------------------ | -| EU データレジデンシー | `"eu.adjust.com"` | `true` | `true` | -| 中国 URL戦略 | `"adjust.cn"`。 `"adjust.com"` | `true` | `false` | -| カスタムURL戦略 | `"my.custom.domain"` | `false` | `false` | +| urlStrategy | デフォルトドメインとカスタムドメイン | サブドメインの使用 | データレジデンシー | +|--------------|-------------------------------|-----------|-----------| +| EU データレジデンシー | `"eu.adjust.com"` | `true` | `true` | +| 中国 URL戦略 | `"adjust.cn"`。 `"adjust.com"` | `true` | `false` | +| カスタムURL戦略 | `"my.custom.domain"` | `false` | `false` | ```js Adjust.initSdk({ @@ -153,16 +145,12 @@ Adjust.initSdk({ }); ``` -### カスタムエンドポイントの設定（廃止済み）{#set-custom-endpoint} +### カスタムエンドポイントの設定（廃止済み）\{\#set\-custom\-endpoint\} -{" "} + 以前のバージョンのSDKでは、廃止された`customUrl`プロパティを使用してエンドポイントをパスしていました。今後は`urlStrategy`設定を使用してください。 - - + ```js Adjust.initSdk({ @@ -178,18 +166,14 @@ Adjust.initSdk({ }); ``` - + -### データレジデンシー（廃止済み）{#data-residency} +### データレジデンシー（廃止済み）\{\#data\-residency\} -{" "} + 以前のバージョンのSDKでは、廃止された`dataResidency`プロパティを使用していました。今後は`urlStrategy`設定を使用してください。 - - + ```js Adjust.initSdk({ @@ -206,3 +190,4 @@ Adjust.initSdk({ ``` + From 0c639ae3b7fe3f649858803e037bf1a1eb08bdb0 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 16 Jan 2025 12:37:37 +0000 Subject: [PATCH 37/42] File src/content/docs/en/sdk/web/index.mdx was translated to ko-KR locale --- src/content/docs/ko/sdk/web/index.mdx | 252 ++++---------------------- 1 file changed, 36 insertions(+), 216 deletions(-) diff --git a/src/content/docs/ko/sdk/web/index.mdx b/src/content/docs/ko/sdk/web/index.mdx index 5bdde493b3..b3db0c09c8 100644 --- a/src/content/docs/ko/sdk/web/index.mdx +++ b/src/content/docs/ko/sdk/web/index.mdx @@ -1,271 +1,91 @@ --- -title: Web SDK integration guide -description: Use the Web SDK to access Adjust's features in your web apps -category-title: Web SDK -slug: ko/sdk/web +title: "Web SDK 연동 가이드" +description: "웹 SDK를 사용해 웹앱의 Adjust 기능에 액세스합니다." +category-title: "웹 SDK " +slug: "en/sdk/web" sidebar-position: 8 --- - Adjust 웹 SDK를 사용하면 웹 앱에서 어트리뷰션, 이벤트 및 기타 데이터를 기록할 수 있습니다. 이 가이드에서는 SDK를 앱과 연동하는 방법을 설명합니다. - - + 웹 SDK를 사용하려면 Adjust 대시보드에서 지원 중단된 웹 앱을 생성하고 그 둘을 연결해야 합니다. 웹 SDK를 모바일 앱 SDK가 이미 포함된 모바일 앱과 연동해서는 안 됩니다. + - - -## 1\. Add the SDK to your project {#add-the-sdk-to-your-project} +1\. 프로젝트에 SDK 추가 \{\#add\-the\-sdk\-to\-your\-project\} +---------------------------------------------------------------- 시작하려면 웹 앱에 SDK를 추가합니다. Adjust SDK는 CommonJS와 AMD\(비동기 모듈 정의\) 환경에서 모두 작동합니다. CDN\(콘텐츠 전송 네트워크\)을 통해 로딩될 때 글로벌 `Adjust` 네임스페이스를 통해 액세스할 수 있습니다. -### Using a CDN {#using-a-cdn} +### CDN 사용 \{\#using\-a\-cdn\} CDN을 통해 SDK를 로딩할 때 프로덕션 빌드에 간소화된 버전을 사용해야 합니다. -- 다음과 같이 CDN 대상에 추가하여 특정 버전을 로드할 수 있습니다. `https://cdn.adjust.com/adjust-5.7.0.min.js` -- 최신 버전을 로드하려면 다음과 같이 `adjust-latest` 패키지를 사용합니다. `https://cdn.adjust.com/adjust-latest.min.js` 이 패키지는 자동으로 업데이트되므로 대상 파일을 변경할 필요가 없습니다. +* 다음과 같이 CDN 대상에 추가하여 특정 버전을 로드할 수 있습니다. `https://cdn.adjust.com/adjust-5.7.0.min.js` +* 최신 버전을 로드하려면 다음과 같이 `adjust-latest` 패키지를 사용합니다. `https://cdn.adjust.com/adjust-latest.min.js` 이 패키지는 자동으로 업데이트되므로 대상 파일을 변경할 필요가 없습니다. - + -The SDK files are cached to enable fast service. This cache updates every 30 minutes. If you want to force an update to the latest version, target a specific version in your header. +SDK 파일은 캐시되어 빠른 서비스가 가능합니다. 이 캐시는 30분마다 업데이트됩니다. SDK 파일을 최신 버전으로 강제로 업데이트하려면 헤더에서 특정 버전을 대상으로 지정하시기 바랍니다. + - - -CDN을 통해 SDK를 로드하려면 웹 앱의 `` 요소 안에 다음 스니펫을 추가합니다. +CDN을 통해 SDK를 로드하려면 웹 앱의 `` 요소 안에 다음 스니펫을 추가합니다. \{/\* prettier\-ignore \*/\} ```html - ``` -The Adjust SDK loads on each page and initiates once per page load. +Adjust SDK는 각 페이지에서 로드되며 페이지 로드 시 한 번 초기화됩니다. -#### Subresource Integrity {#subresource-integrity} +#### 하위 리소스 무결성 \{\#subresource\-integrity\} [하위 리소스 무결성](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) 검사를 사용하여 XSS\(사이트 간 스크립팅\) 공격을 완화할 수 있습니다. 패키지를 실행하기 전에 검증하려면 다음 콜\(추가 `crossOrigin`, `integrity`, 인코딩된 해시 확인\)을 사용합니다. \{/\* prettier\-ignore \*/\} ```html - ``` -### Using npm {#using-npm} - -The Adjust SDK is also available on [npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk). To add the package to your project, use your preferred package manager: +### npm 사용 \{\#using\-npm\} - - +Adjust SDK는 [npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk)에서도 사용이 가능합니다. 프로젝트에 패키지를 추가하려면 선호하는 패키지 매니저를 사용하시기 바랍니다. + ```console $ npm install @adjustcom/adjust-web-sdk --save ``` - - + ```console $ yarn add @adjustcom/adjust-web-sdk ``` - - + ```console $ pnpm add @adjustcom/adjust-web-sdk ``` - - + -## 2\. Initialize the SDK {#initialize-the-sdk} +2\. SDK 초기화 \{\#initialize\-the\-sdk\} +-------------------------------------------- SDK를 설치한 후에는 초기화해야 합니다. 해당 기능 사용을 원하는 경우 `initSdk` 메서드를 호출합니다. 이 메서드는 앱에서 SDK가 작동하는 방식을 사용자 지정하는 데 사용할 수 있는 인수를 제공합니다. SDK를 시작하려면 다음 인수를 `initSdk` 호출에 추가해야 합니다. -- `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/ko/article/app-token-and-reporting-currency#view-your-app-details). -- `environment` \(`string`\): SDK를 실행할 환경입니다. - - 테스트 모드에서 SDK를 실행하려면 `sandbox` 를 전달합니다. - - 릴리즈를 위해 프로덕션 모드에서 SDK를 실행하려면 `production` 을 전달합니다. +* `appToken` `string`: [Adjust 앱 토큰](https://help.adjust.com/en/article/app-token-and-reporting-currency#view-your-app-details)입니다. +* `environment` \(`string`\): SDK를 실행할 환경입니다. + * 테스트 모드에서 SDK를 실행하려면 `sandbox` 를 전달합니다. + * 릴리즈를 위해 프로덕션 모드에서 SDK를 실행하려면 `production` 을 전달합니다. ```js Adjust.initSdk({ @@ -274,8 +94,8 @@ Adjust.initSdk({ }); ``` - - -[구성 가이드](/ko/sdk/web/configuration)에서 Adjust 웹 SDK의 전체 인수 및 속성 목록을 확인하실 수 있습니다. + +[구성 가이드](/en/sdk/web/configuration)에서 Adjust 웹 SDK의 전체 인수 및 속성 목록을 확인하실 수 있습니다. + From 4f39d2834052ce21d5eaccbe595bb7ad526e3233 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 16 Jan 2025 12:37:39 +0000 Subject: [PATCH 38/42] File src/content/docs/en/sdk/web/index.mdx was translated to zh-CN locale --- src/content/docs/zh/sdk/web/index.mdx | 252 ++++---------------------- 1 file changed, 36 insertions(+), 216 deletions(-) diff --git a/src/content/docs/zh/sdk/web/index.mdx b/src/content/docs/zh/sdk/web/index.mdx index b920306bd9..36745f3d25 100644 --- a/src/content/docs/zh/sdk/web/index.mdx +++ b/src/content/docs/zh/sdk/web/index.mdx @@ -1,271 +1,91 @@ --- -title: Web SDK integration guide -description: Use the Web SDK to access Adjust's features in your web apps -category-title: Web SDK -slug: zh/sdk/web +title: "Web SDK 集成指南" +description: "使用 Web SDK 在您的 web 应用中使用 Adjust 功能" +category-title: "Web SDK" +slug: "en/sdk/web" sidebar-position: 8 --- - 通过 Adjust Web SDK，您可以在网页应用中记录归因、事件以及更多数据。该指南展示了如何将该 SDK 集成至应用。 - - + 要使用 Web SDK，您必须在 Adjust 控制面板中创建专用的网页应用并将两者关联起来。请勿将 Web SDK 集成到已经包含移动应用 SDK 的移动应用中。 + - - -## 1\. Add the SDK to your project {#add-the-sdk-to-your-project} +1\. 添加 SDK 至您的项目\{\#add\-the\-sdk\-to\-your\-project\} +--------------------------------------------------------------- 要开始设置，请将 SDK 添加至网页应用。Adjust SDK 可在 CommonJS 和 AMD \(Asynchronous Module Definition\) 环境中运行。通过 CDN \(内容分发网络\) 加载时，您可以通过全局`Adjust`命名空间对其进行访问。 -### Using a CDN {#using-a-cdn} +### 使用 CDN \{\#using\-a\-cdn\} 通过 CDN 加载 SDK 时，您应该在生产环境中使用压缩版本。 -- 您可以通过添加一个版本至 CDN 目标来加载指定版本，如下所示：`https://cdn.adjust.com/adjust-5.7.0.min.js`。 -- 要加载最新版本，请使用`adjust-latest`包，如下所示：`https://cdn.adjust.com/adjust-latest.min.js`。该包会自动更新，您无需更改目标文件。 +* 您可以通过添加一个版本至 CDN 目标来加载指定版本，如下所示：`https://cdn.adjust.com/adjust-5.7.0.min.js`。 +* 要加载最新版本，请使用`adjust-latest`包，如下所示：`https://cdn.adjust.com/adjust-latest.min.js`。该包会自动更新，您无需更改目标文件。 - + -The SDK files are cached to enable fast service. This cache updates every 30 minutes. If you want to force an update to the latest version, target a specific version in your header. +SDK 文件会被缓存，确保服务速度。缓存每 30 分钟更新。如果您想强制更新当前版本，请在标头中定向特定版本。 + - - -要通过 CDN 加载 SDK，请将以下代码片段加入网页应用的``元素中： +要通过 CDN 加载 SDK，请将以下代码片段加入网页应用的``元素中： \{/\* prettier\-ignore \*/\} ```html - ``` -The Adjust SDK loads on each page and initiates once per page load. +Adjust SDK 会在每个页面上加载并初始化。 -#### Subresource Integrity {#subresource-integrity} +#### 子资源完整性\{\#subresource\-integrity\} 请使用[子资源完整性](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity)检查来抵御 XSS \(跨站脚本\) 攻击。要在运行包之前对其进行验证，请使用以下调用 \(请注意额外的`crossOrigin` 、 `integrity`和经过编码的哈希值\): \{/\* prettier\-ignore \*/\} ```html - ``` -### Using npm {#using-npm} - -The Adjust SDK is also available on [npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk). To add the package to your project, use your preferred package manager: +### 使用 npm \{\#using\-npm\} - - +Adjust SDK 还可用于 [npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk)。要将包加入您的项目，请使用您常用的包管理器： + ```console $ npm install @adjustcom/adjust-web-sdk --save ``` - - + ```console $ yarn add @adjustcom/adjust-web-sdk ``` - - + ```console $ pnpm add @adjustcom/adjust-web-sdk ``` - - + -## 2\. Initialize the SDK {#initialize-the-sdk} +2\. 初始化 SDK\{\#initialize\-the\-sdk\} +------------------------------------------- 安装 SDK 后，需要进行初始化。为此，请调用`initSdk`方法。您可以使用该方法中的参数来自定义 SDK 在应用中的工作方式。 要初始化 SDK，您必须将以下参数添加至`initSdk`调用： -- `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/zh/article/app-token-and-reporting-currency#view-your-app-details). -- `environment` \(`string`\)：SDK 运行的环境。 - - 传递`sandbox`来在测试模式下运行 SDK。 - - 传递 `production`来在生产模式下运行 SDK，方便发布。 +* `appToken` \(`string`\)：您的 [Adjust 应用识别码](https://help.adjust.com/en/article/app-token-and-reporting-currency#view-your-app-details)。 +* `environment` \(`string`\)：SDK 运行的环境。 + * 传递`sandbox`来在测试模式下运行 SDK。 + * 传递 `production`来在生产模式下运行 SDK，方便发布。 ```js Adjust.initSdk({ @@ -274,8 +94,8 @@ Adjust.initSdk({ }); ``` - - -您可以在[配置指南](/zh/sdk/web/configuration)中找到 Adjust Web SDK 参数和属性的完整列表。 + +您可以在[配置指南](/en/sdk/web/configuration)中找到 Adjust Web SDK 参数和属性的完整列表。 + From aaacce19cdd1787bc987cfdbae7c06f83b284377 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 16 Jan 2025 12:37:41 +0000 Subject: [PATCH 39/42] File src/content/docs/en/sdk/web/index.mdx was translated to ja-JP locale --- src/content/docs/ja/sdk/web/index.mdx | 252 ++++---------------------- 1 file changed, 36 insertions(+), 216 deletions(-) diff --git a/src/content/docs/ja/sdk/web/index.mdx b/src/content/docs/ja/sdk/web/index.mdx index 6ec09b78fa..472459bb37 100644 --- a/src/content/docs/ja/sdk/web/index.mdx +++ b/src/content/docs/ja/sdk/web/index.mdx @@ -1,271 +1,91 @@ --- -title: Web SDK integration guide -description: Use the Web SDK to access Adjust's features in your web apps -category-title: Web SDK -slug: ja/sdk/web +title: "Web SDK 連携ガイド" +description: "Web SDKを使用して、WebアプリでAdjustの機能にアクセスしましょう。" +category-title: "Web SDK" +slug: "en/sdk/web" sidebar-position: 8 --- - Adjust Web SDKを実装することで、アトリビューションやイベントなどのさまざまなデータをWebアプリで記録できます。このガイドでは、Adjust SDKをアプリに実装する方法をご紹介します。 - - + Web SDKを使用するには、Adjustダッシュボードで専用のWebアプリを作成し、その2つを連携する必要があります。モバイルアプリSDKが既に実装されているモバイルアプリには、Web SDKを実装しないでください。 + - - -## 1\. Add the SDK to your project {#add-the-sdk-to-your-project} +1\. プロジェクトにSDKを追加する \{\#add\-the\-sdk\-to\-your\-project\} +------------------------------------------------------------------- まずは、WebアプリにSDKを追加します。Adjust SDKは、CommonJSとAMD（Asynchronous Module Definition）の両方の環境で動作します。CDN（Content Delivery Network）を利用して読み込むと、グローバルの`Adjust`名前空間を介してアクセスできます。 -### Using a CDN {#using-a-cdn} +### CDNを使用する \{\#using\-a\-cdn\} CDNを利用してSDKを読み込むときは、本番用ビルドには縮小バージョンを使用する必要があります。 -- バージョンを指定するには、`https://cdn.adjust.com/adjust-5.7.0.min.js`のようにCDNターゲットに追加します。 -- 最新バージョンを読み込むには、次のように`adjust-latest`パッケージを使用してください：`https://cdn.adjust.com/adjust-latest.min.js` 。このパッケージは自動的にアップデートされるため、ターゲットファイルを変更する必要はありません。 +* バージョンを指定するには、`https://cdn.adjust.com/adjust-5.7.0.min.js`のようにCDNターゲットに追加します。 +* 最新バージョンを読み込むには、次のように`adjust-latest`パッケージを使用してください：`https://cdn.adjust.com/adjust-latest.min.js` 。このパッケージは自動的にアップデートされるため、ターゲットファイルを変更する必要はありません。 - + -The SDK files are cached to enable fast service. This cache updates every 30 minutes. If you want to force an update to the latest version, target a specific version in your header. +SDKのファイルは、迅速なサービスを実現するためにキャッシュされます。このキャッシュは30分ごとに更新されます。強制的に最新バージョンに更新する場合は、ヘッダーで特定のバージョンをターゲットにしてください。 + - - -CDNを利用してSDKを読み込むには、Webアプリの``タグ間に次のスニペットを追加します。 +CDNを利用してSDKを読み込むには、Webアプリの``タグ間に次のスニペットを追加します。 \{/\* prettier\-ignore \*/\} ```html - ``` -The Adjust SDK loads on each page and initiates once per page load. +Adjust SDKはページごとに読み込まれ、ページの読み込みごとに1回起動されます。 -#### Subresource Integrity {#subresource-integrity} +#### サブリソース完全性 \{\#subresource\-integrity\} XSS（クロスサイトスクリプティング）攻撃を緩和するために、[サブリソース完全性](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity)チェックを使用します。実行前にパッケージを検証するには、次のコールを使用します（追加の`crossOrigin`、 `integrity`、およびエンコードされたハッシュにご留意ください）。 \{/\* prettier\-ignore \*/\} ```html - ``` -### Using npm {#using-npm} - -The Adjust SDK is also available on [npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk). To add the package to your project, use your preferred package manager: +### npmを使用する \{\#using\-npm\} - - +Adjust SDKは[npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk)でも提供されています。パッケージをプロジェクトに追加するには、好みのパッケージマネージャーを使用します。 + ```console $ npm install @adjustcom/adjust-web-sdk --save ``` - - + ```console $ yarn add @adjustcom/adjust-web-sdk ``` - - + ```console $ pnpm add @adjustcom/adjust-web-sdk ``` - - + -## 2\. Initialize the SDK {#initialize-the-sdk} +2\. SDKを初期化する \{\#initialize\-the\-sdk\} +---------------------------------------------- SDKをインストールしたら初期化する必要があります。これを行うには、`initSdk`メソッドを呼び出してください。このメソッドには、アプリでのSDKの動作をカスタマイズするために使用できる引数があります。 SDKを初期化するには、 `initSdk`の呼び出しに次の引数を追加する必要があります。 -- `appToken` \(`string`\): Your [Adjust app token](https://help.adjust.com/ja/article/app-token-and-reporting-currency#view-your-app-details). -- `environment` （`string`）：SDKを実行したい環境。 - - SDKをテストモードで実行するには、 `sandbox`をパスします。 - - リリースの本番用モードでSDKを実行するには、 `production`をパスします。 +* `appToken` （`string`）：お客様の[Adjustアプリトークン](https://help.adjust.com/en/article/app-token-and-reporting-currency#view-your-app-details)。 +* `environment` （`string`）：SDKを実行したい環境。 + * SDKをテストモードで実行するには、 `sandbox`をパスします。 + * リリースの本番用モードでSDKを実行するには、 `production`をパスします。 ```js Adjust.initSdk({ @@ -274,8 +94,8 @@ Adjust.initSdk({ }); ``` - - -AdjustのWeb SDKの引数とプロパティの全リストは、[設定ガイド](/ja/sdk/web/configuration)をご覧ください。 + +AdjustのWeb SDKの引数とプロパティの全リストは、[設定ガイド](/en/sdk/web/configuration)をご覧ください。 + From 1f3e7363779ce0258c04758c674ada3c2945d09d Mon Sep 17 00:00:00 2001 From: github-actions <41898282+github-actions[bot]@users.noreply.github.com> Date: Thu, 16 Jan 2025 12:38:09 +0000 Subject: [PATCH 40/42] Fix translated and formatted files --- .../docs/ja/sdk/web/features/attribution.mdx | 68 ++--- .../docs/ja/sdk/web/features/device-info.mdx | 16 +- .../docs/ja/sdk/web/features/privacy.mdx | 111 ++++---- src/content/docs/ja/sdk/web/index.mdx | 246 +++++++++++++++--- .../docs/ko/sdk/web/features/attribution.mdx | 70 ++--- .../docs/ko/sdk/web/features/device-info.mdx | 16 +- .../docs/ko/sdk/web/features/privacy.mdx | 111 ++++---- src/content/docs/ko/sdk/web/index.mdx | 244 ++++++++++++++--- .../docs/zh/sdk/web/features/attribution.mdx | 68 ++--- .../docs/zh/sdk/web/features/device-info.mdx | 16 +- .../docs/zh/sdk/web/features/privacy.mdx | 111 ++++---- src/content/docs/zh/sdk/web/index.mdx | 246 +++++++++++++++--- 12 files changed, 963 insertions(+), 360 deletions(-) diff --git a/src/content/docs/ja/sdk/web/features/attribution.mdx b/src/content/docs/ja/sdk/web/features/attribution.mdx index 978dd09c60..bda772281b 100644 --- a/src/content/docs/ja/sdk/web/features/attribution.mdx +++ b/src/content/docs/ja/sdk/web/features/attribution.mdx @@ -1,12 +1,14 @@ --- -title: "アトリビューション情報の取得" -description: "Adjust SDKを使ってアトリビューションの変更を受信します。" -slug: "en/sdk/web/features/attribution" +title: アトリビューション情報の取得 +description: Adjust SDKを使ってアトリビューションの変更を受信します。 +slug: ja/sdk/web/features/attribution --- -ユーザーがAdjustリンクをクリックすると、そのアトリビューション情報が更新されます。これは、ユーザーが[ディープリンク](https://help.adjust.com/en/article/deep-links)をクリックした場合に発生します。ユーザーのアトリビューションについての情報は、アトリビューションオブジェクトに表示されます。 + +ユーザーがAdjustリンクをクリックすると、そのアトリビューション情報が更新されます。これは、ユーザーが[ディープリンク](https://help.adjust.com/ja/article/deep-links)をクリックした場合に発生します。ユーザーのアトリビューションについての情報は、アトリビューションオブジェクトに表示されます。 アトリビューションオブジェクトは以下の情報を含んでいます。 - + + ```js export type AttributionMapT = $ReadOnly<{| @@ -22,30 +24,29 @@ export type AttributionMapT = $ReadOnly<{| |}>; ``` - + -| 値 | データタイプ | 説明 | -|-----------------|----------|-------------------------------------------------------------------------------| -| `adid` | `string` | デバイス固有のAdjust識別子 | -| `tracker_token` | `string` | アトリビューションに関連付けられているリンクトークン | -| `tracker_name` | `string` | キャンペーンリンクの名前 | -| `network` | `string` | キャンペーンに関連付けられているネットワーク | -| `campaign` | `string` | アトリビューションに関連付けられているキャンペーンの名前 | -| `adgroup` | `string` | アトリビューションに関連付けられているアドグループ | -| `creative` | `string` | アトリビューションに関連付けられているクリエイティブ | -| `click_label` | `string` | アトリビューションに関連付けられている[クリックラベル](https://help.adjust.com/en/article/user-rewards) | -| `state` | `string` | アトリビューションの現在のステータス。`installed`または `reattributed` | +| 値 | データタイプ | 説明 | +| --------------- | ------------ | ------------------------------------------------------------------------------------------------------- | +| `adid` | `string` | デバイス固有のAdjust識別子 | +| `tracker_token` | `string` | アトリビューションに関連付けられているリンクトークン | +| `tracker_name` | `string` | キャンペーンリンクの名前 | +| `network` | `string` | キャンペーンに関連付けられているネットワーク | +| `campaign` | `string` | アトリビューションに関連付けられているキャンペーンの名前 | +| `adgroup` | `string` | アトリビューションに関連付けられているアドグループ | +| `creative` | `string` | アトリビューションに関連付けられているクリエイティブ | +| `click_label` | `string` | アトリビューションに関連付けられている[クリックラベル](https://help.adjust.com/ja/article/user-rewards) | +| `state` | `string` | アトリビューションの現在のステータス。`installed`または `reattributed` | -アトリビューションの変更時にコールバックをトリガーする \{\#trigger\-a\-callback\-when\-attribution\-changes\} ------------------------------------------------------------------------------------------- +## アトリビューションの変更時にコールバックをトリガーする \{\#trigger\-a\-callback\-when\-attribution\-changes\} - + ```js attributionCallback: (string, Object) => mixed; ``` - + SDKはアトリビューションの変更を受信し、更新を検出したときに関数を呼び出すことができます。アトリビューションコールバックメソッドを設定するには、`initSdk`メソッドで`attributionCallback`関数を指定します。関数内で、ユーザーのアトリビューション情報にアクセスすることができます。 @@ -67,10 +68,12 @@ Adjust.initSdk({ }); ``` -現在のアトリビューション情報を取得する \{\#get\-current\-attribution\-information\} ----------------------------------------------------------------------- +## 現在のアトリビューション情報を取得する \{\#get\-current\-attribution\-information\} - +{" "} ユーザーがアプリをインストールすると、Adjustはそのインストールをキャンペーンにアトリビュートします。Adjust SDKを実装することで、インストールのキャンペーンアトリビューションの詳細にアクセスすることが可能です。`waitForAttribution`メソッドは、SDKがサーバーからアトリビューションデータを正常に受信すると解析される`promise`を返します。 @@ -80,29 +83,30 @@ Adjust.waitForAttribution().then((attr) => ); ``` -リファラーを設定する \{\#set\-a\-referrer\} --------------------------------------- +## リファラーを設定する \{\#set\-a\-referrer\} - + ```js function setReferrer(referrer: string): void; ``` - + SDKの開始時にカスタムクリックIDでSDKクリックのトリガーとなるリファラーを設定することができます。SDKは、アトリビューションの目的でカスタムクリックIDをAdjustのサーバーに送信します。 - + + アトリビューションにリファラーが使用されるように、SDKの初期化時にできる限り近い時点でこのメソッドを呼び出してください。 - + + リファラーを設定するには、`setReferrer`メソッドを呼び出し、URLエンコードされた`string`引数としてリファラーをパスします。 - + + ```js Adjust.setReferrer("adjust_external_click_id%3DEXTERNAL_CLICK_ID"); ``` - diff --git a/src/content/docs/ja/sdk/web/features/device-info.mdx b/src/content/docs/ja/sdk/web/features/device-info.mdx index 4c5badf3c1..90fe7f040b 100644 --- a/src/content/docs/ja/sdk/web/features/device-info.mdx +++ b/src/content/docs/ja/sdk/web/features/device-info.mdx @@ -1,14 +1,17 @@ --- -title: "デバイス情報を取得" -description: "これらのメソッドを使用することでコールバックに詳細を追加し、レポートを改善させましょう。" -slug: "en/sdk/web/features/device-info" +title: デバイス情報を取得 +description: これらのメソッドを使用することでコールバックに詳細を追加し、レポートを改善させましょう。 +slug: ja/sdk/web/features/device-info --- + Adjust SDKには、デバイス情報を返すヘルパーメソッドが含まれています。これらのメソッドを使用することでコールバックに詳細を追加し、レポートを改善させましょう。 -Web UUID \{\#web\-uuid\} ----------------------------- +## Web UUID \{\#web\-uuid\} - +{" "} AdjustがWebユーザーを識別するために、Web SDKはセッションを送信する際に一意の`web_uuid`を生成します。IDはUniversally Unique Identifier（UUID）のフォーマットです。 @@ -19,4 +22,3 @@ AdjustがWebユーザーを識別するために、Web SDKはセッションを ```js Adjust.waitForWebUUID().then((webUuid) => console.log(webUuid)); ``` - diff --git a/src/content/docs/ja/sdk/web/features/privacy.mdx b/src/content/docs/ja/sdk/web/features/privacy.mdx index 2b44505c76..3e90874118 100644 --- a/src/content/docs/ja/sdk/web/features/privacy.mdx +++ b/src/content/docs/ja/sdk/web/features/privacy.mdx @@ -1,42 +1,44 @@ --- -title: "プライバシー機能の設定" -description: "アプリ内でユーザーのプライバシーを処理するために使用できる機能を設定します。" -slug: "en/sdk/web/features/privacy" +title: プライバシー機能の設定 +description: アプリ内でユーザーのプライバシーを処理するために使用できる機能を設定します。 +slug: ja/sdk/web/features/privacy --- + Adjust SDKには、アプリ内でのユーザープライバシーの処理に使用できる機能が含まれています。 -消去リクエストを送信する \{\#send\-erasure\-request\} ----------------------------------------------- +## 消去リクエストを送信する \{\#send\-erasure\-request\} - + ```js function gdprForgetMe(): void; ``` - + -EUの一般データ保護規則（GDPR）および類似する世界的なプライバシー法（CCPA、LGPDなど）は、個人データの処理に関する包括的な権利をデータ主体に付与しています。これらの権利には、消去権（[GDPR第17条](https://gdpr.eu/article-17-right-to-be-forgotten/)を参照）（[1](https://help.adjust.com/en/article/gdpr#ref-1)）が含まれます。データ処理者として、Adjustは、（アプリ）ユーザー（データ管理者）からのそのようなリクエストの処理をサポートする義務があります。 +EUの一般データ保護規則（GDPR）および類似する世界的なプライバシー法（CCPA、LGPDなど）は、個人データの処理に関する包括的な権利をデータ主体に付与しています。これらの権利には、消去権（[GDPR第17条](https://gdpr.eu/article-17-right-to-be-forgotten/)を参照）（[1](https://help.adjust.com/ja/article/gdpr#ref-1)）が含まれます。データ処理者として、Adjustは、（アプリ）ユーザー（データ管理者）からのそのようなリクエストの処理をサポートする義務があります。 `gdprForgetMe`メソッドを呼び出すことで、ユーザーの消去リクエストをAdjustに送信することができます。Adjustが通知を受けると、以下の対応をします。 -* Adjustはその内部システムおよびデータベースから、履歴として保管されているユーザーの全ての個人データを完全に削除します。 -* Adjustは、Adjust SDKを介して、このユーザー/デバイスからデータを受信しなくなります。（[2](https://help.adjust.com/en/article/gdpr#ref-2)） +- Adjustはその内部システムおよびデータベースから、履歴として保管されているユーザーの全ての個人データを完全に削除します。 +- Adjustは、Adjust SDKを介して、このユーザー/デバイスからデータを受信しなくなります。（[2](https://help.adjust.com/ja/article/gdpr#ref-2)） ```js Adjust.gdprForgetMe(); ``` -特定のユーザーの情報をサードパーティと共有する \{\#third\-party\-sharing\-for\-specific\-users\} ---------------------------------------------------------------------------------- +## 特定のユーザーの情報をサードパーティと共有する \{\#third\-party\-sharing\-for\-specific\-users\} - +{" "} Adjust SDKを使用して、ユーザーがサードパーティとの共有設定を変更した時にそれを記録することができます。これらの設定は、`ThirdPartySharing`クラスを使用して行われます。 -### AdjustThirdPartySharingオブジェクトをインスタンス化する \{\#instantiate\-an\-adjustthirdpartysharing\-object\} +### AdjustThirdPartySharingオブジェクトをインスタンス化する {#instantiate-an-adjustthirdpartysharing-object} - + ```ts class ThirdPartySharing { @@ -45,13 +47,13 @@ class ThirdPartySharing { } ``` - + Adjust SDKでサードパーティ共有を有効化または無効化するには、`ThirdPartySharing`オブジェクトをインスタンス化する必要があります。このオブジェクトには、Adjustがサードパーティとの共有をどのように扱うかを制御する変数が含まれます。 これをインスタンス化するには、新しい`ThirdPartySharing`インスタンスを作成して、以下のパラメーターをパスしてください： -* `isEnabled` \( `boolean` \) ：`true`をパスしてサードパーティ共有を有効化するか、 `false`をパスして無効化します。 +- `isEnabled` \( `boolean` \) ：`true`をパスしてサードパーティ共有を有効化するか、 `false`をパスして無効化します。 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -66,9 +68,12 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### サードパーティ共有を無効にする（廃止）\{\#disable\-third\-party\-sharing\} +### サードパーティ共有を無効にする（廃止）{#disable-third-party-sharing} - +{" "} 以前のバージョンのSDKでサードパーティとの共有を無効にするには、 `disableThirdPartySharing`メソッドを呼び出します。このメソッドは廃止されました。それでも使用する場合は、基礎となるメソッドを直接呼び出していることに注意してください。 @@ -77,9 +82,9 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(false); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 粒度の高い情報を送信する \{\#send\-granular\-information\} +### 粒度の高い情報を送信する {#send-granular-information} - + ```ts public addGranularOption(partnerName: string, @@ -87,15 +92,15 @@ public addGranularOption(partnerName: string, value: string) ``` - + ユーザーがサードパーティの共有設定を更新すると、詳細な情報を付与できます。この情報を使用して、ユーザー行動についてより詳しく伝えることができます。 これを行うには、以下のパラメーターを使用して`addGranularOption`メソッドを呼び出します： -* `partnerName` （`string`）：granular optionが適用されるパートナーの名前 -* `key` （`string`）：オプションのキー -* `value` （`string`）：オプションの値 +- `partnerName` （`string`）：granular optionが適用されるパートナーの名前 +- `key` （`string`）：オプションのキー +- `value` （`string`）：オプションの値 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -103,34 +108,37 @@ options.addGranularOption("PartnerA", "foo", "bar"); Adjust.trackThirdPartySharing(options); ``` -URL戦略 \{\#url\-strategy\} ------------------------------ +## URL戦略 \{\#url\-strategy\} - +{" "} URL戦略機能では、以下のいずれかを設定することができます： -* Adjustがお客様のデータを保管する国（データレジデンシー）。 -* Adjust SDKがトラフィックを送信するエンドポイント（カスタムURL）。 +- Adjustがお客様のデータを保管する国（データレジデンシー）。 +- Adjust SDKがトラフィックを送信するエンドポイント（カスタムURL）。 これは、プライバシー要件が厳しい国で事業を展開している場合に便利です。URL戦略を設定すると、Adjustは選択したデータレジデンシー地域にデータを保管したり、選択したドメインにトラフィックを送信したりします。 URL戦略を設定するには、 `Adjust.initSdk`インスタンスの`urlStrategy`の以下のプロパティを設定します。 -* `domains` （`Array`）：SDKトラフィックを送信する国、データの所在国、またはエンドポイント。デフォルトでは、Adjust SDKは全てのデータをAdjustのエンドポイントに送信します。カスタムエンドポイントを設定する場合は、 `urlStrategy`の`domains`プロパティでパスします。 -* `useSubdomains` （`boolean`）：ドメインをAdjustドメインとして扱うかどうか。 - * `true`の場合、SDKはドメインの前にAdjust固有のサブドメインを付けます。 - * `false`の場合、SDKは指定されたドメインをプレフィックスなしでそのまま使用します。 +- `domains` （`Array`）：SDKトラフィックを送信する国、データの所在国、またはエンドポイント。デフォルトでは、Adjust SDKは全てのデータをAdjustのエンドポイントに送信します。カスタムエンドポイントを設定する場合は、 `urlStrategy`の`domains`プロパティでパスします。 +- `useSubdomains` （`boolean`）：ドメインをAdjustドメインとして扱うかどうか。 + + - `true`の場合、SDKはドメインの前にAdjust固有のサブドメインを付けます。 + - `false`の場合、SDKは指定されたドメインをプレフィックスなしでそのまま使用します。 -* `isDataResidency` （`boolean`）：オプション。ドメインをデータレジデンシーに使用するかどうか。 +- `isDataResidency` （`boolean`）：オプション。ドメインをデータレジデンシーに使用するかどうか。 以下の設定リストをご覧ください。 -| urlStrategy | デフォルトドメインとカスタムドメイン | サブドメインの使用 | データレジデンシー | -|--------------|-------------------------------|-----------|-----------| -| EU データレジデンシー | `"eu.adjust.com"` | `true` | `true` | -| 中国 URL戦略 | `"adjust.cn"`。 `"adjust.com"` | `true` | `false` | -| カスタムURL戦略 | `"my.custom.domain"` | `false` | `false` | +| urlStrategy | デフォルトドメインとカスタムドメイン | サブドメインの使用 | データレジデンシー | +| --------------------- | ------------------------------------ | ------------------ | ------------------ | +| EU データレジデンシー | `"eu.adjust.com"` | `true` | `true` | +| 中国 URL戦略 | `"adjust.cn"`。 `"adjust.com"` | `true` | `false` | +| カスタムURL戦略 | `"my.custom.domain"` | `false` | `false` | ```js Adjust.initSdk({ @@ -145,12 +153,16 @@ Adjust.initSdk({ }); ``` -### カスタムエンドポイントの設定（廃止済み）\{\#set\-custom\-endpoint\} +### カスタムエンドポイントの設定（廃止済み）{#set-custom-endpoint} - +{" "} 以前のバージョンのSDKでは、廃止された`customUrl`プロパティを使用してエンドポイントをパスしていました。今後は`urlStrategy`設定を使用してください。 - + + ```js Adjust.initSdk({ @@ -166,14 +178,18 @@ Adjust.initSdk({ }); ``` - + -### データレジデンシー（廃止済み）\{\#data\-residency\} +### データレジデンシー（廃止済み）{#data-residency} - +{" "} 以前のバージョンのSDKでは、廃止された`dataResidency`プロパティを使用していました。今後は`urlStrategy`設定を使用してください。 - + + ```js Adjust.initSdk({ @@ -190,4 +206,3 @@ Adjust.initSdk({ ``` - diff --git a/src/content/docs/ja/sdk/web/index.mdx b/src/content/docs/ja/sdk/web/index.mdx index 472459bb37..270d80e245 100644 --- a/src/content/docs/ja/sdk/web/index.mdx +++ b/src/content/docs/ja/sdk/web/index.mdx @@ -1,91 +1,271 @@ --- -title: "Web SDK 連携ガイド" -description: "Web SDKを使用して、WebアプリでAdjustの機能にアクセスしましょう。" -category-title: "Web SDK" -slug: "en/sdk/web" +title: Web SDK 連携ガイド +description: Web SDKを使用して、WebアプリでAdjustの機能にアクセスしましょう。 +category-title: Web SDK +slug: ja/sdk/web sidebar-position: 8 --- + Adjust Web SDKを実装することで、アトリビューションやイベントなどのさまざまなデータをWebアプリで記録できます。このガイドでは、Adjust SDKをアプリに実装する方法をご紹介します。 - + + Web SDKを使用するには、Adjustダッシュボードで専用のWebアプリを作成し、その2つを連携する必要があります。モバイルアプリSDKが既に実装されているモバイルアプリには、Web SDKを実装しないでください。 - -1\. プロジェクトにSDKを追加する \{\#add\-the\-sdk\-to\-your\-project\} -------------------------------------------------------------------- + + +## 1\. プロジェクトにSDKを追加する \{\#add\-the\-sdk\-to\-your\-project\} まずは、WebアプリにSDKを追加します。Adjust SDKは、CommonJSとAMD（Asynchronous Module Definition）の両方の環境で動作します。CDN（Content Delivery Network）を利用して読み込むと、グローバルの`Adjust`名前空間を介してアクセスできます。 -### CDNを使用する \{\#using\-a\-cdn\} +### CDNを使用する {#using-a-cdn} CDNを利用してSDKを読み込むときは、本番用ビルドには縮小バージョンを使用する必要があります。 -* バージョンを指定するには、`https://cdn.adjust.com/adjust-5.7.0.min.js`のようにCDNターゲットに追加します。 -* 最新バージョンを読み込むには、次のように`adjust-latest`パッケージを使用してください：`https://cdn.adjust.com/adjust-latest.min.js` 。このパッケージは自動的にアップデートされるため、ターゲットファイルを変更する必要はありません。 +- バージョンを指定するには、`https://cdn.adjust.com/adjust-5.7.0.min.js`のようにCDNターゲットに追加します。 +- 最新バージョンを読み込むには、次のように`adjust-latest`パッケージを使用してください：`https://cdn.adjust.com/adjust-latest.min.js` 。このパッケージは自動的にアップデートされるため、ターゲットファイルを変更する必要はありません。 - + SDKのファイルは、迅速なサービスを実現するためにキャッシュされます。このキャッシュは30分ごとに更新されます。強制的に最新バージョンに更新する場合は、ヘッダーで特定のバージョンをターゲットにしてください。 - -CDNを利用してSDKを読み込むには、Webアプリの``タグ間に次のスニペットを追加します。 + + +CDNを利用してSDKを読み込むには、Webアプリの``タグ間に次のスニペットを追加します。 \{/\* prettier\-ignore \*/\} ```html - ``` Adjust SDKはページごとに読み込まれ、ページの読み込みごとに1回起動されます。 -#### サブリソース完全性 \{\#subresource\-integrity\} +#### サブリソース完全性 {#subresource-integrity} XSS（クロスサイトスクリプティング）攻撃を緩和するために、[サブリソース完全性](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity)チェックを使用します。実行前にパッケージを検証するには、次のコールを使用します（追加の`crossOrigin`、 `integrity`、およびエンコードされたハッシュにご留意ください）。 \{/\* prettier\-ignore \*/\} ```html - ``` -### npmを使用する \{\#using\-npm\} +### npmを使用する {#using-npm} Adjust SDKは[npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk)でも提供されています。パッケージをプロジェクトに追加するには、好みのパッケージマネージャーを使用します。 - + + + ```console $ npm install @adjustcom/adjust-web-sdk --save ``` - + + ```console $ yarn add @adjustcom/adjust-web-sdk ``` - + + ```console $ pnpm add @adjustcom/adjust-web-sdk ``` - + + -2\. SDKを初期化する \{\#initialize\-the\-sdk\} ----------------------------------------------- +## 2\. SDKを初期化する \{\#initialize\-the\-sdk\} SDKをインストールしたら初期化する必要があります。これを行うには、`initSdk`メソッドを呼び出してください。このメソッドには、アプリでのSDKの動作をカスタマイズするために使用できる引数があります。 SDKを初期化するには、 `initSdk`の呼び出しに次の引数を追加する必要があります。 -* `appToken` （`string`）：お客様の[Adjustアプリトークン](https://help.adjust.com/en/article/app-token-and-reporting-currency#view-your-app-details)。 -* `environment` （`string`）：SDKを実行したい環境。 - * SDKをテストモードで実行するには、 `sandbox`をパスします。 - * リリースの本番用モードでSDKを実行するには、 `production`をパスします。 +- `appToken` （`string`）：お客様の[Adjustアプリトークン](https://help.adjust.com/ja/article/app-token-and-reporting-currency#view-your-app-details)。 +- `environment` （`string`）：SDKを実行したい環境。 + - SDKをテストモードで実行するには、 `sandbox`をパスします。 + - リリースの本番用モードでSDKを実行するには、 `production`をパスします。 ```js Adjust.initSdk({ @@ -94,8 +274,8 @@ Adjust.initSdk({ }); ``` - + -AdjustのWeb SDKの引数とプロパティの全リストは、[設定ガイド](/en/sdk/web/configuration)をご覧ください。 - +AdjustのWeb SDKの引数とプロパティの全リストは、[設定ガイド](/ja/sdk/web/configuration)をご覧ください。 + diff --git a/src/content/docs/ko/sdk/web/features/attribution.mdx b/src/content/docs/ko/sdk/web/features/attribution.mdx index 65e715eabc..1bf5764cf4 100644 --- a/src/content/docs/ko/sdk/web/features/attribution.mdx +++ b/src/content/docs/ko/sdk/web/features/attribution.mdx @@ -1,12 +1,14 @@ --- -title: "어트리뷰션 정보 확인" -description: "Adjust SDK를 사용하여 어트리뷰션 변경 사항 수신" -slug: "en/sdk/web/features/attribution" +title: 어트리뷰션 정보 확인 +description: Adjust SDK를 사용하여 어트리뷰션 변경 사항 수신 +slug: ko/sdk/web/features/attribution --- -사용자가 Adjust 링크와 상호작용하면 어트리뷰션 정보가 업데이트됩니다. 이는 사용자가 [딥링크](https://help.adjust.com/en/article/deep-links)와 상호작용하는 경우에 발생할 수 있습니다. 사용자의 어트리뷰션 관련 정보는 어트리뷰션 객체에 나타납니다. + +사용자가 Adjust 링크와 상호작용하면 어트리뷰션 정보가 업데이트됩니다. 이는 사용자가 [딥링크](https://help.adjust.com/ko/article/deep-links)와 상호작용하는 경우에 발생할 수 있습니다. 사용자의 어트리뷰션 관련 정보는 어트리뷰션 객체에 나타납니다. 어트리뷰션 객체에는 다음 정보가 포함됩니다. - + + ```js export type AttributionMapT = $ReadOnly<{| @@ -22,32 +24,31 @@ export type AttributionMapT = $ReadOnly<{| |}>; ``` - + -| 값 | 데이터 유형 | 설명 | -|-----------------|----------|-----------------------------------------------------------------------| -| `adid` | `string` | 기기의 고유한 Adjust 식별자. | -| `tracker_token` | `string` | 어트리뷰션과 관련된 링크 토큰. | -| `tracker_name` | `string` | 캠페인 링크의 이름. | -| `network` | `string` | 캠페인과 관련된 네트워크. | -| `campaign` | `string` | 어트리뷰션과 관련된 캠페인의 이름. | -| `adgroup` | `string` | 어트리뷰션과 관련된 광고그룹. | -| `creative` | `string` | 어트리뷰션과 관련된 크리에이티브. | -| `click_label` | `string` | 어트리뷰션과 관련된 [클릭 레이블](https://help.adjust.com/en/article/user-rewards). | -| `state` | `string` | 어트리뷰션의 현재 상태. `installed` 또는 `reattributed` | +| 값 | 데이터 유형 | 설명 | +| --------------- | ----------- | ----------------------------------------------------------------------------------- | +| `adid` | `string` | 기기의 고유한 Adjust 식별자. | +| `tracker_token` | `string` | 어트리뷰션과 관련된 링크 토큰. | +| `tracker_name` | `string` | 캠페인 링크의 이름. | +| `network` | `string` | 캠페인과 관련된 네트워크. | +| `campaign` | `string` | 어트리뷰션과 관련된 캠페인의 이름. | +| `adgroup` | `string` | 어트리뷰션과 관련된 광고그룹. | +| `creative` | `string` | 어트리뷰션과 관련된 크리에이티브. | +| `click_label` | `string` | 어트리뷰션과 관련된 [클릭 레이블](https://help.adjust.com/ko/article/user-rewards). | +| `state` | `string` | 어트리뷰션의 현재 상태. `installed` 또는 `reattributed` | -어트리뷰션 변경 시 콜백 트리거 \{\#trigger\-a\-callback\-when\-attribution\-changes\} --------------------------------------------------------------------------------- +## 어트리뷰션 변경 시 콜백 트리거 \{\#trigger\-a\-callback\-when\-attribution\-changes\} - + ```js attributionCallback: (string, Object) => mixed; ``` - + -SDK는 어트리뷰션 변경 사항을 받고 업데이트가 감지되면 함수를 호출합니다. `initSdk` 메서드의 `attributionCallback` 함수 특정으로 어트리뷰션 콜백 메서드를 설정할 수 있습니다. 함수 내에서 사용자의 어트리뷰션 정보에 액세스할 수 있습니다. +SDK는 어트리뷰션 변경 사항을 받고 업데이트가 감지되면 함수를 호출합니다. `initSdk` 메서드의 `attributionCallback` 함수 특정으로 어트리뷰션 콜백 메서드를 설정할 수 있습니다. 함수 내에서 사용자의 어트리뷰션 정보에 액세스할 수 있습니다. ```js Adjust.initSdk({ @@ -67,10 +68,12 @@ Adjust.initSdk({ }); ``` -현재 어트리뷰션 정보 확인 \{\#get\-current\-attribution\-information\} ------------------------------------------------------------------ +## 현재 어트리뷰션 정보 확인 \{\#get\-current\-attribution\-information\} - +{" "} 사용자가 앱을 설치하면 Adjust는 해당 설치를 캠페인에 어트리뷰션합니다. Adjust SDK를 사용하면 설치 캠페인 어트리뷰션 정보에 액세스할 수 있습니다. `waitForAttribution` 메서드는 SDK가 서버에서 어트리뷰션 데이터를 성공적으로 수신했을 때 `promise` 를 반환합니다. @@ -80,29 +83,30 @@ Adjust.waitForAttribution().then((attr) => ); ``` -리퍼러 설정 \{\#set\-a\-referrer\} ----------------------------------- +## 리퍼러 설정 \{\#set\-a\-referrer\} - + ```js function setReferrer(referrer: string): void; ``` - + SDK가 시작될 때 커스텀 클릭 ID로 SDK 클릭을 트리거하는 리퍼러를 설정할 수 있습니다. SDK는 어트리뷰션 목적으로 커스텀 클릭 ID를 Adjust 서버로 전송합니다. - + + 리퍼러가 어트리뷰션에 사용될 수 있도록 최대한 SDK 초기화에 가깝게 이 메서드를 호출하시기 바랍니다. - + + 리퍼러를 설정하려면 `setReferrer` 메서드를 호출하고 리퍼러를 URL 암호화된 `string` 인수로 전달합니다. - + + ```js Adjust.setReferrer("adjust_external_click_id%3DEXTERNAL_CLICK_ID"); ``` - diff --git a/src/content/docs/ko/sdk/web/features/device-info.mdx b/src/content/docs/ko/sdk/web/features/device-info.mdx index 5b5ff1e94d..a9c803a888 100644 --- a/src/content/docs/ko/sdk/web/features/device-info.mdx +++ b/src/content/docs/ko/sdk/web/features/device-info.mdx @@ -1,14 +1,17 @@ --- -title: "디바이스 정보 확인" -description: "해당 메서드를 사용하여 콜백에 세부 정보를 추가하고 리포트를 보완하시기 바랍니다." -slug: "en/sdk/web/features/device-info" +title: 디바이스 정보 확인 +description: 해당 메서드를 사용하여 콜백에 세부 정보를 추가하고 리포트를 보완하시기 바랍니다. +slug: ko/sdk/web/features/device-info --- + Adjust SDK는 디바이스 정보를 반환하는 헬프 메서드가 포함되어 있습니다. 해당 메서드를 사용하여 콜백에 세부 정보를 추가하고 리포트를 보완하시기 바랍니다. -Web UUID \{\#web\-uuid\} ----------------------------- +## Web UUID \{\#web\-uuid\} - +{" "} 웹 SDK는 Adjust에서 웹 사용자를 식별하기 위해 첫 세션 전송 시 고유한 `web_uuid` 식별자를 생성합니다. 이 ID는 UUID\(Universally Unique Identifier\) 형식을 따릅니다. @@ -19,4 +22,3 @@ Web UUID \{\#web\-uuid\} ```js Adjust.waitForWebUUID().then((webUuid) => console.log(webUuid)); ``` - diff --git a/src/content/docs/ko/sdk/web/features/privacy.mdx b/src/content/docs/ko/sdk/web/features/privacy.mdx index 2ee8c7acee..5f19a2b666 100644 --- a/src/content/docs/ko/sdk/web/features/privacy.mdx +++ b/src/content/docs/ko/sdk/web/features/privacy.mdx @@ -1,42 +1,44 @@ --- -title: "프라이버시 기능 설정" -description: "앱에서 사용자 프라이버시를 관리할 수 있는 기능을 구성합니다." -slug: "en/sdk/web/features/privacy" +title: 프라이버시 기능 설정 +description: 앱에서 사용자 프라이버시를 관리할 수 있는 기능을 구성합니다. +slug: ko/sdk/web/features/privacy --- + Adjust SDK에는 앱에서 사용자 프라이버시를 관리할 수 있는 기능이 포함되어 있습니다. -삭제 요청 전송 \{\#send\-erasure\-request\} ------------------------------------------- +## 삭제 요청 전송 \{\#send\-erasure\-request\} - + ```js function gdprForgetMe(): void; ``` - + -EU의 개인정보 보호 규정\(GDPR\) 및 기타 개인정보 보호법\(CCPA, LGPD 등\)은 데이터 주체에게 개인 데이터 처리와 관련하여 포괄적인 권리를 부여합니다. 이러한 권리에는 삭제 권리\([GDPR 17조](https://gdpr.eu/article-17-right-to-be-forgotten/)\)\([1](https://help.adjust.com/en/article/gdpr#ref-1)\)가 포함됩니다. 데이터 처리자로서 Adjust는 귀하의 \(앱\) 사용자의 이러한 요청을 처리하는 데 있어 귀하\(데이터 컨트롤러\)를 지원할 의무가 있습니다. +EU의 개인정보 보호 규정\(GDPR\) 및 기타 개인정보 보호법\(CCPA, LGPD 등\)은 데이터 주체에게 개인 데이터 처리와 관련하여 포괄적인 권리를 부여합니다. 이러한 권리에는 삭제 권리\([GDPR 17조](https://gdpr.eu/article-17-right-to-be-forgotten/)\)\([1](https://help.adjust.com/ko/article/gdpr#ref-1)\)가 포함됩니다. 데이터 처리자로서 Adjust는 귀하의 \(앱\) 사용자의 이러한 요청을 처리하는 데 있어 귀하\(데이터 컨트롤러\)를 지원할 의무가 있습니다. `gdprForgetMe` 메서드를 호출하여 사용자의 삭제 요청을 Adjust로 전송할 수 있습니다. 삭제 요청 수신 시 Adjust는 다음의 조치를 취합니다: -* Adjust 내부 시스템과 데이터베이스에서 해당 사용자의 모든 개인 정보 기록을 영구적으로 삭제합니다. -* Adjust는 더 이상 Adjust SDK를 통해 해당 사용자/기기로부터 데이터를 수신하지 않습니다.\([2](https://help.adjust.com/en/article/gdpr#ref-2)\) +- Adjust 내부 시스템과 데이터베이스에서 해당 사용자의 모든 개인 정보 기록을 영구적으로 삭제합니다. +- Adjust는 더 이상 Adjust SDK를 통해 해당 사용자/기기로부터 데이터를 수신하지 않습니다.\([2](https://help.adjust.com/ko/article/gdpr#ref-2)\) ```js Adjust.gdprForgetMe(); ``` -특정 사용자에 대한 서드파티 공유 \{\#third\-party\-sharing\-for\-specific\-users\} ----------------------------------------------------------------------------- +## 특정 사용자에 대한 서드파티 공유 \{\#third\-party\-sharing\-for\-specific\-users\} - +{" "} Adjust SDK를 사용하여 사용자의 서드파티 공유 설정 변경 내용을 기록할 수 있습니다. 이러한 설정은 `ThirdPartySharing` 클래스를 사용하여 구성됩니다. -### AdjustThirdPartySharing 객체 인스턴스화 \{\#instantiate\-an\-adjustthirdpartysharing\-object\} +### AdjustThirdPartySharing 객체 인스턴스화 {#instantiate-an-adjustthirdpartysharing-object} - + ```ts class ThirdPartySharing { @@ -45,13 +47,13 @@ class ThirdPartySharing { } ``` - + Adjust SDK와의 서드파트 공유를 활성화 또는 비활성화하려면 `ThirdPartySharing` 객체를 인스턴스화합니다. 이 객체에 Adjust의 서드파티 공유 처리 방식을 제어하는 변수가 포함됩니다. 이를 인스턴스화하려면 새로운 `ThirdPartySharing` 인스턴스를 생성하고 다음 파라미터를 전달합니다. -* `isEnabled` \(`boolean`\):`true` 전달로 서드파티 공유를 활성화하거나 `false` 전달로 서드파티 공유를 비활성화합니다. +- `isEnabled` \(`boolean`\):`true` 전달로 서드파티 공유를 활성화하거나 `false` 전달로 서드파티 공유를 비활성화합니다. ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -66,9 +68,12 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 서드파티 공유 비활성화\(지원 중단\) \{\#disable\-third\-party\-sharing\} +### 서드파티 공유 비활성화\(지원 중단\) {#disable-third-party-sharing} - +{" "} 이전 버전의 SDK에서 서드파티 공유를 비활성화하려면 `disableThirdPartySharing` 메서드를 호출합니다. 이 메서드는 지원 중단되었습니다. 계속 사용할 경우 기본 메서드를 직접 호출하게 됩니다. @@ -77,9 +82,9 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(false); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 세분화된 정보 전송 \{\#send\-granular\-information\} +### 세분화된 정보 전송 {#send-granular-information} - + ```ts public addGranularOption(partnerName: string, @@ -87,15 +92,15 @@ public addGranularOption(partnerName: string, value: string) ``` - + 서드파티 공유 설정 변경 시 세부 정보를 추가할 수 있습니다. 이를 통해 사용자의 결정에 대한 더욱 자세한 정보를 전달할 수 있습니다. 다음 파라미터와 함께 `addGranularOption` 메서드를 호출합니다. -* `partnerName` \(`string`\): 세분화 옵션을 적용할 파트너의 이름 -* `key` \(`string`\): 옵션 키 -* `value` \(`string`\): 옵션 값 +- `partnerName` \(`string`\): 세분화 옵션을 적용할 파트너의 이름 +- `key` \(`string`\): 옵션 키 +- `value` \(`string`\): 옵션 값 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -103,34 +108,37 @@ options.addGranularOption("PartnerA", "foo", "bar"); Adjust.trackThirdPartySharing(options); ``` -URL 전략 \{\#url\-strategy\} ------------------------------- +## URL 전략 \{\#url\-strategy\} - +{" "} URL 전략 기능을 사용하여 다음을 설정할 수 있습니다. -* Adjust가 귀하의 데이터를 저장하는 국가\(데이터 레지던시\). -* Adjust SDK가 트래픽을 전송하는 엔드포인트\(맞춤 URL\). +- Adjust가 귀하의 데이터를 저장하는 국가\(데이터 레지던시\). +- Adjust SDK가 트래픽을 전송하는 엔드포인트\(맞춤 URL\). 본 기능은 프라이버시 요건이 엄격한 나라에서 앱을 운영하는 경우에 유용합니다. URL 전략을 설정하면 Adjust가 선택된 데이터 레지던시 지역에 데이터를 저장하거나 선택된 도메인으로 트래픽을 전송합니다. URL 전략을 구성하려면 `Adjust.initSdk` 인스턴스에 `urlStrategy` 의 다음 속성을 설정합니다. -* `domains` \(`Array`\): SDK 트래픽을 전송할 데이터 레지던스 국가 또는 엔드포인트. 기본 설정에 따라 Adjust SDK는 모든 데이터를 Adjust의 엔드포인트로 전송합니다. 커스텀 엔드포인트를 설정하려면 `urlStrategy`의 `domains` 속성에 엔드포인트를 전달합니다. -* `useSubdomains` \(`boolean`\): 도메인을 Adjust 도메인으로 취급할지 여부. - * `true`인 경우 SDK는 도메인의 접두사로 Adjust에 특화된 하위 도메인을 사용합니다. - * `false`인 경우 SDK는 접두사 없이 제공된 도메인을 그대로 사용합니다. +- `domains` \(`Array`\): SDK 트래픽을 전송할 데이터 레지던스 국가 또는 엔드포인트. 기본 설정에 따라 Adjust SDK는 모든 데이터를 Adjust의 엔드포인트로 전송합니다. 커스텀 엔드포인트를 설정하려면 `urlStrategy`의 `domains` 속성에 엔드포인트를 전달합니다. +- `useSubdomains` \(`boolean`\): 도메인을 Adjust 도메인으로 취급할지 여부. + + - `true`인 경우 SDK는 도메인의 접두사로 Adjust에 특화된 하위 도메인을 사용합니다. + - `false`인 경우 SDK는 접두사 없이 제공된 도메인을 그대로 사용합니다. -* `isDataResidency` \(`boolean`\): 선택 사항으로, 도메인을 데이터 레지던시에 사용해야 하는지 여부입니다. +- `isDataResidency` \(`boolean`\): 선택 사항으로, 도메인을 데이터 레지던시에 사용해야 하는지 여부입니다. 다음 표는 구성 목록을 보여줍니다. -| URL 전략 | 기본 도메인 및 커스텀 도메인 | 하위 도메인 사용 | 데이터 레지던시 | -|-------------|-------------------------------|-----------|----------| -| EU 데이터 레지던시 | `"eu.adjust.com"` | `true` | `true` | -| 중국 URL 전략 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | -| 맞춤 URL 전략 | `"my.custom.domain"` | `false` | `false` | +| URL 전략 | 기본 도메인 및 커스텀 도메인 | 하위 도메인 사용 | 데이터 레지던시 | +| ------------------ | ----------------------------- | ---------------- | --------------- | +| EU 데이터 레지던시 | `"eu.adjust.com"` | `true` | `true` | +| 중국 URL 전략 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | +| 맞춤 URL 전략 | `"my.custom.domain"` | `false` | `false` | ```js Adjust.initSdk({ @@ -145,12 +153,16 @@ Adjust.initSdk({ }); ``` -### 커스텀 엔드포인트 설정\(지원 중단\) \{\#set\-custom\-endpoint\} +### 커스텀 엔드포인트 설정\(지원 중단\) {#set-custom-endpoint} - +{" "} 이전 버전의 SDK는 지원 중단된 `customUrl` 속성을 사용하여 엔드포인트를 전달했습니다. 대신 `urlStrategy` 구성을 사용하시기 바랍니다. - + + ```js Adjust.initSdk({ @@ -166,14 +178,18 @@ Adjust.initSdk({ }); ``` - + -### 데이터 레지던시\(지원 중단\) \{\#data\-residency\} +### 데이터 레지던시\(지원 중단\) {#data-residency} - +{" "} 이전 버전의 SDK는 지원 중단된 `dataResidency` 속성을 사용했습니다. 대신 `urlStrategy` 구성을 사용하시기 바랍니다. - + + ```js Adjust.initSdk({ @@ -190,4 +206,3 @@ Adjust.initSdk({ ``` - diff --git a/src/content/docs/ko/sdk/web/index.mdx b/src/content/docs/ko/sdk/web/index.mdx index b3db0c09c8..2f3380086d 100644 --- a/src/content/docs/ko/sdk/web/index.mdx +++ b/src/content/docs/ko/sdk/web/index.mdx @@ -1,91 +1,271 @@ --- -title: "Web SDK 연동 가이드" -description: "웹 SDK를 사용해 웹앱의 Adjust 기능에 액세스합니다." +title: Web SDK 연동 가이드 +description: 웹 SDK를 사용해 웹앱의 Adjust 기능에 액세스합니다. category-title: "웹 SDK " -slug: "en/sdk/web" +slug: ko/sdk/web sidebar-position: 8 --- + Adjust 웹 SDK를 사용하면 웹 앱에서 어트리뷰션, 이벤트 및 기타 데이터를 기록할 수 있습니다. 이 가이드에서는 SDK를 앱과 연동하는 방법을 설명합니다. - + + 웹 SDK를 사용하려면 Adjust 대시보드에서 지원 중단된 웹 앱을 생성하고 그 둘을 연결해야 합니다. 웹 SDK를 모바일 앱 SDK가 이미 포함된 모바일 앱과 연동해서는 안 됩니다. - -1\. 프로젝트에 SDK 추가 \{\#add\-the\-sdk\-to\-your\-project\} ----------------------------------------------------------------- + + +## 1\. 프로젝트에 SDK 추가 \{\#add\-the\-sdk\-to\-your\-project\} 시작하려면 웹 앱에 SDK를 추가합니다. Adjust SDK는 CommonJS와 AMD\(비동기 모듈 정의\) 환경에서 모두 작동합니다. CDN\(콘텐츠 전송 네트워크\)을 통해 로딩될 때 글로벌 `Adjust` 네임스페이스를 통해 액세스할 수 있습니다. -### CDN 사용 \{\#using\-a\-cdn\} +### CDN 사용 {#using-a-cdn} CDN을 통해 SDK를 로딩할 때 프로덕션 빌드에 간소화된 버전을 사용해야 합니다. -* 다음과 같이 CDN 대상에 추가하여 특정 버전을 로드할 수 있습니다. `https://cdn.adjust.com/adjust-5.7.0.min.js` -* 최신 버전을 로드하려면 다음과 같이 `adjust-latest` 패키지를 사용합니다. `https://cdn.adjust.com/adjust-latest.min.js` 이 패키지는 자동으로 업데이트되므로 대상 파일을 변경할 필요가 없습니다. +- 다음과 같이 CDN 대상에 추가하여 특정 버전을 로드할 수 있습니다. `https://cdn.adjust.com/adjust-5.7.0.min.js` +- 최신 버전을 로드하려면 다음과 같이 `adjust-latest` 패키지를 사용합니다. `https://cdn.adjust.com/adjust-latest.min.js` 이 패키지는 자동으로 업데이트되므로 대상 파일을 변경할 필요가 없습니다. - + SDK 파일은 캐시되어 빠른 서비스가 가능합니다. 이 캐시는 30분마다 업데이트됩니다. SDK 파일을 최신 버전으로 강제로 업데이트하려면 헤더에서 특정 버전을 대상으로 지정하시기 바랍니다. - -CDN을 통해 SDK를 로드하려면 웹 앱의 `` 요소 안에 다음 스니펫을 추가합니다. + + +CDN을 통해 SDK를 로드하려면 웹 앱의 `` 요소 안에 다음 스니펫을 추가합니다. \{/\* prettier\-ignore \*/\} ```html - ``` Adjust SDK는 각 페이지에서 로드되며 페이지 로드 시 한 번 초기화됩니다. -#### 하위 리소스 무결성 \{\#subresource\-integrity\} +#### 하위 리소스 무결성 {#subresource-integrity} [하위 리소스 무결성](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) 검사를 사용하여 XSS\(사이트 간 스크립팅\) 공격을 완화할 수 있습니다. 패키지를 실행하기 전에 검증하려면 다음 콜\(추가 `crossOrigin`, `integrity`, 인코딩된 해시 확인\)을 사용합니다. \{/\* prettier\-ignore \*/\} ```html - ``` -### npm 사용 \{\#using\-npm\} +### npm 사용 {#using-npm} Adjust SDK는 [npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk)에서도 사용이 가능합니다. 프로젝트에 패키지를 추가하려면 선호하는 패키지 매니저를 사용하시기 바랍니다. - + + + ```console $ npm install @adjustcom/adjust-web-sdk --save ``` - + + ```console $ yarn add @adjustcom/adjust-web-sdk ``` - + + ```console $ pnpm add @adjustcom/adjust-web-sdk ``` - + + -2\. SDK 초기화 \{\#initialize\-the\-sdk\} --------------------------------------------- +## 2\. SDK 초기화 \{\#initialize\-the\-sdk\} SDK를 설치한 후에는 초기화해야 합니다. 해당 기능 사용을 원하는 경우 `initSdk` 메서드를 호출합니다. 이 메서드는 앱에서 SDK가 작동하는 방식을 사용자 지정하는 데 사용할 수 있는 인수를 제공합니다. SDK를 시작하려면 다음 인수를 `initSdk` 호출에 추가해야 합니다. -* `appToken` `string`: [Adjust 앱 토큰](https://help.adjust.com/en/article/app-token-and-reporting-currency#view-your-app-details)입니다. -* `environment` \(`string`\): SDK를 실행할 환경입니다. - * 테스트 모드에서 SDK를 실행하려면 `sandbox` 를 전달합니다. - * 릴리즈를 위해 프로덕션 모드에서 SDK를 실행하려면 `production` 을 전달합니다. +- `appToken` `string`: [Adjust 앱 토큰](https://help.adjust.com/ko/article/app-token-and-reporting-currency#view-your-app-details)입니다. +- `environment` \(`string`\): SDK를 실행할 환경입니다. + - 테스트 모드에서 SDK를 실행하려면 `sandbox` 를 전달합니다. + - 릴리즈를 위해 프로덕션 모드에서 SDK를 실행하려면 `production` 을 전달합니다. ```js Adjust.initSdk({ @@ -94,8 +274,8 @@ Adjust.initSdk({ }); ``` - + -[구성 가이드](/en/sdk/web/configuration)에서 Adjust 웹 SDK의 전체 인수 및 속성 목록을 확인하실 수 있습니다. - +[구성 가이드](/ko/sdk/web/configuration)에서 Adjust 웹 SDK의 전체 인수 및 속성 목록을 확인하실 수 있습니다. + diff --git a/src/content/docs/zh/sdk/web/features/attribution.mdx b/src/content/docs/zh/sdk/web/features/attribution.mdx index 26db7c7244..4fedcc3602 100644 --- a/src/content/docs/zh/sdk/web/features/attribution.mdx +++ b/src/content/docs/zh/sdk/web/features/attribution.mdx @@ -1,12 +1,14 @@ --- -title: "获取归因信息" -description: "使用 Adjust SDK 监听归因变化" -slug: "en/sdk/web/features/attribution" +title: 获取归因信息 +description: 使用 Adjust SDK 监听归因变化 +slug: zh/sdk/web/features/attribution --- -用户与 Adjust 链接交互时，其归因信息会发生更新。用户与[深度链接](https://help.adjust.com/en/article/deep-links)交互时可能会发生这种情况。用户归因相关信息会在归因对象中展现。 + +用户与 Adjust 链接交互时，其归因信息会发生更新。用户与[深度链接](https://help.adjust.com/zh/article/deep-links)交互时可能会发生这种情况。用户归因相关信息会在归因对象中展现。 归因对象包含下列信息： - + + ```js export type AttributionMapT = $ReadOnly<{| @@ -22,30 +24,29 @@ export type AttributionMapT = $ReadOnly<{| |}>; ``` - + -| 值 | 数据类型 | 描述 | -|-----------------|----------|------------------------------------------------------------------------| -| `adid` | `string` | 设备的唯一 Adjust 标识符。 | -| `tracker_token` | `string` | 与归因关联的链接识别码。 | -| `tracker_name` | `string` | 推广活动链接名称 | -| `network` | `string` | 与推广活动关联的渠道。 | -| `campaign` | `string` | 与归因关联的推广活动名称。 | -| `adgroup` | `string` | 与归因关联的广告组。 | -| `creative` | `string` | 与归因关联的素材。 | -| `click_label` | `string` | 与归因关联的 [click label](https://help.adjust.com/en/article/user-rewards)。 | -| `state` | `string` | 当前归因状态。`installed` 或 `reattributed` | +| 值 | 数据类型 | 描述 | +| --------------- | -------- | ----------------------------------------------------------------------------- | +| `adid` | `string` | 设备的唯一 Adjust 标识符。 | +| `tracker_token` | `string` | 与归因关联的链接识别码。 | +| `tracker_name` | `string` | 推广活动链接名称 | +| `network` | `string` | 与推广活动关联的渠道。 | +| `campaign` | `string` | 与归因关联的推广活动名称。 | +| `adgroup` | `string` | 与归因关联的广告组。 | +| `creative` | `string` | 与归因关联的素材。 | +| `click_label` | `string` | 与归因关联的 [click label](https://help.adjust.com/zh/article/user-rewards)。 | +| `state` | `string` | 当前归因状态。`installed` 或 `reattributed` | -发生归因变化时触发回传\{\#trigger\-a\-callback\-when\-attribution\-changes\} -------------------------------------------------------------------------- +## 发生归因变化时触发回传\{\#trigger\-a\-callback\-when\-attribution\-changes\} - + ```js attributionCallback: (string, Object) => mixed; ``` - + SDK 可监听归因变更并在发现更新时调用一个函数。您可以在 `initSdk` 方法中指定一个 `attributionCallback` 函数，来设置归因回传方法。在函数内，您可以访问用户归因信息。 @@ -67,10 +68,12 @@ Adjust.initSdk({ }); ``` -获取当前归因信息\{\#get\-current\-attribution\-information\} ----------------------------------------------------------- +## 获取当前归因信息\{\#get\-current\-attribution\-information\} - +{" "} 用户安装您的应用时，Adjust 会将该安装归因至一个推广活动。Adjust SDK 可提供赢得安装归因的推广活动细节。`waitForAttribution`方法会返回一个`promise`，当 SDK 成功从服务器接收到归因数据时，该 promise 会被完成。 @@ -80,29 +83,30 @@ Adjust.waitForAttribution().then((attr) => ); ``` -设置 referrer \{\#set\-a\-referrer\} ---------------------------------------- +## 设置 referrer \{\#set\-a\-referrer\} - + ```js function setReferrer(referrer: string): void; ``` - + 您可以创建一个 referrer，来在 SDK 启动后触发带有自定义点击 ID 的 SDK 点击。SDK 会将您的自定义点击 ID 发送到 Adjust 服务器用于归因。 - + + 在尽可能靠近 SDK 初始化的节点调用此方法，确保您的 referrer 被用于归因。 - + + 要设置 referrer，请调用 `setReferrer` 方法并以 URL 编码 `string` 参数的形式传递 referrer。 - + + ```js Adjust.setReferrer("adjust_external_click_id%3DEXTERNAL_CLICK_ID"); ``` - diff --git a/src/content/docs/zh/sdk/web/features/device-info.mdx b/src/content/docs/zh/sdk/web/features/device-info.mdx index 96ceefac89..9740d2ca9d 100644 --- a/src/content/docs/zh/sdk/web/features/device-info.mdx +++ b/src/content/docs/zh/sdk/web/features/device-info.mdx @@ -1,14 +1,17 @@ --- -title: "获取设备信息" -description: "用这些方法来向回传添加细节信息，优化报告。" -slug: "en/sdk/web/features/device-info" +title: 获取设备信息 +description: 用这些方法来向回传添加细节信息，优化报告。 +slug: zh/sdk/web/features/device-info --- + Adjust SDK 包含能够返回设备信息的辅助方法。用这些方法来向回传添加细节信息，优化报告。 -Web UUID \{\#web\-uuid\} ----------------------------- +## Web UUID \{\#web\-uuid\} - +{" "} 为在 Adjust 中识别网页用户，Adjust Web SDK 会在发送第一次会话时生成唯一的 `web_uuid` 标识符。该标识符采用通用唯一标识符 \(UUID\) 格式。 @@ -19,4 +22,3 @@ Web UUID \{\#web\-uuid\} ```js Adjust.waitForWebUUID().then((webUuid) => console.log(webUuid)); ``` - diff --git a/src/content/docs/zh/sdk/web/features/privacy.mdx b/src/content/docs/zh/sdk/web/features/privacy.mdx index 8979273d83..4a61eb625e 100644 --- a/src/content/docs/zh/sdk/web/features/privacy.mdx +++ b/src/content/docs/zh/sdk/web/features/privacy.mdx @@ -1,42 +1,44 @@ --- -title: "设置隐私功能" -description: "配置处理应用用户隐私的功能。" -slug: "en/sdk/web/features/privacy" +title: 设置隐私功能 +description: 配置处理应用用户隐私的功能。 +slug: zh/sdk/web/features/privacy --- + Adjust SDK 包含处理应用用户隐私的功能。 -发送删除请求\{\#send\-erasure\-request\} ---------------------------------------- +## 发送删除请求\{\#send\-erasure\-request\} - + ```js function gdprForgetMe(): void; ``` - + -在处理个人数据方面，欧盟的《通用数据保护条例》\(GDPR\) 和全球类似的隐私法律 \(CCPA、LGPD 等\) 授予数据主体完全权利，其中包括删除权 \([参见 GDPR 第 17](https://gdpr.eu/article-17-right-to-be-forgotten/)条\)\( [1](https://help.adjust.com/en/article/gdpr#ref-1) \)。作为数据处理方，Adjust 有义务支持您 \(数据控制方\) 处理来自应用用户的此类请求。 +在处理个人数据方面，欧盟的《通用数据保护条例》\(GDPR\) 和全球类似的隐私法律 \(CCPA、LGPD 等\) 授予数据主体完全权利，其中包括删除权 \([参见 GDPR 第 17](https://gdpr.eu/article-17-right-to-be-forgotten/)条\)\( [1](https://help.adjust.com/zh/article/gdpr#ref-1) \)。作为数据处理方，Adjust 有义务支持您 \(数据控制方\) 处理来自应用用户的此类请求。 您可以通过调用 `gdprForgetMe` 方法来将用户的删除请求发送至 Adjust 服务器。收到通知后： -* 我们将从内部系统和数据库中永久删除用户的所有历史个人数据； -* 此外，Adjust 将不再通过 Adjust SDK 接收来自该用户/设备的数据。 \( [2](https://help.adjust.com/en/article/gdpr#ref-2) \) +- 我们将从内部系统和数据库中永久删除用户的所有历史个人数据； +- 此外，Adjust 将不再通过 Adjust SDK 接收来自该用户/设备的数据。 \( [2](https://help.adjust.com/zh/article/gdpr#ref-2) \) ```js Adjust.gdprForgetMe(); ``` -针对特定用户的第三方分享\{\#third\-party\-sharing\-for\-specific\-users\} ---------------------------------------------------------------------- +## 针对特定用户的第三方分享\{\#third\-party\-sharing\-for\-specific\-users\} - +{" "} 您可以使用 Adjust SDK 来记录用户对第三方数据分享设置的变更。请使用 `ThirdPartySharing` 类配置第三方数据分享。 -### 实例化 AdjustThirdPartySharing 对象\{\#instantiate\-an\-adjustthirdpartysharing\-object\} +### 实例化 AdjustThirdPartySharing 对象{#instantiate-an-adjustthirdpartysharing-object} - + ```ts class ThirdPartySharing { @@ -45,13 +47,13 @@ class ThirdPartySharing { } ``` - + 要启用或禁用 Adjust SDK 第三方数据分享，请实例化 `ThirdPartySharing` 对象。该对象包含控制 Adjust 如何处理第三方分享的变量。 要进行实例化，请创建新的 `ThirdPartySharing` 实例，并传递下列参数： -* `isEnabled` \( `boolean` \): 传递`true`来启用第三方分享或传递`false`来禁用第三方分享。 +- `isEnabled` \( `boolean` \): 传递`true`来启用第三方分享或传递`false`来禁用第三方分享。 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -66,9 +68,12 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 禁用第三方分享 \(已弃用\) \{\#disable\-third\-party\-sharing\} +### 禁用第三方分享 \(已弃用\) {#disable-third-party-sharing} - +{" "} 如需在之前版本的 SDK 中禁用第三方数据分享，请调用`disableThirdPartySharing`方法。此方法已被弃用。如果您仍在使用，请注意它会直接调用基础方法。 @@ -77,9 +82,9 @@ const adjustThirdPartySharing = new Adjust.ThirdPartySharing(false); Adjust.trackThirdPartySharing(adjustThirdPartySharing); ``` -### 发送精细信息\{\#send\-granular\-information\} +### 发送精细信息{#send-granular-information} - + ```ts public addGranularOption(partnerName: string, @@ -87,15 +92,15 @@ public addGranularOption(partnerName: string, value: string) ``` - + 当用户更新第三方数据分享设置时，您可以附加较精细的信息，以此发送用户决定的更多细节。 使用下列参数调用`addGranularOption`方法： -* `partnerName` \(`string`\)：使用精细设置的合作伙伴的名称。 -* `key` \(`string`\)：选项 key。 -* `value` \(`string`\)：选项值。 +- `partnerName` \(`string`\)：使用精细设置的合作伙伴的名称。 +- `key` \(`string`\)：选项 key。 +- `value` \(`string`\)：选项值。 ```ts const adjustThirdPartySharing = new Adjust.ThirdPartySharing(true); @@ -103,34 +108,37 @@ options.addGranularOption("PartnerA", "foo", "bar"); Adjust.trackThirdPartySharing(options); ``` -URL 策略\{\#url\-strategy\} ------------------------------ +## URL 策略\{\#url\-strategy\} - +{" "} 通过 URL 策略功能，您可以进行下列设置： -* Adjust 储存您数据的国家/地区 \(即数据驻留\)。 -* 接收 Adjust SDK 所发送流量的终端 \(自定义 URL \)。 +- Adjust 储存您数据的国家/地区 \(即数据驻留\)。 +- 接收 Adjust SDK 所发送流量的终端 \(自定义 URL \)。 当应用运营的国家拥有严格的隐私规定时，此功能会非常有用。在您设置 URL 策略时，Adjust 会将数据储存在指定数据驻留地区，或将流量发送至选定域名。 要配置 URL 策略，请在`Adjust.initSdk`实例中设置`urlStrategy`的以下属性： -* `domains` \(`Array`\)：接收您所发送 SDK 流量的数据驻留国家/地区或终端。默认情况下，Adjust SDK 会将所有数据都发送至 Adjust 终端。如果您想设置自定义终端，请在`urlStrategy`的`domains`属性中传递。 -* `useSubdomains` \(`boolean`\): 域名是否应被视为 Adjust 域名。 - * 如果为`true`，则 SDK 会在域名中添加 Adjust 特定子域作为前缀。 - * 如果为`false`，SDK 会按原样使用所提供的域名，不包含前缀。 +- `domains` \(`Array`\)：接收您所发送 SDK 流量的数据驻留国家/地区或终端。默认情况下，Adjust SDK 会将所有数据都发送至 Adjust 终端。如果您想设置自定义终端，请在`urlStrategy`的`domains`属性中传递。 +- `useSubdomains` \(`boolean`\): 域名是否应被视为 Adjust 域名。 + + - 如果为`true`，则 SDK 会在域名中添加 Adjust 特定子域作为前缀。 + - 如果为`false`，SDK 会按原样使用所提供的域名，不包含前缀。 -* `isDataResidency` \( `boolean` \)：可选。域名是否应被用于数据驻留。 +- `isDataResidency` \( `boolean` \)：可选。域名是否应被用于数据驻留。 下表展示了一系列配置。 -| URL 策略 | 默认和自定义域名 | 使用子域名 | 数据驻留 | -|------------|-------------------------------|---------|---------| -| 欧盟数据驻留 | `"eu.adjust.com"` | `true` | `true` | -| 中国 URL 策略 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | -| 自定义 URL 策略 | `"my.custom.domain"` | `false` | `false` | +| URL 策略 | 默认和自定义域名 | 使用子域名 | 数据驻留 | +| --------------- | ----------------------------- | ---------- | -------- | +| 欧盟数据驻留 | `"eu.adjust.com"` | `true` | `true` | +| 中国 URL 策略 | `"adjust.cn"`, `"adjust.com"` | `true` | `false` | +| 自定义 URL 策略 | `"my.custom.domain"` | `false` | `false` | ```js Adjust.initSdk({ @@ -145,12 +153,16 @@ Adjust.initSdk({ }); ``` -### 设置自定义终端 \(已弃用\) \{\#set\-custom\-endpoint\} +### 设置自定义终端 \(已弃用\) {#set-custom-endpoint} - +{" "} 之前版本的 SDK 使用`customUrl`属性传递终端，该属性已被弃用。请改用`urlStrategy`配置。 - + + ```js Adjust.initSdk({ @@ -166,14 +178,18 @@ Adjust.initSdk({ }); ``` - + -### 数据驻留 \(已弃用\) \{\#data\-residency\} +### 数据驻留 \(已弃用\) {#data-residency} - +{" "} 之前版本的 SDK 使用的是`dataResidency`属性，该属性已被弃用。请改用`urlStrategy`配置。 - + + ```js Adjust.initSdk({ @@ -190,4 +206,3 @@ Adjust.initSdk({ ``` - diff --git a/src/content/docs/zh/sdk/web/index.mdx b/src/content/docs/zh/sdk/web/index.mdx index 36745f3d25..cc058ab1b9 100644 --- a/src/content/docs/zh/sdk/web/index.mdx +++ b/src/content/docs/zh/sdk/web/index.mdx @@ -1,91 +1,271 @@ --- -title: "Web SDK 集成指南" -description: "使用 Web SDK 在您的 web 应用中使用 Adjust 功能" -category-title: "Web SDK" -slug: "en/sdk/web" +title: Web SDK 集成指南 +description: 使用 Web SDK 在您的 web 应用中使用 Adjust 功能 +category-title: Web SDK +slug: zh/sdk/web sidebar-position: 8 --- + 通过 Adjust Web SDK，您可以在网页应用中记录归因、事件以及更多数据。该指南展示了如何将该 SDK 集成至应用。 - + + 要使用 Web SDK，您必须在 Adjust 控制面板中创建专用的网页应用并将两者关联起来。请勿将 Web SDK 集成到已经包含移动应用 SDK 的移动应用中。 - -1\. 添加 SDK 至您的项目\{\#add\-the\-sdk\-to\-your\-project\} ---------------------------------------------------------------- + + +## 1\. 添加 SDK 至您的项目\{\#add\-the\-sdk\-to\-your\-project\} 要开始设置，请将 SDK 添加至网页应用。Adjust SDK 可在 CommonJS 和 AMD \(Asynchronous Module Definition\) 环境中运行。通过 CDN \(内容分发网络\) 加载时，您可以通过全局`Adjust`命名空间对其进行访问。 -### 使用 CDN \{\#using\-a\-cdn\} +### 使用 CDN {#using-a-cdn} 通过 CDN 加载 SDK 时，您应该在生产环境中使用压缩版本。 -* 您可以通过添加一个版本至 CDN 目标来加载指定版本，如下所示：`https://cdn.adjust.com/adjust-5.7.0.min.js`。 -* 要加载最新版本，请使用`adjust-latest`包，如下所示：`https://cdn.adjust.com/adjust-latest.min.js`。该包会自动更新，您无需更改目标文件。 +- 您可以通过添加一个版本至 CDN 目标来加载指定版本，如下所示：`https://cdn.adjust.com/adjust-5.7.0.min.js`。 +- 要加载最新版本，请使用`adjust-latest`包，如下所示：`https://cdn.adjust.com/adjust-latest.min.js`。该包会自动更新，您无需更改目标文件。 - + SDK 文件会被缓存，确保服务速度。缓存每 30 分钟更新。如果您想强制更新当前版本，请在标头中定向特定版本。 - -要通过 CDN 加载 SDK，请将以下代码片段加入网页应用的``元素中： + + +要通过 CDN 加载 SDK，请将以下代码片段加入网页应用的``元素中： \{/\* prettier\-ignore \*/\} ```html - ``` Adjust SDK 会在每个页面上加载并初始化。 -#### 子资源完整性\{\#subresource\-integrity\} +#### 子资源完整性{#subresource-integrity} 请使用[子资源完整性](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity)检查来抵御 XSS \(跨站脚本\) 攻击。要在运行包之前对其进行验证，请使用以下调用 \(请注意额外的`crossOrigin` 、 `integrity`和经过编码的哈希值\): \{/\* prettier\-ignore \*/\} ```html - ``` -### 使用 npm \{\#using\-npm\} +### 使用 npm {#using-npm} Adjust SDK 还可用于 [npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk)。要将包加入您的项目，请使用您常用的包管理器： - + + + ```console $ npm install @adjustcom/adjust-web-sdk --save ``` - + + ```console $ yarn add @adjustcom/adjust-web-sdk ``` - + + ```console $ pnpm add @adjustcom/adjust-web-sdk ``` - + + -2\. 初始化 SDK\{\#initialize\-the\-sdk\} -------------------------------------------- +## 2\. 初始化 SDK\{\#initialize\-the\-sdk\} 安装 SDK 后，需要进行初始化。为此，请调用`initSdk`方法。您可以使用该方法中的参数来自定义 SDK 在应用中的工作方式。 要初始化 SDK，您必须将以下参数添加至`initSdk`调用： -* `appToken` \(`string`\)：您的 [Adjust 应用识别码](https://help.adjust.com/en/article/app-token-and-reporting-currency#view-your-app-details)。 -* `environment` \(`string`\)：SDK 运行的环境。 - * 传递`sandbox`来在测试模式下运行 SDK。 - * 传递 `production`来在生产模式下运行 SDK，方便发布。 +- `appToken` \(`string`\)：您的 [Adjust 应用识别码](https://help.adjust.com/zh/article/app-token-and-reporting-currency#view-your-app-details)。 +- `environment` \(`string`\)：SDK 运行的环境。 + - 传递`sandbox`来在测试模式下运行 SDK。 + - 传递 `production`来在生产模式下运行 SDK，方便发布。 ```js Adjust.initSdk({ @@ -94,8 +274,8 @@ Adjust.initSdk({ }); ``` - + -您可以在[配置指南](/en/sdk/web/configuration)中找到 Adjust Web SDK 参数和属性的完整列表。 - +您可以在[配置指南](/zh/sdk/web/configuration)中找到 Adjust Web SDK 参数和属性的完整列表。 + From ca68d0596293c1b3f0ce2414fc7650262d7f9132 Mon Sep 17 00:00:00 2001 From: Bohdan Zavhorodskyi Date: Thu, 16 Jan 2025 17:13:00 +0200 Subject: [PATCH 41/42] fix: fixed localized sdk/web --- src/content/docs/ja/sdk/web/index.mdx | 183 +------------------------- src/content/docs/ko/sdk/web/index.mdx | 183 +------------------------- src/content/docs/zh/sdk/web/index.mdx | 183 +------------------------- 3 files changed, 12 insertions(+), 537 deletions(-) diff --git a/src/content/docs/ja/sdk/web/index.mdx b/src/content/docs/ja/sdk/web/index.mdx index 270d80e245..b7d158fd72 100644 --- a/src/content/docs/ja/sdk/web/index.mdx +++ b/src/content/docs/ja/sdk/web/index.mdx @@ -33,97 +33,10 @@ SDKのファイルは、迅速なサービスを実現するためにキャッ CDNを利用してSDKを読み込むには、Webアプリの``タグ間に次のスニペットを追加します。 -\{/\* prettier\-ignore \*/\} - +{/* prettier-ignore */} ```html ``` @@ -133,98 +46,10 @@ Adjust SDKはページごとに読み込まれ、ページの読み込みごと XSS（クロスサイトスクリプティング）攻撃を緩和するために、[サブリソース完全性](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity)チェックを使用します。実行前にパッケージを検証するには、次のコールを使用します（追加の`crossOrigin`、 `integrity`、およびエンコードされたハッシュにご留意ください）。 -\{/\* prettier\-ignore \*/\} - +{/* prettier-ignore */} ```html ``` diff --git a/src/content/docs/ko/sdk/web/index.mdx b/src/content/docs/ko/sdk/web/index.mdx index 2f3380086d..1a25155853 100644 --- a/src/content/docs/ko/sdk/web/index.mdx +++ b/src/content/docs/ko/sdk/web/index.mdx @@ -33,97 +33,10 @@ SDK 파일은 캐시되어 빠른 서비스가 가능합니다. 이 캐시는 30 CDN을 통해 SDK를 로드하려면 웹 앱의 `` 요소 안에 다음 스니펫을 추가합니다. -\{/\* prettier\-ignore \*/\} - +{/* prettier-ignore */} ```html ``` @@ -133,98 +46,10 @@ Adjust SDK는 각 페이지에서 로드되며 페이지 로드 시 한 번 초 [하위 리소스 무결성](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) 검사를 사용하여 XSS\(사이트 간 스크립팅\) 공격을 완화할 수 있습니다. 패키지를 실행하기 전에 검증하려면 다음 콜\(추가 `crossOrigin`, `integrity`, 인코딩된 해시 확인\)을 사용합니다. -\{/\* prettier\-ignore \*/\} - +{/* prettier-ignore */} ```html ``` diff --git a/src/content/docs/zh/sdk/web/index.mdx b/src/content/docs/zh/sdk/web/index.mdx index cc058ab1b9..75f3ade6a9 100644 --- a/src/content/docs/zh/sdk/web/index.mdx +++ b/src/content/docs/zh/sdk/web/index.mdx @@ -33,97 +33,10 @@ SDK 文件会被缓存，确保服务速度。缓存每 30 分钟更新。如果 要通过 CDN 加载 SDK，请将以下代码片段加入网页应用的``元素中： -\{/\* prettier\-ignore \*/\} - +{/* prettier-ignore */} ```html ``` @@ -133,98 +46,10 @@ Adjust SDK 会在每个页面上加载并初始化。 请使用[子资源完整性](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity)检查来抵御 XSS \(跨站脚本\) 攻击。要在运行包之前对其进行验证，请使用以下调用 \(请注意额外的`crossOrigin` 、 `integrity`和经过编码的哈希值\): -\{/\* prettier\-ignore \*/\} - +{/* prettier-ignore */} ```html ``` From 980245db9ed3df10f8ad66e2b3dbf00bf22eb236 Mon Sep 17 00:00:00 2001 From: github-actions <41898282+github-actions[bot]@users.noreply.github.com> Date: Thu, 16 Jan 2025 15:13:51 +0000 Subject: [PATCH 42/42] Fix translated and formatted files --- src/content/docs/ja/sdk/web/features/attribution.mdx | 6 +++--- src/content/docs/ja/sdk/web/features/device-info.mdx | 2 +- src/content/docs/ja/sdk/web/features/privacy.mdx | 6 +++--- src/content/docs/ja/sdk/web/index.mdx | 4 ++-- src/content/docs/ko/sdk/web/features/attribution.mdx | 6 +++--- src/content/docs/ko/sdk/web/features/device-info.mdx | 2 +- src/content/docs/ko/sdk/web/features/privacy.mdx | 6 +++--- src/content/docs/ko/sdk/web/index.mdx | 4 ++-- src/content/docs/zh/sdk/web/features/attribution.mdx | 6 +++--- src/content/docs/zh/sdk/web/features/device-info.mdx | 2 +- src/content/docs/zh/sdk/web/features/privacy.mdx | 6 +++--- src/content/docs/zh/sdk/web/index.mdx | 4 ++-- 12 files changed, 27 insertions(+), 27 deletions(-) diff --git a/src/content/docs/ja/sdk/web/features/attribution.mdx b/src/content/docs/ja/sdk/web/features/attribution.mdx index bda772281b..383955a17d 100644 --- a/src/content/docs/ja/sdk/web/features/attribution.mdx +++ b/src/content/docs/ja/sdk/web/features/attribution.mdx @@ -38,7 +38,7 @@ export type AttributionMapT = $ReadOnly<{| | `click_label` | `string` | アトリビューションに関連付けられている[クリックラベル](https://help.adjust.com/ja/article/user-rewards) | | `state` | `string` | アトリビューションの現在のステータス。`installed`または `reattributed` | -## アトリビューションの変更時にコールバックをトリガーする \{\#trigger\-a\-callback\-when\-attribution\-changes\} +## アトリビューションの変更時にコールバックをトリガーする {#trigger-a-callback-when-attribution-changes} @@ -68,7 +68,7 @@ Adjust.initSdk({ }); ``` -## 現在のアトリビューション情報を取得する \{\#get\-current\-attribution\-information\} +## 現在のアトリビューション情報を取得する {#get-current-attribution-information} ); ``` -## リファラーを設定する \{\#set\-a\-referrer\} +## リファラーを設定する {#set-a-referrer} diff --git a/src/content/docs/ja/sdk/web/features/device-info.mdx b/src/content/docs/ja/sdk/web/features/device-info.mdx index 90fe7f040b..d44b28783e 100644 --- a/src/content/docs/ja/sdk/web/features/device-info.mdx +++ b/src/content/docs/ja/sdk/web/features/device-info.mdx @@ -6,7 +6,7 @@ slug: ja/sdk/web/features/device-info Adjust SDKには、デバイス情報を返すヘルパーメソッドが含まれています。これらのメソッドを使用することでコールバックに詳細を追加し、レポートを改善させましょう。 -## Web UUID \{\#web\-uuid\} +## Web UUID {#web-uuid} @@ -27,7 +27,7 @@ EUの一般データ保護規則（GDPR）および類似する世界的なプ Adjust.gdprForgetMe(); ``` -## 特定のユーザーの情報をサードパーティと共有する \{\#third\-party\-sharing\-for\-specific\-users\} +## 特定のユーザーの情報をサードパーティと共有する {#third-party-sharing-for-specific-users} -## 1\. プロジェクトにSDKを追加する \{\#add\-the\-sdk\-to\-your\-project\} +## 1\. プロジェクトにSDKを追加する {#add-the-sdk-to-your-project} まずは、WebアプリにSDKを追加します。Adjust SDKは、CommonJSとAMD（Asynchronous Module Definition）の両方の環境で動作します。CDN（Content Delivery Network）を利用して読み込むと、グローバルの`Adjust`名前空間を介してアクセスできます。 @@ -81,7 +81,7 @@ $ pnpm add @adjustcom/adjust-web-sdk -## 2\. SDKを初期化する \{\#initialize\-the\-sdk\} +## 2\. SDKを初期化する {#initialize-the-sdk} SDKをインストールしたら初期化する必要があります。これを行うには、`initSdk`メソッドを呼び出してください。このメソッドには、アプリでのSDKの動作をカスタマイズするために使用できる引数があります。 diff --git a/src/content/docs/ko/sdk/web/features/attribution.mdx b/src/content/docs/ko/sdk/web/features/attribution.mdx index 1bf5764cf4..4961b6879e 100644 --- a/src/content/docs/ko/sdk/web/features/attribution.mdx +++ b/src/content/docs/ko/sdk/web/features/attribution.mdx @@ -38,7 +38,7 @@ export type AttributionMapT = $ReadOnly<{| | `click_label` | `string` | 어트리뷰션과 관련된 [클릭 레이블](https://help.adjust.com/ko/article/user-rewards). | | `state` | `string` | 어트리뷰션의 현재 상태. `installed` 또는 `reattributed` | -## 어트리뷰션 변경 시 콜백 트리거 \{\#trigger\-a\-callback\-when\-attribution\-changes\} +## 어트리뷰션 변경 시 콜백 트리거 {#trigger-a-callback-when-attribution-changes} @@ -68,7 +68,7 @@ Adjust.initSdk({ }); ``` -## 현재 어트리뷰션 정보 확인 \{\#get\-current\-attribution\-information\} +## 현재 어트리뷰션 정보 확인 {#get-current-attribution-information} ); ``` -## 리퍼러 설정 \{\#set\-a\-referrer\} +## 리퍼러 설정 {#set-a-referrer} diff --git a/src/content/docs/ko/sdk/web/features/device-info.mdx b/src/content/docs/ko/sdk/web/features/device-info.mdx index a9c803a888..332eeedd0d 100644 --- a/src/content/docs/ko/sdk/web/features/device-info.mdx +++ b/src/content/docs/ko/sdk/web/features/device-info.mdx @@ -6,7 +6,7 @@ slug: ko/sdk/web/features/device-info Adjust SDK는 디바이스 정보를 반환하는 헬프 메서드가 포함되어 있습니다. 해당 메서드를 사용하여 콜백에 세부 정보를 추가하고 리포트를 보완하시기 바랍니다. -## Web UUID \{\#web\-uuid\} +## Web UUID {#web-uuid} @@ -27,7 +27,7 @@ EU의 개인정보 보호 규정\(GDPR\) 및 기타 개인정보 보호법\(CCPA Adjust.gdprForgetMe(); ``` -## 특정 사용자에 대한 서드파티 공유 \{\#third\-party\-sharing\-for\-specific\-users\} +## 특정 사용자에 대한 서드파티 공유 {#third-party-sharing-for-specific-users} -## 1\. 프로젝트에 SDK 추가 \{\#add\-the\-sdk\-to\-your\-project\} +## 1\. 프로젝트에 SDK 추가 {#add-the-sdk-to-your-project} 시작하려면 웹 앱에 SDK를 추가합니다. Adjust SDK는 CommonJS와 AMD\(비동기 모듈 정의\) 환경에서 모두 작동합니다. CDN\(콘텐츠 전송 네트워크\)을 통해 로딩될 때 글로벌 `Adjust` 네임스페이스를 통해 액세스할 수 있습니다. @@ -81,7 +81,7 @@ $ pnpm add @adjustcom/adjust-web-sdk -## 2\. SDK 초기화 \{\#initialize\-the\-sdk\} +## 2\. SDK 초기화 {#initialize-the-sdk} SDK를 설치한 후에는 초기화해야 합니다. 해당 기능 사용을 원하는 경우 `initSdk` 메서드를 호출합니다. 이 메서드는 앱에서 SDK가 작동하는 방식을 사용자 지정하는 데 사용할 수 있는 인수를 제공합니다. diff --git a/src/content/docs/zh/sdk/web/features/attribution.mdx b/src/content/docs/zh/sdk/web/features/attribution.mdx index 4fedcc3602..b23d387dda 100644 --- a/src/content/docs/zh/sdk/web/features/attribution.mdx +++ b/src/content/docs/zh/sdk/web/features/attribution.mdx @@ -38,7 +38,7 @@ export type AttributionMapT = $ReadOnly<{| | `click_label` | `string` | 与归因关联的 [click label](https://help.adjust.com/zh/article/user-rewards)。 | | `state` | `string` | 当前归因状态。`installed` 或 `reattributed` | -## 发生归因变化时触发回传\{\#trigger\-a\-callback\-when\-attribution\-changes\} +## 发生归因变化时触发回传{#trigger-a-callback-when-attribution-changes} @@ -68,7 +68,7 @@ Adjust.initSdk({ }); ``` -## 获取当前归因信息\{\#get\-current\-attribution\-information\} +## 获取当前归因信息{#get-current-attribution-information} ); ``` -## 设置 referrer \{\#set\-a\-referrer\} +## 设置 referrer {#set-a-referrer} diff --git a/src/content/docs/zh/sdk/web/features/device-info.mdx b/src/content/docs/zh/sdk/web/features/device-info.mdx index 9740d2ca9d..aa543990ee 100644 --- a/src/content/docs/zh/sdk/web/features/device-info.mdx +++ b/src/content/docs/zh/sdk/web/features/device-info.mdx @@ -6,7 +6,7 @@ slug: zh/sdk/web/features/device-info Adjust SDK 包含能够返回设备信息的辅助方法。用这些方法来向回传添加细节信息，优化报告。 -## Web UUID \{\#web\-uuid\} +## Web UUID {#web-uuid} @@ -27,7 +27,7 @@ function gdprForgetMe(): void; Adjust.gdprForgetMe(); ``` -## 针对特定用户的第三方分享\{\#third\-party\-sharing\-for\-specific\-users\} +## 针对特定用户的第三方分享{#third-party-sharing-for-specific-users} -## 1\. 添加 SDK 至您的项目\{\#add\-the\-sdk\-to\-your\-project\} +## 1\. 添加 SDK 至您的项目{#add-the-sdk-to-your-project} 要开始设置，请将 SDK 添加至网页应用。Adjust SDK 可在 CommonJS 和 AMD \(Asynchronous Module Definition\) 环境中运行。通过 CDN \(内容分发网络\) 加载时，您可以通过全局`Adjust`命名空间对其进行访问。 @@ -81,7 +81,7 @@ $ pnpm add @adjustcom/adjust-web-sdk -## 2\. 初始化 SDK\{\#initialize\-the\-sdk\} +## 2\. 初始化 SDK{#initialize-the-sdk} 安装 SDK 后，需要进行初始化。为此，请调用`initSdk`方法。您可以使用该方法中的参数来自定义 SDK 在应用中的工作方式。