Questa guida mostra come utilizzare GMA Next-Gen SDK per caricare e mostrare gli annunci di Moloco utilizzando la mediazione, incluse le integrazioni di offerte. Viene illustrato 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 ha le seguenti funzionalità:
| Integrazione | |
|---|---|
| Asta | |
| A cascata | |
| Formati | |
| Apertura app | |
| Banner | |
| Interstitial | |
| Con premio | |
| Interstitial con premio | |
| Nativo | |
Requisiti
Ultima versione GMA Next-Gen SDK
Completa la Guida introduttiva alla mediazione.
Passaggio 1: configura le impostazioni nell'interfaccia utente di Moloco
Accedi al Portale dei publisher di Moloco.
Vai alla scheda Panoramica > App e fai clic sul pulsante Aggiungi app per creare una nuova app.
Seleziona il sistema operativo e le impostazioni sulla 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 visualizzarne i dettagli e prendere nota della chiave dell'app.
Vai alla scheda Panoramica > Unità pubblicitarie , seleziona l'app dal menu a discesa e fai clic su Nuova unità pubblicitaria.
Seleziona Offerte in-app come metodo di asta e compila il resto del modulo. Poi, 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 ad Amministratore > Impostazioni globali. Vai alla scheda Impostazioni dell'account Ad Exchange , esamina e attiva l'opzione Condivisione di indicatori sicuri. Fai clic su Salva.
Condividi indicatori sicuri nelle richieste di offerta
Vai a Inventario > Indicatori sicuri. In Indicatori sicuri, cerca SDK Moloco Ads e attiva l'opzione 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 di 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.
Configura la mappatura delle unità pubblicitarie
Vai a Pubblicazione > Offerenti e fai clic su Vai a SDK Bidding.
Seleziona la società 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 per dispositivi mobili come il tipo di inventario e la tua applicazione mobile. Poi, inserisci la chiave dell'app e l'ID unità pubblicitaria ottenuti nella sezione precedente.
Infine, fai clic su Salva.
Aggiungi Moloco Ads all'elenco dei partner pubblicitari per le normative europee 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 le normative europee e statali degli Stati Uniti 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.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
implementation("com.google.ads.mediation:moloco:4.6.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 sulla privacy nell'SDK Moloco
Consenso dell'UE e GDPR
Per rispettare le Norme relative al consenso degli utenti dell'UE di Google, è obbligatorio informare i tuoi utenti nello Spazio economico europeo (SEE), nel Regno Unito e in Svizzera e ricevere 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 catena di mediazione. Google non è in grado di trasmettere automaticamente la scelta di consenso dell'utente a queste reti.
L'SDK Moloco include il
isUserConsent
flag per trasmettere le informazioni sul consenso all'SDK Moloco.
Il seguente codice campione mostra come passare 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
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 maggiori 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 la possibilità di opporsi alla "vendita" delle proprie "informazioni personali" (secondo la definizione di questi termini fornita dalla legge) mediante il link "Non vendere le mie informazioni personali" ben in evidenza 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 catena di mediazione. Pertanto, devi identificare ogni rete pubblicitaria nella 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 passare 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
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 maggiori informazioni, consulta la documentazione dell'SDK Moloco per Android.
Passaggio 5: prova l'implementazione
Attiva 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 prova dall' SDK Moloco Ads, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio Moloco (Offerte).
Codici di errore
Se l'adattatore non riesce a ricevere un annuncio da Moloco, puoi controllare l'errore sottostante
dalla risposta dell'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 annuncio Moloco restituito era null. |
| -1 to 5000 | com.moloco.sdk | L'SDK Moloco ha restituito un errore. Per maggiori dettagli, consulta la documentazione di Moloco. |