Annunci interstitial


Gli annunci interstitial sono annunci a schermo intero che coprono l'interfaccia di un'app finché non vengono chiusi dall'utente. Vengono in genere visualizzati in punti di transizione naturali nel flusso di un'app, ad esempio tra le varie attività o durante la pausa tra i livelli di un gioco. Quando un'app mostra un annuncio interstitial, l'utente può toccare l'annuncio e continuare fino alla destinazione o chiuderlo e tornare all'app. Case study.

Questa guida mostra come integrare gli annunci interstitial nelle app per Android e iOS utilizzando l'SDK Google Mobile Ads C++.

Prerequisiti

Esegui sempre i test con gli annunci di prova

Quando crei ed esegui test sulle tue app, assicurati di utilizzare annunci di prova anziché annunci di produzione live. In caso contrario, il tuo account potrebbe essere sospeso.

Il modo più semplice per caricare gli annunci di test è utilizzare il nostro ID unità pubblicitaria di test dedicato per gli annunci interstitial, che varia in base alla piattaforma del dispositivo:

  • Android: ca-app-pub-3940256099942544/1033173712
  • iOS: ca-app-pub-3940256099942544/4411468910

Sono stati configurati appositamente per restituire annunci di test per ogni richiesta e puoi utilizzarli liberamente nelle tue app durante la codifica, il test e il debug. Assicurati solo di sostituirlo con il tuo ID unità pubblicitaria prima di pubblicare l'app.

Per saperne di più sul funzionamento degli annunci di test dell'SDK Mobile Ads, consulta la sezione Annunci di test.

Implementazione

I passaggi principali per integrare gli annunci interstitial sono:

  1. Carica un annuncio.
  2. Registrati per i callback.
  3. Visualizzare l'annuncio e gestire gli eventi del suo ciclo di vita.

Configura un InterstitialAd

Gli annunci interstitial vengono visualizzati negli oggetti InterstitialAd, quindi il primo passaggio per integrare gli annunci interstitial nella tua app è creare e inizializzare un oggetto InterstitialAd.

  1. Aggiungi la seguente intestazione al codice C++ della tua app: 

     #include "firebase/gma/interstial_ad.h"

  2. Dichiara e crea un'istanza di un oggetto InterstitialAd: 

     firebase::gma::InterstitialAd* interstitial_ad;
 interstitial_ad = new firebase::gma::InterstitialAd();

  3. Inizializza l'istanza InterstitialAd utilizzando il cast della visualizzazione padre a un tipo AdParent. La visualizzazione principale è un riferimento JNI jobject a un Activity Android o un puntatore a un UIView iOS.

    // my_ad_parent is a jobject reference to an Android Activity or
// a pointer to an iOS UIView.
firebase::gma::AdParent ad_parent =
  static_cast<firebase::gma::AdParent>(my_ad_parent);
firebase::Future<void> result = interstitial_ad->Initialize(ad_parent);

  4. In alternativa a conservare il futuro come variabile, puoi controllare periodicamente lo stato dell'operazione di inizializzazione richiamando InitializeLastResult() sull'oggetto InterstitialAd. Questo può essere utile per tenere traccia del processo di inizializzazione nel ciclo di gioco globale.

    // Monitor the status of the future in your game loop:
firebase::Future<void> result = interstitial_ad->InitializeLastResult();
if (result.status() == firebase::kFutureStatusComplete) {
  // Initialization completed.
  if(future.error() == firebase::gma::kAdErrorCodeNone) {
    // Initialization successful.
  } else {
    // An error has occurred.
  }
} else {
  // Initialization on-going.
}

Per saperne di più sull'utilizzo di firebase::Future, consulta Utilizzare Futures per monitorare lo stato di completamento delle chiamate ai metodi.

Caricare un annuncio

Il caricamento di un annuncio viene eseguito utilizzando il metodo LoadAd() sull'oggetto InterstitialAd. Il metodo di caricamento richiede che tu abbia inizializzato l'oggetto InterstitialAd e che tu disponga dell'ID unità pubblicitaria e di un oggetto AdRequest. Viene restituito un firebase::Future che puoi utilizzare per monitorare lo stato e il risultato dell'operazione di caricamento.

Il seguente codice mostra come caricare un annuncio una volta che InterstitialAd è stato inizializzato correttamente:

firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result;
load_ad_result = interstitial_ad->LoadAd(interstitial_ad_unit_id, ad_request);

Registrarsi per i callback

Devi estendere la classe FullScreenContentListener per ricevere notifiche di eventi del ciclo di vita e presentazione di annunci interstitial. La sottoclasse FullScreenContentListener personalizzata può essere registrata tramite il metodo InterstitialAd::SetFullScreenContentListener() e riceverà callback quando l'annuncio viene visualizzato correttamente o meno, nonché quando viene chiuso.

Il seguente codice mostra come estendere la classe e assegnarla all'annuncio:

  class ExampleFullScreenContentListener
      : public firebase::gma::FullScreenContentListener {

   public:
    ExampleFullScreenContentListener() {}

    void OnAdClicked() override {
      // This method is invoked when the user clicks the ad.
    }

    void OnAdDismissedFullScreenContent() override {
     // This method is invoked when the ad dismisses full screen content.
    }

    void OnAdFailedToShowFullScreenContent(const AdError& error) override {
      // This method is invoked when the ad failed to show full screen content.
      // Details about the error are contained within the AdError parameter.
    }

    void OnAdImpression() override {
      // This method is invoked when an impression is recorded for an ad.
    }

    void OnAdShowedFullScreenContent() override {
      // This method is invoked when the ad showed its full screen content.
    }
  };

  ExampleFullScreenContentListener* full_screen_content_listener =
    new ExampleFullScreenContentListener();
  interstitial_ad->SetFullScreenContentListener(full_screen_content_listener);

InterstitialAd è un oggetto monouso. Ciò significa che una volta mostrato un annuncio interstiziale, non può essere mostrato di nuovo. Una best practice consiste nel caricare un altro annuncio interstitial nel metodo OnAdDismissedFullScreenContent() del tuo FullScreenContentListener in modo che l'annuncio interstitial successivo inizi a caricarsi non appena viene chiuso quello precedente.

Visualizzare l'annuncio

Gli interstitial devono essere visualizzati durante le pause naturali nel flusso di un'app. Un buon esempio è tra i livelli di un gioco o dopo che l'utente ha completato un'attività. Anche se FullScreenContentListener può essere utilizzato per determinare quando un annuncio ha mostrato i suoi contenuti a schermo intero, il futuro restituito da Show() segnalerà anche quando l'annuncio è stato mostrato correttamente.

  firebase::Future<void> result = interstitial_ad->Show();

Best practice

Valuta se gli annunci interstitial sono il tipo di annuncio giusto per la tua app.
Gli annunci interstitial funzionano meglio nelle app con punti di transizione naturali. La conclusione di un'attività all'interno di un'app, come la condivisione di un'immagine o il completamento di un livello di un gioco, crea un punto di transizione. Poiché l'utente si aspetta una pausa nell'azione, è facile presentare un annuncio interstitial senza interrompere la sua esperienza. Assicurati di considerare in quali punti del flusso di lavoro della tua app mostrerai gli annunci interstitial e come è probabile che l'utente risponda.
Ricorda di mettere in pausa l'azione quando viene visualizzato un annuncio interstitial.
Esistono diversi tipi di annunci interstitial: di testo, illustrati, video e altro ancora. È importante assicurarsi che quando la tua app mostra un annuncio interstitial, sospenda anche l'utilizzo di alcune risorse per consentire all'annuncio di sfruttarle. Ad esempio, quando effettui la chiamata per visualizzare un annuncio interstitial, assicurati di mettere in pausa qualsiasi output audio prodotto dalla tua app. Puoi riprendere la riproduzione dei suoni nel metodo OnAdDismissedFullScreenContent del tuo FullScreenContentListener installato, che verrà richiamato quando l'utente avrà terminato di interagire con l'annuncio. Inoltre, valuta la possibilità di interrompere temporaneamente qualsiasi attività di calcolo intensa (come un ciclo di gioco) durante la visualizzazione dell'annuncio. In questo modo, l'utente non riscontrerà problemi di lentezza o mancanza di risposta della grafica o di riproduzione a scatti dei video.
Consenti un tempo di caricamento adeguato.
Proprio come è importante assicurarsi di mostrare gli annunci interstitial al momento opportuno, è anche importante assicurarsi che l'utente non debba aspettare che vengano caricati. Il caricamento anticipato dell'annuncio prima della pubblicazione può garantire che la tua app abbia un annuncio interstitial completamente caricato e pronto quando arriva il momento di mostrarlo.
Non inondare l'utente di annunci.
Sebbene l'aumento della frequenza degli annunci interstitial nella tua app possa sembrare un ottimo modo per aumentare le entrate, può anche peggiorare l'esperienza utente e ridurre le percentuali di clic. Assicurati che gli utenti non vengano interrotti così spesso da non riuscire più a godersi l'utilizzo della tua app.
Non utilizzare la futura completamento del caricamento per mostrare l'interstitial.
Ciò può causare un'esperienza utente scadente. Carica invece l'annuncio prima di doverlo mostrare.

Risorse aggiuntive

Esempio in GitHub

Tutorial video di Mobile Ads Garage

Casi di successo

Passaggi successivi