Integrare LY Ads Network con la mediazione

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

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione per la rete pubblicitaria LY Ads ha le seguenti funzionalità:

Prerequisiti

Prima di continuare, verifica quanto segue:

• Target di deployment iOS 13.0 o versioni successive.

• [Per l'asta]: per integrare tutti i formati degli annunci supportati nell'asta, utilizza l'adattatore LY Ads Network 2.8.20240827.0 o versioni successive (consigliata l'ultima versione).

• Ultima versione di Google Mobile Ads SDK.

• Configura Mediazione AdMob.

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

Registrati e accedi al tuo account LY Ads Network.

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

Crea un'area annuncio

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

Compila il modulo per i dettagli sullo slot. In Tipo di asta, seleziona Standard per configurare questo slot per la mediazione a cascata o Google SDK Bidding per configurare questo slot per l'asta. Fai clic su Crea dopo aver compilato il modulo.

Prendi nota dell'ID slot.

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

Crea una chiave API di 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 secret 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 l'inventario pubblicitario della tua 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 pubblicitaria LY nell'interfaccia utente di AdMob

Configura 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 già un gruppo di mediazione che vuoi modificare, fai clic sul nome del gruppo di mediazione per modificarlo e vai direttamente alla sezione Aggiungi LY Ads Network come rete pubblicitaria.

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. Poi, imposta lo stato del gruppo di mediazione su Attivato e 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 vedere la scheda delle unità pubblicitarie compilata con le unità pubblicitarie selezionate:

Aggiungi LY Ads Network come rete pubblicitaria

Offerte

Nella sezione Origini annuncio, individua la scheda Asta 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, quindi su Continua.



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



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

Cascata

Nella scheda A 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 area annuncio ottenuti nella sezione precedente. Dopodiché, fai clic su Fine.

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

Consigliato: utilizza Swift Package Manager

Prima di continuare, devi avere la versione minima supportata dell'adattatore, ovvero 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.

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 dalla rete pubblicitaria dal link di download nel log delle modifiche e collega LineAdapter.framework nel tuo progetto.

Utilizza CocoaPods

Aggiungi la seguente riga al Podfile del progetto:

pod 'GoogleMobileAdsMediationLine'

Dalla riga di comando, esegui:

pod install --repo-update

Passaggio 4: aggiungi il codice richiesto

Implementa SKAdNetwork

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

Passaggio 5: testa l'implementazione

Attiva gli annunci di prova

Assicurati di registrare il tuo dispositivo di test per AdMob.

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

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

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

GADMediationAdapterLine.testMode = YES;

Verifica gli annunci di prova

Per verificare che stai ricevendo annunci di prova dalla rete pubblicitaria LY Ads Network, attiva i test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio LY Ads Network.

Passaggi facoltativi

Parametri specifici della rete

L'adattatore 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 dell'annuncio

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

¹ Per gli annunci nativi, l'SDK LY Ads Network non fornisce un asset icona dell'app. Al contrario, l'adattatore di LY Ads Network compila l'icona dell'app con un'immagine trasparente.

Codici di errore

Se l'adattatore non riesce a ricevere un annuncio da LY Ads Network, puoi controllare l'errore sottostante dalla risposta all'annuncio utilizzando GADResponseInfo.adNetworkInfoArray nelle seguenti classi:

GADMediationAdapterLine

Ecco i codici e i messaggi associati generati dall'adattatore LY Ads Network quando non è possibile caricare un annuncio:

Log delle modifiche dell'adattatore di mediazione LINE per iOS

Versione 3.1.1.0

• È stata verificata la compatibilità con l'SDK FiveAd versione 3.1.1.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 13.9.0.
• SDK FiveAd versione 3.1.1.

Versione 3.1.0.0

• Ora è richiesta la versione minima di iOS 15.0.
• Compatibilità verificata con l'SDK FiveAd versione 3.1.0.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 13.8.0.
• SDK FiveAd versione 3.1.0.

Versione 3.0.1.2

• Aggiorna la versione minima di iOS per allentare la dipendenza dall'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.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 13.4.0.
• SDK FiveAd versione 3.0.1.

Versione 3.0.1.1

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

Sviluppato e testato con:

• SDK Google Mobile Ads versione 13.3.0.
• SDK FiveAd versione 3.0.1.

Versione 3.0.1.0

• Compatibilità verificata con l'SDK FiveAd versione 3.0.1.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 13.1.0.
• SDK FiveAd versione 3.0.1.

Versione 3.0.0.1

• Aggiornamento della dipendenza dell'SDK Google Mobile Ads alla versione 13.0.0.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 13.0.0.
• SDK FiveAd versione 3.0.0.

Versione 3.0.0.0

• Compatibilità verificata con l'SDK FiveAd versione 3.0.0.0.

Sviluppato e testato con:

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

Versione 2.9.20251119.1

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

Sviluppato e testato con:

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

Versione 2.9.20251119.0

• Compatibilità verificata con l'SDK FiveAd versione 2.9.20251119.

Sviluppato e testato con:

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

Versione 2.9.20250930.0

• Compatibilità verificata con l'SDK FiveAd versione 2.9.20250930.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 12.12.0.
• SDK FiveAd versione 2.9.20250930.

Versione 2.9.20250912.0

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

Sviluppato e testato con:

• SDK Google Mobile Ads versione 12.11.0.
• SDK FiveAd versione 2.9.20250912.

Versione 2.9.20250512.0

• Ora è richiesta la versione iOS 13.0 o successive.
• Compatibilità verificata con l'SDK FiveAd versione 2.9.20250512.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 12.4.0.
• SDK FiveAd versione 2.9.20250512.

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 degli annunci banner per l'asta dopo il caricamento riuscito.
  • Gli annunci banner con struttura a cascata continueranno a verificare le dimensioni degli annunci banner dopo il caricamento.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 12.2.0.
• SDK FiveAd versione 2.9.20241106.

Versione 2.9.20241106.2

• 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 dell'inizializzazione dell'SDK FiveAd.
• È stato rimosso il controllo dello stato degli annunci nativi deprecato prima del download degli asset annuncio nativi.
• Ora richiede l'SDK Google Mobile Ads versione 12.0.0 o successive.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 12.0.0.
• SDK FiveAd versione 2.9.20241106.

Versione 2.9.20241106.1

• L'adattatore è stato aggiornato per utilizzare l'API di caricamento degli annunci più recente per gli annunci banner per l'asta.
• Risolto un problema che impediva il corretto inoltro degli eventi degli annunci per gli annunci interstitial per l'asta.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 11.12.0.
• SDK FiveAd versione 2.9.20241106.

Versione 2.9.20241106.0

• Compatibilità verificata con l'SDK FiveAd versione 2.9.20241106.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 11.12.0.
• SDK FiveAd versione 2.9.20241106.

Versione 2.8.20240827.1

• Aggiornato CFBundleShortVersionString in modo che abbia tre componenti anziché quattro.

Sviluppato e testato con:

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

Versione 2.8.20240827.0

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

Sviluppato e testato con:

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

Versione 2.8.20240612.0

• Aggiunto il controllo audio per l'annuncio nativo tramite GADVideoOptions.
• Compatibilità verificata con l'SDK FiveAd versione 2.8.20240612.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 11.5.0.
• SDK FiveAd versione 2.8.20240612.

Versione 2.7.20240411.0

• Compatibilità verificata con l'SDK FiveAd versione 2.7.20240411.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 11.3.0.
• SDK FiveAd versione 2.7.20240411.

Versione 2.7.20240318.0

• Compatibilità verificata con l'SDK FiveAd versione 2.7.20240318.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 11.2.0.
• SDK FiveAd 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.
• Info.plist è stato incluso nei framework all'interno di LineAdapter.xcframework.

Sviluppato e testato con:

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

Versione 2.7.20240214.0

• Compatibilità verificata con l'SDK FiveAd versione 2.7.20240214.

Sviluppato e testato con:

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

Versione 2.7.20240126.0

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

Sviluppato e testato con:

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

Versione 2.7.20231115.0

• Compatibilità verificata con l'SDK FiveAd versione 2.7.20231115.
• Intestazione GADMediationAdapterLineExtras inclusa nel file modulemap.

Sviluppato e testato con:

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

Versione 2.6.20230609.1

• Aggiunta di GADMediationAdapterLineAudioState per gestire lo stato audio iniziale del banner, dell'interstitial e dell'annuncio con premio quando vengono visualizzati per la prima volta.

Sviluppato e testato con:

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

Versione 2.6.20230609.0

• Versione iniziale
• Aggiunto il supporto della struttura a cascata per i formati degli annunci banner, interstitial, con premio e nativi.
• Compatibilità verificata con l'SDK FiveAd versione 2.6.20230609.

Sviluppato e testato con:

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