Como testar a implementação do Audience Network

Quando você estiver integrando o Audience Network do Facebook em seu site ou aplicativo móvel, deverá testar a implementação em dispositivos reais com anúncios reais antes de iniciar a produção. Use os SDKs mais recentes do Audience Network em sua integração para incluir as últimas correções e melhorias. As seções a seguir fornecem orientações sobre como testar seu aplicativo e site da web.

Durante a execução em um simulador do iOS ou Android, os anúncios de teste podem ser exibidos ativando o modo de teste e especificando a id convertida em hash do dispositivo. Essa é uma boa primeira etapa para testar a implementação. Também recomendamos testar em dispositivos reais com anúncios reais de acordo com as orientações abaixo.

1. Como testar com anúncios reais

2. Códigos de arro de solicitações de anúncios reais

3. Como testar com anúncios de teste

Testar solicitações com o Depurador de Solicitações do Audience Network

Após implementar os posicionamentos no aplicativo, você pode usar a ferramenta Depurador de Solicitações do Audience Network para verificar se o Facebook está recebendo as solicitações dele.

Na seção Audience Network do painel do desenvolvedor: https://developers.facebook.com/apps/<your_app_id>/audience-network/

Vá para a seção "aplicativos" no painel esquerdo em "Audience Network" e role a tela para baixo para ver "Depurador de Solicitações do Audience Network". Clique no botão Start, e a própria ferramenta começará a monitorar as solicitações do seu aplicativo.

No seu dispositivo de teste Android ou iOS, navegue no aplicativo para disparar posicionamentos de anúncios do Audience Network, e as solicitações de anúncios aparecerão na ferramenta. Verifique se as solicitações são enviadas com a identificação do posicionamento, o nome do pacote etc. corretos.

Isso exige um dispositivo físico e não funcionará no simulador do iOS ou no emulador do Android.

Você precisa estar conectado ao aplicativo do Facebook no mesmo dispositivo de teste que usa para ser monitorado pela ferramenta.

Quando as solicitações de anúncios não aparecem na ferramenta, isso significa que o Facebook não está recebendo as solicitações conforme o esperado. Para depurar, verifique se:

  1. você está em um dispositivo físico, não simulador/emulador;
  2. o aplicativo do Facebook está instalado no dispositivo de teste;
  3. você está conectado ao Facebook no dispositivo de teste com um usuário que é administrador, desenvolvedor ou testador no aplicativo Audience Network do Facebook;
  4. a camada de mediação está enviando solicitações para o Audience Network do Facebook, se estiver usando mediação.

Como testar com anúncios reais

O teste com anúncios reais é um processo em duas etapas. A primeira etapa é adicionar testadores às configurações do aplicativo para permitir que eles vejam anúncios reais antes da aprovação do aplicativo. A segunda etapa para esses testadores é usar o aplicativo ou site móvel quando conectados ao Facebook. Aqui estão os detalhes de como executar ambas as etapas.

Como adicionar testadores ao seu aplicativo

Você pode testar o aplicativo ou site móvel em dispositivos reais com anúncios reais, assegurando-se de que a pessoa responsável pelo teste seja adicionada ao aplicativo do Facebook em qualquer função. Este é o método recomendado para adicionar testadores ao aplicativo:

  1. Acesse o painel de aplicativos e clique na guia Funções à esquerda.
  2. Na seção Testadores, clique no botão Adicionar testadores. Os usuários também podem ter as funções Administradores ou Desenvolvedores. Recomendamos a função de testadores para usuários que precisam testar o aplicativo ou site, mas não podem ver as configurações do aplicativo ou site no Facebook.
  3. Digite o nome, fbid ou nome de usuário da pessoa que você quer adicionar como testador e clique em Enviar. Você pode incluir várias pessoas aqui.
  4. Agora, você deve ver as pessoas que inseriu como testadores.

Se você estiver usando uma camada de mediação, verifique se essa camada está enviando solicitações ao Audience Network. Se o teste estiver ativado na camada de mediação, talvez não esteja enviando solicitações aos nossos servidores.

Como testar os aplicativos móveis

  1. Distribua o aplicativo aos dispositivos dos testadores usando seu método favorito.
  2. Cada um dos testadores adicionados precisa ter o aplicativo do Facebook instalado em seu dispositivo e estar conectado utilizando o ID de usuário do Facebook que você adicionou à função Testadores. Isso é necessário porque o Facebook precisa reconhecer o usuário como um testador no aplicativo para retornar um anúncio, independentemente do status de análise do aplicativo.
  3. Agora, o testador pode iniciar o aplicativo e realizar as etapas necessárias para acionar os posicionamentos que você deseja testar. Um anúncio real deve ser exibido.

Durante o teste com posicionamentos de anúncios, o Facebook enviará intencionalmente um não preenchimento para cerca de 20% das solicitações, para permitir que você teste como o aplicativo ou site móvel lida com o caso de não preenchimento.

Códigos de arro de solicitações de anúncios reais

Durante o teste da implementação do Audience Network do Facebook, é possível receber um de vários códigos de erro possíveis ao fazer uma solicitação. Esses códigos de erro são descritos abaixo.

1000 - Network Error

Resposta do servidor Documentação do SDK

Code=1000 “Network Error"

  • Error 1000 - Network Error. O SDK do Audience Network não pôde acessar o facebook.com (http://facebook.com/)
  • Seu aplicativo deve tentar fazer outra solicitação até a rede ser acessada. Recomendamos criar solicitações incrementais até uma conexão ser restabelecida ou você declarar um tempo limite.

1001 - No Fill

Este é um erro comum observado durante o teste e está relacionado a uma resposta de "No Fill"; o motivo mais comum para ele é o usuário não estar conectado ao aplicativo do Facebook ao testar seu aplicativo móvel ou não estar conectado ao site móvel do Facebook ao testar seu site móvel.

Resposta do servidor Documentação do SDK

Code=1001 “No Fill”

  • Error 1001 - No Fill. Pode ocorrer devido a um ou mais destes motivos:
  • O usuário não está conectado ao aplicativo nativo do Facebook no dispositivo móvel
  • Rastreamento do limite de anúncio ativado (iOS)
  • Cancelamento do recebimento de anúncios com base em interesses ativado (Android)
  • Não há inventário de anúncio para o usuário atual
  • Seu dispositivo de teste deve ter o aplicativo nativo do Facebook instalado.
  • Seu aplicativo deve tentar fazer outra solicitação depois de 30 segundos.

1002 - Ad Load Too Frequently

Resposta do servidor Documentação do SDK

Code=1002 “Load Too Frequently”

  • As solicitações de anúncio se baseiam em uma combinação de:
  • ID do dispositivo
  • ID de posicionamento
  • Formato de exibição (banner, intersticial, nativo)
  • Seu aplicativo deve tentar fazer outra solicitação depois de 30 minutos. Também sugerimos ajustar sua taxa de atualização ou taxa de solicitação.

1203 - Not An App Admin, Developer or Tester

Resposta do servidor Documentação do SDK

Code=1203 “Not An App Admin, Developer or Tester”

  • A solicitação inicial de um pacote deve vir de um testador, desenvolvedor ou administrador do aplicativo.

2000 - Server Error

Resposta do servidor Documentação do SDK

Code=2000 “Server Error"

  • Error 2000 - Server Error. Possivelmente se deve ao seguinte:
  • ID de posicionamento inválido - Cada posicionamento e tipo tem uma identificação exclusiva
  • Versão sem suporte ou desatualizada do SDK - faça download da versão mais recente ou atualize seu Pod se estiver usando Cocoa Pods
  • Chamada/uso incorreto do método loadAd. Sugerimos posicionar os pontos de interrupção em loadAd e qualquer callback/método associado
  • Seu aplicativo deve tentar fazer outra solicitação depois de 30 segundos.

2001 - Internal Error

Resposta do servidor Documentação do SDK

Code=2001 “Internal Error”

  • Error 2001 - Internal Error. O SDK do Audience Network não pôde processar uma resposta de facebook.com
  • Seu aplicativo deve tentar fazer outra solicitação depois de 30 segundos.
  • Se isso acontecer consistentemente, envie-nos um relatório de erro.

Como testar com anúncios de teste

Você deve assegurar que o usuário testando seu aplicativo seja adicionado a uma função no seu painel de aplicativos no Facebook. Este é o método de teste recomendado, pois permite a leitura de anúncios reais em dispositivos reais. Consulte a seção Como testar com anúncios reais para obter mais informações sobre o método de teste recomendado.

No entanto, conforme mencionado na seção anterior, você pode perceber que nem sempre é possível testar a aparência de anúncios reais sem as visualizações de IU do seu aplicativo. Além disso, não é possível garantir que o anúncio recebido pelo seu aplicativo será um anúncio de imagem, de vídeo ou em carrossel. A solicitação de anúncios reais não garantirá que o conteúdo e o formato do anúncio sejam retornados. E se você quiser fazer o teste com um anúncio que tenha um conteúdo de vídeo em retrato para garantir que ele ficará correto na visualização da IU do seu aplicativo?

Para solicitar um anúncio de teste, você usará a seguinte cadeia de caracteres do tipo de anúncio de teste para concatenar o ID de posicionamento com "#" ao inicializar qualquer objeto de anúncio do Facebook. O modelo do ID de posicionamento para solicitar os anúncios de teste é TIPO__DE_ANÚNCIO_DE_TESTE#SEU_ID__DE_POSICIONAMENTO.

Tabela dos tipos de anúncio de teste

Tipo de anúncio de teste Descrição Formato de anúncio suportado

IMG_16_9_APP_INSTALL

Anúncio de imagem 16x9 com opção de CTA de instalação do aplicativo

Banner, Intersticial, Nativo

IMG_16_9_LINK

Anúncio de imagem 16x9 com opção de CTA de link

Banner, Intersticial, Nativo

VID_HD_16_9_46S_APP_INSTALL

Anúncio de vídeo 16x9 em HD de 46 segundos com opção de CTA de instalação do aplicativo

Intersticial, Nativo

VID_HD_16_9_46S_LINK

Anúncio de vídeo 16x9 em HD de 46 segundos com opção de CTA de link

Intersticial, Nativo

VID_HD_16_9_15S_APP_INSTALL

Anúncio de vídeo 16x9 em HD de 15 segundos com opção de CTA de instalação do aplicativo

Intersticial, Nativo

VID_HD_16_9_15S_LINK

Anúncio de vídeo 16x9 em HD de 15 segundos com opção de CTA de link

Intersticial, Nativo

VID_HD_9_16_39S_APP_INSTALL

Anúncio de vídeo 9x16 em HD de 39 segundos com opção de CTA de instalação do aplicativo

Intersticial, Nativo

VID_HD_9_16_39S_LINK

Anúncio de vídeo 9x16 em HD de 39 segundos com opção de CTA de link

Intersticial, Nativo

CAROUSEL_IMG_SQUARE_APP_INSTALL

Anúncio em carrossel com imagem no formato quadrado e opção de CTA de instalação do aplicativo

Intersticial, Nativo

CAROUSEL_IMG_SQUARE_LINK

Anúncio em carrossel com imagem no formato quadrado e opção de CTA de link

Intersticial, Nativo

Exemplo para solicitar anúncios de teste no código em dispositivos iOS

Ao usar o Testflight para distribuir e testar seu aplicativo, você não verá anúncios reais nessas compilações de teste. Em vez disso, terá que configurar o modo de teste como mostrado abaixo para obter anúncios do Audience Network. Toda vez que um aplicativo distribuído pelo Testflight solicitar o Identificador de Publicidade (IDFA), obterá um IDFA diferente. Normalmente, o IDFA permanece constante para um dispositivo até um usuário redefini-lo de forma manual. No entanto, quando uma compilação do Testflight solicita o IDFA do sistema operacional, não obtém o IDFA "real". Em vez disso, obtém um IDFA "fictício", que é alterado toda vez que o aplicativo o solicita.

Para solucionar esse problema, você pode ativar o modo de teste para permitir a exibição do anúncio de teste.

Por exemplo, para solicitar um anúncio de teste de vídeo com uma taxa de proporção de 9:16 e um botão CTA de instalação do aplicativo em seu aplicativo iOS, você precisará inicializar um objeto FBNativeAd adicionando a seguinte linha de código:

[FBNativeAd *nativeAd = [[FBNativeAd alloc] initWithPlacementID:@"VID_HD_9_16_39S_APP_INSTALL#YOUR_PLACEMENT_ID"];

É possível executar o código acima para solicitar um anúncio de teste no projeto NativeAdSample na pasta de exemplo do SDK do Audience Network.

Como alternativa, se você precisar solicitar anúncios de teste com um formato de conteúdo aleatório, poderá adicionar a seguinte linha de código antes de carregar a solicitação de anúncio:

#ifdef DEBUG
[FBAdSettings setLogLevel:FBAdLogLevelLog];
[FBAdSettings addTestDevice:@"HASHED_ID"];
#endif

Você deverá ver a seguinte mensagem de log:

[FBAudienceNetworkLog/FBAdSettings:94] 
When testing your app with Facebook ad units,  
you must specify the device hashed ID to ensure the delivery of test ads, 
add the following code before loading an ad: `[FBAdSettings addTestDevice:@"HASHED_ID"]`
Test mode device hash: bd675f960298a92003630d76fa612b1706b745ab

Substitua HASHED_ID pelo hash do dispositivo de modo de teste impresso no log acima.

Nunca disponibilize seu aplicativo ao público com o código de teste acima, pois ele fará com que apenas anúncios de teste sejam exibidos. Em vez disso, use uma macro de pré-processador, como DEBUG ou TESTING, depois use #ifdef para distinguir uma compilação de teste de uma compilação da versão.

Após a conclusão dos testes, apague a configuração do dispositivo de teste usando esta linha de código:

[FBAdSettings clearTestDevice:[FBAdSettings testDeviceHash]]; 

Exemplo para solicitar anúncios de teste no código em dispositivos Android

Para solicitar um anúncio de teste de vídeo com uma taxa de proporção de 9:16 e um botão CTA de instalação do aplicativo em seu aplicativo Android, você precisará inicializar um objeto NativeAd adicionando a seguinte linha de código:

nativeAd = new NativeAd(this, "VID_HD_9_16_39S_APP_INSTALL#YOUR_PLACEMENT_ID");

Como alternativa, se você precisar solicitar anúncios de teste com um formato de conteúdo aleatório, verá uma mensagem como esta impressa no Logcat ao testar em um dispositivo Android real:

Registro: hash do dispositivo no modo de teste: ID_HASH Registro: Ao testar seu aplicativo com as unidades de anúncio do Facebook, você deve especificar o ID em hash do dispositivo para assegurar a veiculação dos anúncios de teste e adicionar o seguinte código antes de carregar um anúncio: AdSettings.addTestDevice("HASHED ID");

Você pode ativar os anúncios de teste em um dispositivo adicionando a seguinte linha de código antes de carregar um anúncio:

AdSettings.addTestDevice("HASHED ID");

Se quiser adicionar vários dispositivos de teste, simplesmente crie uma lista de cadeias de caracteres a ser adicionada antes de carregar um anúncio:

List<String> testDevices = new ArrayList<>();
testDevices.add("HASHED_ID_1");
testDevices.add("HASHED_ID_2");
AdSettings.addTestDevices(testDevices);

Após a conclusão dos testes, apague a configuração do dispositivo de teste usando esta linha de código:

AdSettings.clearTestDevices();

Exemplo para solicitar anúncios de teste no painel de mediação

Além de solicitar o anúncio de teste no código, você poderá configurar o valor do ID de posicionamento com o tipo de anúncio de teste no painel de mediação, caso seu aplicativo use a mediação. Por exemplo, se seu aplicativo usar o MoPub, você poderá editar a rede do Facebook e definir o valor do ID de posicionamento para que o anúncio nativo seja VID_HD_9_16_39S_APP_INSTALL#YOUR_PLACEMENT_ID. Seu aplicativo receberá um anúncio de teste de vídeo com uma taxa de proporção de 9:16 e um botão CTA de instalação do aplicativo.