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 físicos com anúncios de produção antes da distribuição. Use o SDK mais recente do Audience Network em sua integração para incluir as correções e melhorias mais atuais. As seções a seguir apresentam uma orientação passo a passo sobre como testar a integração de anúncios do Audience Network com seu aplicativo ou site móvel.

Etapa 1: testar com anúncios de produção

Etapa 2: verificar se há códigos de erro das solicitações de anúncios de produção

Etapa 3: usar o Depurador de solicitações do Audience Network para diagnóstico das solicitações de anúncios

Etapa 4: como testar com anúncios de teste

Etapa 5: lista de verificação da integração de anúncios do Audience Network

Etapa 1: testar com anúncios de produção

O teste com anúncios de produção é um processo em duas etapas. A primeira etapa é adicionar pessoas à página de configurações do negócio para permitir que elas vejam os anúncios de produção antes da aprovação do aplicativo. A segunda destina-se a que os testadores atribuídos usem o aplicativo ou site móvel enquanto conectados ao Facebook.

Como adicionar testadores ao seu aplicativo

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

  1. Acesse as Configurações do negócio.
  2. Clique em +Adicionar na guia Pessoas à esquerda.
  3. Digite o endereço de email da pessoa que você deseja adicionar a sua conta do Gerenciador de Negócios. É possível incluir várias pessoas aqui.
  4. Você pode atribuir funções às pessoas, se desejar, ou pode clicar em Pular para adicioná-las somente a sua conta no Gerenciador de Negócios.

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 para os dispositivos dos testadores usando seu método de distribuição preferido. Os testadores devem estar incluídos na página de configuração do Gerenciador de Negócios.
  2. Cada pessoa adicionada precisa instalar o aplicativo do Facebook no próprio dispositivo e estar conectada com o número de identificação do usuário do Facebook que você adicionou à função Testadores. Isso é obrigatório porque o Facebook precisa reconhecer o usuário como uma pessoa de sua empresa para poder retornar um anúncio.
  3. Agora, o testador pode iniciar o aplicativo e acionar os posicionamentos que você deseja testar. Ele deverá ver um anúncio de produção.

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.

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.



Etapa 2: Verificar se há códigos de erro das solicitações de anúncios de produção

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álida – cada posicionamento e tipo tem uma ID única
  • 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.


Etapa 3: Usar o Depurador de Solicitações do Audience Network para diagnóstico das solicitações de anúncio

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.

  1. Acesse o Gerenciador de Monetização
  2. Clique em Gerenciar propriedade
  3. Clique em Configurações da propriedade > Depurador de Solicitações no canto superior direito
  4. Clique em Iniciar para monitorar as solicitações de seu aplicativo ou site.

No seu dispositivo de teste Android ou iOS, navegue no aplicativo para ativar posicionamentos de anúncios do Audience Network. As solicitações de anúncio aparecerão na ferramenta. Verifique se as solicitações são enviadas com a ID de 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 no simulador/emulador;
  2. O aplicativo do Facebook está instalado no dispositivo de teste;
  3. O testador está conectado ao Facebook no próprio dispositivo de teste e tem uma função na sua empresa;
  4. A camada de mediação está enviando solicitações para o Audience Network do Facebook, se estiver usando mediação.


Etapa 4: como testar com anúncios de teste

O usuário que estiver testando o aplicativo deve estar adicionado a uma função no Gerenciador de Negócios de seu aplicativo. Este é o método de teste recomendado, pois permite a visualização de anúncios de produção em dispositivos físicos. Consulte a seção Como testar com anúncios de produção para obter mais informações sobre o método de teste recomendado.

No entanto, conforme mencionado na seção anterior, pode-se perceber que nem sempre é possível testar a interface do usuário dos anúncios de produção com as visualizações da interface do usuário 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 de produção não garantirá o conteúdo e o formato do retorno do anúncio. 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 a ID de posicionamento com "#" ao inicializar qualquer objeto de anúncio do Facebook. O modelo de ID de posicionamento para solicitar os anúncios de teste é TIPO_DE_ANÚNCIO_DE_TESTE#SUA_ID__DE_POSICIONAMENTO.

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.

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, vídeo com incentivo, 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, vídeo com incentivo, 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, vídeo com incentivo, 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, vídeo com incentivo, 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, vídeo com incentivo, 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, vídeo com incentivo, 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

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, verá uma mensagem como esta impressa no Logcat ao testar em um dispositivo Android físico:

#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.

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 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 físico:

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 a 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 da 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 da 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.



Etapa 5: lista de verificação da integração de anúncios do Audience Network

  1. Instale e entre no aplicativo do Facebook em seu dispositivo de testes.
  2. Adicione à conta do Gerenciador de Negócios as pessoas que estão testando seus anúncios do Audience Network.
  3. Inicialize a instância do anúncio com o ID de posicionamento criado no Gerenciador de Negócios. Consulte a Etapa de introdução.
  4. Verifique se os anúncios de produção do Audience Network foram solicitados com sucesso pelo seu aplicativo. Use os Códigos de erro do Audience Network e o Depurador de Solicitações do Audience Network para diagnosticar.
  5. Verifique se os anúncios estão totalmente visíveis e nítidos para os usuários do aplicativo.
  6. Verifique a experiência do usuário da integração dos anúncios por meios dos anúncios de teste. Certifique-se de remover o trecho de código do anúncio de teste antes do lançamento na loja de aplicativos. Do contrário, seu aplicativo de produção só mostrará anúncios de teste.