Avaliação de campanha

Este documento contém uma visão geral de como avaliar campanhas e origens de tráfego com o SDK v4 do Google Analytics para Android.

Visão geral

Avaliar campanhas no Google Analytics permite a atribuição de campanhas e origens de tráfego às atividades dos usuários no seu aplicativo. Estas opções estão disponíveis para a atribuição de campanhas e origens de tráfego no SDK v4 do Google Analytics para Android:

As seções a seguir descrevem quando e como implementar cada tipo de avaliação de campanhas no seu aplicativo.

Atribuição de campanhas do Google Play

A avaliação de campanhas do Google Play permite que você veja quais campanhas e origens de tráfego estão enviando os usuários para fazer o download do seu aplicativo na Google Play Store. É recomendável que todos os desenvolvedores implementem a avaliação de campanhas da Google Play Store.

Implementação da atribuição de campanhas do Google Play

Quando alguém faz o download do seu aplicativo na Google Play Store, o aplicativo da Google Play Store transmite um INSTALL_REFERRER ao seu aplicativo durante a instalação. Essa intenção contém o valor do parâmetro referrer do link usado para acessar a página do seu aplicativo na Google Play Store, se houver.

Para atribuir um download de aplicativo a uma campanha, você precisa adicionar um parâmetro referrer a todos os links que direcionam para a Google Play Store e um BroadcastReceiver ao seu aplicativo para receber e definir as informações da campanha contidas na intenção do seu rastreador do Google Analytics.

É recomendável que a maioria dos desenvolvedores use o BroadcastReceiver fornecido com o SDK. Para implementar a avaliação de campanhas da Google Play Store por meio do receptor incluído:

1. Adicione o receptor do Google Analytics ao arquivo AndroidManifest.xml. Para adicionar o receptor do Google Analytics ao manifesto, copie e cole a marcação a seguir:

<application>
    <!-- Used for Google Play Store Campaign Measurement-->
    <receiver android:name="com.google.android.gms.analytics.CampaignTrackingReceiver"
        android:enabled="true"
        android:exported="true">
        <intent-filter>
            <action android:name="com.android.vending.INSTALL_REFERRER" />
        </intent-filter>
    </receiver>
    <service android:name="com.google.android.gms.analytics.CampaignTrackingService"
        android:enabled="true"
        android:exported="false" />
</application>

2. Adicione os parâmetros de campanha do Google Analytics aos URLs do Google Play

Em seguida, adicione um parâmetro referrer a todos os URLs que direcionam diretamente para a Google Play Store e defina o valor dele como uma string dos parâmetros de campanha do Google Analytics que descrevem a origem, como neste exemplo:

https://play.google.com/store/apps/details?id=com.example.application
&referrer=utm_source%3Dgoogle
%26utm_medium%3Dcpc
%26utm_term%3Drunning%252Bshoes
%26utm_content%3Dlogolink
%26utm_campaign%3Dspring_sale

Para saber como criar strings de parâmetros de campanha, use o Criador de URL do Google Play ou consulte a seção de referência Parâmetros de campanha.

Testes de atribuição de campanha do Google Play

Para verificar se sua implementação da avaliação de campanhas do Google Play está funcionando como esperado antes de publicar seu aplicativo, use o Guia de soluções para testes da atribuição de campanhas do Google Play.

Atribuição geral de campanhas e origens de tráfego

Depois que um aplicativo é instalado, ele pode ser aberto por referências de campanhas de anúncios, websites ou outros aplicativos. Nesse cenário, origens de tráfego de referência ou campanhas de marketing podem ser atribuídas à atividade do usuário em sessões subsequentes por meio da definição dos parâmetros de campanha em um rastreador de maneira direta usando o método setCampaignParamsFromUrl.

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);

// Set screen name.
t.setScreenName(screenName);

// In this example, campaign information is set using
// a url string with Google Analytics campaign parameters.
// Note: This is for illustrative purposes. In most cases campaign
//       information would come from an incoming Intent.
String campaignData = "http://examplepetstore.com/index.html?" +
    "utm_source=email&utm_medium=email_marketing&utm_campaign=summer" +
    "&utm_content=email_variation_1";

// Campaign data sent with this hit.
t.send(new HitBuilders.ScreenViewBuilder()
    .setCampaignParamsFromUrl(campaignData)
    .build()
);

Consulte Configuração avançada para detalhes sobre o método getTracker.

Parâmetros de campanha

Os parâmetros de campanha são usados para transmitir informações sobre as origens de tráfego e campanhas que estão atraindo usuários para o seu aplicativo.

A tabela abaixo contém os parâmetros de campanha disponíveis que podem ser usados no Google Play ou na avaliação geral de campanhas:

Parâmetro Descrição Exemplos
utm_source Origem da campanha: usado para identificar um mecanismo de pesquisa, boletim informativo ou outra origem. utm_source=google
utm_medium Mídia da campanha: usado para identificar uma mídia, como e-mail ou custo por clique (CPC). utm_medium=cpc
utm_term Termo da campanha: usado com a pesquisa paga para fornecer as palavras-chave para os anúncios. utm_term=running+shoes
utm_content Conteúdo da campanha: usado para testes A/B e anúncios com segmentação por conteúdo para diferenciar anúncios ou links que direcionam ao mesmo URL. utm_content=logolink
utm_content=textlink
utm_campaign Nome da campanha: usado para a análise de palavras-chave com o objetivo de identificar uma campanha estratégica ou a promoção específica de um produto. utm_campaign=spring_sale
gclid Parâmetro de codificação automática do Google Ads: usado para acompanhar anúncios. Esse valor é gerado dinamicamente e nunca deve ser modificado.

Criador de URLs do Google Play

Use a ferramenta abaixo para gerar URLs destinados à avaliação de campanhas do Google Play.