Integrare Moloco con le offerte

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 iOS.

Integrazioni e formati degli annunci supportati

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

Requisiti

• Target di distribuzione iOS 12.0 o versioni successive

• Adattatore Moloco 3.9.1.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

Utilizzo di CocoaPods (opzione consigliata)

• 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

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

import MolocoSDK
// ...

MolocoPrivacySettings.hasUserConsent = true;

#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.

import MolocoSDK
// ...

MolocoPrivacySettings.isDoNotSell = true;

#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 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 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:

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.