Integra Chartboost con la mediazione

Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di Chartboost utilizzando la mediazione, che copre le integrazioni a cascata. Spiega come aggiungere Chartboost alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore Chartboost in un'app Unity.

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione AdMob per Chartboost ha le seguenti funzionalità:

Integrazione
Offerte
Cascata
Formati
Banner
Interstitial
Con premio

Requisiti

  • SDK Google Mobile Ads più recente
  • Unity 4 o versioni successive
  • Per il deployment su Android
    • Livello API Android 23 o superiore
  • Per il deployment su iOS
    • Target di distribuzione iOS 12.0 o versioni successive
  • Un progetto Unity funzionante configurato con l'SDK Google Mobile Ads. Per maggiori dettagli, consulta la sezione Guida introduttiva.
  • Completa la mediazione Guida introduttiva

Passaggio 1: configura le configurazioni nell'interfaccia utente di Chartboost

Registrati per un account Chartboost e accedi una volta verificato l'account. Quindi, vai alla scheda Gestione app.

Dashboard delle app Chartboost

Fai clic sul pulsante Aggiungi nuova app per creare la tua app.

Gestione app

Compila il resto del modulo e fai clic sul pulsante Aggiungi app per finalizzare la tua app.

Nuovo modulo dell'app

Una volta creata l'app, verrà visualizzata la relativa dashboard. Prendi nota dell'ID app e della firma dell'app.

Android

Impostazioni app

iOS

Impostazioni app

AdMob richiede l'ID utente e la firma utente di Chartboost per configurare l'ID unità pubblicitaria AdMob. Puoi trovare questi parametri facendo clic su Mediazione Chartboost nell'interfaccia utente di Chartboost.

Dashboard di mediazione di Chartboost

Vai alla scheda Risorse > Esplora API e prendi nota dell'ID utente e della firma utente che si trovano nella sezione Autenticazione.

Explorer API di Chartboost

Aggiorna il file app-ads.txt

Authorized Sellers for Apps app-ads.txt è un'iniziativa IAB Tech Lab che garantisce la vendita dell'inventario pubblicitario della tua app solo in canali che hai indicato come autorizzati. Per evitare una perdita significativa delle entrate pubblicitarie, devi implementare un file app-ads.txt. Se non l'hai ancora fatto, configura un file app-ads.txt per la tua app.

Per implementare app-ads.txt per Chartboost, consulta app-ads.txt.

Attivare la modalità di test

Puoi attivare la modalità di test nella tua app andando alla scheda Gestione app nell'interfaccia utente di Chartboost, selezionando la tua app dall'elenco e facendo clic su Modifica impostazioni app.

Android

Modificare le impostazioni dell'app

iOS

Modificare le impostazioni dell'app

Dalle impostazioni dell'app, puoi attivare la modalità di test.

Modalità di test di Chartboost

Una volta attivata la modalità di test, puoi richiedere annunci utilizzando l'ID unità pubblicitaria creato in precedenza e ricevere un annuncio di test di Chartboost.

Dopo aver ricevuto gli annunci di test di Chartboost, la tua app verrà inserita nella revisione delle app dei publisher di Chartboost. Affinché la monetizzazione su Chartboost funzioni, la revisione dell'app del publisher deve essere approvata da Chartboost.

Passaggio 2: configura la domanda di Chartboost nell'interfaccia utente di AdMob

Configurare le impostazioni di mediazione per l'unità pubblicitaria

Android

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

iOS

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

Aggiungere Chartboost all'elenco dei partner pubblicitari ai sensi del GDPR e delle normative 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 Chartboost all'elenco dei partner pubblicitari per i regolamenti europei e statali degli Stati Uniti nell'interfaccia utente di AdMob.

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

OpenUPM-CLI

Se hai installato OpenUPM-CLI, puoi installare il plug-in di mediazione Chartboost per Unity nel tuo progetto eseguendo il seguente comando dalla directory principale del progetto:

openupm add com.google.ads.mobile.mediation.chartboost

OpenUPM

Nell'editor del progetto Unity, seleziona Modifica > Impostazioni progetto > Package Manager (Gestione pacchetti) per aprire le impostazioni di Unity Package Manager.

Nella scheda Registri con ambito, aggiungi OpenUPM come registro con ambito con i seguenti dettagli:

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Ambiti: com.google

Dettagli OpenUPM

Poi vai a Window > Package Manager per aprire Unity Package Manager e seleziona My Registries (I miei registri) dal menu a discesa.

Unity Registries

Seleziona il pacchetto Google Mobile Ads Chartboost Mediation e fai clic su Installa.

Installare da OpenUPM

Pacchetto Unity

Scarica l'ultima versione del plug-in di mediazione Google Mobile Ads per Chartboost dal link di download nel changelog ed estrai il GoogleMobileAdsChartboostMediation.unitypackage dal file zip.

Nell'editor del progetto Unity, seleziona Assets (Asset) > Import Package (Importa pacchetto) > Custom Package (Pacchetto personalizzato) e trova il file GoogleMobileAdsChartboostMediation.unitypackage che hai scaricato. Assicurati che tutti i file siano selezionati e fai clic su Importa.

Importa da Unity

Quindi, seleziona Asset > External Dependency Manager > Android Resolver > Force Resolve. La libreria External Dependency Manager esegue la risoluzione delle dipendenze da zero e copia le dipendenze dichiarate nella directory Assets/Plugins/Android della tua app Unity.

Forza risoluzione

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

In base alle Norme relative al consenso degli utenti dell'UE di Google, devi assicurarti che vengano fornite determinate informative agli utenti nello Spazio economico europeo (SEE) e che venga ottenuto il loro consenso in merito all'utilizzo degli identificatori del dispositivo e dei dati personali. Queste norme riflettono i requisiti della direttiva e-Privacy e del Regolamento generale sulla protezione dei dati (GDPR) dell'UE. Quando richiedi il consenso, devi identificare ogni rete pubblicitaria nella catena di mediazione che potrebbe raccogliere, ricevere o utilizzare dati personali e fornire informazioni sull'utilizzo di ciascuna rete. Al momento Google non è in grado di trasmettere automaticamente la scelta del consenso dell'utente a queste reti.

Il plug-in di mediazione Google Mobile Ads per Chartboost versione 3.1.0 include il metodo Chartboost.AddDataUseConsent(). Il seguente codice campione imposta il consenso all'utilizzo dei dati su NonBehavioral. Se scegli di chiamare questo metodo, ti consigliamo di farlo prima di richiedere annunci utilizzando l'SDK Google Mobile Ads.

using GoogleMobileAds.Api.Mediation.Chartboost;
// ...

Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);

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

Il plug-in di mediazione Google Mobile Ads per Chartboost versione 3.1.0 include il metodo Chartboost.AddDataUseConsent(). Il seguente codice campione imposta il consenso all'utilizzo dei dati su OptInSale. Se scegli di chiamare questo metodo, ti consigliamo di farlo prima di richiedere annunci utilizzando l'SDK Google Mobile Ads.

using GoogleMobileAds.Api.Mediation.Chartboost;
// ...

Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);

Passaggio 5: aggiungi il codice richiesto

Android

Non è necessario codice aggiuntivo per l'integrazione di Chartboost.

iOS

Integrazione di SKAdNetwork

Segui la documentazione di Chartboost per aggiungere gli identificatori SKAdNetwork al file Info.plist del tuo progetto.

Passaggio 6: testa l'implementazione

Attivare gli annunci di prova

Assicurati di registrare il dispositivo di prova per AdMob e di attivare la modalità di test nell'interfaccia utente di Chartboost.

Verificare gli annunci di prova

Per verificare di ricevere annunci di test da Chartboost, attiva il test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio Chartboost (cascata).

Passaggi facoltativi

Android

Autorizzazioni

Per un rendimento ottimale, Chartboost consiglia di aggiungere le seguenti autorizzazioni facoltative al file AndroidManifest.xml della tua app:

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

iOS

Non sono necessari ulteriori passaggi per l'integrazione di iOS.

Codici di errore

Se l'adattatore non riceve un annuncio da Chartboost, gli editori possono controllare l'errore sottostante nella risposta dell'annuncio utilizzando ResponseInfo nelle seguenti classi:

Android

com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter

iOS

GADMAdapterChartboost
GADMediationAdapterChartboost

Ecco i codici e i messaggi associati restituiti dall'adattatore Chartboost quando il caricamento di un annuncio non riesce:

Android

Codice di errore Motivo
0-99 L'SDK Chartboost ha restituito un errore.
101 La dimensione annuncio richiesta non corrisponde a una dimensione banner supportata da Chartboost.
102 Chartboost può caricare solo un annuncio per posizione alla volta.
103 I parametri del server Chartboost configurati nella UI di AdMob non sono presenti o non sono validi.
104 L'annuncio interstitial o con premio di Chartboost non è pronto per essere mostrato.

iOS

Codice di errore Motivo
101 I parametri del server Chartboost configurati nella UI di AdMob non sono presenti o non sono validi.
102 L'SDK Chartboost ha restituito un errore di inizializzazione.
103 L'annuncio Chartboost non viene memorizzato nella cache al momento della visualizzazione.
104 La dimensione annuncio richiesta non corrisponde a una dimensione banner supportata da Chartboost.
105 La versione del sistema operativo del dispositivo è inferiore alla versione minima del sistema operativo supportata dall'SDK Chartboost.
200-299 Errori della cache dell'SDK Chartboost. Per ulteriori dettagli, consulta il codice.
300-399 Chartboost SDK show errors. Per ulteriori dettagli, consulta il codice.
400-499 Errori di clic dell'SDK Chartboost. Per ulteriori dettagli, consulta il codice.

Log delle modifiche del plug-in di mediazione Unity di Chartboost

Versione 4.8.0

Versione 4.7.3

Versione 4.7.2

Versione 4.7.1

Versione 4.7.0

Versione 4.6.1

Versione 4.6.0

Versione 4.5.0

Versione 4.4.0

Versione 4.3.0

Versione 4.2.0

Versione 4.1.1

Versione 4.1.0

Versione 4.0.0

Versione 3.5.1

Versione 3.5.0

Versione 3.4.1

Versione 3.4.0

Versione 3.3.1

Versione 3.3.0

Versione 3.2.0

Versione 3.1.0

Versione 3.0.1

Versione 3.0.0

Versione 2.0.1

Versione 2.0.0

  • Supporta la versione 7.5.0.0 dell'adattatore Android Chartboost.
  • Supporta la versione 8.0.1.1 dell'adattatore iOS di Chartboost.

Versione 1.3.0

  • È stato aggiornato il plug-in per supportare la nuova API Rewarded.
  • Supporta la versione 7.3.1.1 dell'adattatore Android di Chartboost.
  • Supporta la versione 7.5.0.0 dell'adattatore iOS di Chartboost.

Versione 1.2.0

  • Supporta la versione 7.3.0.0 dell'adattatore Android di Chartboost.
  • Supporta la versione 7.3.0.0 dell'adattatore iOS di Chartboost.

Versione 1.1.1

  • Supporta la versione 7.2.0.1 dell'adattatore Android Chartboost.
  • Supporta la versione 7.2.0.1 dell'adattatore iOS di Chartboost.

Versione 1.1.0

  • Supporta la versione 7.2.0 dell'SDK Chartboost per Android.
  • Supporta l'SDK Chartboost per iOS versione 7.2.0.
  • È stato aggiunto il metodo Chartboost.RestrictDataCollection() per attivare le limitazioni alla raccolta dei dati del GDPR per l'SDK Chartboost.

Versione 1.0.0

  • Prima release.
  • Supporta la versione 7.0.1 dell'SDK Android di Chartboost.
  • Supporta la versione 7.1.2 dell'SDK Chartboost per iOS.