Crie variáveis personalizadas definidas pelo usuário para dispositivos móveis no Gerenciador de tags do Google para atender a requisitos específicos que talvez ainda não sejam cobertos por variáveis incorporadas.
Para criar uma nova variável definida pelo usuário:
- Abra o contêiner do Gerenciador de Tags que você quer editar.
- Na guia "Espaço de trabalho" na navegação à esquerda, clique em Variáveis.
- Na seção "Variáveis definidas pelo usuário", clique em Nova.
- Clique em Configuração da variável e selecione o tipo de variável desejado.
- Preencha as opções para o tipo de variável selecionado.
- Dê um nome à variável. Use um esquema de nomenclatura que descreva a função dela, por exemplo, Variável da camada de dados – Nome do produto.
- Clique em Salvar.
O Gerenciador de tags oferece suporte a estes tipos de variável definidos pelo usuário para dispositivos móveis:
Firebase
Nome do evento
O valor será definido como eventNameXYZ quando o código a seguir for executado no seu aplicativo:
Android:
FirebaseAnalytics.getInstance(mContext).logEvent("eventNameXYZ", null);
iOS:
[FIRAnalytics logEventWithName:@"eventNameXYZ" parameters:parameters];
Na maioria dos casos, você precisa usar a variável incorporada equivalente.
Parâmetro do evento
O valor é definido como o valor de um parâmetro de evento do Google Analytics (Firebase) para a chave especificada.
Propriedade do usuário do Firebase
O valor é definido como o valor da propriedade do usuário do Google Analytics (Firebase) para a chave especificada.
Utilitários
O acompanhamento de anunciantes está ativado
Para Android, a variável vai retornará"true" se o acompanhamento de anúncios estiver ativado ou "false" se o usuário tiver desativado os anúncios com base em interesses. Saiba mais na Central para desenvolvedores do Android. Versões anteriores ao SDK v4 sempre retornam "false". Para o iOS 6 e as versões mais recentes, o valor é definido como a propriedade advertisingTrackingEnabled. Nos outros casos, o valor é definido como true. Na maioria dos casos, você precisa usar a variável incorporada equivalente.
Constante
O valor é definido para a string que você enviar.
Tabela de consulta
O valor é definido de acordo com as instruções na tabela de consulta. A tabela de consulta contém duas colunas (tabela vazia para ilustrar como os dados são usados depois):
| Quando [selecionar variável] for igual a | Defina [esta variável] como |
|---|
Com a tabela de consulta, você pode criar uma variável em que o valor varia de acordo com o valor de outro item. Isso é útil quando seu app está configurado de forma que o valor adequado (por exemplo, um ID de acompanhamento de conversões) possa ser mapeado para o código da versão do app ou outro aspecto do aplicativo. Neste exemplo, uma variável chamada ID de conversão é criada. Se o código da versão for 1.0, o valor será definido como 12345. Caso seja 1.1, o valor será definido como 34567. Não há limite para o número de linhas na tabela de consulta. Os campos diferenciam maiúsculas de minúsculas.
| Quando o {{App Version Code}} for igual a | Defina {{Conversion ID}} como |
|---|---|
| 1.0 | 12345 |
| 1.1 | 34567 |
| 1.2 | 56789 |
Número aleatório
O valor é definido como um número aleatório entre 0 e 2147483647. Na maioria dos casos, você precisa usar a variável incorporada equivalente.
Dados de contêiner
ID do contêiner
O valor é o código público do contêiner (por exemplo, GTM-ABC42). Na maioria dos casos, você precisa usar a variável incorporada equivalente.
Número da versão do contêiner
Quando o contêiner está no modo de pré-lançamento, o valor dessa variável é o número da versão de pré-lançamento do contêiner. Caso contrário, o valor é o número da versão ativa. Na maioria dos casos, você precisa usar a variável incorporada equivalente.
Aplicativo
ID do aplicativo
O valor é definido como o nome do pacote (Android) ou código do aplicativo (iOS). Na maioria dos casos, você precisa usar a variável incorporada equivalente.
Nome do aplicativo
O valor é definido como o nome do app. Na maioria dos casos, é necessário usar a variável incorporada equivalente.
Código da versão do app
O valor é definido como a versão do aplicativo em execução no momento. Na maioria dos casos, você precisa usar a variável incorporada equivalente.
ID de publicidade
Para Android, o valor é definido como o ID de publicidade. As versões do SDK anteriores à v4 sempre vão retornar uma string vazia. Para as versões do iOS 6 e mais recentes, o valor é definido como o identificador de publicidade (IDFA, na sigla em inglês). Caso contrário, o valor é definido como uma string vazia.
Versão do SDK
O valor é definido como a versão do SDK do sistema operacional em que o aplicativo está instalado. Na maioria dos casos, você precisa usar a variável incorporada equivalente.
Dispositivo
Nome do dispositivo
O valor é definido como o nome do dispositivo do aplicativo em execução no momento (por exemplo, Samsung Android, Pixel 2). Na maioria dos casos, você precisa usar a variável incorporada equivalente.
Idioma
O valor é definido como o código de idioma de duas letras que representa o idioma do dispositivo definido pelo usuário. Na maioria dos casos, você precisa usar a variável incorporada equivalente.
Versão do sistema operacional
O valor é definido como a versão do sistema operacional em que o aplicativo está instalado. Na maioria dos casos, você precisa usar a variável incorporada equivalente.
Plataforma
O valor é definido como a plataforma do aplicativo em execução no momento (por exemplo, "Android", "iOS"). Na maioria dos casos, você precisa usar a variável incorporada equivalente.
Resolução de tela
O valor é definido como a resolução da tela do dispositivo em que o app está em execução. O formato é largura x altura, por exemplo, 1920 x 1080. Na maioria dos casos, você precisa usar a variável incorporada equivalente.
Outro
Chamada de função
O valor é definido como o valor de retorno de uma chamada para uma função pré-registrada. Para saber mais, consulte a documentação do SDK (Android ou iOS).
Coleta de valores (apenas para contêineres legados)
Essa variável contém um conjunto de pares de chave-valor expressos em formato JSON. Use uma coleta de valores para definir os valores de configuração do seu aplicativo. Para um app de jogo de corrida, por exemplo, você pode definir uma variável "Configurações do app" do tipo "Coleta de valores" com o seguinte código:
{
"fuel-burn-rate": 20
}
Seu app para dispositivos móveis pode recuperar um valor na variável fornecendo a chave. Por exemplo:
public class MainActivity {
// Adiciona o ID do seu contêiner público.
private static final String CONTAINER_ID = "XXX-YYY";
// Chaves de valor da configuração do contêiner, usadas depois
// para recuperar valores.
private static final String MAX_FUEL_KEY = "max-fuel";
private static final String INIT_FUEL_KEY = "init-fuel";
private static final String FUEL_BURN_KEY = "fuel-burn-rate";
// Restante do seu código "onCreate".
}
}
/*
* Método para atualizar os valores de configuração do jogo usando um
* contêiner do Gerenciador de Tags do Google.
*/
public void updateConfigurationFromContainer(Container container) {
// Recebe referência para o contêiner.
Container container = mFutureContainer.get();
// Atualiza as configurações do jogo usando as chaves de
// valor da configuração do contêiner.
maxFuel = mContainer.getDoubleValue(MAX_FUEL_KEY);
startingFuel = mContainer.getDoubleValue(INIT_FUEL_KEY);
burnRate = mContainer.getDoubleValue(FUEL_BURN_KEY);
}
Uma variável "Coleta de valores" tem acionadores associados. Para os valores de configuração que se aplicam a todas as instâncias e versões do seu aplicativo, defina o acionador de ativação como "Sempre predefinido". Consulte a documentação para desenvolvedores (Android ou iOS) e veja detalhes sobre como usar a variável Coleta de valores.