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 Tapjoy alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore Tapjoy in un'app Unity.
Integrazioni e formati degli annunci supportati
L' AdMob adattatore di mediazione per Tapjoy ha le seguenti funzionalità:
Integrazione | |
---|---|
Offerte | |
Struttura a cascata | |
Formati | |
Banner | |
Interstitial | |
Con premio |
Requisiti
- Unity 4 o superiore
- Versione più recente dell'SDK Google Mobile Ads
- [For bidding]: plug-in di mediazione Google Mobile Ads per Tapjoy 2.3.0 o versioni successive (ultima versione consigliata)
- Per eseguire il deployment su Android
- Livello API Android 19 o superiore
- Per eseguire il deployment su iOS
- Target di deployment per iOS 12.0 o versioni successive
- Un progetto Unity funzionante configurato con l'SDK Google Mobile Ads. Consulta la guida introduttiva per i dettagli.
- Completa la mediazione Guida introduttiva
Passaggio 1: imposta le configurazioni nell'interfaccia utente di Tapjoy
Registrati o accedi alla dashboard Tapjoy.
Aggiungi app
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.
Se la tua app supporta entrambe le piattaforme, scegli Entrambe come piattaforma.
Android
iOS
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.
Android
iOS
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:
Offerte
Interstitial
Fai clic sul pulsante Crea per i contenuti Video interstitial di pubblicità programmatica. Specifica un nome per i contenuti e scegli la piattaforma. * {Android} * {iOS} Seleziona la valuta virtuale creata in precedenza come Valuta virtuale. Seleziona il posizionamento interstitial creato in precedenza. Quando hai finito di creare i tuoi contenuti, fai clic sul pulsante Salva in basso.Con premio
Fai clic sul pulsante Crea per i contenuti Video con premio programmatico. * {Android} * {iOS} Seleziona la valuta virtuale creata in precedenza come Valuta virtuale. Seleziona il posizionamento con premio creato in precedenza. Quando hai finito di creare i tuoi contenuti, fai clic sul pulsante Salva in basso.Struttura a cascata
Interstitial
Fai clic sul pulsante Crea per i contenuti video interstitial. Specifica un nome per i contenuti e scegli la piattaforma. * {Android} * {iOS} Seleziona la valuta virtuale creata in precedenza come Valuta virtuale. Seleziona il posizionamento interstitial creato in precedenza. Quando hai finito di creare i tuoi contenuti, fai clic sul pulsante Salva in basso.Con premio
Fai clic sul pulsante Crea per i contenuti video con premio. Specifica un nome per i contenuti e scegli la piattaforma. * {Android} * {iOS} Seleziona la valuta virtuale creata in precedenza come Valuta virtuale. Seleziona il posizionamento con premio creato in precedenza. Quando hai finito di creare i tuoi contenuti, fai clic sul pulsante Salva in basso.Individua chiave SDK
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.
Android
iOS
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:
Android
Puoi trovare l'ID pubblicità del dispositivo selezionando Google > Annunci nelle Impostazioni del dispositivo.
iOS
Per ottenere l'ID pubblicità del tuo dispositivo, aggiungi il seguente codice nell'app. Assicurati di importare il framework AdSupport nell'app prima di utilizzare il codice riportato di seguito.
Swift
let advertisingId: String = ASIdentifierManager.shared().advertisingIdentifier.uuidString
print("Advertising ID: \(advertisingId)")
Objective-C
NSString *advertisingId = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
NSLog(@"Advertising ID: %@", advertisingId);
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.
Android
iOS
Passaggio 2: configura la domanda di Tapjoy nell' AdMob UI
Configurare le impostazioni di mediazione per l'unità pubblicitaria
Android
Per le istruzioni, consulta il passaggio 2 della guida per Android.
iOS
Per le istruzioni, consulta il passaggio 2 nella guida per iOS.
Aggiungi Tapjoy 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 Tapjoy 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 Tapjoy
Scarica la versione più recente del plug-in di mediazione Google Mobile Ads per Tapjoy
dal link di download nel
Log delle modifiche ed estrai GoogleMobileAdsTapjoyMediation.unitypackage
dal file ZIP.
Nell'editor del progetto Unity, seleziona Asset > Importa pacchetto > Pacchetto personalizzato e seleziona il file GoogleMobileAdsTapjoyMediation.unitypackage
che hai scaricato. Assicurati che tutti i file siano selezionati e fai clic su Importa.
Quindi, seleziona Asset > Play Services Resolver > Android Resolver > Forza risoluzione. La libreria di resolver Unity Play Services eseguirà la risoluzione delle dipendenze da zero e copierà le dipendenze dichiarate nella directory Assets/Plugins/Android
della tua app Unity.
Passaggio 4: implementa le impostazioni della privacy nell'SDK Tapjoy
Consenso UE 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.
Il plug-in di mediazione degli annunci per dispositivi mobili di Google per Tapjoy versione 1.1.1 include i metodi SetUserConsent()
e SubjectToGDPR()
. Il seguente codice di esempio mostra come passare le 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.
using GoogleMobileAds.Api.Mediation.Tapjoy;
// ...
Tapjoy.SetUserConsent("myUserConsent");
Inoltre, è possibile impostare un flag facoltativo per indicare se l'utente è soggetto al GDPR.
Tapjoy.SubjectToGDPR(true);
Per ulteriori dettagli e per i valori che possono essere forniti nel metodo, consulta la guida Privacy dell'utente di Tapjoy.
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 plug-in di mediazione degli annunci per dispositivi mobili di Google per Tapjoy versione 2.9.1 include il metodo SetUSPrivacy()
. Il seguente codice di esempio mostra come passare le 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.
using GoogleMobileAds.Api.Mediation.Tapjoy;
// ...
Tapjoy.SetUSPrivacy("myUSPrivacyString");
Per ulteriori dettagli e per i valori che possono essere forniti nel metodo, consulta la guida Privacy dell'utente di Tapjoy.
Passaggio 5: aggiungi il codice richiesto
Android
Non è necessario alcun codice aggiuntivo per l'integrazione con Tapjoy.
iOS
Integrazione di SKAdNetwork
Segui la documentazione di Tapjoy per aggiungere gli identificatori SKAdNetwork al file Info.plist
del tuo progetto.
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 Tapjoy UI.
Verifica annunci di prova
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
Android
Autorizzazioni
Per prestazioni ottimali, Tapjoy consiglia di aggiungere le seguenti
autorizzazioni facoltative
al file AndroidManifest.xml
della tua app. Modifica il file AndroidManifest.xml
che si trova nella cartella Assets/Plugins/Android/GoogleMobileAdsTapjoyMediation
e includi queste autorizzazioni facoltative:
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
iOS
Nessun passaggio aggiuntivo per l'integrazione con iOS.
Codici di errore
Se l'adattatore non riceve un annuncio da Tapjoy, i publisher possono controllare l'errore sottostante dalla risposta di annuncio utilizzando ResponseInfo
nelle seguenti classi:
Android
Formato | Nome corso |
---|---|
Interstitial | TapjoyAdapter |
Con premio | TapjoyMediationAdapter |
iOS
Formato | Nome corso |
---|---|
Interstitial | GADMAdapterTapjoy |
Con premio | GADMAdapterTapjoy |
Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore Tapjoy quando un annuncio non viene caricato:
Android
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. |
iOS
Codice di errore | Motivo |
---|---|
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 del plug-in di mediazione Tapjoy Unity
Versione 3.2.0
- Supporta l'adattatore Android Tapjoy versione 13.2.1.0.
- Supporta l'adattatore iOS Tapjoy versione 13.2.1.0.
- Costruito e testato con il plug-in Unity di Google Mobile Ads versione 8.6.0.
Versione 3.1.1
- Supporta l'adattatore Android Tapjoy versione 13.1.2.0.
- Supporta l'adattatore iOS Tapjoy versione 13.1.2.0.
- Sviluppato e testato con il plug-in Unity di Google Mobile Ads versione 8.4.1.
Versione 3.1.0
- Supporta l'adattatore Android Tapjoy versione 13.1.1.0.
- Supporta l'adattatore iOS Tapjoy versione 13.1.1.0.
- Costruito e testato con il plug-in Unity di Google Mobile Ads versione 8.4.0.
Versione 3.0.0
- Contenuti dell'adattatore spostati in
GoogleMobileAds/Mediation/Tapjoy/
. - È stato eseguito il refactoring dello spazio dei nomi dell'adattatore per utilizzare
GoogleMobileAds.Mediation.Tapjoy
. - Supporta l'adattatore Android Tapjoy versione 13.0.1.0.
- Supporta l'adattatore iOS Tapjoy versione 13.0.1.0.
- Costruito e testato con il plug-in Unity di Google Mobile Ads versione 8.1.0.
Versione 2.10.1
- Supporta l'adattatore Android Tapjoy versione 12.11.1.0.
- Supporta l'adattatore iOS Tapjoy versione 12.11.1.0.
- Costruito e testato con il plug-in Unity di Google Mobile Ads versione 7.4.1.
Versione 2.10.0
- Supporta l'adattatore Android Tapjoy versione 12.11.0.0.
- Supporta l'adattatore iOS Tapjoy versione 12.11.0.0.
- Costruito e testato con il plug-in Unity di Google Mobile Ads versione 7.3.0.
Versione 2.9.1
- Metodo
Tapjoy.SetUSPrivacy(string)
aggiunto. - Supporta l'adattatore Android Tapjoy versione 12.10.0.1.
- Supporta l'adattatore iOS Tapjoy versione 12.10.0.0.
- Costruito e testato con il plug-in Unity di Google Mobile Ads versione 7.2.0.
Versione 2.9.0
- Supporta l'adattatore Android Tapjoy versione 12.10.0.1.
- Supporta l'adattatore iOS Tapjoy versione 12.10.0.0.
- Costruito e testato con il plug-in Unity di Google Mobile Ads versione 7.0.2.
Versione 2.8.2
- Supporta l'adattatore Android Tapjoy versione 12.9.1.0.
- Supporta l'adattatore iOS Tapjoy versione 12.9.1.0.
- Costruito e testato con il plug-in Unity di Google Mobile Ads versione 7.0.0.
Versione 2.8.1
- Supporta l'adattatore Android Tapjoy versione 12.9.0.0.
- Supporta l'adattatore iOS Tapjoy versione 12.9.0.1.
- Costruito e testato con il plug-in Unity di Google Mobile Ads versione 7.0.0.
Versione 2.8.0
- Supporta l'adattatore Android Tapjoy versione 12.9.0.0.
- Supporta l'adattatore iOS Tapjoy versione 12.9.0.0.
Versione 2.7.1
- Supporta l'adattatore Android Tapjoy versione 12.8.1.0.
- Supporta l'adattatore iOS Tapjoy versione 12.8.1.0.
Versione 2.7.0
- Supporta l'adattatore Android Tapjoy versione 12.8.0.1.
- Supporta l'adattatore iOS Tapjoy versione 12.8.0.1.
Versione 2.6.1
- Supporta l'adattatore Android Tapjoy versione 12.7.1.0.
- Supporta l'adattatore iOS Tapjoy versione 12.7.1.0.
Versione 2.6.0
- Supporta l'adattatore Android Tapjoy versione 12.7.0.0.
- Supporta l'adattatore iOS Tapjoy versione 12.7.0.0.
Versione 2.5.1
- Supporta l'adattatore Android Tapjoy versione 12.6.1.0.
- Supporta l'adattatore iOS Tapjoy versione 12.6.1.0.
Versione 2.5.0
- Supporta l'adattatore Android Tapjoy versione 12.6.0.0.
- Supporta l'adattatore iOS Tapjoy versione 12.6.0.0.
Versione 2.4.2
- Supporta l'adattatore Android Tapjoy versione 12.4.2.1.
- Supporta l'adattatore iOS Tapjoy versione 12.4.2.1.
Versione 2.4.1
- Supporta l'adattatore Android Tapjoy versione 12.4.2.0.
- Supporta l'adattatore iOS Tapjoy versione 12.4.2.0.
Versione 2.4.0
- Supporta l'adattatore Android Tapjoy versione 12.4.1.0.
- Supporta l'adattatore iOS Tapjoy versione 12.4.1.0.
Versione 2.3.1
- Supporta l'adattatore Android Tapjoy versione 12.3.3.0.
- Supporta l'adattatore iOS Tapjoy versione 12.3.3.0.
Versione 2.3.0
- Supporta l'adattatore Android Tapjoy versione 12.3.1.0.
- Supporta l'adattatore iOS Tapjoy versione 12.3.1.0.
Versione 2.2.0
- Aggiornato il plug-in in modo che supporti la nuova API Reward.
- Supporta l'adattatore Android Tapjoy versione 12.2.1.0.
- Supporta l'adattatore iOS Tapjoy versione 12.2.1.0.
Versione 2.1.0
- Supporta l'adattatore Android Tapjoy versione 12.2.0.0.
- Supporta l'adattatore iOS Tapjoy versione 12.1.0.0.
Versione 2.0.1
- Supporta l'adattatore Android Tapjoy versione 12.0.0.1.
- Supporta l'adattatore iOS Tapjoy versione 12.0.0.0.
Versione 2.0.0
- Supporta l'adattatore Android Tapjoy versione 12.0.0.0.
- Supporta l'adattatore iOS Tapjoy versione 12.0.0.0.
Versione 1.1.1
- Supporta Tapjoy SDK Android versione 11.12.2.
- Supporta l'SDK Tapjoy per iOS versione 11.12.2.
- È stato aggiunto il metodo
Tapjoy.SetUserConsent()
per inoltrare lo stato del consenso dell'utente all'SDK Tapjoy sotto forma di stringa per il consenso. - È stato aggiunto il metodo
Tapjoy.SubjectToGDPR()
per indicare se il GDPR è applicabile all'utente o meno.
Versione 1.1.0
- Supporta Tapjoy SDK Android versione 11.12.1.
- Supporta l'SDK Tapjoy per iOS versione 11.12.1.
Versione 1.0.0
- Prima uscita.
- Supporta Tapjoy SDK Android versione 11.11.1.
- Supporta l'SDK Tapjoy per iOS versione 11.11.1.