Primeiros passos com o Android

O Audience Network agora é exclusivo para lances

O Audience Network agora só usa lances para preencher anúncios em apps para iOS e Android. Para monetizar com o Audience Network, você precisará migrar os apps que usam o método waterfall para os lances.

Saiba mais na nossa publicação de blog do Audience Network.

O Audience Network da Meta permite monetizar os seus apps Android com os anúncios do Facebook. Este guia ajudará você em todas as etapas de integração do SDK.

Pré-requisitos

Verifique se você tem o Android Studio instalado.

Consulte as perguntas frequentes para saber qual é a versão mínima do sistema operacional com suporte do SDK do Audience Network.

Etapa 1: criar um novo projeto

Etapa 2: incluir o SDK

Etapa 3: verificar o modo de erro de integração (opcional)

Etapa 1: criar um novo projeto

Você pode ignorar esta etapa se já tiver um projeto ao qual deseja integrar o Audience Network.

Inicie o Android Studio e selecione "Start a new Android Studio Project".



Nomeie o projeto e especifique o domínio da sua empresa.
O nome do pacote será o identificador caso você decida carregar o app para a Google Play Store.



Defina a versão mínima do Android SDK. O Audience Network exige uma API 15 ou superior, mas, para
estes exemplos, usaremos uma API 21.



Adicione uma atividade vazia ao projeto.



Dê um nome à atividade inicial e clique em "Finish".

Etapa 2: incluir o SDK

O SDK do Audience Network faz parte do SDK do Facebook. Siga estas etapas para baixar o SDK e incluí-lo no projeto:

Com o Gradle



Adicione a seguinte declaração de compilação ao build.gradle no nível do app (e não ao projeto) para usar o SDK do Audience Network mais recente:

dependencies {
compile 'com.facebook.android:audience-network-sdk:6.+'
}

Se houver problemas para resolver o SDK do Audience Network, verifique se arquivo Gradle está sincronizado e reinicie o Android Studio.

Instalação manual (não recomendado)

Se você estiver usando Intellij IDEA ou Eclipse, baixe e extraia o SDK do Audience Network para Android. Na pasta AudienceNetwork/bin, copie o arquivo AudienceNetwork.aar e coloque-o na pasta /libs do projeto. Talvez você precise criar o diretório se ele ainda não existir. Em seguida, adicione as seguintes linhas ao build.gradle do seu app:

repositories {
flatDir {
dirs 'libs'
}
}

dependencies {
...
compile(name: 'AudienceNetwork', ext: 'aar')
}

Se você estiver usando AudienceNetwork.jar para o projeto, na pasta AudienceNetwork/bin, renomeie AudienceNetwork.aar para AudienceNetwork.zip, extraia o arquivo classes.jar e renomeie-o para AudienceNetwork.jar. Coloque o arquivo AudienceNetwork.jarna pasta /libs do projeto. Talvez você precise criar o diretório se ele ainda não existir. Verifique se a interface do usuário do IDE reflete a alteração. Caso você esteja usando Intellij IDEA ou Eclipse, clique com o botão direito no arquivo libs/AudienceNetwork.jar e escolha "Add as Library".

Mesmo não sendo obrigatório, recomendamos configurar o projeto para que ele funcione com o Google Play Services, como indicado aqui. Assim, o SDK do Audience Network poderá buscar a identificação de publicidade de forma mais eficiente.

Etapa 3: verificar o modo de erro de integração (opcional)

Ao integrar o SDK do Audience Network, você pode usar a configuração do modo de erro de integração para verificar se tudo está funcionando como deveria. Especificamente, esse método permite que você controle o comportamento do SDK quando ele for usado de modo incorreto.

  • INTEGRATION_ERROR_CRASH_DEBUG_MODE: o app falhará se a compilação tiver FLAG_DEBUGGABLE do Android, caso contrário, INTEGRATION_ERROR_CALLBACK_MODE será usado (recomendado ao testar).
  • INTEGRATION_ERROR_CALLBACK_MODE: o app fará um retorno de chamada de AdListener.onError(Ad, AdError) se for descoberto um erro de integração.
// Example for setting the SDK to crash when in debug mode
AdSettings.setIntegrationErrorMode(INTEGRATION_ERROR_CRASH_DEBUG_MODE);

Próximas etapas