Ajouter des bandeaux publicitaires et des rectangles de taille moyenne à une application Unity

L’Audience Network vous permet de monétiser vos applications Android et iOS avec des publicités Facebook. Ce guide vous explique comment ajouter des bandeaux publicitaires à votre application.

Procédure d’ajout de bandeaux publicitaires et de rectangles de taille moyenne

Étape 1 : créer un objet de bandeau

Étape 2 : ajouter des évènements de rappel

Étape 3 : charger une publicité

Étape 4 : afficher la publicité

Étape 1 : création d’un objet de bandeau

Pour afficher un bandeau publicitaire, commencez par créer un objet AdView dans un script C# rattaché à 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();
    }
    ...
}

Le créateur d’une publicité AdView dispose des paramètres suivants :

• placementId : l’ID de placement de l’Audience Network de ce bandeau publicitaire.
• size, la taille du bandeau publicitaire, telle que spécifiée par les valeurs Enum d’AdSize.

Étape 2 : ajouter des évènements de rappel

Vous pouvez ensuite insérer quelques rappels pour vous inscrire aux évènements du cycle de vie du bandeau publicitaire. Tenez-vous informé(e) de ces évènements en inscrivant un délégué chargé de l’évènement, comme indiqué dans l’exemple ci-dessous :

...
// 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.");
});
...

Étape 3 : charger une publicité

Une fois la classe AdView instanciée, l’étape suivante consiste à charger la publicité. La méthode loadAd() de la classe AdView permet d’y parvenir.

Selon l’exemple ci-dessus, voici comment charger une publicité :

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

Étape 4 : afficher la publicité

Enfin, une fois le bandeau publicitaire chargé, vous pouvez appeler la méthode Show pour afficher la publicité. Vous pouvez par exemple afficher la publicité une fois son chargement terminé, dans le rappel AdViewDidLoad :

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

Il existe trois méthodes Show différentes dans la catégorie AdView utilisables pour afficher le bandeau publicitaire :

• public bool Show(AdPosition position) affiche le bandeau publicitaire aux emplacements prédéfinis, les options disponibles étant : AdPosition.TOP (affichage en haut de l’écran) et AdPosition.BOTTOM (affichage au bas de l’écran).
• public bool Show(double y) affiche le bandeau publicitaire au niveau des coordonnées d’écran (0, y).
• public bool Show(double x, double y) affiche le bandeau publicitaire au niveau des coordonnées d’écran (x, y).

Dimensions des bandeaux

L’Audience Network prend en charge trois tailles de publicité à utiliser dans votre AdView. La largeur du bandeau est flexible et doit comporter au minimum 320 pixels. Seule la hauteur est définie.