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 GAPF para iOS no ambiente do Unity e lançar campanhas de ação pelo Google Ads.

Neste codelab, você vai conhecer todo o processo de criação de negócios de apps que nossos clientes estão enfrentando. Se quiser uma introdução mais simples ao Firebase e à AdMob no iOS, comece com guia de introdução ao Unity da AdMob e do Firebase: configuração e Princípios básicos do Google Analytics.

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

Criar um app Unity com um modelo simples. 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 Firebase do Unity
4. Selecione um local para salvar seu projeto e clique em CRIAR.
5. O Unity abre seu 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ê tem um projeto do Firebase sem o Google Analytics ativado, ative o Google Analytics na guia "Integrações" das suas configurações > Configurações do projeto. Prossiga 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. Como você precisa dos eventos do Google Analytics para rastrear conversões e eventos de ação, ative o Google Analytics neste projeto.

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

4. Configuração do Unity

1. No menu do Unity > Arquivo > Configurações do build. O valor importante é definir o ID do pacote iOS, que pode ser encontrado na etapa a seguir.

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-o e copie-o.
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 seus 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.

4. Insira 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 seu 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 internos de conveniência 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 da plataforma.

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

• Adicionar 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

Unity 5.x 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 Próxima.

Importante:com o SDK do Firebase para Unity no iOS, não desative o swizzling de métodos. O swizzling é exigido pelo SDK. sem ela, os principais recursos do Firebase (como o processamento de tokens do FCM) não funcionarão corretamente.

6. Registrar eventos personalizados com o Firebase Analytics

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

O Firebase Analytics registra alguns eventos automaticamente para você. não é preciso adicionar códigos para recebê-las. Caso seu app precise coletar dados adicionais, é 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 > Esquema > Editar esquema...
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

Você verá o evento registrado no Console do Firebase em algumas horas. Ele está localizado em Analytics → Eventos. Você também pode clicar no evento para conferir os valores dos parâmetros.

Você marcará "text_search" como conversão deslizando "marcar como conversão" mudar para a direita.

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

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. Para começar, vincule o Firebase ao Google Ads. Ao vincular o Firebase ao Google Ads, as campanhas para apps podem aprender mais sobre os públicos-alvo e impulsionar os aprendizados das campanhas para apps, o que geralmente leva a 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 de seleção e clique no botão Importar e continuar.

Depois de definir "text_search" como uma ação de conversão, é hora de lançar uma campanha que segmente usuários que provavelmente vão disparar eventos 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. Durante esse 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ê encontra 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 vai além do escopo do codelab, portanto, consulte esses 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