Inclusão de tags no servidor para apps para dispositivos móveis

É possível configurar seus apps para dispositivos móveis usando o SDK do Google Analytics para Firebase para trabalhar com a inclusão de tags do lado do servidor no Gerenciador de tags do Google.

Com a inclusão de tags do lado do servidor, você pode organizar, editar e aumentar seus dados antes de enviá-los para produtos de destino, como o Google Analytics. Saiba mais sobre a inclusão de tags no servidor.

Para configurar a inclusão de tags no servidor para apps para dispositivos móveis:

1. Preparar seu app para a inclusão de tags no servidor
2. Configurar o contêiner do servidor para oferecer suporte ao tráfego de dispositivos móveis
3. Ativar a inclusão de tags no servidor na sua propriedade do GA4

Pré-requisitos

• É necessário incluir o SDK do Google Analytics para Firebase no app e conectá-lo à sua propriedade do Google Analytics 4. Saiba mais sobre o SDK do Google Analytics para Firebase.
• Você precisa de uma conta do Gerenciador de tags do Google e um contêiner de servidor. Se você não tiver uma, crie uma conta e um contêiner do Gerenciador de tags.
• Você precisa configurar um servidor de tags.

Etapa 1: preparar o app para a inclusão de tags no servidor

iOS

1. Ative o recurso de upload da inclusão de tags no servidor e configure o esquema de URL personalizado para o modo de depuração da inclusão de tags no servidor no arquivo Info.plist. Substitua o BUNDLE_ID no seguinte pelo identificador do pacote do app.

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
   ...
           <key>CFBundleURLTypes</key>
           <array>
                   <dict>
                           <key>CFBundleTypeRole</key>
                           <string>None</string>
                           <key>CFBundleURLName</key>
                           <string>BUNDLE_ID</string>
                           <key>CFBundleURLSchemes</key>
                           <array>
                                   <string>tagmanager.sgtm.c.BUNDLE_ID</string>
                           </array>
                   </dict>
           </array>
           <key>GOOGLE_ANALYTICS_SGTM_UPLOAD_ENABLED</key>
           <true/>
   </dict>
   </plist>
   

2. Para ativar o modo de depuração ou visualização, adicione uma chamada a Analytics.handleOpen(_:) em um método de ciclo de vida para transmitir o URL de inicialização.

   SwiftUI

   @main
   struct MyApplication: App {
     var body: some Scene {
       WindowGroup {
         ContentView()
           .onOpenURL { url in
             Analytics.handleOpen(url)
           }
       }
     }
   }
   

   UIScene

   class SceneDelegate: UIResponder, UIWindowSceneDelegate {
   func scene(_ scene: UIScene, willConnectTo session: UISceneSession,
           options connectionOptions: UIScene.ConnectionOptions) {
   ...
       if let urlContext = connectionOptions.urlContexts.first {
           let url = urlContext.url
           Analytics.handleOpen(url)
       }
     }
   }
   

   Para apps que não usam SwiftUI ou UIScene, nenhuma ação é necessária. O SDK recebe o URL de inicialização do ApplicationDidFinishLaunchingNotification.

Android

1. Instale a versão mais recente do SDK do Google Analytics para Firebase.

2. Ative o sGTM adicionando o seguinte ao arquivo AndroidManifest.xml do aplicativo.

   <!-- Preview Activity to enable preview mode –->
     <activity
         android:name="com.google.firebase.analytics.GoogleAnalyticsServerPreviewActivity"
         android:exported="true"
         android:noHistory="true" >
       <intent-filter>
         <action android:name="android.intent.action.VIEW" />
         <category android:name="android.intent.category.DEFAULT" />
         <category android:name="android.intent.category.BROWSABLE" />
         <data android:scheme="tagmanager.sgtm.c.<APP_PACKAGE_ID>" />
       </intent-filter>
     </activity>
   
   <!-- Meta-data that enables uploads to sGTM –->
     <meta-data android:name="google_analytics_sgtm_upload_enabled" android:value="true" />
   

   Observação: <APP_PACKAGE_ID> precisa estar em letras minúsculas. A correspondência de esquemas no framework do Android diferencia maiúsculas de minúsculas, ao contrário do RFC.

Etapa 2: configurar o contêiner do servidor para oferecer suporte ao tráfego de dispositivos móveis

A seção a seguir pressupõe que você tenha uma implantação de inclusão de tags no servidor e esteja familiarizado com os conceitos dela. Se você não tem experiência com a inclusão de tags no servidor, faça o curso sobre os conceitos básicos da inclusão de tags no servidor.

Configurar o cliente do Google Analytics: GA4 (app)

Um cliente é um tipo de recurso do Gerenciador de tags que intercepta determinados tipos de solicitações recebidas e gera eventos que podem ser enviados para um destino, como o Google Analytics 4. Nesse caso, a solicitação HTTP é um evento do Google Analytics 4. Portanto, configure o cliente integrado Google Analytics: GA4 (app). Você só precisa de um cliente do GA4 por fonte de dados, como o SDK do GA e o site. Saiba mais sobre como os clientes funcionam.

1. No contêiner do servidor, acesse Clientes e clique em Novo.

2. Clique em Configuração do cliente e selecione Google Analytics: GA4 (app).

   

3. Insira um nome para o cliente e clique em Salvar.

Configurar a tag do Google Analytics: GA4

Para enviar dados ao Google Analytics, crie uma tag do Google Analytics: GA4 no contêiner do servidor. O cliente analisa a solicitação HTTP recebida em um objeto de dados de eventos. A tag vai usar esse objeto, mapear para o formato correto e enviar ao Google Analytics 4.

1. No contêiner do servidor, acesse Tags e clique em Nova.

2. Clique em Configuração da tag e escolha Google Analytics: GA4.

   

Por padrão, a tag herda todos os campos e parâmetros relevantes do objeto de dados de eventos criado pelo cliente:

• Se a solicitação recebida do Google Analytics 4 passar pelo cliente Google Analytics: GA4 (app), a tag vai herdar o ID do app e os parâmetros de evento.
• Se as solicitações recebidas do Google Analytics 4 passarem pelo cliente Google Analytics: GA4 (Web), a tag vai herdar o ID de métricas e os parâmetros de evento.

Dica: você pode usar transformações para incluir, excluir ou modificar a saída dos parâmetros de evento do seu cliente antes de serem expostos para as tags. Com as transformações, você protege informações sensíveis e tem um controle preciso sobre quais parâmetros do evento ficam disponíveis para processamento adicional.

Configurar acionadores para tráfego móvel

Em seguida, defina quando a tag do GA4 deve ser disparada. O cliente do Google Analytics: GA4 (app) analisa a solicitação recebida em um objeto de dados de eventos, e a tag herda os valores dele. Portanto, geralmente é recomendável que a tag seja disparada sempre que o cliente do GA4 reivindicar a solicitação.

Para configurar os acionadores:

1. Nas configurações da tag, clique em Acionamento.
2. Para criar um acionador, clique no ícone + no canto superior direito.
3. Clique em Configuração do acionador para escolher o tipo.

4. Escolha Personalizado ou Evento personalizado na lista.

   • Por padrão, o tipo Acionador personalizado dispara a tag quando qualquer evento é gerado por um cliente do lado do servidor.
   • O tipo de acionador Evento personalizado pode ser usado para disparar a tag em um nome de evento específico ou em um evento que corresponda a um padrão de expressão regular.

5. Para ativar a lista de condições de ativação desse acionador, como disparar apenas em dados de eventos de dispositivos móveis ou da Web, selecione Alguns eventos.

   1. A opção Nome do evento fica pré-selecionada. Clique nesse seletor e em Escolher variável integrada na lista.
   2. Para retornar automaticamente o nome do cliente que gerou o evento, selecione Nome do cliente.

   3. Use o nome do cliente que você configurou anteriormente para definir a condição de acordo com essa informação. Seu acionador vai ficar assim:

      

      Observação: o nome do cliente é o que você especificou na etapa anterior. O tipo de cliente é Google Analytics: GA4 (app). A variável "Nome do cliente" retorna o nome, e não o tipo do cliente.

6. Salve o acionador e insira um nome descritivo. Por exemplo, "Todos os eventos de app do GA4".

7. Agora você deve estar de volta às configurações da tag, com o novo acionador implementado. Salve a tag e insira um nome descritivo, por exemplo, "GA4". A tag vai ter esta aparência:

   

Dica: para omitir o envio de determinados eventos, use acionadores personalizados com lógica condicional baseada no nome do evento (ou em outra variável) ou adicione exceções de acionador. Saiba mais sobre acionadores e exceções de acionadores.

Visualizar o contêiner

É possível usar o Gerenciador de tags do Google para visualizar e depurar seu contêiner do servidor antes de publicar as mudanças. A visualização não vai funcionar até que você ative a inclusão de tag do lado do servidor na sua propriedade do GA4.

Para que as solicitações do app acionem a configuração de prévia, você precisa:

1. Selecione Visualizar no contêiner do servidor do Gerenciador de tags do Google.
2. Clique no ícone Mais ações ⋮ no canto superior direito e selecione Enviar solicitações de um app.

3. Insira o ID do app e clique em Gerar QR code.

   Observação: o ID do app precisa começar com uma letra. Como alternativa, use qualquer ID exclusivo que comece com uma letra, desde que corresponda ao ID usado no arquivo Info.plist ou AndroidManifest.xml.

   

4. Leia o QR code com o app de câmera do smartphone e interaja com o app como faria normalmente para gerar eventos de visualização.

5. Clique em OK para fechar a caixa de diálogo.

Publicar o contêiner

Depois de verificar as mudanças, publique o contêiner para que elas sejam aplicadas a todo o tráfego. Saiba mais sobre Publicação, versões e aprovações.

Etapa 3: ativar a inclusão de tag do lado do servidor na sua propriedade do GA4

1. Na sua propriedade do Google Analytics 4, acesse Administrador.
2. Abra Fluxos de dados.

3. Selecione a configuração de fluxo do seu aplicativo na guia "iOS" ou "Android".

   

4. Clique em Definir as configurações do SDK e em Configurar o Gerenciador de tags do lado do servidor.

   

5. Para permitir que o SDK envie dados de medição ao URL do contêiner do servidor:

   1. Ative a opção Enviar dados para um contêiner do Gerenciador de tags do lado do servidor.
   2. Copie o URL do contêiner do servidor. Para encontrar essa informação no Gerenciador de tags do Google, acesse Administrador > Configurações do contêiner > URLs do contêiner do servidor.

   3. Selecione a porcentagem de tráfego que você quer encaminhar para o contêiner do servidor. Você pode escolher uma opção abaixo de 100% para validar a configuração do servidor antes de usar a inclusão de tags no servidor em todo o tráfego.

      Observação: use a opção "Depurar apenas dispositivos" para ativar apenas os apps que são abertos usando o modo de visualização para enviar dados ao seu servidor.

   

6. Clique em Salvar. O SDK vai recuperar o URL atualizado do contêiner de servidor e direcionar os dados de medição direta para ele.

Limitações conhecidas

• Para aplicativos Android:

  • As compras no app registradas automaticamente dependem da integração com o back-end do Google Play e não são enviadas ao contêiner do servidor.
  • O evento app_remove não será informado no Android.

• Conectar os fluxos de dados do app no Google Analytics à sua conta do Google Ads ainda é necessário para garantir que os dados e as conversões do SDK sejam importados para o Google Ads. A inclusão de tags do lado do servidor não oferece nenhuma integração inerente entre seu SDK e o Google Ads.

Observação: o SDK do Google Analytics para Firebase foi projetado e otimizado para enviar dados ao Google Analytics 4. Em seguida, o Google Analytics 4 pode ser vinculado ao Google Ads para relatórios de conversão, criação de público-alvo, otimização de campanha e modelagem. Isso inclui a inclusão de tags no servidor para apps, e incentivamos os clientes a aproveitar a integração entre o Google Analytics e a inclusão de tags no servidor no Gerenciador de tags do Google.

API

Você pode usar a API REST do Gerenciador de tags para acessar os dados de configuração do Gerenciador de tags. Para mais informações sobre a API:

• Consulte o guia do desenvolvedor para saber como trabalhar com a API.
• Consulte a Referência da API Tag Manager para se familiarizar com os recursos do Gerenciador de tags e as operações disponíveis.