Este documento foi atualizado.
A tradução para Português (Brasil) não foi concluída ainda.
Atualização em inglês: 29 de abr de 2022

Perguntas frequentes sobre o Audience Network

Visite a Central de Ajuda do Audience Network para mais orientações e instruções sobre como trabalhar com o Audience Network.

Implementação

Antes de lançar seu aplicativo na loja, é muito importante testar se a integração está funcionando de forma apropriada. Leia nosso guia sobre como testar sua implementação. Você também pode seguir nosso guia de introdução se precisar de ajuda com a integração. Após analisarmos seu aplicativo, você poderá apresentar anúncios de verdade automaticamente.

Para cada solicitação de anúncio, o SDK passará o identificador do dispositivo (IDFA no iOS e número de identificação de publicidade no Android) para o Facebook, para que possamos determinar qual é o anúncio apropriado a exibir. Nenhuma informação sobre a pessoa será passada de volta para o editor juntamente com o anúncio.

No iOS, o SDK do Audience Network pode ser integrado aos aplicativos direcionados ao iOS 9 ou superior.

No Android, o SDK do Audience Network pode ser integrado aos aplicativos direcionados à versão 15 ou superior da API do SDK do Android.

Yes, the Audience Network delivers ads for publishers using Unity within their iOS and Android app. The Unity SDK supports all of the format supported by the iOS and Android SDKs.

Sim, você pode implementar anúncios a partir de uma classe que não seja a de Atividade, desde que a classe tenha uma referência à Atividade contida. Você precisará passar essa Atividade como um parâmetro ao criar instâncias dos anúncios.

Most mediation services have an option to integrate with 3rd party networks using adapters. The following describes the steps needed to setup such integrations:

  1. Add our SDK to your app
  2. Create a Placement ID on the Facebook app settings page. If you use a banner, make sure to select "None" as the refresh interval. The mediation layer will control the automatic refresh.
  3. Add or code the adapter according to your mediation service instructions. These can be either pre-built adapters (see below for Mopub, Admob and DFP) or a custom adapter that you will need to develop.
  4. Configure the adapter name and placement ID in your mediation server UI and allocate impressions to it

See tips for how to get more fill and revenue when using mediation.

Significa que não foi possível exibir anúncios para a pessoa em questão. Isso pode ocorrer por diversos motivos, incluindo os seguintes:

  • O dispositivo móvel dessa pessoa não está conectado ao aplicativo nativo do Facebook.
  • Você solicitou que o Facebook não veiculasse anúncios personalizados via Audience Network. É possível fazer isso por meio da sinalização setAdvertiserTrackingEnabled.
  • O usuário não permitiu que a atividade enviada por outros aplicativos e sites ao Facebook fosse usada para personalizar os anúncios veiculados.
  • Não há inventário de anúncio disponível para exibição ao usuário.

Caso você veja anúncios verdadeiros durante testes feitos de acordo com nosso guia, isso significará que a implementação está funcionando. Dessa forma, os usuários poderão ver anúncios no seu aplicativo quando ele for publicado.

  • Título: 30 caracteres no máximo
  • Imagem da capa: 1.200 x 627 pixels
  • Ícone: 128 pixels quadrados
  • Contexto social: 30 caracteres
  • Título do botão (chamada para ação): menos de 20 caracteres
  • Texto do corpo: 90 caracteres
  • Escala de classificação: 5
  • Classificação mín./máx.: 1/5

Para carregar um novo anúncio, crie uma nova instância do NativeAd.

Yes, ads can be cached and re-used for up to 60 minutes. If you plan to use the ad after this time period, make a call to load a new ad. After this time passes, if the person has not clicked the ad, you must request a new ad.

Após concluir a integração com nosso SDK, você precisará encaminhar o aplicativo para iOS à análise da Apple. Como parte do processo, é necessário informar se o aplicativo usa o IDFA (Identificador de Publicidade da Apple). Selecione “Sim”. Depois, você precisará explicar como seu aplicativo usa o IDFA. A pergunta terá o seguinte formato:

Este aplicativo usa o Identificador de Publicidade para… (selecione todas as opções aplicáveis)

  • exibir anúncios no aplicativo.
  • atribuir a instalação do aplicativo a um anúncio exibido anteriormente.
  • atribuir uma ação realizada no aplicativo a um anúncio exibido anteriormente.

Se você usar a estrutura do Audience Network, será necessário selecionar a primeira opção. Caso use nossa estrutura principal para rastrear atribuições de instalação e eventos do aplicativo, selecione as duas últimas opções. Selecione as três opções se todos os casos de uso se aplicarem à sua situação.

Sim, o SDK do Audience Network para Android usa o número de identificação de publicidade e respeita a opção de limitar o rastreamento de acordo com os termos e condições do Google Play. Recomendamos, mas não é obrigatório, que você configure seu projeto com o Google Play Services. A configuração do seu aplicativo dessa forma resultará em um melhor desempenho técnico ao usar o Audience Network.

1, What is the purpose of this guide?


This guide is intended to help mobile app developers and ad operation personals to validate ad request/response to and from Audience Network in cases such as:

  • Hassles for adding debugging code and investigating mobile device log
  • No clues for missing ad requests or impressions from dashboard
  • Audience Network ad requests are communicated between Audience Network SDK and Audience Network ad server through HTTPS. Testing and confirming ad requests and responses from the HTTPS network activity is the primary and direct step among many other steps.


    2, How to setup Charles Proxy?


    One of the tools to log the ad requests and responses information from the HTTPS is Charles, a web debugging proxy application https://www.charlesproxy.com.

    Charles is an HTTP proxy / HTTP monitor / Reverse Proxy that enables a developer to view all of the HTTP and SSL / HTTPS traffic between their machine and the internet. This includes requests, responses and the HTTP headers (which contain the cookies and caching information).

    It is found that Charles SSL Proxying is very useful and required for viewing all HTTPS ad requests traffic between iOS and Android app and FAN server.

    The SSL Proxying (https://www.charlesproxy.com/documentation/proxying/ssl-proxying/) shows how to setup Charles for iOS and Android device, and host machine running Windows and Mac OS.

    Once SSL Proxying is setup and tested properly, make sure Charles is able to proxy SSL requests and see request/response content.


    3, How to look up ad requests?


    3.1 Setup SSL Proxy for Audience Network

    Update Charles Proxy / SSL Proxying setting by adding Host: “graph.facebook.com” and Port: “8888”, Host: “graph.facebook.com” and Port: “443”.

    3.2 Read SSL Proxy request / response content for Audience Network

    Go to your mobile app and make ad requests, you should see ad request going to FAN server: https://graph.facebook.com/network_ads_common/ and ad response in JSON text form within HTTPS response contents.

    3.3 Confirming ad request sent to and received from Audience Network

    Ad request can be verified if the ad is filled successfully or returned with no fill based on the “code” in the JSON form. “Code” is “0” indicates the request is returned or filled with an ad, “code” is “1001” means no ad is available for the request and app can make another request after passing the specific time limit.

    Below is an example of successful ad response:

    { "type": "ads", "code": 0, "placements": [{ "definition": { "placement_id": "148789268824369_851969285173027", "type": "rewarded_video", "refresh": "0", "refresh_threshold": "-1", "min_viewability_percentage": "1", "viewability_check_ticker": "0", "viewability_check_interval": "100", "viewability_check_initial_delay": "0", "video_time_polling_interval": "200", "cacheable": true, "client_max_retry_count": "1", "invalidation_duration_in_seconds": "3600", "request_timeout": "30000" }, … }

    3.4 Unable to observe an SSL Proxy request for Audience Network

    If no entry point is observed from Charles Proxy for Audience Network end-point (https://graph.facebook.com/network_ads_common/), it should suggest that the primary reason is the mobile app did not make any ad requests to Audience Network server. For this case, re-examining the app integration and app logic is required for mobile developer or ad operation personal.

    4, What is the next step?

    This guide should help you through testing, troubleshooting ad request/response issues with Audience Network.

    If you have further questions on how to use this guide or unanswered questions on ad request/response, please contact our publisher support portal at https://www.facebook.com/business/publishersupport.

    • Token de acesso de usuário do sistema: usado para fazer solicitações às APIs do Facebook em nome de um aplicativo.
    • Identificação do posicionamento: identificador do Audience Network exclusivo de um posicionamento de anúncio específico em seu aplicativo.
    • ID do aplicativo: a identificação do posicionamento é parcialmente composta pelo ID de aplicativo. Por exemplo, na identificação do posicionamento 1234567898765432_9876543212345678, os números antes do sublinhado são o ID do aplicativo.
    • Identificação de propriedade: identificador do Audience Network exclusivo do seu aplicativo. Você pode usar a mesma identificação de propriedade em várias plataformas, como Android e iOS.

    Políticas para publishers

    Para garantir a melhor experiência possível para os usuários do seu aplicativo, siga as Políticas do Audience Network ao integrar seus anúncios.

    Reservamos o direito de rejeitar, aprovar ou remover qualquer editor, seja por qual motivo for, de acordo com nossos próprios critérios, incluindo editores que afetarem de forma negativa nosso relacionamento com as pessoas ou que promovam conteúdos, serviços ou atividades contrários à nossa posição, interesses ou filosofia de publicidade competitiva. Essas diretrizes estão sujeitas a alteração a qualquer momento.

    In order to ensure that our publishers are offering a high quality advertising experience, we require that all apps serving Facebook ads are in compliance with our Audience Network policies.

    All apps in our network will be reviewed by automated systems as well as manually checked for quality and compliance. We will have on-going quality review to ensure continued adherence to our policies and Audience Network design guidelines.

    No Facebook, acreditamos que os anúncios devem contribuir e ser consistentes com a experiência geral do usuário. Assumimos o compromisso de alcançar esse objetivo, tanto no Facebook quanto no Audience Network.

    Todos os anúncios veiculados no Audience Network também podem ser veiculados no Facebook. Isso significa que eles estão sujeitos às estritas políticas de anúncios do Facebook e passam por nosso rigoroso processo de análise proativa e reativa. Em outras palavras, o Facebook oferece aos editores parceiros as mesmas proteções que usamos para nosso próprio site. Nossas políticas de anúncios estão disponíveis aqui. Essas políticas foram desenvolvidas para garantir que os anúncios tenham alta qualidade, sejam seguros para a marca e estejam em conformidade com toda a legislação aplicável.

    Compreendemos que pode haver casos em que você prefira que um determinado anúncio ou tipo de anúncio não seja veiculado no seu aplicativo, independentemente de ele estar ou não em conformidade com as nossas políticas. Como editor parceiro do Audience Network, você poderá filtrar anunciantes específicos ou categorias de anunciantes (por exemplo, anúncios políticos) conforme considerar adequado.

    Saiba como limitar quais anunciantes podem veicular anúncios no seu aplicativo ou site.

    Desempenho

    Os anúncios terão uma aparência muito similar à dos nossos anúncios móveis existentes no Facebook. Clicar em um anúncio levará o usuário para uma loja de aplicativos para baixar um aplicativo, abrirá uma página da Web no navegador ou iniciará um aplicativo existente no celular. Os anúncios serão anúncios em banners, intersticiais e nativos de acordo com os posicionamentos dos anúncios no seu aplicativo. Os anúncios conterão os mesmos elementos presentes em anúncios padrão do Facebook.

    Saiba mais sobre quais anúncios podem ser veiculados no Audience Network e o que acontece quando as pessoas interagem com eles.

    Os editores não receberão uma lista de anunciantes em nenhum momento, nem mesmo nos relatórios para editores. Os anúncios que estão sendo veiculados nos aplicativos do editor serão analisados pelo Facebook e seguirão as diretrizes de publicidade do Facebook.

    Depende, o desempenho variará de acordo com fatores como público, posicionamentos de anúncios e campanhas de anúncios compatíveis com sua base de usuários.

    A sua taxa de preenchimento pode mudar com o tempo, pois a nossa rede está em constante evolução. Muitos fatores, como a demografia da sua base de usuários, a geografia e a demanda dos anunciantes, podem mudar e afetar o número de anúncios que podem ser veiculados no seu aplicativo.

    Se você observar mudanças repentinas na sua taxa de preenchimento, verifique se:

    • Sua implementação está correta
    • Você adicionou todas as suas propriedades móveis (sites e aplicativos móveis) à guia "Aplicativos e sites" e elas foram aprovadas pelo Audience Network.
    • Você não adicionou outros filtros
    • Você está usando o SDK mais recente
    • Você não está enviando solicitações com muita frequência (por exemplo, solicitando um anúncio para o mesmo ID de posicionamento várias vezes em um intervalo de 15 segundos)

    Ad refresh is not supported by Facebook Audience Network. In addition, disableAutoRefresh is deprecated from FBAdView (iOS) and AdView (Android) in the 4.99 release and above.

    Use a guia Filtro na seção Audience Network para excluir os aplicativos cujos anúncios você queira impedir que sejam exibidos no seu aplicativo. Também é possível excluir domínios da Web, se quiser evitar anúncios de certos sites.

    Além do que já mencionamos, o Audience Network automaticamente detecta o aplicativo móvel que você adicionou nas configurações do seu aplicativo do Facebook (developers.facebook.com/apps/[ID_do_APP]>/settings/).

    Observe que, se essa configuração for muito restritiva, isso afetará a veiculação de anúncios e reduzirá a taxa de preenchimento.

    O Facebook tem como objetivo oferecer um valioso retorno sobre o investimento para anunciantes no Audience Network, garantindo que os cliques sejam autênticos e intencionais. Temos uma política de tolerância zero para fraudes de cliques cometidas por editores e baniremos os editores imediatamente se detectarmos uma fraude. Monitoramos cuidadosamente todos os cliques e impressões exibidas no Audience Network para detectar padrões de fraudes de cliques. Não cobraremos os anunciantes nem pagaremos aos editores por cliques que determinarmos como sendo inválidos.

    A taxa de preenchimento é calculada com base no total de anúncios preenchidos nas solicitações qualificáveis totais. Entre os cenários em que uma solicitação não será considerada estão:

    • A solicitação de um anúncio é muito frequente. Por exemplo, se você solicitar um anúncio com a mesmo ID de posicionamento em intervalos de menos de 15 segundos
    • O IDFA (iOS) ou o ID de anúncio (Android) não está disponível ou não pode ser usado para a veiculação do anúncio
    • O Facebook não foi instalado no aplicativo solicitante ou o usuário não se conectou recentemente

    Relatórios

    Adicione os membros da sua equipe como administradores ou como usuários das Informações, para que eles tenham acesso aos relatórios. Para adicionar ou alterar uma atribuição de função, acesse as configurações do aplicativo do Facebook e escolha a seção "Funções".

    Você pode encontrar relatórios acessando a seção "Audience Network" nas Configurações do Aplicativo e selecionando a guia Desempenho. Os relatórios mostram uma visão geral do seu desempenho, bem como detalhes sobre o desempenho em um intervalo de tempo específico. Você também pode analisar seu desempenho por país e por ID de posicionamento.

    Para seu histórico de pagamentos e detalhes de pagamento, acesse a seção "Audience Network" e selecione a guia Pagamento.

    Não divulgaremos informações específicas dos anunciantes nos seus relatórios. Caso queira filtrar um anunciante ou uma categoria de anunciante em especial, acesse a seção "Audience Network" nas Configurações do Aplicativo e selecione a guia Filtro.

    Sim. Leia este guia para saber mais detalhes sobre como ler programaticamente os dados de desempenho do seu aplicativo.

    Como receber pagamentos

    You can set up payments by completing the publisher payout forms. The forms are located under the payout tab in the "Audience Network" section in your app settings page. We require your bank name, SSN/TIN and tax information in order to process your payouts.

    Note: You need to set up your payout information for ad delivery to start.

    Contact us by clicking on "Need Help?" button within Audience Network Dashboard if you are having problems completing the forms.

    For more information see Add Payout Information.

    You will receive payment on approximately the 21st of each month for the previous month's balance. Read our Audience Network Terms for more information.

    Contact us by clicking on "Need Help?" button within Audience Network Dashboard if you do not receive a payment or if you have questions about the payout process.

    Os pagamentos são feitos quando você acumula uma receita de pelo menos US$ 100. Você receberá os pagamentos no dia 21 de cada mês, referentes ao saldo do mês anterior.

    Primeiro, verifique a guia Audience Network/Pagamentos para confirmar se você concluiu o fluxo de pagamento.

    Se tiver problemas relacionados a pagamentos, entre em contato conosco clicando no botão "Precisa de ajuda?" no painel do Audience Network.

    Caso queira alterar qualquer uma das suas informações de pagamento, acesse a seção "Audience Network" nas Configurações do Aplicativo e selecione a guia Pagamento.

    Acreditamos que o Audience Network oferece uma experiência de publicidade que ajudará editores e desenvolvedores a monetizarem seus aplicativos, mas não podemos confirmar um compartilhamento de receita específico no momento. Relatórios em tempo reais e estimativas de pagamentos estão disponíveis na seção "Audience Network" na página de configurações do seu aplicativo.

    Como gerenciar os seus aplicativos

    Para adicionar uma pessoa a uma função de administrador ou desenvolvedor em um aplicativo do Facebook existente, navegue até a guia Funções do Painel de Aplicativos e selecione "Adicionar administradores" ou "Adicionar desenvolvedores".

    Nesta seção

    Informações para aplicativos e serviços direcionados para crianças

    Explica as responsabilidades exigidas pela Lei de Proteção da Privacidade Online das Crianças (COPPA, pelas iniciais em inglês).

    Conformidade com a CCPA

    Descreve como limitar o uso de informações pessoais pelo aplicativo ou site para manter a conformidade com a Lei de Privacidade do Consumidor da Califórnia (CCPA, pelas iniciais em inglês).