---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# SNMobileAnalytics API

# SNMobileAnalytics API {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 2분

SNMobileAnalytics API는 JavaScript를 사용하여 WebView 내에서 호출할 수 있는 메서드를 제공합니다. 이러한 방법을 사용하면 사용자 지정 분석 데이터(이벤트, 페이지 및 사용자 속성)를 서비스 포털용 사용량 인사이트 대시보드로 푸시할 수 있습니다.
모바일 애플리케이션 내에서 이러한 메서드를 사용하려면 먼저 이러한 JavaScript 메서드를 연결된 WebView에 노출하는 installJavascriptInterface() 메서드를 호출해야 합니다.

iOS 구현은 를 [NowAnalyticsService - installJavascriptInterface(webView로: WKWebView)](https://servicenow-prod.fluidtopics.net/2ZoiWsEOX6sCy8OfReUpaw#NAnalyServiOS-installJSInterface_O "JavaScript를 사용하여 WebView 내에서 SNAnalytics() API의 메서드 호출을 사용하도록 설정합니다.") 참조하십시오.

Android 구현은 을 [NowAnalyticsSDK - installJavascriptInterface(webView: WebView)](https://servicenow-prod.fluidtopics.net/inkqGtDYPLqSJxkVsfSmFg#NAnaly-installJSInterface_O "JavaScript를 사용하여 {@link android.webkit.WebView} 내에서 javaScript.SNMobileAnalytics 메서드를 호출할 수 있도록 합니다.") 참조하십시오.

## SNMobileAnalytics - addEvent(문자열, eventName, 객체 속성) {#ariaid-title2}

연결된 속성과 함께 새 웹 트리거 이벤트를 현재 모바일 세션 타임라인에 추가합니다.
{#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 | 문자열 | 트리거된 웹 작업의 이름입니다. |
[표 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}

현재 모바일 세션 타임라인에 새 웹 트리거 페이지를 추가합니다.
{#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')