Eventos personalizados do Google Ads com o Google Analytics para Firebase – Unity

1. Introdução

Última atualização: 19/02/2021

O que você vai criar

Neste codelab, você vai aprender a implementar eventos personalizados com o GA4F para iOS no ambiente Unity e a lançar campanhas de ação com o Google Ads.

Neste codelab, você vai conferir todo o processo de negócios de apps que nossos clientes enfrentam. Se quiser uma introdução mais suave ao Firebase e à AdMob no iOS, comece com Introdução ao Unity da AdMob+Firebase: noções básicas do Analytics e da configuração.

O que você vai aprender

• Como inicializar o GAPF (Google Analytics para Firebase) no Unity + iOS.
• Como criar eventos e parâmetros personalizados.
• Como importar eventos do Firebase para o Google Ads.
• Como lançar campanhas de ação com eventos personalizados.

O que é necessário

• Xcode
• Unity
• Conta do Firebase.
• Conta do Google Ads

2. Iniciar um novo projeto do Unity

Crie um app simples de modelo do Unity. Modifique esse app simples para criar o app final.

Iniciar o Unity

1. Se você não tiver projetos abertos, selecione "Criar um novo projeto".
2. Selecione modelos 3D na caixa de diálogo.
3. Preencha o nome do projeto, por exemplo, Evento personalizado do Unity Firebase.
4. Selecione um local para salvar o projeto e clique em CRIAR.
5. O Unity abre o novo projeto na janela do espaço de trabalho.

3. Criar e configurar um projeto do Firebase

Para começar a usar o Firebase, será necessário criar e configurar um projeto do Firebase.

Se você tiver um projeto do Firebase sem o Google Analytics ativado, poderá ativar o Google Analytics na guia "Integrações" em "Configurações > Configurações do projeto". Siga para a etapa de configuração do Firebase.

1. Faça login no Firebase.

No Console do Firebase, clique em Adicionar projeto(ou Criar um projeto) e nomeie seu projeto como Firebase-iOS-Ads

2. Clique nas opções de criação do projeto. Se for solicitado, aceite os termos do Firebase. Você precisa ativar o Google Analytics para esse projeto, porque são necessários eventos dele para rastrear os eventos de ação e analisar as conversões.

Para saber mais sobre os projetos do Firebase, consulte Entender os projetos do Firebase.

4. Configuração do Unity

1. Em Unity > File > Build Settings. O valor importante é definir o ID do pacote do iOS, que você vai conseguir usando a próxima etapa.

Você verá a caixa de diálogo mostrada na tela a seguir.

2. No seu projeto do Unity para o app iOS, abra a caixa de diálogo "Build Settings", File > Build Settings. Se a plataforma não estiver definida como iOS, selecione "iOS Platform" e clique no botão Switch Platform.

3. Depois da mudança de plataforma, clique no botão Player Settings para definir o ID do pacote. Você verá o campo de texto ao redor da área Identificação.
4. O valor do campo "Identificador do pacote" é o ID do pacote do iOS (algo como com.yourcompany.yourproject). Copie esse valor ou defina seu valor e copie.
5. Na caixa de diálogo do Firebase, cole o ID do pacote copiado no campo iOS bundle ID.
6. Clique em Registrar app.
7. Ainda no Firebase, siga as instruções para fazer o download do arquivo de configuração GoogleService-Info.plist
8. Abra a janela "Project" do seu projeto do Unity e mova os arquivos de configuração para a pasta Assets.
9. Pule as etapas restantes e volte à página principal do Console do Firebase.

5. Configurar o Firebase Analytics no Unity

Nesta etapa, você começará a adicionar o SDK do Firebase ao seu projeto do Unity.

1. Acesse o Console do Firebase.
2. No centro da página de visão geral do projeto, clique no ícone do Unity () para iniciar o fluxo de trabalho de configuração. Se você já adicionou um app ao seu projeto do Firebase, clique em Adicionar app para exibir as opções da plataforma.
3. Selecione qual destino de build do seu projeto Unity você quer registrar. Também é possível registrar os dois destinos ao mesmo tempo.

Observação: se você registrar apenas um destino de build do seu projeto do Unity agora, poderá retornar ao fluxo de trabalho de configuração mais tarde para registrar o outro destino.

4. Digite os IDs específicos da plataforma do seu projeto do Unity.

• Para iOS: insira o ID do iOS do seu projeto do Unity no campo ID do pacote do iOS.
• Para Android: insira o ID do Android do seu projeto do Unity no campo Nome do pacote Android. Os termos nome do pacote e ID do aplicativo geralmente são usados como sinônimos.

5. Onde fica o ID do projeto do Unity?

Observação:insira o ID que seu projeto está usando. O valor do ID diferencia maiúsculas de minúsculas e não pode ser alterado para esses apps do Firebase depois que eles são registrados no projeto do Firebase.

6. (Opcional) Digite os apelidos específicos da plataforma do seu projeto do Unity. Esses apelidos são identificadores de conveniência internos e só são visíveis para você no Console do Firebase.
7. Clique em Registrar app.

Adicionar SDKs do Firebase Analytics para Unity

1. No Console do Firebase, clique em Fazer o download do SDK do Firebase para Unity e descompacte o SDK em um local prático.

• É possível fazer o download do SDK do Firebase para Unity novamente a qualquer momento.
• O SDK do Firebase para Unity não é específico de nenhuma plataforma.

2. No seu projeto aberto do Unity, acesse Assets > Import Package > Custom Package.
3. No SDK descompactado, selecione os produtos compatíveis do Firebase que você quer usar no seu app.

• Adicione o pacote do Firebase para o Google Analytics: FirebaseAnalytics.unitypackage
• Adicione os pacotes de outros produtos do Firebase que você quer usar no seu app. Por exemplo, para usar o Firebase Authentication e o Firebase Realtime Database: FirebaseAuth.unitypackage e FirebaseDatabase.unitypackage

A versão 5.x do Unity e anteriores usam o framework .NET 3.x. Portanto, importe o pacote dotnet3/. Unity 2017.x e mais recentes permitem o uso do framework .NET 4.x. Caso seu projeto do Unity use .NET 4.x, importe o pacote dotnet4/. A versão 2019 do Unity e posteriores não são mais compatíveis com o framework .NET 3.x. Portanto, importe o pacote dotnet4/.

4. Na janela Import Unity Package, clique em Import.
5. De volta ao fluxo de trabalho de configuração no Console do Firebase, clique em Avançar.

Importante: se você estiver usando o SDK do Firebase para Unity do iOS, não desative o swizzling de métodos. O swizzling é exigido pelo SDK. Sem ele, os principais recursos do Firebase, como o processamento de tokens do FCM, não funcionam corretamente.

6. Registrar eventos personalizados com o Firebase Analytics

Nesta etapa, você vai aprender a registrar eventos personalizados com o Firebase Analytics no app iOS do Unity.

O Firebase Analytics registra alguns eventos automaticamente para você. Não é preciso adicionar códigos para recebê-los. Caso o app precise coletar outros dados, é possível registrar até 500 tipos diferentes de eventos personalizados do Analytics nele.

Registrar eventos

Após configurar a instância FirebaseApp, você pode começar a registrar eventos com o método logEvent().

Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);

Ver eventos no console de depuração do Xcode

É possível ativar o registro detalhado para ver se o SDK está registrando os eventos. Isso inclui os eventos registrados manual e automaticamente.

Para ativar o registro detalhado, faça o seguinte:

1. No Xcode, selecione Product > Scheme > Edit scheme....
2. Selecione Run no menu à esquerda.
3. Selecione a guia Arguments.
4. Na seção Argumentos transmitidos na inicialização, adicione -FIRAnalyticsDebugEnabled.

Na próxima vez que você executar seu app, os eventos vão aparecer no console de depuração do Xcode, o que ajuda a verificar imediatamente se os eventos estão sendo enviados.

Ver eventos no painel

O evento registrado vai aparecer no Console do Firebase em várias horas. Ele está localizado em Analytics → Eventos. Você também pode clicar no evento para conferir os valores dos parâmetros.

Para marcar "text_search" como uma conversão, mude a chave "Marcar como conversão" para a direita.

É possível verificar se o evento foi marcado como conversão na guia "Conversões" do Firebase Analytics. Ao marcar o evento como uma conversão, o Google Ads também poderá importá-lo como uma conversão.

7. Como importar eventos do Analytics no Google Ads

A configuração do Firebase para iOS foi concluída, e está tudo pronto para lançar a campanha para apps com os eventos de ação registrados. Comece vinculando o Firebase ao Google Ads. Ao vincular o Firebase ao Google Ads, as campanhas para apps vão poder aprender mais sobre os públicos-alvo e melhorar os aprendizados das campanhas para apps, o que geralmente resulta em melhor performance e conversões.

1. Acesse as configurações do Firebase clicando no botão ao lado de "Visão geral do projeto".
2. Na guia "Integrações", você verá o Google Ads e o botão "Vincular". Clique em "Vincular" e depois em "Continuar".

3. Selecione a conta do Google Ads.

Atenção: se o evento alvo não for marcado como conversão, o Google Ads não conseguirá importá-lo. Confira se ele foi marcado corretamente como uma conversão.

A parte relacionada ao Firebase já foi concluída.

Agora, acesse o Google Ads e faça login.

1. Acesse o Google Ads, faça login e vá até "Ferramentas e configurações → Medição → Conversões" para importar eventos personalizados como conversões.
2. Clique no botão + para adicionar uma nova ação de conversão.

3. Escolha as propriedades do Google Analytics 4 (Firebase) e clique em "Continuar".

4. Você verá todos os eventos do Analytics que foram marcados como conversões. Encontre o evento clicked_counter que implementamos antes.

5. Marque a caixa e clique no botão "Importar e continuar".

Depois de definir a pesquisa de texto como uma ação de conversão, é hora de lançar uma campanha segmentada para usuários que provavelmente vão disparar eventos do text_search.

8. Como lançar campanhas de ação para apps com eventos importados

Importante:para lançar uma campanha para apps, é necessário ter um app em produção no Google Play. Se você não quiser publicar o app, deixe esta etapa por enquanto.

6. Vá para a guia "Campanhas" da conta atual e inicie uma nova campanha clicando no botão +. Clique na nova campanha e continue.
7. Nesse período, vamos lançar uma campanha de promoção de app com a opção de instalações de apps.

8. Para encontrar seu app, informe o nome dele, do pacote ou do editor.
9. Na seção "Lances", selecione "Ações no app" na caixa de depósito para que os anúncios se concentrem nas ações.
10. Você encontrará seus eventos personalizados na lista fornecida. Defina o custo por ação desejado e preencha as outras opções.

11. Defina as configurações da campanha. Isso está fora do escopo do codelab. Consulte estes documentos ou entre em contato por outros canais para otimizar as configurações.

9. Parabéns

Parabéns! Você integrou o Firebase ao Unity e ao Google Ads. Isso vai ajudar a melhorar a performance da sua campanha.

Você aprendeu

• Como configurar o Firebase para a plataforma iOS do Unity
• Como registrar eventos personalizados com o Unity e o Firebase Analytics
• Como importar eventos e usá-los em campanhas de ação.

Documentos de referência

• Adicionar o Firebase ao seu projeto do Unity
• GitHub: firebase/quickstart-unity