Configurare l'accesso diretto per Ad Exchange

Seleziona la piattaforma: Android Nuovo Android iOS

L'SDK Google Mobile Ads supporta la monetizzazione delle app con una proprietà Ad Exchange. Questa guida mostra come configurare le app per tutti i formati degli annunci supportati da Ad Exchange.

Prerequisiti

Configurare l'app per l'accesso ad Ad Exchange

Aggiungi l'ID app Ad Manager (identificato nell'interfaccia utente di Ad Manager) al file AndroidManifest.xml della tua app tramite un tag <meta-data> con android:name="com.google.android.gms.ads.APPLICATION_ID". In android:value, inserisci il tuo ID app Ad Manager, racchiuso tra virgolette.

<manifest>
    <application>
        <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    </application>
</manifest>

Tieni presente che se non aggiungi il tag <meta-data> come mostrato sopra, si verifica un arresto anomalo con il seguente messaggio:

Missing application ID.

Dopodiché, puoi inizializzare l'SDK Google Mobile Ads e selezionare un formato dell'annuncio da visualizzare. Il resto di questa guida implementa il formato banner per illustrare come caricare un annuncio da Ad Exchange. Gli stessi passaggi possono essere applicati a qualsiasi formato dell'annuncio supportato dall'SDK Google Mobile Ads.

Caricare un annuncio da Ad Exchange

Puoi utilizzare un codice proprietà web Ad Exchange con una barra in avanti finale, al posto di un ID unità pubblicitaria. Ad esempio, ca-mb-app-pub-5629679302779023/.

Ad esempio, per caricare un annuncio banner inserendo un AdManagerAdView nel layout per l'Activity come segue:

# main_activity.xml
...
  <com.google.android.gms.ads.admanager.AdManagerAdView
      xmlns:ads="http://schemas.android.com/apk/res-auto"
      android:id="@+id/adManagerAdView"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_centerHorizontal="true"
      android:layout_alignParentBottom="true"
      ads:adSize="BANNER"
      ads:adUnitId="ca-mb-app-pub-5629679302779023/">
  </com.google.android.gms.ads.admanager.AdManagerAdView>

In alternativa, puoi creare una gerarchia di oggetti View a livello di programmazione:

Java 

AdManagerAdView adView = new AdManagerAdView(this);

adView.setAdSizes(AdSize.BANNER);
adView.setAdUnitId("ca-mb-app-pub-5629679302779023/");

// TODO: Add adView to your view hierarchy.

Kotlin 

val adView = AdManagerAdView(this)

adView.adSizes = AdSize.BANNER
adView.adUnitId = "ca-mb-app-pub-5629679302779023/"

// TODO: Add adView to your view hierarchy.

Una volta inserito AdManagerAdView, puoi chiamare il loadAd() metodo nella AdManagerAdView classe e personalizzare il comportamento dell'annuncio utilizzando gli eventi annuncio.

Tieni presente che se non aggiungi una barra in avanti finale al codice proprietà della proprietà web Ad Exchange, si verifica un errore di richiesta di annuncio con il seguente messaggio:

Invalid Request. Cannot determine request type. Is your ad unit id correct?

Puoi anche convertire un codice proprietà web Ad Exchange in un'unità pubblicitaria. Dopodiché, utilizza l'interfaccia utente di Ad Manager per generare un tag Ad Exchange e copiarlo nella tua app. Il tag generato deve contenere il codice proprietà Ad Exchange, seguito dagli ID unità pubblicitaria discendenti senza una barra in avanti finale, ad esempio: ca-mb-app-pub-5629679302779023/banner.

Questo è tutto! Ora la tua app è pronta per caricare e mostrare gli annunci banner di Ad Exchange.

Inoltre, puoi utilizzare una proprietà web Ad Exchange per caricare e mostrare altri formati degli annunci di Ad Exchange seguendo le rispettive guide:

Aggiungere i prezzi minimi (solo per i publisher europei approvati)

Puoi inviare una richiesta per la funzionalità "Prezzi minimi".

Una volta approvato, puoi includere un prezzo minimo pubblico o privato nella richiesta di annuncio utilizzando rispettivamente i parametri pubf e pvtf. Nel seguente esempio di codice, sostituisci "123" con i prezzi minimi in micro e la valuta predefinita della tua rete. Esempio di come vengono applicati i micro: se la tua valuta predefinita è $, l'inserimento di "6.000.000" equivale a 6,00 $.

Java

Bundle extras = new Bundle();
// Public floor parameter.
extras.putString("pubf", "123");
// Private floor parameter.
extras.putString("pvtf", "123");

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter.class, extras)
    .build();

Kotlin

val extras = Bundle();
// Public floor parameter.
extras.putString("pubf", "123");
// Private floor parameter.
extras.putString("pvtf", "123");

val request = AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter::class::java, extras)
    .build();