Добавление видеорекламы с бонусами в приложение Unity

Audience Network позволяет монетизировать приложения для Android и iOS за счет рекламы Facebook. Видеореклама с бонусами — это полноэкранная видеореклама, за просмотр которой пользователи получают вознаграждение: виртуальную валюту, игровые предметы, эксклюзивный контент и другие преимущества. Сама реклама представляет собой короткое видео и содержит конечную карточку с призывом к действию. Пропустить такую рекламу нельзя. После воспроизведения видео до конца вы получаете обратный вызов, позволяющий отправить бонус пользователю.

Создание видеорекламы с бонусами

Шаг 1. Инициализация видеорекламы с бонусами.

Шаг 2. Добавление событий обратного вызова.

Шаг 3. Загрузка объявления.

Шаг 4. Показ объявления.

Шаг 1. Инициализация видеорекламы с бонусами.

Первый шаг для показа видеорекламы с бонусами — создание объекта RewardedVideoAd в скрипте C#, вложенном в GameObject.

...
using AudienceNetwork;
...

public class RewardedVideoAdTest : MonoBehaviour
{
    public void LoadRewardedVideo()
    {
        // Create the rewarded video unit with a placement ID (generate your own on the Facebook app settings).
        // Use different ID for each ad placement in your app.
        this.rewardedVideoAd = new RewardedVideoAd("YOUR_PLACEMENT_ID");

        this.rewardedVideoAd.Register(this.gameObject);

        // Set delegates to get notified on changes or when the user interacts with the ad.
        this.rewardedVideoAd.RewardedVideoAdDidLoad = (delegate() {
            Debug.Log("RewardedVideo ad loaded.");
            this.isLoaded = true;
        });
        this.rewardedVideoAd.RewardedVideoAdDidFailWithError = (delegate(string error) {
            Debug.Log("RewardedVideo ad failed to load with error: " + error);
        });
        this.rewardedVideoAd.RewardedVideoAdWillLogImpression = (delegate() {
            Debug.Log("RewardedVideo ad logged impression.");
        });
        this.rewardedVideoAd.RewardedVideoAdDidClick = (delegate() {
            Debug.Log("RewardedVideo ad clicked.");
        });

        this.rewardedVideoAd.RewardedVideoAdDidClose = (delegate() {
            Debug.Log("Rewarded video ad did close.");
            if (this.rewardedVideoAd != null) {
                this.rewardedVideoAd.Dispose();
            }
        });

        // Initiate the request to load the ad.
        this.rewardedVideoAd.LoadAd();
    }
}

В конструкторе объекта RewardedVideoAd используются следующие параметры:

• placementId — ID места размещения Audience Network для данного блока видеорекламы с бонусами.

Шаг 2. Добавление событий обратного вызова.

После этого можно добавить несколько обратных вызовов, чтобы подписаться на события жизненного цикла рекламы. Для отслеживания этих событий нужно зарегистрировать делегат для события, как показано в следующем примере:

...
// Set delegates to get notified on changes or when the user interacts with the ad.
this.rewardedVideoAd.RewardedVideoAdDidLoad = (delegate() {
    Debug.Log("RewardedVideo ad loaded.");
    this.isLoaded = true;
});
this.rewardedVideoAd.RewardedVideoAdDidFailWithError = (delegate(string error) {
    Debug.Log("RewardedVideo ad failed to load with error: " + error);
});
this.rewardedVideoAd.RewardedVideoAdWillLogImpression = (delegate() {
    Debug.Log("RewardedVideo ad logged impression.");
});
this.rewardedVideoAd.RewardedVideoAdDidClick = (delegate() {
    Debug.Log("RewardedVideo ad clicked.");
});

this.rewardedVideoAd.RewardedVideoAdDidClose = (delegate() {
    Debug.Log("Rewarded video ad did close.");
    if (this.rewardedVideoAd != null) {
        this.rewardedVideoAd.Dispose();
    }
});
...

Шаг 3. Загрузка объявления.

После создания экземпляра RewardedVideoAd необходимо загрузить объявление. Для этого вызывается метод loadAd.

Инициализация загрузки объявления в примере выше:

...
this.rewardedVideoAd.LoadAd();
...

Шаг 4. Показ объявления.

Наконец, после загрузки объявления можно вызвать метод Show, чтобы отобразить видеорекламу с бонусами на экране. Например, можно создать функцию для ShowRewardedVideo и вызвать ее, когда потребуется показать эту рекламу:

public void ShowRewardedVideo()
{
    if (this.isLoaded) {
        this.rewardedVideoAd.Show();
        this.isLoaded = false;
    } else {
        Debug.Log("Ad not loaded. Click load to request an ad.");
    }
}

Подтверждение бонуса на стороне сервера

Обзор

Если вы управляете бонусами пользователей на стороне сервера, то можете использовать решение Facebook, обеспечивающее безопасность этого процесса. Наш сервер будет подтверждать каждый показ рекламы и каждый бонус, обращаясь к специальной конечной точке.

1. SDK Audience Network запрашивает видеорекламу с бонусами, используя следующие параметры:
   • placementId — ID места размещения Audience Network;
   • RewardData — объект RewardData состоит из элемента UserId, который представляет ID пользователя, и элемента Currency, который представляет фактическую награду в игре.
2. По завершении просмотра видео сервер Facebook передает эти значения в указанную вами конечную точку вместе с секретом приложения и уникальным ID транзакции.
3. Получив эти данные, сервер подтверждает запрос и отправляет следующий ответ:
   • 200 response — запрос действителен, пользователь должен получить бонус;
   • Non 200 response — запрос недействителен, бонус не полагается.
4. По окончании видео пользователь видит конечную карточку и срабатывает одно из следующих событий:
   • RewardedVideoAdDidSucceed — только если на шаге 3 получен код состояния200;
   • RewardedVideoAdDidFail — если на шаге 3 получен другой код состояния.

Следующая схема проиллюстрирует весь процесс:

Реализация

После инициализации объекта видео с бонусами до показа рекламы вам нужно передать в нее ID пользователя и размер бонуса. Это можно сделать с помощью класса RewardData. Оба значения являются строковыми. Пример:

public class RewardedVideoAdTest : MonoBehaviour
{
  ...
  private bool isLoaded;
  private RewardedVideoAd rewardedVideoAd;

  public void LoadRewardedVideo()

    //Set the rewarded ad data
    RewardData rewardData = new RewardData();
    rewardData.UserId = "USER_ID";
    rewardData.Currency = "REWARD_ID";

    // Instantiate RewardedVideoAd with reward data
    this.rewardedVideoAd = new RewardedVideoAd("YOUR_PLACEMENT_ID", rewardData);
    this.rewardedVideoAd.Register(this.gameObject);

    // Set delegates to get notified on changes or when the user interacts with the ad.
    this.rewardedVideoAd.RewardedVideoAdDidLoad = (delegate() {
        Debug.Log("RewardedVideo ad loaded.");
        this.isLoaded = true;
    });
    this.rewardedVideoAd.RewardedVideoAdDidFailWithError = (delegate(string error) {
        Debug.Log("RewardedVideo ad failed to load with error: " + error);
    });
    this.rewardedVideoAd.RewardedVideoAdWillLogImpression = (delegate() {
        Debug.Log("RewardedVideo ad logged impression.");
    });
    this.rewardedVideoAd.RewardedVideoAdDidClick = (delegate() {
        Debug.Log("RewardedVideo ad clicked.");
    });
    this.rewardedVideoAd.RewardedVideoAdDidClose = (delegate() {
        Debug.Log("Rewarded video ad did close.");
        if (this.rewardedVideoAd != null) {
            this.rewardedVideoAd.Dispose();
        }
    });

    // For S2S validation you need to register the following two callback
    this.rewardedVideoAd.RewardedVideoAdDidSucceed = (delegate() {
        Debug.Log("Rewarded video ad validated by server");
    });
    this.rewardedVideoAd.RewardedVideoAdDidFail = (delegate() {
        Debug.Log("Rewarded video ad not validated, or no response from server");
    });       

    this.rewardedVideoAd.loadAd();
  }
  ...
}

Чтобы уведомить приложение о подтверждении бонуса, в дополнение к другим обратным вызовам для RewardedVideoAd необходимо реализовать обратные вызовы RewardedVideoAdDidSucceed и RewardedVideoAdDidFail.

После загрузки рекламы ее можно отобразить с использованием метода Show как обычный объект RewardedVideoAd.