Integrare Moloco con la mediazione

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

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

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione Ad Manager per l'SDK per gli annunci Moloco ha le seguenti funzionalità:

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

Prerequisiti

Prima di continuare, verifica quanto segue:

  • Ultima versione di Google Mobile Ads Unity Plugin.
  • Unity Editor versione 5.6 o successive.
  • Plug-in Unity Moloco 1.2.0 o versioni successive.
  • Per il deployment su Android
    • Livello API Android 24 o versioni successive.
  • Per il deployment su iOS
    • Target di deployment iOS 13.0 o versioni successive.
  • Un progetto Unity funzionante configurato con Google Mobile Ads Unity Plugin. Per informazioni dettagliate, consulta Configurare Google Mobile Ads Unity Plugin.
  • Configura la mediazione.

    • Passaggio 1: configura le impostazioni nell'interfaccia utente dell'SDK Moloco Ads

    Accedi al Portale dei publisher Moloco.

    Vai alla scheda Panoramica > App, poi 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 prendi nota della chiave 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 dell'SDK Moloco Ads 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.

    Aggiungi Moloco Ads all'elenco dei partner pubblicitari ai sensi del GDPR e dei regolamenti 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 Moloco Ads e l'adattatore

    OpenUPM-CLI

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

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

    OpenUPM

    Nell'editor del progetto Unity, seleziona Edit > 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.

    Installa da OpenUPM

    Pacchetto Unity

    Scarica l'ultima versione del plug-in di mediazione Google Mobile Ads per l'SDK per gli annunci Moloco dal link di download nel log delle modifiche ed estrai il file GoogleMobileAdsMolocoMediation.unitypackage dal file ZIP.

    Nell'editor del progetto Unity, seleziona Assets (Asset) > Import Package (Importa pacchetto) > Custom Package (Pacchetto personalizzato) e individua il file GoogleMobileAdsMolocoMediation.unitypackage che hai scaricato. Assicurati che tutti i file siano selezionati e fai clic su Importa.

    Importa da Unity

    Poi, seleziona Assets > External Dependency Manager > Android Resolver > Force Resolve. La libreria External Dependency Manager eseguirà la risoluzione delle dipendenze da zero e copierà le dipendenze dichiarate nella directory Assets/Plugins/Android della tua app Unity.

    Forza risoluzione

    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 informazioni agli utenti nello Spazio economico europeo (SEE), nel Regno Unito e in Svizzera e ottenere il loro consenso per l'utilizzo dei cookie o di altri tipi di archiviazione locale, laddove richiesto dalla legge, nonché per la raccolta, la condivisione e l'utilizzo dei dati personali ai fini della 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.

    L'adattatore Unity dell'SDK per gli annunci Moloco versione 1.0.0 e successive supporta la trasmissione 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 per Android e la stringa di consenso TCF per iOS.

    Leggi statali sulla privacy degli Stati Uniti

    Le leggi statali sulla privacy degli Stati Uniti impongono di garantire agli utenti il diritto di disattivare la "vendita" delle proprie "informazioni personali" (da intendersi secondo la definizione di questi termini fornita dalla legge), mediante un link ben visibile 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à.

    Il plug-in di mediazione Unity di Google Mobile Ads per l'SDK per gli annunci Moloco include il metodo Moloco.SetDoNotSell(bool) per trasmettere le informazioni sul consenso all'SDK per gli annunci Moloco. Il seguente codice campione mostra come trasmettere queste informazioni sul consenso all'SDK per gli annunci Moloco Ads. Se scegli di impostare questi flag, ti consigliamo di farlo prima di richiedere gli annunci tramite Google Mobile Ads Unity Plugin.

    using GoogleMobileAds.Api.Mediation.Moloco;
// ...

Moloco.SetDoNotSell(true);

    Per ulteriori dettagli, consulta le istruzioni di implementazione consigliate dell'SDK per gli annunci Moloco per Android e iOS.

    Passaggio 5: aggiungi il codice richiesto

    Non è necessario codice aggiuntivo per l'integrazione dell'SDK Moloco Ads.

    Passaggio 6: testa l'implementazione

    Attivare gli annunci di prova

    Assicurati di registrare il dispositivo di test per Ad Manager.

    Verificare gli annunci di test

    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, i publisher possono controllare l'errore sottostante dalla risposta all'annuncio utilizzando ResponseInfo nelle seguenti classi:

    Android

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

    iOS

    MolocoSDK.MolocoError
GADMediationAdapterMoloco

    Ecco i codici e i messaggi associati generati 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 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.

    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 mostrato.
    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.

    Log delle modifiche del plug-in di mediazione Moloco Unity

    Versione 3.11.0 (in corso)

    Versione 3.10.1

    Versione 3.10.0

    Versione 3.9.1

    Versione 3.9.0

    Versione 3.8.1

    Versione 3.8.0

    Versione 3.7.0

    Versione 3.6.1

    Versione 3.6.0

    Versione 3.5.1

    Versione 3.5.0

    Versione 3.4.1

    Versione 3.4.0

    Versione 3.3.1

    Versione 3.3.0

    Versione 3.2.0

    Versione 3.1.0

    Versione 3.0.0

    Versione 2.2.1

    Versione 2.2.0

    Versione 2.1.0

    Versione 2.0.0

    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