Last updated 2024年12月5日

Rokt

Roktのユニバーサルモジュール定義（UMD）バンドルはウィンドウオブジェクトに露出しており、Roktのソリューションがページにロードされた後に利用可能になります。

概要

Roktのスクリプトがページにロードされた後、Rokt UMDバンドルはウィンドウオブジェクト上でwindow.Roktとして利用可能になります。スクリプトの読み込みが完了するとRoktプロパティと対話できるようになりますが、スクリプトが非同期でロードされた場合は追加の処理が必要になる場合があります。

同期読み込みの例

<script
  crossorigin="anonymous"
  src="https://apps.rokt.com/wsdk/integrations/launcher.js"
></script>

const launcher = await window.Rokt.createLauncher({
  accountId: "rokt-account-id",
});

上記の引数リストには以下の重要なパラメータに注意してください：

• https://apps.rokt.com/wsdk/integrations/launcher.js — Roktランチャーの最新バージョンを指すURLです。
• rokt-account-id — あなたのユニークなRoktアカウントIDであり、正しい値に置き換えるべきです。アカウントIDがわからない場合は、どこでRoktアカウントIDを見つけることができますか？を参照してください。

非同期読み込みの例

<script
  async
  crossorigin="anonymous"
  id="rokt-launcher"
  fetchpriority="high"
  src="https://apps.rokt.com/wsdk/integrations/launcher.js"
  type="module"
></script>

await new Promise((resolve) =>
  window.Rokt
    ? resolve()
    : (document.getElementById("rokt-launcher").onload = resolve)
);

const launcher = await window.Rokt.createLauncher({
  accountId: "rokt-account-id",
});

スクリプトタグに存在する追加属性に注意してください:

• async - スクリプトの非同期読み込みを有効にします
• id="rokt-launcher" - スクリプト要素のIDです。これは document.getElementById('rokt-launcher') に渡されたIDと一致する必要があります。
• type="module" - 読み込まれるリソースの優先度を高めます。詳細については ベストプラクティス を参照してください。

さらに、Rokt UMDバンドルを取得するには、Promise内でラップする必要があります（例のように）、これは非同期に読み込まれたRoktスクリプトが利用可能になった後のみコードが実行されることを保証します。

メソッド

createLauncher

▸ createLauncher: (options: IntegrationLauncherOptions): Promise<IntegrationLauncher>

IntegrationLauncher のインスタンスを作成します。これはRoktとの統合のためのエントリーポイントです。作成されたオブジェクトの参照を保持するのは統合者の責任です。

同時に、単一のインスタンスのみが存在できます。別のインスタンスを作成しようとすると、前のインスタンスが終了していない限り、エラーが発生します。

パラメータ:

名前	型	説明
options	IntegrationLauncherOptions	統合をカスタマイズするためのオプション

返します: IntegrationLauncher