この記事では、インストールスクリプトを使用してPendoをインストールする際に発生する一般的な問題の解決策について説明します。インストールの詳細については、「インストールスクリプトを使用してPendoのウェブでの直接実装を計画する」および「インストールスクリプトを使用してPendoを実装するための開発者ガイド」をご参照ください。
コンソールのエラーメッセージ：Pendo APIキーが設定されていません（No API key configured）
このメッセージは通常、初期化コードにエラーが生じた場合に表示されます。多くの場合、pendo.initialize()の呼び出し時に、初期化コードに渡されている1つ以上の変数が使用できない状態を意味します。pendo.initialize()を呼び出す前に、値が存在することを確認してください。
このエラーは、ページ上でpendo.initialize()を呼び出していないことを意味している可能性もあります。ウェブでの直接実装のドキュメントとインストールを確認して、Pendoが正しく初期化されていることを確認してください。
コンソールの警告：現在の訪問者は識別されず「匿名」とされます（The current visitor is not identified and will be treated as "anonymous"）
この警告は、訪問者IDフィールドに値が渡されていない場合に表示されます。値が渡されず、空白の文字列が渡された場合、Pendo Web SDKは匿名の訪問者IDを作成します。一般に、匿名IDを持つのはサインインしていないユーザーのみです。そのため、ユーザーがサインインしている場合は、安定した識別子を訪問者IDとして渡す必要があります。
Pendoにデータが表示されません
データはすぐには表示されません。毎時0分に一括集計され、Pendo UIに完全に表示されるまでに、毎時0分を過ぎてから最大15分かかることがあります。それでもPendoにデータが表示されない場合は、以下をお試しください。
インストールスクリプトにAPIキーが含まれていることを確認してください。［インストール設定（Install Settings）］ページからコードブロックをコピーした場合は、APIキーはすでに含まれています。
データ構文のルールに従っていることを確認してください。どのフィールドにもNULL値を送信しないでください。データがないフィールドは送信しないでください。インストールスクリプトで追加されたカスタムフィールドにスペースを含めないでください。フィールドは、アルファベットまたはアンダースコアで始まり、その後にアルファベットまたは数字、アンダースコアを組み合わせることができます。詳細については、訪問者とアカウントのメタデータ設定を参照してください。
メッセージ：ログインしているユーザーがいません
セットアップ中に「ログインしているユーザーがいません（No Logged In Users）」というメッセージが表示される場合、Pendoがアプリケーションから基本データを受信している（アプリでページやフィーチャーが使用されている）にもかかわらず、ユーザーの識別情報がない状態を意味します。このデータがなくてもPendoを使用することはできますが、機能は大幅に低下します。
これは、アプリケーションからPendoに送信されるすべての変数への代入が完了する前にPendoを初期化したことが原因である可能性があります。この問題を解決する方法については、「条件付きでPendoを初期化する」の記事の「例2. 変数が入力された後の条件付き初期化」を参照してください。
インストールスクリプトでは、データが渡されていないか、訪問者ブロックまたはアカウントブロックのデータ構造が正しくありません。このコードのテンプレートは以下のとおりです。
visitor: {
id: 'VISITOR-UNIQUE-ID' // Required if user is logged in
// email: // Recommended if using Pendo Feedback, or NPS Email
// full_name: // Recommended if using Pendo Feedback
// role: // Optional
// You can add any additional visitor level key-values here,
// as long as it's not one of the above reserved names.
},
account: {
// id: 'ACCOUNT-UNIQUE-ID' // Highly recommended
// name: // Optional
// is_paying: // Recommended if using Pendo Feedback
// monthly_value:// Recommended if using Pendo Feedback
// planLevel: // Optional
// planPrice: // Optional
// creationDate: // Optional
// You can add any additional account level key-values here,
// as long as it's not one of the above reserved names.
}以下は、コード内のデータの表示例です。
visitor: {
id: $user.ID,
email: $user.email,
full_name: $user.full_name,
role: $user.accessLevel,
creationDate: $user.creationDate
},
account: {
id: $account.ID,
name: $account.name,
is_paying: $account.is_paying,
monthly_value:$account.monthly_value,
planLevel: $account.subscriptionCost,
isFoo: $account.isFoo
}以下は、コードの処理およびPendoへの送信後の表示例です。
visitor: {
id: 62343,
email: john@doe.com,
full_name: John Doe,
role: admin,
creationDate: 1404326949156
},
account: {
id: 17,
name: Acme, inc,
is_paying: true,
monthly_value:99.99,
planLevel: 995,
isFoo: false