Usando o Facebook SDK com o Singular SDK
Guia abrangente para implementar o Facebook SDK e o Singular SDK no mesmo aplicativo, abrangendo requisitos de configuração, considerações sobre precisão de dados e práticas recomendadas de integração.
Visão geral da integração
Singular como parceiro de medição móvel
Se o SDK da Singular estiver integrado no aplicativo, o SDK do Facebook não será necessário para rastrear a atribuição do Facebook ou visualizar eventos na plataforma do Facebook. Como Mobile Measurement Partner (MMP) certificado do Facebook, o Singular SDK lida com todos os requisitos de atribuição e rastreamento de eventos.
Capacidades do Singular MMP:
- Rastreamento de atribuição: Rastreia automaticamente instalações e conversões de campanhas do Facebook
- Encaminhamento de eventos: Envia eventos in-app para o Facebook para otimização da campanha
- 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 total à API
Quando usar o SDK do Facebook
Casos de uso válidos
Embora o Singular SDK lide com a atribuição e a análise, algumas organizações optam por integrar o Facebook SDK para obter recursos adicionais específicos do Facebook além da mensuração.
Recursos sociais
Login do Facebook
Permite que os usuários se autentiquem usando as credenciais do Facebook, simplificando a integração e reduzindo o atrito do registro.
Partilha do Facebook
Permitir que os utilizadores partilhem o conteúdo da aplicação 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
Aceda às capacidades avançadas dos Anúncios de instalação de aplicações para telemóvel do Facebook, incluindo:
- Anúncios dinâmicos de produtos: Redirecionar utilizadores com recomendações de produtos personalizadas
- Rede de público-alvo: Estenda campanhas além da plataforma do Facebook para aplicativos de parceiros
- Públicos personalizados: Criar públicos com base nos dados do utilizador do Facebook
- Segmentação avançada: Tire partido das opções de segmentação detalhadas do Facebook
Integração com a plataforma do Facebook
Acesso à API do gráfico
Integre-se à API do Facebook Graph para ler e gravar dados no gráfico social do Facebook.
Integração com o Messenger
Permita a comunicação através do Facebook Messenger para suporte ao cliente ou campanhas de envolvimento.
Decisão de integração: Integre o SDK do Facebook apenas se o seu aplicativo exigir recursos específicos da plataforma do Facebook além da atribuição e da análise. Apenas para fins de medição, o Singular SDK fornece a funcionalidade completa.
Considerações sobre a precisão dos dados
Ao usar o Facebook SDK e o Singular SDK no mesmo aplicativo, a configuração adequada é essencial 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 para o Facebook (uma vez do SDK do Facebook e uma vez do SDK do Singular), causando contagens de eventos infladas e relatórios imprecisos.
Problema crítico: O rastreamento duplicado de eventos leva a:
- Contagens de eventos inflacionadas: O Facebook relata o dobro de eventos reais, distorcendo as métricas de desempenho da campanha
- Contagens de sessão incorretas: Os dados da sessão aparecem artificialmente altos na plataforma do Facebook
- Problemas de otimização da campanha: O algoritmo do Facebook recebe sinais incorrectos para a otimização da campanha
- Problemas de alocação de orçamento: Dados imprecisos afetam a distribuição de orçamento entre as campanhas
Requisitos da solução
Estratégia de configuração
Para manter a precisão dos dados ao usar os dois SDKs, desative o registro automático de eventos no SDK do Facebook e permita que o SDK da Singular cuide de todas as medições e encaminhamento de eventos para o Facebook.
Arquitetura de integração:
| Componente | Responsabilidade | Configuração |
|---|---|---|
| SDK singular |
|
Configuração padrão Não são necessárias alterações especiais |
| SDK do Facebook |
|
Desativar o registo automático Evita o envio de eventos duplicados |
Etapas de implementação
Siga estas etapas para usar o Facebook SDK junto com o Singular SDK, mantendo a precisão dos dados e evitando a duplicação de eventos.
Etapa 1: Desativar o registro de eventos do Facebook SDK
Configuração específica da plataforma
Por padrão, o Facebook SDK envia automaticamente eventos para a plataforma do Facebook. Esse registro automático deve ser desativado para evitar o rastreamento de eventos duplicados.
Método de configuração
Siga as instruções oficiais do Facebook em "Desativar eventos registrados automaticamente" em Introdução aos eventos de aplicativo para iOS.
Configuração de Info.plist
Adicione a seguinte chave ao seu ficheiro Info.plist para desativar o registo automático de eventos:
<key>FacebookAutoLogAppEventsEnabled</key>
<false/>
Passos de verificação
-
Verifique o Info.plist: Verificar se a chave foi adicionada corretamente com o valor definido para
false - Testar compilação: Compilar e executar o aplicativo para garantir que a configuração seja aplicada
- Monitorar eventos: Verifique se o Facebook SDK 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 para o Facebook. O Singular SDK cuidará de todo o encaminhamento de eventos para a plataforma do Facebook.
Método de configuração
Siga as instruções oficiais do Facebook em "Desativar eventos registrados automaticamente" em Introdução aos eventos de aplicativo para Android.
Configuração de AndroidManifest.xml
Adicione os seguintes metadados ao seu arquivo AndroidManifest.xmldentro da tag <application>:
<application>
...
<meta-data
android:name="com.facebook.sdk.AutoLogAppEventsEnabled"
android:value="false" />
...
</application>
Alternative: Configuração programática
Em alternativa, desactive o registo automático de forma programática na sua classe de aplicação:
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
-
Verifique o AndroidManifest: Verificar se os metadados foram adicionados corretamente com o valor definido para
false - Compilar aplicativo: Limpar e reconstruir o aplicativo para garantir que a configuração seja aplicada
- Monitorar eventos: Verifique se o SDK do Facebook não está enviando eventos usando o painel do Facebook Analytics
Importante: escolha a configuração AndroidManifest OU a configuração programática, não ambas. A configuração do manifesto é recomendada para consistência.
Etapa 2: configurar a atribuição do Facebook
Configuração de parceiro único
Depois de desativar o log de eventos do SDK do Facebook, configure a atribuição do Facebook na plataforma Singular seguindo os procedimentos de configuração padrão.
Instruções de configuração: Siga as etapas de 1 a 4 no guia de integração de atribuição de anúncios do Facebookpara concluir a configuração de atribuição do Facebook.
Lista de verificação de configuração:
- Adicionar ID do aplicativo do Facebook: Na plataforma Singular, navegue até Atribuição → Configuração de parceiros e adicione o ID do aplicativo do Facebook
- Configurar definições de atribuição: Definir janelas de atribuição e preferências de mensuração
- Mapear eventos: Configurar o mapeamento de eventos entre Singular e Facebook
- Habilitar postbacks: Configurar postbacks de eventos do Singular para o Facebook para otimização da campanha
Etapa 3: Validar a configuração
Procedimentos de teste
Após concluir a configuração, valide a implementação adequada usando as ferramentas de teste do Singular e do Facebook.
Validação do SDK da Singular
- Console de teste: Use o Console de testedo Singularpara verificar se os eventos foram rastreados corretamente
- Logs de eventos: Verifique os Logs de exportação do Singular para confirmar os eventos registrados
- Verificação de atribuição: Verifique se as instalações do Facebook foram atribuídas corretamente nos relatórios do Singular
Validação da plataforma do Facebook
- Gerenciador de eventos: Abra o Gerenciador de Eventos do Facebook e verifique os eventos que aparecem no Singular
- Comparação de contagem de eventos: Comparar as contagens de eventos entre o Singular e o Facebook para garantir que não haja duplicação
- Rastreamento de sessão: Verificar se as contagens de sessões correspondem aos valores esperados sem inflação
Verificações de precisão de dados
| Verificar | Resultado esperado |
|---|---|
| Contagem de eventos | Os eventos aparecem apenas uma vez no Facebook (do Singular), não são duplicados |
| Contagens de sessões | O Facebook mostra contagens de sessão normais sem inflação artificial |
| Dados de atribuição | Os relatórios do Singular mostram as instalações do Facebook com dados de campanha corretos |
| Recursos do Facebook | Login do Facebook, Compartilhar e outros recursos funcionam corretamente no aplicativo |
Linha do tempo de validação: Aguarde de 24 a 48 horas após a configuração inicial para que os dados fluam corretamente em ambas as plataformas. Alguns dados podem parecer atrasados inicialmente.
Resolução de problemas
Problemas e soluções comuns ao usar o Facebook SDK e o Singular SDK juntos.
Problemas comuns
Sintomas
- As contagens de eventos no Facebook duplicam os valores esperados
- O mesmo evento aparece várias vezes com carimbos de data/hora idênticos
- Otimização da campanha do Facebook afetada por métricas inflacionadas
Causa
O registo automático de eventos do Facebook SDK não está desativado, fazendo com que o Facebook SDK e o Singular SDK enviem os mesmos eventos para a plataforma do Facebook.
Solução
-
Verifique se
FacebookAutoLogAppEventsEnabledestá definido comofalseem iOS Info.plist -
Verifique se
com.facebook.sdk.AutoLogAppEventsEnabledestá definido comofalseno Android AndroidManifest.xml - Limpar e reconstruir o aplicativo para garantir que a configuração seja 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 do Singular
- Instalações atribuídas a campanhas orgânicas em vez de campanhas do Facebook
- Dados de campanha ausentes na análise do Singular
Causa
Facebook não configurado como parceiro de atribuição na plataforma Singular ou ID do aplicativo do Facebook ausente/incorreto.
Solução
- Navegue até Singular → Atribuição → Configuração de parceiros e procure pelo Facebook
- Verifique se o ID do aplicativo do Facebook foi inserido corretamente
- Confirmar a integração do Facebook ativada e ativa
- Verifique se as configurações da janela de atribuição correspondem aos requisitos da campanha
- Reveja o guia de integração de atribuição de anúncios do Facebookpara uma configuração completa
Sintomas
- O login do Facebook falha ou retorna erros
- O botão Partilhar do Facebook não funciona
- Recursos do SDK do Facebook indisponíveis no aplicativo
Causa
O SDK do Facebook não foi inicializado ou configurado corretamente, apesar de o registo automático de eventos estar desativado.
Solução
- Verifique se o SDK do Facebook foi inicializado corretamente no aplicativo (a desativação do registro automático não afeta a inicialização do SDK)
- Verifique a ID do aplicativo do Facebook e a configuração nas configurações do aplicativo
- Revise a documentação do SDK do Facebook para obter requisitos de recursos específicos
- Teste os recursos do Facebook de forma independente para isolar problemas de integração
Nota: A desativação do 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 Facebook e do SDK da Singular.
Links de documentação
Recursos do Singular
- Introdução ao Singular SDK/S2S- Guia completo de integração do SDK
- Integração de atribuição de anúncios do Facebook- Configuração de parceiro do Facebook
- Conector de dados do Facebook- Agregação de dados de custo e campanha
- Testando a integração do Singular SDK- Procedimentos de validação e solução de problemas
Recursos para desenvolvedores do Facebook
- Eventos de aplicativo do Facebook para iOS- Configuração do SDK do iOS e registro de eventos
- Eventos de aplicativo 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
Obtendo ajuda
Para obter assistência adicional com a integração do Facebook e do SDK da Singular, entre em contato com o Suporte da Singular ou consulte seu Gerente de sucesso do cliente.