Integrare Moloco con la mediazione

Questa guida mostra come utilizzare Google Mobile Ads SDK per caricare e visualizzare gli annunci display di Moloco utilizzando la Mediazione AdMob, che copre le integrazioni di asta. 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 iOS.

Integrazioni e formati degli annunci supportati

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

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

Prerequisiti

Prima di continuare, verifica quanto segue:

  • Target di deployment iOS 13.0 o versioni successive.

  • Adattatore Moloco 3.9.1.0 o versioni successive.

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

Accedi al portale dei publisher di Moloco.

Vai alla scheda Panoramica > App, quindi 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 prendi nota della 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 AdMob

Configura le impostazioni di mediazione per l'unità pubblicitaria

Devi aggiungere l'SDK Moloco Ads alla configurazione della mediazione per la tua unità pubblicitaria.

Innanzitutto, accedi al tuo account AdMob. Poi, vai alla scheda Mediazione. Se hai un gruppo di mediazione esistente che vuoi modificare, fai clic sul nome del gruppo di mediazione per modificarlo e vai direttamente ad Aggiungi l'SDK per gli annunci Moloco come origine annuncio.

Per creare un nuovo gruppo di mediazione, seleziona Crea gruppo di mediazione.

Inserisci il formato dell'annuncio e la piattaforma, poi fai clic su Continua.

Assegna un nome al gruppo di mediazione e seleziona le località da scegliere come target. Poi, imposta lo stato del gruppo di mediazione su Attivato e fai clic su Aggiungi unità pubblicitarie.

Associa questo gruppo di mediazione a una o più unità pubblicitarie AdMob esistenti. Dopodiché, fai clic su Fine.

Ora dovresti vedere la scheda delle unità pubblicitarie compilata con le unità pubblicitarie selezionate:

Aggiungi l'SDK Moloco Ads come origine annuncio


Nella sezione Origini annuncio, individua la scheda Asta e seleziona Aggiungi origine annuncio. Poi seleziona SDK Moloco Ads .

Fai clic su Come firmare un contratto di partnership e configura una partnership per l'asta con Moloco SDK per gli annunci.



Fai clic su Conferma e accetta, quindi su Continua.



Se hai già una mappatura per l'SDK per gli annunci Moloco, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.



Poi, inserisci la chiave app e l'ID unità pubblicitaria ottenuti nella sezione precedente. Dopodiché, fai clic su Fine.

Aggiungi Moloco Ads all'elenco dei partner pubblicitari per i 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 dei regolamenti europei e statali degli Stati Uniti nell'interfaccia utente di AdMob.

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

Utilizza Swift Package Manager

Prima di continuare, devi disporre della versione minima supportata dell'adattatore, ovvero la 4.1.0.0.

Per aggiungere una dipendenza del pacchetto al tuo progetto, segui questi passaggi:

  1. In Xcode, vai a File > Add Package Dependencies… (File > Aggiungi dipendenze pacchetto…).

  2. Nel prompt visualizzato, cerca il seguente URL del pacchetto:

    https://github.com/googleads/googleads-mobile-ios-mediation-moloco.git

  3. In Regola di dipendenza, seleziona Branch.

  4. Nel campo di testo, inserisci main.

Utilizza CocoaPods

  • Aggiungi la seguente riga al Podfile del tuo progetto:

    pod 'GoogleMobileAdsMediationMoloco'

  • Dalla riga di comando, esegui:

    pod install --repo-update

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.

La versione 3.5.0.0 e successive dell'adattatore iOS dell'SDK per gli annunci Moloco 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 sezione Stringa di consenso TCF.

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 sulla privacy degli stati USA 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 Google Mobile Ads SDK.

Swift 

import MolocoSDK
// ...

MolocoPrivacySettings.isDoNotSell = true;

Objective-C 

#import <MolocoSDK/MolocoSDK-Swift.h>
// ...

[MolocoPrivacySettings setIsDoNotSell:YES];

Per saperne di più, consulta la documentazione sulla privacy di Moloco.

Passaggio 5: testa l'implementazione

Attiva gli annunci di prova

Assicurati di registrare il tuo dispositivo di test per AdMob.

Verifica gli annunci di prova

Per verificare di ricevere annunci di prova dall'SDK per gli annunci Moloco, attiva il test di un'origine annuncio singola nello strumento di controllo degli annunci utilizzando le origini annuncio Moloco (Bidding).

Codici di errore

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

MolocoSDK.MolocoError
GADMediationAdapterMoloco

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 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 dell'adattatore di Mediazione Moloco per iOS

Versione 4.12.0.0 (in corso)

Versione 4.11.1.0

  • Compatibilità verificata con l'SDK Moloco versione 4.11.1.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.11.0.
  • SDK Moloco versione 4.11.1.

Versione 4.11.0.0

  • Compatibilità verificata con l'SDK Moloco versione 4.11.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.11.0.
  • SDK Moloco versione 4.11.0.

Versione 4.10.0.0

  • Compatibilità verificata con l'SDK Moloco versione 4.10.0.
  • Aggiornamento per indicare che l'SDK Moloco può monitorare le impressioni degli annunci nativi.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.9.0.
  • SDK Moloco versione 4.10.0.

Versione 4.9.1.0

  • Compatibilità verificata con l'SDK Moloco versione 4.9.1.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.8.0.
  • SDK Moloco versione 4.9.1.

Versione 4.9.0.0

  • Compatibilità verificata con l'SDK Moloco versione 4.9.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.7.0.
  • SDK Moloco versione 4.9.0.

Versione 4.8.1.1

  • Aggiunto il supporto per le dimensioni degli annunci banner adattivi.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.6.0.
  • SDK Moloco versione 4.8.1.

Versione 4.8.1.0

  • Compatibilità verificata con l'SDK Moloco versione 4.8.1.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.6.0.
  • SDK Moloco versione 4.8.1.

Versione 4.8.0.0

  • Compatibilità verificata con l'SDK Moloco versione 4.8.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.6.0.
  • SDK Moloco versione 4.8.0.

Versione 4.7.0.0

  • Compatibilità verificata con l'SDK Moloco versione 4.7.0.
  • Aggiorna la versione minima di iOS per allentare la dipendenza dall'SDK Google Mobile Ads e consentire le versioni secondarie.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.5.0.
  • SDK Moloco versione 4.7.0.

Versione 4.6.1.1

  • L'adattatore ora inoltra il flag dell'SDK Google Mobile Ads ageRestrictedTreatment all'API COPPA dell'SDK Moloco.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.3.0.
  • SDK Moloco versione 4.6.1.

Versione 4.6.1.0

  • Compatibilità verificata con l'SDK Moloco versione 4.6.1.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.3.0.
  • SDK Moloco versione 4.6.1.

Versione 4.6.0.0

  • Compatibilità verificata con l'SDK Moloco versione 4.6.0.

Sviluppato e testato con:

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

Versione 4.5.1.0

  • Compatibilità verificata con l'SDK Moloco versione 4.5.1.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.2.0.
  • SDK Moloco versione 4.5.1.

Versione 4.5.0.0

  • Compatibilità verificata con l'SDK Moloco versione 4.5.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.1.0.
  • SDK Moloco versione 4.5.0.

Versione 4.4.1.0

  • Compatibilità verificata con l'SDK Moloco versione 4.4.1.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.1.0.
  • SDK Moloco versione 4.4.1.

Versione 4.4.0.0

  • Compatibilità verificata con l'SDK Moloco versione 4.4.0.

Sviluppato e testato con:

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

Versione 4.3.0.2

  • Aggiornamento della dipendenza dell'SDK Google Mobile Ads alla versione 13.0.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.0.0.
  • SDK Moloco versione 4.3.0.

Versione 4.3.0.1

  • Aggiornata la versione minima di iOS di CocoaPods a 13.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.0.0.
  • SDK Moloco versione 4.3.0.

Versione 4.3.0.0

  • Compatibilità verificata con l'SDK Moloco versione 4.3.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 12.14.0.
  • SDK Moloco versione 4.3.0.

Versione 4.2.0.0

  • Compatibilità verificata con l'SDK Moloco versione 4.2.0.

Sviluppato e testato con:

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

Versione 4.1.2.0

  • Compatibilità verificata con l'SDK Moloco versione 4.1.2.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 12.14.0.
  • SDK Moloco versione 4.1.2.

Versione 4.1.0.0

  • Compatibilità verificata con l'SDK Moloco versione 4.1.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 12.14.0.
  • SDK Moloco versione 4.1.0.

Versione 3.13.0.0

  • Include Info.plist all'interno dei framework.
  • Compatibilità verificata con l'SDK Moloco versione 3.13.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 12.9.0.
  • SDK Moloco versione 3.13.0.

Versione 3.12.1.0

  • Compatibilità verificata con l'SDK Moloco versione 3.12.1.

Sviluppato e testato con:

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

Versione 3.12.0.0

  • Compatibilità verificata con l'SDK Moloco versione 3.12.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 12.8.0.
  • SDK Moloco versione 3.12.0.

Versione 3.11.0.0

  • Compatibilità verificata con l'SDK Moloco versione 3.11.0.

Sviluppato e testato con:

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

Versione 3.10.1.0

  • Compatibilità verificata con l'SDK Moloco versione 3.10.1.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 12.6.0.
  • SDK Moloco versione 3.10.1.

Versione 3.10.0.0

  • Compatibilità verificata con l'SDK Moloco versione 3.10.0.

Sviluppato e testato con:

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

Versione 3.9.1.0

  • Aggiunto il supporto della filigrana per i formati degli annunci per l'asta.
  • È stato risolto un problema durante il caricamento degli annunci banner MREC.
  • Compatibilità verificata con l'SDK Moloco versione 3.9.1.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 12.3.0.
  • SDK Moloco versione 3.9.1.

Versione 3.9.0.0

  • Il nome della piattaforma di mediazione viene ora impostato durante l'inizializzazione dell'SDK Moloco.
  • Compatibilità verificata con l'SDK Moloco versione 3.9.0.

Sviluppato e testato con:

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

Versione 3.8.0.0

  • Flag -fobjc-arc e -fstack-protector-all abilitati.
  • Risolto un problema relativo all'ottenimento della valutazione a stelle per gli annunci nativi.
  • Compatibilità verificata con l'SDK Moloco versione 3.8.0.

Sviluppato e testato con:

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

Versione 3.7.2.0

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

Sviluppato e testato con:

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

Versione 3.7.1.0

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

Sviluppato e testato con:

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

Versione 3.7.0.0

  • Compatibilità verificata con l'SDK Moloco versione 3.7.0.

Sviluppato e testato con:

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

Versione 3.6.0.1

  • L'adattatore è stato aggiornato per recuperare la versione dell'SDK Moloco dal thread principale.
  • Ora richiede l'SDK Google Mobile Ads versione 12.0.0 o successive.

Sviluppato e testato con:

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

Versione 3.6.0.0

  • Compatibilità verificata con l'SDK Moloco versione 3.6.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 11.13.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 (incluso MREC), interstitial e con premio.
  • Compatibilità verificata con l'SDK Moloco versione 3.5.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 11.13.0.
  • SDK Moloco versione 3.5.0.