Integrare Moloco con Mediazione AdMob

Questa guida mostra come utilizzare Google Mobile Ads SDK for React Native per caricare e visualizzare gli annunci display dall'SDK per gli annunci Moloco utilizzando la mediazione, che copre le integrazioni di asta. Viene spiegato 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 nativa React Native.

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione AdMob per l'SDK Moloco Ads ha le seguenti funzionalità:

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

Prerequisiti

Prima di continuare, verifica quanto segue:

Passaggio 1: imposta le configurazioni nell'interfaccia utente dell'SDK Moloco Ads

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.

Android

iOS

Una volta creata l'app, selezionala dalla scheda Apps (App) per visualizzare i dettagli e prendi nota della App Key (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 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 dell'SDK per gli annunci Moloco nell'interfaccia utente di AdMob

Configura le impostazioni di mediazione per l'unità pubblicitaria

Android

Per istruzioni, vedi il passaggio 2 della guida per Android.

iOS

Per istruzioni, consulta 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 AdMob.

Passaggio 3: importa l'SDK per gli annunci Moloco Ads e l'adattatore

Nella directory root del progetto, installa l'adattatore di mediazione Google Mobile Ads SDK for React Native per l'SDK per gli annunci Moloco. Completa i passaggi seguente:

  1. Copia il file tar dell'adattatore Google Mobile Ads SDK for React Native dalla directory gma-sdk-react-native/adapters/moloco/ nella directory local_packages/ del progetto. Se non hai la cartella adapters, consulta i Prerequisiti.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/moloco/gma-mediation-moloco-0.1.0.tgz local_packages/

    Sostituisci EXTRACT_DIR con il percorso della directory in cui hai estratto l'archivio.

  2. Installa il pacchetto dell'adattatore utilizzando il gestore di pacchetti che preferisci:

    npm

    npm install ./local_packages/gma-mediation-moloco-0.1.0.tgz

    filo

    yarn add ./local_packages/gma-mediation-moloco-0.1.0.tgz

Passaggio 4: implementa le impostazioni della privacy nell'SDK Moloco

Per rispettare le Norme relative al consenso degli utenti dell'UE di Google, devi informare gli 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 tua catena di mediazione.

La versione 0.1.0 e successive dell'adattatore React Native dell'SDK per gli annunci Moloco supporta il passaggio 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 la possibilità di opporsi alla "vendita" delle proprie "informazioni personali" (secondo la definizione di questi termini fornita dalla legge) mediante il link "Non vendere i miei dati 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 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 Ads include il metodo Moloco.SetDoNotSell(bool) per trasmettere le informazioni sul consenso all'SDK per gli annunci Moloco Ads. 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 SDK for React Native.

import { MolocoMediation } from '@google/gma-mediation-moloco';
// ...

MolocoMediation.setDoNotSell(true);

Per maggiori dettagli, consulta le istruzioni di implementazione consigliate per l'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

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, 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.
104 com.google.ads.mediation.moloco Inizializzazione dell'SDK Moloco non riuscita.
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.

Versione 0.1.0

  • Release iniziale.