Usando o SDK do Facebook e o Singular SDK/S2S no mesmo aplicativo

Documento

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 do Facebook SDK
#

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
  • Trata de todo o rastreamento de atribuição
  • Rastreia eventos in-app
  • Encaminha eventos para o Facebook
  • Fornece análises unificadas

Configuração padrão

Não são necessárias alterações especiais

SDK do Facebook
  • Fornece recursos da plataforma do Facebook
  • Permite iniciar sessão, partilhar, etc.
  • NÃO envia eventos
  • NÃO rastreia a atribuição

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.

iOS - Desativar o registro automático de eventos
#

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

  1. Verifique o Info.plist: Verificar se a chave foi adicionada corretamente com o valor definido para false
  2. Testar compilação: Compilar e executar o aplicativo para garantir que a configuração seja aplicada
  3. 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.

Android - Desativar o registro automático de eventos
#

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:

JAVAKOTLIN
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);
    }
}

Etapas de verificação

  1. Verifique o AndroidManifest: Verificar se os metadados foram adicionados corretamente com o valor definido para false
  2. Compilar aplicativo: Limpar e reconstruir o aplicativo para garantir que a configuração seja aplicada
  3. 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:

  1. 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
  2. Configurar definições de atribuição: Definir janelas de atribuição e preferências de mensuração
  3. Mapear eventos: Configurar o mapeamento de eventos entre Singular e Facebook
  4. 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.

Lista de verificação de validação
#

Validação do SDK da Singular

  1. Console de teste: Use o Console de testedo Singularpara verificar se os eventos foram rastreados corretamente
  2. Logs de eventos: Verifique os Logs de exportação do Singular para confirmar os eventos registrados
  3. 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

  1. Gerenciador de eventos: Abra o Gerenciador de Eventos do Facebook e verifique os eventos que aparecem no Singular
  2. 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
  3. 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

Eventos duplicados no Facebook
#

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

  1. Verifique se FacebookAutoLogAppEventsEnabled está definido como false em iOS Info.plist
  2. Verifique se com.facebook.sdk.AutoLogAppEventsEnabledestá definido como false no Android AndroidManifest.xml
  3. Limpar e reconstruir o aplicativo para garantir que a configuração seja aplicada
  4. Monitorar o Gerenciador de eventos do Facebook por 24 horas para confirmar que o problema foi resolvido
Atribuição do Facebook ausente no Singular
#

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

  1. Navegue até Singular → Atribuição → Configuração de parceiros e procure pelo Facebook
  2. Verifique se o ID do aplicativo do Facebook foi inserido corretamente
  3. Confirmar a integração do Facebook ativada e ativa
  4. Verifique se as configurações da janela de atribuição correspondem aos requisitos da campanha
  5. Reveja o guia de integração de atribuição de anúncios do Facebookpara uma configuração completa
Recursos do Facebook que não estão funcionando
#

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

  1. 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)
  2. Verifique a ID do aplicativo do Facebook e a configuração nas configurações do aplicativo
  3. Revise a documentação do SDK do Facebook para obter requisitos de recursos específicos
  4. 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


Recursos para desenvolvedores do Facebook


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.