webトラッキング機能を使用して、webサイトやミニプログラムからブラウザの詳細、閲覧動作、滞留時間のユーザーログを収集します - Simple Log Service

webトラッキング機能を使用して、ブラウザの詳細、閲覧動作、購入動作、滞留時間などのユーザー情報をブラウザやミニプログラムから収集して分析できます。 Simple Log ServiceのLogstoreにユーザーの行動情報をアップロードするには、サービスコードをわずかに変更するだけです。たとえば、フロントエンドページにトレースピクセルを追加したり、JavaScript用のwebトラッキングSDKを統合したりできます。

webトラッキング機能の概要

webトラッキング機能は、特定のコードスニペットをwebページに追加することでユーザーの行動を追跡するために使用されます。 webトラッキング機能を使用して、ユーザーとwebサイト間のやり取りに関する情報を収集できます。情報は、アクセスされたページ、ページ上の滞留時間、および地理的位置を含む。
webトラッキング機能は、目に見えない1x1ピクセルの画像をwebページに埋め込みます。ページにアクセスすると、ブラウザはwebサーバーへのGETリクエストを開始し、サーバーは自動的にリクエストURLのパラメーターをSimple Log Serviceに送信して保存します。この場合、パラメーターはユーザーログに相当します。このタイプのリクエストには、通常、IPアドレス、ブラウザータイプ、オペレーティングシステムなどのユーザー関連情報が含まれています。
webトラッキング機能を使用して、ブラウザーやミニプログラムでのユーザーの行動を追跡し、行動データをSimple Log Serviceにアップロードできます。これにより、ユーザーの行動を効率的に分析できます。 webトラッキング機能を使用して、ブラウザ、iOSアプリ、およびAndroidアプリから次のユーザー情報を収集できます。
- 使用されるブラウザ、オペレーティングシステム、および解像度。
- Webサイトでのクリックや購入などの閲覧動作。
- アプリとアクティブユーザーの滞留時間。

手順1: ログストアのWebTrackingを有効にする

重要

LogstoreのWebTrackingをオンにすると、インターネットからの匿名ユーザーにLogstoreの書き込み権限が付与されます。これにより、正当な認証が行われないため、ダーティデータが発生する。 Security Token Service (STS) を使用してログを収集することを推奨します。この場合、LogstoreのWebTrackingを有効にする必要はありません。詳細については、このトピックの「webトラッキング機能とSTSを使用してログを収集する」をご参照ください。

Simple Log Serviceコンソール
1. Simple Log Serviceコンソールにログインします。
2. [プロジェクト] セクションで、管理するプロジェクトをクリックします。
3. [ログストレージ] > [ログストア] タブで、WebTrackingを有効にするログストアを見つけ、 > [変更] を選択します。
4. [ログストア属性] ページで、右上隅の [変更] をクリックします。
5. WebTrackingをオンにし、[Save] をクリックします。
API
- UpdateLogStore操作を呼び出して、WebTrackingを有効にします。 enable_trackingパラメーターをtrueに設定する必要があります。

ステップ2: ログの収集

クライアントSDK: WebトラッキングSDK for JavaScriptは、カスタムタイプのログをLogstoreにアップロードするコードに統合されています。ログは、フォーム送信、ページ送信、および例外レポートに関連しています。
HTTP GETリクエスト: Webサイトのフロントエンドコードは、簡単な方法でログを収集するためのGETリクエストを送信します。
HTML imgタグ: HTML <img> タグのsrc属性は、webサーバーへのリクエストを開始するために使用されます。リクエストURLはGIFイメージを参照します。この場合、JavaScript環境とクロスドメインアクセスの設定は必要ありません。
API操作: リクエストされたデータの量が多い場合は、POSTリクエストを送信してデータをアップロードすることでAPI操作を呼び出すことができます。

クライアントSDK

webトラッキングSDKを初期化してログをアップロードする方法の詳細については、「webトラッキングSDK For JavaScriptを使用してwebサイトログを収集する」および「webトラッキングSDK for JavaScriptを使用してミニプログラムログを収集する」をご参照ください。

HTTP GETリクエスト

curlツールで次のコマンドを実行して、HTTPリクエストを送信し、ログをアップロードします。ビジネス要件に基づいてパラメーターを設定します。

curl -- request GET 'http://${project}.${host}/logstores/${logstore}/track?APIVersion=0.6.0&key1=val1&key2=val2'

パラメーター	必須	説明
${project}	課金されます	プロジェクトの名前。
${host}	課金されます	プロジェクトが存在するリージョンのSimple Log Serviceエンドポイント。詳細については、「エンドポイント」をご参照ください。
${logstore}	課金されます	ログストアの名前
APIVersion=0.6.0	課金されます	予約フィールドです。
__topic__=yourtopic	課金されません	アップロードするログのトピック。
key1=val1&key2=val2	課金されます	アップロードするキーと値のペア。複数のキーと値のペアを指定できます。値のサイズが16 KB未満であることを確認してください。

HTML imgタグ

Webサイトのフロントエンドページに次のタグを追加します。

重要

track_ua.gifイメージを使用すると、webサーバーはリクエストのカスタムパラメーターだけでなく、リクエストのUserAgentヘッダーとRefererヘッダーもログフィールドとしてアップロードします。
HTTPSページのリクエストのRefererヘッダーを収集するには、次の <img> タグのURLがHTTPSプロトコルを使用していることを確認します。

<img src='http://${project}.${host}/logstores/${logstore}/track.gif?APIVersion=0.6.0&key1=val1&key2=val2'/>
<img src='http://${project}.${host}/logstores/${logstore}/track_ua.gif?APIVersion=0.6.0&key1=val1&key2=val2'/>

ユーザーは、<img> タグを含むWebサイトにアクセスします。
ブラウザは <img> タグを識別し、<img> タグのsrc属性に指定されたURLで参照されている画像をロードしようとします。この場合、ブラウザはHTTP GETリクエストをSimple Log Serviceに送信して画像を読み込みます。
Simple Log Serviceは、URL内のkey1、key2、value1、value2を解析し、キーと値を保存します。 APIVersionは予約フィールドであり、ログには含まれません。
Simple Log Serviceは、見えないイメージをブラウザに返します。

API 操作

PutWebtracking操作を呼び出してログをアップロードします。詳細については、「PutWebtracking」をご参照ください。

webトラッキング機能とSTSを使用してログを収集する

LogstoreのWebTrackingをオンにすると、インターネットからの匿名ユーザーにLogstoreの書き込み権限が付与されます。これにより、正当な認証が行われないため、ダーティデータが発生する。 STSを使用してログを収集する場合、LogstoreのWebTrackingを有効にする必要はありません。 webトラッキングSDK For JavaScriptのSTSプラグインを初期化し、プラグインを使用してログをアップロードする方法の詳細については、「webトラッキングSDK for JavaScriptのSTSプラグインを使用してログをアップロードする」をご参照ください。