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

Neste codelab, você vai conhecer todo o processo de negócios de apps que nossos clientes estão enfrentando. Se quiser uma introdução mais suave ao Firebase para iOS, comece pelo Firebase iOS Codelab Swift

O que você vai aprender

• Como inicializar o GAPF (Google Analytics para Firebase) no iOS Swift
• 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 iOS Swift

Crie um app iOS Swift de modelo simples. Modifique esse app inicial para criar o final.

Primeiro, inicie o Xcode.

1. Se você não tiver projetos abertos, selecione Criar um novo projeto Xcode na página inicial.
2. Selecione iOS na parte superior 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 seu aplicativo, escolha opções adicionais para o projeto e clique em Next :
5. Nome do produto: por exemplo, ios-app

O Xcode usa o nome do produto que você digitou para nomear o projeto e o app.

2. Equipe: se esse campo não for preenchido automaticamente, defina a equipe como "Nenhuma".
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. Idioma: Swift
6. Selecione um local para salvar o projeto e clique em "Criar".
7. O Xcode 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.

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" em "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 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ê encontra na etapa a seguir.
3. No projeto do Xcode para o app iOS, selecione o app de nível superior no navegador do projeto e, em seguida, a guia "General".
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 seu projeto do Xcode e mova o arquivo GoogleService-Info.plist que você acabou de salvar para a raiz do projeto.
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 seu projeto do Xcode.

Observação:os Serviços do Google usam CocoaPods para instalar e gerenciar dependências. Se você nunca usou o CocoaPods, 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 o Podfile e adicione:

$ vi Podfile

$ pod 'Firebase/Analytics'

4. Salve o arquivo e execute:

$ pod install

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

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

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! Prossiga para o console.

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

6. Registrar eventos personalizados com o Firebase Analytics

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

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

Registrar eventos

Depois de 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 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 "Google Analytics" > "Eventos". Também é possível encontrar valores de parâmetros clicando no evento.

Para marcar "text_search" como uma conversão, deslize 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. 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 você está pronto para lançar a campanha para apps com 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, agora é o momento 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. Nesse período, vamos lançar uma campanha de promoção de app com a opção de instalações de apps.

8. Encontre seu app informando o nome, o nome do pacote ou o 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 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 e o Google Ads. Isso vai ajudar a melhorar a performance da sua campanha.

Você instalou o script, criou e preparou uma nova lista de mudanças do codelab, atualizou e organizou a lista de mudanças pendentes do codelab, analisou 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.