Precaricamento degli annunci (alpha)

Seleziona la piattaforma: Android Nuovo Android iOS Unity

Il precaricamento degli annunci è una funzionalità di caricamento degli annunci gestita da Google in Google Mobile Ads Unity Plugin che gestisce il caricamento e la memorizzazione nella cache degli annunci per tuo conto. Il precaricamento degli annunci richiede una modifica della modalità di gestione del caricamento degli annunci. Per ottimizzare le prestazioni utilizzando il precaricamento degli annunci, disattiva la memorizzazione nella cache personalizzata e delega questa responsabilità a Google Mobile Ads Unity Plugin.

Il precaricamento degli annunci offre i seguenti vantaggi rispetto al caricamento manuale degli annunci:

  • Gestione dei riferimenti: conserva gli annunci caricati in modo che tu non debba mantenere i riferimenti finché non sono pronti per essere mostrati.
  • Ricaricamento automatico: carica automaticamente un nuovo annuncio quando ne estrai uno dalla cache.
  • Ripetizioni gestite: ripete automaticamente le richieste non riuscite utilizzando il backoff esponenziale.
  • Gestione della scadenza: aggiorna automaticamente gli annunci prima della scadenza (in genere dopo un'ora).
  • Ottimizzazione della cache: se utilizzi una dimensione della cache maggiore di uno, Google Mobile Ads Unity Plugin ottimizza l'ordine della cache per pubblicare l'annuncio migliore.

Questa guida illustra come configurare gli annunci di precaricamento, controllare la disponibilità degli annunci di precaricamento e mostrare l'annuncio di precaricamento.

Prerequisiti

Prima di procedere con il tutorial, devi completare i seguenti passaggi:

  • Utilizza la versione 24.4.0 dell'SDK Android e la versione 12.6.0 dell'SDK iOS.

  • (Facoltativo) Scarica ed esegui l'app di esempio per il precaricamento degli annunci .

Inizia il precaricamento degli annunci

Per iniziare il precaricamento degli annunci, chiama Preload(). Chiama questo metodo una sola volta per ogni ID di precaricamento. Ti consigliamo di chiamare il metodo all'inizio della sessione dell'app. Dopo aver chiamato Preload(), Google Mobile Ads Unity Plugin precarica automaticamente gli annunci e ripete le richieste non riuscite per questi ID di precaricamento.

L'esempio seguente avvia il precaricamento degli annunci:

var preloadConfiguration = new PreloadConfiguration
{
    AdUnitId = AD_UNIT_ID,
    Request = new AdRequest(),
};

// Start the preloading initialization process after MobileAds.Initialize().
InterstitialAdPreloader.Preload(
    // The Preload ID can be any unique string to identify this configuration.
    AD_UNIT_ID,
    preloadConfiguration);

Recupera e mostra l'annuncio di precaricamento

Quando utilizzi il precaricamento degli annunci, Google Mobile Ads Unity Plugin conserva gli annunci memorizzati nella cache. Quando vuoi mostrare un annuncio, chiama DequeueAd(). Google Mobile Ads Unity Plugin recupera l'annuncio disponibile e precarica automaticamente l'annuncio successivo in background.

L'esempio seguente recupera e mostra un annuncio di precaricamento:

// DequeueAd returns the next available ad and loads another ad in the background.
var ad = InterstitialAdPreloader.DequeueAd(AD_UNIT_ID);

if (ad != null)
{
    // [Optional] Interact with the ad object as needed.
    ad.OnAdPaid += (AdValue value) =>
    {
        Debug.Log($"Ad paid: {value.CurrencyCode} {value.Value}");
        // [Optional] Send the impression-level ad revenue information to your preferred
        // analytics server directly within this callback.
    };

    // Do not hold onto preloaded ads, always show a preloaded ad immediately.
    ad.Show();
}

Controlla la disponibilità degli annunci di precaricamento

Per verificare la disponibilità degli annunci, scegli una delle seguenti opzioni:

Verifica la disponibilità degli annunci di precaricamento

L'esempio seguente verifica la disponibilità degli annunci:

var isAdAvailable = InterstitialAdPreloader.IsAdAvailable(AD_UNIT_ID);

Ascolta la disponibilità degli annunci di precaricamento

Registrati per gli eventi di precaricamento per ricevere una notifica quando gli annunci vengono precaricati correttamente, non vengono precaricati o la cache degli annunci è esaurita.

Gli eventi di precaricamento sono destinati a scopi di analisi. Nei callback degli eventi di precaricamento:

  • Non chiamare Preload().
  • Evita di chiamare DequeueAd() a meno che l'annuncio non venga mostrato immediatamente.

L'esempio seguente registra gli eventi degli annunci:


void StartPreloadWithCallbacks()
{
    var preloadConfiguration = new PreloadConfiguration
    {
        AdUnitId = AD_UNIT_ID,
        Request = new AdRequest(),
    };

    // Start the preloading initialization process after MobileAds.Initialize().
    InterstitialAdPreloader.Preload(
        // The Preload ID can be any unique string to identify this configuration.
        AD_UNIT_ID,
        preloadConfiguration,
        onAdPreloaded,
        onAdFailedToPreload,
        onAdsExhausted);
}

void onAdPreloaded(string preloadId, ResponseInfo responseInfo)
{
    Debug.Log($"Preload ad configuration {preloadId} was preloaded.");
}

void onAdFailedToPreload(string preloadId, AdError adError)
{
    string errorMessage = $"Preload ad configuration {preloadId} failed to " +
                          $"preload with error : {adError.GetMessage()}.";
    Debug.Log(errorMessage);
}

void onAdsExhausted(string preloadId)
{
    Debug.Log($"Preload ad configuration {preloadId} was exhausted");
    // [Important] Don't call Preload() or DequeueAd() from onAdsExhausted.
}

Interrompi il precaricamento degli annunci

Se non devi mostrare di nuovo gli annunci per un ID di precaricamento nella sessione, puoi interrompere il precaricamento degli annunci. Per interrompere il precaricamento degli annunci per un ID di precaricamento specifico, chiama Destroy() con un ID di precaricamento. Per interrompere il precaricamento per tutti i precaricatori, chiama DestroyAll().

InterstitialAdPreloader.Destroy(AD_UNIT_ID);
InterstitialAdPreloader.DestroyAll();

Imposta la dimensione del buffer

La dimensione del buffer controlla il numero di annunci di precaricamento conservati in memoria. Per impostazione predefinita, Google ottimizza la dimensione del buffer per bilanciare il consumo di memoria e la latenza della pubblicazione degli annunci. Se la tua app mostra gli annunci prima che venga caricato l'annuncio successivo, puoi impostare una dimensione del buffer personalizzata per aumentare il numero di annunci conservati in memoria. Ti consigliamo di impostare una dimensione del buffer di due o tre.

Limiti della cache di precaricamento

Google Mobile Ads Unity Plugin applica un limite a livello di app al numero totale di annunci di precaricamento in tutte le unità pubblicitarie e gli ID di precaricamento:

  • Limite predefinito: Google Mobile Ads Unity Plugin conserva in memoria un massimo di sei annunci di precaricamento. Questo limite è condiviso tra tutti i formati e gli ID di precaricamento.
  • Ti consigliamo di mantenere una dimensione del buffer di due o tre per ogni ID di precaricamento.
new PreloadConfiguration
{
    AdUnitId = AD_UNIT_ID,
    Request = new AdRequest(),
    BufferSize = 5
};