Integrare AdColony con la mediazione

Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci da AdColony utilizzando la mediazione, riguardando le integrazioni sia di asta che di struttura a cascata. Viene spiegato come aggiungere AdColony alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'adattatore e l'SDK AdColony in un'app Unity.

Integrazioni e formati degli annunci supportati

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

Integrazione
Offerte
Struttura a cascata
Formati
Banner
Interstitial
Con premio

Requisiti

  • Unity 5.6 o successive
  • Versione più recente dell'SDK Google Mobile Ads
  • [For bidding]: plug-in di mediazione Google Mobile Ads per AdColony 1.0.5 o versione successiva (ultima versione consigliata)
  • Per eseguire il deployment su Android
    • Livello API Android 19 o superiore
  • Per eseguire il deployment su iOS
    • Target di deployment per iOS 12.0 o versioni successive
  • Un progetto Unity funzionante configurato con l'SDK Google Mobile Ads. Consulta la guida introduttiva per i dettagli.
  • Completa la mediazione Guida introduttiva

Passaggio 1: imposta le configurazioni nell'interfaccia utente di AdColony

Registrati e accedi al tuo account AdColony. Aggiungi la tua app alla dashboard del publisher AdColony facendo clic sul pulsante Configura nuova app.

Configurazione nuova app di AdColony

Compila il modulo e fai clic su Crea nella parte inferiore della pagina per aggiungere la tua app ad AdColony.

Android

App di creazione AdColony

iOS

App di creazione AdColony

Una volta creata l'app, puoi ottenere il tuo ID app andando su Monetizzazione > App nella sezione Informazioni di base sull'app dell'app.

Android

ID app AdColony

iOS

ID app AdColony

Quindi, crea una nuova zona pubblicitaria facendo clic sul pulsante Configura nuova zona pubblicitaria nella sezione Zone pubblicitarie della pagina dell'app. Ti consigliamo di creare una nuova zona annuncio per la mediazione con AdMob , anche se ne hai già una.

Android

Zona di configurazione di AdColony

iOS

Zona di configurazione di AdColony

Per ulteriori istruzioni sulla creazione di un posizionamento dell'annuncio, seleziona la scheda corrispondente al formato dell'annuncio che preferisci.

  1. Imposta La zona è attiva? su Sì.

  2. Inserisci un nome per la zona pubblicitaria.

  3. Scegli Banner come Dimensioni dell'area annuncio.

  4. Inserisci un valore per Limite di riproduzione giornaliero.

Interstitial

  1. Imposta La zona è attiva? su Sì.

  2. Inserisci un nome per la zona pubblicitaria.

  3. Scegli Preroll/Interstitial come Tipo di zona.

  4. Inserisci un valore per Limite di riproduzione giornaliero.

Con premio

  1. Imposta La zona è attiva? su Sì.

  2. Inserisci un nome per la zona pubblicitaria.

  3. Scegli Scambio di valore/V4VC come Tipo di zona.

  4. Imposta Solo lato client? su Sì e inserisci un Nome valuta virtuale, Numero massimo di video giornalieri per utente e Importo del premio.

  5. Inserisci un valore per Limite di riproduzione giornaliero.

Fai clic sul pulsante Crea per creare la zona pubblicitaria.

Dopo aver creato la zona pubblicitaria, puoi individuare il tuo ID zona nella sezione Integrazione dell'area annuncio. L'ID zona verrà utilizzato nel passaggio successivo.

ID zona AdColony

Individuare la chiave API AdColony

Offerte

Questo passaggio non è obbligatorio per le integrazioni dell'asta.

Struttura a cascata

Per configurare l'AdMob ID unità pubblicitaria, devi avere la chiave API di AdColony. Vai a Impostazioni account nella dashboard del publisher AdColony per individuare la tua chiave API.

Impostazioni di AdColony

Attivare la modalità di test

Per attivare gli annunci di prova su AdColony, vai alla dashboard di AdColony e seleziona Monetizzazione > App. Seleziona la zona per cui vuoi attivare gli annunci di prova nella sezione Zone pubblicitarie dell'app. Gli annunci di prova possono essere attivati selezionando da Sì a Vuoi mostrare solo annunci di prova? nella sezione Sviluppo.

Test di AdColony

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

Configurare le impostazioni di mediazione per l'unità pubblicitaria

Android

Per le istruzioni, consulta il passaggio 2 della guida per Android.

iOS

Per le istruzioni, consulta il passaggio 2 nella guida per iOS.

Aggiungere AdColony all'elenco di partner pubblicitari ai sensi delle normative GDPR e degli stati USA

Segui i passaggi descritti in Impostazioni GDPR e Impostazioni relative alle normative statali degli Stati Uniti per aggiungere AdColony all'elenco di partner pubblicitari per le normative GDPR e statali degli Stati Uniti nell' AdMob UI.

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

Scarica la versione più recente del plug-in di mediazione degli annunci per dispositivi mobili di Google per AdColony dal link di download nel log delle modifiche ed estrai GoogleMobileAdsAdColonyMediation.unitypackage dal file ZIP.

Nell'editor del progetto Unity, seleziona Asset > Importa pacchetto > Pacchetto personalizzato e individua il file GoogleMobileAdsAdColonyMediation.unitypackage che hai scaricato. Assicurati che tutti i file siano selezionati e fai clic su Importa.

Quindi, seleziona Asset > Play Services Resolver > Android Resolver > Forza risoluzione. La libreria di Gestore delle dipendenze esterno eseguirà la risoluzione delle dipendenze da zero e copierà le dipendenze dichiarate nella directory Assets/Plugins/Android della tua app Unity.

Passaggio 4: implementa le impostazioni sulla privacy nell'SDK AdColony

Ai sensi delle Norme relative al consenso degli utenti dell'UE di Google, devi assicurarti che vengano fornite determinate informazioni relative all'utilizzo di identificatori di dispositivi e dati personali agli utenti dello Spazio economico europeo (SEE) e il loro consenso è stato ottenuto. 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 i dati personali e fornire informazioni sull'utilizzo di ogni rete. Al momento Google non è in grado di trasmettere automaticamente la scelta dell'utente relativa al consenso a queste reti.

Il plug-in di mediazione Google Mobile Ads per AdColony versione 2.6.1 ha aggiunto la classe AdColonyAppOptions con i metodi SetPrivacyFrameworkRequired() e SetPrivacyConsentString(), per consentirti di trasmettere il consenso all'SDK di AdColony. Il seguente codice campione mostra come passare le informazioni sul consenso all'adattatore AdColony, che vengono poi utilizzati nel metodo di inizializzazione di AdColony. Queste opzioni devono essere impostate prima di inizializzare l'SDK Google Mobile Ads per garantire che vengano inoltrate correttamente all'SDK di AdColony.

using GoogleMobileAds.Api.Mediation.AdColony;
// ...

AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.GDPR, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.GDPR, "myPrivacyConsentString");

Per ulteriori dettagli e per i valori che possono essere forniti nel metodo, consulta l'articolo sulla privacy dei consumatori di AdColony e la guida all'implementazione delle leggi sulla privacy.

Leggi statali sulla privacy degli Stati Uniti

Le leggi statali sulla privacy degli Stati Uniti richiedono che gli utenti abbiano il diritto di disattivare la "vendita" delle loro "informazioni personali" (secondo la definizione di questi termini fornita dalla legge) mediante il link "Non vendere le mie informazioni personali" ben visibile nella home page del "venditore". La guida alla conformità alle leggi statali sulla privacy degli Stati Uniti consente di attivare il trattamento dati limitato per la pubblicazione di annunci Google, ma Google non può applicare questa impostazione a ogni rete pubblicitaria nella catena di mediazione. Pertanto, devi identificare ogni rete pubblicitaria nella tua catena di mediazione che può partecipare alla vendita di informazioni personali e seguire le indicazioni di ciascuna di queste reti per garantire la conformità.

Il plug-in di mediazione Google Mobile Ads per AdColony versione 2.6.1 ha aggiunto la classe AdColonyAppOptions con i metodi SetPrivacyFrameworkRequired() e SetPrivacyConsentString(), per consentirti di trasmettere il consenso all'SDK di AdColony. Il seguente codice campione mostra come passare le informazioni sul consenso all'adattatore AdColony, che vengono poi utilizzati nel metodo di inizializzazione di AdColony. È necessario impostare queste opzioni prima di inizializzare l'SDK Google Mobile Ads per garantire che vengano inoltrate correttamente all'SDK di AdColony.

using GoogleMobileAds.Api.Mediation.AdColony;
// ...

AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.CCPA, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.CCPA, "myPrivacyConsentString");

Per ulteriori dettagli e per i valori che possono essere forniti nel metodo, consulta l'articolo sulla privacy dei consumatori di AdColony e la guida all'implementazione delle leggi sulla privacy.

Passaggio 5: aggiungi il codice richiesto

Android

Non è necessario alcun codice aggiuntivo per l'integrazione di AdColony.

iOS

Integrazione di SKAdNetwork

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

Passaggio 6: testa l'implementazione

Attiva annunci di prova

Assicurati di registrare il dispositivo di test per AdMob e abilitare la modalità di test nell'interfaccia AdColony UI.

Verifica annunci di prova

Per verificare di ricevere annunci di prova daAdColony, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le AdColony (Bidding) and AdColony (Waterfall) origini annuncio.

Passaggi facoltativi

Android

Autorizzazioni

Per prestazioni ottimali, AdColony consiglia di aggiungere le seguenti autorizzazioni facoltative nel file AndroidManifest.xml che si trova nella directory Assets/Plugins/Android/GoogleMobileAdsPlugin del tuo progetto Unity.

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

iOS

Non sono richiesti passaggi aggiuntivi per l'integrazione con iOS.

Parametri specifici della rete

Il pacchetto di mediazione AdColony supporta parametri aggiuntivi di configurazione e richiesta, che possono essere trasmessi all'adattatore utilizzando le classi AdColonyMediationExtras e AdColonyAppOptions.

La classe AdColonyMediationExtras include i seguenti metodi:

SetShowPrePopup(bool)
Imposta se mostrare o meno un popup prima di mostrare un annuncio. Imposta il valore false se non vuoi che venga mostrato un popup prima della visualizzazione degli annunci.
SetShowPostPopup(bool)
Imposta se mostrare o meno un popup dopo aver mostrato un annuncio. Imposta il valore false se non vuoi mostrare un popup dopo la visualizzazione degli annunci.

La classe AdColonyAppOptions include i seguenti metodi:

SetUserId(string)
Imposta lo User-ID per l'SDK AdColony che fornisce ulteriori analisi all'ad server di AdColony.
SetTestMode(bool)
Consente di stabilire se attivare o meno la modalità di test per l'SDK AdColony.

Ecco un esempio di codice di come impostare queste configurazioni e questi parametri di richiesta di annuncio:

// Set app-level configurations
AdColonyAppOptions.SetUserId("myUser");
AdColonyAppOptions.SetTestMode(true);

// Set ad request parameters
AdColonyMediationExtras extras = new AdColonyMediationExtras();
extras.SetShowPrePopup(true);
extras.SetShowPostPopup(true);

AdRequest request = new AdRequest.Builder()
        .AddMediationExtras(extras)
        .Build();

Codici di errore

Se l'adattatore non riceve un annuncio da AdColony, i publisher possono controllare l'errore sottostante dalla risposta di annuncio utilizzando ResponseInfo nelle seguenti classi:

Android

com.jirbo.adcolony.AdColonyAdapter
com.google.ads.mediation.adcolony.AdColonyMediationAdapter

iOS

GADMAdapterAdColony
GADMediationAdapterAdColony

Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore AdColony quando non viene caricato un annuncio:

Android

Codice di errore Motivo
100 L'SDK AdColony ha restituito un errore.
101 Parametri del server non validi (ad es. ID zona mancante).
102 È già stato richiesto un annuncio per lo stesso ID zona.
103 L'SDK AdColony ha restituito un errore di inizializzazione.
104 Le dimensioni del banner richieste non corrispondono a una dimensione di annuncio AdColony valida.
105 Errore di presentazione a causa di un annuncio non caricato.
106 Il contesto utilizzato per inizializzare l'SDK AdColony non era un'istanza Activity.

iOS

Codice di errore Motivo
0 - 3 L'SDK AdColony ha restituito un errore. Per ulteriori dettagli, consulta la documentazione.
101 Parametri del server non validi (ad es. ID zona mancante).
102 Il controller di visualizzazione principale che presenta l'annuncio è nil.
103 L'SDK AdColony ha restituito un errore di inizializzazione.
104 L'SDK AdColony non supporta la configurazione due volte in un periodo di cinque secondi.
105 Impossibile mostrare l'annuncio.
106 La zona utilizzata per l'assegnazione di premi non è una zona con premio sul portale AdColony.

Log delle modifiche del plug-in di mediazione AdColony Unity

Versione 2.6.3 (in corso)

  • È stato corretto un avviso di definizione duplicata per MediationExtras.

Versione 2.6.2

Versione 2.6.1

  • Aggiornamento delle API per la privacy dalla classe AdColonyAppOptions ai seguenti metodi per supportare GDPR e CCPA:
    • SetGDPRRequired(bool) -> SetPrivacyFrameworkRequired(AdColonyPrivacyFramework, bool)
    • IsGDPRRequired() -> GetPrivacyFrameworkRequired(AdColonyPrivacyFramework)
    • SetGDPRConsentString(string)-> SetPrivacyConsentString(AdColonyPrivacyFramework, string)
    • GetGDPRConsentString() -> GetPrivacyConsentString(AdColonyPrivacyFramework)
  • Supporta l'adattatore Android AdColony versione 4.8.0.1.
  • Supporta l'adattatore iOS AdColony versione 4.9.0.2.
  • Costruito e testato con il plug-in Unity di Google Mobile Ads versione 7.4.1.

Versione 2.6.0

Versione 2.5.0

Versione 2.4.1

Versione 2.4.0

Versione 2.3.0

Versione 2.2.0

Versione 2.1.0

Versione 2.0.3

Versione 2.0.2

Versione 2.0.1

Versione 2.0.0

Versione 1.0.6

Versione 1.0.5

  • I seguenti metodi sono stati spostati dalla classe Builder AdColonyMediationExtras alla classe AdColonyAppOptions:
    • SetGDPRRequired()
    • SetGDPRConsentString()
    • SetUserId()
    • SetTestMode()
  • Sono stati aggiunti i seguenti metodi alla classe AdColonyAppOptions:
    • IsGDPRRequired()
    • GetGDPRConsentString()
    • GetUserId()
    • IsTestMode()
  • Metodo SetZoneId() rimosso dalla classe Builder AdColonyMediationExtras.
  • Supporta l'adattatore Android AdColony versione 3.3.10.1.
  • Supporta l'adattatore iOS di AdColony versione 3.3.7.2.

Versione 1.0.4

  • Il plug-in è stato aggiornato in modo che supporti la nuova API con premio in versione beta aperta.
  • Supporta l'adattatore Android AdColony versione 3.3.8.1.
  • Supporta l'adattatore iOS di AdColony versione 3.3.6.1.

Versione 1.0.3

  • Supporta l'adattatore Android AdColony versione 3.3.5.1.
  • Supporta l'adattatore iOS di AdColony versione 3.3.5.0.

Versione 1.0.2

  • Supporta l'SDK AdColony per Android versione 3.3.4.
  • Supporta l'SDK AdColony per iOS versione 3.3.4.
  • SetTestMode() della classe Builder AdColonyMediationExtras ora viene ignorato per Android. Ora i publisher possono richiedere annunci di prova ad AdColony per Android specificando un dispositivo di test tramite AddTestDevice() dalla classe AdRequest Builder.
  • Sono stati aggiunti i seguenti metodi alla classe Builder AdColonyMediationExtras:
    • SetGDPRRequired()
    • SetGDPRConsentString()

Versione 1.0.1

  • Supporta l'SDK AdColony per Android versione 3.3.0-unity.
  • Supporta l'SDK AdColony per iOS versione 3.3.0.

Versione 1.0.0

  • Prima uscita.
  • Supporta l'SDK AdColony per Android versione 3.3.0.
  • Supporta l'SDK AdColony per iOS versione 3.3.0.