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

Ao longo deste codelab, você vai conhecer todo o processo de negócios de apps que nossos clientes enfrentam. Se você quiser uma introdução mais simples ao Firebase e à AdMob no iOS, comece com AdMob+Firebase 101 Unity: configuração e conceitos básicos do Google Analytics.

O que você vai aprender

• Como inicializar o GA4F (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 do Unity usando um modelo. Você vai modificar esse app simples para criar o final.

Iniciar o Unity

1. Se não houver projetos abertos, selecione "Criar um novo projeto".
2. Selecione modelos 3D na caixa de diálogo.
3. Preencha o nome do projeto. Por exemplo, Unity Firebase Custom Event.
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, faça a ativação na guia "Integrações" em "Configurações" > "Configurações do projeto". Vá 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 do Firebase 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 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 buscar usando a próxima etapa.

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

2. No 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 de mudar a plataforma, clique no botão "Player Settings" para definir o ID do pacote. Você vai 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 e copie o seu.
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 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ê vai 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 do Unity você quer registrar ou opte por registrar os dois destinos agora.

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 depois 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 são frequentemente usados de maneira intercambiável.

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 algum lugar conveniente.

• É 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 qualquer outro produto 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 versões 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 oferecem mais suporte ao 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. porque ele é 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 automaticamente alguns eventos para você. Não é necessário 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

Depois de configurar a instância do 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 Arguments Passed On Launch, 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 algumas horas. Ele está em "Analytics" → "Eventos". Você também pode clicar no evento para encontrar os valores de parâmetro.

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

Para verificar se o evento foi marcado como conversão, acesse a guia "Conversões" do Firebase Analytics. Ao marcar o evento como 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-iOS está concluída, e você está pronto para lançar a campanha para apps com eventos de ação registrados. Comece vinculando 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 aumentar os aprendizados das campanhas para apps, o que geralmente resulta em melhor performance e mais 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 Google Ads, faça login e acesse "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. Clique nele 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 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 fase de produção no Google Play. Se você não estiver pronto para publicar o app, deixe essa etapa para depois.

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. Por enquanto, vamos lançar uma campanha de promoção de app com a opção "Apps - Instalações".

8. Encontre seu app informando o nome dele, do pacote ou do publisher.
9. Na seção "Lances", selecione "Ações no app" na caixa de seleção para que o Google Ads se concentre nas ações.
10. Você vai encontrar seus eventos personalizados na lista exibida. Defina o custo por ação desejado e preencha as outras opções.

11. Defina as configurações da campanha. Isso não faz parte do escopo do codelab. 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