Como integrar com o Google Analytics

O Google Analytics Platform permite mensurar as interações dos usuários com seus negócios em vários dispositivos e ambientes. O Google Analytics fornece os recursos necessários para coletar, armazenar, processar e gerar relatórios dessas interações do usuário.

Você pode coletar dados de análises tanto do lado do cliente quanto do servidor.

Coleta de dados de análise do lado do cliente

Use as APIs e os SDKs do Google Analytics para mensurar como os usuários interagem com seu conteúdo e iniciativas de marketing. Você pode ver os dados das interações de usuários na interface do Google Analytics ou usar APIs de relatórios para buscar esses dados. Para mais detalhes sobre a coleta de dados de análise do lado do cliente, selecione o link abaixo, de acordo com o tipo de cliente:

  • Web Tracking (analytics.js) - Meça a interação do usuário com sites ou aplicativos da Web.
  • Android - Meça a interação do usuário com aplicativos para Android.
  • iOS - Meça a interação do usuário com aplicativos para iOS.
  • Protocolo de avaliação - Meça a interação do usuário em qualquer ambiente com este protocolo de nível inferior.

Coleta de dados de análise do lado do servidor

O App Engine fornece um mecanismo para gerar registros de eventos no aplicativo. No entanto, você pode usar o Google Analytics para acompanhar eventos específicos do lado do servidor para diversos fins:

  • Analisar dados históricos - O App Engine permite configurar o tamanho ou número máximo de dias dos arquivos de registros. Depois que esse limite é ultrapassado, você perde o acesso a esses arquivos de registros. Acompanhar eventos no Google Analytics permite visualizar eventos passados por muito mais tempo.
  • Acompanhar eventos-chave - Os arquivos de registros podem ser muito complexos, incluindo e registrando dados de vários componentes de um aplicativo. Ao usar o acompanhamento de eventos, você pode identificar eventos-chave e rastreá-los, juntamente com alguns metadados.
  • Trabalhar na interface do usuário - Aproveite a sofisticada interface do usuário oferecida pelo Google Analytics para ver, gerar relatórios e exportar esses eventos do lado do servidor.

Para ativar a coleta de dados de análise do lado do servidor, você pode usar um cliente HTTP e fazer solicitações desse tipo usando o Protocolo de avaliação do Google Analytics. Para saber mais, consulte o tópico Acompanhamento de eventos do guia de desenvolvedores do Google Analytics.

Aplicativo de amostra

No aplicativo de amostra abaixo, veja como rastrear eventos no aplicativo do App Engine. É feita uma solicitação HTTP, e os dados sobre o evento são postados no Google Analytics.

Antes de usar o Protocolo de avaliação do Google Analytics no App Engine:

  • Antes de executar o app de amostra localmente, defina as variáveis do ambiente exigidas por ele:

    export GA_TRACKING_ID=YOUR_TRACKING_ID
    

  • Você pode executar o código de amostra localmente usando a linha de comando. Por exemplo:

    python main.py
    

  • Você pode integrar o código a seguir no seu aplicativo do App Engine para publicar dados do acompanhamento de eventos no Google Analytics:

    import logging
    import os
    
    from flask import Flask
    import requests
    
    app = Flask(__name__)
    
    # Environment variables are defined in app.yaml.
    GA_TRACKING_ID = os.environ['GA_TRACKING_ID']
    
    def track_event(category, action, label=None, value=0):
        data = {
            'v': '1',  # API Version.
            'tid': GA_TRACKING_ID,  # Tracking ID / Property ID.
            # Anonymous Client Identifier. Ideally, this should be a UUID that
            # is associated with particular user, device, or browser instance.
            'cid': '555',
            't': 'event',  # Event hit type.
            'ec': category,  # Event category.
            'ea': action,  # Event action.
            'el': label,  # Event label.
            'ev': value,  # Event value, must be an integer
        }
    
        response = requests.post(
            'http://www.google-analytics.com/collect', data=data)
    
        # If the request fails, this will raise a RequestException. Depending
        # on your application's needs, this may be a non-error and can be caught
        # by the caller.
        response.raise_for_status()
    
    @app.route('/')
    def track_example():
        track_event(
            category='Example',
            action='test action')
        return 'Event tracked.'
    
    @app.errorhandler(500)
    def server_error(e):
        logging.exception('An error occurred during a request.')
        return """
        An internal error occurred: <pre>{}</pre>
        See logs for full stacktrace.
        """.format(e), 500
    
    if __name__ == '__main__':
        # This is used when running locally. Gunicorn is used to run the
        # application on Google App Engine. See entrypoint in app.yaml.
        app.run(host='127.0.0.1', port=8080, debug=True)

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentos do ambiente flexível do App Engine para Python