Questa pagina è stata tradotta dall'API Cloud Translation.

Per iniziare

L'integrazione dell'SDK Google Mobile Ads in un'app è il primo passo per pubblicare gli annunci e generare entrate. Una volta integrato l'SDK, puoi scegliere un formato dell'annuncio (ad esempio nativo o con premio) e seguire la procedura per implementarlo.

Prima di iniziare

Per preparare la tua app, completa i passaggi nelle sezioni seguenti.

Prerequisiti dell'app

Utilizzare Android Studio 3.2 o versioni successive
Assicurati che il file di build dell'app utilizzi i seguenti valori:
- minSdkVersion di 19 o più
- compileSdkVersion di 28 o più

Configura la tua app

Nel file build.gradle a livello di progetto, includi il repository Maven di Google e il repository centrale Maven nelle sezioni buildscript e allprojects:

buildscript {
    repositories {
        google()
        mavenCentral()
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

Aggiungi le dipendenze dell'SDK Google Mobile Ads al file Gradle a livello di app, in genere app/build.gradle:
```
dependencies {
  implementation 'com.google.android.gms:play-services-ads:22.4.0'
}
```
Aggiungi l' Ad Manager ID app, come identificato nell'Ad Managerinterfaccia web, al file AndroidManifest.xml dell'app. Per farlo, aggiungi un tag <meta-data> con android:name="com.google.android.gms.ads.APPLICATION_ID". Puoi trovare l'ID app nell' Ad Manager interfaccia web. Per android:value, inserisci il tuo Ad Manager ID app, racchiuso tra virgolette.
```
<manifest>
  <application>
    
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
  </application>
</manifest>
```
In un'app reale, utilizza il tuo ID Ad Manager app effettivo, non quello elencato sopra. Se vuoi solo eseguire esperimenti con l'SDK in un'app Hello World, puoi utilizzare l'ID app di esempio mostrato sopra.

Tieni presente, inoltre, che un errore con l'aggiunta del tag <meta-data>, come mostrato sopra, si è verificato in un arresto anomalo con il messaggio:
```
The Google Mobile Ads SDK was initialized incorrectly.
```
(Facoltativo) Dichiara l'autorizzazione AD_ID per consentire il funzionamento delle versioni precedenti con Android 13.

Se la tua app utilizza la versione 20.4.0 o successiva dell'SDK Google Mobile Ads, puoi saltare questo passaggio perché l'SDK dichiara automaticamente l'autorizzazione com.google.android.gms.permission.AD_ID e può accedere all'ID pubblicità ogni volta che è disponibile.

Per le app che utilizzano l'SDK Google Mobile Ads versione 20.3.0 o precedente e che hanno come target Android 13, devi aggiungere l'autorizzazione com.google.android.gms.permission.AD_ID nel file AndroidManifest.xml affinché l'SDK Google Mobile Ads possa accedere all'ID pubblicità:
```
<manifest>
 <application>
   <meta-data
       android:name="com.google.android.gms.ads.APPLICATION_ID"
       android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>

   
   <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

 </application>
</manifest>
```
Per saperne di più sulla dichiarazione delle autorizzazioni com.google.android.gms.permission.AD_ID, incluso come disattivarla, consulta questo articolo di Play Console.

Inizializzare l'SDK Google Mobile Ads

Prima di caricare gli annunci, chiedi alla tua app di inizializzare l'SDK Google Mobile Ads chiamando MobileAds.initialize() l'inizializzazione dell'SDK e richiama un listener di completamento al termine dell'inizializzazione o dopo un timeout di 30 secondi. Questa operazione deve essere eseguita una sola volta, idealmente al momento del lancio dell'app.

Gli annunci possono essere precaricati dall'SDK Google Mobile Ads o dagli SDK dei partner di mediazione al momento della chiamata MobileAds.initialize(). Se è necessario ottenere il consenso degli utenti nello Spazio economico europeo (SEE), impostare flag specifici per le richieste, come tagForChildDirectedTreatment o tag_for_under_age_of_consent, oppure intervenire prima di caricare gli annunci, assicurati di farlo prima di inizializzare l'SDK Google Mobile Ads.

Ecco un esempio di come chiamare il metodo initialize() in un'attività:

Esempio di attività principale (estratto)

Java

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MainActivity extends AppCompatActivity {
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        MobileAds.initialize(this, new OnInitializationCompleteListener() {
            @Override
            public void onInitializationComplete(InitializationStatus initializationStatus) {
            }
        });
    }
}

Kotlin

import com.google.android.gms.ads.MobileAds

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        MobileAds.initialize(this) {}
    }
}

Se utilizzi la mediazione, attendi che il gestore del completamento venga chiamato prima di caricare gli annunci, in modo che tutti gli adattatori di mediazione vengano inizializzati.

Seleziona un formato dell'annuncio

L'SDK Google Mobile Ads è ora importato e puoi implementare un annuncio. Ad Manager Offre una serie di formati di annunci diversi, per consentirti di scegliere quello più adatto per l'esperienza utente della tua app.

Annunci rettangolari che vengono visualizzati nella parte superiore o inferiore dello schermo del dispositivo. Gli annunci banner rimangono sullo schermo mentre gli utenti interagiscono con l'app e possono aggiornarsi automaticamente dopo un determinato periodo di tempo. Se non hai mai utilizzato la pubblicità per il mobile, questa è un ottimo punto di partenza.

Implementare gli annunci banner

Interstitial

Annunci a schermo intero che coprono l'interfaccia di un'app fino alla chiusura dell'utente. Sono ideali per le pause naturali nel flusso di esecuzione di un'app, ad esempio tra i livelli di un gioco o subito dopo il completamento di un'attività.

Implementare gli annunci interstitial

Nativo

Annunci personalizzabili che si adattano all'aspetto della tua app. Decidi come e dove devono essere posizionati, in modo che il layout sia più in linea con il design dell'app.

Google Ad Manager offre due modi per implementare gli annunci nativi: stili nativi e rendering personalizzato.

Gli stili nativi sono stati progettati per semplificare il più possibile l'implementazione degli annunci nativi ed è un'ottima scelta per chi non conosce il formato. Il rendering personalizzato è stato progettato per massimizzare la libertà di creare le tue presentazioni.

Implementa gli annunci nativi

Implementare gli stili nativi

Con premio

Annunci che premiano gli utenti per la visione di brevi video e l'interazione con annunci demo e sondaggi. Categoria relativa alla monetizzazione delle app free-to-play.

Implementare gli annunci con premio

Risorse aggiuntive

Il repository Google Mobile Ads su GitHub mostra come utilizzare i diversi formati degli annunci offerti da questa API.