Integrare la Rete di annunci LINE con la mediazione

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

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione AdMob per LINE Ads Network offre le seguenti funzionalità:

Integrazione
Offerte
Cascata
Formati
Banner
Interstitial
Con premio
Nativo  1

1 Gli annunci nativi (per le offerte) sono in versione beta chiusa. Contatta il tuo account manager per richiedere l'accesso.

Requisiti

  • SDK Google Mobile Ads più recente
  • Flutter 3.7.0 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 Flutter funzionante configurato con l'SDK Google Mobile Ads. Per maggiori dettagli, consulta la sezione Guida introduttiva.
  • Completa la Guida introduttiva alla mediazione.

Passaggio 1: configura le configurazioni nell'interfaccia utente di LINE Ads Network

Registrati e accedi al tuo account LINE Ads Network.

Aggiungere una nuova applicazione

Fai clic su 広告枠管理 (Ad Slot Management) > メディア (Media). Poi, fai clic su 新規作成 (Crea nuovo).

Compila il modulo e fai clic su 登録 (Registrati).

Prendi nota dell'ID applicazione.

Crea un posizionamento dell'annuncio

Fai clic sull'ID dell'applicazione a cui vuoi aggiungere un posizionamento dell'annuncio. Poi, seleziona 詳細 (Dettagli).

Fai clic su スロット 追加 (Aggiungi slot).

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 登録 (Registrati).

Prendi nota dell'ID slot.

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 LINE Ads Network, consulta Informazioni su app-ads.txt.

Passaggio 2: configura la domanda della rete LINE Ads 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.

Passaggio 3: importa l'SDK e l'adattatore della rete pubblicitaria LINE

Integrazione tramite pub.dev

Aggiungi la seguente dipendenza con le versioni più recenti dell'SDK e dell'adattatore della rete pubblicitaria LINE nel file pubspec.yaml del pacchetto:

dependencies:
  gma_mediation_line: ^

Integrazione manuale

Scarica l'ultima versione del plug-in di mediazione Google Mobile Ads per LINE Ads Network, estrai il file scaricato e aggiungi la cartella del plug-in estratto (e i relativi contenuti) al tuo progetto Flutter. Quindi, fai riferimento al plug-in nel file pubspec.yaml aggiungendo la seguente dipendenza:

dependencies:
  gma_mediation_line:
    path: path/to/local/package

Passaggio 4: aggiungi il codice richiesto

Android

Per l'integrazione di LINE Ads Network non è necessario codice aggiuntivo.

iOS

Integrazione di SKAdNetwork

Segui la documentazione di LINE 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 dispositivo di test per AdMob.

Verificare gli annunci di prova

Per verificare di ricevere annunci di prova dalla Rete LINE Ads, attiva i test di singole origini annuncio nella funzionalità di controllo degli annunci utilizzando le origini annuncio Rete LINE Ads (a cascata).

Passaggi facoltativi

Parametri specifici per la rete

Il plug-in di mediazione Flutter della rete pubblicitaria LINE 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 di banner, interstitial e annunci con premio.

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

LineMediationExtras lineExtras = LineMediationExtras(enableAdSound: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [lineExtras],
);

Codici di errore

Se l'adattatore non riceve un annuncio dalla rete LINE Ads Network, gli editori possono controllare l'errore sottostante dalla risposta dell'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 LINE Ads Network quando un annuncio non viene caricato:

Android

Codice di errore Dominio Motivo
1-10 com.five_corp.ad L'SDK LINE Ads Network ha restituito un errore specifico dell'SDK. Per ulteriori dettagli, consulta la documentazione di LINE 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 La dimensione annuncio richiesta non corrisponde a una dimensione annuncio banner supportata da LINE Ads Network.
104 com.google.ads.mediation.line Impossibile caricare un annuncio interstitial o con premio a causa della mancanza del contesto dell'attività.
105 com.google.ads.mediation.line L'SDK LINE Ads Network non è riuscito a mostrare un interstitial o un annuncio con premio.
106 com.google.ads.mediation.line Impossibile caricare un annuncio nativo a causa di asset mancanti.

iOS

Codice di errore Dominio Motivo
1-10 Inviato dall'SDK LINE Ads Network L'SDK LINE Ads Network ha restituito un errore specifico dell'SDK. Per ulteriori dettagli, consulta la documentazione di LINE Ads Network.
101 com.google.ads.mediation.line Parametri del server non validi (ad es. ID applicazione o ID slot mancante).
102 com.google.ads.mediation.line La dimensione annuncio richiesta non corrisponde a una dimensione annuncio banner supportata da LINE Ads Network.
103 com.google.ads.mediation.line Impossibile caricare un asset immagine dell'icona informativa nell'annuncio nativo.

Log delle modifiche dell'adattatore di mediazione Line Flutter

Versione 1.0.4 (in corso)

Versione 1.0.3

Versione 1.0.2

Versione 1.0.1

Versione 1.0.0