Integrare Moloco con la mediazione

Seleziona la piattaforma: Android iOS Unity Flutter Android (legacy)

Questa guida mostra come utilizzare GMA Next-Gen SDK per caricare e visualizzare gli annunci display 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 per Android.

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione per Moloco offre le seguenti funzionalità:

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

Prerequisiti

Prima di continuare, verifica quanto segue:

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

Accedi al Portale dei publisher Moloco.

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

Seleziona il sistema operativo e le impostazioni della privacy per la tua app, compila il resto del modulo e poi fai clic su Crea.

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

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

Seleziona Asta di app come Metodo di 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

Accedi al tuo account Ad Manager.

Attiva la condivisione di indicatori sicuri

Vai su Amministratore > Impostazioni globali. Vai alla scheda Impostazioni dell'account Ad Exchange, rivedi e attiva Condivisione di indicatori sicuri. Fai clic su Salva.

Condividi l'indicatore sicuro nelle richieste di offerta

Vai a Inventario > Indicatori sicuri. In Indicatori sicuri, cerca SDK per gli annunci Moloco e attiva Attiva integrazione app.

Fai clic su Salva.

Consenti la condivisione di indicatori sicuri per SDK Bidding

Vai a Pubblicazione > Impostazioni canali di domanda. Nella scheda Impostazioni predefinite, attiva l'opzione Consenti la condivisione di indicatori sicuri per SDK Bidding.

Fai clic su Salva.

Configura le offerte Moloco

Vai a Pubblicazione > Offerenti e fai clic su Vai a SDK Bidding.

Fai clic su Nuovo offerente.

Seleziona Moloco Ads come offerente.

Fai clic su Continua per attivare SDK Bidding per questo offerente.

Fai clic su Fine.

Configurare la mappatura delle unità pubblicitarie

Vai a Pubblicazione > Offerenti e fai clic su Vai a SDK Bidding.

Seleziona l'azienda per l'SDK per gli annunci di Moloco.

Vai alla scheda Mappatura delle unità pubblicitarie e fai clic su Nuova mappatura delle unità pubblicitarie.

Scegli Unità pubblicitaria specifica. Seleziona un'unità pubblicitaria e un formato, App mobile come Tipo di inventario e la tua applicazione mobile. Poi, inserisci Chiave app e ID unità pubblicitaria ottenuti nella sezione precedente.

Infine, fai clic su Salva.

Aggiungere Moloco Ads all'elenco dei partner pubblicitari ai sensi dei regolamenti europei e statali degli Stati Uniti

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

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

Nel file build.gradle.kts a livello di app, aggiungi le seguenti dipendenze e configurazioni di implementazione. Utilizza le versioni più recenti dell'SDK Moloco e dell'adattatore:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:moloco:4.13.0.0")
}

configurations {
    all {
        exclude(group = "com.google.android.gms", module = "play-services-ads")
        exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
    }
}

Passaggio 4: implementa le impostazioni della privacy nell'SDK Moloco

Per rispettare le Norme relative al consenso degli utenti dell'UE di Google, devi fornire determinate informative ai tuoi utenti nello Spazio economico europeo (SEE), nel Regno Unito e in Svizzera e ottenere il loro consenso all'utilizzo di cookie o di altro spazio di archiviazione locale ove richiesto dalla legge e alla raccolta, alla condivisione e all'utilizzo dei dati personali per la personalizzazione degli annunci. Queste norme riflettono i requisiti della direttiva e-Privacy e del Regolamento generale sulla protezione dei dati (GDPR) dell'UE. È tua responsabilità verificare che il consenso venga propagato a ogni origine annuncio nella tua catena di mediazione.

La versione 3.5.0.0 e successive dell'adattatore Android dell'SDK per gli annunci Moloco supporta il trasferimento degli indicatori di consenso GDPR dalle piattaforme di gestione del consenso che si integrano con il Transparency and Consent Framework (TCF) di IAB all'SDK per gli annunci Moloco. Per saperne di più, consulta la documentazione di MolocoPrivacy.

Leggi statali sulla privacy degli Stati Uniti

Le leggi statali sulla privacy degli Stati Uniti richiedono di garantire agli utenti la possibilità di opporsi alla "vendita" delle proprie "informazioni personali" (da intendersi secondo la definizione di tale normativa), mediante un link ben visibile e recante la dicitura "Non vendere i miei dati personali" nella home page del "venditore". La guida alla conformità alle leggi statali sulla privacy degli Stati Uniti offre la possibilità di attivare il trattamento dati limitato per la pubblicazione di annunci Google, ma Google non è in grado di applicare questa impostazione a ogni rete pubblicitaria nella tua catena di mediazione. Pertanto, devi identificare ogni rete pubblicitaria nella tua catena di mediazione che potrebbe partecipare alla vendita di informazioni personali e seguire le indicazioni di ciascuna di queste reti per garantire la conformità.

L'SDK Moloco include il flag isDoNotSell per trasmettere le informazioni sul consenso all'SDK Moloco.

Il seguente codice campione mostra come trasmettere le informazioni sul consenso all'SDK Moloco. Se scegli di impostare questi flag, ti consigliamo di farlo prima di richiedere gli annunci tramite GMA Next-Gen SDK.

Kotlin 

val privacySettings = PrivacySettings(isDoNotSell = true)
MolocoPrivacy.setPrivacy(privacySettings)

Java 

PrivacySettings privacySettings =
    new PrivacySettings(
        /* isUserConsent= */ false, /* isAgeRestrictedUser= */ false, /* isDoNotSell= */ true);
MolocoPrivacy.setPrivacy(privacySettings);

Per ulteriori informazioni, consulta la documentazione dell'SDK Moloco per Android.

Passaggio 5: testa l'implementazione

Attivare gli annunci di prova

Assicurati di registrare il tuo dispositivo di test per Ad Manager.

Verifica gli annunci di prova

Per verificare di ricevere annunci di test dall'SDK Moloco Ads, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio Moloco (asta).

Codici di errore

Se l'adattatore non riesce a ricevere un annuncio da Moloco, puoi controllare l'errore sottostante dalla risposta all'annuncio utilizzando ResponseInfo.getAdSourceResponses() nelle seguenti classi:

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

Ecco i codici e i messaggi associati generati dall'adattatore Moloco quando un annuncio non viene caricato:

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 dell'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.

Log delle modifiche dell'adattatore di mediazione Android di Moloco

Versione 4.13.0.0

  • Compatibilità verificata con l'SDK Moloco 4.13.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 25.5.0.
  • SDK Google Mobile Ads Next-Gen versione 1.5.0.
  • SDK Moloco versione 4.13.0.

Versione 4.12.0.1

  • Fissa la dipendenza Kotlin dell'adattatore alla versione 1.9.0 (la versione minima di Kotlin supportata dall'SDK GMA NextGen).

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 25.4.0.
  • SDK Google Mobile Ads Next-Gen versione 1.4.0.
  • Versione 4.12.0 dell'SDK Moloco.

Versione 4.12.0.0

  • Compatibilità verificata con l'SDK Moloco 4.12.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 25.4.0.
  • SDK Google Mobile Ads Next-Gen versione 1.4.0.
  • SDK Moloco versione 4.12.0.

Versione 4.11.1.0

  • Aggiornato per registrare un'impressione dell'annuncio quando viene visualizzato un annuncio nativo.
  • Risolto il problema relativo agli annunci banner che chiamavano il callback onAdOpened quando venivano selezionati anziché mostrati.
  • Compatibilità verificata con l'SDK Moloco 4.11.1.

Creata e testata con:

  • SDK Google Mobile Ads versione 25.4.0.
  • SDK Google Mobile Ads Next-Gen versione 1.3.1.
  • Versione 4.11.1 dell'SDK Moloco.

Versione 4.11.0.0

  • Aggiunto il supporto dei banner adattivi all'adattatore di mediazione Moloco.
  • È stata verificata la compatibilità con l'SDK Moloco 4.11.0.

Creata e testata con:

  • SDK Google Mobile Ads versione 25.4.0.
  • SDK Google Mobile Ads Next-Gen versione 1.3.1.
  • SDK Moloco versione 4.11.0.

Versione 4.10.1.0

  • Compatibilità verificata con l'SDK Moloco 4.10.1.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 25.4.0.
  • SDK Google Mobile Ads Next-Gen versione 1.2.1.
  • SDK Moloco versione 4.10.1.

Versione 4.10.0.0

  • Maps AgeRestrictedTreatment alle impostazioni con limiti di età di Moloco.
  • Compatibilità verificata con l'SDK Moloco 4.10.0.

Creata e testata con:

  • SDK Google Mobile Ads versione 25.4.0.
  • SDK Google Mobile Ads Next-Gen versione 1.2.1.
  • Versione 4.10.0 dell'SDK Moloco.

Versione 4.9.0.0

  • Compatibilità verificata con l'SDK Moloco 4.9.0.

Creata e testata con:

  • SDK Google Mobile Ads versione 25.3.0.
  • SDK Google Mobile Ads Next-Gen versione 1.1.1.
  • Versione 4.9.0 dell'SDK Moloco.

Versione 4.9.0.0 (in corso)

Versione 4.8.1.0

  • Compatibilità verificata con l'SDK Moloco 4.8.1.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 25.2.0.
  • SDK Google Mobile Ads Next-Gen versione 1.0.1.
  • Versione 4.8.1 dell'SDK Moloco.

Versione 4.8.0.0

  • Aggiornato per passare il contesto dell'applicazione a Moloco.initialize() anziché il contesto dell'attività per evitare perdite di memoria.
  • Compatibilità verificata con l'SDK Moloco 4.8.0.

Creata e testata con:

  • SDK Google Mobile Ads versione 25.2.0.
  • SDK Google Mobile Ads Next-Gen versione 0.25.0-beta01.
  • Versione 4.8.0 dell'SDK Moloco.

Versione 4.7.0.0

  • È stata aggiunta una proprietà per creare l'adattatore con la dipendenza dell'SDK GMA Next-Gen.
  • Compatibilità verificata con l'SDK Moloco 4.7.0.

Creata e testata con:

  • SDK Google Mobile Ads versione 25.1.0.
  • SDK Google Mobile Ads Next-Gen versione 0.25.0-beta01.
  • SDK Moloco versione 4.7.0.

Versione 4.6.0.0

  • Compatibilità verificata con l'SDK Moloco 4.6.0.

Creata e testata con:

  • SDK Google Mobile Ads versione 24.9.0.
  • SDK Moloco versione 4.6.0.

Versione 4.5.0.0

  • Compatibilità verificata con l'SDK Moloco 4.5.0.

Creata e testata con:

  • SDK Google Mobile Ads versione 24.9.0.
  • Versione 4.5.0 dell'SDK Moloco.

Versione 4.4.0.0

  • Compatibilità verificata con l'SDK Moloco 4.4.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 24.9.0.
  • SDK Moloco versione 4.4.0.

Versione 4.3.1.0

  • Compatibilità verificata con l'SDK Moloco 4.3.1.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 24.8.0.
  • Versione 4.3.1 dell'SDK Moloco.

Versione 4.2.1.0

  • Compatibilità verificata con l'SDK Moloco 4.2.1.

Creata e testata con:

  • SDK Google Mobile Ads versione 24.7.0.
  • SDK Moloco versione 4.2.1.

Versione 4.2.0.0

  • Compatibilità verificata con l'SDK Moloco 4.2.0.

Creata e testata con:

  • SDK Google Mobile Ads versione 24.7.0.
  • SDK Moloco versione 4.2.0.

Versione 4.1.1.0

  • Compatibilità verificata con l'SDK Moloco 4.1.1.

Creata e testata con:

  • SDK Google Mobile Ads versione 24.7.0.
  • Versione 4.1.1 dell'SDK Moloco.

Versione 4.1.0.0

  • Compatibilità verificata con l'SDK Moloco 4.1.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 24.6.0.
  • Versione 4.1.0 dell'SDK Moloco.

Versione 4.0.0.0

  • Compatibilità verificata con l'SDK Moloco 4.0.0.

Creata e testata con:

  • SDK Google Mobile Ads versione 24.5.0.
  • SDK Moloco versione 4.0.0.

Versione 3.12.1.0

  • Compatibilità verificata con l'SDK Moloco 3.12.1.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 24.5.0.
  • SDK Moloco versione 3.12.1.

Versione 3.12.0.0

  • Compatibilità verificata con l'SDK Moloco 3.12.0.

Creata e testata con:

  • SDK Google Mobile Ads versione 24.4.0.
  • Versione 3.12.0 dell'SDK Moloco.

Versione 3.11.0.0

  • Compatibilità verificata con l'SDK Moloco 3.11.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 24.4.0.
  • SDK Moloco versione 3.11.0.

Versione 3.10.0.0

  • È stata verificata la compatibilità con l'SDK Moloco 3.10.0.

Creata e testata con:

  • SDK Google Mobile Ads versione 24.3.0.
  • SDK Moloco versione 3.10.0.

Versione 3.9.0.0

  • Compatibilità verificata con l'SDK Moloco 3.9.0.

Creata e testata con:

  • SDK Google Mobile Ads versione 24.2.0.
  • SDK Moloco versione 3.9.0.

Versione 3.8.0.1

  • È stato aggiunto il supporto per le dimensioni degli annunci banner rettangolo medio.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 24.1.0.
  • SDK Moloco versione 3.8.0.

Versione 3.8.0.0

  • Aggiunto il supporto per l'asta per il formato dell'annuncio nativo.
  • Compatibilità verificata con l'SDK Moloco 3.8.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 24.1.0.
  • Versione 3.8.0 dell'SDK Moloco.

Versione 3.7.2.0

  • Compatibilità verificata con l'SDK Moloco 3.7.2.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 24.0.0.
  • SDK Moloco versione 3.7.2.

Versione 3.7.1.0

  • Il livello API Android minimo richiesto è stato aggiornato alla versione 23.
  • Aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 24.0.0.
  • Compatibilità verificata con l'SDK Moloco 3.7.1.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 24.0.0.
  • SDK Moloco versione 3.7.1.

Versione 3.7.0.0

  • Compatibilità verificata con l'SDK Moloco 3.7.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 23.6.0.
  • SDK Moloco versione 3.7.0.

Versione 3.6.1.0

  • Compatibilità verificata con l'SDK Moloco 3.6.1.

Creata e testata con:

  • SDK Google Mobile Ads versione 23.6.0.
  • SDK Moloco versione 3.6.1.

Versione 3.6.0.0

  • Compatibilità verificata con l'SDK Moloco 3.6.0.

Creata e testata con:

  • SDK Google Mobile Ads versione 23.6.0.
  • SDK Moloco versione 3.6.0.

Versione 3.5.0.0

  • Release iniziale.
  • Aggiunto il supporto per l'asta per i formati degli annunci banner, interstitial e con premio.
  • Compatibilità verificata con l'SDK Moloco 3.5.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 23.6.0.
  • Versione 3.5.0 dell'SDK Moloco.