Anúncios do Facebook Integração com a SKAdNetwork

Documento

Resumo da integração

Tratamento de postback deSKAdNetwork N/A
Decodificação devalores de conversão Suportado
Enriquecimento de dados de campanha

Suportado

Devido aos dados serem agregados no nível da campanha, o relatório do Facebook no conjunto de anúncios pode ser parcial.

Quando disponível, a granularidade suportada é:
- Nome da campanha
- ID da campanha
- Nome da subcampanha (nome do conjunto de anúncios)
- ID da subcampanha (ID do conjunto de anúncios)
- Visualização / Cliques
- País
- É modelado (disponível em API e destinos)
- ID da campanha SKAN (disponível em API e destinos)

Observação: o Facebook não compartilha o sinalizador de Redownload da SKAdNetwork com clientes ou MMPs. As instalações SKAN do Facebook nunca aparecerão como redownloads nos relatórios.

Granularidade dos dados da campanha Suportado
Compartilhamento de modelo de conversão Suportado

Perguntas freqüentes e solução de problemas

Solução de problemas

Por que pode haver diferenças nas instalações da SKAdNetwork (SKAN) relatadas entre o Singular e o Facebook?

Pode haver vários motivos para variações nas instalações de SKAN relatadas pelo Singular e pelo Facebook:

  1. Diferentes configurações de atribuição: A Singular considera tanto as conversões de cliques quanto as de visualizações, enquanto o Facebook pode ter como padrão mostrar apenas as conversões de cliques. Para usar as mesmas configurações no Facebook, use as configurações de SKAdNetwork e adicione instalações de visualização e de cliques:
  2. Taxas de atualização de dados: A Singular e o Facebook podem ter frequências de atualização de dados diferentes, levando a discrepâncias temporárias.
  3. Limites de privacidade: Alterações nos limites de privacidade da Apple podem causar a falta de valores de conversão nos dados da SKAdNetwork no Facebook. Podem ser necessários requisitos mínimos de instalação para que os dados sejam devolvidos sem informações nulas.
  4. Diferenças de fuso horário: Os relatórios SKAdNetwork do Facebook usam o fuso horário configurado da conta do Facebook, que pode ser diferente dos relatórios da Singular.
  5. Manuseio de novo download: O Facebook não compartilha o sinalizador de redownload da SKAdNetwork, o que faz com que as instalações da SKAN a partir do Facebook não apareçam como redownloads nos relatórios.
  6. Limitações de campanhas e contas: O Facebook tem limitações em campanhas ativas por aplicativo e contas de anúncios por aplicativo para campanhas da SKAdNetwork, o que pode afetar os dados relatados.
  7. Níveis de agregação de dados: O Facebook agrega dados no nível da campanha, o que pode levar a relatórios parciais no nível do conjunto de anúncios, causando discrepâncias se a granularidade dos dados for diferente.
  8. Diferenças de modelo de conversão: As variações nos modelos de conversão ou nas configurações entre o Singular e o Facebook podem levar a diferenças nas instalações relatadas.
  9. Atrasos nas alterações do modelo de conversão: As alterações nos modelos de conversão no Singular podem não se refletir imediatamente nos relatórios do Facebook, causando discrepâncias de curto prazo.

Considerar esses fatores ao comparar dados entre o Singular e o Facebook ajuda a entender as fontes de quaisquer discrepâncias.

Por que não consigo selecionar "Valor (otimização)" como uma opção para minha campanha SKAN do Facebook?


mceclip0.png

Para que "Valor" seja uma opção selecionável, verifique novamente se seu aplicativo atende aos requisitos do Facebook para otimização de valor. Em particular:

  • Você deve estar usando um modelo de conversão de receita Singular (esquema de configuração). A otimização de valor do Facebook utiliza receitas/compras para otimizar, pelo que é necessário utilizar um modelo de receitas Singular.
  • Ter uma campanha AEO ativa ou recente a otimizar utilizando um modelo de receita para a aplicação, como:
    • O Facebook deve ter recebido pelo menos 15 compras por clique atribuídas com valores de conversão nos últimos 7 dias.
    • O Facebook deve ter recebido pelo menos 2 valores de conversão de compra distintos nos últimos 7 dias.
Nota: Uma aplicação só precisa de cumprir os requisitos de elegibilidade VO do Facebook uma vez.

Para obter mais detalhes, consulte a documentação do Facebook sobre os requisitos de elegibilidade de VO.

Porque é que estou a ver muitos valores de conversão em falta para o Facebook?

O Facebook forneceu a seguinte declaração sobre os aumentos nos valores de conversão em falta transmitidos pela SKAdNetwork para campanhas AEO/VO:

Em maio de 2021, identificámos um problema que afectava as campanhas de App Event Optimization (AEO)/Value Optimization (VO) da SKAdNetwork (SKAN) do iOS 14, que resultou num aumento de conversões nulas nos dados transmitidos.

Com base na investigação conduzida pela nossa equipa de produto, temos a certeza de que isto foi desencadeado como resultado de uma alteração no limite de privacidade da Apple para as campanhas SKAN, o que significa que as campanhas terão de ter um número mínimo de instalações para que os dados sejam devolvidos sem informação nula.

Embora estejamos a trabalhar para implementar mitigações de back-end até ao início de julho, recomendamos aos anunciantes que tomem as seguintes medidas alternativas:

  • Consolidar campanhas para atingir o limite de 128 instalações por dia
  • Aumentar o orçamento para atingir 128 instalações por dia
  • Após as opções 1 e 2, se os custos continuarem a ser artificialmente elevados, mudar a otimização de AEO/VO para MAI pode ajudar a atingir o limite mínimo de instalações
Porque é que não consigo ver os eventos SKAdNetwork do Facebook nos meus relatórios Singular SKAdNetwork?

Certifique-se de que mapeou o seguinte:

  • O evento SDK para um evento do Facebook (em Configuração de parceiro)
  • O evento Singular SKAN para o evento do Facebook (em Configurações > Eventos).

Para obter mais detalhes, consulte Como faço para que os eventos SKAN incluam dados do Facebook?

Por que estou recebendo um erro ao inserir meu "URL MMP" no Gerenciador de eventos do Facebook?

mceclip0.png

  • Verifique se você tem um modelo de conversão ativo configurado no Singular(etapa 2)
  • Verifique se você mapeou todos os eventos na sua configuração de parceiro do Facebook(etapa 3)
  • Verifique se não há espaços ou outros caracteres não seguros para URL no URL do MMP(etapa 4)
  • Verifique se o app_id no URL de acompanhamento de conversões SKAN corresponde ao ID do aplicativo na página Singular Apps.

PERGUNTAS FREQUENTES

Quais modelos de conversão são suportados com os tipos de campanha do Facebook?

mceclip0.png

Gerenciador de anúncios do Facebook - Opções de tipo de campanha

Você pode selecionar diferentes opções de otimização para entrega de anúncios ao criar sua campanha do Facebook. Como essas campanhas são otimizadas em diferentes sinais de aplicativo, nem todos os tipos de campanha são compatíveis com o modelo de conversão Singular.

Abaixo está uma lista de tipos de campanha do Facebook e os modelos de conversão Singular que são compatíveis com eles

Tipo de campanha do Facebook Modelos de conversão Singular suportados
Instalações de aplicativos (MAI) Qualquer tipo de modelo (evento de conversão, engajamento, funil, receita)
Eventos de aplicativo (AEO) Evento de conversão, funil, receita
Valor (VO)
*ver requisitos adicionais
Receita
O que acontece se eu alterar o meu modelo de conversão?

O Facebook puxa o modelo mais recente aproximadamente uma vez por hora. Se alterar o seu modelo de conversão, a Singular colocará em pausa o modelo existente e, em seguida, activará o novo modelo. Devido às limitações da SKAdNetwork, o processo demora até 48 horas e inclui um intervalo de 24 horas durante o qual não são enviados ou registados valores de conversão. Isso também fará com que o Facebook pause suas campanhas automaticamente por 24 horas.

Lembrete: Embora o encorajemos a experimentar diferentes modelos quando começar a utilizar a SKAdNetwork, não recomendamos que mude de modelo regularmente depois disso, devido ao atraso causado de cada vez.

Posso usar o SDK do Facebook ao mesmo tempo que o SDK da Singular?

Só pode ter um SDK a gerir os valores de conversão de SKAdNetwork na mesma aplicação. No entanto, o SDK do Facebook deixará automaticamente de gerir a SKAdNetwork se seguir o passo 4 destas instruções. Portanto, é seguro continuar usando o SDK do Facebook para outros fins enquanto o SDK da Singular gerencia os valores de conversão de SKAdNetwork.

Qual é o fuso horário dos dados da SKAdNetwork do Facebook?

Os dados SKAdNetwork do Facebook são extraídos diretamente da sua API, pelo que os dados dependem do fuso horário configurado da conta do Facebook. Pode encontrar o fuso horário relevante no painel de controlo do Facebook.

Quais são as limitações da conta e da campanha do Facebook com base na SKAdNetwork?

A declaração do Facebook sobre o seu suporte e planos para a SKAdNetwork menciona as seguintes limitações:

  • Um período de medição de 24 horas.
  • Uma conta de anúncios por aplicativo.
  • Máximo de 9 campanhas activas por aplicação.
  • Apenas informações agregadas (sem informações ao nível do utilizador). Os dados agregados estarão disponíveis nos relatórios de SKAdNetwork da Singular.

Além disso, observe que os modelos de evento de conversão, receita e funil da Singular são recomendados para a otimização de campanhas MAI e AEO no Facebook. O modelo de receita da Singular é necessário para a otimização de campanhas VO no Facebook.

Preciso de definir o sinalizador AdvertiserTrackingEnabled (ATE)?

Como parte das atualizações relacionadas ao iOS 14, o Facebook anunciou novas diretrizes para o uso do sinalizador Advertiser Tracking Enabled (ATE) com MMPs. Sua integração com o Singular já implementa esse sinalizador, e nenhuma ação é necessária na implementação do SDK do Singular.

Detalhes da integração

A estrutura SKAdNetwork da Apple permite que as redes de anúncios (e os anunciantes) recebam alguns dados sobre as instalações de aplicações atribuídas à sua campanha sem comprometer a privacidade do utilizador final. Todos os dados sobre a instalação da aplicação e os eventos pós-instalação têm de estar contidos num único número de 0 a 63, denominado valor de conversão.

A solução SKAdNetwork da Singular oferece várias maneiras diferentes de codificar dados no valor de conversão, dependendo se o anunciante está interessado em otimizar a receita, a retenção ou outros KPIs. Cada método de codificação é chamado de modelo de conversão.

As campanhas de instalação do Facebook, de otimização de eventos de aplicações e de otimização de valores na SKAdNetwork são suportadas através de modelos de conversão, a que o Facebook chama "esquemas de configuração". Seguindo as etapas deste artigo, você poderá "Importar" seu modelo de conversão Singular para um "esquema de configuração" do Facebook, para que o Facebook possa otimizar em relação à SKAdNetwork.

Depois de importar com sucesso um "configuration schema", será possível iniciar campanhas habilitadas para SKAdnetwork com o Facebook, e os dados de desempenho resultantes estarão disponíveis através do seu conetor de dados do Facebook existente.

Veja também: O artigo do Facebook sobre considerações para o iOS 14 e a medição da SKAdNetwork.

Observação: o Facebook não encaminha postbacks de SKAdNetwork e, como resultado, os dados de postback não estão disponíveis em Destinos de dados (ETL) ou Logs de nível de usuário da Singular.

Instruções de configuração

1. Implementar a solução SKAdNetwork da Singular

Se ainda não tiver feito isso, adicione o suporte a SKAdNetwork à sua implementação do SDK da Singular (consulte SDK do iOS: adicionando suporte a SKAdNetwork) ou integração S2S (consulte Guia de implementação de SKAdNetwork S2S).

Lembrete: Você só pode ter um SDK gerenciando valores de conversão de SKAdNetwork no mesmo aplicativo. O SDK do Facebook deixará automaticamente de gerir a SKAdNetwork se seguir o passo 4 destas instruções. No entanto, deve certificar-se de que quaisquer outros SDKs na sua aplicação não estão a gerir SKAdNetwork e a interferir com a implementação do seu modelo de conversão Singular.

2. Configurar um modelo de conversão

Na plataforma Singular, vá para SKAdNetwork > Model Configuration e selecione Add Conversion Model. Selecione um modelo de conversão Singular para a sua aplicação. Certos tipos de campanha do Facebook exigem modelos de conversão específicos. Para obter mais informações, consulte Quais modelos de conversão são compatíveis com os tipos de campanha do Facebook?

Importante: O Facebook exige que todas as conversões mensuráveis ocorram dentro de 24 horas após a instalação, independentemente do tipo de campanha. Certifique-se de definir o período de medição do modelo de conversão Singular para 1 dia.

mceclip0.png

3. Mapear eventos do modelo de conversão para eventos do Facebook

Se você estiver usando um modelo de conversão Singular para SKAdNetwork, certifique-se de que todos os eventos definidos no modelo de conversão sejam mapeados para um evento do Facebook em Attribution > Partner Configuration.

Essa etapa é necessária para que o modelo de conversão Singular apareça no painel de esquema de conversão do Facebook. Os eventos não mapeados não serão exibidos ou usados na otimização ou nos relatórios de campanha do Facebook.

mceclip1.png

Importante:

  • Em Configuração de parceiro, não mapeie eventos SDK para "(Usar nome do evento SDK)". Sempre use um evento padrão do Facebook.
  • Essa etapa não é necessária para um modelo de conversão de receita.

4. Importar modelo de conversão no Gerenciador de eventos do Facebook

Vá para o painel do Gerenciador de eventos do Facebook e siga as instruções abaixo (para obter orientações adicionais, consulte a documentação do Gerenciador de eventos do Facebook).

  • Vá para a configuração de eventos SKAdNetwork do Facebook Event Manager.
  • Selecione Definições > Configurar eventos.

mceclip3.png

  • Selecione Importar da aplicação do parceiro. Se a opção "Importar" não estiver disponível para seleção, é possível que o Facebook não tenha recebido anteriormente eventos de aplicações para a sua aplicação. Para ativar esta opção, certifique-se de que a sua configuração de parceiro do Facebook está activada e que o Facebook recebeu alguns eventos.

mceclip2.png

  • Na tela a seguir, o Facebook solicitará que você insira uma URL de MMP. Construa o seguinte URL e insira a ID da App Store do seu aplicativo no parâmetro app_id:

    https://api.singular.net/api/skadnetwork/conversion_info?org_type=partner&app_id=[your_app_id]

    Por exemplo:

    https://api.singular.net/api/skadnetwork/conversion_info?org_type=partner&app_id=1441750662
  • Depois de importares o(s) teu(s) modelo(s) de conversão Singular, poderás visualizá-los no ecrã seguinte.

Nota: Se tiveres importado um modelo do tipo Eventos, o Facebook pede-te para escolheres um dos eventos para fins de otimização.

image.png