注：このサービスは現在クローズドベータ版であるため、一部のお客様のみにテストとして提供されています。以下の情報は、誓約、保証、法的義務を伴うものではありません。ここに記載されている機能の開発、リリース、およびタイミングは、Pendoの裁量により予告なく変更される場合があります。このフィーチャーを早期に試し、フィードバックを提供したいとお考えの場合は、Pendoのアカウント担当者にお問い合わせください。
この記事では、サポートチームを通さずに、組織レベルでCNAMEレコードを設定し、自分のアプリケーションのドメイン下にホスト名を作成する方法を概説します。イベントの送信やガイドコンテンツのダウンロードには、Pendoホスト名の代わりにこれらを使用できます。
これにより、広告ブロックソフトウェア、ファイアウォール、ウェブフィルターなどを使用しても、確実にイベントが収集され、訪問者にガイドが提供されます。Pendoの代わりに独自ドメインを使用できるため、ブランドの一貫性を保つ上でも役立ちます。
前提条件
この記事を読み進める前に、まず［PendoのCNAME］を読むことを強くお勧めします。
以下の手順では、PendoのインストールとDNSエントリを更新するためのエンジニアリングリソースが必要です。組織のPendo契約に含まれるCNAMEアクセス、静的IPアドレス、プロキシ、SSL証明書の提供が必要です。
この記事で説明されているような技術的な設定には、組織の管理者権限が必要です。組織の管理者はサブスクリプション管理者より上のレベルであり、複数のPendoサブスクリプションに関する権利を持っています。しかし、サブスクリプション管理者権限も持っていない限り、個々のサブスクリプション設定、ガイド、データ可視性を変更したり、サブスクリプション管理者アクセスを制御できません。サブスクリプション管理者アクセスは、管理者権限を日常的に管理するための最高レベルのアクセス権限であることに変わりはありません。
CNAME設定を追加する
続行する前に、PendoのCNAMEに関する記事をお読みください。
組織に新しいCNAME設定を追加するには、次の手順を実行する必要があります。
ステップ1. 新しいCNAME設定を作成する
［設定（Settings）］>［組織設定（Organization settings）］>［CNAME］でCNAMEに移動します。設定するサブスクリプションにマウスを移動し、［CNAME構成の表示（View CNAME Configuration）］を選択します。次に、［サブスクリプションCNAME設定（Subscription CNAME Settings）］ページで次の操作を行います。
- 右上隅の［CNAME設定の管理（Manage CNAME Configurations）］を選択します。これにより、［CNAME構成（CNAME Configuration）］ページが開きます。
- ページの右上隅にある［新しいCNAME設定（New CNAME Configuration）］を選択します。セットアップウィンドウが開きます。
- CNAME設定の［名前（Name）］、［ドメイン（Domain）］、［コンテンツプレフィックス（Content Prefix）］、［データプレフィックス（Data Prefix）］を入力し、［保存（Save）］を選択します。
- Pendoで設定のステータスを確認し、設定に合わせるとDNS エントリを更新するように求めるメールがPendoから届きます。
ステップ2. DNSの問い合わせを更新する
CNAMEの設定と検証が完了し、［ステータス（Status）］列のステータスが［完了（Done）］になると、PendoからPendoインストールスクリプトにコードを挿入するよう求める通知が届きます。DNSエントリをコピーしてフロントエンドコードに貼り付けます。Pendoが自動的に変更して変更を確定し、確認メールを送信します。
このコードは、［サブスクリプションCNAME設定（Subscription CNAME Settings）］ページで作成したCNAME構成を開いて見つけることもできます。
- ［設定（Settings）］ > ［組織設定（Organization Settings）］ > ［CNAME］に移動します。
- 設定したいサブスクリプションにカーソルを合わせます。
- ［CNAME構成の表示（View CNAME Configuration）］を選択して、［サブスクリプションCNAME設定（Subscription CNAME Settings）］ページを開きます。
- 組織に追加するCNAME設定の名前を選択します。
- DNSエントリをコピーします。これらは、CNAME設定の準備が完了したことを通知するPendoからのメールに記載されているものと同じDNSエントリです。
- CNAMEの割り当て準備ができたことを知らせるPendoからのメールが届きます。
サブスクリプションCNAME設定の管理
左側のナビゲーションから［設定（Settings）］>［組織設定（Organization settings）］>［CNAME］に移動します。設定したいサブスクリプションにマウスを移動し、［CNAME設定の表示（View CNAME Configuration）］を選択します。これにより、サブスクリプション内のすべてのアプリに現在割り当てられているCNAME構成が表示されます［サブスクリプションのCNAME設定（Subscription CNAME Settings）］ページが表示されます。
表内の各項目のドロップダウンメニューを使用して［CNAME設定（CNAME Configuration）］を変更できます。CNAME設定では、Pendoのフロントエンドコード内でアカウントの指定されたドメインが使用されます。このため、CNAME構成を変更する場合は、Pendoインストールスクリプトのpendo.js URLと、該当する場合はCSP設定も更新する必要があります。
Pendoインストールスクリプトを更新する
CNAMEがアプリケーションに割り当てられた後、Pendoは新しい設定を使用してサブスクリプションのPendoエージェントを書き換えます。それ以降、Pendoとのすべての通信は、CNAMEによって提供されるエイリアスを通じて行われます。
次に、アプリケーションに追加されたPendoのインストールスクリプト（一般に「スニペット」と呼ばれる）を新しい「コンテンツホスト」で更新します。これを実行している間もcdn.pendo.ioは動作し続けるため、データは失われません。
Twilio Segmentと一緒にPendoをインストールしている場合、Segmentの送信先設定でCNAMEコンテンツホストフィールドを使用してコンテンツホストを追加することができます。これを行う方法の詳細については、 「Twilio SegmentによるPendoのインストール」 の「ステップ2. Pendo Web（Actuib）の宛先を追加する」 を参照してください。
既存のガイドを更新する
新しいCNAME設定でアプリケーションを更新した後は、公開した各ガイドとそのガイド内の画像やコンテンツを再保存して、コンテンツに新しいエイリアスを参照させる必要があります。
アクティブなガイドごとに、次の手順を繰り返します。
- ガイドを見つけて開き、詳細を表示します。
- ［コンテンツ（Content）］セクションの右上にある［自分のアプリで管理（Manage in my app）］を選択します。
- ビジュアルデザインスタジオ（Visual Design Studio）のバナーで［保存（Save）］を選択します。バナーは通常、ブラウザの上部または下部にあります。詳細については、「ガイドの作成」を参照してください。