---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# API SNMobileAnalytics

# API SNMobileAnalytics {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

A API SNMobileAnalytics fornece métodos que você pode chamar em um WebView usando JavaScript. Esses métodos permitem que você envie dados de análise personalizados (eventos, páginas e propriedades do usuário) para o painel Análise da experiência do usuário para Portal de serviços.
Para usar esses métodos em seu aplicativo para celular, você deve primeiro chamar o método installJavascriptInterface(), que expõe esses métodos JavaScript ao WebView associado.

Consulte [NowAnalyticsService - installJavascriptInterface (no webView: WKWebView)](https://servicenow-prod.fluidtopics.net/XIZ7Agmebld5oJZtx4gr3g#NAnalyServiOS-installJSInterface_O "Habilita a chamada dos métodos na API SNAnalytics() de dentro de um WebView usando JavaScript.") para a implementação do iOS.

Consulte [NowAnalyticsSDK - installJavascriptInterface(webView: WebView)](https://servicenow-prod.fluidtopics.net/o0V5Y1XTSOmTPEbIp_~spA#NAnaly-installJSInterface_O "Habilita a chamada de métodos javaScript.SNMobileAnalytics de dentro de um {@link Android.WebKit.WebView}, usando JavaScript.") para a implementação do Android.

## SNMobileAnalytics - addEvent(cadeia de caracteres eventName, propriedades do objeto) {#ariaid-title2}

Adiciona um novo evento \[ acionado pela web com suas propriedades associadas à linha do tempo da sessão móvel atual.
{#MobAn-addEvent_S_O__table_mqk_vgf_mqb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| eventName | Cadeia de caracteres | Nome do evento epara add. |
| propriedades | Objeto | Opcional. Lista de pares de chave-valor de propriedade personalizados para o evento. Tipos de valor compatíveis: * Booliano * Data * Número * Cadeia de caracteres {#MobAn-addEvent_S_O__ul_g41_kxy_spb} Nota: O tamanho total de eventName, chave de propriedades e valor não deve exceder 300 bytes (por evento). |
[Tabela 1. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Nenhum |   |
[Tabela 2. Retorna]

{#MobAn-addEvent_S_O__table_nqk_vgf_mqb}  
<br />

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

## SNMobileAnalytics - addScreenAction(cadeia de caracteres actionName) {#ariaid-title3}

Adiciona um novo marcador de ação de IU à linha do tempo da sessão móvel atual.
{#MobAn-addScreenAction_S__table_iyv_ckf_mqb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| actionName | Cadeia de caracteres | Nome da ação da web acionada. |
[Tabela 3. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Nenhum |   |
[Tabela 4. Retorna]

{#MobAn-addScreenAction_S__table_xdr_53f_mqb}  
<br />

    SNMobileAnalytics.addScreenAction('Custom UI Action')

## SNMobileAnalytics - setUserId(cadeia de caracteres userId) {#ariaid-title4}

Define o ID do usuário ativo atual para a sessão móvel atual.
{#MobAn-setUserId_O__table_hym_ndf_mqb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| userID | Cadeia de caracteres | ID a ser definido para ousuário atual. |
[Tabela 5. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Nenhum |   |
[Tabela 6. Retorna]

{#MobAn-setUserId_O__table_iym_ndf_mqb}  
<br />

    SNMobileAnalytics.setUserId('user123') 

## SNMobileAnalytics - startScreen(cadeia de caracteres screenName) {#ariaid-title5}

Adiciona uma nova página acionada pela web à linha do tempo da sessão móvel atual.
{#MobAn-startScreen_S__table_wdr_53f_mqb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| screenName | Cadeia de caracteres | Nome da tela para registrar a hora de início, como <kbd class="ph userinput">TelaDeBoas</kbd>-vindas . |
[Tabela 7. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Nenhum |   |
[Tabela 8. Retorna]

{#MobAn-startScreen_S__table_xdr_53f_mqb}  
<br />

    SNMobileAnalytics.startScreen('My Web Page')