ファーストパーティドメイン統合
このページでは、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設定を更新してください:
-
SSL検証のためのTXTレコードを作成します。
- これにより、RoktがサブドメインのSSL証明書を検証できるようになります
- ユニークトークンは5日後に失効することに注意してください
TXTレコードの例
Type: TXT
Name: _acme-challenge.rkt.yourcompany.com.
Target: {token_provided_by_Rokt}
TTL: 600 seconds -
CNAMEレコードを作成します。
- CNAMEレコードは、指定したサブドメインに送信されたリクエストをRoktにリダイレクトします。 CNAMEレコードの例
Type: CNAME
Name: rkt (あなたのフルURLのサブドメイン部分)
Target: rkt.yourcompany.com.akamaized.net (Roktによって提供されます)
TTL: 600 seconds -
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が自動的に新しいドメインを使用して初期化されることを確認してもらいます。