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 di 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 | |
Requisiti
Livello API Android 23 o superiore
Adattatore Moloco 3.8.0.0 o versioni successive
SDK Google Mobile Ads più recente
Completa la Guida introduttiva alla mediazione.
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 Ad Manager
Accedi al tuo account Ad Manager.
Attivare la condivisione di indicatori sicuri
Vai ad Amministratore > Impostazioni globali. Vai alla scheda Impostazioni dell'account Ad Exchange, esamina e attiva Condivisione degli indicatori sicuri. Fai clic su Salva.
Condividere indicatori sicuri nelle richieste di offerta
Vai a Inventario > Indicatori sicuri. In Indicatori sicuri, cerca SDK Moloco Ads 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.
Configurare 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 le offerte dell'SDK 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 Moloco Ads.
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 App Key e ID unità pubblicitaria ottenuti nella sezione precedente.
Infine, fai clic su Salva.
Aggiungere 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 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
Integrazione di Android Studio (consigliata)
Nel file build.gradle.kts a livello di app, aggiungi le seguenti dipendenze e configurazioni di implementazione. Utilizza le versioni più recenti dell'SDK e dell'adattatore Moloco:
dependencies {
implementation("com.google.android.gms:play-services-ads:24.5.0")
implementation("com.google.ads.mediation:moloco:3.12.1.0")
}
Passaggio 4: implementa le impostazioni della privacy nell'SDK Moloco
Consenso degli utenti dell'UE e GDPR
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
isUserConsent
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 gli annunci tramite l'SDK Google Mobile Ads.
Kotlin
import com.moloco.sdk.publisher.privacy.MolocoPrivacy
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings
// ...
val privacySettings = PrivacySettings(isUserConsent = true)
MolocoPrivacy.setPrivacy(privacySettings)
Java
import com.moloco.sdk.publisher.privacy.MolocoPrivacy;
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings;
// ...
// Moloco does not support setting one flag at a time in Java.
PrivacySettings privacySettings = new PrivacySettings(
/* isUserConsent */ true,
/* isAgeRestrictedUser */ false,
/* isDoNotSell */ false);
MolocoPrivacy.setPrivacy(privacySettings);
Per ulteriori informazioni, consulta la documentazione dell'SDK Moloco per Android.
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 gli annunci tramite l'SDK Google Mobile Ads.
Kotlin
import com.moloco.sdk.publisher.privacy.MolocoPrivacy
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings
// ...
val privacySettings = PrivacySettings(isDoNotSell = true)
MolocoPrivacy.setPrivacy(privacySettings)
Java
import com.moloco.sdk.publisher.privacy.MolocoPrivacy;
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings;
// ...
// Moloco does not support setting one flag at a time in 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 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, puoi controllare l'errore sottostante
dalla risposta dell'annuncio utilizzando
ResponseInfo.getAdapterResponses()
nelle seguenti classi:
com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter
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 | 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. |
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 Android di Moloco
Versione 4.0.0.0 (in corso)
Versione 3.12.1.0
- Compatibilità verificata con l'SDK Moloco 3.12.1.
Creata e testata con:
- SDK Google Mobile Ads versione 24.5.0.
- Versione 3.12.1 dell'SDK Moloco.
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.
Creata e testata con:
- SDK Google Mobile Ads versione 24.4.0.
- Versione 3.11.0 dell'SDK Moloco.
Versione 3.10.0.0
- Compatibilità verificata con l'SDK Moloco 3.10.0.
Creata e testata con:
- SDK Google Mobile Ads versione 24.3.0.
- Versione 3.10.0 dell'SDK Moloco.
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.
- Versione 3.9.0 dell'SDK Moloco.
Versione 3.8.0.1
- È stato aggiunto il supporto per le dimensioni degli annunci banner rettangolari medi.
Creata e testata con:
- SDK Google Mobile Ads versione 24.1.0.
- Versione 3.8.0 dell'SDK Moloco.
Versione 3.8.0.0
- È stato aggiunto il supporto delle offerte per il formato dell'annuncio nativo.
- Compatibilità verificata con l'SDK Moloco 3.8.0.
Creata e testata 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.
Creata e testata con:
- SDK Google Mobile Ads versione 24.0.0.
- Versione 3.7.2 dell'SDK Moloco.
Versione 3.7.1.0
- È stato aggiornato il livello API Android minimo richiesto a 23.
- È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 24.0.0.
- Compatibilità verificata con l'SDK Moloco 3.7.1.
Creata e testata con:
- SDK Google Mobile Ads versione 24.0.0.
- Versione 3.7.1 dell'SDK Moloco.
Versione 3.7.0.0
- Compatibilità verificata con l'SDK Moloco 3.7.0.
Creata e testata con:
- SDK Google Mobile Ads versione 23.6.0.
- Versione 3.7.0 dell'SDK Moloco.
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.
- Versione 3.6.1 dell'SDK Moloco.
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.
- 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, interstitial e con premio.
- Compatibilità verificata con l'SDK Moloco 3.5.0.
Creata e testata con:
- SDK Google Mobile Ads versione 23.6.0.
- Versione 3.5.0 dell'SDK Moloco.