Questa guida mostra come integrare un adattatore di mediazione con la tua app per Android.
Prerequisiti
Prima di poter integrare la mediazione per un formato dell'annuncio, devi integrare quest'ultimo nella tua app:
- Annunci banner
- Annunci interstitial
- Annunci nativi
- Annunci con premio
- Annunci interstitial con premio
Non hai mai utilizzato la mediazione? Leggi Introduzione alla mediazione.
Per le offerte: SDK Google Mobile Ads 18.3.0 o versioni successive.
Inizializzare l'SDK Mobile Ads
La guida rapida illustra come inizializzare l'SDK Mobile Ads. Durante la chiamata di inizializzazione, anche gli adattatori di mediazione vengono inizializzati. È importante attendere il completamento dell'inizializzazione prima di caricare gli annunci per garantire la piena partecipazione di ogni rete pubblicitaria alla prima richiesta di annuncio.
Il codice di esempio riportato di seguito mostra come controllare lo stato di inizializzazione di ogni adattatore prima di effettuare una richiesta di annuncio.
Java
import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.AdapterStatus;
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);
new Thread(
() ->
// Initialize the Google Mobile Ads SDK on a background thread.
MobileAds.initialize(
this,
initializationStatus -> {
Map<String, AdapterStatus> statusMap =
initializationStatus.getAdapterStatusMap();
for (String adapterClass : statusMap.keySet()) {
AdapterStatus status = statusMap.get(adapterClass);
Log.d(
"MyApp",
String.format(
"Adapter name: %s, Description: %s, Latency: %d",
adapterClass, status.getDescription(), status.getLatency()));
}
// Start loading ads here...
}))
.start();
}
}
Kotlin
import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
val backgroundScope = CoroutineScope(Dispatchers.IO)
backgroundScope.launch {
// Initialize the Google Mobile Ads SDK on a background thread.
MobileAds.initialize(this@MainActivity) { initializationStatus ->
val statusMap =
initializationStatus.adapterStatusMap
for (adapterClass in statusMap.keys) {
val status = statusMap[adapterClass]
Log.d(
"MyApp", String.format(
"Adapter name: %s, Description: %s, Latency: %d",
adapterClass, status!!.description, status.latency
)
)
}
// Start loading ads here...
}
}
}
}
Controllare quale classe dell'adattatore di rete pubblicitaria ha caricato l'annuncio
Di seguito è riportato un esempio di codice che registra il nome della classe della rete pubblicitaria per un annuncio banner:
Java
public void onAdLoaded() {
Log.d("Banner adapter class name: " + ad.getResponseInfo().getMediationAdapterClassName());
}
Kotlin
override fun onAdLoaded() {
Log.d("Banner adapter class name:" + ad.responseInfo.mediationAdapterClassName)
}
Per maggiori dettagli su questo metodo, consulta la documentazione di ResponseInfo
relativa a getMediationAdapterClassName()
.
Inizializza l'oggetto annuncio con un'istanza di attività
Nel costruttore di un nuovo oggetto annuncio (ad esempio, AdManagerAdView
), devi passare un oggetto di tipo Context
.
Questo Context
viene trasmesso ad altre reti pubblicitarie quando viene utilizzata la mediazione. Alcune
reti pubblicitarie richiedono un valore Context
più restrittivo di tipo
Activity
e potrebbe non essere in grado di pubblicare annunci senza un'istanza Activity
. Pertanto, ti consigliamo di trasferire un'istanza Activity
durante l'inizializzazione degli oggetti annuncio per garantire un'esperienza coerente con le reti pubblicitarie con mediazione.
Utilizzare gli annunci banner con la mediazione
Assicurati di disattivare l'aggiornamento in tutte le interfacce utente delle origini annuncio di terze parti per le unità pubblicitarie banner utilizzate nella mediazione. In questo modo si evita un doppio aggiornamento, poiché Ad Manager attiva anche un aggiornamento basato sulla frequenza di aggiornamento dell'unità pubblicitaria banner.
Utilizzare gli annunci nativi con la mediazione
Di seguito sono riportate alcune best practice da considerare durante l'implementazione della mediazione nativa.
- Norme relative alla presentazione degli annunci nativi
- Ogni rete pubblicitaria ha le proprie norme. Quando utilizzi la mediazione, è importante ricordare che la tua app deve comunque rispettare le norme della rete mediata che ha fornito l'annuncio.
- Usa
loadAd()
anzichéloadAds()
- Il metodo
loadAds()
consente di pubblicare solo annunci Google. Per gli annunci con mediazione, utilizza inveceloadAd()
.
Leggi statali sulla privacy degli Stati Uniti e GDPR
Se devi rispettare le leggi statali sulla privacy degli Stati Uniti o il Regolamento generale sulla protezione dei dati (GDPR), segui i passaggi descritti nelle impostazioni dei regolamenti statali degli Stati Uniti o nelle impostazioni GDPR per aggiungere i tuoi partner di mediazione all'elenco dei partner pubblicitari degli stati USA o GDPR di Ad Manager. In caso contrario, i partner potrebbero non pubblicare annunci sulla tua app.
Scopri di più sull'attivazione del trattamento dati limitato (RDP) e sull'ottenimento del consenso GDPR con l'SDK Google User Messaging Platform (UMP).