Uso do SDK do Facebook e do SDK da Singular/S2S no mesmo aplicativo

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

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
  • Gerencia todo o rastreamento de atribuição
  • Rastreia eventos no aplicativo
  • Encaminha eventos para o Facebook
  • Fornece análise unificada

Configuração padrão

Nenhuma alteração especial necessária

SDK do Facebook
  • Fornece recursos da plataforma do Facebook
  • Habilita login, compartilhamento, etc.
  • NÃO envia eventos
  • NÃO rastreia atribuição

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.

iOS - Desativar o registro automático 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

  1. Verificar Info.plist: Confirmar que a chave foi adicionada corretamente com o valor false
  2. Build de teste: Compilar e executar o aplicativo para garantir que a configuração foi aplicada
  3. 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.

Android - Desativar o registro automático 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 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:

JAVA KOTLIN
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. Verificar AndroidManifest: Confirmar que os metadados foram adicionados corretamente com o valor false
  2. Compilar o aplicativo: Fazer uma build limpa do aplicativo para garantir que a configuração foi aplicada
  3. 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:

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

Lista de verificação de validação

Validação do SDK da Singular

  1. Console de teste: Use o console de teste da Singular para verificar se os eventos estão sendo rastreados corretamente
  2. Registros de eventos: Verifique os registros de exportação da Singular para confirmar que os eventos foram registrados
  3. 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

  1. Gerenciador de eventos: Abra o Gerenciador de eventos do Facebook e verifique se os eventos da Singular estão aparecendo
  2. 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
  3. 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

Eventos duplicados no Facebook

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

  1. Verificar se FacebookAutoLogAppEventsEnabled está definido como false no Info.plist do iOS
  2. Verificar se com.facebook.sdk.AutoLogAppEventsEnabled está definido como false no AndroidManifest.xml do Android
  3. Fazer uma build limpa do aplicativo para garantir que a configuração foi aplicada
  4. Monitorar o Gerenciador de eventos do Facebook por 24 horas para confirmar que o problema foi resolvido
Atribuição do Facebook ausente na Singular

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

  1. Navegar até Singular → Atribuição → Configuração de parceiros e pesquisar pelo Facebook
  2. Verificar se o ID do aplicativo do Facebook foi inserido corretamente
  3. Confirmar que a integração do Facebook está habilitada e ativa
  4. Verificar se as configurações da janela de atribuição correspondem aos requisitos da campanha
  5. Consultar o guia Integração de atribuição de anúncios do Facebook para configuração completa
Recursos do Facebook não funcionam

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

  1. Verificar se o SDK do Facebook foi inicializado corretamente no aplicativo (desativar o registro automático não afeta a inicialização do SDK)
  2. Verificar o ID do aplicativo do Facebook e a configuração nas definições do aplicativo
  3. Consultar a documentação do SDK do Facebook para conhecer os requisitos específicos de cada recurso
  4. 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


Recursos para desenvolvedores do Facebook


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.