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 AdMob, che copre le integrazioni delle offerte. Spiega come aggiungere Moloco alla configurazione di 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 offre le seguenti funzionalità:

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

Requisiti

  • Target di distribuzione iOS 12.0 o versioni successive

  • Adattatore Moloco 3.9.1.0 o versioni successive

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.

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 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 AdMob

Configurare le impostazioni di mediazione per l'unità pubblicitaria

Devi aggiungere l'SDK Moloco Ads alla configurazione della mediazione per l'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 alla sezione Aggiungere l'SDK Moloco Ads 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. Successivamente, imposta lo stato del gruppo di mediazione su Attivato e poi fai clic su Aggiungi unità pubblicitarie.

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

Ora dovresti vedere la scheda delle unità pubblicitarie compilata con le unità pubblicitarie che hai selezionato:

Aggiungi l'SDK Moloco Ads come origine annuncio

Nella scheda Offerte della sezione Origini annuncio, seleziona Aggiungi origine annuncio. Poi seleziona SDK Moloco Ads .

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



Fai clic su Riconosci e accetta, poi su Continua.



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



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

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

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

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

  • Aggiungi la seguente riga al Podfile del 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 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. Sei responsabile della verifica che il consenso venga propagato a ogni origine annuncio nella tua catena di mediazione. Google non è in grado di trasmettere automaticamente la scelta del consenso dell'utente a queste reti.

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

Il seguente esempio di codice mostra come trasmettere le informazioni sul consenso all'SDK Moloco. Se scegli di impostare questi flag, ti consigliamo di farlo prima di richiedere annunci tramite l'SDK Google Mobile Ads.

Swift 

import MolocoSDK
// ...

MolocoPrivacySettings.hasUserConsent = true;

Objective-C 

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

[MolocoPrivacySettings setHasUserConsent:YES];

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

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 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 dati 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 esempio di codice mostra come trasmettere le informazioni sul consenso all'SDK Moloco. Se scegli di impostare questi flag, ti consigliamo di farlo prima di richiedere annunci tramite l'SDK Google Mobile Ads.

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

Attivare gli annunci di prova

Assicurati di registrare il dispositivo di test per AdMob.

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, puoi controllare l'errore sottostante dalla risposta dell'annuncio utilizzando GADResponseInfo.adNetworkInfoArray nelle seguenti classi:

MolocoSDK.MolocoError
GADMediationAdapterMoloco

Di seguito sono riportati i codici e i messaggi associati restituiti 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 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 dell'adattatore di mediazione Moloco per iOS

Versione 3.13.0.0

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

Creata e testata con:

  • SDK Google Mobile Ads versione 12.9.0.
  • Versione 3.13.0 dell'SDK Moloco.

Versione 3.12.1.0

  • Compatibilità verificata con la versione 3.12.1 dell'SDK Moloco.

Creata e testata con:

  • SDK Google Mobile Ads versione 12.8.0.
  • Versione 3.12.1 dell'SDK Moloco.

Versione 3.12.0.0

  • Compatibilità verificata con la versione 3.12.0 dell'SDK Moloco.

Creata e testata con:

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

Versione 3.11.0.0

  • Compatibilità verificata con la versione 3.11.0 dell'SDK Moloco.

Creata e testata con:

  • SDK Google Mobile Ads versione 12.6.0.
  • Versione 3.11.0 dell'SDK Moloco.

Versione 3.10.1.0

  • Compatibilità verificata con la versione 3.10.1 dell'SDK Moloco.

Creata e testata con:

  • SDK Google Mobile Ads versione 12.6.0.
  • Versione 3.10.1 dell'SDK Moloco.

Versione 3.10.0.0

  • Compatibilità verificata con la versione 3.10.0 dell'SDK Moloco.

Creata e testata con:

  • SDK Google Mobile Ads versione 12.5.0.
  • Versione 3.10.0 dell'SDK Moloco.

Versione 3.9.1.0

  • È stato 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 la versione 3.9.1 dell'SDK Moloco.

Creata e testata con:

  • SDK Google Mobile Ads versione 12.3.0.
  • Versione 3.9.1 dell'SDK Moloco.

Versione 3.9.0.0

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

Creata e testata con:

  • SDK Google Mobile Ads versione 12.3.0.
  • Versione 3.9.0 dell'SDK Moloco.

Versione 3.8.0.0

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

Creata e testata con:

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

Versione 3.7.2.0

  • Compatibilità verificata con la versione 3.7.2 dell'SDK Moloco.
  • È stato aggiunto il supporto delle offerte per il formato dell'annuncio nativo.

Creata e testata con:

  • SDK Google Mobile Ads versione 12.1.0.
  • Versione 3.7.2 dell'SDK Moloco.

Versione 3.7.1.0

  • Compatibilità verificata con la versione 3.7.1 dell'SDK Moloco.

Creata e testata con:

  • SDK Google Mobile Ads versione 12.1.0.
  • Versione 3.7.1 dell'SDK Moloco.

Versione 3.7.0.0

  • Compatibilità verificata con la versione 3.7.0 dell'SDK Moloco.

Creata e testata con:

  • SDK Google Mobile Ads versione 12.0.0.
  • Versione 3.7.0 dell'SDK Moloco.

Versione 3.6.0.1

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

Creata e testata con:

  • SDK Google Mobile Ads versione 12.0.0.
  • Versione 3.6.0 dell'SDK Moloco.

Versione 3.6.0.0

  • È stata verificata la compatibilità con la versione 3.6.0 dell'SDK Moloco.

Creata e testata con:

  • SDK Google Mobile Ads versione 11.13.0.
  • Versione 3.6.0 dell'SDK Moloco.

Versione 3.5.0.0

  • Release iniziale.
  • È stato aggiunto il supporto delle offerte per i formati degli annunci banner (incluso MREC), interstitial e con premio.
  • Compatibilità verificata con la versione 3.5.0 dell'SDK Moloco.

Creata e testata con:

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