Ajustes do Script
  • 2 Minutes to read
  • Dark
    Light
  • PDF

Ajustes do Script

  • Dark
    Light
  • PDF

Article summary

Ao instalar o script você deve preencher algumas variáveis, que permitem identificar seu cliente e também incluir Dimensões opcionais.
Esse artigo ajuda a entender como o script funciona e o que precisa ser configurado

Importante

Este é um artigo técnico, voltado a auxiliar sua equipe de TI na instalação do Widget

O script que você irá receber se assemelha ao código abaixo:

    <script type="text/javascript">
      window.yvnps = window.yvnps || []
      window.yvnps.push({ account: 'aaaaaaa-bbbbb-cccc-dddd-fffff' })

      //Campos de identificação do usuário (obrigatório)
      window.yvnps.push({ name: 'NOME DO CONSUMIDOR' })
      window.yvnps.push({ email: 'EMAIL@EMAIL.COM' })
      window.yvnps.push({ userid: 'ID DO USUÁRIO' })

      //Campos de Dimensão (opcional)
      window.yvnps.push({ dimension_Departamento: 'Marketing' })
      window.yvnps.push({ dimension_Empresa: 'Marketing Co.' })

      ;(function () {
        var yvn = document.createElement('script')

        yvn.type = 'text/javascript'
        yvn.async = true
        yvn.id = '_yvnps'
        yvn.src = 'https://yvnps.s3.amazonaws.com/public/scripts/v2/yvapi.js'
        var yvn_script = document.getElementsByTagName('script')[0]
        yvn_script.parentNode.insertBefore(yvn, yvn_script)
      })()
    </script>

Identificação do usuário

Identificar um consumidor/cliente/usuário permite que você saiba quem deu a resposta de NPS.
No script acima, repare no trecho "Campos de identificação do usuário". Nesse trecho, temos três possibilidades de identificação do usuário:

  • Nome (name)
  • E-mail (email)
  • Identificador (id)
    Você deve informar o Nome e E-mail ou Nome e Identificador. Esses valores deverão ser fornecidos pelo seu site ou sistema, direto no código JS.

Sendo assim, para informar Nome e E-mail por exemplo, o trecho de código seria dessa forma:

  window.yvnps.push({ name: 'NOME DO CONSUMIDOR' })
  window.yvnps.push({ email: 'EMAIL@EMAIL.COM' })

Lembre-se de alterar os valores "NOME DO CONSUMIDOR" e "EMAIL@EMAIL.COM.BR"

Usuários anônimos (áreas não logadas)

Mesmo que você não possua identificadores do seus usuários por eles não estarem em uma área logada do site, por exemplo, ainda assim é necessário informar nome e id.
Para o nome você pode estabelecer um padrão - chamar de "anônimo" por exemplo.
Para o Id você precisa informar alguma identificador de sessão para aquele usuário.

Lembre-se que utilizamos o "id" do usuário para identificar que ele já respondeu uma pesquisa e, portanto, não precisamos exibir novamente o widget.

Importante

Se você utilizar apenas um número aleatório para o ID, sem associar a uma sessão, sempre que seus usuários navegarem pelo seu site o widget será exibido, mesmo que ele já tenha respondido à pesquisa.

Incluindo Dimensões

As Dimensões ajudam a entender mais sobre o perfil do usuário que deixou a nota. Assim, você pode agrupar as respostas nos relatórios do sistema.
A definição de quais dimensões deverão ser incluídas deverá ser discutida entre o time de Negócios e o time de Tecnologia da sua equipe. Assim, o time de Negócios poderá definir quais são as Dimensões relevantes para as análises das respostas e o time de Tecnologia pode avaliar tecnicamente a possibilidade de incluí-las no script.

A inclusão de Dimensões é opcional.

No script acima, há exemplo para incluir duas dimensões:

      window.yvnps.push({ dimension_Departamento: 'Marketing' })
      window.yvnps.push({ dimension_Empresa: 'Marketing Co.' })

No exemplo acima, há uma Dimensão de nome "Departamento" com valor "Marketing" e outra de nome "Empresa" com valor "Marketing Co.".
Os nomes das Dimensões devem ser os mesmos utilizados no painel administrativo. Se elas ainda não existirem, serão criadas automaticamente.
Note, ainda, que as dimensões são sempre prefixadas por "dimension_".
Os valores deverão ser substituídos por valores fornecidos pelo seu site/sistema.


Was this article helpful?

What's Next