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

Criar um app iOS Swift de modelo simples. Modifique esse app inicial para criar o app 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 "Aplicativo", selecione "App" e clique em "Próxima".
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, app ios

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

2. Equipe: se isso 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ê 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 Firebase

1. No Console do Firebase, selecione Visão geral do projeto > Project Settings na navegação esquerda, depois clique no botão iOS em General > 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 seu projeto Xcode para o app 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 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ê começará a adicionar o SDK do Firebase ao seu projeto Xcode.

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

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

Definir parâmetros de evento padrão

É 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 > 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 você 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, 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. 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 e o Google Ads. Isso vai ajudar a melhorar a performance da sua campanha.

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