Integrare LY Ads Network con la mediazione

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

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione per LY Ads Network ha le seguenti funzionalità:

Prerequisiti

Prima di continuare, verifica quanto segue:

• Target di distribuzione iOS 13.0 o versioni successive.

• [Per le offerte]: per integrare tutti i formati degli annunci supportati nelle offerte, utilizza l'adattatore di rete LY Ads 2.8.20240827.0 o versioni successive (consigliata l'ultima versione).

• Ultima versione di Google Mobile Ads SDK.

• Configura la Mediazione AdMob.

Passaggio 1: configura le configurazioni nell'interfaccia utente della rete LY Ads

Registrati e accedi al tuo account LY Ads Network.

Aggiungere una nuova applicazione

Vai alla scheda App e fai clic sul pulsante Nuova registrazione.

Compila il modulo e fai clic su Registrazione.

Prendi nota dell'ID app.

Creare un'area annunci

Nella scheda App, seleziona la tua app per visualizzarne i dettagli. Nella sezione Slot, fai clic su Aggiungi.

Compila il modulo per i dettagli dello spazio. Per Tipo di offerta, seleziona Standard per configurare questo slot per la mediazione a cascata oppure SDK Bidding di Google per configurare questo slot per le offerte. Una volta compilato il modulo, fai clic su Crea.

Prendi nota dell'ID slot.

Dopo aver creato il primo spazio pubblicitario, fai clic su Rivedi nella pagina dei dettagli dell'app per ottenere l'approvazione da LY Ads Network. Questa operazione potrebbe richiedere del tempo. Per eventuali domande, contatta il tuo rappresentante di LY Ads Network.

Creare una chiave API Reporting

Vai alla scheda Gestione delle chiavi API di reporting e fai clic sul pulsante Crea chiave API.

Compila il modulo e fai clic su Salva.

Prendi nota dell'ID chiave API e del segreto della chiave API.

Aggiorna il file app-ads.txt

Authorized Sellers for Apps app-ads.txt è un'iniziativa di IAB Tech Lab che contribuisce a garantire che il tuo inventario pubblicitario dell'app venga venduto solo tramite canali che hai identificato 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 LY Ads Network, consulta Informazioni su app-ads.txt.

Passaggio 2: configura la domanda della rete LY Ads nell'interfaccia utente di AdMob

Configurare le impostazioni di mediazione per l'unità pubblicitaria

Devi aggiungere LY Ads Network alla configurazione della mediazione per la tua unità pubblicitaria.

Innanzitutto, accedi al tuo account AdMob. Poi, vai alla scheda Mediazione. Se hai un gruppo di mediazione esistente che vuoi modificare, fai clic sul nome del gruppo di mediazione per modificarlo e vai alla sezione Aggiungere LY Ads Network come origine annuncio.

Per creare un nuovo gruppo di mediazione, seleziona Crea gruppo di mediazione.

Inserisci il formato dell'annuncio e la piattaforma, poi fai clic su Continua.

Assegna un nome al gruppo di mediazione e seleziona le località da scegliere come target. Successivamente, imposta lo stato del gruppo di mediazione su Attivato e poi fai clic su Aggiungi unità pubblicitarie.

Associa questo gruppo di mediazione a una o più delle tue unità pubblicitarie AdMob esistenti. Dopodiché, fai clic su Fine.

Ora dovresti visualizzare la scheda delle unità pubblicitarie compilata con le unità pubblicitarie selezionate:

Aggiungere LY Ads Network come origine annuncio

Offerte

Nella sezione Origini annuncio, individua la scheda Offerte e seleziona Aggiungi origine annuncio. Poi seleziona LY Ads Network .

Fai clic su Come firmare un contratto di partnership e configura una partnership per l'asta con LY Ads Network.



Fai clic su Conferma e accetta, poi su Continua.



Se hai già una mappatura per LY Ads Network, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.



Poi, inserisci l'ID applicazione e l'ID slot ottenuti nella sezione precedente. Poi fai clic su Fine.

Cascata

Nella scheda Cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio.

Seleziona LY Ads Network e attiva l'opzione Ottimizza. Inserisci l'ID chiave API e il secret della chiave API ottenuti nella sezione precedente per configurare l'ottimizzazione dell'origine annuncio per LY Ads Network. Poi inserisci un valore eCPM per LY Ads Network e fai clic su Continua.




Se hai già una mappatura per LY Ads Network, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.



Poi, inserisci l'ID applicazione e l'ID slot ottenuti nella sezione precedente. Poi fai clic su Fine.

Passaggio 3: importa l'SDK e l'adattatore LY Ads Network

Utilizzare Swift Package Manager

Prima di continuare, devi avere la versione minima supportata dell'adattatore 2.9.20251119.

Per aggiungere una dipendenza del pacchetto al tuo progetto, segui questi passaggi:

1. In Xcode, vai a File > Add Package Dependencies… (File > Aggiungi dipendenze pacchetto…).

2. Nel prompt visualizzato, cerca il seguente URL del pacchetto:

   https://github.com/googleads/googleads-mobile-ios-mediation-line.git
   

3. In Regola di dipendenza, seleziona Branch.

4. Nel campo di testo, inserisci main.

Utilizzare CocoaPods

Aggiungi la seguente riga al Podfile del tuo progetto:

pod 'GoogleMobileAdsMediationLine'

Dalla riga di comando, esegui:

pod install --repo-update

Integrazione manuale

• Scarica l'ultima versione dell'SDK LY Ads Network e collega FiveAd.framework nel tuo progetto.
• Scarica l'ultima versione dell'adattatore LY Ads Network dal link di download nel log delle modifiche e collega LineAdapter.framework nel tuo progetto.

Passaggio 4: aggiungi il codice richiesto

Implementare SKAdNetwork

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

Passaggio 5: testa l'implementazione

Attivare gli annunci di prova

Assicurati di registrare il tuo dispositivo di test per AdMob.

L'adattatore LY Ads Network contiene un metodo helper per attivare la modalità test per LY Ads Network. Devi impostare questa opzione prima di inizializzare Google Mobile Ads SDK per assicurarti che vengano inoltrate correttamente all'SDK LY Ads Network.

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

#import <LineAdapter/LineAdapter.h>
// ...

GADMediationAdapterLine.testMode = YES;

Verificare gli annunci di test

Per verificare di ricevere annunci di test dalla rete LY Ads, attiva i test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio LY Ads Network.

Passaggi facoltativi

Parametri specifici per la rete

L'adattatore di LY Ads Network supporta un parametro di richiesta aggiuntivo che può essere passato all'adattatore utilizzando la classe GADMediationAdapterLineExtras. Questa classe include le seguenti proprietà:

adAudio

Specifica lo stato di avvio predefinito dell'audio degli annunci banner, interstitial e con premio.

Di seguito è riportato un esempio di codice per creare una richiesta di annuncio che imposta questi parametri:

import LineAdapter
// ...

let request = GADRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

#import <LineAdapter/LineAdapter.h>
// ...

GADRequest *request = [GADRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];

Utilizzo degli annunci nativi

Rendering degli annunci

L'adattatore LY Ads Network compila le seguenti descrizioni avanzate dei campi degli annunci nativi per un GADNativeAd.

¹ Per gli annunci nativi, l'SDK LY Ads Network non fornisce un asset icona dell'app. L'adattatore LY Ads Network inserisce invece un'immagine trasparente nell'icona dell'app.

Codici di errore

Se l'adattatore non riceve un annuncio dalla rete LY Ads, puoi controllare l'errore sottostante nella risposta dell'annuncio utilizzando GADResponseInfo.adNetworkInfoArray nelle seguenti classi:

GADMediationAdapterLine

Ecco i codici e i messaggi associati generati dall'adattatore LY Ads Network quando un annuncio non viene caricato:

Log delle modifiche dell'adattatore di mediazione LINE per iOS

Versione 3.1.1.0

• Compatibilità verificata con la versione 3.1.1 dell'SDK FiveAd.

Creata e testata con:

• SDK Google Mobile Ads versione 13.9.0.
• Versione 3.1.1 dell'SDK FiveAd.

Versione 3.1.0.0

• Ora richiede la versione minima di iOS 15.0.
• Compatibilità verificata con la versione 3.1.0 dell'SDK FiveAd.

Creata e testata con:

• SDK Google Mobile Ads versione 13.8.0.
• Versione 3.1.0 dell'SDK FiveAd.

Versione 3.0.1.2

• Aggiorna la versione minima di iOS per allentare la dipendenza dell'SDK Google Mobile Ads e consentire le versioni secondarie.
• È stato risolto un problema per cui l'icona Scegli Tu! per gli annunci nativi era troppo grande.

Creata e testata con:

• SDK Google Mobile Ads versione 13.4.0.
• Versione 3.0.1 dell'SDK FiveAd.

Versione 3.0.1.1

• L'adattatore ora inoltra il flag dell'SDK Google Mobile Ads ageRestrictedTreatment all'API COPPA dell'SDK FiveAd.

Creata e testata con:

• SDK Google Mobile Ads versione 13.3.0.
• Versione 3.0.1 dell'SDK FiveAd.

Versione 3.0.1.0

• Compatibilità verificata con la versione 3.0.1 dell'SDK FiveAd.

Creata e testata con:

• SDK Google Mobile Ads versione 13.1.0.
• Versione 3.0.1 dell'SDK FiveAd.

Versione 3.0.0.1

• È stata aggiornata la dipendenza dell'SDK Google Mobile Ads alla versione 13.0.0.

Creata e testata con:

• SDK Google Mobile Ads versione 13.0.0.
• Versione 3.0.0 dell'SDK FiveAd.

Versione 3.0.0.0

• Compatibilità verificata con la versione 3.0.0.0 dell'SDK FiveAd.

Creata e testata con:

• SDK Google Mobile Ads versione 12.14.0.
• Versione 3.0.0 dell'SDK FiveAd.

Versione 2.9.20251119.1

• È stato aggiunto il supporto per l'inoltro dei parametri dell'SDK Google Mobile Ads tagForUnderAgeOfConsent all'SDK FiveAd.

Creata e testata con:

• SDK Google Mobile Ads versione 12.14.0.
• FiveAd SDK versione 2.9.20251119.

Versione 2.9.20251119.0

• Compatibilità verificata con la versione 2.9.20251119 dell'SDK FiveAd.

Creata e testata con:

• SDK Google Mobile Ads versione 12.14.0.
• FiveAd SDK versione 2.9.20251119.

Versione 2.9.20250930.0

• Compatibilità verificata con la versione 2.9.20250930 dell'SDK FiveAd.

Creata e testata con:

• SDK Google Mobile Ads versione 12.12.0.
• Versione 2.9.20250930 dell'SDK FiveAd.

Versione 2.9.20250912.0

• L'adattatore ora inizializza l'SDK FiveAd prima di ogni richiesta di annuncio.
• Compatibilità verificata con la versione 2.9.20250912 dell'SDK FiveAd.

Creata e testata con:

• SDK Google Mobile Ads versione 12.11.0.
• Versione 2.9.20250912 dell'SDK FiveAd.

Versione 2.9.20250512.0

• Ora richiede la versione minima di iOS 13.0.
• Compatibilità verificata con la versione 2.9.20250512 dell'SDK FiveAd.

Creata e testata con:

• SDK Google Mobile Ads versione 12.4.0.
• Versione 2.9.20250512 dell'SDK FiveAd.

Versione 2.9.20241106.3

• Risolto un problema per cui GADMediationAdapterLine.h non era un'intestazione pubblica.
• Flag -fobjc-arc e -fstack-protector-all abilitati.
• È stata rimossa la verifica delle dimensioni dell'annuncio banner per le offerte dopo il caricamento.
  • Gli annunci banner a cascata continueranno a controllare le dimensioni degli annunci banner dopo il caricamento riuscito.

Creata e testata con:

• SDK Google Mobile Ads versione 12.2.0.
• Versione 2.9.20241106 dell'SDK FiveAd.

Versione 2.9.20241106.2

• È stata aggiunta la proprietà GADMediationAdapterLine.testMode per indicare se l'SDK FiveAd deve essere inizializzato in modalità di test. Questo flag deve essere impostato prima di inizializzare l'SDK Google Mobile Ads.
• È stato rimosso il controllo dello stato di inizializzazione dell'SDK FiveAd prima di inizializzarlo.
• È stato rimosso il controllo dello stato dell'annuncio nativo ritirato prima del download degli asset annuncio nativo.
• 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 2.9.20241106 dell'SDK FiveAd.

Versione 2.9.20241106.1

• È stato aggiornato l'adattatore per utilizzare l'ultima API di caricamento degli annunci per gli annunci banner con offerta.
• Risolto un problema che impediva l'inoltro corretto degli eventi annuncio per le offerte per gli annunci interstitial.

Creata e testata con:

• SDK Google Mobile Ads versione 11.12.0.
• Versione 2.9.20241106 dell'SDK FiveAd.

Versione 2.9.20241106.0

• Compatibilità verificata con la versione 2.9.20241106 dell'SDK FiveAd.

Creata e testata con:

• SDK Google Mobile Ads versione 11.12.0.
• Versione 2.9.20241106 dell'SDK FiveAd.

Versione 2.8.20240827.1

• CFBundleShortVersionString è stato aggiornato e ora è composto da tre componenti anziché quattro.

Creata e testata con:

• SDK Google Mobile Ads versione 11.10.0.
• FiveAd SDK versione 2.8.20240827.

Versione 2.8.20240827.0

• Compatibilità verificata con la versione 2.8.20240827 dell'SDK FiveAd.
• Aggiunto il supporto delle offerte per i formati degli annunci banner, interstitial, con premio e nativi.

Creata e testata con:

• SDK Google Mobile Ads versione 11.8.0.
• FiveAd SDK versione 2.8.20240827.

Versione 2.8.20240612.0

• È stato aggiunto il controllo audio per gli annunci nativi tramite GADVideoOptions.
• Compatibilità verificata con la versione 2.8.20240612 dell'SDK FiveAd.

Creata e testata con:

• SDK Google Mobile Ads versione 11.5.0.
• Versione 2.8.20240612 dell'SDK FiveAd.

Versione 2.7.20240411.0

• È stata verificata la compatibilità con la versione 2.7.20240411 dell'SDK FiveAd.

Creata e testata con:

• SDK Google Mobile Ads versione 11.3.0.
• Versione 2.7.20240411 dell'SDK FiveAd.

Versione 2.7.20240318.0

• Compatibilità verificata con la versione 2.7.20240318 dell'SDK FiveAd.

Creata e testata con:

• SDK Google Mobile Ads versione 11.2.0.
• FiveAd SDK versione 2.7.20240318.

Versione 2.7.20240214.1

• Ora richiede la versione minima di iOS 12.0.
• Ora richiede l'SDK Google Mobile Ads versione 11.0 o successive.
• Incluso Info.plist nei framework all'interno di LineAdapter.xcframework.

Creata e testata con:

• SDK Google Mobile Ads versione 11.0.1.
• FiveAd SDK versione 2.7.20240214.

Versione 2.7.20240214.0

• È stata verificata la compatibilità con la versione 2.7.20240214 dell'SDK FiveAd.

Creata e testata con:

• SDK Google Mobile Ads versione 11.0.1.
• FiveAd SDK versione 2.7.20240214.

Versione 2.7.20240126.0

• Compatibilità verificata con la versione 2.7.20240126 dell'SDK FiveAd.
• È stata aggiornata l'implementazione dell'adattatore con i nuovi protocolli delegati dell'SDK FiveAd.

Creata e testata con:

• SDK Google Mobile Ads versione 10.14.0.
• Versione 2.7.20240126 dell'SDK FiveAd.

Versione 2.7.20231115.0

• Compatibilità verificata con la versione 2.7.20231115 dell'SDK FiveAd.
• Inclusa l'intestazione GADMediationAdapterLineExtras in modulemap.

Creata e testata con:

• SDK Google Mobile Ads versione 10.14.0.
• Versione 2.7.20231115 dell'SDK FiveAd.

Versione 2.6.20230609.1

• È stato aggiunto GADMediationAdapterLineAudioState per gestire lo stato audio iniziale del banner, dell'annuncio interstitial e dell'annuncio con premio quando viene visualizzato per la prima volta.

Creata e testata con:

• SDK Google Mobile Ads versione 10.14.0.
• FiveAd SDK versione 2.6.20230609.

Versione 2.6.20230609.0

• Versione iniziale
• È stato aggiunto il supporto della cascata per i formati degli annunci banner, interstitial, con premio e nativi.
• Compatibilità verificata con la versione 2.6.20230609 dell'SDK FiveAd.

Creata e testata con:

• SDK Google Mobile Ads versione 10.9.0.
• FiveAd SDK versione 2.6.20230609.