Integrazione di Yahoo con la mediazione

Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di Yahoo utilizzando la mediazione e le integrazioni con struttura a cascata. Descrive come aggiungere Yahoo alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'adattatore e l'SDK Yahoo Mobile in un'appAndroid .

Integrazioni e formati degli annunci supportati

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

Integrazione
Offerte
Struttura a cascata
Formati
Banner
Interstitial
Con premio
Nativo

Requisiti

  • Livello API Android 19 o superiore

  • Versione più recente dell'SDK Google Mobile Ads

  • Completa la mediazione Guida introduttiva

Passaggio 1: imposta le configurazioni nella UI di Yahoo

Accedi all'SSP di Yahoo. In Applicazioni e siti, fai clic sul pulsante + e poi su Applicazione.

Compila il modulo e fai clic su Salva e aggiungi posizionamento per creare la tua app.

Dopo aver creato un'app, devi creare un posizionamento. Seleziona un tipo di posizionamento, compila il modulo e fai clic su Salva e monetizza.

Prendi nota dell'ID posizionamento.

Dovrai aggiungere un'origine annuncio al posizionamento. Nel modulo successivo, seleziona SSP di Yahoo come Origine annuncio e compila il modulo con le informazioni richieste. Dopo aver compilato il modulo, fai clic su Salva.

Infine, trascina l'origine annuncio appena creata nella tabella Origini annuncio con struttura a cascata per aggiungerla al posizionamento.

Prendi nota dell'ID sito.

Attivare la modalità di test

Gli annunci Yahoo possono essere testati creando un'origine annuncio di test e aggiungendola alle origini annuncio con struttura a cascata del posizionamento. Vai alle impostazioni dell'ID posizionamento, fai clic sul pulsante Aggiungi e seleziona Testa origine annuncio.

Dopo aver creato l'origine annuncio, trascinala nelle Origini annuncio con struttura a cascata del posizionamento.

È tutto. Ora disponi di un'integrazione della mediazione funzionante con Yahoo.

Passaggio 2: configura la domanda di Yahoo nell' AdMob UI

Configurare le impostazioni di mediazione per l'unità pubblicitaria

Devi aggiungere Yahoo alla configurazione della mediazione per la tua unità pubblicitaria.

Innanzitutto, accedi all'account AdMob. Quindi, vai alla scheda Mediazione. Se vuoi modificare un gruppo di mediazione esistente, fai clic sul nome del gruppo per modificarlo e vai alla sezione Aggiungi Yahoo 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. 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ù unità pubblicitarieAdMob esistenti. Poi, fai clic su Fine.

A questo punto, dovresti vedere la scheda delle unità pubblicitarie compilata con quelle selezionate:

Aggiungi Yahoo come origine annuncio

Nella scheda Con struttura a cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio. Seleziona Yahoo .

Seleziona Yahoo . Inserisci un valore eCPM per Yahoo e fai clic su Continua.

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

Quindi, inserisci l' Placement ID and Site ID ottenuto nella sezione precedente. Poi, fai clic su Fine.

Aggiungi Yahoo 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 Yahoo 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 Yahoo Mobile

Aggiungi le seguenti dipendenze di implementazione con le versioni più recenti dell'adattatore e dell'SDK Yahoo Ads nel file build.gradle a livello di app:

repositories {
    google()
    mavenCentral()
    maven {
      url 'https://artifactory.yahooinc.com/artifactory/maven/'
    }
}

...
dependencies {
    implementation 'androidx.appcompat:appcompat:1.2.0'
    implementation 'com.google.android.gms:play-services-ads:22.6.0'
    implementation 'com.google.ads.mediation:yahoo:1.4.1.1'
}
...

Integrazione manuale

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

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 seguente codice campione mostra come passare le informazioni sul consenso all'SDK Yahoo Mobile. Se scegli di chiamare questo metodo, ti consigliamo di farlo prima di richiedere gli annunci tramite l'SDK Google Mobile Ads.

Java

import com.yahoo.ads.YASAds;
import com.yahoo.ads.CcpaConsent;

// ...
CcpaConsent ccpaConsent = new CcpaConsent("<CCPA CONSENT>");
YASAds.addConsent(ccpaConsent);

Kotlin

import com.yahoo.ads.YASAds
import com.yahoo.ads.CcpaConsent

// ...
val ccpaConsent = CcpaConsent("<CCPA CONSENT>")
YASAds.addConsent(ccpaConsent)

Per ulteriori dettagli e per i valori che possono essere forniti nel metodo, consulta Impostazioni della privacy del publisher.

Passaggio 5: aggiungi il codice richiesto

Non è richiesto codice aggiuntivo per l'integrazione di Yahoo.

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 Yahoo UI.

Verifica annunci di prova

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

Passaggi facoltativi

Utilizzo degli annunci nativi

Rendering dell'annuncio

L'adattatore Yahoo restituisce gli annunci nativi come NativeAd oggetti. Compila i seguenti campi: Descrizioni dei campi degli annunci nativi di NativeAd.

Campo Compilato dall'adattatore Yahoo
Titolo
Immagine
Body
Icona dell'app
Call to action
Nome inserzionista
Star rating
Archiviazione
Prezzo

Log delle modifiche dell'adattatore di mediazione di Yahoo Android

Versione successiva

  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.4.0.

Versione 1.4.1.1

  • L'adattatore è stato aggiornato per utilizzare la nuova classe VersionInfo.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.0.0.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 22.0.0.
  • SDK Yahoo Mobile 1.4.1.

Versione 1.4.1.0

  • L'adattatore Verizon Media è stato rinominato "Yahoo".
  • Sono stati aggiunti codici di errore descrittivi e i motivi del caricamento dell'adattatore e mostra gli errori.
  • Compatibilità verificata con l'SDK Yahoo Mobile versione 1.4.1.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.5.0.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 21.5.0.
  • SDK Yahoo Mobile 1.4.1.