Integrare LY Ads Network con la Mediazione AdMob

Seleziona la piattaforma: Android iOS Unity Flutter React Native Android (legacy)

Questa guida mostra come utilizzare Google Mobile Ads SDK for React Native per caricare e visualizzare gli annunci di LY Ads Network utilizzando la mediazione, che copre le integrazioni con la struttura a cascata. Spiega come aggiungere 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 React Native.

Integrazioni e formati degli annunci supportati

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

Integrazione
Offerte
Cascata
Formati
Apertura app
Banner
Interstitial
Con premio
Interstitial con premio
Nativo

Prerequisiti

Prima di continuare, verifica quanto segue:

• Ultima versione di Google Mobile Ads SDK for React Native.
• Framework React Native versione 0.85.0 o successive.
• Per eseguire il deployment su Android
  • Livello API Android 24 o versioni successive.
• Per il deployment su iOS
  • Target di deployment iOS 13.0 o versioni successive.
• Un progetto React Native funzionante configurato con Google Mobile Ads SDK for React Native. Per informazioni dettagliate, consulta Configura Google Mobile Ads SDK for React Native.
  • Assicurati di aver scaricato ed estratto la cartella adapters dalla cartella gma-sdk-react-native. Se non hai la cartella adapters, segui i passaggi uno, due e tre della sezione Installare Google Mobile Ads SDK for React Native.
• 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.

Nota: dovrai creare un'app separata per ogni piattaforma che intendi supportare.

Prendi nota dell'ID app.

Android

iOS

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.

Nota: il formato pubblicitario e il tipo di asta non possono essere modificati dopo la registrazione dell'area annuncio. Contatta il tuo account manager LY Ads Network per ottenere l'accesso per creare posizionamenti degli annunci nativi nell'interfaccia utente di LY Ads Network.

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

Android

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

iOS

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

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

Nota: la mancata integrazione delle versioni compatibili di LY Ads Network e dell'SDK Google Mobile Ads potrebbe causare problemi di build.

Nella directory root del progetto, installa l'adattatore di mediazione Google Mobile Ads SDK for React Native per la rete pubblicitaria LY Ads. Completa i passaggi seguente:

1. Copia il file tar dell'adattatore Google Mobile Ads SDK for React Native dalla directory gma-sdk-react-native/adapters/line/ nella directory local_packages/ del progetto. Se non hai la cartella adapters, consulta i Prerequisiti.

   mkdir -p local_packages
   cp EXTRACT_DIR/gma-sdk-react-native/adapters/line/gma-mediation-line-0.1.0.tgz local_packages/
   

   Sostituisci EXTRACT_DIR con il percorso della directory in cui hai estratto l'archivio.

2. Installa il pacchetto dell'adattatore utilizzando il gestore di pacchetti che preferisci:

   npm

   npm install ./local_packages/gma-mediation-line-0.1.0.tgz
   

   filo

   yarn add ./local_packages/gma-mediation-line-0.1.0.tgz
   

Passaggio 4: aggiungi il codice richiesto

Android

Non è necessario alcun codice aggiuntivo per l'integrazione di LY Ads Network.

iOS

Integrazione di 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

Attiva gli annunci di prova

Assicurati di registrare il tuo dispositivo di test per AdMob.

Importante: disattiva la modalità di test per AdMob e LY Ads Network prima di rilasciare l'app.

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

Il plug-in di mediazione React Native di LY Ads Network supporta il seguente parametro di richiesta aggiuntivo che può essere passato all'adattatore tramite la classe LineMediationExtras:

• enableAdSound : specifica lo stato di avvio dell'audio predefinito 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 { LineMediationExtras } from '@google/gma-mediation-line';

const request = {
  // ...
  mediationExtras: [
    new LineMediationExtras({
      enableAdSound: true,
    }),
  ],
};

Codici di errore

Se l'adattatore non riesce a ricevere un annuncio da LY Ads Network, i publisher possono controllare l'errore sottostante dalla risposta all'annuncio utilizzando ResponseInfo nelle seguenti classi:

Android

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

iOS

GADMediationAdapterLine

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

Android

Codice di errore	Dominio	Motivo
1-10	com.five_corp.ad	L'SDK LY Ads Network ha restituito un errore specifico dell'SDK. Per saperne di più, consulta la documentazione di LY Ads Network.
101	com.google.ads.mediation.line	ID applicazione mancante o non valido.
102	com.google.ads.mediation.line	ID slot mancante o non valido.
103	com.google.ads.mediation.line	Le dimensioni dell'annuncio richieste non corrispondono a quelle di un annuncio banner supportato dalla rete pubblicitaria LY Ads Network.
104	com.google.ads.mediation.line	Impossibile caricare un annuncio interstitial o con premio a causa di un contesto di attività mancante.
105	com.google.ads.mediation.line	L'SDK LY Ads Network non è riuscito a mostrare un annuncio interstitial o con premio.
106	com.google.ads.mediation.line	Impossibile caricare un annuncio nativo a causa di asset mancanti.
107	com.google.ads.mediation.line	L'SDK FiveAd ha restituito un caricatore di annunci nullo.

iOS

Codice di errore	Dominio	Motivo
1-10	Inviato dall'SDK della rete pubblicitaria LY	L'SDK LY Ads Network ha restituito un errore specifico dell'SDK. Per saperne di più, consulta la documentazione di LY Ads Network.
101	com.google.ads.mediation.line	Parametri del server non validi (ad es. ID applicazione o ID area annuncio mancante).
102	com.google.ads.mediation.line	Le dimensioni dell'annuncio richieste non corrispondono a quelle di un annuncio banner supportato dalla rete pubblicitaria LY Ads Network.
103	com.google.ads.mediation.line	Impossibile caricare un asset immagine dell'icona informazioni nell'annuncio nativo.
104	com.google.ads.mediation.line	Impossibile raccogliere gli indicatori per l'asta.
105	com.google.ads.mediation.line	Impossibile inizializzare il caricatore di annunci dell'SDK LINE Ads.

Versione 0.1.0

• Release iniziale.

• Supporta l'adattatore LINE per Android versione 3.1.1.2.
• Supporta l'adattatore LINE per iOS versione 3.1.1.0.
• Creato e testato con la versione 0.1.0 del plug-in React Native di Google Mobile Ads.