Integrare Moloco con la mediazione

Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di Moloco utilizzando la mediazione, che copre le integrazioni delle offerte. Spiega come aggiungere Moloco alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore Moloco in un'app Unity.

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione Ad Manager per Moloco ha le seguenti funzionalità:

Integrazione
Offerte
Cascata
Formati
Apertura app
Banner
Interstitial
Con premio
Interstitial con premio

Requisiti

  • SDK Google Mobile Ads più recente
  • Unity 5.6 o versioni successive
  • Plug-in Unity Moloco 1.2.0 o versioni successive
  • Per il deployment su Android
    • Livello API Android 23 o superiore
  • Per il deployment su iOS
    • Target di distribuzione iOS 12.0 o versioni successive
  • Un progetto Unity funzionante configurato con l'SDK Google Mobile Ads. Per maggiori dettagli, consulta la sezione Guida introduttiva.
  • Completa la mediazione Guida introduttiva

Passaggio 1: configura le configurazioni nell'interfaccia utente di Moloco

Accedi al portale per editori Moloco.

Vai alla scheda Panoramica > App, quindi fai clic sul pulsante Aggiungi app per creare una nuova app.

Seleziona Sistema operativo e Impostazioni della privacy per la tua app, compila il resto del modulo e fai clic su Crea.

Android

iOS

Una volta creata l'app, selezionala dalla scheda App per visualizzare i dettagli e annota la chiave dell'app.

Android

iOS

Vai alla scheda Panoramica > Unità pubblicitarie, seleziona l'app dal menu a discesa e poi fai clic su Nuova unità pubblicitaria.

Seleziona Offerte in-app come Metodo asta e compila il resto del modulo. Quindi, fai clic su Crea.

Vai all'unità pubblicitaria appena creata nella scheda Unità pubblicitarie per visualizzarne i dettagli. Prendi nota dell'ID unità pubblicitaria.

Passaggio 2: configura la domanda di Moloco nell'interfaccia utente di Ad Manager

Configurare le impostazioni di mediazione per l'unità pubblicitaria

Android

Per istruzioni, vedi il passaggio 2 della guida per Android.

iOS

Per istruzioni, vedi il passaggio 2 della guida per iOS.

Aggiungere Moloco Ads all'elenco dei partner pubblicitari ai sensi del GDPR e delle normative statali degli Stati Uniti

Segui i passaggi descritti in Impostazioni relative ai regolamenti europei e Impostazioni relative alle normative statali degli Stati Uniti per aggiungere Moloco Ads all'elenco dei partner pubblicitari europei e statunitensi nell'interfaccia utente di Ad Manager.

Passaggio 3: importa l'SDK e l'adattatore Moloco

OpenUPM-CLI

Se hai installato OpenUPM-CLI, puoi installare il plug-in di mediazione dell'SDK Google Mobile Ads Moloco Ads per Unity nel tuo progetto eseguendo il seguente comando dalla directory radice del progetto:

openupm add com.google.ads.mobile.mediation.moloco

OpenUPM

Nell'editor del progetto Unity, seleziona Modifica > Impostazioni progetto > Package Manager per aprire le impostazioni di Unity Package Manager.

Nella scheda Registri con ambito, aggiungi OpenUPM come registro con ambito con i seguenti dettagli:

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Ambiti: com.google

Dettagli OpenUPM

Poi vai a Window > Package Manager per aprire Unity Package Manager e seleziona My Registries dal menu a discesa.

Registri Unity

Seleziona il pacchetto Google Mobile Ads Moloco Mediation e fai clic su Installa.

Installare da OpenUPM

Pacchetto Unity

Scarica l'ultima versione del plug-in di mediazione Google Mobile Ads per l'SDK Moloco Ads dal link di download riportato nel Changelog ed estrai GoogleMobileAdsMolocoMediation.unitypackage dal file zip.

Nell'editor del progetto Unity, seleziona Assets > Import Package > Custom Package e trova il file GoogleMobileAdsMolocoMediation.unitypackage che hai scaricato. Assicurati che tutti i file siano selezionati e fai clic su Importa.

Importa da Unity

Quindi, seleziona Asset > External Dependency Manager > Android Resolver > Force Resolve. La libreria External Dependency Manager esegue la risoluzione delle dipendenze da zero e copia le dipendenze dichiarate nella directory Assets/Plugins/Android della tua app Unity.

Forza risoluzione

Passaggio 4: aggiungi il codice richiesto

Non è necessario alcun codice aggiuntivo per l'integrazione di Moloco.

Passaggio 5: testa l'implementazione

Attivare gli annunci di prova

Assicurati di registrare il dispositivo di test per Ad Manager.

Verificare gli annunci di prova

Per verificare di ricevere annunci di test dall'SDK Moloco Ads, attiva i test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio Moloco (offerta).

Codici di errore

Se l'adattatore non riceve un annuncio da Moloco, i publisher possono controllare l'errore sottostante nella risposta dell'annuncio utilizzando ResponseInfo nelle seguenti classi:

Android

com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter

iOS

MolocoSDK.MolocoError
GADMediationAdapterMoloco

Di seguito sono riportati i codici e i messaggi associati restituiti dall'adattatore Moloco quando un annuncio non viene caricato:

Android

Codice di errore Dominio Motivo
101 com.google.ads.mediation.moloco Chiave dell'app Moloco mancante o non valida.
102 com.google.ads.mediation.moloco ID unità pubblicitaria Moloco mancante o non valido.
103 com.google.ads.mediation.moloco L'oggetto annuncio Moloco restituito era nullo.
Da -1 a 5000 com.moloco.sdk L'SDK Moloco ha restituito un errore. Per ulteriori dettagli, consulta la documentazione di Moloco.

iOS

Codice di errore Dominio Motivo
101 com.google.ads.mediation.moloco L'SDK Moloco non supporta la pubblicazione di annunci su iOS 12 e versioni precedenti.
102 com.google.ads.mediation.moloco Chiave dell'app Moloco mancante o non valida.
103 com.google.ads.mediation.moloco ID unità pubblicitaria Moloco mancante o non valido.
104 com.google.ads.mediation.moloco L'annuncio non è pronto per essere pubblicato.
105 com.google.ads.mediation.moloco Impossibile mostrare l'annuncio.
106 com.google.ads.mediation.moloco Dati di rendering non disponibili per il rendering dell'annuncio.
Da -1 a 5000 Inviato dall'SDK Moloco L'SDK Moloco ha restituito un errore. Per ulteriori dettagli, consulta la documentazione di Moloco.

Verifica lato server degli annunci con premio

Se Convalida i callback di verifica lato server (SSV), l'identificatore dell'origine annuncio per Moloco è 8267622065755668722.

Log delle modifiche del plug-in di mediazione Unity Moloco

Versione 1.6.1

Versione 1.6.0

Versione 1.5.0

Versione 1.4.0

Versione 1.3.1

Versione 1.3.0

Versione 1.2.1

Versione 1.2.0

Versione 1.1.0

Versione 1.0.0