Aggiunta di banner e inserzioni Medium Rectangle su un'app per Unity

Audience Network ti consente di monetizzare le tue app per Android e iOS con le inserzioni di Facebook. Questa guida spiega come aggiungere banner alla tua app.

Passaggi per banner e inserzioni Medium Rectangle

Passaggio 1: creazione di un oggetto banner

Passaggio 2: aggiunta di eventi callback

Passaggio 3: caricamento di un'inserzione

Passaggio 4: visualizzazione dell'inserzione

Passaggio 1: creazione di un oggetto banner

Il primo passaggio per la visualizzazione di un banner è la creazione di un oggetto AdView in uno script C# allegato a un GameObject.

...
using AudienceNetwork;
...

public class AdViewTest : MonoBehaviour
{
    ...
    private AdView adView;
    ...

    public void LoadBanner()
    {
        if (this.adView) {
            this.adView.Dispose();
        }

        this.adView = new AdView("YOUR_PLACEMENT_ID", AdSize.BANNER_HEIGHT_50);
        this.adView.Register(this.gameObject);

        // Set delegates to get notified on changes or when the user interacts with the ad.
        this.adView.AdViewDidLoad = (delegate() {
            Debug.Log("Banner loaded.");
            this.adView.Show(100);
        });
        adView.AdViewDidFailWithError = (delegate(string error) {
            Debug.Log("Banner failed to load with error: " + error);
        });
        adView.AdViewWillLogImpression = (delegate() {
            Debug.Log("Banner logged impression.");
        });
        adView.AdViewDidClick = (delegate() {
            Debug.Log("Banner clicked.");
        });

        // Initiate a request to load an ad.
        adView.LoadAd();
    }
    ...
}

Il costruttore di un AdView ha i seguenti parametri:

• placementId: ID del posizionamento Audience Network per questa unità banner.
• size: la dimensione del banner, specificata da valori enum AdSize.

Passaggio 2: aggiunta di eventi callback

Successivamente, puoi implementare alcune callback per ricevere gli aggiornamenti relativi agli eventi del ciclo di vita del banner. Rileva questi eventi registrando un delegato per l'evento, come mostrato di seguito nell'esempio:

...
// Set delegates to get notified on changes or when the user interacts with the ad.
this.adView.AdViewDidLoad = (delegate() {
    Debug.Log("Banner loaded.");
    this.adView.Show(100);
});
adView.AdViewDidFailWithError = (delegate(string error) {
    Debug.Log("Banner failed to load with error: " + error);
});
adView.AdViewWillLogImpression = (delegate() {
    Debug.Log("Banner logged impression.");
});
adView.AdViewDidClick = (delegate() {
    Debug.Log("Banner clicked.");
});
...

Passaggio 3: caricamento di un'inserzione

Una volta istanziata l'AdView, il passaggio successivo consiste nel caricare un'inserzione. Questa operazione viene eseguita con il metodo loadAd() nella classe AdView.

Nell'esempio sopra riportato, ecco come caricare un'inserzione:

...
adView.LoadAd();
...

Passaggio 4: visualizzazione dell'inserzione

Infine, dopo aver caricato il banner, puoi chiamare il metodo Show per visualizzare l'inserzione sullo schermo. Ad esempio, puoi mostrare l'inserzione al termine del caricamento, nella callback AdViewDidLoad:

this.adView.AdViewDidLoad = (delegate() {
    Debug.Log("Banner loaded.");
    this.adView.Show(100);
});

Esistono 3 tipi diversi di metodo Show nella classe AdView che puoi utilizzare per visualizzare l'unità banner:

• public bool Show(AdPosition position): consente di visualizzare l'unità banner in posizioni predefinite. Le opzioni disponibili sono AdPosition.TOP per visualizzarla nella parte superiore dello schermo, AdPosition.BOTTOM per visualizzarla nella parte inferiore dello schermo.
• public bool Show(double y): consente di pubblicare l'unità banner in corrispondenza delle coordinate dello schermo (0, y).
• public bool Show(double x, double y): consente di pubblicare l'unità banner in corrispondenza delle coordinate dello schermo (x, y).

Dimensioni dei banner

Audience Network supporta tre dimensioni per le inserzioni da usare in AdView. La larghezza dell'unità banner è flessibile con un minimo di 320 px, solo l'altezza è definita.