Eventos do app sem código

Os eventos do app sem código, incluídos na versão 4.34, permitem que você use o Gerenciador de Eventos para adicionar ou remover eventos sem implementar código nem lançar uma nova versão do app.

Android

Requisitos

É preciso ter uma das opções a seguir:

Consulte o guia de introdução para instalar a versão mais recente do SDK do Facebook para Android e o guia de atualização para atualizar para a versão mais recente do SDK. Se tiver instalado a v4.34-4.37, adicione o kit de marketing. Para isso, abra <your_app> | Gradle Scripts | build.gradle (Module: app) e inclua o seguinte na seção dependencies{}.

implementation 'com.facebook.android:facebook-marketing:[4,5)'

Lembre-se de recriar o seu projeto.

Implementar o recurso de evento do app sem código

Para ativar o evento de depuração sem código, adicione as seguintes linhas em AndroidManifest.xml:

<meta-data
    android:name="com.facebook.sdk.CodelessDebugLogEnabled"
    android:value="true" />

Adicionar os eventos do app

Acesse o Gerenciador de Eventos para adicionar os eventos do app a serem rastreados.

No Gerenciador de Eventos, clique em Adicionar nova fonte de dados e selecione Eventos do app no menu suspenso.
Clique em Usar nossa ferramenta de configuração de eventos sem código. Depois, selecione o app ao qual você quer adicionar eventos.
Para escolher a plataforma, clique em Iniciar configuração.
Se for o seu primeiro acesso ao fluxo sem código, você verá um pequeno tutorial. Depois de conferir o tutorial, abra uma nova sessão do app no seu dispositivo móvel.
Balance o telefone até que uma versão do seu app seja exibida.
Clique em qualquer elemento para adicionar um evento do app. Acesse diferentes páginas do app para selecionar os elementos.
Clique em Salvar no menu pop-up. Se não quiser adicionar o evento, clique em Cancelar.
Quando você tiver adicionado todos os eventos, clique em Verificar e concluir.
Clique em Eventos de teste ou Salvar e Sair.

Observação: pode levar até 30 minutos para que os eventos apareçam no Gerenciador de Eventos.

Verificar a integração

Acesse o Auxiliar para Anúncios no Aplicativo.

Selecione um app e clique em Enviar.
Role a tela para baixo até a seção Ferramentas para desenvolvedores e clique em Eventos do app de teste.
Se o app estiver enviando eventos fb_codeless_debug, os eventos de teste selecionados aparecerão na tabela.

Observação: funciona apenas com o SDK do Facebook v4.35 e versões posteriores.

iOS

Requisitos

SDK completo do Facebook para iOS (v4.34 a v7.1.1)
SDK principal do Facebook para iOS (v4.38 a v7.1.1)
SDK principal do Facebook para iOS (v4.34-4.37 a v7.1.1) e o kit de marketing

Limitações

Este recurso não está disponível para v8.0.0 nem versões posteriores. Saiba mais.

Consulte o guia de introdução aos eventos do app para iOS a fim de instalar a versão mais recente do SDK do iOS e o guia de atualização a fim de atualizar para a versão mais recente do SDK. Se tiver instalado apenas a v4.34-4.37 do SDK principal, adicione o kit de marketing incluindo o seguinte no seu Podfile.

pod 'FBSDKMarketingKit'

Lembre-se de executar pod update e pod install --repo-update.

Implementar o recurso de evento do app sem código

Ative o registro de eventos de depuração sem código ao abrir o .plist do app como código no Xcode e adicione o XML a seguir ao dicionário de propriedades:

<key>FacebookCodelessDebugLogEnabled</key>
<true/>

Adicionar os eventos do app

App Store Connect para iOS 14

Os eventos que seu app coleta e envia para o Facebook podem exigir que você divulgue esses tipos de dados no questionário do App Store Connect. É sua responsabilidade informar isso na política de privacidade do aplicativo. Consulte App privacy details on the App Store para saber os tipos de dados que você precisará divulgar.

Acesse o Gerenciador de Eventos para adicionar os eventos do app a serem rastreados.

No Gerenciador de Eventos, clique em Adicionar fonte de dados e selecione Eventos do app no menu suspenso.
Clique em Usar nossa ferramenta de configuração de eventos sem código. Depois, selecione o app ao qual você quer adicionar eventos.
Para escolher a plataforma, clique em Iniciar configuração.
Se for o seu primeiro acesso ao fluxo sem código, você verá um pequeno tutorial. Depois de conferir o tutorial, abra uma nova sessão do app no seu dispositivo móvel.
Balance o telefone até que uma versão do seu app seja exibida.
Clique em qualquer elemento para adicionar um evento do app. Acesse diferentes páginas do app para selecionar os elementos.
Clique em Salvar no menu pop-up. Se não quiser adicionar o evento, clique em Cancelar.
Quando você tiver adicionado todos os eventos, clique em Verificar e concluir.
Clique em Eventos de teste ou Salvar e Sair.

Observação: pode levar até 30 minutos para que os eventos apareçam no Gerenciador de Eventos.

Verificar a integração

Acesse o Auxiliar para Anúncios no Aplicativo.

Selecione um app e clique em Enviar.
Vá para a parte inferior da página e selecione Testador de eventos do app.
Se o app estiver enviando eventos fb_codeless_debug, eles aparecerão na tabela.

Unity

É preciso ter o SDK do Facebook para Unity v4.34 ou uma versão superior.

Consulte este guia de introdução para instalar a versão mais recente do SDK do Facebook para Unity e siga as configurações específicas da plataforma para Unity no iOS ou Unity no Android.

Habilitar eventos do app sem código

Para ativar esta opção, em Unity Editor, selecione Facebook | Edit Settings e depois Auto Logging App Events:

Adicionar eventos do app

Nesta etapa, você pode adicionar eventos do app com o Gerenciador de Eventos:

Em Add Data Source, selecione App Events.
Clique em User our codeless event setup tool.
Selecione o app ao qual você quer adicionar eventos.
Clique em Start Setup para selecionar a sua plataforma. Se for o seu primeiro acesso ao fluxo sem código, você verá um pequeno tutorial.
Depois de conferir o tutorial, abra uma nova sessão do app no seu dispositivo móvel.
Balance o dispositivo móvel até que uma versão do seu app seja exibida.
Clique em qualquer elemento no seu app para adicionar um evento. Acesse diferentes páginas do app para selecionar os elementos.
Em Unity Editor, clique em Save para adicionar o evento.
Depois de adicionar todos os eventos, clique em Review and Finish.
Clique em Test Events ou Save and Exit.

Pode demorar até 30 minutos para que os eventos apareçam no Gerenciador de Eventos. Repita essas etapas para cada plataforma compatível com o seu jogo, como iOS ou Android.

Verificar a integração

Acesse o Auxiliar para Anúncios no Aplicativo.

Em Select an App, clique em Submit.
Escolha App Events Tester.
Se o app enviar eventos fb_codeless_debug, eles aparecerão na tabela.

Perguntas frequentes

GERAL

1. Como posso verificar se o recurso sem código foi integrado corretamente?

Alguns minutos depois de iniciar o seu app no dispositivo de teste, você verá eventos com o nome fb_codeless_debug no Gerenciador de Eventos.

2. Como faço para desativar o recurso sem código?

Para desativar o registro de eventos do app sem código, use a ferramenta de configuração e remova todos os eventos.

Android

1. O que devo fazer quando encontrar o erro de compilação a seguir?

Android SDK build Error:Execution failed for task ':app:processDebugManifest'.> Manifest merger failed : 
Attribute activity#com.facebook.FacebookActivity@theme value=(@android:style/Theme.Translucent.NoTitleBar) 
from AndroidManifest.xml:69:13-72is also present at [com.facebook.android:facebook-android-sdk:4.16.0] 
AndroidManifest.xml:32:13-63 value=(@style/com_facebook_activity_theme).Suggestion: add
'tools:replace="android:theme"' to <activity> element at AndroidManifest.xml:66:9-70:47 to override.

Adicione o seguinte ao elemento manifest no seu arquivo AndroidManifest.xml:

<manifest>
  ...
  xmlns:tools="http://schemas.android.com/tools"
  ...
</manifest>

E o seguinte ao elemento activity:

<activity>
  ...
  tools:replace="android:theme"
  ...
</activity>

iOS

1. O que devo fazer quando encontrar este aviso?

[!] Unable to find a specification for FBSDKMarketingKit

Execute pod update e pod install --repo-update.