Nesta página, descrevemos como usar a gtag.js para medir interações com páginas nos sites que carregam o conteúdo dinamicamente (sem o carregamento tradicional de página inteira).
Visão geral
O aplicativo de página única (SPA) é um app da Web ou site que carrega todos os recursos necessários para navegar pelo conteúdo no primeiro carregamento. À medida que o usuário clica em links e interage com a página, o restante do conteúdo é carregado dinamicamente. O app atualiza o URL na barra de endereço para simular a navegação tradicional. No entanto, não é necessário fazer outra solicitação de página inteira.
A tag do Google funciona bem com sites tradicionais porque o código do snippet é executado sempre que os usuários carregam uma nova página. No entanto, para um aplicativo de página única em que o site atualiza o novo conteúdo dinamicamente em vez de carregamentos de página inteira, o código do snippet da gtag.js é executado apenas uma vez. Isso significa que as próximas exibições de página (virtuais) precisam ser medidas manualmente à medida que o novo conteúdo é carregado.
Medir as exibições virtuais de página
Quando seu aplicativo carregar o conteúdo dinamicamente e atualizar o URL na barra de endereço, o URL da página armazenado pela gtag.js também precisará ser atualizado. Você também pode incluir as alterações de endereço no seu site na medição de visualizações de página.
Se quiser definir os caminhos da gtag.js, use o comando set e especifique um valor para o parâmetro page_path:
gtag('set', 'page_path', page_path);
gtag('event', 'page_view');
Exemplo:
gtag('set', 'page_path', '/new-page.html');
gtag('event', 'page_view');
Depois que você adicionar o novo valor de page_path, ele será usado em todos os próximos eventos enviados para essa propriedade.
Gerenciamento de vários URLs para o mesmo recurso
Alguns SPAs atualizam somente o hash do URL quando eles carregam conteúdo dinamicamente. Isso pode criar situações em que muitos caminhos de página diferentes levam ao mesmo recurso. Nesses casos, normalmente é melhor escolher um URL canônico e enviar somente o valor page_path para o Google Analytics.
Por exemplo, considere um site cuja página "Sobre" pode ser acessada com um dos URLs a seguir:
/about/#/about/home/#/about
Para evitar duplicação nos relatórios, é melhor gravar todas essas páginas usando /about para o page_path.