O Audience Network permite que você monetize seus apps Android usando os anúncios do Facebook. Este guia explica como adicionar anúncios em banner e anúncios de retângulo médio ao seu app.
You can change placements in Monetization Manager to the Medium Rectangle format if these were previously configured as Banner for bidding. Similarly, for any new medium rectangle placements, navigate to the placement settings page in Monetization Manager and select Medium Rectangle (not Banner).
Placements will deliver as normal even if they are not changed to the medium rectangle format. However, to avoid confusion, we recommend that you change these placements to medium rectangle.
Se você tiver interesse em outros tipos de anúncio, consulte a lista de tipos disponíveis.
Antes de continuar, conclua os guias de configuração do Android.
No arquivo de layout (por exemplo, /res/layout/activity_main.xml
), adicione um layout para funcionar como o contêiner do anúncio.
Vale lembrar que o ID definido neste momento será usado no código mais tarde.
<?xml version="1.0" encoding="utf-8"?> <RelativeLayout ... > ... <LinearLayout android:id="@+id/banner_container" android:layout_width="match_parent" android:layout_height="wrap_content" android:layout_alignParentBottom="true" android:orientation="vertical" app:layout_constraintBottom_toBottomOf="parent" /> ... </RelativeLayout>
Adicione o seguinte código na parte superior de sua atividade para importar o SDK dos anúncios do Facebook:
import com.facebook.ads.*;
Depois, instancie um objeto AdView
e faça uma solicitação para carregar o anúncio. Como AdView
é uma subclasse de View
, é possível adicioná-lo à hierarquia de visualização como você faria normalmente com outra visualização:
private AdView adView; @Override public void onCreate(Bundle savedInstanceState) { ... // Instantiate an AdView object. // NOTE: The placement ID from the Facebook Monetization Manager identifies your App. // To get test ads, add IMG_16_9_APP_INSTALL# to your placement id. Remove this when your app is ready to serve real ads. adView = new AdView(this, "IMG_16_9_APP_INSTALL#YOUR_PLACEMENT_ID", AdSize.BANNER_HEIGHT_50); // Find the Ad Container LinearLayout adContainer = (LinearLayout) findViewById(R.id.banner_container); // Add the ad view to your activity layout adContainer.addView(adView); // Request an ad adView.loadAd(); }
Se você está criando um app para tablet, considere usar o tamanho AdSize.BANNER_HEIGHT_90
. Em todos os casos, a largura do banner é flexível, com o mínimo de 320 px.
Por fim, adicione o código a seguir à função onDestroy()
da atividade para liberar os recursos usados por AdView
:
@Override protected void onDestroy() { if (adView != null) { adView.destroy(); } super.onDestroy(); }
Depois de executá-lo, você verá uma tela com esta aparência:
Se estiver usando o emulador padrão de Android do Google, adicione a seguinte linha de código antes de carregar um anúncio de teste:AdSettings.addTestDevice("HASHED ID");
.
Use o ID convertido em hash que está impresso no catálogo de registros ao fazer uma solicitação para carregar um anúncio em um dispositivo pela primeira vez.
Genymotion e dispositivos físicos não precisam dessa etapa. Se você quiser testar com anúncios reais, consulte nosso Guia de Teste.
Com o código básico em execução, é possível definir um AdListener
ao AdView
para ouvir eventos específicos.
import android.widget.Toast; ... protected void onCreate(Bundle savedInstanceState) { ... AdListener adListener = new AdListener() { @Override public void onError(Ad ad, AdError adError) { // Ad error callback Toast.makeText( MainActivity.this, "Error: " + adError.getErrorMessage(), Toast.LENGTH_LONG) .show(); } @Override public void onAdLoaded(Ad ad) { // Ad loaded callback } @Override public void onAdClicked(Ad ad) { // Ad clicked callback } @Override public void onLoggingImpression(Ad ad) { // Ad impression logged callback } }; // Request an ad adView.loadAd(adView.buildLoadAdConfig().withAdListener(adListener).build()); }
O Audience Network é compatível com três tamanhos de anúncio que podem ser usados em AdView
. A largura da unidade Banner é flexível, com um mínimo de 320 pixels, e apenas a altura é definida.
Formato do anúncio | Referência de AdSize | Tamanho | Recomendação |
---|---|---|---|
Banner padrão |
| 320 x 50 | Este banner é o mais apropriado para celulares |
Banner grande |
| 320 x 90 | Este banner é o mais apropriado para tablets e dispositivos grandes |
Retângulo médio |
| 300 x 250 | Este formato é o mais apropriado para feeds com rolagem ou telas no final de níveis |
Explore nossas amostras de código do Audience Network para Android no Github. Importe os projetos para o seu IDE e veicule-os em um dispositivo ou no emulador.
Quando estiver pronto para lançar seu aplicativo e monetizar, envie o aplicativo para análise após garantir que ele cumpre as Políticas do Audience Network e os Padrões da Comunidade do Facebook.