英語からAIを使用して翻訳されました
この記事はAI技術を使用して翻訳されたことにご注意ください。正確性を維持するよう努めていますが、一部の詳細は元のテキストを完全に反映していない場合があります。情報に不明な点がある場合は、英語版を参照してください。
イベントは、ユーザーがあなたのサイト上で行ったアクションを表します。これらのイベントは、クライアントサイドのコードを介してEvents APIを通じてContentsquareに定義され、送信されます。イベントは、ページが読み込まれたとき、モーダルが表示されたとき、またはユーザーがA/Bテストを通じてページの特定のバリエーションを見たときに送信される可能性があります。
Events APIへの呼び出し
基本的な使用法：
window._uxa.push(["event", "eventName"]);使用例：
window._uxa.push(["event", "subscribed_to_email_list"]);パラメータの定義
| フィールド | タイプ | 説明 |
|---|---|---|
event |
string |
常に最初のパラメータである必要があります - リテラル文字列 "event"。 |
eventName |
string |
イベントに割り当てられたカスタム名（例：opened_modal）。 |
重要な考慮事項
- イベント名のルール：最大250文字。許可される文字にはa-z、A-Z、0-9、スペース、アンダースコア（_）、ダッシュ（-）、ピリオド（.）、コロン（:）およびスラッシュ（/）が含まれます。
- ユニークイベントの上限：サイトごとに10,000のユニークイベント。最も使用されるイベントのみがこの制限を超えて保持されます。
- イベントプロパティなし：イベントプロパティを渡すことはできません - 名前のみです。
ベストプラクティス
- メールアドレスやIPアドレスなどの個人を特定できる情報（PII）を渡さないでください。特定のユーザーとデータを接続するには、ユーザー属性機能を検討してください。
- 9桁以上の数字を送信するためにイベントを使用しないでください（クレジットカード情報を防ぐため）。
- 詳細なエラーログやリファラルコードを渡さないでください。
- 日付文字列、タイムスタンプ、または余分な値を含む可能性のあるGoogle Tag Managerデータレイヤーなどのオブジェクトからのデータを渡さないでください。
- Identify APIも使用している場合は、Event呼び出しの前にIdentify呼び出しをトリガーしてください。
- 製品特有の情報（例：SKUコード）を送信しないでください。通常、URLの方がより有用であり、デフォルトでキャプチャされます。
イベントのテスト
1. デバッグログを有効にします。
イベントをテストしたいページを開き、URLの末尾に?hjDebug=1パラメータを追加します。
例えば：
- https://www.example.com/?hjDebug=1
- https://www.example.com/?utm_1234&hjDebug=1
2. ブラウザの開発者コンソールを開きます。
3. Events APIコマンドを実行して手動でイベントを発火させます。
ブラウザコンソールにEvent APIコードを追加し、キーボードでEnterまたはReturnを押します。この確認ログを探してください：
COMMAND: Processing command: event example_actionユーザーが行うステップを通過して、イベントを自動的にトリガーすることをお勧めします。イベントが自動的に発火する場合、コードが正常に実装されていることがわかります。手動では動作するが自動では動作しない場合は、コードの実装を再確認する必要があります。