Aggiunta di banner e inserzioni Medium Rectangle su un'app Android

Audience Network ti consente di monetizzare le tue app per Android con le inserzioni di Facebook. Questa guida spiega come aggiungere banner e inserzioni Medium Rectangle alla tua 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 ti interessano altri tipi di unità pubblicitarie, consulta la lista di tipologie disponibili.

Assicurati di aver seguito tutte le istruzioni fornite nelle Guide alla configurazione di Android prima di procedere.

Passaggi per banner e inserzioni Medium Rectangle

Passaggio 1: aggiunta di un contenitore di layout per il banner

Passaggio 2: implementazione del banner nell'attività

Passaggio 3: aggiunta di una funzione di rilevamento delle inserzioni

Passaggio 1: aggiunta di un contenitore di layout per il banner

Nel file di layout (ad esempio, /res/layout/activity_main.xml), aggiungi un layout che fungerà da contenitore per l'inserzione.
Ricorda l'ID impostato qui perché dovrai inserirlo nel codice in un secondo momento.

<?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>

Passaggio 2: implementazione del banner nell'attività

Aggiungi il codice di seguito nella parte superiore della tua attività per importare l'SDK Facebook Ads:

import com.facebook.ads.*;

Poi istanzia un oggetto AdView e richiedi di caricare un'inserzione. Poiché AdView è una sottoclasse di View, puoi aggiungerlo alla gerarchia come qualsiasi altra visualizzazione:

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 stai creando un'app per tablet, prendi invece in considerazione l'uso delle dimensioni AdSize.BANNER_HEIGHT_90. In tutti i casi, la larghezza del banner è flessibile con un minimo di 320 px.

Infine, aggiungi il codice di seguito alla funzione onDestroy() della tua attività per rilasciare le risorse utilizzate da AdView:

@Override
protected void onDestroy() {
if (adView != null) {
adView.destroy();
}
super.onDestroy();
}

Una volta eseguito quanto sopra, dovresti visualizzare qualcosa di simile a questo:



Se usi l'emulatore Google Android predefinito, aggiungi la riga di codice seguente prima di caricare un'inserzione di prova:
AdSettings.addTestDevice("HASHED ID");.

Usa l'ID con hash che viene visualizzato nel logcat alla prima richiesta di caricamento di un'inserzione sul dispositivo.

Genymotion e i dispositivi fisici non richiedono questo passaggio. Se desideri eseguire il test con inserzioni reali, consulta la nostra guida ai test.

Passaggio 3: aggiunta di una funzione di rilevamento delle inserzioni

Una volta che il codice di base è in esecuzione, puoi impostare un AdListener per AdView in modo da controllare eventi specifici:

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

Dimensioni dei banner

Audience Network supporta tre dimensioni per le inserzioni da usare in AdView. La larghezza dell'unità banner è flessibile con un minimo di 320 px, solo l'altezza è definita.

Formato pubblicitario Riferimento AdSize Dimensioni Consiglio

Banner standard

BANNER_50

320 x 50

Questo tipo di banner è adatto ai cellulari

Banner grande

BANNER_90

320 x 90

Questo tipo di banner è adatto a tablet e dispositivi di grandi dimensioni

Rettangolo medio

RECTANGLE_HEIGHT_250

300 x 250

Questo formato è adatto alle sezioni a scorrimento o alle schermate di fine livello

Passaggi successivi