概要
Singular Web SDKを使用すると、ウェブサイト上のユーザーの訪問、コンバージョン、イベントを追跡することができます。Singularが正しく実装されていれば、Singularはウェブサイトのコンバージョンをその訪問を促進したマーケティングキャンペーンに関連付け、ウェブマーケティングのパフォーマンスを完全に可視化します。
情報Web Attributionは企業向け機能です。お客様のアカウントでこの機能を有効にするには、カスタマーサクセスマネージャーにお問い合わせください。
ウェブアトリビューションの仕組み
Singular Web SDKはJavaScriptを使用してブラウザでユーザーを識別し、お客様のウェブサイトでのユーザーの行動を追跡します。ユーザーがお客様のサイトを訪問すると、SDKはそれが初めての訪問なのか、それともウェブキャンペーン後の再訪問セッションなのかを判断します。
主な機能は以下の通りです：
- ページ訪問とユーザーセッションのトラッキング
- コンバージョンイベント（購入、サインアップ、購読）の記録
- お客様のビジネスに特化したカスタムイベントの測定
- コンバージョンをマーケティング・キャンペーンに帰属させる
- モバイルSDKとの組み合わせによるクロスデバイスのアトリビューション（クロスデバイス機能のサブスクリプションが必要です）
始める前に
Web SDKを実装する前に、以下を確認してください：
| 要件 | 説明 |
|---|---|
| SDKキー | お客様のSingular SDKキー。SingularアカウントのDeveloper Tools > SDK Integration > SDK Keysにあります。 |
| ウェブサイトアクセス | お客様のウェブサイトのHTMLに直接またはタグ管理システムを通してJavaScriptコードを追加する許可。 |
| イベントプランニング | 追跡したいイベントの文書化されたリスト（例：購入、カートに追加、サインアップ）。 |
| プライバシーポリシー | クロスサブドメイントラッキング（クッキーを使用）を有効にする場合は、プライバシーポリシーを更新します。 |
統合方法の選択
Singularは2つの統合オプションを提供しています。お客様の技術設定に最も適した方法をお選びください：
ネイティブJavaScriptの実装
最適な方法ウェブサイトのコードに直接アクセスできるチーム、JavaScriptに慣れている開発者、またはサードパーティへの依存を最小限に抑え、最大限のコントロールが必要な場合。
利点
- 一般的な広告ブロッカーにブロックされない
- より速いページ読み込みパフォーマンス
- より信頼性の高いトラッキング
- 実装を直接コントロール
- バナーサポート
デメリット
- ウェブサイトのコード変更が必要
- 更新には開発者の関与が必要
ヒントSingularは、信頼性が高く、広告ブロッカーにブロックされる可能性が低いネイティブJavaScriptの実装をほとんどの使用例に推奨しています。
Google タグマネージャの実装
次のような場合に最適です：すでに Google Tag Manager を使用しているチーム、開発者のサポートを受けずに変更を行う必要があるマーケティングチーム。
メリット
- 直接コードを変更する必要がない
- 技術者以外のチームでも管理が容易
- 変更はGTMのインターフェイスからデプロイ可能
デメリット
- 広告ブロッカーにブロックされることが多い
- GTMが正しく読み込まれるかどうかに依存
- デバッグがさらに複雑になる
- バナーをサポートしない
重要実装する方法は1つだけにしてください。ネイティブJavaScriptとGoogleタグマネージャの両方を同時に使用すると、トラッキングが重複し、指標が膨れ上がります。Singularは自動的にイベントを重複排除しません。
主な概念を理解する
プロダクトID（アプリバンドルID）
プロダクトIDはSingularに対してお客様のウェブサイトを識別します。モバイルアプリのバンドルIDと同様に、逆DNS表記でなければなりません。
形式は以下の通りです：com.website-name
例
- 正しい
com.acme - 正しくない：
acme-store - 正しくない：
www.acme.com
ヒントウェブサイトのすべてのページで同じプロダクトIDを使用してください。同じウェブサイトに関連する複数のサブドメインがある場合: (www.acme.com,shop.acme.com,store.acme.com)、それらのすべてに同じプロダクトIDcom.acme を使用する必要があります。異なるドメインのウェブサイトまたはウェブプロパティ（www.site1.com,www.site2.com,www.site3.com ）は、Singularアカウントでそれぞれ別のプロダクトIDを使用して作成し、別々のアプリとして扱ってください。
セッションとリエンゲージメント
セッションとは何ですか？
Singularのトラッキングにおけるセッションとは、あなたのウェブサイトとユーザーのエンゲージメントの明確な期間を表します。HTTPセッション（ページリクエスト全体でログイン状態などの技術的な状態を維持する）とは異なり、Singularのセッションは分析に特化しており、アトリビューションやエンゲージメントメトリクスのためにユーザーの行動パターンを測定します。
セッションが作成されるタイミング
Singularは以下の場合に自動的に新しいセッションを作成します：
- ユーザーが30分以上アクティブでない場合（デフォルトのセッションタイムアウト）
- ユーザーが新しいキャンペーンパラメータ（異なる広告ソース）で訪問した場合
- ユーザーが異なる参照元ウェブサイトからアクセスした場合
セッションタイムアウトとリエンゲージメント非アクティブウィンドウの比較
2つの異なる時間ベースの設定を理解することが重要です：
セッションタイムアウト（SDKレベル）
- 新しいセッションを開始するタイミングを制御します。
- デフォルト：WebSDKは30分、モバイルSDKは60秒
- SDKの初期化により設定可能
- ユーザーのアクティビティが検出されるたびにリセット
- セッション・ベースのメトリクス（セッション・カウント、セッション時間など）に使用されます。
リエンゲージメント非活動ウィンドウ（プラットフォーム・レベル）
- リエンゲージメント・アトリビューションが適用されるタイミングを制御します。
- デフォルト：7日間
- 設定 > アプリでアプリごとに設定
- リターゲティングキャンペーンのクリックがリエンゲージメントイベントとしてカウントされる前に、ユーザーが非アクティブでなければならない最小時間を決定します。
- 通常のセッション作成には影響しません
シナリオ例
次のようなユーザーを考えてみましょう：
- サイトを訪問し、5分後に離脱した場合
- 45分後にリターゲティング広告経由で再訪問
何が起こりますか？
- 新しいセッションが作成される（30分のセッションタイムアウトを超過）
- リエンゲージメントアトリビューションは発生しない（ユーザーは7日間アクティブではなかった）
- この訪問は、以前のアトリビューションソースと同系列の通常のセッションとして追跡される。
同じユーザーがリターゲティング広告経由で10日間活動しなかった後に戻ってきた場合：
- 新しいセッションが作成されます。
- リエンゲージメントアトリビューションがトリガーされます。
- イベントはリターゲティングキャンペーンへの適切なアトリビューションと共にリエンゲージメントとして記録されます。
設定オプション
セッションタイムアウトのカスタマイズ：
セッション タイムアウトは、SDK の初期化中に調整できます。実装方法に関連するドキュメントのWebSDK初期化オプションを確認してください：ネイティブJavaScriptまたはGoogleタグマネージャ
リエンゲージメント無効ウィンドウのカスタマイズ：
リエンゲージメントアトリビューション用のリエンゲージメント非アクティブウィンドウは、設定 > アプリに移動し、Singularプラットフォームの「詳細設定を表示」オプションを展開することで、アプリごとにカスタマイズできます。典型的なユーザーエンゲージメントパターンとリターゲティングキャンペーン戦略に基づいて調整してください。
インフォメーション非アクティブ期間は必要に応じてカスタマイズできます。詳しくはリエンゲージメントFAQをご覧ください。
イベントコンバージョンとスタンダード
Singularでは2種類のイベントを区別しています：
コンバージョンイベント：コンバージョンイベント：成功を示すビジネスクリティカルなアクション（購入、購読、サインアップ、ダウンロード）。これらはアトリビューションレポートやROI計算に表示されます。
標準イベント：ユーザーの行動を理解するのに役立つサポートアクション（ページビュー、カートに追加、ビデオ再生）。これらはローデータレポートに表示され、ユーザージャーニーの分析に役立ちます。
ヒントSingularのアカウント設定で、どのイベントを「コンバージョンイベント」に分類するかを設定します。これにより、正しいレポートに表示されるようになります。
プライバシーとクッキーの使用
デフォルトでは、Singularはクッキーを使用しません。しかし、クロスサブドメイン識別子パーシステンスを有効にすると、Singularはファーストパーティークッキーを設定し、サブドメイン間のユーザー識別を維持します。
クッキーの詳細（有効な場合）：
| プロパティ | 値 |
|---|---|
| クッキー名 | singular_device_id |
| 目的 | ユーザーに一意のIDを割り当て、個人情報を収集することなく、セッション間のアクティビティとインタラクションを追跡します。 |
| 有効期間 | 1年間 |
| 種類 | ファーストパーティクッキー（お客様のドメインに設定されます） |
| プライバシーポリシー | https://www.singular.net/privacy-policy/ |
重要クロスサブドメイントラッキングを有効にする場合は、ウェブサイトのプライバシーポリシーを更新し、singular_device_id クッキーの使用を開示してください。
次のステップ
- 統合方法（ネイティブJavaScriptまたはGoogleタグマネージャ）を選択します。
- 選択した方法のステップバイステップの実装ガイドに従ってください。
- 提供されている検証手順を使用して実装をテストします。
- トラブルシューティングガイドでベストプラクティスを確認する。