Visão geral

Este artigo explica como a UserGuiding se integra ao Google Analytics, um serviço de análise da Web oferecido pelo Google que rastreia e relata o tráfego e os eventos do site.

Quando ativada, a UserGuiding pode ser usada como uma Fonte que envia dados de eventos relacionados ao conteúdo da UserGuiding para sua conta do Google Analytics.

Observação importante: para iniciar essa integração com êxito, você deve ter instalado o Google Analytics em seu aplicativo web. Caso contrário, essa integração não será realizada.

Como habilitar a integração com o Google Analytics

É possível ativar essa integração usando o botão de alternância na aba Integrations, na seção Settings.

Quando você ativar a alternância, essa integração será ativada para as páginas em que o código do container da UserGuiding e o código de rastreamento do Google Analytics estiverem presentes ao mesmo tempo.

Requisitos específicos do método de instalação

Para saber mais sobre os métodos de instalação do Google Analytics, acesse a documentação do Google.

gtag.js

Se você instalou o Google Analytics em seu aplicativo web usando o método gtag.js, não são necessárias etapas adicionais.

Gerenciador de tags do Google

Se você tiver instalado o Google Analytics usando o Google Tag Manager, deverá concluir as etapas a seguir antes de ativar a integração.

1- Criar variáveis de camada de dados

Você precisa criar 11 novas variáveis de camada de dados com os seguintes nomes:

userguiding_material_id
userguiding_material_name
userguiding_material_type
userguiding_interacted_item_id
userguiding_interacted_item_name
userguiding_survey_id
userguiding_survey_name
userguiding_question_id
userguiding_question_type
userguiding_survey_score
userguiding_survey_answer

Cada variável deve se parecer com o seguinte:
​

2- Criar uma tag para eventos de material

3- Adicionar gatilho à tag de eventos de material

• Tipo de acionador: Custom Event
• Nome do evento: userguiding_(?!survey)\w+\b
• Usar correspondência de regex

4- Criar uma tag para eventos de pesquisa

Adicione uma nova tag de evento do GA4 com as configurações abaixo:

5- Adicionar gatilho à tag de eventos de pesquisa

• Tipo de acionador: Custom Event
• Nome do evento: userguiding_survey.+
• Usar correspondência de regex

Publicar alterações em seu espaço de trabalho GTM

Desde que a integração UserGuiding > Google Analytics esteja ativada, todos os eventos da UserGuiding enviados para o GTM agora também devem ser encaminhados para a sua conta do Google Analytics.

Rastreamento de eventos

Quando ativada, a UserGuiding enviará dados de eventos relacionados ao conteúdo para sua conta do Google Analytics.
​
​Para visualizar os eventos:
Vá até o Painel do Google Analytics > Realtime > Events.

Ou vá até Behavior > Events > Top events

Você deve ver os eventos mais recentes da UserGuiding nessa seção.

Formato do Evento

<EVENT_NAME>
<EVENT_PROPERTIES>

Example do Evento

userguiding_banner_button_click

userguiding_material_id: 36
userguiding_material_name: Banner Name
userguiding_material_type: banner
userguiding_interacted_item_id: 0910f959-f611-4f42-9337-3964d7f9e005
userguiding_interacted_item_name: Explore Now

Abaixo, você encontra a lista dos eventos enviados ao Google Analytics pelo UserGuiding.

userguiding_guide_started

userguiding_guide_completed

userguiding_guide_button_clicked

userguiding_hotspot_interacted

userguiding_hotspot_button_clicked

userguiding_banner_button_clicked

userguiding_checklist_completed

userguiding_checklist_item_trigger

userguiding_checklist_item_url_click

userguiding_rc_guide_trigger

userguiding_rc_survey_trigger

userguiding_rc_checklist_guide_trigger

userguiding_rc_checklist_item_url_click

userguiding_rc_external_url_click

userguiding_rc_article_link_click

userguiding_survey_shown

userguiding_survey_answer

userguiding_booster_slide_out_view

userguiding_booster_tooltip_view

userguiding_product_updates_post_view

userguiding_product_updates_page_view

userguiding_product_updates_feedback

userguiding_ai_assistant_booster_tooltip_view

userguiding_ai_assistant_widget_view

userguiding_ai_assistant_conversation_started

userguiding_ai_assistant_message_sent

userguiding_ai_assistant_message_received

userguiding_ai_assistant_fallback_message_received

userguiding_ai_assistant_fallback_action_clicked

userguiding_ai_assistant_article_clicked

userguiding_ai_assistant_guide_trigger