Web SDK 連携ガイド

Adjust Web SDKを実装することで、アトリビューションやイベントなどのさまざまなデータをWebアプリで記録できます。このガイドでは、Adjust SDKをアプリに実装する方法をご紹介します。

1. プロジェクトにSDKを追加する

まずは、WebアプリにSDKを追加します。Adjust SDKは、CommonJSとAMD（Asynchronous Module Definition）の両方の環境で動作します。CDN（Content Delivery Network）を利用して読み込むと、グローバルのAdjust名前空間を通じてアクセスできます。

CDNを使用する

CDNを利用してSDKを読み込むときは、本番用ビルドには縮小バージョンを使用する必要があります。バージョンを指定するには、https://cdn.adjust.com/adjust-5.6.0.min.jsのようにCDNターゲットに追加します。https://cdn.adjust.com/adjust-latest.min.jsのように、adjust-latestパッケージをターゲットにすることで、最新版を入手することができます。このパッケージは自動的にアップデートされるため、ターゲットファイルを変更する必要はありません。

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

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

Adjust SDKはページごとに読み込まれ、ページの読み込みごとに1回起動されます。

サブリソース完全性

XSS（クロスサイトスクリプティング）攻撃を緩和するためにサブリソース完全性チェックを使用する場合、次の呼び出しを使用すると、パッケージが実行される前に検証することができます。

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

npmを使用する

Adjust SDKはnpmでも提供されています。パッケージをプロジェクトに追加するには、好みのパッケージマネージャーを使用します。

2. SDKを初期化する

SDKをインストールしたら、初期化する必要があります。これを行うには、initSdkメソッドを呼び出します。このメソッドは、アプリでのSDKの動作をカスタマイズするいくつかの引数を取ります。

SDKを初期化するには、initSdk呼び出しに次の引数を追加する必要があります。

appToken （string）：お客様のAdjustアプリトークン。
environment （string）：SDKを実行したい環境。テスト用のサンドボックスモードでSDKを実行するにはsandboxをパスします。リリース用の本番モードでSDKを実行するにはproductionをパスします。

Adjust.initSdk({
   appToken: "YOUR_APP_TOKEN",
   environment: "sandbox",
});