Numa olhadela: Instruções para configurar o envio de eventos, reportados via Firebase SDK, para AppsFlyer no Google Tag Manager.
Configuração do Google Tag Manager
Esta secção discute a configuração necessária na interface do utilizador do Google Tag Manager (GTM). Todos os passos descritos nesta secção são necessários para que o GTM envie eventos para AppsFlyer. Siga os passos pela ordem indicada.
Os seguintes passos são para o Google Tag Manager em aplicações móveis. Se a interface do seu Google Tag Manager for diferente das capturas de ecrã nos vários passos, verifique o seguinte:
- O conteúdo do seu Google Tag Manager está configurado para aplicações móveis.
- O contentor é o v5. Para mais informações, clique aqui.
Nota
Os passos descritos nesta secção referem-se a um evento de compra, mas são relevantes para qualquer evento que deseje enviar.
1. Criar variáveis de parâmetros de eventos
As variáveis de parâmetros de eventos permitem que o Google Tag Manager obtenha dados do evento. Quando o evento é enviado, as variáveis ID do AppsFlyer e Dev Key são passadas junto com ele. O Google Tag Manager avalia então o valor dessas variáveis e é assim que as obtém. Os dados do evento têm duas funções:
- Fornecer ao Google Tag Manager o ID do AppsFlyer e a Dev Key
- Fornecer ao Google Tag Manager o nome do evento e os parâmetros do evento
Sempre que o Google Tag Manager enviar um evento para o AppsFlyer, deve enviá-lo com o ID do AppsFlyer e a Dev Key. A Dev Key permite que o Google Tag Manager comunique com os servidores do AppsFlyer. O ID do AppsFlyer permite que o AppsFlyer saiba a qual utilizador atribuir o evento.
- No Google Tag Manager, clique em Variáveis e depois em Novo
- Dê o nome à variável de "Chave de Desenvolvedor AppsFlyer" e clique em Configuração da Variável.
- Escolha Parâmetro de Evento.
- Escolha Parâmetro Personalizado.
- No campo Parâmetro de Evento , introduza "dev_key" e guarde.
- Repita o processo para o ID AppsFlyer também - nomeie a variável de "ID do Dispositivo AppsFlyer" e introduza "af_id" no campo Parâmetro de Evento .
Exemplo
Abaixo está uma captura de ecrã da interface do GTM. Mostra a configuração final do parâmetro de evento:
Importante!
Para iOS, deve ser configurado um Parâmetro de Evento adicional. Siga o mesmo fluxo listado acima. Crie uma variável e nomeie-a "Apple App ID". No campo Parâmetro de Evento, introduza "apple_app_id" e guarde.
O próximo passo é criar e definir as variáveis ID e Chave de Desenvolvedor AppsFlyer dentro da aplicação. Este passo é discutido na secção Envio de Eventos.
A maioria dos eventos in-app requer parâmetros de valor de evento. Neste caso, são os parâmetros af_revenue e af_price, mas pode enviar quaisquer parâmetros de evento. Agora que o evento está configurado na aplicação, é necessário criar variáveis de receita e preço no Google Tag Manager. Estas variáveis serão usadas mais tarde na tag de evento de Compra.
- No Google Tag Manager, crie duas variáveis de Parâmetro de Evento para af_revenue e af_price.
- Para "af_revenue", nomeie a variável "Receita" e defina a Chave do Parâmetro de Evento para "af_revenue".
- Para "af_price", nomeie a variável "Preço" e defina a Chave do Parâmetro de Evento para "af_price".
Exemplo
Abaixo está uma captura de ecrã da interface do GTM. Mostra a configuração final do parâmetro de evento:
Nota
O exemplo aqui mostra como criar variáveis de parâmetro de evento para os parâmetros de evento Receita e Preço. Pode criar variáveis de parâmetro de evento para qualquer tipo de parâmetro de evento, de acordo com o evento que é enviado.
2. Criar um gatilho para o evento de compra.
Para que o Google Tag Manager saiba se o evento deve ser enviado para o AppsFlyer, um disparador para o evento deve ser configurado.
- No Google Tag Manager, clique em Disparadores e depois em Novo.
- Nomeie o disparador como "Compra" e clique em Configuração do Disparador.
- Escolha Personalizado.
- Escolha Alguns Eventos.
- Nas condições, defina o disparador para ser ativado quando o Nome do Evento for igual a "af_purchase".
- Clique em Salvar.
Exemplo
Abaixo está uma captura de ecrã da interface do GTM. Aqui está a configuração final do disparador:
3. Criar um tag para o evento de compra
Agora que as variáveis necessárias e o disparador do evento estão configurados, você pode criar o tag para o evento de Compra.
- No Google Tag Manager, clique em Tags e depois em Novo.
- Nomeie o tag como "Compra" e clique em Configuração do Tag.
- Escolha AppsFlyer.
- No campo ID da Aplicação , defina a variável interna do ID da App.
Importante!
Para iOS, defina a variável personalizada "apple_app_id" no campo ID da Aplicação .
- No campo Chave de Desenvolvedor , escolha a variável "AppsFlyer Dev Key".
- No campo ID do Dispositivo AppsFlyer , escolha a variável "AppsFlyer Device ID".
- No campo Nome do Evento, defina a variável interna Nome do Evento.
- No campo Moeda do Evento , defina o código da sua moeda, por exemplo, USD.
- Clique duas vezes em Adicionar Valor do Evento.
- Defina o seguinte:
Chave: af_revenue, Valor: escolha a Variável de Parâmetro do Evento "Receita".
Chave: af_price, Valor: escolha a Variável de Parâmetro do Evento "Preço". - Na secção de Disparos, defina o Disparador de Ativação para o disparador do evento "Compra".
- Clique em Salvar.
Exemplo
Abaixo está uma captura de ecrã da interface do GTM. Aqui está a configuração final do Tag:
4. Publicação do container do tag manager
- Android - app/src/main/assets/containers
- iOS - pasta raiz/container