Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci da Tapjoy utilizzando la mediazione, coprendo le integrazioni sia per l'asta che per la struttura a cascata. Descrive come aggiungere annunci Tapjoy
alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK
e l'adattatore Tapjoy in un' Android app.
Integrazioni e formati degli annunci supportati
L' AdMob adattatore di mediazione per Tapjoy ha le seguenti funzionalità:
Aggiungi la tua app alla dashboard Tapjoy accedendo all'elenco delle app in alto a destra e facendo clic sul pulsante Aggiungi app. Ti verrà chiesto di
inserire i dettagli dell'app.
Compila il modulo e fai clic sul pulsante Crea ora per aggiungere la tua app alla dashboard Tapjoy.
Puoi saltare i passaggi di integrazione presentati da Tapjoy e passare alla creazione di posizionamenti da utilizzare con la AdMob mediazione.
Posizionamento, valuta virtuale e contenuti
Posizionamento
Vai a Monetizzazione > Posizionamenti e fai clic sul pulsante Crea posizionamento nell'angolo in alto a destra. Anche se hai già un posizionamento, è meglio crearne uno nuovo per AdMob in modo che possa essere monitorato e riportato separatamente.
Inserisci un nome per il posizionamento, seleziona la casella di controllo Mediazione e seleziona AdMob dall'elenco a discesa. Al termine, fai clic su Crea.
Il Nome posizionamento inserito qui viene utilizzato per impostare l'AdMob unità pubblicitaria per la mediazione nella sezione successiva.
In questo esempio è stata utilizzata la funzionalità "AdMob Mediazione", ma puoi chiamare il posizionamento come preferisci.
Valuta virtuale
Vai a Monetizzazione > Valuta virtuale e fai clic sul pulsante Crea valuta virtuale nell'angolo in alto a destra.
Compila il modulo e fai clic su Crea ora. Usa NO_CALLBACK come
URL di callback. Ciò garantisce che l'SDK Tapjoy eviti chiamate non necessarie al tuo server.
Il valore e il nome della valuta non vengono inoltrati dall'adattatore Tapjoy, pertanto
è possibile scegliere valori generici per il nome e l'importo della valuta.
Contenuti
Vai a Monetizzazione > Crea contenuti per creare contenuti da mostrare con i posizionamenti.
Per ulteriori istruzioni sulla creazione di contenuti, seleziona la scheda corrispondente al
formato di annuncio preferito:
Oltre al nome del posizionamento, devi disporre anche della chiave SDK per configurare
l'unità pubblicitaria AdMob .
Vai a Impostazioni > Impostazioni app. Puoi ottenere la chiave SDK dalla sezione Informazioni sull'app nella scheda Piattaforme di applicazione.
Individuare le chiavi dei report
Offerte
Questo passaggio non è obbligatorio per le integrazioni dell'asta.
Struttura a cascata
Per continuare, devi avere la chiave OAuth del publisher e la chiave di mediazione.
Puoi ottenere la chiave OAuth del publisher nella stessa pagina nella scheda Chiavi API.
Puoi ottenere la chiave di mediazione nella stessa pagina nella scheda Chiavi di mediazione nella colonna Chiave API di reporting. La chiave è
etichettata come "AdMob".
Attivare la modalità di test
È possibile attivare gli annunci di prova nella dashboard Tapjoy in Impostazioni > Impostazioni app > Dispositivi di prova. Crea un nuovo dispositivo di test usando l'ID pubblicità del dispositivo:
Your device's **Advertising ID** can be located by navigating to **Google >
Ads** in your device **Settings**.
Quindi, modifica i contenuti creati in precedenza.
Per modificare i tuoi contenuti, innanzitutto vai a Monetizzazione > Posizionamenti e fai clic sulla scheda Avviati dall'utente. Seleziona il menu a discesa corrispondente
ai contenuti che vuoi modificare e scegli Modifica.
Nella sezione Base dei contenuti, seleziona la casella di controllo Solo per dispositivi di test. Quindi, fai clic su Salva in fondo alla pagina. È tutto. Ora hai un'integrazione
della mediazione funzionante con Tapjoy.
Passaggio 2: configura la domanda di Tapjoy nell' AdMob UI
Configurare le impostazioni di mediazione per l'unità pubblicitaria
Devi aggiungere Tapjoy 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 Tapjoy 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 Tapjoy come origine annuncio
Offerte
Nella scheda Offerte nella sezione Origini annuncio, seleziona Aggiungi origine annuncio. Seleziona Tapjoy.
Aggiungi la seguente dipendenza per l'implementazione con la versione più recente
dell'adattatore e dell'SDK Tapjoy nel file build.gradle a livello di app:
Scarica l'SDK Tapjoy Android ed estrai tapjoyconnectlibrary.jar nella cartella Libraries, quindi aggiungilo al tuo progetto.
Vai agli elementi dell'adattatore Tapjoy nel repository Maven di Google. Seleziona la versione più recente, scarica il file .aar
dell'adattatore Tapjoy e aggiungilo al progetto.
Passaggio 4: implementa le impostazioni della privacy nell'SDK Tapjoy
Consenso dell'Unione Europea e GDPR
Ai sensi delle Norme relative al consenso degli utenti dell'UE di Google, devi assicurarti che vengano fornite determinate informazioni relative all'utilizzo di identificatori di dispositivi e dati personali agli utenti dello Spazio economico europeo (SEE) e il loro consenso è stato ottenuto. Queste norme riflettono i requisiti della direttiva e-Privacy e del Regolamento generale sulla protezione dei dati (GDPR) dell'UE. Quando richiedi il consenso, devi identificare ogni rete pubblicitaria nella catena di mediazione che potrebbe raccogliere, ricevere o utilizzare i dati personali e fornire informazioni sull'utilizzo di ogni rete. Al momento Google non è in grado di trasmettere automaticamente
la scelta dell'utente relativa al consenso a queste reti.
Nell'SDK Tapjoy versione 12.6.0, Tapjoy ha aggiunto un'API per il consenso degli utenti per supportare le impostazioni della privacy. Il seguente codice campione mostra come passare queste informazioni sul consenso
all'SDK Tapjoy. Se scegli di chiamare questo metodo, ti consigliamo di farlo prima di richiedere gli annunci tramite l'SDK Google Mobile Ads.
import com.tapjoy.Tapjoy
...
val privacyPolicy = Tapjoy.getPrivacyPolicy()
privacyPolicy.setSubjectToGDPR(true)
privacyPolicy.setUserConsent("0")
Visita la
Guida alla privacy dell'utente di Tapjoy
per ulteriori dettagli e per conoscere i valori che possono essere forniti in ciascun metodo.
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à.
Nell'SDK Tapjoy versione 12.6.0, Tapjoy ha aggiunto un'API per il consenso degli utenti per supportare le impostazioni della privacy. Il seguente codice campione mostra come passare queste informazioni sul consenso
all'SDK Tapjoy. Se scegli di chiamare questo metodo, ti consigliamo di farlo prima di richiedere gli annunci tramite l'SDK Google Mobile Ads.
Per verificare di ricevere annunci di prova daTapjoy, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le Tapjoy (Bidding) and Tapjoy (Waterfall) origini annuncio.
Passaggi facoltativi
Aggiungere Tapjoy all'elenco di partner pubblicitari CCPA
Segui i passaggi descritti in
Impostazioni CCPA
per aggiungere Tapjoy all'elenco di partner pubblicitari CCPA nellaAdMob UI.
Autorizzazioni
Per prestazioni ottimali, Tapjoy consiglia di aggiungere le seguenti autorizzazioni facoltative al file AndroidManifest.xml della tua app:
L'adattatore Tapjoy supporta un parametro di richiesta aggiuntivo che può essere trasmesso all'adattatore utilizzando la classe TapjoyExtrasBundleBuilder. TapjoyExtrasBundleBuilder include il seguente metodo:
setDebug(bool)
L'attivazione della modalità di debug sull'SDK Tapjoy ti consente di visualizzare varie azioni di Tapjoy
nella Developer Console di Tapjoy. Questo parametro è supportato per tutti i formati degli annunci.
Di seguito è riportato un esempio di codice di come impostare questi parametri di richiesta di annuncio:
Java
Bundle extras = new TapjoyAdapter.TapjoyExtrasBundleBuilder()
.setDebug(true)
.build();
Richiesta di annuncio adRequest = new Richiesta di annuncio.Builder()
.addNetworkExtrasBundle(TapjoyAdapter.class, extras)
.build());
Kotlin
val extras = TapjoyExtrasBundleBuilder()
.setDebug(true)
.build()
val adRequest = Richiesta di annuncio
.addNetworkExtrasBundle(TapjoyAdapter::class.java, extras)
.build()
Verifica le versioni dell'adattatore e dell'SDK
Per registrare le versioni dell'adattatore e dell'SDK, utilizza il seguente snippet di codice:
TapjoyMediationAdapter adapter = new TapjoyMediationAdapter();
VersionInfo adapterVersion = adapter.getVersionInfo();
VersionInfo sdkVersion = adapter.getSDKVersionInfo();
// Log the adapter patch version to 3 digits to represent the x.x.x.x versioning
// used by adapters.
Log.d("TAG", String.format(
"Adapter version: %d.%d.%03d",
adapterVersion.getMajorVersion(),
adapterVersion.getMinorVersion(),
adapterVersion.getMicroVersion()));
Log.d("TAG", String.format(
"SDK version: %d.%d.%d",
sdkVersion.getMajorVersion(),
sdkVersion.getMinorVersion(),
sdkVersion.getMicroVersion()));
Codici di errore
Se l'adattatore non riceve un annuncio da Tapjoy, puoi controllare l'errore sottostante dalla risposta dell'annuncio utilizzando
ResponseInfo.getAdapterResponse() nelle seguenti classi:
Formato
Nome corso
Interstitial
TapjoyAdapter
Con premio
TapjoyMediationAdapter
Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore Tapjoy quando un annuncio non viene caricato:
Codice di errore
Motivo
101
I parametri del server Tapjoy configurati nell' AdMob UI mancano o non sono validi.
103
Il publisher deve richiedere annunci con un contesto Activity.
104
Inizializzazione dell'SDK Tapjoy non riuscita.
105
Si è verificato un errore nella presentazione Tapjoy durante la riproduzione del video.
106
L'SDK Tapjoy non può caricare contemporaneamente due annunci per lo stesso ID posizionamento.
107
L'app non ha richiesto annunci nativi.
108
L'SDK Tapjoy non ha contenuti degli annunci disponibili.
101
I parametri del server Tapjoy configurati nell' AdMob UI mancano o non sono validi.
102
Inizializzazione dell'SDK Tapjoy non riuscita.
103
L'adattatore Tapjoy non supporta il formato dell'annuncio richiesto.
104
Tapjoy ha inviato un callback di caricamento riuscito, ma non erano disponibili contenuti.
105
È già stato caricato un annuncio per questa configurazione di rete.
106
L'SDK Tapjoy ha restituito un callback di errore video.
Log delle modifiche dell'adattatore di mediazione Android di Tapjoy
Versione 13.2.1.0
La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.3.0.
Compatibilità verificata con l'SDK Tapjoy versione 13.2.1.
Realizzato e testato con:
SDK Google Mobile Ads versione 22.3.0.
SDK Tapjoy versione 13.2.1.
Versione 13.1.2.0
Compatibilità verificata con l'SDK Tapjoy versione 13.1.2.
Realizzato e testato con:
SDK Google Mobile Ads versione 22.2.0.
SDK Tapjoy versione 13.1.2.
Versione 13.1.1.0
Compatibilità verificata con l'SDK Tapjoy versione 13.1.1.
Realizzato e testato con:
SDK Google Mobile Ads versione 22.1.0.
SDK Tapjoy versione 13.1.1.
Versione 13.0.1.0
Compatibilità verificata con l'SDK Tapjoy versione 13.0.1.
Realizzato e testato con:
SDK Google Mobile Ads versione 22.0.0.
SDK Tapjoy versione 13.0.1.
Versione 13.0.0.0
Compatibilità verificata con l'SDK Tapjoy versione 13.0.0.
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 Tapjoy versione 13.0.0.
Versione 12.11.1.0
Compatibilità verificata con l'SDK Tapjoy versione 12.11.1.
La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.3.0.
Realizzato e testato con:
SDK Google Mobile Ads versione 21.3.0.
SDK Tapjoy versione 12.11.1.
Versione 12.11.0.0
Compatibilità verificata con l'SDK Tapjoy versione 12.11.0.
La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.2.0.
Realizzato e testato con:
SDK Google Mobile Ads versione 21.2.0.
SDK Tapjoy versione 12.11.0.
Versione 12.10.0.1
Aggiornamento di compileSdkVersion e targetSdkVersion all'API 31.
La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.0.0.
Il livello API Android minimo richiesto è stato aggiornato a 19.
Realizzato e testato con:
SDK Google Mobile Ads versione 21.0.0.
SDK Tapjoy versione 12.10.0.
Versione 12.10.0.0
Compatibilità verificata con l'SDK Tapjoy versione 12.10.0.
Realizzato e testato con:
SDK Google Mobile Ads versione 20.6.0.
SDK Tapjoy versione 12.10.0.
Versione 12.9.1.0
Compatibilità verificata con l'SDK Tapjoy versione 12.9.1.
La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.6.0.
Realizzato e testato con:
SDK Google Mobile Ads versione 20.6.0.
SDK Tapjoy versione 12.9.1.
Versione 12.9.0.0
Compatibilità verificata con l'SDK Tapjoy versione 12.9.0.
La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.5.0.
Realizzato e testato con:
SDK Google Mobile Ads versione 20.5.0.
SDK Tapjoy versione 12.9.0.
Versione 12.8.1.1
Compatibilità verificata con l'SDK Tapjoy versione 12.8.1.
La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.4.0.
Risolto il problema per cui si poteva verificare un arresto anomalo se il campo TJError.message di Tapjoy è nullo.
Realizzato e testato con:
SDK Google Mobile Ads versione 20.4.0.
SDK Tapjoy versione 12.8.1.
Versione 12.8.1.0
Compatibilità verificata con l'SDK Tapjoy versione 12.8.1.
Risolto il problema per cui NullPointerException viene registrato quando l'adattatore registra un errore.
La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.2.0.
Realizzato e testato con:
SDK Google Mobile Ads versione 20.2.0.
SDK Tapjoy versione 12.8.1.
Versione 12.8.0.1
La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.0.0.
Realizzato e testato con:
SDK Google Mobile Ads versione 20.0.0.
SDK Tapjoy versione 12.8.0.
Versione 12.8.0.0
Correzione dei messaggi di errore errati.
La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.7.0.
Realizzato e testato con:
SDK Google Mobile Ads versione 19.7.0.
SDK Tapjoy versione 12.8.0.
Versione 12.7.1.0
Compatibilità verificata con l'SDK Tapjoy versione 12.7.1.
La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.5.0.
Realizzato e testato con:
SDK Google Mobile Ads versione 19.5.0.
SDK Tapjoy versione 12.7.1.
Versione 12.7.0.0
Risolto il problema per cui l'adattatore restituisce una stringa di versione errata.
La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.4.0.
Realizzato e testato con:
SDK Google Mobile Ads versione 19.4.0.
SDK Tapjoy versione 12.7.0.
Versione 12.6.1.0
Compatibilità verificata con l'SDK Tapjoy versione 12.6.1.
Se si caricano contemporaneamente più annunci interstitial con lo stesso nome di posizionamento Tapjoy, viene visualizzato un errore di caricamento per la seconda richiesta. Questo comportamento ora corrisponde al comportamento esistente per gli annunci con premio.
Realizzato e testato con:
SDK Google Mobile Ads versione 19.2.0.
SDK Tapjoy versione 12.6.1.
Versione 12.6.0.0
Compatibilità verificata con l'SDK Tapjoy versione 12.6.0.
La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.2.0.
Realizzato e testato con:
SDK Google Mobile Ads versione 19.2.0.
SDK Tapjoy versione 12.6.0.
Versione 12.4.2.1
Sono stati aggiunti codici di errore descrittivi e i motivi degli errori di caricamento/programma dell'adattatore.
La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.0.1.
Realizzato e testato con:
SDK Google Mobile Ads versione 19.0.1.
SDK Tapjoy versione 12.4.2.
Versione 12.4.2.0
Compatibilità verificata con l'SDK Tapjoy versione 12.4.2.
Realizzato e testato con:
SDK Google Mobile Ads versione 18.3.0.
SDK Tapjoy versione 12.4.2.
Versione 12.4.1.0
Compatibilità verificata con l'SDK Tapjoy versione 12.4.1.
Realizzato e testato con:
SDK Google Mobile Ads versione 18.3.0.
SDK Tapjoy versione 12.4.1.
Versione 12.4.0.0
Compatibilità verificata con l'SDK Tapjoy versione 12.4.0.
Realizzato e testato con:
SDK Google Mobile Ads versione 18.3.0.
SDK Tapjoy versione 12.4.0.
Versione 12.3.4.0
Compatibilità verificata con l'SDK Tapjoy versione 12.3.4.
La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 18.3.0.
Realizzato e testato con:
SDK Google Mobile Ads versione 18.3.0.
SDK Tapjoy versione 12.3.4.
Versione 12.3.3.0
Compatibilità verificata con l'SDK Tapjoy versione 12.3.3.
Versione 12.3.2.0
Compatibilità verificata con l'SDK Tapjoy versione 12.3.2.
La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 18.2.0.
Versione 12.3.1.1
Ora l'adattatore Tapjoy richiede un solo annuncio per ogni posizionamento.
Versione 12.3.1.0
Aggiornato l'adattatore per richiamare l'evento annuncio "onClick()".
Compatibilità verificata con l'SDK Tapjoy versione 12.3.1.
La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 17.2.1.
Versione 12.2.1.1
È stata aggiunta la funzionalità di offerta all'adattatore per gli
annunci interstitial e con premio.
Versione 12.2.1.0
Compatibilità verificata con l'SDK Tapjoy versione 12.2.1.
Versione 12.2.0.1
L'adattatore è stato aggiornato per supportare la nuova API con premio in versione beta aperta.
La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 17.2.0.
Versione 12.2.0.0
Compatibilità verificata con l'SDK Tapjoy versione 12.2.0.
Versione 12.1.0.0
Compatibilità verificata con l'SDK tapjoy versione 12.1.0.
Versione 12.0.0.1
È stato aggiornato l'adattatore per richiamare l'evento annuncio onRewardedVideoComplete().
Versione 12.0.0.0
Compatibilità verificata con l'SDK tapjoy versione 12.0.0.
Versione 11.12.2.0
Compatibilità verificata con l'SDK tapjoy versione 11.12.2.
Versione 11.12.1.0
Compatibilità verificata con l'SDK tapjoy versione 11.12.1.
Versione 11.12.0.0
Compatibilità verificata con l'SDK tapjoy versione 11.12.0.
Versione 11.11.1.0
Compatibilità verificata con l'SDK Tapjoy versione 11.11.1.
Versione 11.11.0.0
È stato aggiornato l'adattatore per renderlo compatibile con la versione 11.11.0 dell'SDK Tapjoy.
Versione 11.10.2.0
L'importo predefinito del premio è stato aggiornato su 1.
Compatibilità verificata con l'SDK Tapjoy versione 11.10.2.
Versione 11.10.1.0
Compatibilità verificata con l'SDK Tapjoy versione 11.10.1.
Versione 11.10.0.0
Compatibilità verificata con l'SDK Tapjoy versione 11.10.0.
Versione 11.9.1.0
Release iniziale. Supporta gli annunci video e interstitial basati su premi.