Integrare Tapjoy con la mediazione

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

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

Versione 3.1.1

Versione 3.1.0

Versione 3.0.0

Versione 2.10.1

Versione 2.10.0

Versione 2.9.1

Versione 2.9.0

Versione 2.8.2

Versione 2.8.1

Versione 2.8.0

Versione 2.7.1

Versione 2.7.0

Versione 2.6.1

Versione 2.6.0

Versione 2.5.1

Versione 2.5.0

Versione 2.4.2

Versione 2.4.1

Versione 2.4.0

Versione 2.3.1

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.