Anúncios em banner e anúncios de retângulo médio no app Android

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.

Etapas para anúncios em banner e anúncios de retângulo médio

Etapa 1: adicionar um contêiner de layout ao anúncio de banner

Etapa 2: implementar o banner na sua atividade

Etapa 3: adicionar um ouvinte ao anúncio

Etapa 1: adicionar um contêiner de layout ao anúncio de banner

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>

Etapa 2: implementar o banner na sua atividade

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.

Etapa 3: adicionar um ouvinte ao anúncio

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());
}

Tamanhos de anúncios de banner

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

BANNER_50

320 x 50

Este banner é o mais apropriado para celulares

Banner grande

BANNER_90

320 x 90

Este banner é o mais apropriado para tablets e dispositivos grandes

Retângulo médio

RECTANGLE_HEIGHT_250

300 x 250

Este formato é o mais apropriado para feeds com rolagem ou telas no final de níveis

Próximas etapas