Skip to content

Commit

Permalink
File src/content/docs/en/sdk/web/index.mdx was translated to ja-JP lo…
Browse files Browse the repository at this point in the history 
…cale
  • Loading branch information
@smartling-github-connector
smartling-github-connector[bot] authored Dec 10, 2024
1 parent b367712 commit aa471ec
Showing 1 changed file with 47 additions and 137 deletions.
184 changes: 47 additions & 137 deletions src/content/docs/ja/sdk/web/index.mdx
View file
Original file line number Diff line number Diff line change
@@ -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をアプリに実装する方法をご紹介します。
<callout type="important">

## 1\. プロジェクトにSDKを追加する {#add-the-sdk-to-your-project}
Web SDKを使用するには、Adjustダッシュボードで専用のWebアプリを作成し、その2つを連携する必要があります。モバイルアプリSDKが既に実装されているモバイルアプリには、Web SDKを実装しないでください。
</Callout>

まずは、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\}

<Callout type="tip">
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` 。このパッケージは自動的にアップデートされるため、ターゲットファイルを変更する必要はありません。

</Callout>
<callout type="tip">

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.
</Callout>

CDNを利用してSDKを読み込むには、Webアプリの`<head id="sl-md0000000">`タグ間に次のスニペットを追加します。

CDNを利用してSDKを読み込むには、Webアプリの`<head>`タグ間に次のスニペットを追加します。
\{/\* prettier\-ignore \*/\}

```html
<script type="application/javascript">
!(function (t, e, a, r, n, s, d, l, o, i, u) {
(t.Adjust = t.Adjust || {}), (t.Adjust_q = t.Adjust_q || []);
for (var c = 0; c < l.length; c++) o(t.Adjust, t.Adjust_q, l[c]);
(i = e.createElement(a)),
(u = e.getElementsByTagName(a)[0]),
(i.async = !0),
(i.src = "https://cdn.adjust.com/adjust-latest.min.js"),
(i.onload = function () {
for (var e = 0; e < t.Adjust_q.length; e++)
t.Adjust[t.Adjust_q[e][0]].apply(t.Adjust, t.Adjust_q[e][1]);
t.Adjust_q = [];
}),
u.parentNode.insertBefore(i, u);
})(
window,
document,
"script",
0,
0,
0,
0,
[
"initSdk",
"getAttribution",
"getWebUUID",
"setReferrer",
"trackEvent",
"addGlobalCallbackParameters",
"addGlobalPartnerParameters",
"removeGlobalCallbackParameter",
"removeGlobalPartnerParameter",
"clearGlobalCallbackParameters",
"clearGlobalPartnerParameters",
"switchToOfflineMode",
"switchBackToOnlineMode",
"stop",
"restart",
"gdprForgetMe",
"disableThirdPartySharing",
"initSmartBanner",
"showSmartBanner",
"hideSmartBanner",
],
function (t, e, a) {
t[a] = function () {
e.push([a, arguments]);
};
},
);
<script type="application/javascript" id="sl-md0000000">
!function(t,r,e,a,n,o,i,l,c,s,d,h,u){var f=i+"_q",m=i+"_c";t[i]=t[i]||{},t[f]=t[f]||[],t[m]=t[m]||[];for(let r=0;r<l.length;r++)d(t[i],t[f],l[r]);for(let r=0;r<c.length;r++){var g,b=c[r][0],p=c[r][1];t[i][b]=function(...r){return g=this,t[m].push((function(){g[s]=new t[i][b](...r)})),g};for(let r=0;r<p.length;r++){const e=p[r];t[i][b].prototype[e]=function(...r){t[m].push((function(){g[s][e](...r)}))}}}h=r.createElement(e),u=r.getElementsByTagName(e)[0],h.async=!0,h.src="https://cdn.adjust.com/adjust-latest.min.js",h.onload=function(){for(var r=0;r<t[m].length;r++)t[m][r]();t[m]=[];for(r=0;r<t[f].length;r++)t[f][r][1][0][s]?t[i][t[f][r][0]](t[f][r][1][0][s]):t[i][t[f][r][0]].apply(t[i],t[f][r][1]);t[f]=[]},u.parentNode.insertBefore(h,u)}(window,document,"script",0,0,0,"Adjust",["initSdk","getAttribution","getWebUUID","waitForAttribution","waitForWebUUID","setReferrer","trackEvent","addGlobalCallbackParameters","addGlobalPartnerParameters","removeGlobalCallbackParameter","removeGlobalPartnerParameter","clearGlobalCallbackParameters","clearGlobalPartnerParameters","switchToOfflineMode","switchBackToOnlineMode","stop","restart","gdprForgetMe","disableThirdPartySharing","trackThirdPartySharing","initSmartBanner","showSmartBanner","hideSmartBanner"],[["ThirdPartySharing",["addGranularOption","addPartnerSharingSetting"]]],"__realObj",(function(t,r,e){t[e]=function(){r.push([e,arguments])}}));
</script>
```

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
<script type="application/javascript">
!(function (t, e, a, r, n, s, o, d, l, i, u) {
(t.Adjust = t.Adjust || {}), (t.Adjust_q = t.Adjust_q || []);
for (var c = 0; c < d.length; c++) l(t.Adjust, t.Adjust_q, d[c]);
(i = e.createElement(a)),
(u = e.getElementsByTagName(a)[0]),
(i.async = !0),
(i.src = "https://cdn.adjust.com/adjust-latest.min.js"),
(i.crossOrigin = "anonymous"),
(i.integrity = s),
(i.onload = function () {
for (var e = 0; e < t.Adjust_q.length; e++)
t.Adjust[t.Adjust_q[e][0]].apply(t.Adjust, t.Adjust_q[e][1]);
t.Adjust_q = [];
}),
u.parentNode.insertBefore(i, u);
})(
window,
document,
"script",
0,
0,
"sha384-BqbTn9xyk5DPznti1ZP8ksxKiOFhKufLBFWm5eNMCnZABFSG1eqQfcu5dsiZJHu5",
0,
[
"initSdk",
"getAttribution",
"getWebUUID",
"setReferrer",
"trackEvent",
"addGlobalCallbackParameters",
"addGlobalPartnerParameters",
"removeGlobalCallbackParameter",
"removeGlobalPartnerParameter",
"clearGlobalCallbackParameters",
"clearGlobalPartnerParameters",
"switchToOfflineMode",
"switchBackToOnlineMode",
"stop",
"restart",
"gdprForgetMe",
"disableThirdPartySharing",
"initSmartBanner",
"showSmartBanner",
"hideSmartBanner",
],
function (t, e, a) {
t[a] = function () {
e.push([a, arguments]);
};
},
);
<script type="application/javascript" id="sl-md0000000">
!function(t,r,e,a,n,o,i,l,s,c,d,h,u){var f=i+"_q",g=i+"_c";t[i]=t[i]||{},t[f]=t[f]||[],t[g]=t[g]||[];for(let r=0;r<l.length;r++)d(t[i],t[f],l[r]);for(let r=0;r<s.length;r++){var m,b=s[r][0],p=s[r][1];t[i][b]=function(...r){return m=this,t[g].push((function(){m[c]=new t[i][b](...r)})),m};for(let r=0;r<p.length;r++){const e=p[r];t[i][b].prototype[e]=function(...r){t[g].push((function(){m[c][e](...r)}))}}}h=r.createElement(e),u=r.getElementsByTagName(e)[0],h.async=!0,h.src="https://cdn.adjust.com/adjust-latest.min.js",o&&(h.crossOrigin="anonymous",h.integrity=o),h.onload=function(){for(var r=0;r<t[g].length;r++)t[g][r]();t[g]=[];for(r=0;r<t[f].length;r++)t[f][r][1][0][c]?t[i][t[f][r][0]](t[f][r][1][0][c]):t[i][t[f][r][0]].apply(t[i],t[f][r][1]);t[f]=[]},u.parentNode.insertBefore(h,u)}(window,document,"script",0,0,"sha384-WE6fJqvcE0mjcC/fPYooIQAOhsHpTDVYjC52i6Asn3LECEpjHyI5zUwD8/5esthg","Adjust",["initSdk","getAttribution","getWebUUID","waitForAttribution","waitForWebUUID","setReferrer","trackEvent","addGlobalCallbackParameters","addGlobalPartnerParameters","removeGlobalCallbackParameter","removeGlobalPartnerParameter","clearGlobalCallbackParameters","clearGlobalPartnerParameters","switchToOfflineMode","switchBackToOnlineMode","stop","restart","gdprForgetMe","disableThirdPartySharing","trackThirdPartySharing","initSmartBanner","showSmartBanner","hideSmartBanner"],[["ThirdPartySharing",["addGranularOption","addPartnerSharingSetting"]]],"__realObj",(function(t,r,e){t[e]=function(){r.push([e,arguments])}}));
</script>
```

### npmを使用する {#using-npm}

Adjust SDKは[npm](https://www.npmjs.com/package/@adjustcom/adjust-web-sdk)でも提供されています。パッケージをプロジェクトに追加するには、好みのパッケージマネージャーを使用します。
### Using npm \{\#using\-npm\}

<Tabs>
<Tab title="NPM" sync="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:
<tabs> <tab title="npm" sync="npm">

```console
$ npm install @adjustcom/adjust-web-sdk --save
```

</Tab>
<Tab title="yarn" sync="yarn">
</Tab> <tab title="Yarn" sync="yarn">

```console
$ yarn add @adjustcom/adjust-web-sdk
```

</Tab>
<Tab title="pnpm" sync="pnpm">
</Tab> <tab title="pnpm" sync="pnpm">

```console
$ pnpm add @adjustcom/adjust-web-sdk
```

</Tab>
</Tabs>
</Tab> </Tabs>

## 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({
Expand All @@ -184,8 +94,8 @@ Adjust.initSdk({
});
```

<Callout type="seealso">

Adjust SDKの設定をカスタマイズするには、[設定ガイド](/ja/sdk/web/configuration)をご覧ください。
<callout type="seealso">

AdjustのWeb SDKの引数とプロパティの全リストは、[設定ガイド](/en/sdk/web/configuration)をご覧ください。
</Callout>

0 comments on commit aa471ec

Please sign in to comment.