Integrazione di Yahoo con la mediazione

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

Integrazioni e formati degli annunci supportati

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

Integrazione
Offerte
Cascata
Formati
Banner
Interstitial
Con premio
Nativo

Requisiti

  • Livello API Android 19 o superiore

Passaggio 1: imposta le configurazioni nella UI di Yahoo

Accedi alla 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 l'app.

Una volta creata l'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.

Devi aggiungere un'origine annuncio al posizionamento. Nel modulo successivo, seleziona Yahoo SSP 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.

Attiva 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 di mediazione funzionante con Yahoo.

Passaggio 2: configura la domanda di Yahoo nell' AdMob interfaccia utente

Configurare le impostazioni di mediazione per l'unità pubblicitaria

Devi aggiungere Yahoo alla configurazione di 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 ad Aggiungere 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. Quindi, 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à pubblicitarie AdMob esistenti. Dopodiché, fai clic su Fine.

A questo punto, la scheda delle unità pubblicitarie dovrebbe essere completata con le unità pubblicitarie selezionate:

Aggiungere Yahoo come origine annuncio

Nella scheda Origini annuncio, seleziona Aggiungi rete pubblicitaria. Seleziona Yahoo, poi inserisci un valore eCPM per Yahoo e fai clic su Continua.

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

Quindi, inserisci l'ID posizionamento e l'ID sito ottenuti nella sezione precedente e fai clic su Fine.

Aggiungi Yahoo all'elenco di partner pubblicitari in base alle normative GDPR e statali degli Stati Uniti

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.5.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 di garantire agli utenti il diritto di disattivare la "vendita" delle proprie "informazioni personali" (secondo la definizione di questi termini dalla legge) mediante il link "Non vendere le mie informazioni personali" ben in evidenza nella home page del "venditore". La guida alla conformità alle leggi statali sulla privacy degli Stati Uniti offre la possibilità 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. Di conseguenza, devi identificare ogni rete pubblicitaria nella 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 trasmettere 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)

Consulta le impostazioni della privacy dell'editore per ulteriori dettagli e sui valori che possono essere forniti nel metodo.

Passaggio 5: aggiungi il codice richiesto

Non è richiesto alcun 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 di abilitare la modalità di test nell' Yahoo interfaccia utente.

Verifica annunci di prova

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

Passaggi facoltativi

Utilizzare gli annunci nativi

Rendering degli annunci

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

Campo Completato 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 Yahoo per 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, i motivi del caricamento dell'adattatore e la visualizzazione degli errori.
  • Verificata la compatibilità con la versione 1.4.1 dell'SDK Yahoo Mobile.
  • 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.