Uso do SDK do Facebook e do SDK da Singular no mesmo aplicativo
Guia completo para implementar o SDK do Facebook e o SDK da Singular no mesmo aplicativo, abrangendo requisitos de configuração, considerações sobre precisão de dados e melhores práticas de integração.
Visão geral da integração
Singular como parceiro de medição móvel
Se o SDK da Singular estiver integrado ao aplicativo, o SDK do Facebook não é necessário para rastrear a atribuição do Facebook ou visualizar eventos na plataforma do Facebook. Como parceiro de medição móvel (MMP) certificado pelo Facebook, o SDK da Singular gerencia todos os requisitos de atribuição e rastreamento de eventos.
Capacidades da Singular como MMP:
- Rastreamento de atribuição: Rastreia automaticamente instalações e conversões de campanhas do Facebook
- Encaminhamento de eventos: Envia eventos no aplicativo para o Facebook para otimização de campanhas
- Relatórios de dados: Fornece dados de atribuição unificados em todos os canais, incluindo o Facebook
- Integração certificada: Solução de medição aprovada pelo Facebook com acesso completo à API
Quando usar o SDK do Facebook
Casos de uso válidos
Embora o SDK da Singular gerencie a atribuição e a análise, algumas organizações optam por integrar o SDK do Facebook para acessar recursos específicos do Facebook além da medição.
Recursos sociais
Login com Facebook
Permite que os usuários se autentiquem usando as credenciais do Facebook, simplificando o processo de integração e reduzindo o atrito no cadastro.
Compartilhamento no Facebook
Permite que os usuários compartilhem o conteúdo do aplicativo diretamente no Facebook, aumentando o alcance orgânico e o potencial de crescimento viral.
Recursos avançados de publicidade
Anúncios de instalação de aplicativos móveis do Facebook
Acesse os recursos avançados dos anúncios de instalação de aplicativos móveis do Facebook , incluindo:
- Anúncios dinâmicos de produtos: Redirecione usuários com recomendações de produtos personalizadas
- Audience Network: Estenda campanhas para além da plataforma do Facebook até aplicativos de parceiros
- Custom Audiences: Crie públicos com base nos dados de usuários do Facebook
- Segmentação avançada: Aproveite as opções detalhadas de segmentação do Facebook
Integração com a plataforma do Facebook
Acesso à Graph API
Integre-se com a Graph API do Facebook para ler e gravar dados no grafo social do Facebook.
Integração com o Messenger
Habilite a comunicação pelo Facebook Messenger para suporte ao cliente ou campanhas de engajamento.
Decisão de integração: Integre o SDK do Facebook somente se o seu aplicativo exigir recursos específicos da plataforma do Facebook além da atribuição e da análise. Para fins de medição apenas, o SDK da Singular oferece funcionalidade completa.
Considerações sobre precisão de dados
Ao usar o SDK do Facebook e o SDK da Singular no mesmo aplicativo, é essencial realizar a configuração adequada para manter a precisão dos dados e evitar discrepâncias.
Problemas comuns de dados
Duplicação de eventos
Sem a configuração adequada, os eventos podem ser enviados duas vezes ao Facebook (uma vez pelo SDK do Facebook e uma vez pelo SDK da Singular), causando contagens de eventos infladas e relatórios imprecisos.
Problema crítico: O rastreamento duplicado de eventos causa:
- Contagens de eventos infladas: O Facebook reporta o dobro dos eventos reais, distorcendo as métricas de desempenho das campanhas
- Contagens de sessões incorretas: Os dados de sessão aparecem artificialmente elevados na plataforma do Facebook
- Problemas de otimização de campanhas: O algoritmo do Facebook recebe sinais incorretos para a otimização de campanhas
- Problemas de alocação de orçamento: Dados imprecisos afetam a distribuição do orçamento entre campanhas
Requisitos da solução
Estratégia de configuração
Para manter a precisão dos dados ao usar ambos os SDKs, desative o registro automático de eventos no SDK do Facebook e permita que o SDK da Singular gerencie todas as medições e o encaminhamento de eventos para o Facebook.
Arquitetura de integração:
| Componente | Responsabilidade | Configuração |
|---|---|---|
| SDK da Singular |
|
Configuração padrão Nenhuma alteração especial necessária |
| SDK do Facebook |
|
Desativar o registro automático Evitar o envio duplicado de eventos |
Etapas de implementação
Siga estas etapas para usar o SDK do Facebook junto com o SDK da Singular mantendo a precisão dos dados e evitando a duplicação de eventos.
Etapa 1: Desativar o registro de eventos do SDK do Facebook
Configuração específica por plataforma
Por padrão, o SDK do Facebook envia eventos automaticamente para a plataforma do Facebook. Esse registro automático deve ser desativado para evitar o rastreamento duplicado de eventos.
Método de configuração
Siga as instruções oficiais do Facebook na seção "Desativar eventos registrados automaticamente" em Introdução aos App Events para iOS .
Configuração do Info.plist
Adicione a seguinte chave ao seu arquivo
Info.plist
para desativar o registro automático de eventos:
<key>FacebookAutoLogAppEventsEnabled</key>
<false/>
Etapas de verificação
-
Verificar Info.plist:
Confirmar que a chave foi adicionada corretamente com o valor
false - Build de teste: Compilar e executar o aplicativo para garantir que a configuração foi aplicada
- Monitorar eventos: Verificar que o SDK do Facebook não está enviando eventos usando o painel do Facebook Analytics
Importante: Após desativar o registro automático, o SDK do Facebook não enviará nenhum evento ao Facebook. O SDK da Singular gerenciará todo o encaminhamento de eventos para a plataforma do Facebook.
Método de configuração
Siga as instruções oficiais do Facebook na seção "Desativar eventos registrados automaticamente" em Introdução aos App Events para Android .
Configuração do AndroidManifest.xml
Adicione os seguintes metadados ao seu arquivo
AndroidManifest.xml
dentro da tag
<application>
:
<application>
...
<meta-data
android:name="com.facebook.sdk.AutoLogAppEventsEnabled"
android:value="false" />
...
</application>
Alternativa: Configuração programática
Como alternativa, desative o registro automático de forma programática na sua classe Application:
import com.facebook.FacebookSdk;
import com.facebook.appevents.AppEventsLogger;
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
// Disable automatic event logging
FacebookSdk.setAutoLogAppEventsEnabled(false);
}
}
import com.facebook.FacebookSdk
import com.facebook.appevents.AppEventsLogger
class MyApplication : Application() {
override fun onCreate() {
super.onCreate()
// Disable automatic event logging
FacebookSdk.setAutoLogAppEventsEnabled(false)
}
}
Etapas de verificação
-
Verificar AndroidManifest:
Confirmar que os metadados foram adicionados corretamente com o valor
false - Compilar o aplicativo: Fazer uma build limpa do aplicativo para garantir que a configuração foi aplicada
- Monitorar eventos: Verificar que o SDK do Facebook não está enviando eventos usando o painel do Facebook Analytics
Importante: Escolha a configuração pelo AndroidManifest OU a configuração programática, não ambas. A configuração pelo Manifest é recomendada para maior consistência.
Etapa 2: Configurar a atribuição do Facebook
Configuração do parceiro na Singular
Após desativar o registro de eventos do SDK do Facebook, configure a atribuição do Facebook na plataforma da Singular seguindo os procedimentos padrão de configuração.
Instruções de configuração: Siga as etapas 1 a 4 do guia Integração de atribuição de anúncios do Facebook para concluir a configuração de atribuição do Facebook.
Lista de verificação de configuração:
- Adicionar o ID do aplicativo do Facebook: Na plataforma da Singular, navegue até Atribuição → Configuração de parceiros e adicione o ID do aplicativo do Facebook
- Configurar as definições de atribuição: Defina as janelas de atribuição e as preferências de medição
- Mapear eventos: Configure o mapeamento de eventos entre a Singular e o Facebook
- Habilitar postbacks: Configure postbacks de eventos da Singular para o Facebook para otimização de campanhas
Etapa 3: Validar a configuração
Procedimentos de teste
Após concluir a configuração, valide a implementação correta usando as ferramentas de teste da Singular e do Facebook.
Validação do SDK da Singular
- Console de teste: Use o console de teste da Singular para verificar se os eventos estão sendo rastreados corretamente
- Registros de eventos: Verifique os registros de exportação da Singular para confirmar que os eventos foram registrados
- Verificação de atribuição: Verifique se as instalações do Facebook estão sendo atribuídas corretamente nos relatórios da Singular
Validação na plataforma do Facebook
- Gerenciador de eventos: Abra o Gerenciador de eventos do Facebook e verifique se os eventos da Singular estão aparecendo
- Comparação de contagens de eventos: Compare as contagens de eventos entre a Singular e o Facebook para garantir que não haja duplicação
- Rastreamento de sessões: Verifique se as contagens de sessões correspondem aos valores esperados sem inflação
Verificações de precisão de dados
| Verificação | Resultado esperado |
|---|---|
| Contagens de eventos | Os eventos aparecem apenas uma vez no Facebook (da Singular), sem duplicação |
| Contagens de sessões | O Facebook exibe contagens de sessões normais sem inflação artificial |
| Dados de atribuição | Os relatórios da Singular mostram instalações do Facebook com dados corretos de campanha |
| Recursos do Facebook | O login, o compartilhamento e outros recursos do Facebook funcionam corretamente no aplicativo |
Prazo de validação: Aguarde de 24 a 48 horas após a configuração inicial para que os dados fluam corretamente pelas duas plataformas. Alguns dados podem aparecer com atraso inicialmente.
Solução de problemas
Problemas comuns e soluções ao usar o SDK do Facebook e o SDK da Singular juntos.
Problemas comuns
Sintomas
- As contagens de eventos no Facebook são o dobro dos valores esperados
- O mesmo evento aparece várias vezes com timestamps idênticos
- A otimização de campanhas do Facebook é afetada por métricas infladas
Causa
O registro automático de eventos do SDK do Facebook não está desativado, fazendo com que tanto o SDK do Facebook quanto o SDK da Singular enviem os mesmos eventos para a plataforma do Facebook.
Solução
-
Verificar se
FacebookAutoLogAppEventsEnabledestá definido comofalseno Info.plist do iOS -
Verificar se
com.facebook.sdk.AutoLogAppEventsEnabledestá definido comofalseno AndroidManifest.xml do Android - Fazer uma build limpa do aplicativo para garantir que a configuração foi aplicada
- Monitorar o Gerenciador de eventos do Facebook por 24 horas para confirmar que o problema foi resolvido
Sintomas
- As instalações do Facebook não aparecem nos relatórios da Singular
- As instalações são atribuídas como orgânicas em vez de campanhas do Facebook
- Os dados de campanha estão ausentes na análise da Singular
Causa
O Facebook não está configurado como parceiro de atribuição na plataforma da Singular, ou o ID do aplicativo do Facebook está ausente ou incorreto.
Solução
- Navegar até Singular → Atribuição → Configuração de parceiros e pesquisar pelo Facebook
- Verificar se o ID do aplicativo do Facebook foi inserido corretamente
- Confirmar que a integração do Facebook está habilitada e ativa
- Verificar se as configurações da janela de atribuição correspondem aos requisitos da campanha
- Consultar o guia Integração de atribuição de anúncios do Facebook para configuração completa
Sintomas
- O login com Facebook falha ou retorna erros
- O botão de compartilhamento do Facebook não funciona
- Os recursos do SDK do Facebook não estão disponíveis no aplicativo
Causa
O SDK do Facebook não foi corretamente inicializado ou configurado apesar do registro automático de eventos estar desativado.
Solução
- Verificar se o SDK do Facebook foi inicializado corretamente no aplicativo (desativar o registro automático não afeta a inicialização do SDK)
- Verificar o ID do aplicativo do Facebook e a configuração nas definições do aplicativo
- Consultar a documentação do SDK do Facebook para conhecer os requisitos específicos de cada recurso
- Testar os recursos do Facebook de forma independente para isolar os problemas de integração
Observação: Desativar o registro automático de eventos afeta apenas o rastreamento de eventos, não os recursos da plataforma do Facebook, como login e compartilhamento. Esses recursos devem continuar funcionando normalmente.
Recursos adicionais
Documentação completa para a integração do SDK do Facebook e da Singular.
Links de documentação
Recursos da Singular
- Introdução ao SDK/S2S da Singular - Guia completo de integração do SDK
- Integração de atribuição de anúncios do Facebook - Configuração do parceiro Facebook
- Conector de dados do Facebook - Agregação de dados de custos e campanhas
- Teste da integração do SDK da Singular - Procedimentos de validação e solução de problemas
Recursos para desenvolvedores do Facebook
- App Events do Facebook para iOS - Configuração do SDK do iOS e registro de eventos
- App Events do Facebook para Android - Configuração do SDK do Android e registro de eventos
- Anúncios de instalação de aplicativos móveis do Facebook - Recursos e capacidades avançadas de publicidade
Suporte
Como obter ajuda
Para obter assistência adicional com a integração do SDK do Facebook e da Singular, entre em contato com o suporte da Singular ou consulte seu gerente de sucesso do cliente.