イベント
イベント画面には、サイトが意図して送信するイベントが表示されます。各イベントが現在も発生しているか、発生頻度、送信した訪問者数、送信元のページを確認できます。
イベントを送信する
Silktideのアナリティクススニペットがページに追加されると、関心のある事象が発生した場所で、名前を指定してsilktideを呼び出せます。たとえば、フォームの送信、動画の再生、登録などです。
document.querySelector("#newsletter-form").addEventListener("submit", () => {
silktide("newsletter_signup");
});
このスニペットでは、アナリティクススクリプトの読み込み前にsilktideが定義されます。そのため、早い段階で送信されたイベントはキューに追加され、スクリプトの準備が整うと記録されます。
newsletter_signupやvideo_playedのように、イベントを追跡している間は変わらない名前を選択してください。この名前は、フィルター、エクスポート、目標、APIで使用されます。個人データは含めないでください。イベント名には、メールアドレス、氏名、アカウント番号を絶対に入れないでください。
アナリティクススクリプトは、すでに一部のイベントを以下の名前で記録しています。独自のイベントには別の名前を付けてください。page_load、page_update、page_return、click、download、frustration、field。
イベントとともに詳細を送信する
2番目の引数としてオブジェクトを渡すと、どのアコーディオンが開かれたか、どのフォームが送信されたか、どの動画が再生されたかなど、発生内容の詳細を指定できます。そのオブジェクト内の各キーは、イベントのプロパティです。
document.querySelectorAll("details").forEach((accordion) => {
accordion.addEventListener("toggle", () => {
if (accordion.open) {
silktide("open_accordion", {
summary: accordion.querySelector("summary")?.textContent.trim() ?? "",
});
}
});
});
- すべての値はテキストとして記録されます。テキスト、数値、またはtrueとfalseを送信してください。プロパティ内のオブジェクトやリストは、有用な形式では記録されません。
- ページのアドレスを送信する必要はありません。すべてのイベントには、送信元のページがすでに記録されています。
- プロパティを追跡している間は名前を変えず、イベント名と同様に値にも個人データを含めないでください。
event、time、pageUrlはスクリプト自体で使用されるため、プロパティとしては記録されません。
画面に表示される内容
- あなたのイベントには、期間中に最も多かった4つのイベントがカードとして表示されます。各カードには、イベントの送信回数、送信した訪問者数、訪問者あたりの回数、期間中の推移、最後に確認された日時が表示されます。比較をオンにすると、前の期間との差分が件数に表示されます。
- 最後に確認の横にあるドットは、イベントが3日を超えて送信されていない場合に黄色になります。発生しなくなったイベントは、誤ってサイトから削除された可能性があります。
- テストのようですは、1人の訪問者から3回以下しか送信されていないイベントを示します。通常は、誰かが試しているイベントです。
- 発生場所には、イベントの送信元ページが頻度順に表示されます。別のイベントを選択してそのページを表示したり、そのイベントを含むジャーニーを開いたり、すべてのページを見るを選択してイベントの完全な一覧を表示したりできます。
- 自動記録には、スクリプトが自動的に記録するイベントが一覧表示されます。それぞれ対応する画面へのリンクがあります。ページ読み込みはページ、クリックはクリック、フラストレーションはフラストレーション、ダウンロードはダウンロードにリンクします。
- 表には、サイトが送信するすべてのイベントと、それぞれが最初と最後に確認された日時が表示されます。行を開くとそのイベントの詳細を確認でき、メニューからジャーニーを表示したり、すべての画面をそのイベントでフィルターしたりできます。
アナリティクスを管理できるユーザーは、表からイベントに読みやすい名前を付けることができます。この名前はアカウント全体に適用されます。フィルターとエクスポートでは、引き続きサイトが送信する名前が使用されます。
イベントの詳細
表からイベントを開くと、そのイベント単体の情報を確認できます。期間中の送信頻度、訪問者の流入元、そしてこのイベントを通るジャーニーが表示されます。これは、イベント送信時に訪問者がいたページと、その後に移動した先を示します。表示方法はこのページを通るジャーニーと同様です。
送信元ページには、イベントの送信元となったすべてのページが頻度順に表示されます。ページを検索したり、ページの詳細を開いたり、行のメニューからページを検査したりできます。
プロパティ付きで送信されたイベントの場合、詳細には次の内容も表示されます。
- 送信時の内容では、1つのプロパティの値が送信回数順にランク付けされ、各値の送信回数が表示されます。一覧の上にあるメニューから別のプロパティを選択できます。値を選択すると、その値でイベントが送信された回のみを一覧表示します。もう一度選択すると、すべての送信回を表示します。
- 送信されたすべての回には、イベントが送信された各回が新しい順に表示されます。日時、送信元ページ、各プロパティがそれぞれ別の列に表示されます。ページまたは値で検索したり、行を開いてそのイベントを含む訪問を確認したりできます。
APIを通じてイベントの詳細を取得する
Silktide REST APIでは同じ詳細を取得できるため、独自のツールでレポートできます。各エンドポイントは、すべてのアナリティクスエンドポイントで使用できる日付範囲とフィルターに加え、イベント名をeventとして受け取ります。
analytics/event-propertiesは、イベントが送信された際のプロパティを一覧表示します。analytics/event-property-valuesは、1つのプロパティの値をランク付けします。プロパティ名はpropertyとして指定します。analytics/event-occurrencesは、イベントが送信されたすべての回を新しい順に一覧表示します。各行には、time(秒単位のUnixタイムスタンプ)、urlとしてのページ、sessionIdとしてのそのイベントを含む訪問、およびpropertiesが含まれます。propertyとvalueを追加すると、その値で送信された回のみを一覧表示できます。
API画面でキーを作成してください。完全なリクエスト形式と、サイトからイベントを送信する方法については、開発者向けドキュメントを参照してください。
目標でイベントを使用する
訪問者がイベントを発生させたときに、目標を完了とすることができます。ファネルと目標を参照してください。
イベントが表示されない場合
イベントを送信するページにアナリティクススニペットがあること、silktideを呼び出すコードが実行されること、選択した日付範囲に今日が含まれていることを確認してください。