Gerenciador de tags + Firebase: primeiros passos

Introdução

Os desenvolvedores podem usar a interface do Gerenciador de tags do Google para implementar e gerenciar as tags e os pixels de avaliação nos aplicativos para dispositivos móveis deles, sem ter de recriar e reenviar os binários aos mercados de aplicativos. Os profissionais que trabalham com o Firebase Analytics podem adicionar facilmente o Gerenciador de tags do Google e usá-lo para gerenciar e fazer alterações na implementação, mesmo após o envio do aplicativo.

Eles podem registrar eventos importantes para decidir quais tags ou pixels de acompanhamento precisam ser disparados. No momento, o Gerenciador é compatível com as tags dos seguintes produtos:

• Firebase Analytics
• Google Analytics
• Floodlight
• Google Ads
• Adjust
• AppsFlyer
• Apsalar
• Kochava
• Tune
• Custom Function Calls (para outros produtos)

Observação: se você quiser ser um fornecedor de tags e solicitar que o Google inclua um modelo para a tag da sua empresa, preencha este formulário. Para mais detalhes, consulte o artigo sobre o Programa de modelos de tags de fornecedores do Gerenciador de tags do Google.

Pré-requisitos

Antes de começar, faça o seguinte:

• Instale o SDK do Firebase.
• No Firebase console, adicione o aplicativo ao seu projeto.
• Adicione o Firebase Analytics ao seu aplicativo.
• Crie uma conta do Gerenciador de tags do Google.
• Configure um contêiner do Gerenciador de tags do Google.

Veja na seção a seguir as etapas para configurar e usar o Gerenciador de tags do Google no seu aplicativo para iOS.

Primeiros passos

1. Adicionar o Gerenciador de tags do Google ao seu projeto.
2. Registrar eventos e variáveis.
3. Disparar as tags.
4. Visualizar, depurar e publicar seu contêiner.

1. Adicionar o Gerenciador de tags do Google ao seu projeto

1. Adicione o CocoaPods do Gerenciador de tags do Google ao seu projeto:
   1. Em um terminal, execute o seguinte comando para instalar o CocoaPods:

      $ sudo gem install cocoapods
      

   2. Mude para o diretório do seu projeto.
   3. Execute o seguinte comando para criar um arquivo chamado Podfile:

      $ pod init
      

   4. No Podfile, adicione o seguinte:

      pod 'GoogleTagManager', '~> 6.0'
      

   5. Execute o comando a seguir para fazer o download e instalar as dependências do Gerenciador de tags do Google no seu projeto:

      $ pod install
      

2. Crie um contêiner do iOS se sua conta do Gerenciador de tags do Google não tiver um:
   1. Faça login na sua conta do Gerenciador de tags do Google.
   2. Clique em ADMIN na barra de navegação superior.
   3. Na coluna CONTÊINER, clique no menu suspenso e selecione CRIAR CONTÊINER.
   4. Insira um nome para o contêiner.
   5. Selecione o contêiner do iOS.
   6. Selecione o Firebase iOS SDK.
   7. Clique em CRIAR.
3. Faça o download do seu contêiner:
   1. Faça login na sua conta do Gerenciador de tags do Google.
   2. Selecione seu contêiner do iOS.
   3. Clique em Versões na barra de navegação superior.
   4. Clique em Ações > Download na versão do contêiner selecionada.
      O nome do arquivo salvo é o código do contêiner com uma extensão .json.
4. Adicione o contêiner salvo ao seu projeto:
   1. Copie o arquivo salvo em uma pasta chamada container na raiz do projeto XCode (geralmente PROJECT_ROOT/container/GTM-XXXXXX.json).
   2. Abra o Xcode.
   3. No menu Arquivo, escolha Adicionar arquivos a...
   4. Selecione a pasta container.
   5. Clique em Opções e verifique se a opção Criar referências de pasta está selecionada.
   6. Clique em Concluir.

2. Registrar eventos e variáveis

O Gerenciador de tags do Google usa os eventos, os parâmetros e as propriedades do usuário do Firebase Analytics para acionar e criar as tags que você configurou na interface da Web do Gerenciador. Assim, sua implementação do Firebase Analytics atua como a camada de dados.

Leia a documentação do desenvolvedor do Firebase Analytics para ver instruções sobre como registrar eventos e configurar as propriedades do usuário.

Configurar variáveis no Gerenciador de tags

Para usar o valor dos parâmetros do evento e das propriedades do usuário do Firebase no Gerenciador de tags do Google, configure variáveis na interface do Gerenciador.

Por exemplo, se você registrasse o seguinte evento personalizado no seu aplicativo:

Analytics.logEvent("share_image", parameters: [
    "image_name": name,
    "full_text": text
  ])

poderia configurar novas variáveis do parâmetro do evento no Gerenciador de tags do Google para capturar os valores de image_name e full_text parameter:

• Nome da variável: nome da imagem
• Tipo da variável: parâmetro do evento
• Nome da chave do parâmetro do evento: image_name

e:

• Nome da variável: texto completo
• Tipo da variável: parâmetro do evento
• Nome da chave do parâmetro do evento: full_text

Da mesma forma, se você definisse a seguinte propriedade do usuário no seu aplicativo:

Analytics.setUserProperty(food, forName: "favorite_food")

poderia configurar uma nova variável da propriedade do usuário do Firebase no Gerenciador de tags do Google para capturar o valor de favorite_food:

• Nome da variável: comida favorita
• Tipo da variável: propriedade do usuário do Firebase
• Nome da chave do parâmetro do evento: favorite_food

Modificar e bloquear eventos do Firebase Analytics

Com o Gerenciador de tags do Google, você pode modificar e bloquear eventos antes que eles sejam registrados no Firebase Analytics. Ao modificar eventos, é possível adicionar, remover ou alterar os valores dos parâmetros dos eventos ou ajustar os nomes deles sem precisar atualizar os aplicativos. Os eventos não bloqueados serão registrados no Firebase Analytics.

O Firebase Analytics também registra automaticamente alguns eventos e propriedades do usuário. Assim, você não precisa adicionar códigos para ativá-los. Esses dados coletados automaticamente podem ser usados no Gerenciador de tags do Google, mas não podem ser bloqueados.

3. Disparar as tags

As variáveis de nome e de parâmetro de evento do Firebase, além de outras variáveis, são usadas para configurar os acionadores. As condições do acionador são avaliadas sempre que você registra um evento do Firebase. Por padrão, os eventos do Firebase Analytics são disparados automaticamente. É possível adicionar uma tag do Firebase Analytics ao Gerenciador de tags para evitar que os eventos sejam enviados ao Firebase Analytics.

4. Visualizar, depurar e publicar seu contêiner

Antes de publicar uma versão do seu contêiner, convém visualizá-lo para garantir que ele funcione conforme o esperado. Com o Gerenciador de tags do Google, você visualiza as versões do seu contêiner ao gerar links e códigos QR na interface da Web do Gerenciador e usá-los para abrir o aplicativo.

Visualizar o contêiner

Para visualizar um contêiner, gere um URL de visualização na interface da Web do Gerenciador de tags do Google da seguinte forma:

1. Faça login na sua conta do Gerenciador de tags do Google.
2. Selecione um contêiner para dispositivos móveis.
3. Clique em Versões na barra de navegação superior.
4. Clique em Ações > Visualizar na versão do contêiner que você quer ver.
5. Digite o nome do pacote do seu aplicativo.
6. Clique em Gerar link de visualização de entrada.

   

   Figura 1: como gerar um URL de visualização na interface da Web do Gerenciador de tags.

   Salve este URL de visualização para usar nas etapas posteriores.

Para ativar as visualizações de contêiner, defina o esquema de URL de visualização do Gerenciador de tags do Google na lista de propriedades do seu projeto. Na seção tipos de URL do arquivo da lista de propriedades do seu aplicativo, registre o identificador e o esquema de URL a seguir:

URL identifier: your.package.name
URL scheme: tagmanager.c.your.package.name

Figura 2: como adicionar o esquema de URL de visualização do Gerenciador de tags ao arquivo da lista de propriedades do seu aplicativo.

Observação: your.package.name precisa corresponder ao nome do aplicativo usado para gerar o URL de visualização (veja a Figura 1).

Interrompa o aplicativo e abra o URL de visualização em um emulador ou dispositivo físico para visualizar o contêiner de amostra nesse aplicativo.

Depurar o contêiner

Quando você executa seu aplicativo em um simulador ou no modo de visualização, o Gerenciador de tags muda o registro para o modo detalhado de forma automática.

Publicar o contêiner

Publique o contêiner depois de visualizá-lo e verificar se ele está funcionando. Em seguida, as configurações das tags ficarão disponíveis para os usuários de aplicativos para dispositivos móveis.

Observação: um contêiner padrão de dispositivos móveis é usado para definir as configurações iniciais da tag até que um contêiner seja obtido por download. Depois que o aplicativo se conectar à Internet e fizer o download de outro contêiner, ele não usará mais esse padrão. Os aplicativos buscam atualizações de contêiner com frequência, geralmente a cada 12 horas.

Próxima

Leia sobre a configuração avançada.