はじめに

Singular Website SDKを使用すると、ウェブサイトのアクティビティをマーケティングタッチポイントに帰属させ、ウェブサイト内のユーザーイベントを追跡することができます。また、Singularのクロスデバイスアトリビューションソリューションの重要なコンポーネントでもあり、ユーザージャーニーを分析し、クロスプラットフォームのLTVとROASを計算することができます。便利なように、Singular Website SDKはGoogle Tag Managerと統合されています。

前提条件

Singular Website SDKを統合する前に、以下を確認してください：

• お客様のサイトでGoogleTag Managerが設定されていること。
• Singularに送信したいイベント（コンバージョンイベントとカスタムイベント）に対して、必要に応じてGoogle Tag Managerのトリガーを設定している。Google ドキュメントの トリガーについてを参照してください。
• Singularに送信したいイベントに対して、必要に応じてGoogleタグマネージャーの変数を設定します。例えば、トランザクションイベントを送信し、トランザクションの収益を含める場合は、トランザクションの合計と通貨の変数を設定する必要があります。Google ドキュメントの 変数についてを参照ください。

Singular SDKの統合

SDKの初期化

ウェブサイトにSingular Web SDKを使用するには、Singular初期化タグを追加する必要があります。このイベントはウェブサイトがロードされるとすぐにトリガーされるように設定することをお勧めします（例：ページビュー時）。

Singular初期化タグを追加するには

1. Googleタグマネージャのアカウントで、「タグ」>「新規」をクリックします。
2. タグ設定ウィンドウでタグ設定をクリックし、タグの種類メニューで「Singular Web Tracking」を選択します。
3. トラックタイプで「初期化」を選択します。
4. その他の必要なパラメータを入力します：
   • SDKキーとSDKシークレット：Singularアカウントにログインし、"Developer Tools > SDK Integration > SDK Keys "から取得できます。
   • 製品ID：お客様のウェブサイトの名前です。例えば、"com.example "のように、メインウェブドメインの逆DNS表記を使用することをお勧めします。 これはSingularプラットフォーム全体でお客様のウェブサイトを識別するために使用されます。この値は、SingularプラットフォームのアプリページのApp bundleIDとも一致する必要があります。
   • オプションです：
     
     • ログレベル： コンソールへのSDKデバッグロギングの設定です。デフォルトはnoneです。
     • セッションタイムアウト：SDKが新しいセッションを作成するまでの、ユーザーの非アクティブ時間。Singularは、ユーザーのリテンションを計算し、再エンゲージメントのアトリビューションを有効にするために、ユーザーセッションを送信します。デフォルト値は30分です。
     • クロスサブドメイントラッキング
5. トリガーをクリックし、トリガー "Page View "を追加します。
6. 保存をクリックする。

オプション：ユーザーIDの設定

ユーザーがログインせずにウェブサイト上でアクションを実行する限り、イベントはSingularが生成したユーザーIDでSingularに送信されます。しかし、ユーザーが登録またはログインした後は、あなたのウェブサイトで使用されているユーザーID（メールアドレスなど）と共にイベントをSingularに送信させることができます。

Singularは、ユーザーレベルのデータエクスポート（属性ログのエクスポートを参照）および内部BIポストバックを設定している場合（内部BIポストバックの設定を参照）、ユーザーIDを使用します。

ユーザー ID を Singular に送信するには、2 つの方法があります：

• 推奨： 推奨：ウェブサイトを開いたときのユーザーIDがわかっている場合は、SDKを初期化するときに初期化トラックタイプにユーザーIDを設定します。これにより、最初のページ訪問からSingularがユーザーIDを利用できるようになります。
• あるいは、実行中のどの時点でもLoginメソッドを呼び出すことができます。ユーザーIDが利用可能になったらすぐに呼び出すことをお勧めします。

ユーザーIDをSingularと共有するには、"Login "トラックタイプのSingularタグを追加します：

1. Googleタグマネージャーアカウントで、タグ > 新規をクリックします。
2. タグ設定ウィンドウで、タグ設定をクリックし、タグタイプメニューで「Singular Web Tracking」を選択します。
3. トラックタイプで「ログイン」を選択します。
4. カスタムユーザーID]の下に、ユーザーIDを含むGoogleタグマネージャ変数を入力します。
5. トリガーをクリックし、トリガーイベントを追加します。
6. 保存をクリックします。

ユーザーIDの設定を解除するには、「ログアウト」トラックタイプのタグを追加します：

1. Googleタグマネージャーアカウントで、タグ > 新規をクリックします。
2. タグ設定]ウィンドウで、[タグ設定]をクリックし、[タグタイプ]メニューで、[Singular Web Tracking]を選択します。
3. トラックタイプで「ログアウト」を選択します。
4. トリガー」をクリックし、トリガーイベント「ユーザーログアウト」を追加します。
5. 保存］をクリックします。

オプションイベントと収益のトラッキング

イベントのトラッキング（非収益）

Singularはサイト内のユーザーイベントに関するデータを収集し、キャンペーンのパフォーマンス分析やKPIの測定に役立てることができます。例えば、ユーザーのログイン、登録、チュートリアルの完了に関するデータを収集したい場合があります。

イベントをSingularに送信するにはイベントメソッドを使用します。

カスタムイベントをトラッキングするには

1. Googleタグマネージャのアカウントで、タグ > 新規をクリックします。
2. タグ設定]ウィンドウで[タグ設定]をクリックし、[タグタイプ]メニューで[Singular Web Tracking]を選択します。
3. トラックタイプ]で[カスタムイベント]を選択します。
4. イベント名]で、イベントの名前を入力するか、以前に定義したGoogleタグマネージャの変数を入力します。
5. トリガーをクリックし、トリガーイベントを追加します。
6. 保存をクリックします。

収益のトラッキング

Singularはウェブサイトを通じて得た収益に関するデータを収集し、キャンペーンのパフォーマンスとROIの分析に役立てることができます。Singularはレポート、ログエクスポート、ポストバックでデータを利用できるようにします。

イベントのレポートには収益メソッドを使用します。収益ではカスタムイベント名を渡すことができ、Singularレポートで収益を収益イベントの種類別に分けて表示することができます。

収益イベントを追跡するには

1. Googleタグマネージャーアカウントで、タグ > 新規をクリックします。
2. タグ設定ウィンドウでタグ設定をクリックし、タグの種類メニューで「Singular Webトラッキング」を選択します。
3. トラックタイプ]で[収益イベント]を選択します。
4. イベント名]で、イベントの名前を入力するか、以前に定義したGoogleタグマネージャの変数を入力します。
5. Currency（通貨）］には、"USD"、"EUR"、"INR "などの3文字のISO 4217通貨コードを表す変数を入力します。
6. Revenue（収益）」の下に、トランザクションの金額を含む変数を入力します（1.99など、10進数で渡すことができます）。
7. Triggeringをクリックし、トリガーイベントを追加します。
8. Save をクリックする。

オプション：クロスサブドメイントラッキング

デフォルトでは、SingularウェブサイトSDKはSingularデバイスIDを生成し、ブラウザストレージを使用して永続化します。このストレージはサブドメイン間で共有できないため、SDKはサブドメインごとに新しいIDを生成することになります。

サブドメイン間でSingular Device IDを永続化したい場合は、以下のいずれかの方法をご利用ください：

方法A：クッキーを使った自動永続化

Singular SDKにカスタムファーストパーティークッキーを使用してSingularデバイスIDを永続化させることができます。以下のオプションを選択し、追跡したいメインドメインを設定します。

方法B（詳細）：GTM変数にSingularデバイスIDを読み込む

Singular SDKにデバイスIDを自動的に保持させたくない場合は、例えばトップレベルドメインCookieやサーバーサイドCookieを使用して、ドメイン間でIDを手動で保持することができます。この値は有効なuuid4フォーマットでSingularが以前に生成したIDでなければなりません。

カスタムユーザーIDデバイスマッピング

Singularはサーバー間の統合によって追加のウェブトラッキングデータを受け取ることができます。この機能を利用するには、カスタムユーザーIDをSingularのウェブトラッキング識別子にマッピングする必要があります。

カスタムユーザーIDをSingularのウェブトラッキング識別子にマッピングします：

1. Google Tag Managerアカウントで、 タグ > 新規を クリック します。
2. タグ設定 ウィンドウで タグ設定を クリック し、 タグの種類 メニューで「Singularウェブトラッキング」を選択します。
3. トラックタイプ]で [デバイスのカスタムユーザーIDを設定]を選択します。
4. カスタムユーザーIDの 下に 、ユーザーIDを含むGoogleタグマネージャ変数を入力します。
5. Triggeringを クリック し、トリガーイベントを追加します。
6. 保存をクリックします。