Perguntas frequentes

Um app pode criar até 1.000 nomes de eventos únicos. Caso ultrapasse esse limite, você poderá ver um erro 100 Invalid parameter durante o registro.

Se precisar remover eventos obsoletos, desative-os seguindo as instruções na Central de Ajuda.

É comum que os desenvolvedores ultrapassem os limites de eventos quando não usam parâmetros nas situações adequadas, em vez disso registrando eventos individuais. Por exemplo, em vez de registrar um evento separado sempre que alguém conclui um nível (como Nível alcançado 1, Nível alcançado 2 e assim por diante), o desenvolvedor deveria registrar um evento Nível alcançado único com um parâmetro de level para o nível.

An event can have up to 25 parameters. This doesn't just mean for each call, but for all invocations using that event name.

If you need to remove obsolete parameters - you can deactivate parameters by following the instructions in our help center.

Nomes de eventos e de parâmetros devem ter entre 2 e 40 caracteres alfanuméricos.

Cada valor de parâmetro deve ter no máximo 100 caracteres.

Os eventos do app fornecem SDKs para os canais a seguir: iOS, Android, Jogos no Facebooke Unity. Além disso, os eventos do app são compatíveis com a transmissão de eventos de servidor para servidor por meio da Graph API.

Não é preciso implementar o Login do Facebooke nenhum outro recurso de Canal para usar eventos do app.

É possível definir eventos personalizados que você gostaria de capturar e que podem ser exibidos no seu painel do Facebook Analytics . Há compatibilidade com o registro de até 1.000 nomes de eventos personalizados. Não há limite de volume de eventos. No entanto, em Relatórios de Anúncios, exibiremos apenas os eventos-padrão do app. Os eventos personalizados criados por você serão registrados como "Outras ações no app para celular".

Para jogos do Unity, você pode usar o SDK do Unity para registrar eventos do app. Para outros canais que utilizam o modo de exibição da web em um app nativo, uma das opções é usar a API de Eventos do App para transmitir os eventos do seu servidor aos servidores do Facebook.

Normalmente, os desenvolvedores consideram mais fácil usar o SDK do Facebook para integrar os eventos do app. O SDK do Facebook ajuda a reduzir o volume de programação exigido e fornece metadados úteis sobre o app, como a versão e o nome. Ao usar o SDK, você acessa automaticamente e com pouco esforço métricas como tempo gasto, número de sessões e interrupções. O SDK também coleta o ID de publicidade do Android ou o Identificador de Anunciante da Apple (se você estiver usando eventos do app com a atribuição do anúncio) e controla a limitação da publicidade rastreada para você. Entretanto, existe uma limitação para o SDK: se você decidir adicionar eventos extras, será preciso enviar uma nova versão do app. Para a maioria dos desenvolvedores, o SDK é a opção mais adequada.

A API pode ser a melhor solução para desenvolvedores que não querem enviar uma versão atualizada do app para integrar ou adicionar eventos do app. Para desenvolvedores que têm apps da web híbridos, a integração pela API também pode ser mais fácil. Porém, a solução da API exige que você controle por conta própria a limitação da publicidade rastreada, bem como a coleta do Identificador de Anunciante e do identificador de publicidade do Android. Além disso, a API não fornece as métricas de uso do app coletadas automaticamente pelo SDK. Os desenvolvedores que querem rastrear métricas adicionais, como a versão e o nome do app, além do número de sessões e das interrupções, precisarão determinar essas métricas por conta própria e transmiti-las de volta como parâmetros personalizados usando a API.

If you are currently using an MMP to track installs or other actions in your app, you can request that your MMP passes those events server to server to Facebook.

Você pode usar um SDK de MMP e o SDK do Facebook ao mesmo tempo no seu app, mas precisa ter certeza de que não está transmitindo o mesmo evento duas vezes, já que isso pode resultar em uma contagem duplicada.

Sim, você pode fazer isso.

O Auxiliar para Anúncios de Aplicativo permite que você faça testes para verificar se o app está enviando os eventos ao Facebook.

a. Abra o Auxiliar para Anúncios de Aplicativo.

b. Em Selecionar um aplicativo, selecione seu app e clique em Enviar.

c. Vá até a parte inferior da página e escolha Testar evento.

d. Inicie o app e envie um evento. O evento será exibido na página da web.

O Facebook utiliza os dados conforme a nossa Política de Dados. Essas informações podem ser usadas para aprimorar as nossas capacidades de direcionamento e veiculação de anúncios, assim como para melhorar outras experiências no Facebook, incluindo os recursos de classificação do Feed e da pesquisa de conteúdo.

• Esquecer-se de transmitir a moeda ou o valor de uma compra ou de um evento relacionado à compra
• Colocar o decimal no lugar errado
• Usar vírgulas em vez de decimais para um valor numérico
• Programar valores de conversão com base em um palpite sobre o valor "médio" do pedido em vez de transmitir o valor real

Se você estiver registrando um evento personalizado em vez de um padrão, ele aparecerá na opção "Outras ações no app para celular" de Relatórios de Anúncios e não será detalhado.

Sim, é possível criar públicos personalizados usando eventos do app. Para fazer isso, siga estas instruções.

Sim, veiculamos nossos anúncios para as pessoas mais propensas a realizar uma ação específica ao menos uma vez, pelo custo mais baixo. Crie um conjunto de anúncios de instalação de app para celular que otimize para um evento do app específico por meio da API. Isso é semelhante a um conjunto de anúncios comum de instalação de app para celular ou de engajamento com o app para celular, exceto:

Para anúncios de engajamento com o app para celular, otimize para eventos do app padrão, exceto inicialização do app. Essas opções estão disponíveis no Gerenciador de Anúncios e na API. Consulte API de Marketing, Conjunto de anúncios.

Primeiro, verifique se você tem a versão 4.36 (ou superior) do SDK principal do Facebook para Android instalado no app. Depois, acesse Configurações > Básico no painel do app. Nas configurações do Android, defina Registrar automaticamente eventos de compra no app como Sim.

Para versões de 4.27 a 4.35, chame callbackManager.onActivityResult() durante a ativação do app e habilite o registro automático de eventos de compra no app na seção de configurações do Android no painel do app.

First, ensure that you have v3.22 (or higher) of the Facebook iOS SDK installed within your app. Second, ensure that you are calling the ActivateApp method.

1. Acesse Meus apps.
2. Selecione seu app.
3. Clique na aba de configurações no menu de navegação à esquerda.
4. Encontre a seção chamada Android.
5. Defina Registrar automaticamente eventos de compra no app no Android como Sim.

1. Acesse Meus apps.
2. Selecione seu app.
3. Clique na aba de configurações no menu de navegação à esquerda.
4. Encontre a seção chamada iOS.
5. Habilite a opção "Registrar automaticamente eventos de compra no app no iOS".

Ao habilitar o registro de compras no app, os seguintes eventos serão rastreados: Iniciar finalização da compra, Compra e Cancelamento da compra.

A opção automática reduz o tempo necessário para registrar eventos do app com precisão. Isso significa que você não precisará mais coletar manualmente os eventos nem determinar quais parâmetros serão transmitidos. Por exemplo, os parâmetros abaixo são registrados automaticamente: quantidade, valor total, moeda, bem como ID, título e descrição do produto. Além disso, se você estiver usando a versão 3.22 ou posterior, será possível habilitar isso automaticamente sem precisar enviar um cliente atualizado para a App Store.

Caso você já esteja registrando compras no app, não será necessário habilitar esse recurso. No entanto, se você quiser adotar a funcionalidade, será preciso interromper o registro explícito de eventos de compras no app para evitar que seus relatórios exibam contagens duplicadas.

Não, isso só se aplica a compras no app.

We recommend logging all events that are relevant to your app. You can use this best practices guide as a starting point to determine what events would be relevant for your business.

Para desabilitar o registro automático de compras no app, acesse o guia de introdução sobre eventos do app para iOS ou o guia de introdução sobre eventos do app para Android.