Questa guida illustra come eseguire il debug della pubblicazione di annunci utilizzando l'anteprima in-app e gli strumenti di pubblicazione di Ad Manager.
L'anteprima in-app ti consente di esaminare le creatività visualizzate all'interno della tua app per dispositivi mobili. Questa anteprima è particolarmente utile se hai creatività che interagiscono con l'app, che hanno un comportamento univoco o che si basano sull'app per eseguire il rendering (incluse creatività native e MRAID).
Gli strumenti di pubblicazione di Ad Manager forniscono informazioni su quali annunci sono stati pubblicati; pertanto, quando vengono pubblicati annunci imprevisti, utilizza gli strumenti di pubblicazione per scoprirne il motivo.
Prerequisiti
- Versione 10.2.0 o successive dell'SDK Google Mobile Ads.
- Accesso a un account Google Ad Manager.
- Completa la procedura Inizia.
Preparare l'app
Il debug richiede l'interazione con il menu delle opzioni di debug dell'SDK. Il modo consigliato per aprire il menu è includere la funzione riportata di seguito nell'app e attivarla in base a un'azione dell'utente:
Java
public class MainActivity extends AppCompatActivity {
...
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// Initialize the Mobile Ads SDK.
MobileAds.initialize(this);
}
...
// Opens a debug menu. Call this method based on a user action.
// TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
public void openDebugMenu() {
MobileAds.openDebugMenu(this, "YOUR_AD_UNIT_ID");
}
}
Kotlin
class MainActivity : AppCompatActivity() {
...
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
// Initialize the Mobile Ads SDK.
MobileAds.initialize(this)
}
...
// Opens a debug menu. Call this method based on a user action.
// TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
fun openDebugMenu() {
MobileAds.openDebugMenu(this, "YOUR_AD_UNIT_ID")
}
}
Qualsiasi unità pubblicitaria valida del tuo account Ad Manager è sufficiente per aprire il menu delle opzioni di debug.
Un altro modo per aprire il menu è eseguire una pressione prolungata con due dita sulla creatività, ma questa operazione non funziona per tutti i formati di annunci, ad esempio gli annunci nativi, e devi fare attenzione a non fare clic sull'annuncio quando provi a scorrere. Chiamare il metodo descritto sopra è molto più sicuro.
Collega il tuo dispositivo
Dopo aver aggiunto la funzionalità per aprire il menu delle opzioni di debug, esegui l'app e attiva la funzione riportata sopra. Si apre il seguente menu:
Seleziona Creative Preview per collegare il tuo dispositivo. Si apre un browser e si apre automaticamente un browser per accedere ad Ad Manager. Dopo avere eseguito l'accesso, assegna un nome al dispositivo per registrarlo con il tuo account Ad Manager. Fai clic su Verifica.
A questo punto, puoi verificare che il tuo dispositivo sia stato collegato nell'interfaccia utente di Ad Manager. Puoi anche consentire ad altre persone di accedere ai tuoi dispositivi.
Anteprima in-app
Segui la procedura per inviare una creatività al dispositivo collegato. Assicurati che la creatività trasferita faccia parte di un elemento pubblicitario attivo che ha come target l'area annuncio in cui vuoi pubblicare la creatività.
Dopo aver inviato una creatività dall'interfaccia utente, attiva di nuovo il menu delle opzioni di debug sul dispositivo e seleziona ancora Creative Preview. Questo passaggio consente all'SDK di controllare Ad Manager per verificare che il collegamento del dispositivo sia riuscito e per ottenere alcune informazioni sulla creatività inviata. Se il collegamento del dispositivo in precedenza ha avuto esito positivo, il menu di debug si chiude immediatamente. Se l'operazione non va a buon fine, ti verrà chiesto di collegare nuovamente l'account.
Infine, carica un annuncio per l'area di cui vuoi visualizzare l'anteprima per vedere la creatività.
Strumenti di pubblicazione
Segui i passaggi descritti in Esaminare la pubblicazione in Ad Manager per risolvere i problemi di pubblicazione degli annunci. Se hai completato correttamente i passaggi, la richiesta viene visualizzata nell'interfaccia utente di Ad Manager e puoi visualizzare ulteriori informazioni sull'annuncio pubblicato.
