Eventos personalizados do Google Ads com o Google Analytics para Firebase (iOS)

1. Introdução

Última atualização:14/12/2020

O que você vai criar

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

Com este codelab, você pode passar por todo o processo de negócios de apps que nossos clientes enfrentam. Se quiser uma introdução mais suave ao Firebase para iOS, comece com o Codelab do Firebase para iOS em Swift.

O que você vai aprender

• Como inicializar o GA4F (Google Analytics para Firebase) no Swift para 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
• Conta do Firebase.
• Conta do Google Ads

2. Iniciar um novo projeto do Swift para iOS

Crie um app de modelo simples do Swift para iOS. Você modificará esse app inicial para criar o final.

Primeiro, inicie o Xcode.

1. Se não houver projetos abertos, selecione "Create a new Xcode project" na página inicial.
2. Selecione "iOS" na parte de cima da caixa de diálogo.
3. Na seção "Application", selecione "App" e clique em "Next".
4. Na caixa de diálogo exibida, use os seguintes valores para nomear o app e escolher outras opções para o projeto e clique em "Next":
5. Nome do produto: por exemplo, ios-app

O Xcode usa o nome do produto inserido para nomear o projeto e o app.

2. Equipe: se esse campo não for preenchido automaticamente, defina a equipe como "None".
3. Nome da organização: o nome da sua organização ou seu próprio nome.
4. Identificador do pacote: esse valor é gerado automaticamente com base no nome do produto e no identificador da organização.
5. Linguagem: Swift
6. Selecione um local para salvar o projeto e clique em "Create".
7. O Xcode 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.

Criar 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 das > Configurações do projeto. Passe para a etapa de configuração do Firebase.

1. Faça login no Firebase.

No Console do Firebase, clique em "Adicionar um 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 Firebase

1. No Console do Firebase, selecione "Visão geral do projeto" > "Configurações do projeto" no painel de navegação à esquerda e clique no botão "iOS" em "Geral" > "Seus apps".

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

2. O valor importante a ser fornecido é o ID do pacote do iOS, que você vai buscar usando a próxima etapa.
3. No projeto Xcode do app para iOS, selecione o app de nível superior no navegador do projeto e selecione a guia "Geral".
4. O valor do campo "Identificador do pacote" é o ID do pacote do iOS (algo como com.yourcompany.yourproject). Copie esse valor.
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. Acesse o projeto Xcode e mova o arquivo GoogleService-Info.plist (que você acabou de fazer o download) para a raiz do projeto Xcode.
9. Pule as etapas restantes e volte à página principal do Console do Firebase.

5. Configurar o Firebase Analytics no Xcode

Nesta etapa, você vai começar a adicionar o SDK do Firebase ao projeto Xcode.

Observação:os Serviços do Google usam o CocoaPods para instalar e gerenciar dependências. Se você nunca usou o CocoaPods antes, primeiro instale-o executando este comando no terminal:

$ sudo gem install cocoapods

1. Abra uma janela do terminal e navegue até o local do projeto Xcode do seu app.
2. Crie um Perfil se ainda não tiver um:

$ pod init

3. Abra seu Podfile e adicione :

$ vi Podfile

$ pod 'Firebase/Analytics'

4. Salve o arquivo e execute :

$ pod install

5. Adicione o código de inicialização :

Para conectar o Firebase quando seu app for inicializado, adicione o código de inicialização abaixo à sua classe principal AppDelegate.

import UIKit
import Firebase

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions:
      [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    FirebaseApp.configure()
    return true
  }
}

6. Tudo pronto! Continuar no console.

Agora você já pode disparar alguns logs de eventos personalizados.

6. Registrar eventos personalizados com o Firebase Analytics

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

O Firebase Analytics registra alguns eventos para você automaticamente, sem precisar de código adicional para o recebimento. Caso seu app precise coletar outros dados, é possível registrar até 500 tipos diferentes de eventos personalizados do Analytics no app.

Registrar eventos

Após configurar a instância do FirebaseApp, será possível registrar eventos com o método logEvent().

Analytics.logEvent("text_search", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject
  ])

Definir parâmetros padrão de eventos

É possível registrar parâmetros em eventos usando setDefaultEventParameters. Os parâmetros padrão são associados a todos os eventos futuros registrados.

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

Visualizar 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 várias horas. Ele está localizado em "Analytics" → "Eventos". Também é possível encontrar valores de parâmetros clicando no evento.

Para marcar o "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 conversão, o Google Ads também poderá importar o evento como uma conversão.

7. Como importar eventos do Analytics no Google Ads

A configuração do Firebase-iOS foi 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 poderão aprender mais sobre os públicos-alvo e aumentar os aprendizados da campanha para apps, o que geralmente leva a um melhor desempenho 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 e faça login. Em seguida, 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 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 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, pule 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. Desta vez, 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 editor.
9. Na seção "Lances", selecione "Ações no app" na caixa de seleção para que os anúncios se concentrem nas ações.
10. Você 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 vai além 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 e o Google Ads. Isso vai ajudar a aumentar a performance da campanha.

Você instalou o script, criou e preparou uma nova lista de mudanças do codelab, atualizou e preparou a lista de mudanças pendente do codelab, revisou e aprovou a lista de mudanças do codelab e enviou e publicou a lista de mudanças do codelab.

Você aprendeu

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