First Party Domain Integration

このページでは、Rokt Web SDK のファーストパーティドメイン統合の設定方法について説明します。これは、Rokt Ecommerce 製品スイート（Rokt Thanks、Rokt Pay+ など）および Rokt Ads に適用されます。ファーストパーティのクライアント固有ドメインを使用することで、厳しいプライバシー制御や広告ブロッカーがある環境でも SDK が確実に読み込まれるようにし、顧客にとってよりシームレスでブランドに沿った体験を提供します。

ウェブ統合に推奨

CNAME レコードを使用したファーストパーティドメイン統合は、現在の広告およびコンテンツブロッキングの慣行により、モバイル SDK に対しては限定的なパフォーマンス向上を提供します。

前提条件

開始する前に、以下を確認してください：

• 技術チームが DNS 設定にアクセスでき、CNAME レコードと TXT レコードを作成できること。
• ウェブサイトがファーストパーティサブドメインへのウェブリクエストを許可していること。

1. サブドメインを選択する

Rokt SDK を読み込むサブドメインを選択します。例: rkt.yourcompany.com

"Rokt" や "Ads"、"Offers" などの広告関連のキーワードを含まないようにしてください。これにより、配置がブロックされる可能性があります。使用するサブドメインを決定したら、それを Rokt のアカウント担当者に共有してください。

2. Rokt が SSL 証明書を作成する

このステップは Rokt が処理します。次のステップまでアクションを取る必要はありません。

専任の Rokt チームがサブドメインを受け取った後、SSL 証明書の発行を行います。その後、次のステップで TXT レコードと CNAME ターゲットドメインを作成するために必要なユニークトークンを提供します。

3. DNS レコードを作成する

Rokt チームからユニークトークンと CNAME ターゲットドメインを受け取った後、DNS 設定を以下のように更新します：

1. SSL 検証用の TXT レコードを作成します。

   • これにより、Rokt がサブドメインの SSL 証明書を検証できるようになります
   • ユニークトークンは 5 日後に期限切れになることに注意してください

   TXT レコードの例

   Type: TXT
   Name: _acme-challenge.rkt.yourcompany.com.
   Target: {token_provided_by_Rokt}
   TTL: 600 seconds

2. CNAME レコードを作成します。

   • 指定したサブドメインに送信されたリクエストを Rokt にリダイレクトする CNAME レコードを作成します。 CNAME レコードの例

   Type: CNAME
   Name: rkt (the subdomain part of your full URL)
   Target: rkt.yourcompany.com.akamaized.net (provided by Rokt)
   TTL: 600 seconds

3. TXT レコードと CNAME レコードを作成したら、Rokt チームに通知します。

4. SDK 初期化スクリプトを更新する

専任の Rokt チームが TXT レコードと CNAME レコードが機能していることを確認した後、SDK 初期化スクリプトを更新して、新しく選択したサブドメインを参照するようにします。 初期化スクリプトで、DOMAIN が指定されている行を探します：

const DOMAIN = "https://apps.rokt-api.com";

値を Rokt のドメインから自分のドメインに変更します：

const DOMAIN = "https://rkt.yourcompany.com";

最後に、スクリプトのドメイン設定を更新したことを Rokt に通知し、SDK が新しいドメインを使用して自動的に初期化されることを確認します。