---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# SNMobileAnalytics API

# SNMobileAnalytics API {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：2分

SNMobileAnalytics API は、JavaScript を使用して WebView 内で呼び出すことができるメソッドを提供します。これらのメソッドを使用すると、カスタムアナリティクスデータ (イベント、ページ、およびユーザープロパティ) をサービスポータルのユーザーエクスペリエンスアナリティクスダッシュボードにプッシュできます。
モバイルアプリケーション内でこれらのメソッドを使用するには、まず installJavascriptInterface() メソッドを呼び出す必要があります。これにより、これらの JavaScript メソッドが関連する WebView に公開されます。

iOS の実装については、「 [NowAnalyticsService - installJavascriptInterface(webView へ:WKWebView)](https://servicenow-prod.fluidtopics.net/xVzDFm1ys7wvAQekScLCng#NAnalyServiOS-installJSInterface_O "JavaScript を使用して WebView 内から SNAnalytics() API のメソッドを呼び出せるようにします。") 」を参照してください。

Android の実装については、「 [NowAnalyticsSDK - installJavascriptInterface(webView: WebView)](https://servicenow-prod.fluidtopics.net/Zl8z1fQt_obG8hCyZzpcWA#NAnaly-installJSInterface_O "JavaScript を使用して、{@link android.webkit.WebView} 内から javaScript.SNMobileAnalytics メソッドを呼び出せるようにします。") 」を参照してください。

## SNMobileAnalytics - addEvent(文字列 eventName, オブジェクトプロパティ) {#ariaid-title2}

新しい Web トリガー イベントとそれに関連するプロパティを 現在のモバイルセッションタイムラインに追加します。
{#MobAn-addEvent_S_O__table_mqk_vgf_mqb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| eventName | 文字列 | 広告イベントの名前d。 |
| プロパティ | オブジェクト | オプション。イベントのカスタム プロパティのキーと値のペアのリスト。 サポートされている値の型: * ブール * 日付 * 番号 * 文字列 {#MobAn-addEvent_S_O__ul_g41_kxy_spb} 注: eventName、プロパティキー、および値の合計サイズは、(イベントあたり) 300 バイトを超えてはなりません。 |
[表 : 1. パラメーター]

{#MobAn-addEvent_S_O__table_mqk_vgf_mqb} {#MobAn-addEvent_S_O__table_nqk_vgf_mqb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 2. 返される内容]

{#MobAn-addEvent_S_O__table_nqk_vgf_mqb}  
<br />

    SNMobileAnalytics.addEvent('MyEvent', JSON.stringify({'Type': 'Show', 'Amount': 16}))

## SNMobileAnalytics - addScreenAction(文字列 actionName) {#ariaid-title3}

現在のモバイルセッションのタイムラインに新しい 画面 UI アクションタグ を追加します。
{#MobAn-addScreenAction_S__table_iyv_ckf_mqb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| actionName | 文字列 | トリガーされた Web アクションの名前。 |
[表 : 3. パラメーター]

{#MobAn-addScreenAction_S__table_iyv_ckf_mqb} {#MobAn-addScreenAction_S__table_xdr_53f_mqb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 4. 返される内容]

{#MobAn-addScreenAction_S__table_xdr_53f_mqb}  
<br />

    SNMobileAnalytics.addScreenAction('Custom UI Action')

## SNMobileAnalytics - setUserId(文字列 userId) {#ariaid-title4}

現在のモバイルセッションの現在アクティブなユーザーの ID を設定します。
{#MobAn-setUserId_O__table_hym_ndf_mqb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| userID | 文字列 | 現在のユーザーに設定するID。 |
[表 : 5. パラメーター]

{#MobAn-setUserId_O__table_hym_ndf_mqb} {#MobAn-setUserId_O__table_iym_ndf_mqb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 6. 返される内容]

{#MobAn-setUserId_O__table_iym_ndf_mqb}  
<br />

    SNMobileAnalytics.setUserId('user123') 

## SNMobileAnalytics - startScreen(文字列 screenName) {#ariaid-title5}

新しい Web トリガーページを現在のモバイルセッションのタイムラインに追加します。
{#MobAn-startScreen_S__table_wdr_53f_mqb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| screenName | 文字列 | 開始時間をログに記録する画面の名前 ( <kbd class="ph userinput">WelcomeScreen</kbd> など)。 |
[表 : 7. パラメーター]

{#MobAn-startScreen_S__table_wdr_53f_mqb} {#MobAn-startScreen_S__table_xdr_53f_mqb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 8. 返される内容]

{#MobAn-startScreen_S__table_xdr_53f_mqb}  
<br />

    SNMobileAnalytics.startScreen('My Web Page')